Skip to content

Latest commit

 

History

History
73 lines (43 loc) · 3.17 KB

README.md

File metadata and controls

73 lines (43 loc) · 3.17 KB
Raw

Fx_File_Edit_Standalone Application Description

This application provides an example of FileX stack usage on STM32H735G-DK board, running in standalone mode (without ThreadX).

It demonstrates how to create a Fat File system on the SD card memory using FileX.

The application is designed to execute file operations on the SD card, it provides all required software code for properly managing it.

The application's main calls the MX_FileX_Init() function in order to initialize FileX, format the SD memory as FAT and open the sdio_disk driver. The resulting file system is a FAT32 compatible, with 512 bytes per sector.

Upon successful opening of the created SDIO-Disk media, FileX continues with creating a file called "STM32.TXT" into the root directory by calling MX_FileX_Process(void) function, then writes into it some predefined data. The file is re-opened in read only mode and its content is checked.

As stated earlier, the present application runs in standalone mode without ThreadX, for this reason, the standalone variant of FileX is used, plus the following flags need to be set in fx_user.h:

  • #define FX_SINGLE_THREAD
  • #define FX_STANDALONE_ENABLE

Expected success behavior

  • A blinking green LED light marks the success of the file operations.
  • A file named STM32.TXT should be visible in the root directory of the SD card.
  • Information regarding executing operation on the SD card is printed to the serial port.

Error behaviors

  • On failure, the red LED should start blinking.
  • Error handler is called at the spot where the error occurred.

Assumptions if any

None.

Known limitations

No SD card insertion/removal mechanisms are implemented.

Notes

  1. Before starting the application, the SD card should be present in the SD card connector and formatted initially by user.

FileX/LevelX usage hints

  • FileX sd driver is using the DMA, thus the DTCM (0x20000000) memory should not be used by the application, as it is not accessible by the SD DMA.
  • When calling the fx_media_format() API, it is highly recommended to understand all the parameters used by the API to correctly generate a valid filesystem.
  • FileX is using data buffers, passed as arguments to fx_media_open(), fx_media_read() and fx_media_write() API it is recommended that these buffers are multiple of sector size and "32 bytes" aligned to avoid cache maintenance issues.

Keywords

FileX, File system, FAT32, SDMMC

Hardware and Software environment

  • This application runs on STM32H735xx devices.

  • This application has been tested with STMicroelectronics STM32H735G-DK boards revision: MB1520-H735I-B02 and can be easily tailored to any other supported device and development board.

  • This application uses USART3 to display logs, the hyperterminal configuration is as follows:

    • BaudRate = 115200 baud
    • Word Length = 8 Bits
    • Stop Bit = 1
    • Parity = none
    • Flow control = None

How to use it ?

In order to make the program work, you must do the following :

  • Open your preferred toolchain
  • Rebuild all files and load your image into target memory
  • Run the application