Socket SendTo (Transmit Explicit Data): IPv4 - 0x45
Description
A Socket SendTo (Transmit Explicit Data) message causes the device to transmit data using an IPv4 address and port. For a non-zero frame ID, this will elicit a Transmit (TX) Status - 0x89 frame.
If this frame is used with a TCP, SSL, or a connected UDP socket, the address and port fields are ignored.
You must perform a Socket Bind/Listen - 0x46 frame for a UDP connection before you attempt a SendTo in order to assign a source port.
Format
The following table provides the contents of the frame. For details on frame structure, see API frame format.
Field name | Field value | Data type | Description |
---|---|---|---|
Frame type |
0x45 |
Byte |
|
Frame ID |
|
Byte |
A reference identifier used to match status responses. If set to 0, the Transmit (TX) Status - 0x89 frame is disabled. |
Socket ID |
|
Byte |
ID of the socket to send on. |
Destination address | 32-bit big endian |
|
|
Destination port | 16-bit big endian | ||
Transmit options | Byte bit-field | Reserved | |
Payload | Variable | Data to be transferred to the destination, up to 1500 bytes. |