FAT filesystem using SDMMC Media
This application shows an example of using the MPLAB Harmony File System to access and modify the contents of a SD card using the SDMMC driver.
Description
File System Operations on the SD Card:
- Application opens a file named FILE_TOO_LONG_NAME_EXAMPLE_123.JPG in the root directory of the SD card and reads its content into memory
- The image file could be any arbitrary JPEG (image) file chosen by the user and then renamed to FILE_TOO_LONG_NAME_EXAMPLE_123.JPG
- Application creates directory named Dir1 in the root directory
- Application creates a new file named FILE_TOO_LONG_NAME_EXAMPLE_123.JPG inside Dir1
- Application copies the content from step 1 into this newly created file
The reason for choosing a JPEG file for test purposes is that the duplicate file, Dir1/FILE_TOO_LONG_NAME_EXAMPLE_123.JPG created by the demonstration could be easily verified for correctness.If the new file inside Dir1 opens for viewing on the computer and matches to original image, the test is deemed to have passed. Otherwise, if the file does not open (i.e., is corrupted), the test will be considered to have failed.
Note:
Since the application creates a directory named Dir1, it is important that the a folder with the same name does not exist on the SD card. If a directory named Dir1 is already present on the SD card, the application will fail.
Downloading and building the application
To clone or download this application from Github, go to the main page of this repository and then click Clone button to clone this repository or download as zip file. This content can also be downloaded using content manager by following these instructions.
Path of the application within the repository is apps/fs/sdmmc_fat/firmware .
To build the application, refer to the following table and open the project using its IDE.
| Project Name | Description |
|---|---|
| sam_a5d27_som1_ek_freertos.X | MPLABX project for SAMA5D27-SOM1-EK1 |
| sam_a5d2_xult.X | MPLABX project for SAMA5D2 Xplained Ultra Evaluation Kit |
| sam_a5d2_xult_freertos.X | MPLABX project for SAMA5D2 Xplained Ultra Evaluation Kit |
Setting up AT91Bootstrap loader
To load the application binary onto the target device, we need to use at91bootstrap loader. Refer to the at91bootstrap loader documentation for details on how to configure, build and run bootstrap loader project and use it to bootstrap the application binaries.
Setting up the hardware
The following table shows the target hardware for the application projects.
| Project Name | Board |
|---|---|
| sam_a5d2_xult.X sam_a5d2_xult_freertos.X | SAMA5D2 Xplained Ultra Evaluation Kit |
| sam_a5d27_som1_ek_freertos.X | SAMA5D27-SOM1-EK1 |
Setting up SAMA5D27-SOM1-EK1
Addtional hardware required
- SD Card with FAT32 file system
Setting up the SD Card
- Create a new JPEG file in the SD Card with name FILE_TOO_LONG_NAME_EXAMPLE_123.JPG
Setting up the board
- Insert the SD card into SDMMC slot
- Connect the Debug USB port on the board to the computer using a micro USB cable
Setting up SAMA5D2 Xplained Ultra Evaluation Kit
Addtional hardware required
- SD Card with FAT32 file system
Setting up the SD Card
- Create a new JPEG file in the SD Card with name FILE_TOO_LONG_NAME_EXAMPLE_123.JPG
Setting up the board
- Insert the SD card into SDMMC slot
- Short jumper JP2 (DEBUG_DIS)
- Connect the Debug USB port on the board to the computer using a micro USB cable
Running the Application
- Build the application using its IDE
- The LED is turned ON if there was no error during creating the directory and copying the file into it
Refer to the following table for LED name:
| Board | LED Name |
|---|---|
| SAMA5D27-SOM1-EK1 | D5(Green) |
| SAMA5D2 Xplained Ultra Evaluation Kit | RGB_LED(Green) |