Echelon FTXL Manual do Utilizador

FTXL User’s Guide078-0363-01A®

x Keywords... 132 The Network Variable Modifier ...

88 Developing an FTXL Application nciGain }; You can enhance the myController() function to implement the new gain f

FTXL User’s Guide 89 See The Dynamic Interface Example Application on page 202 for an example application that handles changeable-type network

90 Developing an FTXL Application } nv_type_category_t; This enumeration describes the type (signed short or floatin

FTXL User’s Guide 91 then the application must process the type changes for both the network variable and the configuration network variable.

92 Developing an FTXL Application callback handler function can report the correct current size for any implemented n

FTXL User’s Guide 93 network variable is added. On device startup, it calls this function for each dynamic network variable that had been pre

94 Developing an FTXL Application Sending an Application Message to the Network Call the LonSendMsg() function to sen

FTXL User’s Guide 95 management callbacks. These commands are requests for your application to wink, go offline, go online, or reset, and are

96 Developing an FTXL Application utility, might not be able to communicate with a device that is in the extended mod

FTXL User’s Guide 97 You do not generally need to modify the code that the LonTalk Interface Developer utility generates (in FtxlDev.c) or the

FTXL User’s Guide xi Managing Interrupts... 179 Determining Memory Usa

98 Developing an FTXL Application FTXL TransceiverRegistered Memory WindowMaximum range: 0x0001 – 0xFFFFFile director

FTXL User’s Guide 99 File Directory The LonTalk Interface Developer utility produces a configurable file directory structure, which supports:

FTXL User’s Guide 101 6 Working with the Nios II Development Environment This chapter describes how to set up the Nios II IDE for building a

102 Working with the Nios II Development Environment Development Tools To develop your FTXL application, you use ver

FTXL User’s Guide 103 Using a Device Programmer for the FPGA Device To load your hardware design, software application, and the FTXL LonTalk p

104 Working with the Nios II Development Environment application consists of the following components, all of which n

FTXL User’s Guide 105 5. Specify the target hardware. Click Browse in the Select Target Hardware area to open the Select Target Hardware dia

106 Working with the Nios II Development Environment To customize the system library properties for the operating sys

FTXL User’s Guide 107 f. In the Properties window, click Apply to save these settings, then click OK to close the dialog. Other options and p

xii LonTalk Interface Developer Utility Error and Warning Messages...229 Introduction...

108 Working with the Nios II Development Environment b. Load the hardware image for the Nios II processor into the F

FTXL User’s Guide 109 4. If you have a valid Nios II development license, and have already loaded the configuration data (the JTAG Indirect C

110 Working with the Nios II Development Environment • The application itself, including implementations of the even

FTXL User’s Guide 111 A LonTalk Interface Developer Command Line Usage This appendix describes the command-line interface for the LonTalk Int

112 LonTalk Interface Developer Command Line Usage Overview The LonTalk Interface Developer utility consists of two m

FTXL User’s Guide 113 are yes, on, 1, +, no, off, 0, - (a minus sign or dash). Examples: libf -–verbosecomments=yes libf --verbosecomments •

114 LonTalk Interface Developer Command Line Usage Command Switch Long Form Short Form Description --buffer -B Impl

FTXL User’s Guide 115 Command Switch Long Form Short Form Description --source -n Use the specified model file --spdelay -p Set the servic

116 LonTalk Interface Developer Command Line Usage Note that the type and number for the --buffer switch are separate

FTXL User’s Guide 117 Buffer Type Primary Specification Alternate Specifications Valid Values Network output priority buffers nop netoutputpri

FTXL User’s Guide 1 1 Introduction to FTXL This chapter introduces the LonTalk Platform for FTXL Transceivers. It describes the architecture

FTXL User’s Guide 119 B Model File Compiler Directives This Appendix lists the compiler directives that can be included in a model file. Mod

120 Model File Compiler Directives Using Model File Compiler Directives ANSI C permits compiler extensions through th

FTXL User’s Guide 121 Important: Configuration property re-ordering and merging can reduce the memory required for the template file, but can

122 Model File Compiler Directives #pragma set_guidelines_version string The Neuron C 2.1 compiler generates LONMARK

FTXL User’s Guide 123 #pragma disable_warning number #pragma enable_warning number Controls the compiler's printing of individual warning

FTXL User’s Guide 125 C Neuron C Syntax for the Model File This Appendix lists the Neuron C syntax for the allowable statements of a model fil

126 Neuron C Syntax for the Model File Functional Block Syntax fblock FPT-identifier { fblock-member-list } identifie

FTXL User’s Guide 127 referenced by the fblock must be declared as an array of at least the same size. When implementing an fblock array&apos

2 Introduction to FTXL Overview Automation solutions for buildings, homes, and industrial applications include sensor

128 Neuron C Syntax for the Model File implementation_specific keyword, followed by a unique index number, and a uniq

FTXL User’s Guide 129 Functional Block Properties Syntax fb_properties { property-reference-list } property-reference-list : property-refere

130 Neuron C Syntax for the Model File has a range modification, then all members must have a range modification spec

FTXL User’s Guide 131 of the nvoData network variable array), and four offset CP family members (SCPToffset), one for each member of each fblo

132 Neuron C Syntax for the Model File network output SNVT_amp nvoAmpere; network output polled SNVT_time_stamp nvoIn

FTXL User’s Guide 133 sync | synchronized Specifies that all values assigned to this network variable must be propagated, and in their origi

134 Neuron C Syntax for the Model File In an application that uses compiler-generated SD data, you can still specify

FTXL User’s Guide 135 Recommendation: Use a SNVT or SCPT if one is available that matches your data because SNVTs and SCPTs can provide inte

136 Neuron C Syntax for the Model File network variables. This keyword is not required for model files. Names of arr

FTXL User’s Guide 137 A network variable connection is authenticated only if the readers and writers have the authenticated keywords specified

FTXL User’s Guide 3 the ANSI/CEA-709.1 (EN14908-1) Control Network Protocol as the “LonTalk protocol”, although other interoperable implementa

138 Neuron C Syntax for the Model File The Network Variable Initializer initial-value or initializer-list Specifies a

FTXL User’s Guide 139 Network variable properties can be shared between two or more network variables. The use of the global keyword creates

140 Neuron C Syntax for the Model File cp_family Declares the configuration property as part of a configuration file.

FTXL User’s Guide 141 network database. This specification is used for configuration properties that must be managed by the device, such as a

142 Neuron C Syntax for the Model File specified. In this case, each range modification pair is delimited by the ASC

FTXL User’s Guide 143 The compiler uses the first rule in this list that applies to the configuration property. These initialization rules are

144 Neuron C Syntax for the Model File The syntax for declaring a device property list is: device_properties { proper

FTXL User’s Guide 145 // empty string initializer with its own }; Message Tag Syntax msg_tag [ connection-info ] tag-identifier [, tag-ide

FTXL User’s Guide 147 D FTXL LonTalk API This Appendix describes the API functions, event handler functions, and callback handler functions t

4 Introduction to FTXL Neuron Firmware Figure 1. A Single-Chip LONWORKS Device For a Neuron-hosted device that uses a

148 FTXL LonTalk API Introduction The FTXL LonTalk API provides the functions that you call from your FTXL applicatio

FTXL User’s Guide 149 • API source code for the example applications: Start → Programs → Echelon FTXL Developer’s Kit → Source Code FTXL Lon

150 FTXL LonTalk API Table 13. Other FTXL LonTalk API Functions Function Description LonFreeNvTypeData() Frees int

FTXL User’s Guide 151 Function Description LonSendResponse() Sends an application message response to a request message. The FTXL applica

152 FTXL LonTalk API Function Description LonQueryConfigData() Queries local configuration data on the FTXL device

FTXL User’s Guide 153 Table 17. Commonly Used FTXL Event Handler Functions Function Description LonNvUpdateCompleted() Indicates that eithe

154 FTXL LonTalk API Dynamic Network Variable Event Handler Functions Table 18 lists the event handler functions tha

FTXL User’s Guide 155 Function Description LonResponseArrived() Indicates that an application message response has arrived from the network

156 FTXL LonTalk API Function Description LonEventReady() Indicates that a network event is ready to be processed.

FTXL User’s Guide 157 Function Description LonNvdDelete() Indicates a request to delete a non-volatile data segment. LonNvdDeserializeSegme

FTXL User’s Guide 5 Compared to the single-chip device, the Smart Transceiver implements only a subset of the LonTalk protocol layers. The ho

158 FTXL LonTalk API • HTML API documentation: Start → Programs → Echelon FTXL Developer’s Kit → Documentation → AP

FTXL User’s Guide 159 Function Description OsalDeleteEvent() Deletes an event. OsalSetEvent() Sets an event. OsalWaitForEvent() Waits

160 FTXL LonTalk API Table 29. FTXL OSAL Debug Functions Function Description OsalClearStatistics() Clears the c

FTXL User’s Guide 161 Resource Number Notes Events 10 Modify the number of events, if needed, within the operating-system settings. To cal

162 FTXL LonTalk API Figure 13. FTXL Abstract Priorities Before you can instantiate a task within an application, yo

FTXL User’s Guide 163 OS_LOW_APPLICATION_PRIORITY_BASE Defines the highest OS priority used for application tasks running at a lower priority

164 FTXL LonTalk API Figure 15. Defined Symbols in the Project Properties Dialog Similarly, if you want to support a

FTXL User’s Guide 165 priority tasks (OS_HIGH_PRIORITY_BASE) set to 4. The figure assumes that low numbers represent high priorities. The cr

166 FTXL LonTalk API Lowest Assignable Task Priority The μC/OS-II operating system uses the lowest task priority for

FTXL User’s Guide 167 Maximum Number of Event Control Blocks The μC/OS-II operating system uses event control blocks for the FTXL OSAL critica

6 Introduction to FTXL Using a ShortStack Micro Server makes it easy to add LONWORKS networks to any existing smart d

168 FTXL LonTalk API Table 33. MicroC/OS-II General Options Option Setting for FTXL Applications Maximum number of

FTXL User’s Guide 169 Figure 18. MicroC/OS-II General Options Page Event Flags Table 34 describes the event flag options for the μC/OS-II ope

170 FTXL LonTalk API Option Setting for FTXL Applications Size of name of Event Flag group 0 or larger Event flag b

FTXL User’s Guide 171 Option Setting for FTXL Applications Include code for OSMutexDel() Not required Include code for OSMutexQuery() Not r

172 FTXL LonTalk API Figure 20. MicroC/OS-II Semaphores Page Mailboxes FTXL applications do not use mailbox resource

FTXL User’s Guide 173 Queues FTXL applications do not use queue resources. Table 38 describes the queue options for the μC/OS-II operating sy

174 FTXL LonTalk API Option Setting for FTXL Applications Enable debug variables Not required Include code for OSSc

FTXL User’s Guide 175 Figure 21. MicroC/OS-II Miscellaneous Page Task Management Table 41 describes the task-management options for the μC/OS

176 FTXL LonTalk API Option Setting for FTXL Applications Include code for OSTaskQuery() Required Include code for

FTXL User’s Guide 177 Table 42. MicroC/OS-II Time Management Options Option Setting for FTXL Applications Include code for OSTimeDlyHMSM()

FTXL User’s Guide 7 For an FTXL device, you use an Altera Nios II processor as the host processor for your device’s application and I/O. The

178 FTXL LonTalk API Table 43. MicroC/OS-II Timer Management Options Option Setting for FTXL Applications Maximum nu

FTXL User’s Guide 179 Table 44. FTXL HAL Transceiver Functions Function Description LonAssertTransceiverReset() Asserts the FTXL Transce

180 FTXL LonTalk API Function Description LonDriverTransceiverIrq() The main body of the ISR for processing input

FTXL User’s Guide 181 E Determining Memory Usage for FTXL Applications This Appendix describes how much volatile and non-volatile memory an FT

182 Determining Memory Usage for FTXL Applications Overview The FTXL LonTalk protocol stack allocates memory dynamica

FTXL User’s Guide 183 call to the LonInit() function (you could also call it after the FTXL device is commissioned or during peak activity).

184 Determining Memory Usage for FTXL Applications Table 48. RAM Usage per Application Buffer Application Buffer Type

FTXL User’s Guide 185 required for each type of LONWORKS resource. The number of bytes required for each type of resource is an estimate; you

186 Determining Memory Usage for FTXL Applications The flash memory implementation in the FtxlNvdFlashDirect.c file r

FTXL User’s Guide 187 Table 53. Non-Volatile Memory Required for the Application Data Application Data Bytes Required Header 16 CPNVs ()∑jjCP

Echelon, LONWORKS, LONMARK, NodeBuilder, LonTalk, Neuron, 3120, 3150, LNS, i.LON, ShortStack, LonMaker, and the Echelon logo are trademarks of Echelon

8 Introduction to FTXL Transceiver and wiringApplication in CFTXL Device11-pin parallel I/O link layer and driver sof

188 Determining Memory Usage for FTXL Applications Table 54. Example Memory Usage Number of Network Variables Number

FTXL User’s Guide 189 05001000150020002500Memory (KB)10 100 250 500 1000 2000 4000Number of Network VariablesRAMFlash Figure 24. Example Memor

FTXL User’s Guide 191 F Downloading an FTXL Application Over the Network This Appendix describes considerations for designing an FTXL applicat

192 Downloading an FTXL Application Over the Network Overview For a Neuron-hosted device, you can update the applicat

FTXL User’s Guide 193 should also inform the user of its state. During this stage, the FTXL device should verify that the application to be d

194 Downloading an FTXL Application Over the Network minimum, the FTXL application should reserve enough RAM to buffe

FTXL User’s Guide 195 G Example FTXL Applications This Appendix describes the example applications that are included in the FTXL Developer’s K

196 Example FTXL Applications Overview of the Example Applications The FTXL Developer’s Kit includes two example appl

FTXL User’s Guide 197 Table 56. FTXL Dynamic Interface Example Files File Name Description Dynamic Interface Example.lidprj LonTalk Interfa

FTXL User’s Guide 9 Table 3. Comparing Neuron-Hosted and Host-Based Solutions for LONWORKS Devices Characteristic Neuron-Hosted Solution Sho

198 Example FTXL Applications Main Function The main() function is in the main.c file. The main() function creates a

FTXL User’s Guide 199 • Creates the “event ready” event using the FTXL OSAL OsalCreateEvent() function. The LonEventReady() callback handler

200 Example FTXL Applications The FtxlHandlers.c file contains the modified LonNvUpdateOccurred() function, which is

FTXL User’s Guide 201 • ProcessOnlineEvent(): Calls the ProcessNviVoltUpdate() function when the device goes online. These functions are def

202 Example FTXL Applications For more information about creating and using a model file, see Creating a Model File o

FTXL User’s Guide 203 SNVT_volt_mil type. Any attempt to change the NV to an unsupported type causes the device to reject the change and to r

204 Example FTXL Applications LON_SET_UNSIGNED_WORD(FbStatus[fbIndex].object_id, fbIndex); } /* Initiali

FTXL User’s Guide 205 Although the main() and appTask() functions for this application are part of an example, you can use the same basic algo

206 Example FTXL Applications This functional separation approach keeps changes to the LonTalk Interface Developer ut

FTXL User’s Guide 207 • Checks whether the object index represents a supported object: o For non-supported objects, sets the object status t

10 Introduction to FTXL Notes: 1. ShortStack Micro Servers running on FT 3150 or PL 3150 Smart Transceivers support u

208 Example FTXL Applications LonBool processActuatorInputs = FALSE; unsigned index =

FTXL User’s Guide 209 /* Update the status. If the object is not the * node object, just return the current status

210 Example FTXL Applications { /* Actuator was disabled, but is now *

FTXL User’s Guide 211 break; } } myNvAdded() The myNvAdded() function calls the UpdateCircuitMap() utility function to update the log

212 Example FTXL Applications void myNvDeleted(const unsigned index) { LonByte oldCircuitId = circuitMap[index].cir

FTXL User’s Guide 213 Application-Specific Utility Functions The dynamic interface example application includes the following application-spec

214 Example FTXL Applications void myEventReady(void) { /* Signal application task so that it can process the * e

FTXL User’s Guide 215 fblock SFPTclosedLoopActuator { nviVolt implements nviValue; nvoVoltFb implements nvoValueFb; } voltActuator exte

216 Example FTXL Applications 3. Optional: Enter a project name in the Name field. The default name is FTXL_Simple

FTXL User’s Guide 217 Figure 25. New Project Window for the FTXL Simple Project Perform the same steps to create a new project for the dynami

FTXL User’s Guide 11 The FTXL LonTalk protocol stack and API require about 540 KB of program memory on the Nios II host processor, not includi

218 Example FTXL Applications 2. From the Welcome to LonTalk Interface Developer page of the utility, click Browse t

FTXL User’s Guide 219 1. Start the Nios II EDS IDE. 2. Ensure that the workspace includes the example application project that you want to b

220 Example FTXL Applications e. Select Program FPGA configuration data into hardware-image region of flash memory t

FTXL User’s Guide 221 5. If you have a valid Nios II development license, and have already loaded the configuration data into the Cyclone II

222 Example FTXL Applications Running the Simple Example To verify that the application runs as expected, connect the

FTXL User’s Guide 223 6. In the Select Network Variable Type dialog, expand C:\LonWorks\Types\STANDARD.FMT and select either SNVT_volt or SNV

224 Example FTXL Applications 3. Drag a Functional Block shape from the NodeBuilder Basic Shapes 3.0 pane of the Sha

FTXL User’s Guide 225 vi. The Create Network Variable dialog should look similar to Figure 26. Figure 26. The LonMaker Create Network Variab

226 Example FTXL Applications vi. The Create Network Variable dialog should look similar to Figure 27. Figure 27. T

FTXL User’s Guide 227 5. Repeat steps 2 - 4 to set values for the nviAmpA02 and nviAmp03 network variables and observe the change to the nvoA

12 Introduction to FTXL Figure 4 shows the basic architecture of an FTXL device. Figure 4. FTXL Architecture The FTXL

228 Example FTXL Applications Each time you build either of the FTXL example applications, you see the following remi

FTXL User’s Guide 229 G LonTalk Interface Developer Utility Error and Warning Messages This Appendix lists the LonTalk Interface Developer ut

230 LonTalk Interface Developer Utility Error and Warning Messages Introduction All messages, errors and warnings, co

FTXL User’s Guide 231 LID# Description 5 An error occurred when reading a device interface file This is an internal error, probably a result

232 LonTalk Interface Developer Utility Error and Warning Messages LID# Description 10 Failure to attach to LONUCL3

FTXL User’s Guide 233 LID# Description 21 The xif32bin.exe utility returned an error, indicating failure when converting XIF to XFB The bina

234 LonTalk Interface Developer Utility Error and Warning Messages LID# Description 28 Unexpected error (not a file

FTXL User’s Guide 235 LID# Description 35 Configuration parameters are in use, but no template file has been found This might be the result

236 LonTalk Interface Developer Utility Error and Warning Messages LID# Description 46 One or more configuration pa

FTXL User’s Guide 237 LID# Description 62 Insufficient buffer space The message includes the total number of bytes available for transceiver

FTXL User’s Guide 13 The FTXL LonTalk API consists of the following types of functions: • Functions to initialize the FTXL device after each

238 LonTalk Interface Developer Utility Error and Warning Messages LID# Description 4009 Warning code not in use. 4

FTXL User’s Guide 239 LID# Description 4019 Warning code not in use. 4020 Warning code not in use. 4021 Warning code not in use. 4022 War

FTXL User’s Guide 241 H Glossary This appendix defines many of the common terms used for FTXL device development.

242 Glossary D downlink Link-layer data transfer from the host to the FTXL Transceiver. E Eclipse An open-source soft

FTXL User’s Guide 243 FTXL link layer The physical connection and protocol used to attach an FTXL host processor to an FTXL Transceiver; the h

244 Glossary included with both the FTXL Developer's Kit and the ShortStack Developer's Kit. LonTalk Platfo

FTXL User’s Guide 245 Index A address table, 47 alias table, 47 Altera Complete Design Suite, 102 ANSI/CEA 709.1-B, 2 application. See FTXL ap

246 Index new project, 215 Nios II IDE, 215 overview, 196 running, 220 running LonTalk Interface Developer, 217 simpl

FTXL User’s Guide 247 K keywords configuration property, 139 functional block, 126 functional block properties, 129 message tag, 145 network v

14 Introduction to FTXL • The FTXL hardware abstraction layer (HAL) files, which you might need to modify • The FTXL

248 Index building application, 107 compiling, 107 creating new project, 104 debugging, 109 loading application, 107

www.echelon.com

FTXL User’s Guide 15 Task Additional Considerations Reference Select an FPGA device and load it with Nios II processor and related hardware

16 Introduction to FTXL Task Additional Considerations Reference Use the LonTalk Interface Developer utility to gene

FTXL User’s Guide 17 2 Getting Started with FTXL This chapter describes the FTXL Developer’s Kit and how to install it.

FTXL User’s Guide iii Welcome Echelon’s FTXL™ products enable any product that contains an Altera® Nios® II processor to quickly and inexpensi

18 Getting Started with FTXL FTXL Developer’s Kit Overview The FTXL Developer’s Kit is a development toolkit that con

FTXL User’s Guide 19 • Driver software for the Altera USB-Blaster download cable • FPGA configuration data and software for the DBC2C20 deve

20 Getting Started with FTXL DBC2C20 Software Although the DBC2C20 Altera Cyclone II Development Board includes a set

FTXL User’s Guide 21 File Name Description FtxlHandlers.c Function definitions for the FTXL event handler functions and callback handler fun

22 Getting Started with FTXL

FTXL User’s Guide 23 3 Creating a Model File You use a model file to define your device’s interoperable interface, including its network in

24 Creating a Model File Model File Overview The interoperable application interface of a LONWORKS device consists o

FTXL User’s Guide 25 Developer’s Kit, and must be licensed separately. See the NodeBuilder User’s Guide for details about using the NodeBuild

26 Creating a Model File Example: The following declaration defines an input network variable of type “SNVT_type” wi

FTXL User’s Guide 27 (for example, SNVT_volt), but can be changed during device installation to a different type (for example, SNVT_volt_mil).

iv • Introduction to the LONWORKS System (078-0183-01A). This manual provides an introduction to the ANSI/CEA-709.1 (EN14908) Control Networking Prot

28 Creating a Model File • Includes a single network variable, named nvoAmpere, which implements the nvoValue networ

FTXL User’s Guide 29 Type translators are also available to convert network variables of one type to another type. Some type translators can

30 Creating a Model File The FTXL application in a device does not need to know anything about where input network va

FTXL User’s Guide 31 • Only a network management tool, such as the LonMaker Integration tool, can change the type of a changeable-type networ

32 Creating a Model File Defining a Configuration Property Like network variables, configuration properties have type

FTXL User’s Guide 33 You must implement configuration properties within a configuration file if any of the following apply to your application

34 Creating a Model File SFPTnodeObject functional profile, simply add this network variable to the model file. You

FTXL User’s Guide 35 When you define a configuration property array, the entire array (but not each element) applies to one or more network va

36 Creating a Model File There is one gain setting per channel, implemented as an array of configuration network vari

FTXL User’s Guide 37 Sharing a Configuration Property The typical instantiation of a configuration property is unique to a single device, func

FTXL User’s Guide v Product Category Documentation Titles Nios II processor Nios II Hardware Development Tutorial Nios II Software Develop

38 Creating a Model File Example 2: The following model file defines a three-phase ammeter, implemented with an array

FTXL User’s Guide 39 SCPTdefOutput configuration property as an optional configuration property, and use it to define the default value for th

40 Creating a Model File Declaring a Message Tag You can declare a message tag in a model file. A message tag is a c

FTXL User’s Guide 41 the program ID template to the program ID of a device. That is, the range of device types to which a resource file appli

42 Creating a Model File devices, and scopes 1 and 2 are reserved for future use. Because scope 0 applies to all dev

FTXL User’s Guide 43 Writing Acceptable Neuron C Code When processing the model file, the LonTalk Interface Developer utility distinguishes be

44 Creating a Model File Legacy Neuron C Constructs You must use the Neuron C Version 2.1 syntax described in this ma

FTXL User’s Guide 45 Alternatively, your application can use a combination of the LonQueryDomainConfig() and LonUpdateDomainConfig() API calls

46 Creating a Model File Device B(reader)1234ACKD Message orRequestChallengeReply to challengeACK or ResponseDevice A

FTXL User’s Guide 47 http://global.ihs.com/doc_detail.cfm?item_s_key=00391891&item_key_date=971131&rid=CEA. See Appendix E, Determinin

vi

48 Creating a Model File override the automatic calculation of the table size and specify any number of entries, from

FTXL User’s Guide 49 However, it is a common practice to use the “nvi” prefix for input network variables and the "nvo" prefix for o

50 Creating a Model File file. The API uses this table to access the network variables when the application runs. I

FTXL User’s Guide 51 Functional Blocks with Configuration Network Variables The following example takes the above example and adds a few confi

52 Creating a Model File element of the Meter array of functional blocks, again starting with nvoWattage[0]. The use

FTXL User’s Guide 53 network output polled eeprom SNVT_elapsed_tm nvoUsage[3]; fblock UFPTenergyMeter { nvoWattage[0] implements nvoWatta

FTXL User’s Guide 55 4 Using the LonTalk Interface Developer Utility You use the model file, described in Chapter 3, and the LonTalk Interf

56 Using the LonTalk Interface Developer Utility Running the LonTalk Interface Developer You use the LonTalk Interfac

FTXL User’s Guide 57 utility’s Model File Selection page, you can specify the name and location of the model file. The location of the LonTalk

FTXL User’s Guide vii Table of Contents Welcome...

58 Using the LonTalk Interface Developer Utility Recommendation: Allow the LonTalk Interface Developer utility to ca

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 T

60 Using the LonTalk Interface Developer Utility If your company is not a member of the LONMARK International, you ca

FTXL User’s Guide 61 The LonTalk Interface Developer project directory is automatically included in the compiler search path, and does not nee

62 Using the LonTalk Interface Developer Utility • project.xif • project.xfb These files form the FTXL application fr

FTXL User’s Guide 63 The LonCpTypes.h file defines configuration property types, and includes standard or user configuration property types (S

64 Using the LonTalk Interface Developer Utility Using Types The LonTalk Interface Developer utility produces type de

FTXL User’s Guide 65 • The nvoSwitch declaration is based on a structure. The LonTalk Interface Developer utility redefines this structure u

66 Using the LonTalk Interface Developer Utility LON_SET_ATTRIBUTE(var, LON_ALPHA, alpha_flag); These macros are defi

FTXL User’s Guide 67 This floating-point format can represent numbers with the following characteristics: • 103810*1± approximate maximum val

viii Specifying the Authentication Key... 44 How Authentication Works...

68 Using the LonTalk Interface Developer Utility #define LON_MSMANTISSA_FIELD Flags_2 See the IEEE Standard for Binar

FTXL User’s Guide 69 The utility generates a configuration file in FtxlDev.c for the cpLocation configuration property: /* * * Writable con

70 Using the LonTalk Interface Developer Utility Similarly, a LonReadOnlyValueFile type is defined and used to declar

FTXL User’s Guide 71 • Defining the LON_READONLY_FILE_IS_WRITEABLE macro to 1 causes the read-only value file to be writeable by the local ap

72 Using the LonTalk Interface Developer Utility The FtxlTypes.h file defines the bitmasks for these attributes. For

FTXL User’s Guide 73 5 Developing an FTXL Application This chapter describes how to develop an FTXL application. It also describes the vari

74 Developing an FTXL Application Overview of an FTXL Application This chapter describes how to use the FTXL LonTalk

FTXL User’s Guide 75 Host ApplicationFTXL LonTalk APIApplication FrameworkOperating System Abstraction LayerHardware Abstraction LayerANSI/CEA

76 Developing an FTXL Application o Future versions or fixes to the FTXL product might affect these API files Callba

FTXL User’s Guide 77 The FTXL OSAL function prototypes are generic, and do not depend on the operating system’s syntax. For example, to creat

FTXL User’s Guide ix Initializing the FTXL Device ... 81 Periodically Calling the

78 Developing an FTXL Application current application. The header also includes a checksum to ensure that the data i

FTXL User’s Guide 79 this function returns FALSE, but if the device was reset while a transaction was in progress, this function returns TRUE

80 Developing an FTXL Application 7. Calling the LonNvdExitTransaction() callback handler function to clear the tran

FTXL User’s Guide 81 process FTXL events. This function then calls event handler functions (such as LonNvUpdateOccurred() or LonNvUpdateCompl

82 Developing an FTXL Application main thread, the application should implement an infinite loop that waits on this o

FTXL User’s Guide 83 Example: while (1) { // process application-specific data ... if (OsalWaitForEvent(readyHandle, OSAL_WAIT_FOREVER) =

84 Developing an FTXL Application application-specific processing of update completion. Figure 10 shows the control

FTXL User’s Guide 85 Do not handle an update failure with a repeated propagation; the FTXL LonTalk protocol stack automatically retries a numb

86 Developing an FTXL Application If a network variable update is received while the FTXL device is offline, the valu

FTXL User’s Guide 87 This example extends the previous example and shows how your application can be notified of an update to either network v