INSTEON Hub Developer's Guide

INSTEON Hub: Developer’s Guide
Page 41 © 2013 INSTEON
0x80
Delete First Found
Delete an ALL-Link Record.
Starting at the top of the ALDB, search for the first ALL-Link Record matching
the <ALL-Link Group> and <ID> in bytes 5 – 8. The search ignores byte 4,
<ALL-Link Record Flags>.
You will receive an ACK at the end of the returned message if such an ALL-
Link Record existed and was deleted, or else a NAK no such record exists.
4 <ALL-Link Record Flags> ALL-Link Database control flags for this ALL-Link Record
Bit 7 1 = Record is in use
0 = Record is available
Note: This bit is only settable for ALDB-L (linear) databases using <Control
Code> 0x20. It is handled automatically by ALDB-T (threaded) databases.
Bit 6 1 = IM is a Controller (master) of the device with <ID>
given in bytes 6 – 8 below,
0 = IM is a Responder (slave) to the device with <ID>
given in bytes 6 – 8 below
Bit 5 Product dependent
Bit 4 Product dependent
Bit 3 Reserved (set to 0)
Bit 2 Reserved (set to 0)
Bit 1 1 = Record has been used before
0 = ‘High-water Mark’
Note: This bit is only settable for ALDB-L (linear) databases using <Control
Code> 0x20. It is handled automatically by ALDB-T (threaded) databases.
Bit 0 Reserved (set to 0)
5 <ALL-Link Group> ALL-Link Group Number for this ALL-Link Record
6 <ID high byte> INSTEON ID high byte for device ALL-Linked to
7 <ID middle byte> INSTEON ID middle byte for device ALL-Linked to
8 <ID low byte> INSTEON ID low byte for device ALL-Linked to
9 <Link Data 1> Link Information: varies by device ALL-Linked to
10 <Link Data 2> Link Information: varies by device ALL-Linked to
11 <Link Data 3> Link Information: varies by device ALL-Linked to
Message Returned by IM to Host
Byte Value Meaning
1 0x02 Echoed Start of IM Command
2
0x6F
Echoed IM Command Number
3 <Control Code> Echoed <Control Code>
4 <ALL-Link Record Flags> Echoed <ALL-Link Record Flags>
5 <ALL-Link Group> Echoed <ALL-Link group>
6 <ID high byte> Echoed <ID high byte>
7 <ID middle byte> Echoed <ID middle byte>
8 <ID low byte> Echoed <ID low byte>
9 <Link Data 1> Echoed <Link Data 1>
10 <Link Data 2> Echoed <Link Data 2>
11 <Link Data 3> Echoed <Link Data 3>
12 <ACK/NAK> 0x06 (ACK) if the IM executed the Command correctly.
0x15 (NAK) if an error occurred or the ALL-Link Record doesn’t exist.
Notes
See the section INSTEON All-Link Database in the INSTEON Developer’s Guide
2
for details about the
contents of an ALL-Link Record.
Note that except for Find Next, all ALDB searches begin at the top of the ALDB, which means that the
IM will always perform modify or delete operations on the first matching record that it finds in its ALDB.
You must therefore use caution when deleting records because an ALDB may contain multiple
Controller and Responder records matching a given <ALL-Link Group> and <ID>. If you want to delete

INSTEON Hub Specifications

General

Product Name	INSTEON Hub
Model Number	2245-222
Connectivity	Ethernet
Communication Protocol	INSTEON
Operating Temperature	0°C to 40°C (32°F to 104°F)
Operating Humidity	85% non-condensing