Быстрый старт

Эта глава поможет вам за 15 минут пройти первое знакомство с open-source версией FastBee. После завершения развёртывания выполните следующие шаги, чтобы за 5 минут создать первый IoT-продукт и подключить устройство.

Обзор страницы

Содержание страницыОсновной процесс раздела «Быстрый старт»: полный маршрут первого знакомства — от входа в платформу и создания продукта до определения модели вещи и проверки подключения по MQTT.

Кому подходитПользователям, которые завершили развёртывание и впервые работают с платформой: пошаговое создание продукта, определение модели вещи, добавление устройства и тестирование MQTT-подключения.

ТребованияРазвёртывание завершено, Web-консоль доступна, подготовлен MQTT-клиент (например, MQTTX).

Критерии приёмкиВ платформе виден онлайн-статус устройства, устройство может отправлять данные свойств и принимать команды, передаваемые платформой.

1. Вход в платформу

Откройте в браузере http://server-ip и войдите с учётной записью по умолчанию:

• Имя пользователя: admin
• Пароль: admin123

2. Создание продукта

1. Перейдите в Интернет вещей > Управление продуктами
2. Нажмите кнопку Добавить
3. Заполните информацию о продукте:
   • Название продукта: например, «Датчик температуры и влажности»
   • Категория продукта: выберите или создайте категорию
   • Тип устройства: выберите «Устройство прямого подключения»
   • Способ аутентификации: выберите «Простая аутентификация (одно устройство — один секрет)»
4. Нажмите OK для сохранения

3. Определение модели вещи

На странице деталей продукта откройте вкладку Модель вещи.

1. Добавьте свойство: например, «Температура» (тип данных: float, единица: ℃)
2. Добавьте свойство: например, «Влажность» (тип данных: float, единица: %RH)
3. Добавьте функцию (опционально): например, «Переключатель» (тип данных: bool)
4. Нажмите Опубликовать, чтобы модель вещи вступила в силу

4. Добавление устройства

1. Перейдите в Интернет вещей > Управление устройствами
2. Нажмите кнопку Добавить
3. Выберите только что созданный продукт
4. Введите имя устройства (например, «sensor-001»)
5. Система автоматически сгенерирует номер устройства и ключ аутентификации — сохраните эти данные

5. Тестирование MQTT-подключения

Подключитесь к платформе любым MQTT-клиентом (например, MQTTX, MQTT.fx):

Параметр	Значение
Адрес сервера	IP вашего сервера
Порт	1883 (TCP)
Client ID	S&deviceNumber&productId&userId
Имя пользователя	MQTT-аккаунт
Пароль	MQTT-пароль

Отправка данных свойств

Отправьте JSON-данные в следующий топик:

Topic: /{productId}/{deviceNumber}/property/post

[{
  "id": "temperature",
  "value": "25.6",
  "remark": ""
}, {
  "id": "humidity",
  "value": "60.2",
  "remark": ""
}]

После публикации посмотрите данные в реальном времени в разделе Данные модели вещи на странице деталей устройства.

6. Просмотр данных

• Данные в реальном времени: детали устройства > Данные модели вещи
• Журнал устройства: детали устройства > Журнал устройства
• Онлайн-статус: проверьте в списке устройств, находится ли устройство в сети

Следующие шаги

• Изучите Подробное руководство по подключению по MQTT
• Настройте Сценарную автоматизацию (на кит.)
• Напишите Скрипты правил (на кит.)

Часто задаваемые вопросы

Как связаны «Быстрый старт» и «Установка и развёртывание»?

Установка и развёртывание — это предварительное условие, которое запускает платформу; быстрый старт — это руководство по первому использованию после развёртывания, охватывающее кратчайший путь от создания продукта до подключения устройства.

Какая учётная запись по умолчанию у open-source версии FastBee?

Имя пользователя по умолчанию — admin, пароль — admin123. После завершения развёртывания откройте в браузере http://server-ip, чтобы войти в платформу.

Как заполнить параметры подключения MQTT-клиента?

Адрес сервера — IP вашего сервера, порт — 1883 (TCP), формат Client ID — S&deviceNumber&productId&userId, в полях имени пользователя и пароля укажите соответственно MQTT-аккаунт и MQTT-пароль.

В какой топик устройство отправляет данные свойств?

Отправляйте данные в формате JSON-массива в топик /{productId}/{deviceNumber}/property/post; после публикации данные в реальном времени доступны в разделе «Данные модели вещи» на странице деталей устройства.

Как убедиться, что устройство подключено успешно?

Ориентируйтесь на три критерия приёмки: устройство отображается в сети в списке устройств, в разделе «Детали устройства > Данные модели вещи» видны отправленные данные в реальном времени, устройство нормально принимает команды, передаваемые платформой.

См. также

• Установка и развёртывание (на кит.): полное руководство по развёртыванию Docker в один клик и традиционному системному развёртыванию
• Подключение по MQTT: параметры подключения, публикация сообщений и замкнутая проверка на стороне платформы
• Частые вопросы по подключению устройств (на кит.): диагностика активации устройств, настройки сети и хранения данных