Description
A Socket Send message causes the device to transmit data using the current connection. For a non-zero frame ID, this will elicit a Transmit Status - 0x89 frame. For a socket that is not connected, the device responds with a Transmit Status - 0x89 frame with an error. This frame requires a successful Socket Connect - 0x42 frame first. To send data from a UDP socket that is not connected, use a Socket SendTo (Transmit Explicit Data) - 0x47 frame.
Format
The following table provides the contents of the frame. For details on frame structure, see API Frames.
| Offset | Size | Frame Field | Description |
|---|---|---|---|
0 |
8-bit |
Start Delimiter |
Indicates the start of an API frame. |
1 |
16-bit |
Length |
Number of bytes between the length and checksum. |
3 |
8-bit |
Frame type |
0x44 |
4 |
8-bit |
Frame ID |
A reference identifier used to match status responses. Requests made with Frame ID 0 will not send a response. |
5 |
8-bit |
Socket ID |
The socket ID to modify. |
6 |
8-bit |
Transmit Options |
Reserved. |
7 |
variable |
Payload |
Data to be transferred to the destination. |
EOF |
8-bit |
Checksum |
0xFF minus the 8-bit sum of bytes from offset 3 to this byte (between length and checksum). |