Mini FX/PL Examples Guide ® 078-0394-01A
Echelon, LON, LONWORKS, Neuron, 3120, 3150, Digital Home, i.LON, LNS, LonMaker, LONMARK, LonPoint, LonTalk, NodeBuilder, ShortStack, and the Echelon logo are trademarks of Echelon Corporation registered in the United States and other countries. FTXL, LonScanner, LonSupport, OpenLDV, and LNS Powered by Echelon are trademarks of Echelon Corporation. Other brand and product names are trademarks or registered trademarks of their respective holders.
Table of Contents Welcome ......................................................................................................... iv Purpose .......................................................................................................... iv Audience ........................................................................................................ iv Hardware Requirements .............................................................................. iv Content ..............................
Welcome The Mini FX/PL Evaluation Kit is a complete hardware and software platform for evaluating the LONWORKS® 2.0 platform and developing LONWORKS devices based on PL 3150® and PL 3170 Smart Transceivers. The Mini kit lets you build Neuron® C applications and download them to LONWORKS devices, and test LONWORKS devices.
www.microsoft.com/windows/windows-vista/get/system-requirements.aspx. You can use Microsoft’s Vista Upgrade Advisor to determine upgrade requirements for a particular computer. To download this tool, go to the Microsoft Web site at www.microsoft.com/windows/windows-vista/get/upgrade-advisor.aspx. • CD-ROM drive. • 1024x768 or higher-resolution display with at least 256 colors. • Mouse or compatible pointing device. • LNS® network interface or IP-852 router.
I/O Model Reference for Smart Transceivers and Neuron Chips Describes the many different I/O models that are available for use with the Neuron Chips and Smart Transceivers. ISI Programmer’s Guide Describes the ISI protocol, which provides for easy development of devices that do not require installation tools. ISI Protocol Specification Describes the typical ISI network architecture, the procedures that take place in an ISI installed network, and the messages that are defined by the ISI protocol.
support partner. See www.echelon.com/support for more information on Echelon support and training services. You can also view free online training or enroll in training classes at Echelon or an Echelon training center to learn more about developing devices. You can find additional information about device development training at www.echelon.com/training. You can obtain technical support via phone, fax, or e-mail from your closest Echelon support center. The contact information is as follows (check www.
Region viii Languages Supported Contact Information China Chinese English Echelon Greater China Rm. 1007-1008, IBM Tower Pacific Century Place 2A Gong Ti Bei Lu Chaoyang District Beijing 100027, China Phone: +86-10-6539-3750 Fax: +86-10-6539-3754 lonsupport@echelon.com.cn Other Regions English Japanese Phone: +1.408-938-5200 Fax: +1.408-328-3801 lonsupport@echelon.
1 Using the Mini FX/PL Example Applications This chapter introduces the four Neuron C example applications included with the Mini FX/PL Evaluation Kit. It describes how to load these example applications on a PL 3150/PL 3170 EVB using the Mini FX Application. It describes how to bind the example applications in a self-installed or managed network. It explains how to browse the Neuron C code used by these examples so that you can begin developing your own device applications.
Introduction to the Mini FX/PL Examples The Mini FX/PL Evaluation Kit includes the following four Neuron C example applications that you can load into your evaluation boards and use to create simple LONWORKS networks: MgDemo, MgSwitch, MgLight, and MgKeyboard. The PL 3150 EVB comes pre-loaded with the MgDemo example application; the PL 3170 EVB comes pre-loaded with the MgSwitch example application.
Example Application Description MgLight Summary Demonstrates how you can use light devices in a LONWORKS network. You can connect a PL 3150 EVB or PL 3170 EVB running the MgLight application to the following applications: 1. The MgSwitch application running on a PL 3150 EVB or PL 3170 EVB. 2. The MgDemo application running on a PL 3150 EVB.
Example Application Description MgKeyboard Summary Demonstrates how to use automatic network variable connections with the ISI protocol. You can connect a PL 3150 or PL 3170 running the MgKeyboard application to the following applications: 1. The MgDemo application running on a PL 3150 EVB.
Figure 1.1 Mini FX/PL Example Application Image File Location The Neuron C source files (.nc extension) for the Mini FX/PL examples are stored in separate folders within the LONWORKS\NeuronC\Examples\Mini EVB directory (for example, the MgDemo Neuron C application is stored in the LONWORKS\NeuronC\Examples\Mini EVB\MgDemo folder). Note that the default LONWORKS folder on your computer is typically C:\LONWORKS or C:\Program Files\LONWORKS.
1. Download the Mini FX/PL example applications with the Mini kit. 2. Use the Mini FX/PL example applications. Loading the Mini FX/PL Example Applications You can use the Mini FX Application to download the example applications to the PL 3150/PL 3170 EVBs. To do this, follow these steps: 1. Install the Mini FX software following Chapter 2 of the Mini FX User’s Guide. 2. Connect your PL 3150/PL 3170 EVB boards following Chapter 1 of the Mini FX/PL Hardware Guide.
Figure 1.3 Mini FX Application—Device Tab 5. In the Network Interface property, select a network interface to be used for communication between the Mini FX Application and the PL 3150/PL 3170 EVB over the LONWORKS channel, and then click Connect. You can use the U20 USB Network Interface included with the PL 3150/PL 3170 EVB, or you can use another network interface such as a i.LON 10 Ethernet Adaptor, i.LON 100 e3 plus Internet Server, or i.LON SmartServer.
Figure 1.4 Mini FX Application—Service Pin Message Dialog The Neuron ID is a unique 48-bit (12-hex digit) identifier contained in every LONWORKS device. The Mini kit uses the Neuron ID to communicate with your selected device. For more information on Neuron IDs, see the Introduction to the LONWORKS System document in the Echelon Mini FX program folder. The Program ID is a unique, 16-hex digit ID that uniquely identifies the device application. 8.
Figure 1.5 Mini FX Application—Application Image Selected 11. Click Load to load the selected Neuron application image into the PL 3150/PL 3170 EVB. The Status box informs you when the application image has been successfully loaded into the device, and also informs you of any load errors. Figure 1.
network variable updates between the evaluation boards. These steps are summarized below. Further details are provided in the sections following this summary: 1. Start the Mini FX Application, and then load the example applications (MgDemo, MgSwitch, MgLight, or MgKeyboard) you want to use into the evaluation boards, as described in the previous section, Loading the Mini FX/PL Example Applications. 2.
Connect button, and the LED next to the SW8 button is the Connect light. The Connect light will start blinking to indicate that the connection has been initiated. The Connect lights on the other devices that can join the connection will also start blinking. NOTE: You can press and hold the Connect button for 8 seconds to cancel the connection. 3. Choose a device you want to add to the connection, and push the device’s Connect button to add the device to the connection.
• Four switch/light pairs implement a switch that is hard-wired to a local light, where each pair may be connected to remote switches, remote lights, or remote switch/light pairs, on other devices. The four pairs consist of one switch and one light each. Each switch is implemented with a SFPTclosedLoopSensor functional block, and each light is implemented with a SFPTclosedLoopActuator functional block.
Table 1.2 MgDemo Application Connect Button I/O Push Button I/O LED SW5 SW1 LED1 SW6 SW2 LED2 SW7 SW3 LED3 SW8 SW4 LED4 6. You can create ISI connections to other evaluation boards running the MgDemo, MgSwitch, or MgLight applications. When you press the I/O button on one of the evaluation boards running the MgDemo application, the I/O LEDs on all other connected evaluation boards running the MgDemo application will activate. When you press the I/O button again, the I/O LEDs will de-activate.
connection process. The MgDemo application will automatically join this connection. No manual intervention is needed in this case. The Tauto protocol timer is provided to avoid race conditions when a network segment, or the entire site, is powered up. The timer is only relevant the first time the device powers up with a new application, or when it is connected to a new network. Once the connection has been created, it will be immediately operational following a power-cycle or reset.
www.echelon.