Added const modifiers to device mode class drivers.
Added parameter directions to function parameter documentation. Added new experimental FAST_STREAM_FUNCTIONS compile time option to speed up stream transfers at the expense of a higher FLASH consumption (needs testing to verify improved throughput).
This commit is contained in:
		
							parent
							
								
									3cbdcd3686
								
							
						
					
					
						commit
						f1076ac4d6
					
				
					 115 changed files with 1031 additions and 633 deletions
				
			
		| 
						 | 
				
			
			@ -86,8 +86,8 @@
 | 
			
		|||
 | 
			
		||||
				/** Selects the given dataflash chip.
 | 
			
		||||
				 *
 | 
			
		||||
				 *  \param  ChipMask  Mask of the Dataflash IC to select, in the form of DATAFLASH_CHIPn mask (where n is
 | 
			
		||||
				 *          the chip number).
 | 
			
		||||
				 *  \param[in]  ChipMask  Mask of the Dataflash IC to select, in the form of DATAFLASH_CHIPn mask (where n is
 | 
			
		||||
				 *              the chip number).
 | 
			
		||||
				 */
 | 
			
		||||
				static inline void Dataflash_SelectChip(uint8_t ChipMask);
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -105,7 +105,7 @@
 | 
			
		|||
		/* Inline Functions: */
 | 
			
		||||
			/** Sends a byte to the currently selected dataflash IC, and returns a byte from the dataflash.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param Byte of data to send to the dataflash
 | 
			
		||||
			 *  \param[in] Byte of data to send to the dataflash
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \return Last response byte from the dataflash
 | 
			
		||||
			 */
 | 
			
		||||
| 
						 | 
				
			
			@ -117,7 +117,7 @@
 | 
			
		|||
 | 
			
		||||
			/** Sends a byte to the currently selected dataflash IC, and ignores the next byte from the dataflash.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param Byte of data to send to the dataflash
 | 
			
		||||
			 *  \param[in] 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)
 | 
			
		||||
| 
						 | 
				
			
			@ -154,7 +154,7 @@
 | 
			
		|||
			/** Initializes the dataflash driver (including the SPI driver) so that commands and data may be
 | 
			
		||||
			 *  sent to an attached dataflash IC.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PrescalerMask  SPI prescaler mask, see SPI.h documentation
 | 
			
		||||
			 *  \param[in] PrescalerMask  SPI prescaler mask, see SPI.h documentation
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_Init(const uint8_t PrescalerMask)
 | 
			
		||||
			{
 | 
			
		||||
| 
						 | 
				
			
			@ -191,16 +191,16 @@
 | 
			
		|||
			 *  the total number of pages contained in the boards dataflash ICs, all dataflash ICs
 | 
			
		||||
			 *  are deselected.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                      ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 *  \param[in] PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                          ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SelectChipFromPage(const uint16_t PageAddress);
 | 
			
		||||
 | 
			
		||||
			/** 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-byte address.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Page address within the selected dataflash IC
 | 
			
		||||
			 *  \param 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
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SendAddressBytes(uint16_t PageAddress, const uint16_t BufferByte);
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -117,28 +117,28 @@
 | 
			
		|||
 | 
			
		||||
		/** Turns on the LEDs specified in the given LED mask.
 | 
			
		||||
		 *
 | 
			
		||||
		 *  \param LEDMask  Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 *  \param[in] LEDMask  Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 */
 | 
			
		||||
		static inline void LEDs_TurnOnLEDs(const uint8_t LEDMask);
 | 
			
		||||
 | 
			
		||||
		/** Turns off the LEDs specified in the given LED mask.
 | 
			
		||||
		 *
 | 
			
		||||
		 *  \param LEDMask  Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 *  \param[in] LEDMask  Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 */
 | 
			
		||||
		static inline void LEDs_TurnOffLEDs(const uint8_t LEDMask);
 | 
			
		||||
 | 
			
		||||
		/** Turns off all LEDs not specified in the given LED mask, and turns on all the LEDs in the given LED
 | 
			
		||||
		 *  mask.
 | 
			
		||||
		 *
 | 
			
		||||
		 *  \param LEDMask  Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 *  \param[in] LEDMask  Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 */
 | 
			
		||||
		static inline void LEDs_SetAllLEDs(const uint8_t LEDMask);
 | 
			
		||||
 | 
			
		||||
		/** Turns off all LEDs in the LED mask that are not set in the active mask, and turns on all the LEDs
 | 
			
		||||
		 *  specified in both the LED and active masks.
 | 
			
		||||
		 *
 | 
			
		||||
		 *  \param LEDMask     Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 *  \param ActiveMask  Mask of whether the LEDs in the LED mask should be turned on or off
 | 
			
		||||
		 *  \param[in] LEDMask     Mask of the board LEDs to manipulate (see board-specific LEDs.h driver file)
 | 
			
		||||
		 *  \param[in] ActiveMask  Mask of whether the LEDs in the LED mask should be turned on or off
 | 
			
		||||
		 */
 | 
			
		||||
		static inline void LEDs_ChangeLEDs(const uint8_t LEDMask, const uint8_t ActiveMask);
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -85,8 +85,8 @@
 | 
			
		|||
			 *  the total number of pages contained in the boards dataflash ICs, all dataflash ICs
 | 
			
		||||
			 *  are deselected.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                      ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 *  \param[in] PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                          ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SelectChipFromPage(const uint16_t PageAddress)
 | 
			
		||||
			{
 | 
			
		||||
| 
						 | 
				
			
			@ -101,8 +101,8 @@
 | 
			
		|||
			/** 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-byte address.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Page address within the selected dataflash IC
 | 
			
		||||
			 *  \param 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
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SendAddressBytes(uint16_t PageAddress, const uint16_t BufferByte)
 | 
			
		||||
			{	
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -85,8 +85,8 @@
 | 
			
		|||
			 *  the total number of pages contained in the boards dataflash ICs, all dataflash ICs
 | 
			
		||||
			 *  are deselected.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                      ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 *  \param[in] PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                          ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SelectChipFromPage(const uint16_t PageAddress)
 | 
			
		||||
			{
 | 
			
		||||
| 
						 | 
				
			
			@ -101,8 +101,8 @@
 | 
			
		|||
			/** 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-byte address.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Page address within the selected dataflash IC
 | 
			
		||||
			 *  \param 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
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SendAddressBytes(uint16_t PageAddress, const uint16_t BufferByte)
 | 
			
		||||
			{	
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -88,8 +88,8 @@
 | 
			
		|||
			 *  the total number of pages contained in the boards dataflash ICs, all dataflash ICs
 | 
			
		||||
			 *  are deselected.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                      ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 *  \param[in] PageAddress  Address of the page to manipulate, ranging from
 | 
			
		||||
			 *                          ((DATAFLASH_PAGES * DATAFLASH_TOTALCHIPS) - 1).
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SelectChipFromPage(const uint16_t PageAddress)
 | 
			
		||||
			{
 | 
			
		||||
| 
						 | 
				
			
			@ -107,8 +107,8 @@
 | 
			
		|||
			/** 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-byte address.
 | 
			
		||||
			 *
 | 
			
		||||
			 *  \param PageAddress  Page address within the selected dataflash IC
 | 
			
		||||
			 *  \param 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
 | 
			
		||||
			 */
 | 
			
		||||
			static inline void Dataflash_SendAddressBytes(uint16_t PageAddress, const uint16_t BufferByte)
 | 
			
		||||
			{	
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue