Skip to main content

Downlink — clear multicast group queue

According to the v0.17 description, the command cancels the frames of a multicast group that are waiting to be sent. The current ONS version has no such command: the server responds to the request with an invalid_command_req message, and the group queue stays as it was.

Request and response: multicast_data_purge_req → invalid_command_req.
Access: the command is not executed with any token.

Current ONS version

The command is described in v0.17 but is not implemented in the server. The multicast_data_purge_resp message does not exist.

Request​

The server reads only operation_id from the request. It does not parse the multicast_eui and multicast_addr fields from the v0.17 description.

FieldTypeDescription
cmdstringmulticast_data_purge_req
operation_idstringAny string; the server returns it in the response to match the request and the response
{
"cmd": "multicast_data_purge_req",
"operation_id": "xyz",
"multicast_eui": "7DA50BE8C74CE6DC"
}

Response​

FieldTypeDescription
cmdstringinvalid_command_req — the server does not recognize this command
operation_idstringValue from the request; an empty string if it was not given

The response has no status and error_code fields.

{
"cmd": "invalid_command_req",
"operation_id": "xyz"
}

Errors​

The command has no error codes: the server responds to any request with invalid_command_req.

See also​