Difference between revisions of "KONNEKTING Protocol Specification 0x01"

From KONNEKTING Wiki
Jump to navigation Jump to search
(Created page with "= Message Types for Protocol-Version 0x01 = --- DRAFT --- This is the second protocol version. --- DRAFT --- ETS MemoryWrite: * 1 byte: Count * 2 byte: address * n byte:...")
 
Line 259: Line 259:
  
  
−
== 0x1E WriteMemory ==
+
== 0x?? MemoryWrite ==
  
−
* '''Message Name:''' WriteMemory
+
* '''Message Name:''' MemoryWrite
−
* '''MsgID:''' 30 dec / 0x1E hex   
+
* '''MsgID:''' ?? dec / 0x?? hex   
−
* '''Description:''' Writes data to memory. Device will respond with a "Acknowledge" message.   
+
* '''Description:'''  
 
* '''Requires Programming Mode:''' yes
 
* '''Requires Programming Mode:''' yes
  
Line 271: Line 271:
 
|-
 
|-
 
|2
 
|2
−
|Parameter ID
+
|
 
|-
 
|-
 
|3..13
 
|3..13
−
|parameter value, up to 11 bytes. Data depends on parameter type
+
|
 
|}
 
|}
  
  
  
−
== 0x1F ReadParameter ==
+
== 0x?? MemoryRead ==
  
−
* '''Message Name:''' ReadParameter  
+
* '''Message Name:''' MemoryRead  
−
* '''MsgID:''' 31 dec / 0x1F hex   
+
* '''MsgID:''' ?? dec / 0x?? hex   
−
* '''Description:''' Reads a value for a specific parameter 
+
* '''Description:'''  
 
* '''Requires Programming Mode:''' yes
 
* '''Requires Programming Mode:''' yes
  
Line 291: Line 291:
 
|-
 
|-
 
|2
 
|2
−
|Parameter ID
+
|
 
|-
 
|-
 
|3..13
 
|3..13
−
|0x00, unused
+
|
 
|}
 
|}
  
  
  
−
== 0x20 AnswerParameter ==
+
== 0x?? MemoryResponse ==
  
−
* '''Message Name:''' AnswerParameter  
+
* '''Message Name:''' MemoryResponse  
−
* '''MsgID:''' 32 dec / 0x20 hex   
+
* '''MsgID:''' ?? dec / 0x?? hex   
−
* '''Description:''' Answers a ReadDeviceInfo message with the device's individual address. 
+
* '''Description:'''  
−
* '''Requires Programming Mode:''' n/a
 
−
 
 
−
{| class="wikitable"
 
−
!style="text-align:center"|Byte no#
 
−
!style="text-align:center"|Description
 
−
|-
 
−
|2
 
−
|Parameter ID
 
−
|-
 
−
|3..13
 
−
|parameter value, up to 11 bytes. Data depends on parameter type
 
−
|}
 
−
 
 
−
 
 
−
 
 
−
== 0x28 WriteCommObject ==
 
−
 
 
−
* '''Message Name:''' WriteCommObject 
 
−
* '''MsgID:''' 40 dec / 0x28 hex 
 
−
* '''Description:''' Writes a GA for a specific CommObjects. Device will respond with a "Acknowledge" message. 
 
 
* '''Requires Programming Mode:''' yes
 
* '''Requires Programming Mode:''' yes
  
Line 331: Line 311:
 
|-
 
|-
 
|2
 
|2
−
|CommObject ID
+
|
−
|-
 
−
|3
 
−
|GA HI
 
−
|-
 
−
|4
 
−
|GA LO
 
−
|-
 
−
|5
 
−
|Settings
 
−
|-
 
−
|6..13
 
−
|parameter value, up to 11 bytes. Data depends on parameter type
 
−
|}
 
−
 
 
−
 
 
−
 
 
−
== 0x29 ReadCommObject ==
 
−
 
 
−
* '''Message Name:''' ReadCommObject 
 
−
* '''MsgID:''' 41 dec / 0x29 hex 
 
−
* '''Description:''' Reads up to 3 GAs for a specific CommObjects. 
 
−
* '''Requires Programming Mode:''' no
 
−
 
 
−
{| class="wikitable"
 
−
!style="text-align:center"|Byte no#
 
−
!style="text-align:center"|Description
 
−
|-
 
−
|2
 
−
|CommObject ID
 
 
|-
 
|-
 
|3..13
 
|3..13
−
|parameter value, up to 11 bytes. Data depends on parameter type
+
|
−
|}
 
−
 
 
−
 
 
−
 
 
−
== 0x2A AnswerCommObject ==
 
−
 
 
−
* '''Message Name:''' AnswerCommObject 
 
−
* '''MsgID:''' 42 dec / 0x2A hex 
 
−
* '''Description:''' Answers read request for a specific CommObjects.
 
−
* '''Requires Programming Mode:''' n/a
 
−
 
 
−
{| class="wikitable"
 
−
!style="text-align:center"|Byte no#
 
−
!style="text-align:center"|Description
 
−
|-
 
−
|2
 
−
|CommObject ID
 
−
|-
 
−
|3
 
−
|GA HI
 
−
|-
 
−
|4
 
−
|GA LO
 
−
|-
 
−
|5
 
−
|Settings
 
−
|-
 
−
|6..13
 
−
|0x00, unused
 
 
|}
 
|}

Revision as of 19:31, 5 March 2018

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
Retrieved from "http://wiki.konnekting.de/index.php?title=KONNEKTING_Protocol_Specification_0x01&oldid=231"