FFSWrapper

Overview

Module which wraps Flash File System into RAM memory

Discussion

Audio Weaver module which constructs Flash File System instance from the address in RAM, which is used as input e.g. to wave player supporting FFS. This module accepts file system start address on input pin, constructs file system structure instance and send it through the output pin. This module supports additional argument through which user can specify Audio Weaver Flash File System (.bin) file name to simulate functionality on Native-PC target.

On the Native-PC target, input pin is ignored and flash file system is constructed from file name supplied through the argument. If the file name is empty input pin will be checked.

On a 64-bit system, user has to provide the 64-bit address of a bin file stored in RAM on two channels of fsStartAddr, with lower 32-bits of the address in the first channel (index 0) and upper 32-bits of the address in the second channel (index 1).

Similarly the module outputs a 64-bit address on fsInstance output pin.

Type Definition

CODE

typedef struct _ModuleFFSWrapper
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    INT32 isFFSValid;                             // Internal flag to control FFS bin file handling (used only for Native-PC targets)
    INT32 FFSFileNameLength;                      // Length of the FFS file path (used only for Native-PC targets)
    INT32* FFSFileName;                           // Name and path of the AWE Flash File System (.bin) file (used only for Native-PC targets)
    INT32* FFSInstance;                           // AWE Flash File System instance structure
    UINT32 * FFSStartAddrPtr;                     // AWE Flash File System start address in RAM
    UINT32 * FFSInstancePtr;                      // AWE Flash File System instance pointer
} ModuleFFSWrapperClass;

Variables

Properties

Name	Type	Usage	isHidden	Default value	Range	Units
isFFSValid	int	state	1	1	Unrestricted
FFSFileNameLength	int	const	1	1	Unrestricted
FFSFileName	int*	parameter	1	[40 x 1]	Unrestricted
FFSInstance	int*	state	1	[1 x 1]	Unrestricted
FFSStartAddrPtr	UINT32 *	state	1		Unrestricted
FFSInstancePtr	UINT32 *	state	1		Unrestricted

Pins

Input Pins

Name: FFSStartAddr

Description: FFS start address in RAM

Data type: int

Channel range: Unrestricted

Block size range: 1

Sample rate range: Unrestricted

Complex support: Real

Output Pins

Name: FFSInstancePtr

Description: AWE Flash File System instance pointer

Data type: int

MATLAB Usage

File Name: ffs_wrapper_module.m

CODE

 M=ffs_wrapper_module(NAME, AWE_FFS_BIN_FILENAME)
 Audio Weaver module which constructs Flash File System instance from the
 address in RAM, which is used as input, e.g. to wave player supporting FFS. 
 This module accepts file system start address on input pin, constructs file
 system structure instance and send it through the output pin.
 This module supports additional argument through which user can specify
 Audio Weaver flash file system bin file name to simulate functionality
 on Native-PC target.
 Arguments:
    NAME - name of the module.
    AWE_FFS_BIN_FILENAME - AudioWeaver Flash File System (.bin) file name
 Copyright 2022.  DSP Concepts, Inc.  All Rights Reserved.
 AudioWeaverModule [This tag makes it appear under awe_help]