Skip to content

Latest commit

 

History

History
65 lines (40 loc) · 3.04 KB

README.md

File metadata and controls

65 lines (40 loc) · 3.04 KB
Raw

Fx_SRAM_File_Edit_Standalone application description

This application provides an example of FileX stack usage on STM32WL55JC-Nucleo board, running in standalone mode (without ThreadX). It demonstrates how to create a Fat File System on the internal SRAM memory using FileX.

The application is designed to execute file operations on the SRAM-Disk device, it provides all required software code for properly managing it.

The application's main calls the MX_FileX_Process() function that handles file operations. At this stage, all FileX resources are created and the SRAM driver is initialized. After that, the MX_FileX_Process() will start by formatting the SRAM-Disk using FileX services. The resulting File System is a FAT32 compatible, with 512 bytes per sector.

Upon successful opening of the created SRAM-Disk media, FileX continue with creating a file called "STM32.TXT" into the root directory, then write into it some predefined data. Then file is re-opened in read only mode and 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

  • Successful operation is marked by a toggling GREEN LED light.
  • Information regarding executing operation on the SRAM-Disk is printed to the serial port.

Error behaviors

On failure, the RED LED starts toggling while the GREEN LED is switched OFF.

Assumptions if any

None

Known limitations

None

Notes

  1. The created SRAM-Disk, is placed in SRAM2 (32 KB) starting from the (SRAM2_BASE=@0x20008000).
  2. First 512 byte of this memory is reserved for FAT File System, the rest is available for file storage.

FileX/LevelX usage hints

  • 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 File System.
  • 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 be "4 bytes" aligned to avoid unaligned access issues.

Keywords

FileX, File System, FAT32, SRAM, SRAM-DISK

Hardware and Software environment

  • This application runs on STM32WL55xx devices

  • This application has been tested on STMicroelectronics NUCLEO-WL55JC1 boards Revision MB1389-HIGHBAND-E01 and can be easily tailored to any other supported device and development board.

  • This application uses UART2 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