Если вы начали знакомство с платформой с этой статьи – рекомендуем перейти в инструкцию для визарда, которая содержит важные детали, пропущенные в тексте ниже.
Сборка прототипа и регистрация на платформе
Сборка прототипа умного Wi-Fi реле подробно описана в предыдущей статье. Для рассказа об особенностях создания нового IoT устройства на платформе без визарда будет использована та же схема.
Также подразумевается, что вы уже зарегистрировались на самой платформе и попробовали ее функционал в режиме демонстрации.
Создание прошивки
1 - Чтобы перейти к созданию нового IoT устройства на платформе без использования пошагового помощника, откройте страницу “Продукты” и нажмите “Создать продукт”.
Обратите внимание! Аналогичная кнопка на главном экране кабинета запускает визард!
2 - Выберите микроконтроллер, на основе которого создано умное устройство – в данном случае это ESP32. Нажмите “Далее”.
3 - В открывшемся окне настроек продукта вы можете указать описание устройства, создать прошивку и мобильное приложение. В отличие от визарда, последовательность этих шагов на данном экране может быть разной.
4 - Обратите внимание на подсказку-индикатор вашего прогресса в создании нового устройства. С ее помощью вы увидите, какие обязательные шаги уже пройдены, а какие еще предстоит пройти, чтобы устройство можно было опубликовать на платформе.
5 - В столбце “Общее” введите название устройства, его описание, загрузите иконку и фотографию.
- “Название продукта” – имя, под которым продукт будет отображаться в маркете 2Smart Cloud и по которому пользователи будут искать устройство.
- “Описание” – небольшой текст о продукте, который отображается в его карточке в маркете.
- “Иконка продукта” – графическое изображение, которое сопровождает название в маркете.
- “Фото товара для маркета” – отображается в карточке в маркете, сопровождая текстовое описание.
При желании этот шаг можно отложить – все эти данные можно редактировать в любой момент. Не забудьте вернуться к этому шагу до публикации продукта.
6 - Переходим к созданию прошивки. Нажмите кнопку “Создать прошивку” в столбце “Прошивка” и выберите один из доступных для вашего микроконтроллера вариантов.
7 - Выберите базу прошивки. Для микроконтроллеров ESP32 это варианты ESPHome или Custom. Подробнее о разнице между ними – в предыдущей статье.
После выбора подходящей базы прошивки (в примере использован ESPHome) нажмите “Далее”.
Скопируйте код прошивки Wi-Fi реле, созданной на базе ESPHome, в новое окно (детальные комментарии к коду – в предыдущей инструкции).
# Switchers for relay and wi-fi led indicator
switch:
- platform: gpio
id: l2
name: relay
pin:
number: GPIO4
inverted: True
- platform: gpio
id: Wifiled
name: ledWifi
pin:
number: GPIO2
# Physical button for relay switching
binary_sensor:
- platform: gpio
pin:
number: GPIO13
mode: INPUT_PULLUP
inverted: True
name: sensor_button
on_press:
then:
- switch.toggle: l2
# Physical button for reset creds for production devices (only for 2Smart Cloud version of EspHome)
- platform: reset_sensor
pin:
number: GPIO15
mode: INPUT_PULLUP
inverted: true
name: Reset button
filters:
- delayed_on: 2s
interval:
- interval: 10s
then:
if:
condition:
wifi.connected:
then:
- switch.turn_on: Wifiled
else:
- switch.turn_off: Wifiled
# Standart sensor for wi-fi signal
sensor:
- platform: wifi_signal
name: "WiFi Signal Sensor"
update_interval: 10s
# Standart sensors for wi-fi settings
text_sensor:
- platform: wifi_info
ip_address:
name: ESP IP Address
ssid:
name: ESP Connected SSID
bssid:
name: ESP Connected BSSID
mac_address:
name: ESP Mac Wifi Address
После настройки кода нажмите “Сохранить”.
8 - После того, как был добавлен код прошивки, на экране настройки продукта появились две новые кнопки “Собрать прошивку” – для Sandbox и Production прошивки.
Sandbox – это прошивка для тестирования прототипа устройства. Production – финальная версия прошивки, которая устанавливается на устройства, предназначенные для конечных пользователей.
Подробнее о разнице между двумя этими вариантами – в предыдущей статье.
9 - Нажмите первую кнопку “Собрать прошивку”, чтобы создать Sandbox прошивку.
10 - Укажите параметры своей Wi-Fi сети и нажмите “Сохранить”.
Обратите внимание! Устройства на основе микроконтроллера ESP32 поддерживают только Wi-Fi сети с частотным диапазоном 2,4 ГГц!
11 - После завершения процесса сборки нажмите на ссылку “Скачать”.
12 - Внутри скачанного архива будет файл readme.md с описанием процесса прошивки устройства. Прошейте его по инструкции.
Прошивка возможна с устройств на Mac OS, Linux или Windows.
Обратите внимание! Если на микроконтроллер уже записана прошивка, не забудьте удалить ее по инструкции в файле readme.md или согласно документации.
13 - После прошивки вернитесь к личному кабинету на платформе – статус устройства сменится на “Ready”, индикатор статуса станет зеленым. Это означает, что устройство успешно обнаружено платформой.
Иногда для обнаружения устройства системой нужно отключить прошитое IoT устройство от питания и подключить его снова.
14 - Обратите внимание на все пункты колонки “Прошивка” после подключения устройства:
- "Обновить прошивку" – используйте ссылку для внесения изменений в код прошивки. После редактирования не забудьте собрать новые версии Sandbox и Production прошивок.
- "Настройки прошивки" – вендор может ввести собственный текст инструкции для пользователей вместо того, что используется в 2Smart Cloud по умолчанию.
- "Поддержка пейринга" – переключатель в "Настройках прошивки". Отвечает за возможность добавления устройства пользователями приложения 2Smart Cloud по стандартной процедуре. Если включен – устройство можно добавить в приложение с использованием функции сопряжения. Если выключен – пользователь сможет найти продукт в каталоге, но не запустит сопряжение.
- "Информация о подключении" – техническая информация для данного продукта с возможностью быстрого копирования каждого из параметров конфигурации. Подробнее обо всех параметрах можно узнать в документации платформы.
- "Предпросмотр состояния" – текущие данные всех сенсоров устройства, подключенного к тестовой среде платформы.
- "Очистить устройство" – кнопка, при нажатии на которую информация о состоянии устройства удаляется из тестового окружения. Такая возможность может потребоваться на этапе разработки и отладки прошивки продукта.
- "Статус устройства" – индикатор подключения устройства с тестовой прошивкой и его текущего состояния. Позволяет убедиться, что устройство подключено, прошито актуальной версией прошивки и исправно функционирует.
Подключение к тестовой среде и создание мобильного приложения
1 - После обнаружения системой устройства с тестовой прошивкой можно создать мобильное приложение для управления устройством со смартфона. Кнопка “Создать интерфейс” теперь активна, нажмите ее.
2 - Мастер настройки мобильного приложения полностью соответствует тому, что используется в визарде.
Управлять устройством можно уже в процессе редактирования интерфейса приложения. Устройство моментально отзывается на переключение виджета реле на экране эмулятора мобильного приложения. И наоборот – при нажатии на кнопку переключения реле на плате в интерфейсе эмулятора мобильного приложения моментально изменится состояние виджета.
3 - Нажмите “Сохранить”, когда настройки приложения завершены. Вернуться к редактированию можно в любой момент – используйте ссылку “Изменить интерфейс”.
4 - Теперь можно протестировать управление устройством со смартфона. Скачайте приложение (iOS | Android), включите в настройках режим разработки и найдите свое устройство в списке – по аналогии с тестированием при добавлении устройства визардом.
Сборка финальной прошивки и управление устройством со смартфона
Используйте Production прошивку для устройств, которые будут продаваться конечным потребителям. Рекомендуем оставить один прототип устройства с тестовой прошивкой для удобного тестирования новых возможностей или изменения интерфейса мобильного приложения.
1 - Для сборки Production прошивки нажмите соответствующую кнопку “Собрать прошивку”.
2 - Дождитесь завершения процесса и нажмите ссылку “Скачать”.
3 - Прошейте устройство финальной прошивкой аналогично тому, как прошивали его тестовой версией.
Обратите внимание! Если на микроконтроллер уже записана прошивка, не забудьте удалить ее по инструкции в файле readme.md или согласно документации.
4 - После сборки финальной прошивки активировалась кнопка “Опубликовать” для вашего продукта. Нажмите ее, чтобы разместить IoT устройство в каталоге 2Smart Cloud.
5 - Подтвердите желание опубликовать новый продукт на платформе.
6 - После публикации появится уведомление “Опубликовано”, а статус продукта изменится с “draft” на “production”.
7 - После публикации продукта можно добавить его в мобильное приложение 2Smart Cloud на своем смартфоне и приступить к использованию устройства. Опубликованный продукт смогут добавлять в приложение и ваши покупатели.
Обратите внимание, что продукт появится в общедоступном каталоге только после одобрения администраторами платформы. До этого добавить устройство можно только через процедуру сопряжения, выбрав пункт “Другие” в маркете.
Привязка устройства к приложению 2Smart Cloud
Посмотрите на устройство глазами вашего клиента. Зарегистрируйтесь в мобильном приложении 2Smart Cloud как обычный пользователь, отключив режим разработки. Протестируйте продукт в реальных условиях. Подробнее – в инструкции для визарда.
Используйте дополнительные возможности по управлению устройством, которые есть у пользователей 2Smart Cloud: голосовые команды, Telegram бота, управление телефонным звонком. Попробуйте возможность поделиться доступом к управлению с другими пользователями. Подробные инструкции можно найти в блоге платформы.
Что дальше
Как видите, представленный выше способ создания нового устройства в 2Smart Cloud – более гибкий в сравнении с визардом. Он рекомендуется опытным вендорам, которые создали хотя бы один продукт и уже ориентируются в функционале платформы.
Обратите внимание, что вы всегда можете вернуться к уже опубликованному продукту, чтобы отредактировать прошивку и приложение. К примеру, если пользователи вашего продукта начали жаловаться на неудобное управление или недостаточный функционал приложения, вы можете внести необходимые изменения всего за несколько минут. Они будут видны вашим клиентам автоматически – достаточно перезапустить приложение 2Smart Cloud на смартфоне.
Подробнее о редактировании продукта – в отдельной инструкции.
Вы также можете работать со статистикой использования ваших устройств пользователями. Этому посвящена еще одна инструкция.
Чтобы присоединиться к 2Smart Cloud, не обязательно быть крупным производителем! Платформа открыта, в том числе, для DIY разработчиков, которые делают устройства для себя, как в этом примере с умным реле.
Ссылки:
- IoT платформа 2Smart Cloud – https://cloud.2smart.com/
- Документация 2Smart Cloud – https://github.com/2SmartCloud/2smart-cloud-docs
- Мобильное приложение 2Smart Cloud в AppStore – https://apps.apple.com/ru/app/2smart-cloud/id1539188825
- Мобильное приложение 2Smart Cloud в Google Play – https://play.google.com/store/apps/details?id=com.smart.microcloud.app&hl=ru&gl=US
- Блог платформы – https://2smart.com/ru/blog
Все статьи о создании и поддержке IoT устройства в 2Smart Cloud:
- Познакомься с IoT платформой – создай свое первое устройство без микроконтроллера и управляй им со смартфона
- Как создать Wi-Fi реле с управлением через мобильное приложение и Telegram бота
- Как создать новое IoT устройство всего за 4 шага
- Как создать IoT устройство на печатной плате – от прототипа к реальному продукту
- Как написать прошивку для IoT устройства на базе SDK
- Как за 5 минут обновить прошивку и мобильное приложение готовых устройств
- Сбор и анализ статистики – полезный инструмент для улучшения продукта
