Echelon LonTal Stack Uživatelský manuál

Procházejte online nebo si stáhněte Uživatelský manuál pro Software Echelon LonTal Stack. Echelon LonTal Stack User Manual Uživatelská příručka

  • Stažení
  • Přidat do mých příruček
  • Tisk
  • Strana
    / 247
  • Tabulka s obsahem
  • KNIHY
  • Hodnocené. / 5. Na základě hodnocení zákazníků

Shrnutí obsahu

Strany 1 - Developer's Guide

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

Strany 2

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

Strany 3 - Table of Contents

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

Strany 4

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

Strany 5

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

Strany 6

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

Strany 7

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

Strany 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

Strany 9 - Related Documentation

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

Strany 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.

Strany 11

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

Strany 12

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

Strany 13 - ONWORKS device

LonTalk Stack Developer’s Guide xi

Strany 14 - Overview

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

Strany 15

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

Strany 16 - ShortStack Developer’s Kit

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

Strany 17 - Communications Channel

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

Strany 18

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

Strany 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

Strany 20

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

Strany 21

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

Strany 22 - LonTalk Stack Architecture

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

Strany 23

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

Strany 25

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

Strany 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

Strany 27 - ONWORKS events

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

Strany 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

Strany 29

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

Strany 30

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

Strany 31 - Getting Started with the

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

Strany 32 - Software Requirements

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

Strany 33 - LonTalk Stack Files

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

Strany 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

Strany 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

Strany 36

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

Strany 37 - Transceiver or Neuron Chip

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

Strany 38 - Loading Overview

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

Strany 39

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

Strany 40

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

Strany 41

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

Strany 42

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

Strany 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

Strany 44 - Serial Communication Lines

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

Strany 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

Strany 46 - **5 PPSBPTPEAPMinBitRate

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

Strany 47 - Interface

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

Strany 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

Strany 49 - Health Check

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

Strany 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

Strany 51 - MIP Driver

132 Developing a LonTalk Stack Device Application

Strany 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

Strany 53

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

Strany 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

Strany 55

136 Developing an IP-852 Router Application

Strany 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

Strany 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

Strany 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

Strany 59 - Structures

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

Strany 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

Strany 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

Strany 62

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

Strany 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

Strany 64 - Model File Overview

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

Strany 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

Strany 66 - Choosing the Data Type

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

Strany 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

Strany 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

Strany 69

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

Strany 70 - Variable

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

Strany 72

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

Strany 73

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

Strany 74 - Value Changes

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

Strany 75

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

Strany 76 - Linearization

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

Strany 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

Strany 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

Strany 80 - Defining a Resource File

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

Strany 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

Strany 82

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

Strany 83 - Legacy Neuron C Constructs

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

Strany 84

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

Strany 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

Strany 86 - Address Table

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

Strany 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

Strany 88 - Example Model files

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

Strany 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

Strany 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

Strany 91

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

Strany 92

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

Strany 93 - Developer Utility

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

Strany 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

Strany 95 - Chip Configuration

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

Strany 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

Strany 97 - Configuring the Buffers

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

Strany 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

Strany 99

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

Strany 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

Strany 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

Strany 103

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

Strany 104

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

Strany 105

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

Strany 106 - Copied Files

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

Strany 107 - Using Types

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

Strany 108

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

Strany 109 - Bit Field Members

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

Strany 110 - Enumerations

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

Strany 111

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

Strany 112 - Declarations

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

Strany 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

Strany 114

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

Strany 115 - Network Variable Attributes

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

Strany 116 - The Message Tag Table

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

Strany 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

Strany 118 - Using the LonTalk API

192 Appendix D: LonTalk API

Strany 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

Strany 120 - Callbacks and Events

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

Strany 121

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

Strany 122 - Restoring Non-Volatile Data

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

Strany 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

Strany 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

Strany 125

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

Strany 126

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

Strany 127 - ONWORKS

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

Strany 128 - Application

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

Strany 129 - Network

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

Strany 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

Strany 131

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

Strany 132 - Variables

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

Strany 133 - Validating a Type Change

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

Strany 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.

Strany 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

Strany 136 - Rejecting a Type Change

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

Strany 137 - Messages

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

Strany 138 - Handling Management Commands

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

Strany 139 - Working with ECS Devices

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

Strany 140 - Using Direct Memory Files

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

Strany 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

Strany 142 - File Directory

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

Strany 143

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

Strany 144

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

Strany 145 - Developing an IP-852 Router

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

Strany 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

Strany 148

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

Strany 149 - Porting a LonTalk Stack

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

Strany 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

Strany 151 - LonTalkStack Source Files

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

Strany 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

Strany 153 - Selecting the Device Type

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

Strany 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

Strany 155 - Command Line Usage

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

Strany 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

Strany 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

Strany 158

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

Strany 159 - Specifying Buffers

LonTalk Stack Developer’s Guide 229

Strany 161

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

Strany 162

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

Strany 163 - Appendix B

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

Strany 164

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

Strany 165

www.echelon.com

Strany 166

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

Strany 167

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

Strany 168

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

Strany 169 - Appendix C

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

Strany 170 - Keywords

LonTalk Stack Developer’s Guide 17

Strany 171

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

Strany 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

Strany 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

Strany 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

Strany 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

Strany 177

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

Strany 178 - The Network Variable Type

24 Getting Started with the LonTalk Stack Developer’s Kit

Strany 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

Strany 180

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

Strany 181

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

Strany 182

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

Strany 183

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

Strany 184

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

Strany 185

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

Strany 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

Strany 187

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

Strany 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

Strany 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

Strany 190

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

Strany 191 - LonTalk API

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

Strany 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

Strany 193 - Other LonTalk API Functions

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

Strany 194 - ONWORKS device. The

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

Strany 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

Strany 196 - Event Handler Functions

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

Strany 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

Strany 198

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

Strany 199

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

Strany 200

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

Strany 201

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

Strany 202 - Managing Binary Semaphores

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

Strany 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

Strany 204 - 192 Appendix D: LonTalk API

vi LtLogicalChannel ... 134 LtIp852Router ...

Strany 205 - LonTalk Stack Applications

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

Strany 206 - Memory Use for Transactions

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

Strany 207 - Memory Use for Buffers

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

Strany 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

Strany 209

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

Strany 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

Strany 211

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

Strany 212

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

Strany 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

Strany 214

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

Strany 215 - Application Download Utility

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

Strany 216

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

Strany 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

Strany 218

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

Strany 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

Strany 220 - Application Details

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

Strany 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

Strany 222 - Example LonTalk

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

Strany 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

Strany 224 - Event Handler Function

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

Strany 225 - Callback Handler Function

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

Strany 226 - Model File

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

Strany 227

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

Strany 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

Strany 229

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

Strany 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

Strany 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

Strany 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

Strany 233

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

Strany 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

Strany 235

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

Strany 236

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

Strany 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

Strany 238 - Warning Codes

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

Strany 239

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

Strany 240 - Hint Codes

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

Strany 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

Strany 242

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

Strany 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

Strany 244

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

Strany 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

Strany 246

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

Strany 247

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

Komentáře k této Příručce

Žádné komentáře