1. CDNET Levels
2. Level 0 Format
3. Level 1 Format
4. Level 2 Format
5. Specific Ports
6. Examples

CDNET protocol has three different levels, select by bit7 and bit6 of first byte:

You can select one or more levels for your application as needed.

The CDNET is little endian.

First byte:

Note: The port is equivalent to UDP port, but can be simply understood as commands.

The second byte and after: command parameters.

First byte:

E.g.: reply [0x40, 0x0c] is the same as [0x6c].

0x40: 'b0100_0000
0x0c: 'b0000_1100
----
0x6c: 'b0110_1100

The first byte shared part, and the second byte and after: reply status and/or datas.

First byte:

Notes: All fields reserved in this document must be 0.

Notes:

• Broadcast could simply not use the MULTICAST bit.

0: No sequence number;
1: Append 1 byte SEQ_NUM, see Port 0.

Notes:

• Default port is 0xcdcd for convention, it does not take up space.
• Append bytes for src_port first then dst_port.

First byte:

Note:

• SEQUENCE must be selected when using fragments.
• There is no need to reset the SEQ_NUM when starting the fragmentation.

0: No sequence number;
1: Append 1 byte SEQ_NUM, see Port 0.

Ports 0 through 9 are cdnet-specific (undefined ports are reserved), Port 10 and later are freely assigned by user.

All specific ports are optional, and user can only implement some of the port features. It is recommended to implement at least the basic part of port 1 (device info).

Used together with header's SEQUENCE for flow control and ensure data integrity.
The SEQ_NUM[6:0] auto increase when SEQUENCE is selected in the header.
Bit 7 of SEQ_NUM is set indicating that a report is required.
Do not select SEQUENCE for port 0 communication self.

Port 0 communications:

Check the SEQ_NUM:
  Write []
  Return: [SEQ_NUM] (no record found if bit 7 set)

Set the SEQ_NUM:
  Write [0x00, SEQ_NUM]
  Return: []

Report SEQ_NUM:
  Write [SEQ_NUM]
  Return: None

Example:
(-> and <- is port level communication, >> and << is packet level communication)

  Device A                      Device B        Description

  [0x00, 0x00]          ->      Port0           Set SEQ_NUM at first time
  Default port          <-      []              Set return
  [0x88, 0x00, ...]     >>                      Start send data
  [0x88, 0x01, ...]     >>
  [0x88, 0x82, ...]     >>                      Require report at SEQ_NUM 2
  [0x88, 0x03, ...]     >>
  [0x88, 0x04, ...]     >>
  Port0                 <-      [0x03]          Report after receive SEQ_NUM 2
  [0x88, 0x85, ...]     >>                      Require report at SEQ_NUM 5
  Port0                 <-      [0x06]          Report after receive SEQ_NUM 5

Provide device info.

Type of mac_start and mac_end is uint8_t;
Type of max_time is uint16_t, unit: ms;
Type of "string" is any length of string, include empty.

Check device_info string:
  Write []
  Return ["device_info"]

Search device by filters (need by mac auto allocation):
  Write [max_time, mac_start, mac_end, "string"]
  Return ["device_info"] after a random time in range [0, max_time]
    only if "device_info" contain "string" (always true for empty string) and
    current mac address is in the range [mac_start, mac_end]
  Return None otherwise

Example of device_info:
M: model; S: serial string; HW: hardware version; SW: software version ...
Do not care about the field order, and should at least include the model field.

Set device baud rate.

Type of baud_rate is uint32_t, e.g. 115200;
Type of intf is uint8_t.

Set current interface baud rate：
  Write [0x00, baud_rate]                       // single baud rate
  Write [0x00, baud_rate_low, baud_rate_high]   // dual baud rate
  Return: []                                    // change baud rate after return

Set baud rate for specified interface:
  Write [0x08, intf, baud_rate]
  Write [0x08, intf, baud_rate_low, baud_rate_high]
  Return: []

Check baud rate for specified interface:
  Write [0x08, intf]
  Return: [baud_rate] or [baud_rate_low, baud_rate_high]

Set device address.

Type of mac and net is uint8_t;
Type of intf is uint8_t;
Type of "string" is any length of string, include empty.

Change mac address for current interface:
  Write [0x00, new_mac, "string"]:              // "string" is optional (need by mac auto allocation)
  Return [] if "device_info" contain "string"   // change mac address after return
  Return None and ignore the command otherwise

Change net id for current interface:
  Write [0x01, new_net]
  Return: []                                    // change net id after return

Check net id of current interface:
  Write [0x01]
  Return: [net]

Set mac address for specified interface:
  Write [0x08, intf, new_mac]
  Return: []

Set net id for specified interface:
  Write [0x09, intf, new_net]
  Return: []

Check mac address for specified interface:
  Write [0x08, intf]
  Return: [mac]

Check net id for specified interface:
  Write [0x09, intf]
  Return: [net]

Request device info:
(Local network, requester's MAC address: 0x0c, target's MAC address: 0x0d)

Reply the device info string: "M: c1; S: 1234", expressed in hexadecimal: [0x4d, 0x3a, 0x20, 0x63, 0x31, 0x3b, 0x20, 0x53, 0x3a, 0x20, 0x31, 0x32, 0x33, 0x34].

The Level 0 Format:

• Request:
  • CDNET packet: [0x01] (dst_port = 0x01, no arguments)
  • CDBUS frame: [0x0c, 0x0d, 0x01, 0x01, crc_l, crc_h]
• Reply:
  • CDNET packet: [0x40, 0x4d, 0x3a, 0x20 ... 0x34] (0x40: first data byte not shared with the head)
  • CDBUS frame: [0x0d, 0x0c, 0x0f, 0x40, 0x4d, 0x3a, 0x20 ... 0x34, crc_l, crc_h]

The Level 1 Format:

• Request:
  • CDNET packet: [0x80, 0x01] (src_port = default, dst_port = 0x01, no arguments)
  • CDBUS frame: [0x0c, 0x0d, 0x02, 0x80, 0x01, crc_l, crc_h]
• Reply:
  • CDNET packet: [0x82, 0x01, 0x4d, 0x3a, 0x20 ... 0x34] (src_port = 0x01, dst_port = default)
  • CDBUS frame: [0x0d, 0x0c, 0x10, 0x82, 0x01, 0x4d, 0x3a, 0x20 ... 0x34, crc_l, crc_h]

How to use this library refer to stepper_motor_controller, cdbus_bridge or cdnet_tun projects;
How to control CDCTL-Bx refer to dev/cdctl_bx_xxx.