Command/response AEh, Ethernet configuration

The following table describes the structure of the report packet containing the application file. All data in the packet flows from the data collector to the receiver.

Byte

Item

Type

Value

Notes

0

STX

1 (Char)

02h

Start transmission.

1

STATUS

1 (Char)

See Receiver status byte.

Receiver status indicator.

2

PACKET TYPE

1 (Char)

AEh

Command/Response packet AEh.

3

LENGTH

1 (Char)

See Data collector format: packet structure.

Data byte count.

4

SUBTYPE

1 (Char)

00h, 01h, 02h, 0Ch, 0Dh, 0Eh, 0Fh, 10h

Subtypes can be:

00h: Get DHCP and IP Address
01h: Response DHCP and IP Address
02h: Set DHCP and IP Address
0Ch: Get IP Port Summary
0Dh: Return IP Port Summary
0Eh: Get Individual IP Port Configuration
0Fh: Return Individual IP Port Configuration
10h: Set Individual IP Port Configuration

 

CHECKSUM

1 (Char)

See Data collector format: packet structure.

Checksum value.

 

ETX

1 (Char)

03h

End transmission.

Subtypes

The subtypes are:

  • 00h: command sent from the data collector to the receiver this will cause the receiver to respond with the type 01h subtype message.

  • 01h: response from the receiver giving the DHCP and IP Address status of the unit. For the response packets, see Subtype 1: Response DHCP and IP Address.

  • 02h: command sent from the data collector to the receiver setting the DHCP and IP Address status of the unit. For the structure of the command packet, see Subtype 2: Set DHCP and IP Address. It must include all fields even if DHCP is enabled (address fields can be set to 00h if DHCP is used).

  • 0Ch: command sent from the data collector to the receiver this will cause the receiver to respond with the type 0Dh subtype message.

  • 0Dh: response from the receiver giving the IP port summary of the unit. For the response packets, see Subtype 0Dh: Response IP Port Summary.

  • 0Eh: command sent from the data collector to the receiver this will cause the receiver to respond with the type 0Fh subtype message. See Subtype 0Eh: Get Individual IP Port Configuration.

  • 0Fh: response from the receiver giving the IP port configuration for a specific port of the unit. For the response packets, see Subtype 0Fh: Response Individual IP Port Configuration.

  • 10h: command sent from the data collector to the receiver setting the IP port configuration for a specific port of the unit. For the structure of the command packet, see Subtype 10h: Set Individual IP Port Configuration.

Subtype 1: Response DHCP and IP Address

Byte

Item

Type

Value

Meaning

5

DHCP ACTIVE

1 (Char)

00h–01h

Set if DHCP is active, otherwise Static IP addresses are used.

6–9

IP ADDRESS

4 (Chars)

00h–FFh

Each byte gives one of the integers (0-255) in the dot-decimal notation of the IP v4 IP address assigned.

10–13

NETMASK

4 (Chars)

00h–FFh

14–17

BROADCAST ADDRESS

4 (Chars)

00h–FFh

18–21

GATEWAY

4 (Chars)

00h–FFh

22–25

DNS SERVER ADDRESS

4 (Chars)

00h–FFh

---------- End of Subtype 1 ----------

Subtype 2: Set DHCP and IP Address

Byte

Item

Type

Value

Meaning

5

DHCP ACTIVE

1 (Char)

00h–01h

Set if DHCP is active, otherwise Static IP addresses are used.

6–9

IP ADDRESS

4 (Chars)

00h–FFh

Each byte gives one of the integers (0-255) in the dot-decimal notation of the IP v4 IP address assigned when in a static IP mode (if DHCP is active, this is determined from the DHCP server and can be left as four 00h characters).

10–13

NETMASK

4 (Chars)

00h–FFh

14–17

BROADCAST ADDRESS

4 (Chars)

00h–FFh

18–21

GATEWAY

4 (Chars)

00h–FFh

22–25

DNS SERVER ADDRESS

4 (Chars)

00h–FFh

---------- End of Subtype 2 ----------

After the 02h subtype message is sent, the receivers will ACK or NAK this command.

Subtype 0Dh: Response IP Port Summary

Byte

Item

Type

Value

Meaning

5

FIRST VIRTUAL PORT

1 (Char)

00h–FFh

The lowest numbered virtual receiver port allocated to the Ethernet interface (zero-based, see Port number values).

6

LAST VIRTUAL PORT

1 (Char)

00h–FFh

The highest numbered virtual receiver port allocated to the Ethernet interface (zero-based, see Port number values).

7

NUMBER OF ACTIVE VIRTUAL PORTS

1 (Char)

00h–FFh

The number of active virtual ports. This specifies the number of bytes to follow.

??

ACTIVE VIRTUAL PORTS

1 (Char)

00h–FFh

List of virtual port numbers set up as active IP ports. Each byte gives the virtual port ID for a single virtual port.

---------- End of Subtype 0Dh ----------

Subtype 0Eh: Get Individual IP Port Configuration

Byte

Item

Type

Value

Meaning

5

VIRTUAL PORT

1 (Char)

00h–FFh

The numbered virtual receiver port whose configuration will be returned (zero-based, see Port number values).

---------- End of Subtype 0Eh ----------

Subtype 0Fh: Response Individual IP Port Configuration

Byte

Item

Type

Value

Meaning

5

VIRTUAL PORT

1 (Char)

00h–FFh

The numbered virtual receiver port whose configuration has been returned (zero-based, see Port number values).

6

ACTIVE

1 (Char)

00h–01h

Set if the virtual port is active.

7–8

IP PORT

2 (Chars)

0000h–FFFFh

The IP port number for this virtual port.

9

MODE

1 (Char)

00h–FFh

0 (TCP) or 1 (UDP)

10

UDP TIMEOUT

1 (Char)

00h–FFh

UDP Timeout in seconds.

11

OUTPUT ONLY

1 (Char)

00h–FFh

If set, the port will operate in an output-only mode and allow multiple connections.

12

RESERVED

1 (Char)

00h

Reserved (set to zero).

13

INITIATE CONNECTION

1 (Char)

00h–01h

The port will operate in a client mode if set (in client mode, "OUTPUT ONLY" must be disabled).

14–15

REMOTE IP PORT

2 (Chars)

0000h–FFFFh

The IP port to connect to if initiating a connection in client mode.

16–22

RESERVED

7 (Chars)

00h

Reserved (set to zero).

23

REMOTE IP ADDR LENGTH

1 (Char)

00h–FFh

Number of bytes to follow in the REMOTE IP ADDRESS.

24–??

REMOTE IP ADDRESS

?? Chars

00h–FFh

The IP address to connect to if initiating a connection in client mode. Each byte is converted to its ASCII character value.

---------- End of Subtype 0Fh ----------

Subtype 10h: Set Individual IP Port Configuration

Byte

Item

Type

Value

Meaning

5

VIRTUAL PORT

1 (Char)

00h–FFh

The numbered virtual receiver port whose configuration has been returned (zero-based, see Port number values).

6

ACTIVE

1 (Char)

00h–01h

Set if the virtual port is active.

7–8

IP PORT

2 (Chars)

0000h–FFFFh

The IP port number for this virtual port.

9

MODE

1 (Char)

00h–FFh

0 (TCP) or 1 (UDP)

10

UDP TIMEOUT

1 (Char)

00h–FFh

UDP Timeout in seconds.

11

OUTPUT ONLY

1 (Char)

00h–FFh

If set, the port will operate in an output-only mode and allow multiple connections.

12

RESERVED

1 (Char)

00h

Reserved (set to zero).

13

INITIATE CONNECTION

1 (Char)

00h–01h

The port will operate in a client mode if set (in client mode, "OUTPUT ONLY" must be disabled).

14–15

REMOTE IP PORT

2 (Chars)

0000h–FFFFh

The IP port to connect to if initiating a connection in client mode.

16–22

RESERVED

7 (Chars)

00h

Reserved (set to zero).

23

REMOTE IP ADDR LENGTH

1 (Char)

00h–FFh

Number of bytes to follow in the REMOTE IP ADDRESS.

24–??

REMOTE IP ADDRESS

?? Chars

00h–FFh

The IP address to connect to if initiating a connection in client mode. Each byte is converted from its ASCII character value.

---------- End of Subtype 10h ----------

After the 10h subtype message is sent, the receivers will ACK or NAK this command.