ThingLinks-MQTT-C

Открытый клиент ThingLinks для платформы MQTT, интегрирующей IoT. Клиент предназначен для операционных систем Windows, Linux и MacOS.

Быстрое начало работы

1. Компилирование окружения и компиляции.
   • Операционная система: Ubuntu 16.
   • Компилятор: GCC.
2. Инструкция по компиляции:
   • make && make install.
3. Сгенерированные файлы динамической библиотеки и исполняемые файлы примеров:
   • build/output — содержит файлы libpaho-mqtt3a.so*, libpaho-mqtt3as.so* и libpaho-mqtt3ac.so*.
   • build/output/samples — содержит исполняемые файлы для тестирования, которые могут подключаться к платформе MQTT, подписываться на сообщения и отправлять сообщения.
4. Интерпретация параметров тестовых процессов paho_cs_pub, paho_cs_sub, paho_c_sub и paho_c_pub:

   • Использование: [topicname] [-t topic] [-c connection] [-h host] [-p port] [-q qos] [-i clientid] [-u username] [-P password] [-k keepalive_timeout] [-V MQTT-version] [--quiet] [--trace trace-level] [-R] [--no-delimiter] [--will-topic topic] [--will-payload message] [--will-qos qos] [--will-retain] [--cafile filename] [--capath dirname] [--cert filename] [--key filename] [--keypass string] [--ciphers string] [--insecure].

   • -t (--topic) — тема MQTT для подписки.

   • -c (--connection) — строка подключения, которая заменяет хост и порт.

   • -h (--host) — хост для подключения. По умолчанию localhost.

   • -p (--port) — сетевой порт для подключения. По умолчанию 1883.

   • -q (--qos) — качество обслуживания (0, 1 или 2) для подписки. По умолчанию 0.

   • -V (--MQTTversion) — версия MQTT (31, 311 или 5). По умолчанию 311.

   • --quiet — не выводить сообщения об ошибках.

   • --trace — выводить внутреннюю трассировку («ошибка», «минимальная», «максимальная» или «протокол»).

   • -i (--clientid) — идентификатор клиента MQTT. По умолчанию paho-cs-sub.

   • -u (--username) — имя пользователя MQTT. Без нарушения обязательств.

   • -P (--password) — пароль MQTT. Без нарушения обязательств.

   • -k (keepalive) — время ожидания MQTT keepalive. По умолчанию 10 секунд.

   • --delimiter — строка разделителя. По умолчанию \n.

   • --no-delimiter — не использовать строку разделителя между сообщениями.

   • -R (--без сохранения) — не печатать сохранённые сообщения.

   • --will-topic — тема соединения will. Без нарушения обязательств.

   • --will-payload — сообщение will. Если установлена тема will, но не установлена полезная нагрузка, будет установлено пустое сообщение.

   • --will retain (сохранить) — установить флаг сохранения в сообщении will. По умолчанию отключено.

   • --will qos — качество обслуживания сообщения will. По умолчанию 0.

   • --cafile — имя файла доверенной библиотеки TLS.

   • --capath — имя каталога, содержащего сертификаты доверенных серверов TLS.

   • --cert — имя файла библиотеки ключей TLS для клиентского сертификата.

   • --key — файл закрытого ключа клиента.

   • --keypass — пароль для файла закрытого ключа клиента.

   • --ciphers — список комплектов шифров, предоставляемых клиентом серверу во время рукопожатия TLS.

   • --insecure — не проверять сертификат сервера на соответствие общему имени.

   • --psk — шестнадцатеричный предварительный общий ключ (без ведущего 0x).

   • --psk-identity — строка идентификации клиента в режиме TLS-psk.

   • --http-proxy — строка прокси HTTP.

   • --https-proxy — строка прокси HTTPS.

5. Примеры использования тестового процесса:
   • Подключение к платформе MQTT и подписка на сообщения темы test:
     • paho_cs_sub -v -h 113.90.145.99 -p 18886 -u smqtt -P smqtt -i 123456 -t test.
   • Подключение к платформе MQTT и отправка сообщений на тему test с вводом содержимого сообщения с клавиатуры:
     • paho_cs_pub -v -h 113.90.145.99 -p 18886 -u smqtt -P smqtt -i 12345678 -t test.