Echelon Mini FX Manuel d'utilisateur

0 7 8 - 0 3 9 8 - 0 1 A®Mini FX User’s Guide

Mini FX User's Guide ix PCLTA-20, or PCLTA-21 network interfaces; and the SLTA-10 Serial LonTalk Adapter. o Compatible remote network interf

Mini FX User's Guide 87 SFPTopenLoopActuator, where each functional block encapsulates the network variable and configuration property for each

88 Developing Device Applications Advanced Digital Sensor Example The advanced digital sensor example expands the previous simple digital sensor and

Mini FX User's Guide 89 // and make sure the timer is stopped: // nvoSwitch.state ^= 1; autoOffTimer = 0; }

90 Developing Device Applications #include <string.h> #include <snvt_hv.h> #include "io.nc" #pragma enable_sd_nv_names

Mini FX User's Guide 91 Thermostat(); } when(timer_expires(sampleTimer)) { Thermostat(); } when(nv_update_occurs(nviSetpoint)) {

92 Developing Device Applications Display(3,0, "Setpoint: 0.00", nviSetpoint); // Schedule next sample: if (nciHeartbeat

Mini FX User's Guide 93 decide whether to start the ISI engine at reset time, but it does not have to make the same decision repeatedly. The r

94 Developing Device Applications // uses the PL 3170 Smart Transceiver, and use IsiCompactS.lib for // devices using an FT 3120 or PL 3120 Smart Tra

Mini FX User's Guide 95 // TODO: process other application messages here (if any) ; } } The second part of this segment pro

96 Developing Device Applications ISI_DEFAULT_GROUP, isiDirectionVarious, 1, 0xFF, 95u, 0, { 0, 0, isiScopeStandard, {0x00, 0x00, 0

x Preface FT 5000 EVB Hardware Guide Describes how to connect the FT 5000 EVBs, and describes the Neuron core, I/O devices, service pin and reset b

Mini FX User's Guide 97 Appendix A Glossary This appendix provides definitions for many terms commonly used with Mini FX device development.

98 Appendix A: Glossary Application Device A LONWORKS device that runs an ISO/IEC 14908-1 application (OSI Layer 7). The application may run on a N

Mini FX User's Guide 99 Commissioning The process in which the LonMaker tool or other network management tool downloads network and applicatio

100 Appendix A: Glossary Download An installation process in which data, such as the application program, network configuration, and/or application c

Mini FX User's Guide 101 User-defined functional profiles can be created if no appropriate standard profiles are available. Hardware Template

102 Appendix A: Glossary vendors can work together to install, maintain, monitor, and control LONWORKS networks. The LNS architecture consists of th

Mini FX User's Guide 103 LONWORKS Network A network of intelligent devices (such as sensors, actuators, and controllers) that communicate with

104 Appendix A: Glossary can be a standard configuration property type (SCPT) or a user-defined configuration property type (UCPT) Neuron 5000 Proces

Mini FX User's Guide 105 Neuron Firmware A complete operating system including an implementation of the ISO/IEC 14908-1 protocol used by a Neur

106 Appendix A: Glossary variables or configuration properties specified by the functional profile that the functional block is instantiating. PCC-

Mini FX User's Guide xi NodeBuilder® Resource Editor User’s Guide Describes how to use the NodeBuilder Resource Editor to create and edit resou

Mini FX User's Guide 107 The SLTA-10 network interface is supported, but not recommended unless dial-up operation through a modem and a serial

108 Appendix A: Glossary durations of time, in seconds. The SCPTmaxSentTime standard configuration property type references SNVT_time_sec, but adds

Mini FX User's Guide 109 Appendix B Creating and Editing Hardware Templates This appendix explains how to edit standard hardware templates wit

110 Appendix B: Editing Hardware Templates Using Hardware Templates You can create new custom hardware templates and then configure them with the Ha

Mini FX User's Guide 111 Creating Custom Hardware Templates You can create a new custom hardware template from a copy of a Standard hardware te

112 Appendix B: Editing Hardware Templates Figure B-2 Default Hardware Properties You can set the following properties on the Hardware tab: Hardwar

Mini FX User's Guide 113 Platform A platform is a category of hardware implementations. Most hardware templates, including standard and user-

114 Appendix B: Editing Hardware Templates For Series 5000 chips, the default internal system clock speed is 80.00 MHz (the crystal’s speed external

Mini FX User's Guide 115 Figure B-3 Default Memory Properties for FT 5000 Evaluation Board Hardware Template The Memory Addresses box details

116 Appendix B: Editing Hardware Templates Extended Non-Volatile The Series 5000 chips use a serial memory interface for external non-volatile memo

xii Preface Region Languages Supported Contact Information Japan Japanese Echelon Japan Holland Hills Mori Tower, 18F 5-11.2 Toranomon, Minato-ku

Mini FX User's Guide 117 Setting the Hardware Template Description You can enter an optional description for a hardware template in the Descrip

118 Appendix B: Editing Hardware Templates

Mini FX User's Guide 119 Appendix C Mini FX Software License Agreement When installing the Mini FX software, you must agree to the terms of th

120 Appendix C: Software License Agreement NOTICE This is a legal agreement between you and Echelon Corporation (“Echelon”). YOU MUST READ AND AGRE

Mini FX User's Guide 121 “Mini FX Example Applications” means the Neuron C and C# source code example applications included as part of the Li

122 Appendix C: Software License Agreement This license is not a sale. Title, copyrights and all other rights to the Licensed Software and the Docu

Mini FX User's Guide 123 YOU RECEIVE NO OTHER WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE OR IN ANY COMMUNICATION WITH Y

124 Appendix C: Software License Agreement LANGUAGE The parties hereto confirm that it is their wish that this Agreement, as well as other documents

Mini FX User's Guide 125 pursuant to DFAR Section 227.7015(a). Any use, modification, reproduction, release, performance, display or disclosur

www.echelon.com

Mini FX User's Guide 1 1 Introduction This chapter introduces the Mini FX Evaluation Kit. It lists the new features in the Mini kit, and it s

2 Introduction Introduction to the Mini FX Evaluation Kit The Mini FX Evaluation Kit is a hardware and software platform for evaluating the LONWORKS

Mini FX User's Guide 3 • Backwards compatibility for device applications. Improved Memory Architecture The Series 5000 chips have a new memor

4 Introduction Figure 1.1 Series 5000 Chip Architecture Faster System Clock The Series 5000 chips support an internal system clock speed of up to

Mini FX User's Guide 5 routines and your device application. At lower system clock rates, these interrupts run in the same application process

6 Introduction The Neuron C Version 2.2 language includes new keywords such as interrupt, __lock, stretchedtriac, __slow, __fast, and __parity. So

Mini FX User's Guide 7 The PL 3150 EVB is a complete LONWORKS device that includes a PL 3150 Smart Transceiver operating at 10MHz external cloc

8 Introduction You can enable and disable specific warnings using the new #pragma enable_warning and #pragma disable_warning compiler directives, an

Mini FX User's Guide 9 LonScanner Protocol Analyzer CD (Demo Edition) 5 5 U10 or U20 USB Network Interface 5 5 The following sections describ

10 Introduction Development Platforms The Mini FX/FT Evaluation Kit includes two FT 5000 EVBs. The Mini FX/PL Evaluation Kit includes one PL 3150 E

Mini FX User's Guide 11 supplies included with the PL 3150 and 3170 EVBs pass the network signals directly into the AC power lines over the sam

12 Introduction also use it with other network interfaces including an IP-852 (ISO/IEC 14908-4) interface as described in the LonScanner Protocol An

Mini FX User's Guide 13 • Debugger. Debug your application with a source-level view of your application code as it executes. The debugger le

14 Introduction Feature Mini FX Evaluation Kit NodeBuilder FX Tool LonScanner Protocol Analyzer (Demo Edition) 5  LonScanner Protocol Analyzer (L

Mini FX User's Guide 15 The Data Point shape provides similar functionally as the LonMaker Browser, but directly in your LonMaker drawing. The

16 Introduction communications processor, or it may handle both application processing and communications processing on the host processor. The Mi

ii Echelon, LON, LONWORKS, Neuron, 3120, 3150, Digital Home, i.LON, LNS, LonMaker, LONMARK, LonPoint, LonTalk, NodeBuilder, ShortStack, and the Echel

Mini FX User's Guide 17 Applications Every LONWORKS device contains an application that defines the device’s behavior. The application defines

18 Introduction Field Description manufacturer ID, you can find your ID in the list of manufacturer IDs at www.lonmark.org/spid. The most current l

Mini FX User's Guide 19 an input network variable that was of the switch type, while an application on a dimmer-switch device could have an out

20 Introduction Connections may be thought of as virtual wires. For example, the dimmer-switch device in the dimmer-switch-light example could be r

Mini FX User's Guide 21 Figure 1.6 Functional Profile When a functional block is created from a functional profile, the application designer

22 Introduction Mini kit will upgrade this device template as necessary, but it will not delete or manage it. If you build the application with the

Mini FX User's Guide 23 2 Installing the Mini FX Evaluation Kit This chapter describes how to get started with your Mini kit, including how

24 Installing the Mini FX Evaluation Kit Installing the Mini FX Evaluation Kit To install your Mini FX Evaluation Kit, follow these steps: 1. Verif

Mini FX User's Guide 25 2. If the Mini FX setup application does not launch immediately, click Start on the Windows taskbar and then and click

26 Installing the Mini FX Evaluation Kit 4. Click Microsoft .NET Framework 3.5 SP1 to install Microsoft .NET Framework 3.5 SP1 and then follow the

Mini FX User's Guide iii Table of Contents Preface...

Mini FX User's Guide 27 Figure 2.4 Mini FX Evaluation Kit Installer—License Agreement 7. Read the license agreement (see Appendix C, Mini FX S

28 Installing the Mini FX Evaluation Kit Figure 2.6 Mini FX Evaluation Kit Installer—Setup Type 11. Select the type of installation to be performed

Mini FX User's Guide 29 they are installed, but have a lower version): ISI Developer’s Kit 3.02, OpenLDV 3.40, NodeBuilder Resource Editor 4.0

30 Installing the Mini FX Evaluation Kit Connecting the Mini FX/FT Hardware To connect the Mini FX/FT hardware, follow these steps: 1. Unpack the

Mini FX User's Guide 31 Figure 2.9 FT 5000 EVB Power Supply Connection 4. Connect the orange network connector on each FT 5000 EVB to the inc

32 Installing the Mini FX Evaluation Kit Figure 2.11 USB 10 Network Interface Connection If this is the only LONWORKS interface installed on your

Mini FX User's Guide 33 The NcMultiSensorExample application is pre-loaded on the FT 5000 EVBs and runs in Interoperable Self-Installation (ISI

34 Installing the Mini FX Evaluation Kit Figure 2.12 PL 3150/PL 3170 EVB Connections 5. After you plug in the power supplies, LED1 will begin fl

Mini FX User's Guide 35 protocol. To view this book, click Start, point to Programs, point to Echelon Mini, point to Smart Transceiver Data Bo

36 Installing the Mini FX Evaluation Kit Note: Echelon power line technology combined with ISI self-installation provides virtual plug and play comm

iv Preface Hardware Templates...21 Neuron C ...

Mini FX User's Guide 37 3 Mini FX Quick-Start Exercise This chapter demonstrates how to create a LONWORKS device using the Mini kit.

38 Mini FX Quick-Start Exercise Mini FX Quick-Start Exercise The following quick-start exercise demonstrates how to create a LONWORKS device with t

Mini FX User's Guide 39 Save. This creates a new empty Neuron C source file named main.nc in your chosen location, and it opens the file using

40 Mini FX Quick-Start Exercise 4. Add the following code that initializes the I/O devices and writes to the LCD when the FT 5000 EVB is reset: voi

Mini FX User's Guide 41 LcdDisplayString(3, 0, “LED1 = “); LcdDisplayString(2, 7, led ? “ON” : “OFF”); LcdDisplayStrin

42 Mini FX Quick-Start Exercise // strobe: io_out(ioLedLoad, 0); io_out(ioLedLoad, 1); } //Create global variable to store the previous

Mini FX User's Guide 43 application image files used for various memory parts, see Chapter 8 of the NodeBuilder FX User’s Guide. To compile and

44 Mini FX Quick-Start Exercise Note: The current list of manufacturer IDs, device classes, usage values, and channel types are defined in an XML fi

Mini FX User's Guide 45 Step 4: Downloading the Device Application You can use the Mini FX Application to download an application image over a

46 Mini FX Quick-Start Exercise Figure 3-2 demonstrates that the device application in this quick-start exercise has successfully been downloaded to

Mini FX User's Guide v I/O Examples Toolkit ...80 Creating Example Device Ap

Mini FX User's Guide 47 4 Using the Mini FX Application This chapter describes how to use the Mini FX Application to build a Neuron C device

48 Using the Mini FX Application Introduction to the Mini FX Application The Mini FX Application is an easy-to-use program consisting of two tabs: t

Mini FX User's Guide 49 Creating and Opening Neuron C Source Files You can use the Application tab in the Mini FX Application to create a new N

50 Using the Mini FX Application 5000 EVB example applications, see the FT 5000 EVB Examples Guide. For more information on the PL 3150/PL 3170 EVB

Mini FX User's Guide 51 libraries are supplied, varying in features provided and application memory required. For more information on the libr

52 Using the Mini FX Application identifies the device application. The program ID may be formatted as a standard or non-standard program ID. When

Mini FX User's Guide 53 • If you do not have a standard manufacturer ID, you can request a temporary manufacturer ID by filling out a simple f

54 Using the Mini FX Application device class, usage, and channel type. The same hardware may be used for multiple model numbers depending on the p

Mini FX User's Guide 55 10. Click OK to return to the Application tab in the Mini FX Application. The program ID you calculated appears in the

56 Using the Mini FX Application 2. In the Network Interface box, select the network interface attached to your development computer that is to be

vi Preface

Mini FX User's Guide 57 Note: The Mini FX Application is an OpenLDV application; therefore, it cannot share a network interface with other LON

58 Using the Mini FX Application Figure 4.4 Service Pin Message Dialog The Neuron ID is a unique 48-bit (12-hex digit) identifier contained in ever

Mini FX User's Guide 59 through the ISI protocol (all self-installed devices in the network are silently registered and added to the Device lis

60 Using the Mini FX Application Note: After you load one of the MgDemo, MgSwitch, MgKeyboard or MgLight application image files into a PL 3150/PL 3

Mini FX User's Guide 61 o When you wink a PL EVB when it is running an example application LED1–LED3 on the Mini Gizmo I/O Board turn on and L

62 Using the Mini FX Application

Mini FX User's Guide 63 5 Developing Device Applications This chapter provides an overview of the Neuron C Version 2.2 programming language.

64 Developing Device Applications Introduction to Neuron C Neuron C Version 2.2 is a programming language based on ANSI C that you can use to develo

Mini FX User's Guide 65 Neuron C also provides a way to organize the network variables and configuration properties in the device into function

66 Developing Device Applications Timers may be automatically reloading (repeating), or one-shot timers, with a duration ranging from 0.001–65,535 se

Mini FX User's Guide vii Preface The Mini FX Development Kit is a hardware and software platform for evaluating the LONWORKS® 2.0 platform and

Mini FX User's Guide 67 Neuron C Storage Classes If no class is specified for a declaration at file scope, the data or function is global. Fi

68 Developing Device Applications Variable Initialization Initialization of variables occurs at different times for different classes. The const va

Mini FX User's Guide 69 Declaration Example Configuration Properties SCPTdefOutput cp_family cpDefaultOut; Functional Blocks fblock SFPTnodeObj

70 Developing Device Applications Table 5.3 Required EVB Jumper Configurations Required Connections Required Disconnections Board Jumper Pin Jumper

Mini FX User's Guide 71 chapter, and the jumper configuration discusses earlier in this chapter, use an EIA- 232 connection. • You can conne

72 Developing Device Applications Document Title Description Part Number Scanning a Keypad with the Neuron Chip Describes how a Smart Transceiver

Mini FX User's Guide 73 IO_9 input bit ioSwitch1; void example() { if ((boolean)io_in(ioSwitch1)) { … } } The Neuron C langu

74 Developing Device Applications and a bit output model for the latch pulse. To read any of these buttons, all eight buttons must be read from the

Mini FX User's Guide 75 #ifdef USE_5000EVB IO_9 input bit ioSwitch1; // // when(io_changes…) executes whenever the button is pressed // whe

76 Developing Device Applications FT 5000 EVB The FT 5000 EVB includes two LEDs: LED1 and LED2. LED1 and LED2 are connected to pins I/O 2 and I/O 3,

viii Preface Purpose This document describes how to use the Mini FX Evaluation Kit to develop and build simple Neuron C device applications, downloa

Mini FX User's Guide 77 #ifdef USE_5000EVB IO_2 output bit ioLed1 = 1; IO_3 output bit ioLed2 = 1; #else #ifdef USE_MINIGIZMO IO_2 output bi

78 Developing Device Applications current.raw[0] = (unsigned)touch_byte(ioTemperatureSensor, 0xFFu); if (touch_reset(ioTemperatureSe

Mini FX User's Guide 79 LCD Display The LCD display included with the FT 5000 EVB may be used to display status or other application data in an

80 Developing Device Applications // Set the cursor position static const unsigned lcdRowAddress[4] = {0x00, 0x40, 0x14, 0x54}; SendLcdC

Mini FX User's Guide 81 // levels, i.e. TRUE for "on". // The driver function translates the logical levels as necessary. // #if

82 Developing Device Applications // when(timer_expires(buttonTimer)) { static boolean previousButton = TRUE; boolean currentButton; cur

Mini FX User's Guide 83 } else { current.value = 32767l; } } return current.value; } // // Driver to supp

84 Developing Device Applications { #ifndef USE_MINIGIZMO SendLcdCommand(LCD_COMMAND_ON, 0, 1); SendLcdCommand(LCD_COMMAND_BRIGHTNESS, 1, 2);

Mini FX User's Guide 85 • The example device applications presented in this section are not considered interoperable mainly because they do no

86 Developing Device Applications // zero after reset. network output SNVT_switch nvoSwitch; // // OnButtonPressed() is called whenever the button b