Echelon Mini FX-PL User Manual

Mini FX/PL Examples Guide

®

0 7 8 - 0 3 9 4 - 0 1 A

Echelon, LON, LONWORKS, Neuron, 3120, 3150, Digital Home,
i.LON, LNS, LonMaker, L
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.

ONMARK, LonPoint, LonTalk,

Neuron

Chips and other OEM Products were not designed for

use in equipment or systems which involve danger to human
health or safety or a risk of property damage and Echelon
assumes no responsibility or liability for use of the Neuron
Chips or LonPoint Modules in such applications.

Parts manufactured by vendors other than Echelon and
referenced in this document have been described for
illustrative purposes only, and may not have been tested by
Echelon. It is the responsibility of the customer to determine
the suitability of these parts for each application.

ECHELON MAKES NO REPRESENTATION, WARRANTY, OR
CONDITION OF ANY KIND, EXPRESS, IMPLIED, STATUTORY, OR
OTHERWISE OR IN ANY COMMUNICATION WITH YOU,
INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF
MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR ANY
PARTICULAR PURPOSE, NONINFRINGEMENT, AND THEIR
EQUIVALENTS.

No part of this publication may be reproduced, stored in a
retrieval system, or transmitted, in any form or by any means,
electronic, mechanical, photocopying, recording, or
otherwise, without the prior written permission of Echelon
Corporation.

Printed in the United States of America.
Copyright ©1997–2009 by Echelon
Corporation.
Echelon Corporation
www.echelon.com

ii Preface

Table of Contents

Welcome......................................................................................................... iv

Purpose ..........................................................................................................iv

Audience ........................................................................................................iv

Hardware Requirements ..............................................................................iv

Content ...........................................................................................................v

Related Manuals ............................................................................................v

For More Information and Technical Support ............................................vi

Using the Mini FX/PL Example Applications............................................. 1

Introduction to the Mini FX/PL Examples ................................................... 2

Loading the Mini FX/PL Example Applications .......................................... 6

Using the Mini FX/PL Example Applications .............................................. 9

MgSwitch and MgLight Example Applications................................... 10

MgDemo Example Application ............................................................. 11

MgKeyboard Example Application....................................................... 13

Getting Started with Device Development.................................................14

Mini FX/PL Hardware Guide iii

Welcome

The Mini FX/PL Evaluation Kit is a complete hardware and software platform for
evaluating the L

®

3150

and PL 3170 Smart Transceivers. The Mini kit lets you build Neuron® C

applications and download them to L

You can use the Mini kit to develop prototype or production devices, particularly in the
rapidly growing, price-sensitive mass markets of smart light switches, thermostats, and
other simple devices and sensors.

ONWORKS

®

2.0 platform and developing LONWORKS devices based on PL

ONWORKS devices, and test LONWORKS devices.

Purpose

This document describes the Neuron C example applications included with the Mini
FX/PL Evaluation Kit that you can run on your PL 3150/PL 3170 EVBs. You can use
these examples to test the I/O devices on the Mini Gizmo I/O Boards that you can attach
to your PL 3150/PL 3170 EVBs, and create simple managed and self-installed

ONWORKS networks. You can browse the Neuron C code used by these examples to

L
learn how to develop your own device applications.

Audience

This guide is intended for device and system designers with an understanding of control
networks.

Hardware Requirements

Requirements for computers running the Mini FX/PL Evaluation Kit are listed below:

• Microsoft

you install the latest service pack available from Microsoft for your version of
Windows.

• Intel® Pentium

requirements for the selected version of Windows.

o 120 to 350 megabytes (MB) free hard-disk space, plus the minimum Windows

o The Mini FX Application requires 90 MB of free space.
o Microsoft .NET Framework 3.5 SP1, which is required to run the Mini kit,

o The LonScanner

o If you install Adobe

• 512 MB RAM minimum.

• Note: Windows Vista testing for the Mini FX Application has been performed on

computers that have a minimum of 2 GB of RAM. For complete Windows Vista
requirements, refer to

®

Windows Vista® or Microsoft Windows® XP. Echelon recommends that

®

III 600MHz processor or faster, and meeting the minimum Windows

requirements for the selected version of Windows.

requires 30 MB of free space.

™

Protocol Analyzer (Demo Edition), which is included with the

Mini kit software, requires 26 MB of free space.

®

Reader 9.1 from the Mini FX Evaluation Kit CD, you need
an additional 204 MB of free space. You need Adobe Reader or another PDF
viewer to view the Mini FX/PL Evaluation Kit documentation.

iv Preface

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. If an LNS network interface is used, it

may be a local or remote interface.

o Compatible local network interfaces include the U20 USB network interface

(included with the Mini FX/PL Evaluation Kit); PCC-10, PCLTA-20, or
PCLTA-21 network interfaces; and the SLTA-10 Serial LonTalk Adapter.

o Compatible remote network interfaces include the i.LON

100 e3 Internet Server, i.LON 600 L

ONWORKS-IP Server, or i.LON 10 Ethernet

Adapter.

o Compatible IP-852 routers include the i.LON SmartServer with IP-852 routing,

i.LON 100 e3 Internet Server with IP-852 routing, or an i.LON 600

ONWORKS-IP Server. If you are using an IP-852 router, your computer must

L
have an IP network interface such as an Ethernet card or modem with PPP
software. In addition, the i.LON software must be installed on your computer,
and the IP-852 channel must be configured using the L
Configuration Server application software.

®

SmartServer, i.LON

ONWORKS-IP

Content

This guide includes the following content:

•

Connecting the Mini FX/PL Hardware. Describes how to power your PL 3150 and
PL 3170 EVBs and connect them to a L

ONWORKS PL-20 channel and to your

development computer.

Mini FX/PL Hardware Details. Describes the service pin and reset buttons and

•

LEDs, jumper settings, stand-alone power line coupler connector, and I/O connector
on the PL 3150/PL 3170 EVBs. Describes the I/O devices on the Mini Gizmo I/O
Board.

Related Manuals

The documentation related to the Mini kit is provided as Adobe PDF files and online help
files. The PDF files are installed in the Echelon Mini program folder when you install
the Mini kit. You can download the latest Mini FX documentation, including the latest
version of this guide, from Echelon’s Web site at

The following manuals provide supplemental information to the material in this guide.
You can download these documents from Echelon’s Web site at

®

Introduction to the L
Platform

ONWORKS

Provides a high-level introduction to L
networks and the tools and components that are used
for developing, installing, operating, and maintaining
them.

www.echelon.com/docs.

www.echelon.com.

ONWORKS

Mini FX/PL Hardware Guide v

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.

LonMaker

®

User’s Guide

Describes how to use the LonMaker Integration Tool to
design, commission, modify, and maintain L

ONWORKS

networks.

ONWORKS

L

®

USB Network

Interface User’s Guide

Describes how to install and use the U20 USB Network
Interface, which is included with the Mini FX/PL
Evaluation Kit.

Mini FX/PL Hardware Guide Describes the hardware included with the Mini FX/PL

Evaluation Kit, including assembly instructions and
other information you will need when using the Mini
FX/PL Evaluation Kit.

Mini FX User’s Guide Describes how to use the Mini FX Evaluation Kit to

develop and build simple Neuron C device applications,

ONWORKS devices,

Neuron

®

C Programmer’s Guide

download the device applications to L
and test the L

ONWORKS devices

Describes how to write programs using the Neuron
Version 2.2 language.

Neuron

®

C Reference Guide

Provides reference information for writing programs
using the Neuron C Version 2.2 language.

®

PL 3120

/ PL 3150® / PL 3170

Smart Transceiver Data Book

™

Provides detailed technical specifications on the
electrical interfaces, mechanical interfaces, and
operating environment characteristics for the PL 3120,
PL 3150, and PL 3170 Power Line Smart Transceivers.

For More Information and Technical Support

The Mini FX ReadMe document provides descriptions of known problems, if any, and
their workarounds. To view the Mini FX ReadMe, click Start, point to Programs,
point to Echelon Mini, and then select Mini FX ReadMe First. You can also find
additional information about the Mini kit at the Mini FX Web page at

www.echelon.com/mini.

®

C

If you have technical questions that are not answered by this document, the Mini FX
online help, or the Mini FX ReadMe file, you can contact technical support. Free e-mail
support is available or you can purchase phone support from Echelon or an Echelon

vi Preface

support partner. See
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

You can obtain technical support via phone, fax, or e-mail from your closest Echelon
support center. The contact information is as follows (check
for updates to this information):

Region Languages Supported Contact Information

The Americas

Europe

www.echelon.com/support for more information on Echelon

www.echelon.com/training.

www.echelon.com/support

English
Japanese

English
German
French
Italian

Echelon Corporation
Attn. Customer Support
550 Meridian Avenue
San Jose, CA 95126
Phone (toll-free):

1.800-258-4LON (258-4566)
Phone: [phone]
Fax: [phone]

[e-mail]

Echelon Europe Ltd.
Suite 12
Building 6
Croxley Green Business
Park
Hatters Lane
Watford
Hertfordshire WD18 8YH
United Kingdom
Phone: [phone]
Fax: [phone]

[e-mail]

Japan

Mini FX/PL Hardware Guide vii

Japanese

Echelon Japan
Holland Hills Mori Tower,
18F
5-11.2 Toranomon,
Minato-ku
Tokyo 105-0001
Japan
Phone: [phone]
Fax: [phone]

[e-mail]