D e v e l o p e r ’ s G u i d e 2 n d E d i t i o n August 16, 2007 © 2005–2007 SmartLabs Technology Developer’s Guide Page i Contents at a Glance INTRODUCTION............................................................................................ 1 PART I — INSTEON BASICS .......................................................................... 4 Chapter 1 — Getting Started Quickly ......................................................... 5 Chapter 2 — About This Developer’s Guide ................................................ 8 Chapter 3 — INSTEON Overview.............................................................. 14 Chapter 4 — INSTEON Application Development Overview...................... 27 PART II — INSTEON REFERENCE ................................................................ 37 Chapter 5 — INSTEON Messages ............................................................. 38 Chapter 6 — INSTEON Signaling Details .................................................. 56 Chapter 7 — INSTEON Device Networking ............................................... 82 Chapter 8 — INSTEON Command Set ..................................................... 114 Chapter 9 — INSTEON BIOS (IBIOS) ..................................................... 166 Chapter 10 — INSTEON Modems............................................................ 217 Chapter 11 — SALad Language Documentation ..................................... 263 Chapter 12 — SmartLabs Device Manager (SDM) Reference .................. 336 Chapter 13 — INSTEON Hardware Documentation................................. 358 CONCLUSION............................................................................................ 378 GLOSSARY................................................................................................ 379 NOTES ...................................................................................................... 384 August 16, 2007 © 2005-2007 SmartLabs Technology Developer’s Guide Page ii Full Table of Contents INTRODUCTION............................................................................................ 1 PART I — INSTEON BASICS .......................................................................... 4 Chapter 1 — Getting Started Quickly ......................................................... 5 INSTEON Modem (IM) Quick Start............................................................... 6 PowerLinc Controller (PLC) Quick Start ........................................................ 7 Chapter 2 — About This Developer’s Guide ................................................ 8 Other Documents Included by Reference...................................................... 9 INSTEON Conformance Specification......................................................... 9 INSTEON Command Tables Document.................................................... 9 INSTEON Device Categories and Product Keys Document.......................... 9 INSTEON Modem Spec Sheets ................................................................10 IN2680A INSTEON Direct Powerline Modem Interface..............................10 IN2682A INSTEON Direct RF Modem Interface........................................10 Other INSTEON Documents of Interest .......................................................10 INSTEON, the Details ............................................................................10 INSTEON Compared ..............................................................................10 Document Conventions.............................................................................11 Getting Help ...........................................................................................11 Legal Information ....................................................................................12 Revision History ......................................................................................13 Chapter 3 — INSTEON Overview.............................................................. 14 Why INSTEON? .......................................................................................15 Hallmarks of INSTEON..............................................................................17 INSTEON Specifications ............................................................................18 INSTEON Fundamentals............................................................................20 INSTEON Device Communication.............................................................21 INSTEON Message Repeating..................................................................23 INSTEON Peer-to-Peer Networking ..........................................................25 INSTEON ALL-Linking ............................................................................26 Chapter 4 — INSTEON Application Development Overview...................... 27 Interfacing to an INSTEON Network ...........................................................28 The SmartLabs PowerLinc Controller........................................................28 The SmartLabs Powerline Modem ............................................................29 Comparing the Powerline Modem (PLM) to the PowerLinc Controller (PLC).....29 Manager Applications ...............................................................................31 INSTEON Modem Applications ...................................................................32 SALad Applications ..................................................................................33 SALad Overview ...................................................................................33 SALad Integrated Development Environment ............................................33 INSTEON SALad and PowerLinc Controller Architecture...............................35 INSTEON Developer’s Kits.........................................................................36 Software Developer’s Kit........................................................................36 Hardware Development Modules .............................................................36 PART II — INSTEON REFERENCE ................................................................ 37 Chapter 5 — INSTEON Messages ............................................................. 38 INSTEON Message Structure .....................................................................39 August 16, 2007 © 2005-2007 SmartLabs Technology Developer’s Guide Page iii Message Lengths ..................................................................................39 Standard-length Message ....................................................................39 Extended-length Message....................................................................40 Message Fields .....................................................................................41 Device Addresses ...............................................................................41 Message Flags ...................................................................................41 Message Type Flags .........................................................................42 Extended Message Flag ....................................................................43 Message Retransmission Flags...........................................................43 Command 1 and 2..............................................................................44 User Data .........................................................................................44 Message Integrity Byte .......................................................................44 INSTEON Message Summary Table ............................................................46 SD and ED Messages.............................................................................46 SD ACK and SD NAK Messages ...............................................................47 SB Messages........................................................................................47 SA ALL-Link Broadcast Messages.............................................................48 SC ALL-Link Cleanup Messages ...............................................................48 SC ACK and SC NAK Messages................................................................48 INSTEON Message Repetition ....................................................................49 INSTEON Message Hopping ....................................................................49 Message Hopping Control ....................................................................49 Timeslot Synchronization ....................................................................49 INSTEON Message Retrying....................................................................54 i2 Engine Message Retrying .................................................................54 Chapter 6 — INSTEON Signaling Details .................................................. 56 INSTEON Powerline Signaling ....................................................................57 Powerline BPSK Modulation ....................................................................58 INSTEON Powerline Packets ...................................................................59 Powerline Packet Timing ........................................................................60 X10 Compatibility .................................................................................61 Powerline Message Timeslots..................................................................62 Standard-length Message Timeslots