1.5 FAT File System Using NVM and SST26 Media

This application shows an example of using the MPLAB Harmony File System to access multiple files across multiple media (NVM, SQI Flash).

Description

File System Operations on NVM

  • Application places a FAT disk image consisting of a Master Boot Record (MBR) sector, Logical Boot Sector, File Allocation Table, and Root Directory Area in the internal Flash memory (NVM)
  • During execution, the application first opens an existing file named FILE.txt and performs following file system related operations:
    • SYS_FS_FileStat
    • SYS_FS_FileSize
    • SYS_FS_FileSeek
    • SYS_FS_FileEOF
  • Finally, the string Hello World is written to this file. The string is then read and compared with the string that was written to the file.

File System Operations on the On-Board SST26 Flash Memory

  • Performs a SYS_FS_FormatDisk
  • Opens a newfile.txt on the SST26 Flash
  • Writes and reads back 4 KB of data on newfile.txt
  • Verifies the data read back

File System Layer Uses

  • One instance of the Memory driver is used to communicate with underlying NVM media
  • One instance of the Memory driver is used to communicate with the on-board SQI Flash memory

The application consists of three tasks which are called in RTOS thread context:

  • APP_SST26_Tasks():
    • Performs File Operations on SQI Flash memory
  • APP_NVM_Tasks():
    • Performs File Operations on NVM
  • APP_MONITOR_Tasks():
    • Monitors the state of above two Tasks

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/nvm_sqi_fat/firmware.

To build the application, refer to the following table and open the project using its IDE.

Project NameDescription
pic32mz_ef_sk_freertos.XMPLAB X project for PIC32MZ Embedded Connectivity with FPU (EF) Starter Kit

Setting Up the Hardware

The following table shows the target hardware for the application projects.

Project NameDescription
pic32mz_ef_sk_freertos.XPIC32MZ Embedded Connectivity with FPU (EF) Starter Kit

Setting Up PIC32MZ Embedded Connectivity With FPU (EF) Starter Kit

  • Connect the Debug USB port on the board to the computer using a mini USB cable

Running the Application

  1. Build and program the application using its IDE.
  2. The LED toggles when the following criteria are satisfied.
    • For NVM media:
      • The FILE.txt has the app data Hello World written in it
    • For SST26 media:
      • 4 KB of data has successfully been written and read back from file newfile.txt
Refer to the following table for LED name:
BoardLED Name
PIC32MZ Embedded Connectivity with FPU (EF) Starter KitLED3