D e v e l o p e r ’ s G u i d e October 14, 2005 © 2005 Smarthome Technology Developer’s Guide Page i Contents at a Glance INTRODUCTION............................................................................................ 1 INSTEON BASICS ......................................................................................... 3 Getting Started Quickly ............................................................................. 4 About This Developer’s Guide.................................................................... 5 INSTEON Overview.................................................................................. 11 INSTEON Application Development Overview.......................................... 23 INSTEON REFERENCE ................................................................................. 30 INSTEON Messages ................................................................................. 31 INSTEON Signaling Details ...................................................................... 46 INSTEON Network Usage......................................................................... 59 INSTEON BIOS (IBIOS) ........................................................................... 90 SALad Language Documentation ........................................................... 132 Smarthome Device Manager Reference ................................................. 209 INSTEON Hardware Development Documentation................................. 229 CONCLUSION............................................................................................ 237 NOTES ...................................................................................................... 238 October 14, 2005 © 2005 Smarthome Technology Developer’s Guide Page ii Full Table of Contents INTRODUCTION............................................................................................ 1 INSTEON BASICS ......................................................................................... 3 Getting Started Quickly ............................................................................. 4 About This Developer’s Guide.................................................................... 5 About the Documentation .......................................................................... 6 Getting Help ............................................................................................ 7 Legal Information ..................................................................................... 8 Revision History ....................................................................................... 9 INSTEON Overview.................................................................................. 11 Why INSTEON? .......................................................................................12 Hallmarks of INSTEON..............................................................................14 INSTEON Specifications ............................................................................15 INSTEON Fundamentals............................................................................17 INSTEON Device Communication.............................................................18 INSTEON Message Repeating..................................................................20 INSTEON Peer-to-Peer Networking ..........................................................22 INSTEON Application Development Overview.......................................... 23 Interfacing to an INSTEON Network ...........................................................24 The Smarthome PowerLinc Controller ......................................................24 Manager Applications ...............................................................................25 SALad Applications ..................................................................................26 SALad Overview ...................................................................................26 SALad Integrated Development Environment ............................................26 INSTEON SALad and PowerLinc Controller Architecture...............................28 INSTEON Developer’s Kits.........................................................................29 Software Developer’s Kit........................................................................29 Hardware Development Modules .............................................................29 INSTEON REFERENCE ................................................................................. 30 INSTEON Messages ................................................................................. 31 INSTEON Message Structure .....................................................................32 Message Lengths ..................................................................................32 Standard Message..............................................................................32 Extended Message .............................................................................33 Message Fields .....................................................................................34 Device Addresses ...............................................................................34 Message Flags ...................................................................................34 Message Type Flags .........................................................................35 Extended Message Flag ....................................................................36 Message Retransmission Flags...........................................................36 Command 1 and 2..............................................................................37 User Data .........................................................................................37 Message Integrity Byte .......................................................................37 INSTEON Message Summary Table ............................................................38 INSTEON Message Repetition ....................................................................40 INSTEON Message Hopping ....................................................................40 Message Hopping Control ....................................................................40 October 14, 2005 © 2005 Smarthome Technology Developer’s Guide Page iii Timeslot Synchronization ....................................................................40 INSTEON Message Retrying....................................................................45 INSTEON Signaling Details ...................................................................... 46 INSTEON Packet Structure ........................................................................47 Powerline Packets .................................................................................47 RF Packets...........................................................................................48 INSTEON Signaling ..................................................................................49 Powerline Signaling ...............................................................................49 BPSK Modulation................................................................................50 Packet Timing....................................................................................51 X10 Compatibility...............................................................................51 Message Timeslots .............................................................................52 Standard Message Timeslots .............................................................53 Extended Message Timeslots.............................................................53 INSTEON Powerline Data Rates ............................................................54 RF Signaling.........................................................................................55 Simulcasting ...........................................................................................57 Powerline Simulcasting ..........................................................................57 RF Simulcasting....................................................................................58 RF/Powerline Synchronization .................................................................58 INSTEON Network Usage......................................................................... 59 INSTEON Commands ...............................................................................60 INSTEON Command 1 and 2...................................................................61 INSTEON Command Tables ....................................................................62 INSTEON Common Commands.............................................................63 NAK Reason Codes ..........................................................................68 INSTEON Broadcast Commands ...........................................................69 INSTEON Command Examples ................................................................71 INSTEON Device Classes...........................................................................75 Device Identification Broadcast ...............................................................75 Device Type ......................................................................................75 Device Attributes ...............................................................................75 Firmware Revision..............................................................................76