Ftxldev.h, Ftxldev.c, Project.xif and project.xfb – Echelon LonTal Stack User Manual

Page 107: Using types, Project .xif and project .xfb

Advertising
background image

LonTalk Stack Developer’s Guide

95

FtxlDev.h

The FtxlDev.h file is the main header file that the LonTalk Interface Developer

utility produces. This file provides the definitions that are required for your
application code to interface with the application framework and the LonTalk

API, including C extern references to public functions, variables, and constants
generated by the LonTalk Interface Developer utility.
You should include this file with all source files that your application uses, but

you do not normally have to edit this file. Any manual changes to this file are not
retained when you rerun the LonTalk Interface Developer utility. The file

contains comments that describe how you can override some of the preferences

and assumptions made by the utility.

FtxlDev.c

The FtxlDev.c file is the main source file that the LonTalk Interface Developer

utility produces. This file includes the FtxlDev.h file header file, declares the
network variables, configuration properties, and configuration files (where

applicable).
It defines the device’s LonInit() function. It also defines variables and
constants, including the network variable table, the device’s initialization data

block, and a number of utility functions.
You must compile and link this file with your application, but you do not
normally have to edit this file. Any manual changes to this file are not retained

when you rerun the LonTalk Interface Developer utility, but the file contains
comments that describe how you can override some of the preferences and

assumptions made by the utility.

project.xif and project.xfb

The LonTalk Interface Developer utility generates the device interface file for
your project in two formats:

project.xif (a text file)
project.xfb (a binary file)

For both files, project is the name of the LonTalk Stack project that you specified
in the Welcome to LonTalk Interface Developer window of the LonTalk Interface

Developer utility. Thus, these files have the same name as the LonTalk Stack

project file (.lidprj extension).

These files comply with the L

ON

M

ARK

device interface revision 4.401 format.

If your device is defined with a non-standard program ID, the device interface file

cannot contain interoperable L

ON

M

ARK

constructs such as functional blocks and

configuration properties.

Using Types

The LonTalk Interface Developer utility produces type definitions for the network

variables and configuration properties in your model file. For maximum
portability, all types defined by the utility are based on a small set of host-side

Advertising