Echelon LonTal Stack Manual do Utilizador

Consulte online ou descarregue Manual do Utilizador para Software Echelon LonTal Stack. Echelon LonTal Stack User Manual Manual do Utilizador

  • Descarregar
  • Adicionar aos meus manuais
  • Imprimir
  • Página
    / 247
  • Índice
  • MARCADORES
  • Avaliado. / 5. Com base em avaliações de clientes

Resumo do Conteúdo

Página 1 - Developer's Guide

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

Página 2

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

Página 3 - Table of Contents

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

Página 4

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

Página 5

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

Página 6

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

Página 7

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

Página 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

Página 9 - Related Documentation

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

Página 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.

Página 11

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

Página 12

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

Página 13 - ONWORKS device

LonTalk Stack Developer’s Guide xi

Página 14 - Overview

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

Página 15

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

Página 16 - ShortStack Developer’s Kit

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

Página 17 - Communications Channel

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

Página 18

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

Página 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

Página 20

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

Página 21

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

Página 22 - LonTalk Stack Architecture

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

Página 23

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

Página 25

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

Página 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

Página 27 - ONWORKS events

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

Página 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

Página 29

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

Página 30

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

Página 31 - Getting Started with the

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

Página 32 - Software Requirements

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

Página 33 - LonTalk Stack Files

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

Página 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

Página 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

Página 36

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

Página 37 - Transceiver or Neuron Chip

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

Página 38 - Loading Overview

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

Página 39

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

Página 40

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

Página 41

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

Página 42

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

Página 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

Página 44 - Serial Communication Lines

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

Página 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

Página 46 - **5 PPSBPTPEAPMinBitRate

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

Página 47 - Interface

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

Página 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

Página 49 - Health Check

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

Página 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

Página 51 - MIP Driver

132 Developing a LonTalk Stack Device Application

Página 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

Página 53

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

Página 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

Página 55

136 Developing an IP-852 Router Application

Página 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

Página 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

Página 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

Página 59 - Structures

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

Página 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

Página 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

Página 62

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

Página 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

Página 64 - Model File Overview

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

Página 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

Página 66 - Choosing the Data Type

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

Página 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

Página 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

Página 69

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

Página 70 - Variable

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

Página 72

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

Página 73

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

Página 74 - Value Changes

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

Página 75

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

Página 76 - Linearization

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

Página 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

Página 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

Página 80 - Defining a Resource File

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

Página 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

Página 82

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

Página 83 - Legacy Neuron C Constructs

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

Página 84

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

Página 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

Página 86 - Address Table

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

Página 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

Página 88 - Example Model files

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

Página 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

Página 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

Página 91

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

Página 92

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

Página 93 - Developer Utility

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

Página 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

Página 95 - Chip Configuration

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

Página 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

Página 97 - Configuring the Buffers

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

Página 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

Página 99

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

Página 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

Página 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

Página 103

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

Página 104

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

Página 105

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

Página 106 - Copied Files

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

Página 107 - Using Types

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

Página 108

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

Página 109 - Bit Field Members

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

Página 110 - Enumerations

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

Página 111

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

Página 112 - Declarations

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

Página 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

Página 114

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

Página 115 - Network Variable Attributes

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

Página 116 - The Message Tag Table

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

Página 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

Página 118 - Using the LonTalk API

192 Appendix D: LonTalk API

Página 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

Página 120 - Callbacks and Events

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

Página 121

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

Página 122 - Restoring Non-Volatile Data

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

Página 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

Página 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

Página 125

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

Página 126

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

Página 127 - ONWORKS

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

Página 128 - Application

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

Página 129 - Network

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

Página 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

Página 131

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

Página 132 - Variables

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

Página 133 - Validating a Type Change

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

Página 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.

Página 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

Página 136 - Rejecting a Type Change

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

Página 137 - Messages

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

Página 138 - Handling Management Commands

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

Página 139 - Working with ECS Devices

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

Página 140 - Using Direct Memory Files

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

Página 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

Página 142 - File Directory

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

Página 143

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

Página 144

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

Página 145 - Developing an IP-852 Router

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

Página 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

Página 148

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

Página 149 - Porting a LonTalk Stack

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

Página 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

Página 151 - LonTalkStack Source Files

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

Página 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

Página 153 - Selecting the Device Type

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

Página 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

Página 155 - Command Line Usage

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

Página 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

Página 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

Página 158

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

Página 159 - Specifying Buffers

LonTalk Stack Developer’s Guide 229

Página 161

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

Página 162

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

Página 163 - Appendix B

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

Página 164

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

Página 165

www.echelon.com

Página 166

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

Página 167

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

Página 168

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

Página 169 - Appendix C

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

Página 170 - Keywords

LonTalk Stack Developer’s Guide 17

Página 171

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

Página 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

Página 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

Página 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

Página 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

Página 177

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

Página 178 - The Network Variable Type

24 Getting Started with the LonTalk Stack Developer’s Kit

Página 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

Página 180

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

Página 181

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

Página 182

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

Página 183

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

Página 184

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

Página 185

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

Página 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

Página 187

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

Página 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

Página 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

Página 190

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

Página 191 - LonTalk API

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

Página 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

Página 193 - Other LonTalk API Functions

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

Página 194 - ONWORKS device. The

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

Página 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

Página 196 - Event Handler Functions

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

Página 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

Página 198

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

Página 199

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

Página 200

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

Página 201

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

Página 202 - Managing Binary Semaphores

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

Página 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

Página 204 - 192 Appendix D: LonTalk API

vi LtLogicalChannel ... 134 LtIp852Router ...

Página 205 - LonTalk Stack Applications

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

Página 206 - Memory Use for Transactions

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

Página 207 - Memory Use for Buffers

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

Página 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

Página 209

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

Página 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

Página 211

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

Página 212

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

Página 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

Página 214

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

Página 215 - Application Download Utility

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

Página 216

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

Página 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

Página 218

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

Página 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

Página 220 - Application Details

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

Página 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

Página 222 - Example LonTalk

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

Página 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

Página 224 - Event Handler Function

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

Página 225 - Callback Handler Function

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

Página 226 - Model File

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

Página 227

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

Página 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

Página 229

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

Página 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

Página 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

Página 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

Página 233

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

Página 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

Página 235

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

Página 236

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

Página 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

Página 238 - Warning Codes

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

Página 239

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

Página 240 - Hint Codes

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

Página 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

Página 242

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

Página 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

Página 244

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

Página 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

Página 246

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

Página 247

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

Comentários a estes Manuais

Sem comentários