Подключиться
Yandex IoT Core

Отправка сообщения

Вы можете отправлять сообщения следующих типов:

  • Отправлять данные с устройства в реестр, используя топики $devices/<ID устройства>/events или $registries/<ID реестра>/events.
  • Отправлять команды из реестра на устройство, используя топики $devices/<ID устройства>/commands или $registries/<ID реестра>/commands.

Для получения сообщения необходимо быть подписанным на отправителя. Как это сделать, читайте в разделе Подписка устройства или реестра на получение сообщений.

Важно

Топик реестра и топик устройства не связаны между собой. Если устройство отправляет данные в топик устройства для телеметрических данных, получить их можно только подписавшись на этот топик. Аналогично для топика реестра.

Перед началом

Подготовьте ресурсы, необходимые для начала работы:

  1. (опционально) Создайте сертификаты для реестра и устройства.
  2. Создайте реестр.
  3. Добавьте сертификат реестру.
  4. Создайте устройство.
  5. Добавьте сертификат устройству.

Авторизация

Чтобы отправлять сообщения, необходимо пройти авторизацию. Для этого используйте X.509-сертификат или логин и пароль. В данном разделе приведены примеры для обоих способов авторизации.

Отправить сообщение с данными

Примечание

Если в процессе выполнения команды у вас возникла ошибка, добавьте к команде флаг --debug и попробуйте еще раз. Данный флаг выводит журнал отладки при выполнении команды, что помогает при диагностике проблемы.

Отправьте данные с устройства в топик устройства

Реестр, подписанный на данный топик, будет знать, какое именно устройство отправило данные, так как в топике присутствует уникальный идентификатор устройства.

Если у вас еще нет интерфейса командной строки Яндекс.Облака, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  • Отправьте данные, используя сертификат:

    $ yc iot mqtt publish \
--cert device-cert.pem \
--key device-key.pem \
--topic '$devices/<ID устройства>/events' \
--message 'Test data' \
--qos 1

    Где:

    • --cert и --key — параметры для авторизации с помощью сертификата.
    • --topic — топик устройства для отправки данных.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

  • Отправьте данные, используя логин и пароль:

    $ yc iot mqtt publish \
--username <ID устройства> \
--password <пароль для устройства> \
--topic '$devices/<ID устройства>/events' \
--message 'Test data' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик устройства для отправки данных.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

Отправьте данные с устройства в топик реестра

Реестр, подписанный на данный топик, не будет знать, какое именно устройство отправило данные, так как в топике отсутствует уникальный идентификатор устройства.

Если у вас еще нет интерфейса командной строки Яндекс.Облака, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  • Отправьте данные, используя сертификат:

    $ yc iot mqtt publish \
--cert device-cert.pem \
--key device-key.pem \
--topic '$registries/<ID реестра>/events' \
--message 'Test data' \
--qos 1

    Где:

  • Отправьте данные, используя логин и пароль:

    $ yc iot mqtt publish \
--username <ID устройства> \
--password <пароль для устройства> \
--topic '$registries/<ID реестра>/events' \
--message 'Test data' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик реестра для получения данных.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

Отправить сообщение с командой

Реестр может отправить сообщение с командой одному, нескольким или всем устройствам, добавленным в него. Рассмотрим все варианты.

Примечание

Если в процессе выполнения команды у вас возникла ошибка, добавьте к команде флаг --debug и попробуйте еще раз. Данный флаг выводит журнал отладки при выполнении команды, что помогает при диагностике проблемы.

Отправьте команду одному устройству

Если у вас еще нет интерфейса командной строки Яндекс.Облака, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  • Отправьте команду, используя сертификат:

    $ yc iot mqtt publish \
--cert registry-cert.pem \
--key registry-key.pem \
--topic '$devices/<ID устройства>/commands' \
--message 'Test command for first device' \
--qos 1

    Где:

    • --cert и --key — параметры для авторизации с помощью сертификата.
    • --topic — топик устройства для получения команд.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

  • Отправьте команду, используя логин и пароль:

    $ yc iot mqtt publish \
--username <ID реестра> \
--password <пароль для реестра> \
--topic '$devices/<ID устройства>/commands' \
--message 'Test command for first device' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик устройства для получения команд.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

Отправьте команду всем устройствам, добавленным в реестр

Если у вас еще нет интерфейса командной строки Яндекс.Облака, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  • Отправьте команду, используя сертификат:

    $ yc iot mqtt publish \
--cert registry-cert.pem \
--key registry-key.pem \
--topic '$registries/<ID реестра>/commands' \
--message 'Test command for all devices' \
--qos 1

    Где:

  • Отправьте команду, используя логин и пароль:

    $ yc iot mqtt publish \
--username <ID реестра> \
--password <пароль для реестра> \
--topic '$registries/<ID реестра>/commands' \
--message 'Test command for all devices' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик реестра для отправки команд.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).