Echelon LonTal Stack Manual de usuario

Busca en linea o descarga Manual de usuario para Software Echelon LonTal Stack. Echelon LonTal Stack User Manual Manual de usuario

  • Descarga
  • Añadir a mis manuales
  • Imprimir
  • Pagina
    / 247
  • Tabla de contenidos
  • MARCADORES
  • Valorado. / 5. Basado en revisión del cliente

Indice de contenidos

Pagina 1 - Developer's Guide

LonTalk® Stack Developer's Guide 078-0483-01A

Pagina 2

x • LONMARK® Application Layer Interoperability Guidelines. This manual describes design guidelines for developing applications for open interoperab

Pagina 3 - Table of Contents

88 Using the LonTalk Interface Developer Utility The non-volatile data flush timeout value determines how long the Lo

Pagina 4

LonTalk Stack Developer’s Guide 89 allowing you to select from lists contained in a program ID definition file distributed by LONMARK Internat

Pagina 5

90 Using the LonTalk Interface Developer Utility The model file is a simple source file written using a subset of th

Pagina 6

LonTalk Stack Developer’s Guide 91 Specifying additional directories is optional. Use separate lines to specify multiple directories. The Lon

Pagina 7

92 Using the LonTalk Interface Developer Utility Click Next. Compiling and Generating the Files From the Summary and

Pagina 8

LonTalk Stack Developer’s Guide 93 The Build Progress and Summary page shows the results of compilation and generation of the LonTalk Stack pr

Pagina 9 - Related Documentation

94 Using the LonTalk Interface Developer Utility • FtxlDev.c • project.xif • project.xfb These files form the LonT

Pagina 10

LonTalk Stack Developer’s Guide 95 FtxlDev.h The FtxlDev.h file is the main header file that the LonTalk Interface Developer utility produces.

Pagina 11

96 Using the LonTalk Interface Developer Utility equivalents to the built-in Neuron C types. For example, the LonPla

Pagina 12

LonTalk Stack Developer’s Guide 97 typedef LON_STRUCT_BEGIN(SNVT_switch){ ncuInt value; ncsInt state; } LON_STRUCT_END(SNVT_switch); Type d

Pagina 13 - ONWORKS device

LonTalk Stack Developer’s Guide xi

Pagina 14 - Overview

98 Using the LonTalk Interface Developer Utility Enumerations The LonTalk Interface Developer utility does not produc

Pagina 15

LonTalk Stack Developer’s Guide 99 • 710*1−± approximate relative resolution The float_type structure declaration represents a floating-poin

Pagina 16 - ShortStack Developer’s Kit

100 Using the LonTalk Interface Developer Utility Network Variable and Configuration Property Declarations The LonTal

Pagina 17 - Communications Channel

LonTalk Stack Developer’s Guide 101 */ volatile LonWriteableValueFile lonWriteableValueFile = { {{'\x0', '\x0', '\

Pagina 18

102 Using the LonTalk Interface Developer Utility resources. You can use any type of non-volatile memory, or any oth

Pagina 19 - Stack Devices

LonTalk Stack Developer’s Guide 103 For the network management tool, however, the read-only file remains non-writeable. If your application u

Pagina 20

104 Using the LonTalk Interface Developer Utility input network variables, the polled attribute changes the behavior

Pagina 21

LonTalk Stack Developer’s Guide 105 8 Developing a LonTalk Stack Device Application This chapter describes how to develop a LonTalk Stack d

Pagina 22 - LonTalk Stack Architecture

106 Developing a LonTalk Stack Device Application Overview of a LonTalk Stack Device Application This chapter describ

Pagina 23

LonTalk Stack Developer’s Guide 107 Echelon Smart TransceiverorNeuron Processor Host ApplicationLonTalk APIApplication FrameworkOperating Syst

Pagina 25

108 Developing a LonTalk Stack Device Application o Future versions or fixes to the LonTalk Stack might affect these

Pagina 26

LonTalk Stack Developer’s Guide 109 a pointer to the created semaphore and returns a status variable that indicates whether the function was s

Pagina 27 - ONWORKS events

110 Developing a LonTalk Stack Device Application When data that must be stored persistently is updated in RAM, the L

Pagina 28 - ONWORKS network

LonTalk Stack Developer’s Guide 111 3. Calling the LonNvdRead() callback handler function to read the header of the NVD image. This function

Pagina 29

112 Developing a LonTalk Stack Device Application LonNvdSegNodeDefinition segments, but not for the application-defin

Pagina 30

LonTalk Stack Developer’s Guide 113 Initializing the LonTalk Stack Device Before your application initializes the LonTalk host stack, it must

Pagina 31 - Getting Started with the

114 Developing a LonTalk Stack Device Application operating system event which is signaled by the LonEventReady() cal

Pagina 32 - Software Requirements

LonTalk Stack Developer’s Guide 115 Example: while (1) { // process application-specific data ... if (OsalWaitForEvent(readyHandle, OSAL_

Pagina 33 - LonTalk Stack Files

116 Developing a LonTalk Stack Device Application any application-specific processing of update completion. The foll

Pagina 34 - ONWORKS channel

LonTalk Stack Developer’s Guide 117 Do not handle an update failure with a repeated propagation; the LonTalk host stack automatically retries

Pagina 35 - See Appendix G

LonTalk Stack Developer’s Guide 1 1 Introduction to LonTalk Stack This chapter introduces LonTalk Stack for embedded processors. It describ

Pagina 36

118 Developing a LonTalk Stack Device Application To process notification of a network variable update, modify the Lo

Pagina 37 - Transceiver or Neuron Chip

LonTalk Stack Developer’s Guide 119 extern void myController(void); void LonNvUpdateCompleted(unsigned index, const LonBool success

Pagina 38 - Loading Overview

120 Developing a LonTalk Stack Device Application { // nvoWatt = nviAmpere * nviVolt * nciGain.multiplier; LON_SET

Pagina 39

LonTalk Stack Developer’s Guide 121 Validating a Type Change The SCPTnvType configuration property is defined by the following structure: typ

Pagina 40

122 Developing a LonTalk Stack Device Application This enumeration describes the type (signed short or floating-point

Pagina 41

LonTalk Stack Developer’s Guide 123 then the application must process the type changes for both the network variable and the configuration net

Pagina 42

124 Developing a LonTalk Stack Device Application callback handler function can report the correct current size for a

Pagina 43 - Hardware Interface

LonTalk Stack Developer’s Guide 125 variable is added. On device startup, it calls this function for each dynamic network variable that had b

Pagina 44 - Serial Communication Lines

126 Developing a LonTalk Stack Device Application Sending an Application Message to the Network Call the LonSendMsg()

Pagina 45 - The RESET~ Pin

LonTalk Stack Developer’s Guide 127 or reset, and are handled by your LonWink(), LonOffline(), LonOnline(), and LonReset() callback handler fu

Pagina 46 - **5 PPSBPTPEAPMinBitRate

2 Introduction to the LonTalk Stack Overview Automation solutions for buildings, homes, utility, transportation, and industrial applications include

Pagina 47 - Interface

128 Developing a LonTalk Stack Device Application To return a LonTalk Stack device to the legacy mode, rather than th

Pagina 48 - SCI Interface

LonTalk Stack Developer’s Guide 129 The DMF Memory Window To the network management tool, all content of the DMF memory window is presented as

Pagina 49 - Health Check

130 Developing a LonTalk Stack Device Application Echelon Smart Transceiver or Neuron Chip Registered Memory WindowMa

Pagina 50 - Transceiver

LonTalk Stack Developer’s Guide 131 • Using named or unnamed files (the DMF framework uses unnamed files by default, whereas FTP uses named f

Pagina 51 - MIP Driver

132 Developing a LonTalk Stack Device Application

Pagina 52 - Code Packet Layout

LonTalk Stack Developer’s Guide 133 9 Developing an IP-852 Router Application This chapter describes how to develop a LonTalk Stack IP-852 r

Pagina 53

134 Developing an IP-852 Router Application Developing an IP-852 Router Application You can develop an IP-852 router

Pagina 54 - Type Code Values

LonTalk Stack Developer’s Guide 135 Function Syntax Description name persistence files. The index is arbitrary, but it may need to be betw

Pagina 55

136 Developing an IP-852 Router Application

Pagina 56 - Acknowledgment Rules

LonTalk Stack Developer’s Guide 137 10 Porting a LonTalk Stack Application This chapter describes how to port a LonTalk Stack device or IP-8

Pagina 57 - Supported MIP Command Set

LonTalk Stack Developer’s Guide 3 600 IP-852 Routers, and the LonTalk Stack. This document refers to the ISO/IEC 14908-1 Control Network Prot

Pagina 58 - Layer 2 / Layer 5 Modes

138 Porting a LonTalk Stack Application Porting Overview You can port your LonTalk Stack device or IP-852 router appl

Pagina 59 - Structures

LonTalk Stack Developer’s Guide 139 File/Folder Description MIP. The LonLink derived class is implemented in LonLinkDcx.cpp and LonLinkDcx.h

Pagina 60

140 Porting a LonTalk Stack Application Shared\LtChannel.cpp X X X Shared\LtCUtil.c X X X Shared\LtDomain.cpp X X X S

Pagina 61

LonTalk Stack Developer’s Guide 141 ble.cpp Stack\LtLayer4.cpp X X X Stack\LtLayer6.cpp X X X Stack\LtMip.cpp X X X Stack\LtMipApp.cpp X X X S

Pagina 62

142 Porting a LonTalk Stack Application Preprocessor Definition Description LONTALK_STACK_PLATFORM An application d

Pagina 63 - Creating a Model File

LonTalk Stack Developer’s Guide 143 Appendix A LonTalk Interface Developer Command Line Usage This appendix describes the command-line inte

Pagina 64 - Model File Overview

144 Appendix A: Appendix A LonTalk Interface Developer Command Line Usage Overview The LonTalk Interface D

Pagina 65

LonTalk Stack Developer’s Guide 145 • Commands of a Boolean type need not be followed by a value. In this case, the value yes is assumed. P

Pagina 66 - Choosing the Data Type

146 Appendix A: Appendix A LonTalk Interface Developer Command Line Usage Command Switch Long Form Short F

Pagina 67 - Defining a Functional Block

LonTalk Stack Developer’s Guide 147 Command Switch Long Form Short Form Description --silent Suppress banner message display --source -n Us

Pagina 68 - Defining a Network Variable

4 Introduction to the LonTalk Stack A LONWORKS device that uses a single processor chip is called a Neuron-hosted device, which means that the Neuro

Pagina 69

148 Appendix A: Appendix A LonTalk Interface Developer Command Line Usage The type and number for the --bu

Pagina 70 - Variable

LonTalk Stack Developer’s Guide 149 Buffer Type Primary Specification Alternate Specifications Valid Values Network output priority buffers no

Pagina 72

LonTalk Stack Developer’s Guide 151 Appendix B Model File Compiler Directives This Appendix lists the compiler directives that can be inclu

Pagina 73

152 Appendix B: Appendix B Model File Compiler Directives Using Model File Compiler Directives ANSI C perm

Pagina 74 - Value Changes

LonTalk Stack Developer’s Guide 153 Important: Configuration property re-ordering and merging can reduce the memory required for the template

Pagina 75

154 Appendix B: Appendix B Model File Compiler Directives #pragma set_guidelines_version string The Neuro

Pagina 76 - Linearization

LonTalk Stack Developer’s Guide 155 #pragma disable_warning number #pragma enable_warning number Controls the compiler's printing of indi

Pagina 78

LonTalk Stack Developer’s Guide 157 Appendix C Neuron C Syntax for the Model File This Appendix lists the Neuron C syntax for the allowable

Pagina 79 - Declaring a Message Tag

LonTalk Stack Developer’s Guide 5 A ShortStack Micro Server is an Echelon Smart Transceiver or Neuron Chip with ShortStack firmware that imple

Pagina 80 - Defining a Resource File

158 Appendix C: Appendix C Neuron C Syntax for the Model File Functional Block Syntax fblock FPT-identifie

Pagina 81

LonTalk Stack Developer’s Guide 159 If the fblock is implemented as an array, each network variable that is to be referenced by the fblock mus

Pagina 82

160 Appendix C: Appendix C Neuron C Syntax for the Model File These extra members are declared in the memb

Pagina 83 - Legacy Neuron C Constructs

LonTalk Stack Developer’s Guide 161 Functional Block Properties Syntax fb_properties { property-reference-list } property-reference-list :

Pagina 84

162 Appendix C: Appendix C Neuron C Syntax for the Model File has a range modification, then all members m

Pagina 85 - How Authentication Works

LonTalk Stack Developer’s Guide 163 pair for each member of the nvoData network variable array), and four offset CP family members (SCPToffset

Pagina 86 - Address Table

164 Appendix C: Appendix C Neuron C Syntax for the Model File network output SNVT_amp nvoAmpere; network o

Pagina 87 - Domain Table

LonTalk Stack Developer’s Guide 165 sync | synchronized Specifies that all values assigned to this network variable must be propagated, and i

Pagina 88 - Example Model files

166 Appendix C: Appendix C Neuron C Syntax for the Model File In an application that uses compiler-generat

Pagina 89

LonTalk Stack Developer’s Guide 167 Use a SNVT or SCPT if one is available that matches your data because SNVTs and SCPTs can provide interop

Pagina 90

6 Introduction to the LonTalk Stack API, which is an ANSI C API, to manage communications with the ShortStack Micro Server and devices on the LONWOR

Pagina 91

168 Appendix C: Appendix C Neuron C Syntax for the Model File network variables. This keyword is not requi

Pagina 92

LonTalk Stack Developer’s Guide 169 A network variable connection is authenticated only if the readers and writers have the authenticated keyw

Pagina 93 - Developer Utility

170 Appendix C: Appendix C Neuron C Syntax for the Model File The Network Variable Initializer initial-val

Pagina 94 - Specifying the Project File

LonTalk Stack Developer’s Guide 171 Network variable properties can be shared between two or more network variables. The use of the global ke

Pagina 95 - Chip Configuration

172 Appendix C: Appendix C Neuron C Syntax for the Model File cp_family Declares the configuration propert

Pagina 96

LonTalk Stack Developer’s Guide 173 of relying upon the value in the device interface file or a value stored in a network database. This spec

Pagina 97 - Configuring the Buffers

174 Appendix C: Appendix C Neuron C Syntax for the Model File has a range modification, then all members m

Pagina 98 - Configuring the Application

LonTalk Stack Developer’s Guide 175 5. If no initial value is available from any of the preceding rules, a value of all zeros is used. The co

Pagina 99

176 Appendix C: Appendix C Neuron C Syntax for the Model File The syntax for declaring a device property l

Pagina 100 - ONMARK Standard Program

LonTalk Stack Developer’s Guide 177 // empty string initializer with its own }; Message Tag Syntax msg_tag [ connection-info ] tag-identif

Pagina 101 - Specifying the Model File

LonTalk Stack Developer’s Guide 7 develop your application using the Echelon LonTalk API to manage communications between the LonTalk Host sta

Pagina 103

LonTalk Stack Developer’s Guide 179 Appendix D LonTalk API This Appendix describes the API functions, event handler functions, and callback

Pagina 104

180 Appendix D: LonTalk API Introduction The LonTalk API provides the functions that you call from your LonTalk Stack

Pagina 105

LonTalk Stack Developer’s Guide 181 Commonly Used LonTalk API Functions The following table lists API functions that you will most likely use

Pagina 106 - Copied Files

182 Appendix D: LonTalk API Function Description LonGetUniqueId() Gets the unique ID (Neuron ID) value of the Eche

Pagina 107 - Using Types

LonTalk Stack Developer’s Guide 183 Function Description LonNvdAppSegmentHasBeenUpdated() Indicates that the application data segment in no

Pagina 108

184 Appendix D: LonTalk API Function Description LonQueryTransceiverStatus() Requests the local status of the Echel

Pagina 109 - Bit Field Members

LonTalk Stack Developer’s Guide 185 Function Description LonNvUpdateOccurred() Indicates that a network variable update request from the ne

Pagina 110 - Enumerations

186 Appendix D: LonTalk API Function Description LonNvAdded() Indicates that a dynamic network variable has been a

Pagina 111

LonTalk Stack Developer’s Guide 187 Function Description LonNvdStarvation() Indicates that a write request to non-volatile data has taken m

Pagina 112 - Declarations

Echelon, LONWORKS, LONMARK, NodeBuilder, LonTalk, Neuron, 3120, 3150, LNS, ShortStack, and the Echelon logo are trademarks of Echelon Corporation regi

Pagina 113

8 Introduction to the LonTalk Stack File access methods supported FTP [4] , DMF FTP [4], DMF FTP [4], DMF [5] Link-layer type N/A 4- or 5-line S

Pagina 114

188 Appendix D: LonTalk API Function Description LonGetMyNetworkInterface() Gets the name of the network interface

Pagina 115 - Network Variable Attributes

LonTalk Stack Developer’s Guide 189 Function Description LonNvdDeserializeSegment() Indicates a request to update the LonTalk Stack device

Pagina 116 - The Message Tag Table

190 Appendix D: LonTalk API The following sections provide an overview of the functions that the OSAL provides. Manag

Pagina 117 - Device Application

LonTalk Stack Developer’s Guide 191 Managing System Timing To manage system timing, the OSAL provides the functions listed in the following ta

Pagina 118 - Using the LonTalk API

192 Appendix D: LonTalk API

Pagina 119 - LonTalk Protocol Stack

LonTalk Stack Developer’s Guide 193 Appendix E Determining Memory Usage for LonTalk Stack Applications This Appendix describes how much vola

Pagina 120 - Callbacks and Events

194 Appendix E: Appendix E Determining Memory Usage for LonTalk Stack Applications Overview The LonTalk Ho

Pagina 121

LonTalk Stack Developer’s Guide 195 Memory Use for Buffers The Buffer Configuration page of the LonTalk Interface Developer utility allows you

Pagina 122 - Restoring Non-Volatile Data

196 Appendix E: Appendix E Determining Memory Usage for LonTalk Stack Applications Resource Type Bytes Re

Pagina 123 - Writing Non-Volatile Data

LonTalk Stack Developer’s Guide 197 non-volatile data functions calculates the maximum use configuration, and reserves flash memory space so t

Pagina 124

LonTalk Stack Developer’s Guide 9 Notes: 1. ShortStack Micro Servers running on FT 3150 or PL 3150 Echelon Smart Transceivers support up to 2

Pagina 125

198 Appendix E: Appendix E Determining Memory Usage for LonTalk Stack Applications Node Data Bytes Requir

Pagina 126

LonTalk Stack Developer’s Guide 199 does not siginificantly alter the amount of RAM that the application requires. The number of buffers can

Pagina 127 - ONWORKS

200 Appendix E: Appendix E Determining Memory Usage for LonTalk Stack Applications Number of Network Vari

Pagina 128 - Application

LonTalk Stack Developer’s Guide 201 Appendix F Downloading a LonTalk Stack Application Over the Network This Appendix describes consideration

Pagina 129 - Network

202 Appendix F: Appendix F Downloading a LonTalk Stack Application Over the Network Overview For a Neuron-h

Pagina 130

LonTalk Stack Developer’s Guide 203 During this stage, the LonTalk Stack device should verify that the application to be downloaded can run on

Pagina 131

204 Appendix F: Appendix F Downloading a LonTalk Stack Application Over the Network application download ut

Pagina 132 - Variables

LonTalk Stack Developer’s Guide 205 Appendix G Example LonTalk Stack Applications This Appendix describes the example applications that are

Pagina 133 - Validating a Type Change

206 Appendix G: Appendix G Example LonTalk Stack Applications Overview of the Example Applications The Lon

Pagina 134 - Processing a Type Change

LonTalk Stack Developer’s Guide 207 Function Description Ip852Router A router that connects an IP-852 channel to a native LonTalk channel.

Pagina 135 - Processing a Size Change

10 Introduction to the LonTalk Stack Development Tools for LonTalk Stack To develop an application for a device that uses the LonTalk Stack, you nee

Pagina 136 - Rejecting a Type Change

208 Appendix G: Appendix G Example LonTalk Stack Applications To test the example application, you can use

Pagina 137 - Messages

LonTalk Stack Developer’s Guide 209 The model file for this example includes a single SFPTclosedLoopActuator functional block for the two netw

Pagina 138 - Handling Management Commands

210 Appendix G: Appendix G Example LonTalk Stack Applications "\n"

Pagina 139 - Working with ECS Devices

LonTalk Stack Developer’s Guide 211 OsalSleep(10); } OsalCloseTaskHandle(taskHandle); }

Pagina 140 - Using Direct Memory Files

212 Appendix G: Appendix G Example LonTalk Stack Applications LonResgisterUniqueId(&uid); #endif

Pagina 141 - The DMF Memory Window

LonTalk Stack Developer’s Guide 213 The two network variables are defined in the model file, which is described in Model File. The myNvUpdateO

Pagina 142 - File Directory

214 Appendix G: Appendix G Example LonTalk Stack Applications The myEventReady() function calls the OSAL O

Pagina 143

LonTalk Stack Developer’s Guide 215 4. Run the LonWorks Interface Developer by double-clicking the Simple Example.lidprj file. This generate

Pagina 144

216 Appendix G: Appendix G Example LonTalk Stack Applications 5. Runs a simple command console: • When t

Pagina 145 - Developing an IP-852 Router

LonTalk Stack Developer’s Guide 217 sts = router.Start(0, ltUid, pLtChannel, 1, ipUid, ipAddress, ipPort)

Pagina 146 - LtIp852Router

LonTalk Stack Developer’s Guide 11 The LonTalk Stack includes source code for the LonTalk API and the LonTalk host stack. The kit also inclu

Pagina 148

LonTalk Stack Developer’s Guide 219 Appendix H LonTalk Interface Developer Utility Error and Warning Messages This Appendix lists the LonTal

Pagina 149 - Porting a LonTalk Stack

220 Appendix H: Appendix H LonTalk Interface Developer Utility Error and Warning Messages Introduction All

Pagina 150 - LonLink Driver

LonTalk Stack Developer’s Guide 221 LID# Description 5 An error occurred when reading a device interface file This is an internal error, pro

Pagina 151 - LonTalkStack Source Files

222 Appendix H: Appendix H LonTalk Interface Developer Utility Error and Warning Messages LID# Description

Pagina 152

LonTalk Stack Developer’s Guide 223 LID# Description 23 An error occurred when reading a type info file (.NCT) This is an internal error, po

Pagina 153 - Selecting the Device Type

224 Appendix H: Appendix H LonTalk Interface Developer Utility Error and Warning Messages LID# Description

Pagina 154 - File System Requirements

LonTalk Stack Developer’s Guide 225 LID# Description 36 The program ID found in the XIF file seems malformed and cannot be used to produce t

Pagina 155 - Command Line Usage

226 Appendix H: Appendix H LonTalk Interface Developer Utility Error and Warning Messages LID# Description

Pagina 156 - Command Usage

LonTalk Stack Developer’s Guide 227 LID# Description 4006 A file cannot be copied This is possibly, but not necessarily, fatal. When the Lo

Pagina 157 - Command Switches

12 Introduction to the LonTalk Stack Overview of the LonTalk Stack Development Process The development process for a LonTalk Stack application inclu

Pagina 158

228 Appendix H: Appendix H LonTalk Interface Developer Utility Error and Warning Messages LID# Description

Pagina 159 - Specifying Buffers

LonTalk Stack Developer’s Guide 229

Pagina 161

LonTalk Stack Developer’s Guide 231 Appendix I Glossary This appendix defines many of the common terms used for LonTalk Stack device develop

Pagina 162

232 Appendix I: Glossary D downlink Link-layer data transfer from the host to the Echelon Smart Transceiver or Neuron

Pagina 163 - Appendix B

LonTalk Stack Developer’s Guide 233 H host processor A microcontroller, microprocessor, or embedded processor that is integrated with the Lo

Pagina 164

234 Appendix I: Glossary LonTalk Stack application An application for a LONWORKS device based on the LonTalk API and

Pagina 165

www.echelon.com

Pagina 166

LonTalk Stack Developer’s Guide 13 This manual describes the software development process for creating a LonTalk Stack device, which includes

Pagina 167

14 Introduction to the LonTalk Stack Task Additional Considerations Reference Develop a LonTalk Stack serial driver for your host processor that m

Pagina 168

LonTalk Stack Developer’s Guide 15 Task Additional Considerations Reference Structure the layout and interoperable interface of your LonTalk

Pagina 169 - Appendix C

16 Introduction to the LonTalk Stack Task Additional Considerations Reference Modify your application to interface with a LONWORKS network by usin

Pagina 170 - Keywords

LonTalk Stack Developer’s Guide 17

Pagina 171

LonTalk Stack Developer’s Guide iii Table of Contents Welcome...

Pagina 173

LonTalk Stack Developer’s Guide 19 2 Getting Started with the LonTalk Stack Developer’s Kit This chapter describes the LonTalk Stack and how

Pagina 174

20 Getting Started with the LonTalk Stack Developer’s Kit LonTalk Stack Overview The LonTalk Stack Developer’s Kit contains the source code, firmwar

Pagina 175

LonTalk Stack Developer’s Guide 21 • Microsoft® Windows® XP, plus Service Pack 3 or later. Installing the LonTalk Stack Developer’s Kit To in

Pagina 176 - Network Variable Syntax

22 Getting Started with the LonTalk Stack Developer’s Kit modify and link with your application. This framework contains most of the code that is n

Pagina 177

LonTalk Stack Developer’s Guide 23 See Appendix G, Example LonTalk Stack Applications, for more information about these examples.

Pagina 178 - The Network Variable Type

24 Getting Started with the LonTalk Stack Developer’s Kit

Pagina 179 - Information

LonTalk Stack Developer’s Guide 25 3 Loading the Echelon Smart Transceiver or Neuron Chip This chapter describes how to load an application

Pagina 180

26 Loading the Echelon Smart Transceiver or Neuron Chip Loading Overview To create a LonTalk Stack device, you first

Pagina 181

LonTalk Stack Developer’s Guide 27 The following table lists the Neuron processor and memory combinations, and it lists the application image

Pagina 182

iv Serial MIP Driver Example... 47 Serial MIP Driver API ...

Pagina 183

28 Loading the Echelon Smart Transceiver or Neuron Chip Notes: • If you load an NDL file with the NodeL

Pagina 184

LonTalk Stack Developer’s Guide 29 Updated Symbol File Destination Folder on Development Computer Source/Target/Neuron/L2MLIB/ Ver14/sys3150l2

Pagina 185

30 Loading the Echelon Smart Transceiver or Neuron Chip Function Syntax Description l2ml_freel2packet() extern syst

Pagina 186

LonTalk Stack Developer’s Guide 31 4 Designing the Serial I/O Hardware Interface This chapter describes what you need to design the serial I

Pagina 187

32 Designing the Serial I/O Hardware Interface Overview of the Hardware Interface This chapter describes the hardware

Pagina 188

LonTalk Stack Developer’s Guide 33 The RESET~ Pin The Echelon Smart Transceiver and Neuron Chip have no special requirements for the RESET~ (o

Pagina 189 - Message Tag Syntax

34 Designing the Serial I/O Hardware Interface higher voltage drop (typically, 0.7 V), that is, the Schottky diode en

Pagina 190

LonTalk Stack Developer’s Guide 35 o sizeof(network_variable) o sizeof(message_length) • InterfaceBPT represents data transfer overhead for

Pagina 191 - LonTalk API

36 Designing the Serial I/O Hardware Interface Host Latency Considerations The processing time required by the host p

Pagina 192 - LonTalk API Functions

LonTalk Stack Developer’s Guide 37 • 8 data bits (least-significant bit first) • 1 stop bit The SCI link-layer interface uses two serial da

Pagina 193 - Other LonTalk API Functions

LonTalk Stack Developer’s Guide v Specifying Code Generator Preferences... 91 Compiling and Genera

Pagina 194 - ONWORKS device. The

38 Designing the Serial I/O Hardware Interface PL 3120FT 5000Echelon Smart TransceiverTXDRXDRESET~VDD9 x 10 kΩ Your h

Pagina 195 - Extended API Functions

LonTalk Stack Developer’s Guide 39 5 Creating a LonTalk Stack Serial MIP Driver This chapter describes the link-layer protocol (LLP) and how

Pagina 196 - Event Handler Functions

40 Creating a LonTalk Stack Serial MIP Driver Overview of the Link Layer Protocol The LonTalk Serial MIP driver commu

Pagina 197 - Functions

LonTalk Stack Developer’s Guide 41 The packet sum is an 8-bit value that, when added to the first three bytes, results in an 8-bit zero result

Pagina 198

42 Creating a LonTalk Stack Serial MIP Driver Type Code Values The following table lists the values for the Type Code

Pagina 199

LonTalk Stack Developer’s Guide 43 Value Type Description Uplink / Downlink 4 CpMsgAck The Serial MIP is entering the ready-receive state.

Pagina 200

44 Creating a LonTalk Stack Serial MIP Driver • All length fields do not count for escape prefixes. Instead, they r

Pagina 201

LonTalk Stack Developer’s Guide 45 Sequence Number Cycling and Duplicate Detection The sequence number is used to reject duplicate non-LLP dat

Pagina 202 - Managing Binary Semaphores

46 Creating a LonTalk Stack Serial MIP Driver Value Name Description Uplink / Downlink 0x90 niFLUSH Sets the MIP

Pagina 203 - Managing System Timing

LonTalk Stack Developer’s Guide 47 Product Query Network Management The Serial MIP supports the Product Query network management command from

Pagina 204 - 192 Appendix D: LonTalk API

vi LtLogicalChannel ... 134 LtIp852Router ...

Pagina 205 - LonTalk Stack Applications

48 Creating a LonTalk Stack Serial MIP Driver Structure Description sensed. UlDiscarded. Number of tossed uplinks.

Pagina 206 - Memory Use for Transactions

LonTalk Stack Developer’s Guide 49 Function Syntax Description SciMipRead LdvRetVal SciMipRead ( LDV_Message *pMsg, int size); De-queu

Pagina 207 - Memory Use for Buffers

50 Creating a LonTalk Stack Serial MIP Driver Function Syntax Description SciMipStatistics LdvRetVal SciMipStatisti

Pagina 208 - Memory for Non-Volatile Data

LonTalk Stack Developer’s Guide 51 6 Creating a Model File You use a model file to define your device’s interoperable interface, including i

Pagina 209

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

Pagina 210 - CPNVlen

LonTalk Stack Developer’s Guide 53 file. NodeBuilder software is not included with the LonTalk Stack, and must be licensed separately. See t

Pagina 211

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

Pagina 212

LonTalk Stack Developer’s Guide 55 Using changeable-type network variables allows you to design a generic device (such as a generic proportion

Pagina 213 - Application Over the Network

56 Creating a Model File Declaring a Functional Block A functional block declaration, by itself, does not cause the L

Pagina 214

LonTalk Stack Developer’s Guide 57 You can minimize the need for type translators by using standard network variable types (SNVTs) for commonl

Pagina 215 - Application Download Utility

LonTalk Stack Developer’s Guide vii LonTalk API Functions ... 180 Commonly

Pagina 216

58 Creating a Model File other devices (or groups of devices) in the network that expect a specific network variable,

Pagina 217 - Applications

LonTalk Stack Developer’s Guide 59 1. Declare the network variable with the changeable_type keyword. You must declare an initial type for th

Pagina 218

60 Creating a Model File use the NodeBuilder Resource Editor to look through the standard configuration property type

Pagina 219 - Running the Examples

LonTalk Stack Developer’s Guide 61 property array must be shared among all network variables or functional blocks to which it applies. In thi

Pagina 220 - Application Details

62 Creating a Model File The LONWORKS file transfer protocol and the direct memory files features are mutually exclus

Pagina 221 - Main Function

LonTalk Stack Developer’s Guide 63 Example: This example defines a four-channel analog-to-digital converter (ADC), with the following properti

Pagina 222 - Example LonTalk

64 Creating a Model File network variable to which the property applies. For an SFPTopenLoopSensor standard function

Pagina 223 - Application Task Function

LonTalk Stack Developer’s Guide 65 The global keyword causes a configuration property member to be shared among all the functional blocks or n

Pagina 224 - Event Handler Function

66 Creating a Model File fblock SFPTopenLoopSensor { nvoAmpere[0] implements nvoValue; } fbAmpereMeter[NUM_PHASES]

Pagina 225 - Callback Handler Function

LonTalk Stack Developer’s Guide 67 cpDefaultOutput = 123 }; fblock SFPTopenLoopSensor { nvoAmpere implements nvoValue; } fbAmpereMeter; T

Pagina 226 - Model File

viii Model File... 214 Extending the SimpleLtDevice and Simp

Pagina 227

68 Creating a Model File msg_tag myBindableMT; msg_tag bind_info(nonbind) myNotBindableMT; Similar to network variabl

Pagina 228

LonTalk Stack Developer’s Guide 69 2 – Device Class and Subclass Applies to all devices with the specified device class and subclass. 3 – Manu

Pagina 229

70 Creating a Model File the highest (most specific) applicable scope level. See the NodeBuilder FX User’s Guide for

Pagina 230

LonTalk Stack Developer’s Guide 71 predefines the _FTXL and _MODEL_FILE macros, so that you can use #ifdef or #ifndef compiler directives to c

Pagina 231 - Error and Warning Messages

72 Creating a Model File that the “open” message comes from the owner, not from someone attempting to break into the

Pagina 232 - Error Messages

LonTalk Stack Developer’s Guide 73 tool, but must specify an authentication key because the device has only a default key. How Authentication

Pagina 233

74 Creating a Model File messages and commands be secret, because they are sent unencrypted over the network, and any

Pagina 234 - ONWORKS Bin folder

LonTalk Stack Developer’s Guide 75 The maximum number of address table entries that a device could require is determined by the expected maxim

Pagina 235

76 Creating a Model File Network Variable Configuration Table This table contains one entry for each network variable

Pagina 236

LonTalk Stack Developer’s Guide 77 posted to the nvoWattage output network variable. A second nvoUsage output network variable is polled and

Pagina 237

LonTalk Stack Developer’s Guide ix Welcome Echelon’s LonTalk® Stack enables you to add a high-performance ISO/IEC 14908-1 control networking i

Pagina 238 - Warning Codes

78 Creating a Model File // Implements the meter from the previous example. network input SNVT_amp nviAmpere

Pagina 239

LonTalk Stack Developer’s Guide 79 nciMaxSendTime[0] }; network output polled eeprom SNVT_elapsed_tm nvoUsage; fblock UFPTenergyMeter { n

Pagina 240 - Hint Codes

80 Creating a Model File nvoNodeStatus implements nvoStatus; nvoFileDirectory implements nvoFileDirectory; } Nod

Pagina 241

LonTalk Stack Developer’s Guide 81 7 Using the LonTalk Interface Developer Utility You use the model file, described in Chapter 6, and the

Pagina 242

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

Pagina 243 - Glossary

LonTalk Stack Developer’s Guide 83 You can include a project version number in the name of the project to facilitate version control and pr

Pagina 244

84 Using the LonTalk Interface Developer Utility Select a clock speed and then click Next. In the System Preferenc

Pagina 245

LonTalk Stack Developer’s Guide 85 • The size of the address table (the number of addresses) • The size of the alias table (the number of al

Pagina 246

86 Using the LonTalk Interface Developer Utility • Non-priority output buffers • Priority output buffers You can s

Pagina 247

LonTalk Stack Developer’s Guide 87 The average amount of memory to reserve for dynamic network variable self-documentation strings is used, a

Comentarios a estos manuales

Sin comentarios