Specifying the device program id – Echelon FTXL User Manual
Page 71
FTXL User’s Guide
59
• The non-volatile data flush guard timeout value
• The name for the top-level root segment for the non-volatile data
The non-volatile data driver model can be one of the following types, depending
on your application’s requirements:
• Flash file system (such as the Micrium μC/FS embedded file system)
• Flash direct memory (with no file system) if you do not have, or do not
want to use, a flash file system for your non-volatile data
• User defined if you have another non-volatile data support model that
your application uses
You can only select one driver model for the specified application.
The non-volatile data flush timeout value determines how long the FTXL
LonTalk protocol stack waits to receive additional updates before writing them to
the non-volatile data.
The non-volatile root name is used to configure the non-volatile data support
driver. If you use the flash file system, the non-volatile root name is used as a
file system directory name in which to create non-volatile data files. If you use
the direct flash model, the name represents a Nios II flash device name. If you
use unstructured flash memory, leave the Root field blank.
Within the Nios development environment, the system.h file defines the root
name. For the examples that are included with the FTXL Developer’s Kit, the
root name is /dev/cfi_flash, which is the root directory for the flash file system.
The FTXL source files that handle non-volatile data (FtxlNvdFlashDirect.c,
FtxlNvdFlashFs.c, and FtxlNvdUserDefined.c) use conditional compilation based
on the selected model to include the appropriate code. If you select a user-defined
model, the related callback handler functions are not defined and cause a linker
error if they are not implemented.
Specifying the Device Program ID
From the Program ID Selection page of the utility, you specify the device
program ID or use the L
ON
M
ARK
Standard Program ID Calculator to specify the
device program ID. The program ID is a 16-digit hexadecimal number that
uniquely identifies the device interface for your device.
The program ID can be formatted as a standard or non-standard program ID.
When formatted as a standard program ID, the 16 hexadecimal digits are
organized into six fields that identify the manufacturer, classification, usage,
channel type, and model number of the device. The L
ON
M
ARK
Standard Program
ID Calculator simplifies the selection of the appropriate values for these fields by
allowing you to select from lists contained in a program ID definition file
distributed by L
ON
M
ARK
International. A current version of this list is included
with the FTXL Developer’s Kit.
Within the device’s program ID, you must include your manufacturer ID. If your
company is a member of L
ON
M
ARK
International, you have a permanent
Manufacturer ID assigned by L
ON
M
ARK
International. You can find those listed
within the Standard Program ID Calculator utility, or online at