База знаний / Справочник TiOS / Разработка (TiOS) / Справочник по программированию / Библиотеки / Справочник по библиотекам / Библиотека MQTT
Пошаговая инструкция по использованию
Внимание
Этот раздел сейчас переделывается. Приносим извинения за неудобства. Если вам нужна срочная помощь, обратитесь в Tibbo Support.
Минимальные шаги
- Убедитесь, что в проекте есть библиотека SOCK.
- Добавьте в проект файлы mqtt.tbs и mqtt.tbh (они находятся в current_library_set\mqtt\trunk).
- Добавьте #define MQTT_DEBUG_PRINT 1 в раздел defines файла global.tbh проекта. Так вы будете «видеть, что происходит». Не забудьте потом удалить эту строку, когда убедитесь, что библиотека работает как ожидается. Отладочный вывод заметно замедляет работу!
- Добавьте include "mqtt\trunk\mqtt.tbh" в раздел Includes файла global.tbh.
- Добавьте mqtt_proc_timer() в код обработчика события on_sys_timer().
- Добавьте mqtt_proc_data() в код обработчика события on_sock_data_arrival().
- Добавьте следующее в обработчик события on_sys_init():
- Добавьте mqtt_start() для инициализации библиотеки;
- Добавьте mqtt_connect() с правильными параметрами MQTT-сервера (брокера), чтобы начать соединение с сервером.
- Если ваше устройство является издателем (publisher), реализуйте код, который вызывает mqtt_publish() в нужные моменты.
- Создайте тела функций обратного вызова где-нибудь в проекте (например, в файле device.tbs):
- Callback_mqtt_connect_ok() - процедуру можно оставить пустой;
- Callback_mqtt_connect_lost() - как минимум тело этой функции должно содержать вызов mqtt_reconnect();
- Callback_mqtt_notif() - если устройство является подписчиком (subscriber), именно здесь размещается код, который реагирует на уведомления от MQTT-сервера;
- Callback_mqtt_sub_ok() - процедуру можно оставить пустой.