Using direct memory files – Echelon LonTal Stack User Manual

Page 140

Advertising
background image

128

Developing a LonTalk Stack Device Application

To return a LonTalk Stack device to the legacy mode, rather than the extended

mode, perform one of the following tasks:

• Re-run the LonTalk Interface Developer utility to generate a new

signature for the device, and rebuild and load the application image.

• Send the NM_NODE::NM_INITIALIZE extended network management

command to the device.

• Erase the non-volatile memory for the device.
• If the device is currently commissioned in an OpenLNS database,

de-commission it.

You should not need to perform any of these tasks often because most network

management tools use OpenLNS or are compatible with ECS.

For more information about the LonTalk extended command set (ECS) network

management commands, see the ISO/IEC 14908-1 Control Network Protocol

Specification. This document is available from ISO:
www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=60203

Using Direct Memory Files

To use configuration properties in files, your host application program must

implement a method that allows the network management tool to access those

files. You can support either one of the following:

• The L

ON

W

ORKS

FTP protocol

• The host direct memory files (DMF) feature

The FTP protocol is appropriate when large amounts of data need to be

transferred between the host processor and Echelon Smart Transceiver or

Neuron Chip. The host DMF feature is appropriate for most other cases.

By supporting direct memory files, your application allows the network

management tool to use standard memory read and write network messages to

access configuration property files located on the host. Direct memory files
appear to the network management tool as if they were located within the

Echelon Smart Transceiver or Neuron Chip’s native address space, but the
LonTalk host stack routes memory read and write requests within the DMF

memory window to the LonMemoryRead() and LonMemoryWrite() callback

handler functions provided in the FtxlHandlers.c file. These functions use the
LonTranslateWindowArea() support function, which is generated by the

LonTalk Interface Developer utility to translate between Echelon Smart
Transceiver or Neuron Chip addresses and host addresses.
If the model file contains a network variable of type SNVT_address, the

LonTalk Interface Developer utility automatically generates all necessary code
and data for the memory read and write requests, including code in the

LonInit() function to register the virtual memory window with the LonTalk Host
stack.
You do not generally need to modify the code that the LonTalk Interface

Developer utility generates (in FtxlDev.c) or the LonMemoryRead() and
LonMemoryWrite() callback handler functions (in FtxlHandlers.c).

Advertising