KONNEKTING Protocol Specification 0x01

From KONNEKTING Wiki
Revision as of 19:31, 5 March 2018 by Konnekting (talk | contribs)
Jump to navigation Jump to search

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