KONNEKTING Protocol Specification 0x01

Message Types for Protocol-Version 0x01

--- DRAFT --- This is the second protocol version. --- DRAFT ---

ETS MemoryWrite:

• 1 byte: Count
• 2 byte: address
• n byte: memory data

0x00 Acknowledge

• Message Name: Acknowledge
• MsgID: 0 dec / 0x00 hex
• Description: Acknowledge a previous received WRITE message
• Requires Programming Mode: n/a

Byte no#	Description
2	Acknowledge type: 0x00: ACK 0xFF: NACK
3	Error-Code (only NACK): 0x00: no error / no error code available 0x01: ??? 0xFE: ??? 0xFF: ???
4..13	0x00, unused

0x01 ReadDeviceInfo

• Message Name: ReadDeviceInfo
• MsgID: 1 dec / 0x01 hex
• Description: Initiates reading general device information
• Requires Programming Mode: no

Byte no#	Description
2	IndividualAddress HI
3	IndividualAddress LO
4..13	0x00, unused

0x02 AnswerDeviceInfo

• Message Name: AnswerDeviceInfo
• MsgID: 2 dec / 0x02 hex
• Description: Answers a ReadDeviceInfo message
• Requires Programming Mode: n/a

Byte no#	Description
2	Manufacturer-ID HI
3	Manufacturer-ID LO
4	Device-ID
5	RevisionID
6	Device Flags Flag masks: 0x80: Factory-Flag: 1 = factory sttings, 0 = stored settings
7	IndividualAddress HI
8	IndividualAddress LO
9..13	0x00, unused

0x09 Restart

• Message Name: Restart
• MsgID: 9 dec / 0x09 hex
• Description: Restart device (device reboot, no memory reset)
• Requires Programming Mode: no

Byte no#	Description
2	IndividualAddress HI
3	IndividualAddress LO
4..13	0x00, unused

0x0A WriteProgrammingMode

• Message Name: WriteProgrammingMode
• MsgID: 10 dec / 0x0A hex
• Description: Sets/Unsets Programming-Mode for device with given individual address. Device will respond with a "Acknowledge" message.
• Requires Programming Mode: no

Byte no#	Description
2	IndividualAddress HI
3	IndividualAddress LO
4	Mode: 0x00 = OFF 0x01 = ON
5..13	0x00, unused

0x0B ReadProgrammingMode

• Message Name: ReadProgrammingMode
• MsgID: 11 dec / 0x10 hex
• Description: Reads current programming mode of all listening devices. If more than one device is in programming-mode, you will get more then one AnswerProgrammingMode messages.
• Requires Programming Mode: no

Byte no#	Description
2..13	0x00, unused

0x0C AnswerProgrammingMode

• Message Name: AnswerProgrammingMode
• MsgID: 12 dec / 0x11 hex
• Description: Answers a ReadDeviceInfo message with the device's individual address.
• Requires Programming Mode: n/a

Byte no#	Description
2	IndividualAddress HI
3	IndividualAddress LO
4..13	0x00, unused

0x14 WriteIndividualAddress

• Message Name: WriteProgrammingMode
• MsgID: 20 dec / 0x14 hex
• Description: Writes the individual address the device should use. Device will respond with a "Acknowledge" message.
• Requires Programming Mode: yes

Byte no#	Description
2	IndividualAddress HI
3	IndividualAddress LO
4..13	0x00, unused

0x15 ReadIndividualAddress

• Message Name: ReadIndividualAddress
• MsgID: 21 dec / 0x15 hex
• Description: Each device in programming mode will respond with its individual address
• Requires Programming Mode: yes

Byte no#	Description
2..13	0x00, unused

0x16 AnswerIndividualAddress

• Message Name: AnswerIndividualAddress
• MsgID: 22 dec / 0x16 hex
• Description: Answers a ReadIndividualAddress message with the device's individual address.
• Requires Programming Mode: n/a

Byte no#	Description
2	IndividualAddress HI
3	IndividualAddress LO
4..13	0x00, unused

0x?? MemoryWrite

• Message Name: MemoryWrite
• MsgID: ?? dec / 0x?? hex
• Description:
• Requires Programming Mode: yes

Byte no#	Description
2
3..13

0x?? MemoryRead

• Message Name: MemoryRead
• MsgID: ?? dec / 0x?? hex
• Description:
• Requires Programming Mode: yes

Byte no#	Description
2
3..13

0x?? MemoryResponse

• Message Name: MemoryResponse
• MsgID: ?? dec / 0x?? hex
• Description:
• Requires Programming Mode: yes

Byte no#	Description
2
3..13