projects
/
pub
/
USBasp.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Add library maintenance scripts.
[pub/USBasp.git]
/
LUFA
/
Drivers
/
Board
/
Dataflash.h
diff --git
a/LUFA/Drivers/Board/Dataflash.h
b/LUFA/Drivers/Board/Dataflash.h
index
06c1e62
..
a5ae29d
100644
(file)
--- a/
LUFA/Drivers/Board/Dataflash.h
+++ b/
LUFA/Drivers/Board/Dataflash.h
@@
-1,13
+1,13
@@
/*
LUFA Library
/*
LUFA Library
- Copyright (C) Dean Camera, 201
1
.
+ Copyright (C) Dean Camera, 201
2
.
dean [at] fourwalledcubicle [dot] com
www.lufa-lib.org
*/
/*
dean [at] fourwalledcubicle [dot] com
www.lufa-lib.org
*/
/*
- Copyright 201
1
Dean Camera (dean [at] fourwalledcubicle [dot] com)
+ Copyright 201
2
Dean Camera (dean [at] fourwalledcubicle [dot] com)
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
@@
-30,9
+30,10
@@
/** \file
* \brief Master include file for the board dataflash IC driver.
/** \file
* \brief Master include file for the board dataflash IC driver.
+ * \brief Atmel Dataflash storage IC board hardware driver.
*
*
- * This file is the master dispatch header file for the board-specific dataflash driver, for boards containing
- *
d
ataflash ICs for external non-volatile storage.
+ * This file is the master dispatch header file for the board-specific
Atmel
dataflash driver, for boards containing
+ *
Atmel D
ataflash ICs for external non-volatile storage.
*
* User code should include this file, which will in turn include the correct dataflash driver header file for
* the currently selected board.
*
* User code should include this file, which will in turn include the correct dataflash driver header file for
* the currently selected board.
@@
-45,6
+46,7
@@
/** \ingroup Group_BoardDrivers
* \defgroup Group_Dataflash Dataflash Driver - LUFA/Drivers/Board/Dataflash.h
/** \ingroup Group_BoardDrivers
* \defgroup Group_Dataflash Dataflash Driver - LUFA/Drivers/Board/Dataflash.h
+ * \brief Atmel Dataflash storage IC board hardware driver.
*
* \section Sec_Dependencies Module Source Dependencies
* The following files must be built with any user project that uses this module:
*
* \section Sec_Dependencies Module Source Dependencies
* The following files must be built with any user project that uses this module:
@@
-64,7
+66,7
@@
* application.
*
* \code
* application.
*
* \code
- * // Initiali
s
e the SPI and board Dataflash drivers before first use
+ * // Initiali
z
e the SPI and board Dataflash drivers before first use
* SPI_Init(SPI_SPEED_FCPU_DIV_2 | SPI_ORDER_MSB_FIRST | SPI_SCK_LEAD_FALLING |
* SPI_SAMPLE_TRAILING | SPI_MODE_MASTER);
* Dataflash_Init();
* SPI_Init(SPI_SPEED_FCPU_DIV_2 | SPI_ORDER_MSB_FIRST | SPI_SCK_LEAD_FALLING |
* SPI_SAMPLE_TRAILING | SPI_MODE_MASTER);
* Dataflash_Init();
@@
-117,14
+119,10
@@
#define __DATAFLASH_H__
/* Macros: */
#define __DATAFLASH_H__
/* Macros: */
- #if !defined(__DOXYGEN__)
#define __INCLUDE_FROM_DATAFLASH_H
#define __INCLUDE_FROM_DATAFLASH_H
- #define INCLUDE_FROM_DATAFLASH_H
- #endif
/* Includes: */
/* Includes: */
- #include "../../Common/Common.h"
- #include "../Peripheral/SPI.h"
+ #include "../../Common/Common.h"
/* Enable C linkage for C++ Compilers: */
#if defined(__cplusplus)
/* Enable C linkage for C++ Compilers: */
#if defined(__cplusplus)
@@
-147,9
+145,11
@@
#define DATAFLASH_CHIP_MASK(index) __GET_DATAFLASH_MASK(index)
/* Inline Functions: */
#define DATAFLASH_CHIP_MASK(index) __GET_DATAFLASH_MASK(index)
/* Inline Functions: */
- /** Initiali
s
es the dataflash driver so that commands and data may be sent to an attached dataflash IC.
+ /** Initiali
z
es the dataflash driver so that commands and data may be sent to an attached dataflash IC.
*
*
- * \note The AVR's SPI driver must be initialized before any of the dataflash commands are used.
+ * \note The microcontroller's physical interface driver connected to the Dataflash IC must be initialized before
+ * any of the dataflash commands are used. This is usually a SPI hardware port, but on some devices/boards may
+ * be a USART operating in SPI Master mode.
*/
static inline void Dataflash_Init(void);
*/
static inline void Dataflash_Init(void);
@@
-177,7
+177,7
@@
* are deselected.
*
* \param[in] PageAddress Address of the page to manipulate, ranging from
* are deselected.
*
* \param[in] PageAddress Address of the page to manipulate, ranging from
- * ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
+ *
0 to
((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
*/
static inline void Dataflash_SelectChipFromPage(const uint16_t PageAddress);
*/
static inline void Dataflash_SelectChipFromPage(const uint16_t PageAddress);
@@
-192,7
+192,7
@@
static inline void Dataflash_WaitWhileBusy(void);
/** Sends a set of page and buffer address bytes to the currently selected dataflash IC, for use with
static inline void Dataflash_WaitWhileBusy(void);
/** Sends a set of page and buffer address bytes to the currently selected dataflash IC, for use with
- * dataflash commands which require a complete 24-b
yte
address.
+ * dataflash commands which require a complete 24-b
it
address.
*
* \param[in] PageAddress Page address within the selected dataflash IC
* \param[in] BufferByte Address within the dataflash's buffer
*
* \param[in] PageAddress Page address within the selected dataflash IC
* \param[in] BufferByte Address within the dataflash's buffer
@@
-202,51
+202,41
@@
/** Sends a byte to the currently selected dataflash IC, and returns a byte from the dataflash.
*
/** Sends a byte to the currently selected dataflash IC, and returns a byte from the dataflash.
*
- * \param[in] Byte of data to send to the dataflash
+ * \param[in] Byte
Byte
of data to send to the dataflash
*
* \return Last response byte from the dataflash
*/
static inline uint8_t Dataflash_TransferByte(const uint8_t Byte) ATTR_ALWAYS_INLINE;
*
* \return Last response byte from the dataflash
*/
static inline uint8_t Dataflash_TransferByte(const uint8_t Byte) ATTR_ALWAYS_INLINE;
- static inline uint8_t Dataflash_TransferByte(const uint8_t Byte)
- {
- return SPI_TransferByte(Byte);
- }
/** Sends a byte to the currently selected dataflash IC, and ignores the next byte from the dataflash.
*
/** Sends a byte to the currently selected dataflash IC, and ignores the next byte from the dataflash.
*
- * \param[in] Byte of data to send to the dataflash
+ * \param[in] Byte
Byte
of data to send to the dataflash
*/
static inline void Dataflash_SendByte(const uint8_t Byte) ATTR_ALWAYS_INLINE;
*/
static inline void Dataflash_SendByte(const uint8_t Byte) ATTR_ALWAYS_INLINE;
- static inline void Dataflash_SendByte(const uint8_t Byte)
- {
- SPI_SendByte(Byte);
- }
/** Sends a dummy byte to the currently selected dataflash IC, and returns the next byte from the dataflash.
*
* \return Last response byte from the dataflash
*/
static inline uint8_t Dataflash_ReceiveByte(void) ATTR_ALWAYS_INLINE ATTR_WARN_UNUSED_RESULT;
/** Sends a dummy byte to the currently selected dataflash IC, and returns the next byte from the dataflash.
*
* \return Last response byte from the dataflash
*/
static inline uint8_t Dataflash_ReceiveByte(void) ATTR_ALWAYS_INLINE ATTR_WARN_UNUSED_RESULT;
- static inline uint8_t Dataflash_ReceiveByte(void)
- {
- return SPI_ReceiveByte();
- }
/* Includes: */
#if (BOARD == BOARD_NONE)
#error The Board Dataflash driver cannot be used if the makefile BOARD option is not set.
#elif (BOARD == BOARD_USBKEY)
/* Includes: */
#if (BOARD == BOARD_NONE)
#error The Board Dataflash driver cannot be used if the makefile BOARD option is not set.
#elif (BOARD == BOARD_USBKEY)
- #include "USBKEY/Dataflash.h"
+ #include "
AVR8/
USBKEY/Dataflash.h"
#elif (BOARD == BOARD_STK525)
#elif (BOARD == BOARD_STK525)
- #include "STK525/Dataflash.h"
+ #include "
AVR8/
STK525/Dataflash.h"
#elif (BOARD == BOARD_STK526)
#elif (BOARD == BOARD_STK526)
- #include "STK526/Dataflash.h"
- #elif (BOARD == BOARD_XPLAIN)
- #include "XPLAIN/Dataflash.h"
- #elif (BOARD == BOARD_XPLAIN_REV1)
- #include "XPLAIN/Dataflash.h"
+ #include "AVR8/STK526/Dataflash.h"
+ #elif ((BOARD == BOARD_XPLAIN) || (BOARD == BOARD_XPLAIN_REV1))
+ #include "AVR8/XPLAIN/Dataflash.h"
#elif (BOARD == BOARD_EVK527)
#elif (BOARD == BOARD_EVK527)
- #include "EVK527/Dataflash.h"
+ #include "AVR8/EVK527/Dataflash.h"
+ #elif (BOARD == BOARD_A3BU_XPLAINED)
+ #include "XMEGA/A3BU_XPLAINED/Dataflash.h"
+ #elif (BOARD == BOARD_B1_XPLAINED)
+ #include "XMEGA/B1_XPLAINED/Dataflash.h"
#else
#include "Board/Dataflash.h"
#endif
#else
#include "Board/Dataflash.h"
#endif
projects / pub / USBasp.git / blobdiff