Skip to content

Latest commit

 

History

History
66 lines (40 loc) · 3.05 KB

README.md

File metadata and controls

66 lines (40 loc) · 3.05 KB
Raw

Fx_SRAM_File_Edit_Standalone application description

This application provides an example of FileX stack usage on NUCLEO-G0B1RE 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 fx_FileXApp() function that handles file operations. At this stage, all FileX resources are created and the SRAM driver is initialized. After that, the fx_FileXApp 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 toggeling green LED light.

Also, information regarding executing operation on the SRAM-Disk is printed to the serial port.

Error behaviors

On failure, an error message is printed to the serial port while the green LED is switched OFF.

Assumptions if any

None

Known limitations

None

Notes

  1. The created SRAM-Disk, is placed in SRAM (144 KB) starting from the (FX_SRAM_DISK_BASE_ADDRESS=@0x2001B800).
  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 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 be "4 bytes" aligned to avoid unaligned access issues.

Keywords

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

Hardware and Software environment

  • This example runs on STM32G0B1xx devices.

  • This example has been tested with STMicroelectronics STM32G0B1RE NUCLEO boards Revision MB1360 C-02 and can be easily tailored to any other supported device and development board.

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