diff options
Diffstat (limited to 'Projects/Incomplete/StandaloneProgrammer/Lib')
12 files changed, 2323 insertions, 0 deletions
| diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/DataflashManager.c b/Projects/Incomplete/StandaloneProgrammer/Lib/DataflashManager.c new file mode 100644 index 0000000000..6646278ee5 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/DataflashManager.c @@ -0,0 +1,525 @@ +/*
 +             LUFA Library
 +     Copyright (C) Dean Camera, 2009.
 +              
 +  dean [at] fourwalledcubicle [dot] com
 +      www.fourwalledcubicle.com
 +*/
 +
 +/*
 +  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 +
 +  Permission to use, copy, modify, and distribute this software
 +  and its documentation for any purpose and without fee is hereby
 +  granted, provided that the above copyright notice appear in all
 +  copies and that both that the copyright notice and this
 +  permission notice and warranty disclaimer appear in supporting
 +  documentation, and that the name of the author not be used in
 +  advertising or publicity pertaining to distribution of the
 +  software without specific, written prior permission.
 +
 +  The author disclaim all warranties with regard to this
 +  software, including all implied warranties of merchantability
 +  and fitness.  In no event shall the author be liable for any
 +  special, indirect or consequential damages or any damages
 +  whatsoever resulting from loss of use, data or profits, whether
 +  in an action of contract, negligence or other tortious action,
 +  arising out of or in connection with the use or performance of
 +  this software.
 +*/
 +
 +/** \file
 + *
 + *  Functions to manage the physical dataflash media, including reading and writing of
 + *  blocks of data. These functions are called by the SCSI layer when data must be stored
 + *  or retrieved to/from the physical storage media. If a different media is used (such
 + *  as a SD card or EEPROM), functions similar to these will need to be generated.
 + */
 +
 +#define  INCLUDE_FROM_DATAFLASHMANAGER_C
 +#include "DataflashManager.h"
 +
 +/** Writes blocks (OS blocks, not Dataflash pages) to the storage medium, the board dataflash IC(s), from
 + *  the pre-selected data OUT endpoint. This routine reads in OS sized blocks from the endpoint and writes
 + *  them to the dataflash in Dataflash page sized blocks.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to a structure containing a Mass Storage Class configuration and state
 + *  \param[in] BlockAddress  Data block starting address for the write sequence
 + *  \param[in] TotalBlocks   Number of blocks of data to write
 + */
 +void DataflashManager_WriteBlocks(USB_ClassInfo_MS_Device_t* MSInterfaceInfo, const uint32_t BlockAddress, uint16_t TotalBlocks)
 +{
 +	uint16_t CurrDFPage          = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) / DATAFLASH_PAGE_SIZE);
 +	uint16_t CurrDFPageByte      = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) % DATAFLASH_PAGE_SIZE);
 +	uint8_t  CurrDFPageByteDiv16 = (CurrDFPageByte >> 4);
 +	bool     UsingSecondBuffer   = false;
 +
 +	/* Select the correct starting Dataflash IC for the block requested */
 +	Dataflash_SelectChipFromPage(CurrDFPage);
 +
 +#if (DATAFLASH_PAGE_SIZE > VIRTUAL_MEMORY_BLOCK_SIZE)
 +	/* Copy selected dataflash's current page contents to the dataflash buffer */
 +	Dataflash_SendByte(DF_CMD_MAINMEMTOBUFF1);
 +	Dataflash_SendAddressBytes(CurrDFPage, 0);
 +	Dataflash_WaitWhileBusy();
 +#endif
 +
 +	/* Send the dataflash buffer write command */
 +	Dataflash_SendByte(DF_CMD_BUFF1WRITE);
 +	Dataflash_SendAddressBytes(0, CurrDFPageByte);
 +
 +	/* Wait until endpoint is ready before continuing */
 +	if (Endpoint_WaitUntilReady())
 +	  return;
 +
 +	while (TotalBlocks)
 +	{
 +		uint8_t BytesInBlockDiv16 = 0;
 +		
 +		/* Write an endpoint packet sized data block to the dataflash */
 +		while (BytesInBlockDiv16 < (VIRTUAL_MEMORY_BLOCK_SIZE >> 4))
 +		{
 +			/* Check if the endpoint is currently empty */
 +			if (!(Endpoint_IsReadWriteAllowed()))
 +			{
 +				/* Clear the current endpoint bank */
 +				Endpoint_ClearOUT();
 +				
 +				/* Wait until the host has sent another packet */
 +				if (Endpoint_WaitUntilReady())
 +				  return;
 +			}
 +
 +			/* Check if end of dataflash page reached */
 +			if (CurrDFPageByteDiv16 == (DATAFLASH_PAGE_SIZE >> 4))
 +			{
 +				/* Write the dataflash buffer contents back to the dataflash page */
 +				Dataflash_WaitWhileBusy();
 +				Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_BUFF2TOMAINMEMWITHERASE : DF_CMD_BUFF1TOMAINMEMWITHERASE);
 +				Dataflash_SendAddressBytes(CurrDFPage, 0);
 +
 +				/* Reset the dataflash buffer counter, increment the page counter */
 +				CurrDFPageByteDiv16 = 0;
 +				CurrDFPage++;
 +
 +				/* Once all the dataflash ICs have had their first buffers filled, switch buffers to maintain throughput */
 +				if (Dataflash_GetSelectedChip() == DATAFLASH_CHIP_MASK(DATAFLASH_TOTALCHIPS))
 +				  UsingSecondBuffer = !(UsingSecondBuffer);
 +
 +				/* Select the next dataflash chip based on the new dataflash page index */
 +				Dataflash_SelectChipFromPage(CurrDFPage);
 +
 +#if (DATAFLASH_PAGE_SIZE > VIRTUAL_MEMORY_BLOCK_SIZE)
 +				/* If less than one dataflash page remaining, copy over the existing page to preserve trailing data */
 +				if ((TotalBlocks * (VIRTUAL_MEMORY_BLOCK_SIZE >> 4)) < (DATAFLASH_PAGE_SIZE >> 4))
 +				{
 +					/* Copy selected dataflash's current page contents to the dataflash buffer */
 +					Dataflash_WaitWhileBusy();
 +					Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_MAINMEMTOBUFF2 : DF_CMD_MAINMEMTOBUFF1);
 +					Dataflash_SendAddressBytes(CurrDFPage, 0);
 +					Dataflash_WaitWhileBusy();
 +				}
 +#endif
 +
 +				/* Send the dataflash buffer write command */
 +				Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_BUFF2WRITE : DF_CMD_BUFF1WRITE);
 +				Dataflash_SendAddressBytes(0, 0);				
 +			}
 +
 +			/* Write one 16-byte chunk of data to the dataflash */
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			Dataflash_SendByte(Endpoint_Read_Byte());
 +			
 +			/* Increment the dataflash page 16 byte block counter */
 +			CurrDFPageByteDiv16++;
 +
 +			/* Increment the block 16 byte block counter */
 +			BytesInBlockDiv16++;
 +
 +			/* Check if the current command is being aborted by the host */
 +			if (MSInterfaceInfo->State.IsMassStoreReset)
 +			  return;			
 +		}
 +			
 +		/* Decrement the blocks remaining counter and reset the sub block counter */
 +		TotalBlocks--;
 +	}
 +
 +	/* Write the dataflash buffer contents back to the dataflash page */
 +	Dataflash_WaitWhileBusy();
 +	Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_BUFF2TOMAINMEMWITHERASE : DF_CMD_BUFF1TOMAINMEMWITHERASE);
 +	Dataflash_SendAddressBytes(CurrDFPage, 0x00);
 +	Dataflash_WaitWhileBusy();
 +
 +	/* If the endpoint is empty, clear it ready for the next packet from the host */
 +	if (!(Endpoint_IsReadWriteAllowed()))
 +	  Endpoint_ClearOUT();
 +
 +	/* Deselect all dataflash chips */
 +	Dataflash_DeselectChip();
 +}
 +
 +/** Reads blocks (OS blocks, not Dataflash pages) from the storage medium, the board dataflash IC(s), into
 + *  the pre-selected data IN endpoint. This routine reads in Dataflash page sized blocks from the Dataflash
 + *  and writes them in OS sized blocks to the endpoint.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to a structure containing a Mass Storage Class configuration and state
 + *  \param[in] BlockAddress  Data block starting address for the read sequence
 + *  \param[in] TotalBlocks   Number of blocks of data to read
 + */
 +void DataflashManager_ReadBlocks(USB_ClassInfo_MS_Device_t* MSInterfaceInfo, const uint32_t BlockAddress, uint16_t TotalBlocks)
 +{
 +	uint16_t CurrDFPage          = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) / DATAFLASH_PAGE_SIZE);
 +	uint16_t CurrDFPageByte      = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) % DATAFLASH_PAGE_SIZE);
 +	uint8_t  CurrDFPageByteDiv16 = (CurrDFPageByte >> 4);
 +
 +	/* Select the correct starting Dataflash IC for the block requested */
 +	Dataflash_SelectChipFromPage(CurrDFPage);
 +
 +	/* Send the dataflash main memory page read command */
 +	Dataflash_SendByte(DF_CMD_MAINMEMPAGEREAD);
 +	Dataflash_SendAddressBytes(CurrDFPage, CurrDFPageByte);
 +	Dataflash_SendByte(0x00);
 +	Dataflash_SendByte(0x00);
 +	Dataflash_SendByte(0x00);
 +	Dataflash_SendByte(0x00);
 +	
 +	/* Wait until endpoint is ready before continuing */
 +	if (Endpoint_WaitUntilReady())
 +	  return;
 +	
 +	while (TotalBlocks)
 +	{
 +		uint8_t BytesInBlockDiv16 = 0;
 +		
 +		/* Write an endpoint packet sized data block to the dataflash */
 +		while (BytesInBlockDiv16 < (VIRTUAL_MEMORY_BLOCK_SIZE >> 4))
 +		{
 +			/* Check if the endpoint is currently full */
 +			if (!(Endpoint_IsReadWriteAllowed()))
 +			{
 +				/* Clear the endpoint bank to send its contents to the host */
 +				Endpoint_ClearIN();
 +				
 +				/* Wait until the endpoint is ready for more data */
 +				if (Endpoint_WaitUntilReady())
 +				  return;
 +			}
 +			
 +			/* Check if end of dataflash page reached */
 +			if (CurrDFPageByteDiv16 == (DATAFLASH_PAGE_SIZE >> 4))
 +			{
 +				/* Reset the dataflash buffer counter, increment the page counter */
 +				CurrDFPageByteDiv16 = 0;
 +				CurrDFPage++;
 +
 +				/* Select the next dataflash chip based on the new dataflash page index */
 +				Dataflash_SelectChipFromPage(CurrDFPage);
 +				
 +				/* Send the dataflash main memory page read command */
 +				Dataflash_SendByte(DF_CMD_MAINMEMPAGEREAD);
 +				Dataflash_SendAddressBytes(CurrDFPage, 0);
 +				Dataflash_SendByte(0x00);
 +				Dataflash_SendByte(0x00);
 +				Dataflash_SendByte(0x00);
 +				Dataflash_SendByte(0x00);
 +			}	
 +
 +			/* Read one 16-byte chunk of data from the dataflash */
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			Endpoint_Write_Byte(Dataflash_ReceiveByte());
 +			
 +			/* Increment the dataflash page 16 byte block counter */
 +			CurrDFPageByteDiv16++;
 +			
 +			/* Increment the block 16 byte block counter */
 +			BytesInBlockDiv16++;
 +
 +			/* Check if the current command is being aborted by the host */
 +			if (MSInterfaceInfo->State.IsMassStoreReset)
 +			  return;
 +		}
 +		
 +		/* Decrement the blocks remaining counter */
 +		TotalBlocks--;
 +	}
 +	
 +	/* If the endpoint is full, send its contents to the host */
 +	if (!(Endpoint_IsReadWriteAllowed()))
 +	  Endpoint_ClearIN();
 +
 +	/* Deselect all dataflash chips */
 +	Dataflash_DeselectChip();
 +}
 +
 +/** Writes blocks (OS blocks, not Dataflash pages) to the storage medium, the board dataflash IC(s), from
 + *  the a given RAM buffer. This routine reads in OS sized blocks from the buffer and writes them to the
 + *  dataflash in Dataflash page sized blocks. This can be linked to FAT libraries to write files to the
 + *  dataflash.
 + *
 + *  \param[in] BlockAddress  Data block starting address for the write sequence
 + *  \param[in] TotalBlocks   Number of blocks of data to write
 + *  \param[in] BufferPtr     Pointer to the data source RAM buffer
 + */
 +void DataflashManager_WriteBlocks_RAM(const uint32_t BlockAddress, uint16_t TotalBlocks, uint8_t* BufferPtr)
 +{
 +	uint16_t CurrDFPage          = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) / DATAFLASH_PAGE_SIZE);
 +	uint16_t CurrDFPageByte      = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) % DATAFLASH_PAGE_SIZE);
 +	uint8_t  CurrDFPageByteDiv16 = (CurrDFPageByte >> 4);
 +	bool     UsingSecondBuffer   = false;
 +
 +	/* Select the correct starting Dataflash IC for the block requested */
 +	Dataflash_SelectChipFromPage(CurrDFPage);
 +
 +#if (DATAFLASH_PAGE_SIZE > VIRTUAL_MEMORY_BLOCK_SIZE)
 +	/* Copy selected dataflash's current page contents to the dataflash buffer */
 +	Dataflash_SendByte(DF_CMD_MAINMEMTOBUFF1);
 +	Dataflash_SendAddressBytes(CurrDFPage, 0);
 +	Dataflash_WaitWhileBusy();
 +#endif
 +
 +	/* Send the dataflash buffer write command */
 +	Dataflash_SendByte(DF_CMD_BUFF1WRITE);
 +	Dataflash_SendAddressBytes(0, CurrDFPageByte);
 +	
 +	while (TotalBlocks)
 +	{
 +		uint8_t BytesInBlockDiv16 = 0;
 +		
 +		/* Write an endpoint packet sized data block to the dataflash */
 +		while (BytesInBlockDiv16 < (VIRTUAL_MEMORY_BLOCK_SIZE >> 4))
 +		{
 +			/* Check if end of dataflash page reached */
 +			if (CurrDFPageByteDiv16 == (DATAFLASH_PAGE_SIZE >> 4))
 +			{
 +				/* Write the dataflash buffer contents back to the dataflash page */
 +				Dataflash_WaitWhileBusy();
 +				Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_BUFF2TOMAINMEMWITHERASE : DF_CMD_BUFF1TOMAINMEMWITHERASE);
 +				Dataflash_SendAddressBytes(CurrDFPage, 0);
 +
 +				/* Reset the dataflash buffer counter, increment the page counter */
 +				CurrDFPageByteDiv16 = 0;
 +				CurrDFPage++;
 +
 +				/* Once all the dataflash ICs have had their first buffers filled, switch buffers to maintain throughput */
 +				if (Dataflash_GetSelectedChip() == DATAFLASH_CHIP_MASK(DATAFLASH_TOTALCHIPS))
 +				  UsingSecondBuffer = !(UsingSecondBuffer);
 +
 +				/* Select the next dataflash chip based on the new dataflash page index */
 +				Dataflash_SelectChipFromPage(CurrDFPage);
 +
 +#if (DATAFLASH_PAGE_SIZE > VIRTUAL_MEMORY_BLOCK_SIZE)
 +				/* If less than one dataflash page remaining, copy over the existing page to preserve trailing data */
 +				if ((TotalBlocks * (VIRTUAL_MEMORY_BLOCK_SIZE >> 4)) < (DATAFLASH_PAGE_SIZE >> 4))
 +				{
 +					/* Copy selected dataflash's current page contents to the dataflash buffer */
 +					Dataflash_WaitWhileBusy();
 +					Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_MAINMEMTOBUFF2 : DF_CMD_MAINMEMTOBUFF1);
 +					Dataflash_SendAddressBytes(CurrDFPage, 0);
 +					Dataflash_WaitWhileBusy();
 +				}
 +#endif
 +
 +				/* Send the dataflash buffer write command */
 +				Dataflash_ToggleSelectedChipCS();
 +				Dataflash_SendByte(DF_CMD_BUFF1WRITE);
 +				Dataflash_SendAddressBytes(0, 0);
 +			}
 +			
 +			/* Write one 16-byte chunk of data to the dataflash */
 +			for (uint8_t ByteNum = 0; ByteNum < 16; ByteNum++)
 +			  Dataflash_SendByte(*(BufferPtr++));
 +			
 +			/* Increment the dataflash page 16 byte block counter */
 +			CurrDFPageByteDiv16++;
 +
 +			/* Increment the block 16 byte block counter */
 +			BytesInBlockDiv16++;		
 +		}
 +			
 +		/* Decrement the blocks remaining counter and reset the sub block counter */
 +		TotalBlocks--;
 +	}
 +
 +	/* Write the dataflash buffer contents back to the dataflash page */
 +	Dataflash_WaitWhileBusy();
 +	Dataflash_SendByte(UsingSecondBuffer ? DF_CMD_BUFF2TOMAINMEMWITHERASE : DF_CMD_BUFF1TOMAINMEMWITHERASE);
 +	Dataflash_SendAddressBytes(CurrDFPage, 0x00);
 +	Dataflash_WaitWhileBusy();
 +
 +	/* Deselect all dataflash chips */
 +	Dataflash_DeselectChip();
 +}
 +
 +/** Reads blocks (OS blocks, not Dataflash pages) from the storage medium, the board dataflash IC(s), into
 + *  the a preallocated RAM buffer. This routine reads in Dataflash page sized blocks from the Dataflash
 + *  and writes them in OS sized blocks to the given buffer. This can be linked to FAT libraries to read
 + *  the files stored on the dataflash.
 + *
 + *  \param[in] BlockAddress  Data block starting address for the read sequence
 + *  \param[in] TotalBlocks   Number of blocks of data to read
 + *  \param[out] BufferPtr    Pointer to the data destination RAM buffer
 + */
 +void DataflashManager_ReadBlocks_RAM(const uint32_t BlockAddress, uint16_t TotalBlocks, uint8_t* BufferPtr)
 +{
 +	uint16_t CurrDFPage          = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) / DATAFLASH_PAGE_SIZE);
 +	uint16_t CurrDFPageByte      = ((BlockAddress * VIRTUAL_MEMORY_BLOCK_SIZE) % DATAFLASH_PAGE_SIZE);
 +	uint8_t  CurrDFPageByteDiv16 = (CurrDFPageByte >> 4);
 +
 +	/* Select the correct starting Dataflash IC for the block requested */
 +	Dataflash_SelectChipFromPage(CurrDFPage);
 +
 +	/* Send the dataflash main memory page read command */
 +	Dataflash_SendByte(DF_CMD_MAINMEMPAGEREAD);
 +	Dataflash_SendAddressBytes(CurrDFPage, CurrDFPageByte);
 +	Dataflash_SendByte(0x00);
 +	Dataflash_SendByte(0x00);
 +	Dataflash_SendByte(0x00);
 +	Dataflash_SendByte(0x00);
 +
 +	while (TotalBlocks)
 +	{
 +		uint8_t BytesInBlockDiv16 = 0;
 +		
 +		/* Write an endpoint packet sized data block to the dataflash */
 +		while (BytesInBlockDiv16 < (VIRTUAL_MEMORY_BLOCK_SIZE >> 4))
 +		{
 +			/* Check if end of dataflash page reached */
 +			if (CurrDFPageByteDiv16 == (DATAFLASH_PAGE_SIZE >> 4))
 +			{
 +				/* Reset the dataflash buffer counter, increment the page counter */
 +				CurrDFPageByteDiv16 = 0;
 +				CurrDFPage++;
 +
 +				/* Select the next dataflash chip based on the new dataflash page index */
 +				Dataflash_SelectChipFromPage(CurrDFPage);
 +				
 +				/* Send the dataflash main memory page read command */
 +				Dataflash_SendByte(DF_CMD_MAINMEMPAGEREAD);
 +				Dataflash_SendAddressBytes(CurrDFPage, 0);
 +				Dataflash_SendByte(0x00);
 +				Dataflash_SendByte(0x00);
 +				Dataflash_SendByte(0x00);
 +				Dataflash_SendByte(0x00);
 +			}	
 +
 +			/* Read one 16-byte chunk of data from the dataflash */
 +			for (uint8_t ByteNum = 0; ByteNum < 16; ByteNum++)
 +			  *(BufferPtr++) = Dataflash_ReceiveByte();
 +			
 +			/* Increment the dataflash page 16 byte block counter */
 +			CurrDFPageByteDiv16++;
 +			
 +			/* Increment the block 16 byte block counter */
 +			BytesInBlockDiv16++;
 +		}
 +		
 +		/* Decrement the blocks remaining counter */
 +		TotalBlocks--;
 +	}
 +
 +	/* Deselect all dataflash chips */
 +	Dataflash_DeselectChip();
 +}
 +
 +/** Disables the dataflash memory write protection bits on the board Dataflash ICs, if enabled. */
 +void DataflashManager_ResetDataflashProtections(void)
 +{
 +	/* Select first dataflash chip, send the read status register command */
 +	Dataflash_SelectChip(DATAFLASH_CHIP1);
 +	Dataflash_SendByte(DF_CMD_GETSTATUS);
 +	
 +	/* Check if sector protection is enabled */
 +	if (Dataflash_ReceiveByte() & DF_STATUS_SECTORPROTECTION_ON)
 +	{
 +		Dataflash_ToggleSelectedChipCS();
 +
 +		/* Send the commands to disable sector protection */
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[0]);
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[1]);
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[2]);
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[3]);
 +	}
 +	
 +	/* Select second dataflash chip (if present on selected board), send read status register command */
 +	#if (DATAFLASH_TOTALCHIPS == 2)
 +	Dataflash_SelectChip(DATAFLASH_CHIP2);
 +	Dataflash_SendByte(DF_CMD_GETSTATUS);
 +	
 +	/* Check if sector protection is enabled */
 +	if (Dataflash_ReceiveByte() & DF_STATUS_SECTORPROTECTION_ON)
 +	{
 +		Dataflash_ToggleSelectedChipCS();
 +
 +		/* Send the commands to disable sector protection */
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[0]);
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[1]);
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[2]);
 +		Dataflash_SendByte(DF_CMD_SECTORPROTECTIONOFF[3]);
 +	}
 +	#endif
 +	
 +	/* Deselect current dataflash chip */
 +	Dataflash_DeselectChip();
 +}
 +
 +/** Performs a simple test on the attached Dataflash IC(s) to ensure that they are working.
 + *
 + *  \return Boolean true if all media chips are working, false otherwise
 + */
 +bool DataflashManager_CheckDataflashOperation(void)
 +{
 +	uint8_t ReturnByte;
 +
 +	/* Test first Dataflash IC is present and responding to commands */
 +	Dataflash_SelectChip(DATAFLASH_CHIP1);
 +	Dataflash_SendByte(DF_CMD_READMANUFACTURERDEVICEINFO);
 +	ReturnByte = Dataflash_ReceiveByte();
 +	Dataflash_DeselectChip();
 +
 +	/* If returned data is invalid, fail the command */
 +	if (ReturnByte != DF_MANUFACTURER_ATMEL)
 +	  return false;
 +
 +	#if (DATAFLASH_TOTALCHIPS == 2)
 +	/* Test second Dataflash IC is present and responding to commands */
 +	Dataflash_SelectChip(DATAFLASH_CHIP2);
 +	Dataflash_SendByte(DF_CMD_READMANUFACTURERDEVICEINFO);
 +	ReturnByte = Dataflash_ReceiveByte();
 +	Dataflash_DeselectChip();
 +
 +	/* If returned data is invalid, fail the command */
 +	if (ReturnByte != DF_MANUFACTURER_ATMEL)
 +	  return false;
 +	#endif
 +	
 +	return true;
 +}
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/DataflashManager.h b/Projects/Incomplete/StandaloneProgrammer/Lib/DataflashManager.h new file mode 100644 index 0000000000..9b74b2eaaa --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/DataflashManager.h @@ -0,0 +1,81 @@ +/*
 +             LUFA Library
 +     Copyright (C) Dean Camera, 2009.
 +              
 +  dean [at] fourwalledcubicle [dot] com
 +      www.fourwalledcubicle.com
 +*/
 +
 +/*
 +  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 +
 +  Permission to use, copy, modify, and distribute this software
 +  and its documentation for any purpose and without fee is hereby
 +  granted, provided that the above copyright notice appear in all
 +  copies and that both that the copyright notice and this
 +  permission notice and warranty disclaimer appear in supporting
 +  documentation, and that the name of the author not be used in
 +  advertising or publicity pertaining to distribution of the
 +  software without specific, written prior permission.
 +
 +  The author disclaim all warranties with regard to this
 +  software, including all implied warranties of merchantability
 +  and fitness.  In no event shall the author be liable for any
 +  special, indirect or consequential damages or any damages
 +  whatsoever resulting from loss of use, data or profits, whether
 +  in an action of contract, negligence or other tortious action,
 +  arising out of or in connection with the use or performance of
 +  this software.
 +*/
 +
 +/** \file
 + *
 + *  Header file for DataflashManager.c.
 + */
 + 
 +#ifndef _DATAFLASH_MANAGER_H
 +#define _DATAFLASH_MANAGER_H
 +
 +	/* Includes: */
 +		#include <avr/io.h>
 +		
 +		#include "StandaloneProgrammer.h"
 +		#include "Descriptors.h"
 +
 +		#include <LUFA/Common/Common.h>                 // Function Attribute, Atomic, Debug and ISR Macros
 +		#include <LUFA/Drivers/USB/USB.h>               // USB Functionality
 +		#include <LUFA/Drivers/USB/Class/MassStorage.h> // Mass Storage Class Driver
 +		#include <LUFA/Drivers/Board/Dataflash.h>       // Dataflash chip driver
 +
 +	/* Preprocessor Checks: */
 +		#if (DATAFLASH_PAGE_SIZE % 16)
 +			#error Dataflash page size must be a multiple of 16 bytes.
 +		#endif
 +
 +	/* Defines: */
 +		/** Total number of bytes of the storage medium, comprised of one or more dataflash ICs. */
 +		#define VIRTUAL_MEMORY_BYTES                ((uint32_t)DATAFLASH_PAGES * DATAFLASH_PAGE_SIZE * DATAFLASH_TOTALCHIPS)
 +
 +		/** Block size of the device. This is kept at 512 to remain compatible with the OS despite the underlying
 +		 *  storage media (Dataflash) using a different native block size. Do not change this value.
 +		 */
 +		#define VIRTUAL_MEMORY_BLOCK_SIZE           512
 +		
 +		/** Total number of blocks of the virtual memory for reporting to the host as the device's total capacity. Do not
 +		 *  change this value; change VIRTUAL_MEMORY_BYTES instead to alter the media size.
 +		 */
 +		#define VIRTUAL_MEMORY_BLOCKS               (VIRTUAL_MEMORY_BYTES / VIRTUAL_MEMORY_BLOCK_SIZE)
 +		
 +	/* Function Prototypes: */
 +		void DataflashManager_WriteBlocks(USB_ClassInfo_MS_Device_t* MSInterfaceInfo, const uint32_t BlockAddress,
 +		                                  uint16_t TotalBlocks);
 +		void DataflashManager_ReadBlocks(USB_ClassInfo_MS_Device_t* MSInterfaceInfo, const uint32_t BlockAddress,
 +		                                 uint16_t TotalBlocks);
 +		void DataflashManager_WriteBlocks_RAM(const uint32_t BlockAddress, uint16_t TotalBlocks,
 +		                                      uint8_t* BufferPtr) ATTR_NON_NULL_PTR_ARG(3);
 +		void DataflashManager_ReadBlocks_RAM(const uint32_t BlockAddress, uint16_t TotalBlocks,
 +		                                     uint8_t* BufferPtr) ATTR_NON_NULL_PTR_ARG(3);
 +		void DataflashManager_ResetDataflashProtections(void);
 +		bool DataflashManager_CheckDataflashOperation(void);
 +		
 +#endif
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/00readme.txt b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/00readme.txt new file mode 100644 index 0000000000..594b9194c0 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/00readme.txt @@ -0,0 +1,36 @@ +Petit FatFs Module Source Files R0.01a                 (C)ChaN, 2009
 +
 +
 +FILES
 +
 +  pff.h      Common include file for Petit FatFs and application module.
 +  pff.c      Petit FatFs module.
 +  diskio.h   Common include file for Petit FatFs and disk I/O module.
 +  diskio.c   Skeleton of low level disk I/O module.
 +  integer.h  Alternative type definitions for integer variables.
 +
 +  Low level disk I/O module is not included in this archive because the Petit
 +  FatFs module is only a generic file system layer and not depend on any
 +  specific storage device. You have to provide a low level disk I/O module that
 +  written to control your storage device.
 +
 +
 +
 +AGREEMENTS
 +
 + Petit FatFs module is an open source software to implement FAT file system to
 + small embedded systems. This is a free software and is opened for education,
 + research and commercial developments under license policy of following trems.
 +
 +  Copyright (C) 2009, ChaN, all right reserved.
 +
 + * The Petit FatFs module is a free software and there is NO WARRANTY.
 + * No restriction on use. You can use, modify and redistribute it for
 +   personal, non-profit or commercial use UNDER YOUR RESPONSIBILITY.
 + * Redistributions of source code must retain the above copyright notice.
 +
 +
 +
 +REVISION HISTORY
 +
 +  Jun 15, 2009  R0.01a  First release (Branched from FatFs R0.07b)
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/diskio.c b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/diskio.c new file mode 100644 index 0000000000..0084fa5143 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/diskio.c @@ -0,0 +1,46 @@ +/*-----------------------------------------------------------------------*/
 +/* Low level disk I/O module skeleton for Petit FatFs (C)ChaN, 2009      */
 +/*-----------------------------------------------------------------------*/
 +
 +#include "diskio.h"
 +
 +#include <string.h>
 +#include "../DataflashManager.h"
 +
 +/*-----------------------------------------------------------------------*/
 +/* Initialize Disk Drive                                                 */
 +/*-----------------------------------------------------------------------*/
 +
 +DSTATUS disk_initialize (void)
 +{
 +	DSTATUS stat;
 +
 +	stat = RES_OK;
 +
 +	return stat;
 +}
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Read Partial Sector                                                   */
 +/*-----------------------------------------------------------------------*/
 +
 +DRESULT disk_readp (
 +	void* dest,			/* Pointer to the destination object */
 +	DWORD sector,		/* Sector number (LBA) */
 +	WORD sofs,			/* Offset in the sector */
 +	WORD count			/* Byte count (bit15:destination) */
 +)
 +{
 +	DRESULT res;
 +
 +	uint8_t BlockTemp[512];
 +	DataflashManager_ReadBlocks_RAM(sector, 1, BlockTemp);
 +	memcpy(dest, &BlockTemp[sofs], count);
 +
 +	res = RES_OK;
 +
 +	return res;
 +}
 +
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/diskio.h b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/diskio.h new file mode 100644 index 0000000000..c5ab064bab --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/diskio.h @@ -0,0 +1,36 @@ +/*-----------------------------------------------------------------------
 +/  PFF - Low level disk interface modlue include file    (C)ChaN, 2009
 +/-----------------------------------------------------------------------*/
 +
 +#ifndef _DISKIO
 +
 +#include "integer.h"
 +
 +
 +/* Status of Disk Functions */
 +typedef BYTE	DSTATUS;
 +
 +
 +/* Results of Disk Functions */
 +typedef enum {
 +	RES_OK = 0,		/* 0: Function succeeded */
 +	RES_ERROR,		/* 1: Disk error */
 +	RES_STRERR,		/* 2: Seream error */
 +	RES_NOTRDY,		/* 3: Not ready */
 +	RES_PARERR		/* 4: Invalid parameter */
 +} DRESULT;
 +
 +
 +/*---------------------------------------*/
 +/* Prototypes for disk control functions */
 +
 +DSTATUS disk_initialize (void);
 +DRESULT disk_readp (void*, DWORD, WORD, WORD);
 +
 +BOOL assign_drives (int argc, char *argv[]);
 +
 +#define STA_NOINIT		0x01	/* Drive not initialized */
 +#define STA_NODISK		0x02	/* No medium in the drive */
 +
 +#define _DISKIO
 +#endif
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/integer.h b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/integer.h new file mode 100644 index 0000000000..1d6bac3684 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/integer.h @@ -0,0 +1,37 @@ +/*-------------------------------------------*/
 +/* Integer type definitions for FatFs module */
 +/*-------------------------------------------*/
 +
 +#ifndef _INTEGER
 +
 +#if 0
 +#include <windows.h>
 +#else
 +
 +/* These types must be 16-bit, 32-bit or larger integer */
 +typedef int				INT;
 +typedef unsigned int	UINT;
 +
 +/* These types must be 8-bit integer */
 +typedef signed char		CHAR;
 +typedef unsigned char	UCHAR;
 +typedef unsigned char	BYTE;
 +
 +/* These types must be 16-bit integer */
 +typedef short			SHORT;
 +typedef unsigned short	USHORT;
 +typedef unsigned short	WORD;
 +typedef unsigned short	WCHAR;
 +
 +/* These types must be 32-bit integer */
 +typedef long			LONG;
 +typedef unsigned long	ULONG;
 +typedef unsigned long	DWORD;
 +
 +/* Boolean type */
 +typedef enum { FALSE = 0, TRUE } BOOL;
 +
 +#endif
 +
 +#define _INTEGER
 +#endif
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/pff.c b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/pff.c new file mode 100644 index 0000000000..126d45f4f9 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/pff.c @@ -0,0 +1,777 @@ +/*----------------------------------------------------------------------------/
 +/  Petit FatFs - FAT file system module  R0.01a                (C)ChaN, 2009
 +/-----------------------------------------------------------------------------/
 +/ Petit FatFs module is an open source software to implement FAT file system to
 +/ small embedded systems. This is a free software and is opened for education,
 +/ research and commercial developments under license policy of following trems.
 +/
 +/  Copyright (C) 2009, ChaN, all right reserved.
 +/
 +/ * The Petit FatFs module is a free software and there is NO WARRANTY.
 +/ * No restriction on use. You can use, modify and redistribute it for
 +/   personal, non-profit or commercial use UNDER YOUR RESPONSIBILITY.
 +/ * Redistributions of source code must retain the above copyright notice.
 +/
 +/-----------------------------------------------------------------------------/
 +/ Jun 15,'09 R0.01a  Branched from FatFs R0.07b
 +/----------------------------------------------------------------------------*/
 +
 +#include "pff.h"		/* Petit FatFs configurations and declarations */
 +#include "diskio.h"		/* Declarations of low level disk I/O functions */
 +
 +
 +/*--------------------------------------------------------------------------
 +
 +   Private Work Area
 +
 +---------------------------------------------------------------------------*/
 +
 +static
 +FATFS *FatFs;	/* Pointer to the file system object (logical drive) */
 +
 +
 +/*--------------------------------------------------------------------------
 +
 +   Private Functions
 +
 +---------------------------------------------------------------------------*/
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* String functions                                                      */
 +/*-----------------------------------------------------------------------*/
 +
 +/* Fill memory */
 +static
 +void mem_set (void* dst, int val, int cnt) {
 +	char *d = (char*)dst;
 +	while (cnt--) *d++ = (char)val;
 +}
 +
 +/* Compare memory to memory */
 +static
 +int mem_cmp (const void* dst, const void* src, int cnt) {
 +	const char *d = (const char *)dst, *s = (const char *)src;
 +	int r = 0;
 +	while (cnt-- && (r = *d++ - *s++) == 0) ;
 +	return r;
 +}
 +
 +/* Check if chr is contained in the string */
 +static
 +int chk_chr (const char* str, int chr) {
 +	while (*str && *str != chr) str++;
 +	return *str;
 +}
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* FAT access - Read value of a FAT entry                                */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +CLUST get_fat (	/* 1:IO error, Else:Cluster status */
 +	CLUST clst	/* Cluster# to get the link information */
 +)
 +{
 +	WORD wc, bc, ofs;
 +	BYTE buf[4];
 +	FATFS *fs = FatFs;
 +
 +
 +	if (clst < 2 || clst >= fs->max_clust)	/* Range check */
 +		return 1;
 +
 +	switch (fs->fs_type) {
 +	case FS_FAT12 :
 +		bc = (WORD)clst; bc += bc / 2;
 +		ofs = bc % 512; bc /= 512;
 +		if (ofs != 511) {
 +			if (disk_readp(buf, fs->fatbase + bc, ofs, 2)) break;
 +		} else {
 +			if (disk_readp(buf, fs->fatbase + bc, 511, 1)) break;
 +			if (disk_readp(buf+1, fs->fatbase + bc + 1, 0, 1)) break;
 +		}
 +		wc = LD_WORD(buf);
 +		return (clst & 1) ? (wc >> 4) : (wc & 0xFFF);
 +
 +	case FS_FAT16 :
 +		if (disk_readp(buf, fs->fatbase + clst / 256, (WORD)(((WORD)clst % 256) * 2), 2)) break;
 +		return LD_WORD(buf);
 +#if _FS_FAT32
 +	case FS_FAT32 :
 +		if (disk_readp(buf, fs->fatbase + clst / 128, (WORD)(((WORD)clst % 128) * 4), 4)) break;
 +		return LD_DWORD(buf) & 0x0FFFFFFF;
 +#endif
 +	}
 +
 +	return 1;	/* An error occured at the disk I/O layer */
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Get sector# from cluster#                                             */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +DWORD clust2sect (	/* !=0: Sector number, 0: Failed - invalid cluster# */
 +	CLUST clst		/* Cluster# to be converted */
 +)
 +{
 +	FATFS *fs = FatFs;
 +
 +
 +	clst -= 2;
 +	if (clst >= (fs->max_clust - 2)) return 0;		/* Invalid cluster# */
 +	return (DWORD)clst * fs->csize + fs->database;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Directory handling - Rewind directory index                           */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +FRESULT dir_rewind (
 +	DIR *dj			/* Pointer to directory object */
 +)
 +{
 +	CLUST clst;
 +	FATFS *fs = FatFs;
 +
 +
 +	dj->index = 0;
 +	clst = dj->sclust;
 +	if (clst == 1 || clst >= fs->max_clust)	/* Check start cluster range */
 +		return FR_DISK_ERR;
 +#if _FS_FAT32
 +	if (!clst && fs->fs_type == FS_FAT32)	/* Replace cluster# 0 with root cluster# if in FAT32 */
 +		clst = fs->dirbase;
 +#endif
 +	dj->clust = clst;						/* Current cluster */
 +	dj->sect = clst ? clust2sect(clst) : fs->dirbase;	/* Current sector */
 +
 +	return FR_OK;	/* Seek succeeded */
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Directory handling - Move directory index next                        */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +FRESULT dir_next (	/* FR_OK:Succeeded, FR_NO_FILE:End of table, FR_DENIED:EOT and could not streach */
 +	DIR *dj			/* Pointer to directory object */
 +)
 +{
 +	CLUST clst;
 +	WORD i;
 +	FATFS *fs = FatFs;
 +
 +
 +	i = dj->index + 1;
 +	if (!i || !dj->sect)	/* Report EOT when index has reached 65535 */
 +		return FR_NO_FILE;
 +
 +	if (!(i & (16-1))) {	/* Sector changed? */
 +		dj->sect++;			/* Next sector */
 +
 +		if (dj->clust == 0) {	/* Static table */
 +			if (i >= fs->n_rootdir)	/* Report EOT when end of table */
 +				return FR_NO_FILE;
 +		}
 +		else {					/* Dynamic table */
 +			if (((i / 16) & (fs->csize-1)) == 0) {	/* Cluster changed? */
 +				clst = get_fat(dj->clust);		/* Get next cluster */
 +				if (clst <= 1) return FR_DISK_ERR;
 +				if (clst >= fs->max_clust)		/* When it reached end of dynamic table */
 +					return FR_NO_FILE;			/* Report EOT */
 +				dj->clust = clst;				/* Initialize data for new cluster */
 +				dj->sect = clust2sect(clst);
 +			}
 +		}
 +	}
 +
 +	dj->index = i;
 +
 +	return FR_OK;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Directory handling - Find an object in the directory                  */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +FRESULT dir_find (
 +	DIR *dj			/* Pointer to the directory object linked to the file name */
 +)
 +{
 +	FRESULT res;
 +	BYTE c, *dir;
 +
 +
 +	res = dir_rewind(dj);			/* Rewind directory object */
 +	if (res != FR_OK) return res;
 +
 +	dir = FatFs->buf;
 +	do {
 +		res = disk_readp(dir, dj->sect, (WORD)((dj->index % 16) * 32), 32)	/* Read an entry */
 +			? FR_DISK_ERR : FR_OK;
 +		if (res != FR_OK) break;
 +		c = dir[DIR_Name];	/* First character */
 +		if (c == 0) { res = FR_NO_FILE; break; }	/* Reached to end of table */
 +		if (!(dir[DIR_Attr] & AM_VOL) && !mem_cmp(dir, dj->fn, 11)) /* Is it a valid entry? */
 +			break;
 +		res = dir_next(dj);							/* Next entry */
 +	} while (res == FR_OK);
 +
 +	return res;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Read an object from the directory                                     */
 +/*-----------------------------------------------------------------------*/
 +#if _USE_DIR
 +static
 +FRESULT dir_read (
 +	DIR *dj			/* Pointer to the directory object to store read object name */
 +)
 +{
 +	FRESULT res;
 +	BYTE a, c, *dir;
 +
 +
 +	res = FR_NO_FILE;
 +	while (dj->sect) {
 +		dir = FatFs->buf;
 +		res = disk_readp(dir, dj->sect, (WORD)((dj->index % 16) * 32), 32)	/* Read an entry */
 +			? FR_DISK_ERR : FR_OK;
 +		if (res != FR_OK) break;
 +		c = dir[DIR_Name];
 +		if (c == 0) { res = FR_NO_FILE; break; }	/* Reached to end of table */
 +		a = dir[DIR_Attr] & AM_MASK;
 +		if (c != 0xE5 && c != '.' && !(a & AM_VOL))	/* Is it a valid entry? */
 +			break;
 +		res = dir_next(dj);				/* Next entry */
 +		if (res != FR_OK) break;
 +	}
 +
 +	if (res != FR_OK) dj->sect = 0;
 +
 +	return res;
 +}
 +#endif
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Pick a segment and create the object name in directory form           */
 +/*-----------------------------------------------------------------------*/
 +
 +
 +static
 +FRESULT create_name (
 +	DIR *dj,			/* Pointer to the directory object */
 +	const char **path	/* Pointer to pointer to the segment in the path string */
 +)
 +{
 +	BYTE c, ni, si, i, *sfn;
 +	const char *p;
 +
 +	/* Create file name in directory form */
 +	sfn = dj->fn;
 +	mem_set(sfn, ' ', 11);
 +	si = i = 0; ni = 8;
 +	p = *path;
 +	for (;;) {
 +		c = p[si++];
 +		if (c < ' ' || c == '/') break;	/* Break on end of segment */
 +		if (c == '.' || i >= ni) {
 +			if (ni != 8 || c != '.') return FR_INVALID_NAME;
 +			i = 8; ni = 11;
 +			continue;
 +		}
 +		if (c >= 0x7F || chk_chr(" +,;[=\\]\"*:<>\?|", c))	/* Reject unallowable chrs for SFN */
 +			return FR_INVALID_NAME;
 +		if (c >='a' && c <= 'z') c -= 0x20;
 +		sfn[i++] = c;
 +	}
 +	if (!i) return FR_INVALID_NAME;		/* Reject null string */
 +	*path = &p[si];						/* Rerurn pointer to the next segment */
 +
 +	sfn[11] = (c < ' ') ? 1 : 0;		/* Set last segment flag if end of path */
 +
 +	return FR_OK;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Get file information from directory entry                             */
 +/*-----------------------------------------------------------------------*/
 +#if _USE_DIR
 +static
 +void get_fileinfo (		/* No return code */
 +	DIR *dj,			/* Pointer to the directory object */
 +	FILINFO *fno	 	/* Pointer to store the file information */
 +)
 +{
 +	BYTE i, c, *dir;
 +	char *p;
 +
 +
 +	p = fno->fname;
 +	if (dj->sect) {
 +		dir = FatFs->buf;
 +		for (i = 0; i < 8; i++) {	/* Copy file name body */
 +			c = dir[i];
 +			if (c == ' ') break;
 +			if (c == 0x05) c = 0xE5;
 +			*p++ = c;
 +		}
 +		if (dir[8] != ' ') {		/* Copy file name extension */
 +			*p++ = '.';
 +			for (i = 8; i < 11; i++) {
 +				c = dir[i];
 +				if (c == ' ') break;
 +				*p++ = c;
 +			}
 +		}
 +		fno->fattrib = dir[DIR_Attr];				/* Attribute */
 +		fno->fsize = LD_DWORD(dir+DIR_FileSize);	/* Size */
 +		fno->fdate = LD_WORD(dir+DIR_WrtDate);		/* Date */
 +		fno->ftime = LD_WORD(dir+DIR_WrtTime);		/* Time */
 +	}
 +	*p = 0;
 +}
 +#endif /* _USE_DIR */
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Follow a file path                                                    */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +FRESULT follow_path (	/* FR_OK(0): successful, !=0: error code */
 +	DIR *dj,			/* Directory object to return last directory and found object */
 +	const char *path	/* Full-path string to find a file or directory */
 +)
 +{
 +	FRESULT res;
 +	BYTE *dir;
 +
 +
 +	if (*path == '/') path++;			/* Strip heading separator */
 +	dj->sclust = 0;						/* Set start directory (always root dir) */
 +
 +	if ((BYTE)*path < ' ') {			/* Null path means the root directory */
 +		res = dir_rewind(dj);
 +		FatFs->buf[0] = 0;
 +
 +	} else {							/* Follow path */
 +		for (;;) {
 +			res = create_name(dj, &path);	/* Get a segment */
 +			if (res != FR_OK) break;
 +			res = dir_find(dj);				/* Find it */
 +			if (res != FR_OK) {				/* Could not find the object */
 +				if (res == FR_NO_FILE && !*(dj->fn+11))
 +					res = FR_NO_PATH;
 +				break;
 +			}
 +			if (*(dj->fn+11)) break;		/* Last segment match. Function completed. */
 +			dir = FatFs->buf;				/* There is next segment. Follow the sub directory */
 +			if (!(dir[DIR_Attr] & AM_DIR)) { /* Cannot follow because it is a file */
 +				res = FR_NO_PATH; break;
 +			}
 +			dj->sclust =
 +#if _FS_FAT32
 +				((DWORD)LD_WORD(dir+DIR_FstClusHI) << 16) | 
 +#endif
 +				LD_WORD(dir+DIR_FstClusLO);
 +		}
 +	}
 +
 +	return res;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Check a sector if it is an FAT boot record                            */
 +/*-----------------------------------------------------------------------*/
 +
 +static
 +BYTE check_fs (	/* 0:The FAT boot record, 1:Valid boot record but not an FAT, 2:Not a boot record, 3:Error */
 +	BYTE *buf,	/* Working buffer */
 +	DWORD sect	/* Sector# (lba) to check if it is an FAT boot record or not */
 +)
 +{
 +	if (disk_readp(buf, sect, 510, 2))		/* Read the boot sector */
 +		return 3;
 +	if (LD_WORD(buf) != 0xAA55)				/* Check record signature */
 +		return 2;
 +
 +	if (!disk_readp(buf, sect, BS_FilSysType, 2) && LD_WORD(buf) == 0x4146)	/* Check FAT12/16 */
 +		return 0;
 +#if _FS_FAT32
 +	if (!disk_readp(buf, sect, BS_FilSysType32, 2) && LD_WORD(buf) == 0x4146)	/* Check FAT32 */
 +		return 0;
 +#endif
 +	return 1;
 +}
 +
 +
 +
 +
 +/*--------------------------------------------------------------------------
 +
 +   Public Functions
 +
 +--------------------------------------------------------------------------*/
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Mount/Unmount a Locical Drive                                         */
 +/*-----------------------------------------------------------------------*/
 +
 +FRESULT pf_mount (
 +	FATFS *fs		/* Pointer to new file system object (NULL: Unmount) */
 +)
 +{
 +	BYTE fmt, buf[36];
 +	DWORD bsect, fsize, tsect, mclst;
 +
 +
 +	FatFs = 0;
 +	if (!fs) return FR_OK;				/* Unregister fs object */
 +
 +	if (disk_initialize() & STA_NOINIT)	/* Check if the drive is ready or not */
 +		return FR_NOT_READY;
 +
 +	/* Search FAT partition on the drive */
 +	bsect = 0;
 +	fmt = check_fs(buf, bsect);			/* Check sector 0 as an SFD format */
 +	if (fmt == 1) {						/* Not an FAT boot record, it may be FDISK format */
 +		/* Check a partition listed in top of the partition table */
 +		if (disk_readp(buf, bsect, MBR_Table, 16)) {	/* 1st partition entry */
 +			fmt = 3;
 +		} else {
 +			if (buf[4]) {					/* Is the partition existing? */
 +				bsect = LD_DWORD(&buf[8]);	/* Partition offset in LBA */
 +				fmt = check_fs(buf, bsect);	/* Check the partition */
 +			}
 +		}
 +	}
 +	if (fmt == 3) return FR_DISK_ERR;
 +	if (fmt) return FR_NO_FILESYSTEM;	/* No valid FAT patition is found */
 +
 +	/* Initialize the file system object */
 +	if (disk_readp(buf, bsect, 13, sizeof(buf))) return FR_DISK_ERR;
 +
 +	fsize = LD_WORD(buf+BPB_FATSz16-13);				/* Number of sectors per FAT */
 +	if (!fsize) fsize = LD_DWORD(buf+BPB_FATSz32-13);
 +
 +	fsize *= buf[BPB_NumFATs-13];						/* Number of sectors in FAT area */
 +	fs->fatbase = bsect + LD_WORD(buf+BPB_RsvdSecCnt-13); /* FAT start sector (lba) */
 +	fs->csize = buf[BPB_SecPerClus-13];					/* Number of sectors per cluster */
 +	fs->n_rootdir = LD_WORD(buf+BPB_RootEntCnt-13);		/* Nmuber of root directory entries */
 +	tsect = LD_WORD(buf+BPB_TotSec16-13);				/* Number of sectors on the file system */
 +	if (!tsect) tsect = LD_DWORD(buf+BPB_TotSec32-13);
 +	mclst = (tsect						/* Last cluster# + 1 */
 +		- LD_WORD(buf+BPB_RsvdSecCnt-13) - fsize - fs->n_rootdir / 16
 +		) / fs->csize + 2;
 +	fs->max_clust = (CLUST)mclst;
 +
 +	fmt = FS_FAT12;							/* Determine the FAT sub type */
 +	if (mclst >= 0xFF7) fmt = FS_FAT16;		/* Number of clusters >= 0xFF5 */
 +	if (mclst >= 0xFFF7)					/* Number of clusters >= 0xFFF5 */
 +#if _FS_FAT32
 +		fmt = FS_FAT32;
 +#else
 +		return FR_NO_FILESYSTEM;
 +#endif
 +
 +	fs->fs_type = fmt;		/* FAT sub-type */
 +#if _FS_FAT32
 +	if (fmt == FS_FAT32)
 +		fs->dirbase = LD_DWORD(buf+(BPB_RootClus-13));	/* Root directory start cluster */
 +	else
 +#endif
 +		fs->dirbase = fs->fatbase + fsize;				/* Root directory start sector (lba) */
 +	fs->database = fs->fatbase + fsize + fs->n_rootdir / 16;	/* Data start sector (lba) */
 +
 +	fs->flag = 0;
 +	FatFs = fs;
 +
 +	return FR_OK;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Open or Create a File                                                 */
 +/*-----------------------------------------------------------------------*/
 +
 +FRESULT pf_open (
 +	const char *path	/* Pointer to the file name */
 +)
 +{
 +	FRESULT res;
 +	DIR dj;
 +	BYTE sp[12], dir[32];
 +	FATFS *fs = FatFs;
 +
 +
 +	if (!fs)						/* Check file system */
 +		return FR_NOT_ENABLED;
 +
 +	fs->flag = 0;
 +	fs->buf = dir;
 +	dj.fn = sp;
 +	res = follow_path(&dj, path);	/* Follow the file path */
 +	if (res != FR_OK) return res;	/* Follow failed */
 +	if (!dir[0] || (dir[DIR_Attr] & AM_DIR))	/* It is a directory */
 +		return FR_NO_FILE;
 +
 +	fs->org_clust =						/* File start cluster */
 +#if _FS_FAT32
 +		((DWORD)LD_WORD(dir+DIR_FstClusHI) << 16) |
 +#endif
 +		LD_WORD(dir+DIR_FstClusLO);
 +	fs->fsize = LD_DWORD(dir+DIR_FileSize);	/* File size */
 +	fs->fptr = 0;						/* File pointer */
 +	fs->flag = FA_READ;
 +
 +	return FR_OK;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Read File                                                             */
 +/*-----------------------------------------------------------------------*/
 +
 +FRESULT pf_read (
 +	void* dest,		/* Pointer to the destination object */
 +	WORD btr,		/* Number of bytes to read (bit15:destination) */
 +	WORD* br		/* Pointer to number of bytes read */
 +)
 +{
 +	DRESULT dr;
 +	CLUST clst;
 +	DWORD sect, remain;
 +	WORD rcnt;
 +	BYTE *rbuff = dest;
 +	FATFS *fs = FatFs;
 +
 +
 +	*br = 0;
 +	if (!fs) return FR_NOT_ENABLED;		/* Check file system */
 +	if (!(fs->flag & FA_READ))
 +			return FR_INVALID_OBJECT;
 +
 +	remain = fs->fsize - fs->fptr;
 +	if (btr > remain) btr = (UINT)remain;			/* Truncate btr by remaining bytes */
 +
 +	for ( ;  btr;									/* Repeat until all data transferred */
 +		rbuff += rcnt, fs->fptr += rcnt, *br += rcnt, btr -= rcnt) {
 +		if ((fs->fptr % 512) == 0) {				/* On the sector boundary? */
 +			if ((fs->fptr / 512 % fs->csize) == 0) {	/* On the cluster boundary? */
 +				clst = (fs->fptr == 0) ?			/* On the top of the file? */
 +					fs->org_clust : get_fat(fs->curr_clust);
 +				if (clst <= 1) {
 +					fs->flag = 0; return FR_DISK_ERR;
 +				}
 +				fs->curr_clust = clst;				/* Update current cluster */
 +				fs->csect = 0;						/* Reset sector offset in the cluster */
 +			}
 +			sect = clust2sect(fs->curr_clust);		/* Get current sector */
 +			if (!sect) {
 +				fs->flag = 0; return FR_DISK_ERR;
 +			}
 +			sect += fs->csect;
 +			fs->dsect = sect;
 +			fs->csect++;							/* Next sector address in the cluster */
 +		}
 +		rcnt = 512 - ((WORD)fs->fptr % 512);		/* Get partial sector data from sector buffer */
 +		if (rcnt > btr) rcnt = btr;
 +		if (fs->flag & FA_STREAM) {
 +			dr = disk_readp(dest, fs->dsect, (WORD)(fs->fptr % 512), (WORD)(rcnt | 0x8000));
 +		} else {
 +			dr = disk_readp(rbuff, fs->dsect, (WORD)(fs->fptr % 512), rcnt);
 +		}
 +		if (dr) {
 +			fs->flag = 0;
 +			return (dr == RES_STRERR) ? FR_STREAM_ERR : FR_DISK_ERR;
 +		}
 +	}
 +
 +	return FR_OK;
 +}
 +
 +
 +
 +
 +#if _USE_LSEEK
 +/*-----------------------------------------------------------------------*/
 +/* Seek File R/W Pointer                                                 */
 +/*-----------------------------------------------------------------------*/
 +
 +FRESULT pf_lseek (
 +	DWORD ofs		/* File pointer from top of file */
 +)
 +{
 +	CLUST clst;
 +	DWORD bcs, nsect, ifptr;
 +	FATFS *fs = FatFs;
 +
 +
 +	if (!fs) return FR_NOT_ENABLED;		/* Check file system */
 +	if (!(fs->flag & FA_READ))
 +			return FR_INVALID_OBJECT;
 +
 +	if (ofs > fs->fsize) ofs = fs->fsize;	/* Clip offset with the file size */
 +	ifptr = fs->fptr;
 +	fs->fptr = 0;
 +	if (ofs > 0) {
 +		bcs = (DWORD)fs->csize * 512;	/* Cluster size (byte) */
 +		if (ifptr > 0 &&
 +			(ofs - 1) / bcs >= (ifptr - 1) / bcs) {	/* When seek to same or following cluster, */
 +			fs->fptr = (ifptr - 1) & ~(bcs - 1);	/* start from the current cluster */
 +			ofs -= fs->fptr;
 +			clst = fs->curr_clust;
 +		} else {							/* When seek to back cluster, */
 +			clst = fs->org_clust;			/* start from the first cluster */
 +			fs->curr_clust = clst;
 +		}
 +		while (ofs > bcs) {				/* Cluster following loop */
 +				clst = get_fat(clst);	/* Follow cluster chain if not in write mode */
 +			if (clst <= 1 || clst >= fs->max_clust) {
 +				fs->flag = 0; return FR_DISK_ERR;
 +			}
 +			fs->curr_clust = clst;
 +			fs->fptr += bcs;
 +			ofs -= bcs;
 +		}
 +		fs->fptr += ofs;
 +		fs->csect = (BYTE)(ofs / 512) + 1;	/* Sector offset in the cluster */
 +		nsect = clust2sect(clst);	/* Current sector */
 +		if (!nsect) {
 +			fs->flag = 0; return FR_DISK_ERR;
 +		}
 +		fs->dsect = nsect + fs->csect - 1;
 +	}
 +
 +	return FR_OK;
 +}
 +#endif
 +
 +
 +#if _USE_DIR
 +/*-----------------------------------------------------------------------*/
 +/* Create a Directroy Object                                             */
 +/*-----------------------------------------------------------------------*/
 +
 +FRESULT pf_opendir (
 +	DIR *dj,			/* Pointer to directory object to create */
 +	const char *path	/* Pointer to the directory path */
 +)
 +{
 +	FRESULT res;
 +	BYTE sp[12], dir[32];
 +	FATFS *fs = FatFs;
 +
 +
 +	if (!fs) {				/* Check file system */
 +		res = FR_NOT_ENABLED;
 +	} else {
 +		fs->buf = dir;
 +		dj->fn = sp;
 +		res = follow_path(dj, path);			/* Follow the path to the directory */
 +		if (res == FR_OK) {						/* Follow completed */
 +			if (dir[0]) {						/* It is not the root dir */
 +				if (dir[DIR_Attr] & AM_DIR) {	/* The object is a directory */
 +					dj->sclust =
 +#if _FS_FAT32
 +					((DWORD)LD_WORD(dir+DIR_FstClusHI) << 16) |
 +#endif
 +					LD_WORD(dir+DIR_FstClusLO);
 +				} else {						/* The object is not a directory */
 +					res = FR_NO_PATH;
 +				}
 +			}
 +			if (res == FR_OK) {
 +				res = dir_rewind(dj);			/* Rewind dir */
 +			}
 +		}
 +		if (res == FR_NO_FILE) res = FR_NO_PATH;
 +	}
 +
 +	return res;
 +}
 +
 +
 +
 +
 +/*-----------------------------------------------------------------------*/
 +/* Read Directory Entry in Sequense                                      */
 +/*-----------------------------------------------------------------------*/
 +
 +FRESULT pf_readdir (
 +	DIR *dj,			/* Pointer to the open directory object */
 +	FILINFO *fno		/* Pointer to file information to return */
 +)
 +{
 +	FRESULT res;
 +	BYTE sp[12], dir[32];
 +	FATFS *fs = FatFs;
 +
 +
 +	if (!fs) {				/* Check file system */
 +		res = FR_NOT_ENABLED;
 +	} else {
 +		fs->buf = dir;
 +		dj->fn = sp;
 +		if (!fno) {
 +			res = dir_rewind(dj);
 +		} else {
 +			res = dir_read(dj);
 +			if (res == FR_NO_FILE) {
 +				dj->sect = 0;
 +				res = FR_OK;
 +			}
 +			if (res == FR_OK) {				/* A valid entry is found */
 +				get_fileinfo(dj, fno);		/* Get the object information */
 +				res = dir_next(dj);			/* Increment index for next */
 +				if (res == FR_NO_FILE) {
 +					dj->sect = 0;
 +					res = FR_OK;
 +				}
 +			}
 +		}
 +	}
 +
 +	return res;
 +}
 +
 +#endif /* _FS_DIR */
 +
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/pff.h b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/pff.h new file mode 100644 index 0000000000..b24339c0c3 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/PetiteFATFs/pff.h @@ -0,0 +1,237 @@ +/*---------------------------------------------------------------------------/
 +/  Petit FatFs - FAT file system module include file  R0.01a   (C)ChaN, 2009
 +/----------------------------------------------------------------------------/
 +/ Petit FatFs module is an open source software to implement FAT file system to
 +/ small embedded systems. This is a free software and is opened for education,
 +/ research and commercial developments under license policy of following trems.
 +/
 +/  Copyright (C) 2009, ChaN, all right reserved.
 +/
 +/ * The Petit FatFs module is a free software and there is NO WARRANTY.
 +/ * No restriction on use. You can use, modify and redistribute it for
 +/   personal, non-profit or commercial use UNDER YOUR RESPONSIBILITY.
 +/ * Redistributions of source code must retain the above copyright notice.
 +/----------------------------------------------------------------------------*/
 +
 +#include "integer.h"
 +
 +/*---------------------------------------------------------------------------/
 +/ Petit FatFs Configuration Options
 +/
 +/ CAUTION! Do not forget to make clean the project after any changes to
 +/ the configuration options.
 +/
 +/----------------------------------------------------------------------------*/
 +#ifndef _FATFS
 +#define _FATFS
 +
 +#define _WORD_ACCESS	0
 +/* The _WORD_ACCESS option defines which access method is used to the word
 +/  data in the FAT structure.
 +/
 +/   0: Byte-by-byte access. Always compatible with all platforms.
 +/   1: Word access. Do not choose this unless following condition is met.
 +/
 +/  When the byte order on the memory is big-endian or address miss-aligned
 +/  word access results incorrect behavior, the _WORD_ACCESS must be set to 0.
 +/  If it is not the case, the value can also be set to 1 to improve the
 +/  performance and code efficiency. */
 +
 +
 +#define	_USE_DIR	0
 +/* To enable pf_opendir and pf_readdir function, set _USE_DIR to 1. */
 +
 +
 +#define	_USE_LSEEK	0
 +/* To enable pf_lseek function, set _USE_LSEEK to 1. */
 +
 +
 +#define _FS_FAT32	0
 +/* To enable FAT32 support, set _FS_FAT32 to 1. */
 +
 +
 +/* End of configuration options. Do not change followings without care.     */
 +/*--------------------------------------------------------------------------*/
 +
 +
 +#if _FS_FAT32
 +#define	CLUST	DWORD
 +#else
 +#define	CLUST	WORD
 +#endif
 +
 +
 +/* File system object structure */
 +
 +typedef struct _FATFS_ {
 +	BYTE	fs_type;	/* FAT sub type */
 +	BYTE	csize;		/* Number of sectors per cluster */
 +	BYTE	flag;		/* File status flags */
 +	BYTE	csect;		/* File sector address in the cluster */
 +	WORD	n_rootdir;	/* Number of root directory entries (0 on FAT32) */
 +	BYTE*	buf;		/* Pointer to the disk access buffer */
 +	CLUST	max_clust;	/* Maximum cluster# + 1. Number of clusters is max_clust - 2 */
 +	DWORD	fatbase;	/* FAT start sector */
 +	DWORD	dirbase;	/* Root directory start sector (Cluster# on FAT32) */
 +	DWORD	database;	/* Data start sector */
 +	DWORD	fptr;		/* File R/W pointer */
 +	DWORD	fsize;		/* File size */
 +	CLUST	org_clust;	/* File start cluster */
 +	CLUST	curr_clust;	/* File current cluster */
 +	DWORD	dsect;		/* File current data sector */
 +} FATFS;
 +
 +
 +
 +/* Directory object structure */
 +
 +typedef struct _DIR_ {
 +	WORD	index;		/* Current read/write index number */
 +	BYTE*	fn;			/* Pointer to the SFN (in/out) {file[8],ext[3],status[1]} */
 +	CLUST	sclust;		/* Table start cluster (0:Static table) */
 +	CLUST	clust;		/* Current cluster */
 +	DWORD	sect;		/* Current sector */
 +} DIR;
 +
 +
 +
 +/* File status structure */
 +
 +typedef struct _FILINFO_ {
 +	DWORD	fsize;		/* File size */
 +	WORD	fdate;		/* Last modified date */
 +	WORD	ftime;		/* Last modified time */
 +	BYTE	fattrib;	/* Attribute */
 +	char	fname[13];	/* File name */
 +} FILINFO;
 +
 +
 +
 +/* File function return code (FRESULT) */
 +
 +typedef enum {
 +	FR_OK = 0,			/* 0 */
 +	FR_DISK_ERR,		/* 1 */
 +	FR_NOT_READY,		/* 2 */
 +	FR_NO_FILE,			/* 3 */
 +	FR_NO_PATH,			/* 4 */
 +	FR_INVALID_NAME,	/* 5 */
 +	FR_STREAM_ERR,		/* 6 */
 +	FR_INVALID_OBJECT,	/* 7 */
 +	FR_NOT_ENABLED,		/* 8 */
 +	FR_NO_FILESYSTEM	/* 9 */
 +} FRESULT;
 +
 +
 +
 +/*--------------------------------------------------------------*/
 +/* Petit FatFs module application interface                     */
 +
 +FRESULT pf_mount (FATFS*);				/* Mount/Unmount a logical drive */
 +FRESULT pf_open (const char*);			/* Open a file */
 +FRESULT pf_read (void*, WORD, WORD*);	/* Read data from a file */
 +FRESULT pf_lseek (DWORD);				/* Move file pointer of a file object */
 +FRESULT pf_opendir (DIR*, const char*);	/* Open an existing directory */
 +FRESULT pf_readdir (DIR*, FILINFO*);	/* Read a directory item */
 +
 +
 +
 +/*--------------------------------------------------------------*/
 +/* Flags and offset address                                     */
 +
 +/* File status flag (FATFS.flag) */
 +
 +#define	FA_READ		0x01
 +#define	FA_STREAM	0x40
 +#define	FA__ERROR	0x80
 +
 +
 +/* FAT sub type (FATFS.fs_type) */
 +
 +#define FS_FAT12	1
 +#define FS_FAT16	2
 +#define FS_FAT32	3
 +
 +
 +/* File attribute bits for directory entry */
 +
 +#define	AM_RDO	0x01	/* Read only */
 +#define	AM_HID	0x02	/* Hidden */
 +#define	AM_SYS	0x04	/* System */
 +#define	AM_VOL	0x08	/* Volume label */
 +#define AM_LFN	0x0F	/* LFN entry */
 +#define AM_DIR	0x10	/* Directory */
 +#define AM_ARC	0x20	/* Archive */
 +#define AM_MASK	0x3F	/* Mask of defined bits */
 +
 +
 +/* FatFs refers the members in the FAT structures with byte offset instead
 +/ of structure member because there are incompatibility of the packing option
 +/ between various compilers. */
 +
 +#define BS_jmpBoot			0
 +#define BS_OEMName			3
 +#define BPB_BytsPerSec		11
 +#define BPB_SecPerClus		13
 +#define BPB_RsvdSecCnt		14
 +#define BPB_NumFATs			16
 +#define BPB_RootEntCnt		17
 +#define BPB_TotSec16		19
 +#define BPB_Media			21
 +#define BPB_FATSz16			22
 +#define BPB_SecPerTrk		24
 +#define BPB_NumHeads		26
 +#define BPB_HiddSec			28
 +#define BPB_TotSec32		32
 +#define BS_55AA				510
 +
 +#define BS_DrvNum			36
 +#define BS_BootSig			38
 +#define BS_VolID			39
 +#define BS_VolLab			43
 +#define BS_FilSysType		54
 +
 +#define BPB_FATSz32			36
 +#define BPB_ExtFlags		40
 +#define BPB_FSVer			42
 +#define BPB_RootClus		44
 +#define BPB_FSInfo			48
 +#define BPB_BkBootSec		50
 +#define BS_DrvNum32			64
 +#define BS_BootSig32		66
 +#define BS_VolID32			67
 +#define BS_VolLab32			71
 +#define BS_FilSysType32		82
 +
 +#define MBR_Table			446
 +
 +#define	DIR_Name			0
 +#define	DIR_Attr			11
 +#define	DIR_NTres			12
 +#define	DIR_CrtTime			14
 +#define	DIR_CrtDate			16
 +#define	DIR_FstClusHI		20
 +#define	DIR_WrtTime			22
 +#define	DIR_WrtDate			24
 +#define	DIR_FstClusLO		26
 +#define	DIR_FileSize		28
 +
 +
 +
 +/*--------------------------------*/
 +/* Multi-byte word access macros  */
 +
 +#if _WORD_ACCESS == 1	/* Enable word access to the FAT structure */
 +#define	LD_WORD(ptr)		(WORD)(*(WORD*)(BYTE*)(ptr))
 +#define	LD_DWORD(ptr)		(DWORD)(*(DWORD*)(BYTE*)(ptr))
 +#define	ST_WORD(ptr,val)	*(WORD*)(BYTE*)(ptr)=(WORD)(val)
 +#define	ST_DWORD(ptr,val)	*(DWORD*)(BYTE*)(ptr)=(DWORD)(val)
 +#else					/* Use byte-by-byte access to the FAT structure */
 +#define	LD_WORD(ptr)		(WORD)(((WORD)*(BYTE*)((ptr)+1)<<8)|(WORD)*(BYTE*)(ptr))
 +#define	LD_DWORD(ptr)		(DWORD)(((DWORD)*(BYTE*)((ptr)+3)<<24)|((DWORD)*(BYTE*)((ptr)+2)<<16)|((WORD)*(BYTE*)((ptr)+1)<<8)|*(BYTE*)(ptr))
 +#define	ST_WORD(ptr,val)	*(BYTE*)(ptr)=(BYTE)(val); *(BYTE*)((ptr)+1)=(BYTE)((WORD)(val)>>8)
 +#define	ST_DWORD(ptr,val)	*(BYTE*)(ptr)=(BYTE)(val); *(BYTE*)((ptr)+1)=(BYTE)((WORD)(val)>>8); *(BYTE*)((ptr)+2)=(BYTE)((DWORD)(val)>>16); *(BYTE*)((ptr)+3)=(BYTE)((DWORD)(val)>>24)
 +#endif
 +
 +
 +#endif /* _FATFS */
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/ProgrammerConfig.c b/Projects/Incomplete/StandaloneProgrammer/Lib/ProgrammerConfig.c new file mode 100644 index 0000000000..2f3d95ba6a --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/ProgrammerConfig.c @@ -0,0 +1,77 @@ +/*
 +             LUFA Library
 +     Copyright (C) Dean Camera, 2009.
 +              
 +  dean [at] fourwalledcubicle [dot] com
 +      www.fourwalledcubicle.com
 +*/
 +
 +/*
 +  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 +
 +  Permission to use, copy, modify, and distribute this software
 +  and its documentation for any purpose and without fee is hereby
 +  granted, provided that the above copyright notice appear in all
 +  copies and that both that the copyright notice and this
 +  permission notice and warranty disclaimer appear in supporting
 +  documentation, and that the name of the author not be used in
 +  advertising or publicity pertaining to distribution of the
 +  software without specific, written prior permission.
 +
 +  The author disclaim all warranties with regard to this
 +  software, including all implied warranties of merchantability
 +  and fitness.  In no event shall the author be liable for any
 +  special, indirect or consequential damages or any damages
 +  whatsoever resulting from loss of use, data or profits, whether
 +  in an action of contract, negligence or other tortious action,
 +  arising out of or in connection with the use or performance of
 +  this software.
 +*/
 +
 +#include "ProgrammerConfig.h"
 +
 +struct
 +{
 +	uint16_t SigBytes[4];
 +	bool EnforceSigBytes;
 +	
 +	uint32_t ProgrammingSpeed;
 +} ProgrammerConfig;
 +
 +bool ProgrammerConfig_ProcessConfiguration(void)
 +{
 +	memset(&ProgrammerConfig, sizeof(ProgrammerConfig), 0x00);
 +
 +	if (!(pf_open("CONF.txt") == FR_OK))
 +	{
 +		fputs(" >> ERROR: CONF.txt File Not Found.\r\n", &USBSerialStream);
 +		return false;
 +	}
 +	
 +	char  LineBuff[100];
 +	char* CurrentLine;
 +			
 +	do
 +	{
 +		CurrentLine = fgets(LineBuff, sizeof(LineBuff), &DataflashStream);
 +		
 +		if (CurrentLine)
 +		{
 +			sscanf(CurrentLine, "SIGNATURE = %02x %02x %02x %02x", &ProgrammerConfig.SigBytes[0],
 +			                                                       &ProgrammerConfig.SigBytes[1],
 +			                                                       &ProgrammerConfig.SigBytes[2],
 +			                                                       &ProgrammerConfig.SigBytes[3]);
 +
 +			sscanf(CurrentLine, "SPEED = %lu", &ProgrammerConfig.ProgrammingSpeed);
 +		}
 +	} while (CurrentLine);
 +	
 +	fprintf(&USBSerialStream, " >> *** Configuration: ***\r\n");
 +	fprintf(&USBSerialStream, " >> Device Signature: 0x%02x 0x%02x 0x%02x 0x%02x\r\n", ProgrammerConfig.SigBytes[0],
 +			                                                                           ProgrammerConfig.SigBytes[1],
 +			                                                                           ProgrammerConfig.SigBytes[2],
 +			                                                                           ProgrammerConfig.SigBytes[3]);
 +	fprintf(&USBSerialStream, " >> Programming Speed: %lu Hz\r\n", ProgrammerConfig.ProgrammingSpeed);
 +	
 +	return true;
 +}
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/ProgrammerConfig.h b/Projects/Incomplete/StandaloneProgrammer/Lib/ProgrammerConfig.h new file mode 100644 index 0000000000..8067097497 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/ProgrammerConfig.h @@ -0,0 +1,44 @@ +/*
 +             LUFA Library
 +     Copyright (C) Dean Camera, 2009.
 +              
 +  dean [at] fourwalledcubicle [dot] com
 +      www.fourwalledcubicle.com
 +*/
 +
 +/*
 +  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 +
 +  Permission to use, copy, modify, and distribute this software
 +  and its documentation for any purpose and without fee is hereby
 +  granted, provided that the above copyright notice appear in all
 +  copies and that both that the copyright notice and this
 +  permission notice and warranty disclaimer appear in supporting
 +  documentation, and that the name of the author not be used in
 +  advertising or publicity pertaining to distribution of the
 +  software without specific, written prior permission.
 +
 +  The author disclaim all warranties with regard to this
 +  software, including all implied warranties of merchantability
 +  and fitness.  In no event shall the author be liable for any
 +  special, indirect or consequential damages or any damages
 +  whatsoever resulting from loss of use, data or profits, whether
 +  in an action of contract, negligence or other tortious action,
 +  arising out of or in connection with the use or performance of
 +  this software.
 +*/
 +
 +#ifndef _PROGRAMMER_CONFIG_H_
 +#define _PROGRAMMER_CONFIG_H_
 +
 +	/* Includes: */
 +		#include <stdio.h>
 +		#include <string.h>
 +		#include <stdbool.h>
 +		
 +		#include "../StandaloneProgrammer.h"
 +
 +	/* Function Prototypes: */
 +		bool ProgrammerConfig_ProcessConfiguration(void);
 +
 +#endif
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/SCSI.c b/Projects/Incomplete/StandaloneProgrammer/Lib/SCSI.c new file mode 100644 index 0000000000..6a978718f2 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/SCSI.c @@ -0,0 +1,281 @@ +/*
 +             LUFA Library
 +     Copyright (C) Dean Camera, 2009.
 +              
 +  dean [at] fourwalledcubicle [dot] com
 +      www.fourwalledcubicle.com
 +*/
 +
 +/*
 +  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 +
 +  Permission to use, copy, modify, and distribute this software
 +  and its documentation for any purpose and without fee is hereby
 +  granted, provided that the above copyright notice appear in all
 +  copies and that both that the copyright notice and this
 +  permission notice and warranty disclaimer appear in supporting
 +  documentation, and that the name of the author not be used in
 +  advertising or publicity pertaining to distribution of the
 +  software without specific, written prior permission.
 +
 +  The author disclaim all warranties with regard to this
 +  software, including all implied warranties of merchantability
 +  and fitness.  In no event shall the author be liable for any
 +  special, indirect or consequential damages or any damages
 +  whatsoever resulting from loss of use, data or profits, whether
 +  in an action of contract, negligence or other tortious action,
 +  arising out of or in connection with the use or performance of
 +  this software.
 +*/
 +
 +/** \file
 + *
 + *  SCSI command processing routines, for SCSI commands issued by the host. Mass Storage
 + *  devices use a thin "Bulk-Only Transport" protocol for issuing commands and status information,
 + *  which wrap around standard SCSI device commands for controlling the actual storage medium.
 + */
 + 
 +#define  INCLUDE_FROM_SCSI_C
 +#include "SCSI.h"
 +
 +/** Structure to hold the SCSI response data to a SCSI INQUIRY command. This gives information about the device's
 + *  features and capabilities.
 + */
 +SCSI_Inquiry_Response_t InquiryData = 
 +	{
 +		.DeviceType          = DEVICE_TYPE_BLOCK,
 +		.PeripheralQualifier = 0,
 +			
 +		.Removable           = true,
 +			
 +		.Version             = 0,
 +			
 +		.ResponseDataFormat  = 2,
 +		.NormACA             = false,
 +		.TrmTsk              = false,
 +		.AERC                = false,
 +
 +		.AdditionalLength    = 0x1F,
 +			
 +		.SoftReset           = false,
 +		.CmdQue              = false,
 +		.Linked              = false,
 +		.Sync                = false,
 +		.WideBus16Bit        = false,
 +		.WideBus32Bit        = false,
 +		.RelAddr             = false,
 +		
 +		.VendorID            = "LUFA",
 +		.ProductID           = "Dataflash Disk",
 +		.RevisionID          = {'0','.','0','0'},
 +	};
 +
 +/** Structure to hold the sense data for the last issued SCSI command, which is returned to the host after a SCSI REQUEST SENSE
 + *  command is issued. This gives information on exactly why the last command failed to complete.
 + */
 +SCSI_Request_Sense_Response_t SenseData =
 +	{
 +		.ResponseCode        = 0x70,
 +		.AdditionalLength    = 0x0A,
 +	};
 +
 +
 +/** Main routine to process the SCSI command located in the Command Block Wrapper read from the host. This dispatches
 + *  to the appropriate SCSI command handling routine if the issued command is supported by the device, else it returns
 + *  a command failure due to a ILLEGAL REQUEST.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
 + */
 +bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* MSInterfaceInfo)
 +{
 +	/* Set initial sense data, before the requested command is processed */
 +	SCSI_SET_SENSE(SCSI_SENSE_KEY_GOOD,
 +	               SCSI_ASENSE_NO_ADDITIONAL_INFORMATION,
 +	               SCSI_ASENSEQ_NO_QUALIFIER);
 +					   
 +	/* Run the appropriate SCSI command hander function based on the passed command */
 +	switch (MSInterfaceInfo->State.CommandBlock.SCSICommandData[0])
 +	{
 +		case SCSI_CMD_INQUIRY:
 +			SCSI_Command_Inquiry(MSInterfaceInfo);			
 +			break;
 +		case SCSI_CMD_REQUEST_SENSE:
 +			SCSI_Command_Request_Sense(MSInterfaceInfo);
 +			break;
 +		case SCSI_CMD_READ_CAPACITY_10:
 +			SCSI_Command_Read_Capacity_10(MSInterfaceInfo);			
 +			break;
 +		case SCSI_CMD_SEND_DIAGNOSTIC:
 +			SCSI_Command_Send_Diagnostic(MSInterfaceInfo);
 +			break;
 +		case SCSI_CMD_WRITE_10:
 +			SCSI_Command_ReadWrite_10(MSInterfaceInfo, DATA_WRITE);
 +			break;
 +		case SCSI_CMD_READ_10:
 +			SCSI_Command_ReadWrite_10(MSInterfaceInfo, DATA_READ);
 +			break;
 +		case SCSI_CMD_TEST_UNIT_READY:
 +		case SCSI_CMD_PREVENT_ALLOW_MEDIUM_REMOVAL:
 +		case SCSI_CMD_VERIFY_10:
 +			/* These commands should just succeed, no handling required */
 +			MSInterfaceInfo->State.CommandBlock.DataTransferLength = 0;
 +			break;
 +		default:
 +			/* Update the SENSE key to reflect the invalid command */
 +			SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
 +		                   SCSI_ASENSE_INVALID_COMMAND,
 +		                   SCSI_ASENSEQ_NO_QUALIFIER);
 +			break;
 +	}
 +
 +	return (SenseData.SenseKey == SCSI_SENSE_KEY_GOOD);
 +}
 +
 +/** Command processing for an issued SCSI INQUIRY command. This command returns information about the device's features
 + *  and capabilities to the host.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
 + */
 +static void SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* MSInterfaceInfo)
 +{
 +	uint16_t AllocationLength  = (((uint16_t)MSInterfaceInfo->State.CommandBlock.SCSICommandData[3] << 8) |
 +	                                         MSInterfaceInfo->State.CommandBlock.SCSICommandData[4]);
 +	uint16_t BytesTransferred  = (AllocationLength < sizeof(InquiryData))? AllocationLength :
 +	                                                                       sizeof(InquiryData);
 +
 +	/* Only the standard INQUIRY data is supported, check if any optional INQUIRY bits set */
 +	if ((MSInterfaceInfo->State.CommandBlock.SCSICommandData[1] & ((1 << 0) | (1 << 1))) ||
 +	     MSInterfaceInfo->State.CommandBlock.SCSICommandData[2])
 +	{
 +		/* Optional but unsupported bits set - update the SENSE key and fail the request */
 +		SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
 +		               SCSI_ASENSE_INVALID_FIELD_IN_CDB,
 +		               SCSI_ASENSEQ_NO_QUALIFIER);
 +
 +		return;
 +	}
 +	
 +	Endpoint_Write_Stream_LE(&InquiryData, BytesTransferred, NO_STREAM_CALLBACK);
 +
 +	uint8_t PadBytes[AllocationLength - BytesTransferred];
 +	
 +	/* Pad out remaining bytes with 0x00 */
 +	Endpoint_Write_Stream_LE(&PadBytes, (AllocationLength - BytesTransferred), NO_STREAM_CALLBACK);
 +
 +	/* Finalize the stream transfer to send the last packet */
 +	Endpoint_ClearIN();
 +
 +	/* Succeed the command and update the bytes transferred counter */
 +	MSInterfaceInfo->State.CommandBlock.DataTransferLength -= BytesTransferred;
 +}
 +
 +/** Command processing for an issued SCSI REQUEST SENSE command. This command returns information about the last issued command,
 + *  including the error code and additional error information so that the host can determine why a command failed to complete.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
 + */
 +static void SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* MSInterfaceInfo)
 +{
 +	uint8_t  AllocationLength = MSInterfaceInfo->State.CommandBlock.SCSICommandData[4];
 +	uint8_t  BytesTransferred = (AllocationLength < sizeof(SenseData))? AllocationLength : sizeof(SenseData);
 +	
 +	uint8_t PadBytes[AllocationLength - BytesTransferred];
 +
 +	Endpoint_Write_Stream_LE(&SenseData, BytesTransferred, NO_STREAM_CALLBACK);
 +	Endpoint_Write_Stream_LE(&PadBytes, (AllocationLength - BytesTransferred), NO_STREAM_CALLBACK);
 +	Endpoint_ClearIN();
 +
 +	/* Succeed the command and update the bytes transferred counter */
 +	MSInterfaceInfo->State.CommandBlock.DataTransferLength -= BytesTransferred;
 +}
 +
 +/** Command processing for an issued SCSI READ CAPACITY (10) command. This command returns information about the device's capacity
 + *  on the selected Logical Unit (drive), as a number of OS-sized blocks.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
 + */
 +static void SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* MSInterfaceInfo)
 +{
 +	uint32_t LastBlockAddressInLUN = (VIRTUAL_MEMORY_BLOCKS - 1);
 +	uint32_t MediaBlockSize        = VIRTUAL_MEMORY_BLOCK_SIZE;
 +
 +	Endpoint_Write_Stream_BE(&LastBlockAddressInLUN, sizeof(LastBlockAddressInLUN), NO_STREAM_CALLBACK);
 +	Endpoint_Write_Stream_BE(&MediaBlockSize, sizeof(MediaBlockSize), NO_STREAM_CALLBACK);
 +	Endpoint_ClearIN();
 +	
 +	/* Succeed the command and update the bytes transferred counter */
 +	MSInterfaceInfo->State.CommandBlock.DataTransferLength -= 8;
 +}
 +
 +/** Command processing for an issued SCSI SEND DIAGNOSTIC command. This command performs a quick check of the Dataflash ICs on the
 + *  board, and indicates if they are present and functioning correctly. Only the Self-Test portion of the diagnostic command is
 + *  supported.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
 + */
 +static void SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* MSInterfaceInfo)
 +{
 +	/* Check to see if the SELF TEST bit is not set */
 +	if (!(MSInterfaceInfo->State.CommandBlock.SCSICommandData[1] & (1 << 2)))
 +	{
 +		/* Only self-test supported - update SENSE key and fail the command */
 +		SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
 +		               SCSI_ASENSE_INVALID_FIELD_IN_CDB,
 +		               SCSI_ASENSEQ_NO_QUALIFIER);
 +
 +		return;
 +	}
 +	
 +	/* Check to see if all attached Dataflash ICs are functional */
 +	if (!(DataflashManager_CheckDataflashOperation()))
 +	{
 +		/* Update SENSE key with a hardware error condition and return command fail */
 +		SCSI_SET_SENSE(SCSI_SENSE_KEY_HARDWARE_ERROR,
 +		               SCSI_ASENSE_NO_ADDITIONAL_INFORMATION,
 +		               SCSI_ASENSEQ_NO_QUALIFIER);	
 +	
 +		return;
 +	}
 +	
 +	/* Succeed the command and update the bytes transferred counter */
 +	MSInterfaceInfo->State.CommandBlock.DataTransferLength = 0;
 +}
 +
 +/** Command processing for an issued SCSI READ (10) or WRITE (10) command. This command reads in the block start address
 + *  and total number of blocks to process, then calls the appropriate low-level dataflash routine to handle the actual
 + *  reading and writing of the data.
 + *
 + *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
 + *  \param[in] IsDataRead  Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
 + */
 +static void SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* MSInterfaceInfo, const bool IsDataRead)
 +{
 +	uint32_t BlockAddress;
 +	uint16_t TotalBlocks;
 +	
 +	/* Load in the 32-bit block address (SCSI uses big-endian, so have to reverse the byte order) */
 +	BlockAddress = SwapEndian_32(*(uint32_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[2]);
 +
 +	/* Load in the 16-bit total blocks (SCSI uses big-endian, so have to reverse the byte order) */
 +	TotalBlocks  = SwapEndian_16(*(uint32_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[7]);
 +	
 +	/* Check if the block address is outside the maximum allowable value for the LUN */
 +	if (BlockAddress >= VIRTUAL_MEMORY_BLOCKS)
 +	{
 +		/* Block address is invalid, update SENSE key and return command fail */
 +		SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
 +		               SCSI_ASENSE_LOGICAL_BLOCK_ADDRESS_OUT_OF_RANGE,
 +		               SCSI_ASENSEQ_NO_QUALIFIER);
 +
 +		return;
 +	}
 +	
 +	/* Determine if the packet is a READ (10) or WRITE (10) command, call appropriate function */
 +	if (IsDataRead == DATA_READ)
 +	  DataflashManager_ReadBlocks(MSInterfaceInfo, BlockAddress, TotalBlocks);
 +	else
 +	  DataflashManager_WriteBlocks(MSInterfaceInfo, BlockAddress, TotalBlocks);
 +
 +	/* Update the bytes transferred counter and succeed the command */
 +	MSInterfaceInfo->State.CommandBlock.DataTransferLength -= ((uint32_t)TotalBlocks * VIRTUAL_MEMORY_BLOCK_SIZE);
 +}
 diff --git a/Projects/Incomplete/StandaloneProgrammer/Lib/SCSI.h b/Projects/Incomplete/StandaloneProgrammer/Lib/SCSI.h new file mode 100644 index 0000000000..91ba77dd51 --- /dev/null +++ b/Projects/Incomplete/StandaloneProgrammer/Lib/SCSI.h @@ -0,0 +1,146 @@ +/*
 +             LUFA Library
 +     Copyright (C) Dean Camera, 2009.
 +              
 +  dean [at] fourwalledcubicle [dot] com
 +      www.fourwalledcubicle.com
 +*/
 +
 +/*
 +  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 +
 +  Permission to use, copy, modify, and distribute this software
 +  and its documentation for any purpose and without fee is hereby
 +  granted, provided that the above copyright notice appear in all
 +  copies and that both that the copyright notice and this
 +  permission notice and warranty disclaimer appear in supporting
 +  documentation, and that the name of the author not be used in
 +  advertising or publicity pertaining to distribution of the
 +  software without specific, written prior permission.
 +
 +  The author disclaim all warranties with regard to this
 +  software, including all implied warranties of merchantability
 +  and fitness.  In no event shall the author be liable for any
 +  special, indirect or consequential damages or any damages
 +  whatsoever resulting from loss of use, data or profits, whether
 +  in an action of contract, negligence or other tortious action,
 +  arising out of or in connection with the use or performance of
 +  this software.
 +*/
 +
 +/** \file
 + *
 + *  Header file for SCSI.c.
 + */
 + 
 +#ifndef _SCSI_H_
 +#define _SCSI_H_
 +
 +	/* Includes: */
 +		#include <avr/io.h>
 +		#include <avr/pgmspace.h>
 +
 +		#include <LUFA/Drivers/USB/USB.h>
 +		#include <LUFA/Drivers/USB/Class/MassStorage.h>
 +
 +		#include "Descriptors.h"
 +		#include "DataflashManager.h"
 +	
 +	/* Macros: */
 +		/** Macro to set the current SCSI sense data to the given key, additional sense code and additional sense qualifier. This
 +		 *  is for convenience, as it allows for all three sense values (returned upon request to the host to give information about
 +		 *  the last command failure) in a quick and easy manner.
 +		 *
 +		 *  \param[in] key    New SCSI sense key to set the sense code to
 +		 *  \param[in] acode  New SCSI additional sense key to set the additional sense code to
 +		 *  \param[in] aqual  New SCSI additional sense key qualifier to set the additional sense qualifier code to
 +		 */
 +		#define SCSI_SET_SENSE(key, acode, aqual)  MACROS{ SenseData.SenseKey = key;              \
 +		                                                   SenseData.AdditionalSenseCode = acode; \
 +		                                                   SenseData.AdditionalSenseQualifier = aqual; }MACROE
 +
 +		/** Macro for the SCSI_Command_ReadWrite_10() function, to indicate that data is to be read from the storage medium. */
 +		#define DATA_READ           true
 +
 +		/** Macro for the SCSI_Command_ReadWrite_10() function, to indicate that data is to be written to the storage medium. */
 +		#define DATA_WRITE          false
 +
 +		/** Value for the DeviceType entry in the SCSI_Inquiry_Response_t enum, indicating a Block Media device. */
 +		#define DEVICE_TYPE_BLOCK   0x00
 +		
 +		/** Value for the DeviceType entry in the SCSI_Inquiry_Response_t enum, indicating a CD-ROM device. */
 +		#define DEVICE_TYPE_CDROM   0x05
 +
 +	/* Type Defines: */
 +		/** Type define for a SCSI response structure to a SCSI INQUIRY command. For details of the
 +		 *  structure contents, refer to the SCSI specifications.
 +		 */
 +		typedef struct
 +		{
 +			unsigned char DeviceType          : 5;
 +			unsigned char PeripheralQualifier : 3;
 +			
 +			unsigned char _RESERVED1          : 7;
 +			unsigned char Removable           : 1;
 +			
 +			uint8_t      Version;
 +			
 +			unsigned char ResponseDataFormat  : 4;
 +			unsigned char _RESERVED2          : 1;
 +			unsigned char NormACA             : 1;
 +			unsigned char TrmTsk              : 1;
 +			unsigned char AERC                : 1;
 +
 +			uint8_t      AdditionalLength;
 +			uint8_t      _RESERVED3[2];
 +
 +			unsigned char SoftReset           : 1;
 +			unsigned char CmdQue              : 1;
 +			unsigned char _RESERVED4          : 1;
 +			unsigned char Linked              : 1;
 +			unsigned char Sync                : 1;
 +			unsigned char WideBus16Bit        : 1;
 +			unsigned char WideBus32Bit        : 1;
 +			unsigned char RelAddr             : 1;
 +			
 +			uint8_t      VendorID[8];
 +			uint8_t      ProductID[16];
 +			uint8_t      RevisionID[4];
 +		} SCSI_Inquiry_Response_t;
 +		
 +		/** Type define for a SCSI sense structure to a SCSI REQUEST SENSE command. For details of the
 +		 *  structure contents, refer to the SCSI specifications.
 +		 */
 +		typedef struct
 +		{
 +			uint8_t       ResponseCode;
 +			
 +			uint8_t       SegmentNumber;
 +			
 +			unsigned char SenseKey            : 4;
 +			unsigned char _RESERVED1          : 1;
 +			unsigned char ILI                 : 1;
 +			unsigned char EOM                 : 1;
 +			unsigned char FileMark            : 1;
 +			
 +			uint8_t      Information[4];
 +			uint8_t      AdditionalLength;
 +			uint8_t      CmdSpecificInformation[4];
 +			uint8_t      AdditionalSenseCode;
 +			uint8_t      AdditionalSenseQualifier;
 +			uint8_t      FieldReplaceableUnitCode;
 +			uint8_t      SenseKeySpecific[3];
 +		} SCSI_Request_Sense_Response_t;
 +		
 +	/* Function Prototypes: */
 +		bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* MSInterfaceInfo);
 +		
 +		#if defined(INCLUDE_FROM_SCSI_C)
 +			static void SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* MSInterfaceInfo);
 +			static void SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* MSInterfaceInfo);
 +			static void SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* MSInterfaceInfo);
 +			static void SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* MSInterfaceInfo);
 +			static void SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* MSInterfaceInfo, const bool IsDataRead);
 +		#endif
 +		
 +#endif
 | 
