RL-ARM User's Guide

Source Files

Source Files for creating applications with the RL-FlashFS library can be found in the folders:

Folder NameDescription
\ARM\RV31\INCContains include files, header files, and configuration files.
\ARM\RV31\LIBContains the library files, such as FS_ARM_L.LIB, FS_CM3.LIB and others.
\ARM\RL\FlashFS\DriversContains driver modules for MCI, MMC, NAND, and SPI devices.
\ARM\RL\FlashFS\ConfigContains configuration files, such as File_Config.c and Retarget.c.
\ARM\RL\FlashFS\Flash\device familyContains Flash programming functions and device description files.
\ARM\Boards\vendor\board\RL\FlashFSContains example applications built with the RL-FlashFS Library. Use the projects as templates to create new applications.

RL-FlashFS include files in \ARM\RV31\INC:

File NameFile TypeLayerDescription
absacc.hHeader FileAll layersHeader file to locating variables at absolute addresses at C level. The file is included from the file File_lib.c. Code changes are not required.
File_Config.hHeader FileAll layersHeader file with common definitions. Code changes are not required.
File_lib.cModuleAll layersSystem configuration file outlining library functions. Code changes are not required.
RTL.hHeader FileAll layersCommon header file with type definitions and exporting library functions. Code changes are not required.

RL-FlashFS library files in \ARM\RV31\LIB:

File NameFile TypeLayerDescription
FS_ARM_L.libLibraryAll layersRL-FlashFS library for ARM7 and ARM9 devices - Little Endian.
FS_ARM_B.libLibraryAll layersRL-FlashFS library for ARM7 and ARM9 devices - Big Endian.
FS_CM1.libLibraryAll layersRL-FlashFS library for Cortex-M0 and Cortex-M1 devices - Little Endian.
FS_CM3.libLibraryAll layersRL-FlashFS library for Cortex-M3 devices - Little Endian.
FSN_ARM_L.libLibraryAll layersRL-FlashFS library without FAT Long File Name support for ARM7 and ARM9 devices - Little Endian.
FSN_ARM_B.libLibraryAll layersRL-FlashFS library without FAT Long File Name support for ARM7 and ARM9 devices - Big Endian.
FSN_CM1.libLibraryAll layersRL-FlashFS library without FAT Long File Name support for Cortex-M0 and Cortex-M1 devices - Little Endian.
FSN_CM3.libLibraryAll layersRL-FlashFS library without FAT Long File Name support for Cortex-M3 devices - Little Endian.

RL-FlashFS interface files in \ARM\RL\FlashFS\Drivers:

File NameFile TypeLayerDescription
MCI_device familyModule and include fileAll layersMultimedia Card Interface driver files with device specific definitions and functions. Code changes are not required.
NAND_device familyModule and include fileAll layersNAND Flash Interface driver files with device specific definitions and functions. Code changes are not required.
SDIO_device familyModule and include fileAll layersMultimedia Card Interface driver files with device specific definitions and functions. Code changes are not required.
SPI_device family.cModuleAll layersSerial Peripheral Interface driver file with device specific definitions and functions. Code changes are not required.

RL-FlashFS configuration files in \ARM\RL\FlashFS\Config:

File NameFile TypeLayerDescription
File_Config.cModuleAll layersApplication and device configuration file. Code changes can be entered manually or using the µVision Configuration Wizard.
Retarget.cModuleAll layersModule exposing low-level I/O functions. Code changes are not required.

RL-FlashFS Flash programming and device description files in \ARM\RL\FlashFS\Flash\device family:

File NameFile TypeLayerDescription
FS_FlashDev.hHeader fileAll layersDevice description file defining the memory layout for devices using Embedded File System. Adapt the code the application needs.
FS_FlashPrg.cModuleAll layersModule with Flash programming functions for devices using the Embedded File System. Adapt the code to the application needs.
FS_SPI_FlashDev.hHeader fileAll layersDevice description file for SPI devices outlining the memory layout. Adapt the code the application needs.
FS_SPI_FlashPrg.cModuleAll layersModule with Flash programming functions for SPI devices. Adapt the code to the application needs.
IAP.sModuleAll layersAssembler file with IAP execution functions. Adapt the code to the application needs.