Downlink — отправить данные multicast-группе

По описанию v0.17 команда ставит кадр с данными в очередь на отправку multicast-группе. В текущей версии ONS она этого не делает: сервер проверяет запрос, но кадр в очередь не ставит и на правильный запрос не отвечает.

Запрос и ответ: multicast_data_req → ответа нет; при ошибке — сообщение с тем же cmd: multicast_data_req.
Доступ: только токен высокого уровня. С токеном низкого уровня сервер ответит ошибкой 1.

Текущая версия ONS

Отличия от описания v0.17:

• Команда не выполняется: кадр не попадает в очередь и в эфир не уходит.
• На правильный запрос сервер не отвечает. Сообщения multicast_data_resp с dataId не существует.
• При ошибке приходит сообщение с cmd: multicast_data_req, без operation_id и без error_text.

Запрос

Поля без пометки «обязательно» можно не передавать. Сервер только проверяет их формат.

Поле	Тип	Описание
cmd	string	multicast_data_req
operation_id	string	Произвольная строка; в ответ сервер её не возвращает
data	string	Обязательно. Полезная нагрузка в hex
multicast_eui	string	EUI группы, 16 hex-символов
multicast_addr	string	Адрес группы, 8 hex-символов
gatewayEui	string	EUI шлюза, 16 hex-символов
fport	uint8	Порт приложения, 0–255. По умолчанию 2
fcnt	uint16	Счётчик кадров, 0–65535. По умолчанию 0

{
    "cmd": "multicast_data_req",
    "operation_id": "xyz",
    "multicast_eui": "7DA50BE8C74CE6DC",
    "fport": 2,
    "data": "FFFFFFFFFFFF"
}

Ответ

На правильный запрос ответа нет. Сообщение приходит только при ошибке:

Поле	Тип	Описание
cmd	string	multicast_data_req
status	uint8	2 — ошибка
error_code	uint8	Код ошибки, см. ниже

{
    "cmd": "multicast_data_req",
    "status": 2,
    "error_code": 3
}

Ошибки

error_code	error_text	Что случилось
1	—	Запрос пришёл с токеном низкого уровня
3	—	Неверные данные: нет data или в нём не hex; multicast_eui или gatewayEui не из 16 hex-символов; multicast_addr не из 8; fport не 0–255; fcnt не 0–65535

См. также

• Multicast-группы — что такое группа и какие команды работают.