Блог 2Smart (RU)

Как создать новое IoT устройство всего за 4 шага

Самый простой способ создать новое IoT устройство с помощью платформы 2Smart Cloud – использование пошагового помощника. Однако опытным вендорам и тем, кто не хочет ограничиваться рамками визарда, подойдет альтернативный вариант, который отличается более гибкими возможностями. На примере Wi-Fi реле покажем, как создать новое IoT устройства в кабинете вендора 2Smart Cloud без использования визарда.

Если вы начали знакомство с платформой с этой статьи – рекомендуем перейти в инструкцию для визарда, которая содержит важные детали, пропущенные в тексте ниже.

Сборка прототипа и регистрация на платформе


Сборка прототипа умного Wi-Fi реле подробно описана в предыдущей статье. Для рассказа об особенностях создания нового IoT устройства на платформе без визарда будет использована та же схема.

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

Прототип Wi-Fi реле на основе микроконтроллера ESP32

Схема Wi-Fi реле

Создание прошивки


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 прошивку.

Ссылка для сборки Sandbox прошивки

10 - Укажите параметры своей Wi-Fi сети и нажмите “Сохранить”.

Обратите внимание! Устройства на основе микроконтроллера ESP32 поддерживают только Wi-Fi сети с частотным диапазоном 2,4 ГГц!

Окно добавления параметров Wi-Fi сети

11 - После завершения процесса сборки нажмите на ссылку “Скачать”.


12 - Внутри скачанного архива будет файл readme.md с описанием процесса прошивки устройства. Прошейте его по инструкции.

Прошивка возможна с устройств на Mac OS, Linux или Windows.

Обратите внимание! Если на микроконтроллер уже записана прошивка, не забудьте удалить ее по инструкции в файле readme.md или согласно документации.

Содержание архива с Sandbox прошивкой

Процесс прошивки устройства

13 - После прошивки вернитесь к личному кабинету на платформе – статус устройства сменится на “Ready”, индикатор статуса станет зеленым. Это означает, что устройство успешно обнаружено платформой.

Иногда для обнаружения устройства системой нужно отключить прошитое IoT устройство от питания и подключить его снова.

Статус Ready, говорящий об успешном обнаружении устройства

14 - Обратите внимание на все пункты колонки “Прошивка” после подключения устройства:

  • "Обновить прошивку" – используйте ссылку для внесения изменений в код прошивки. После редактирования не забудьте собрать новые версии Sandbox и Production прошивок.
  • "Настройки прошивки" – вендор может ввести собственный текст инструкции для пользователей вместо того, что используется в 2Smart Cloud по умолчанию.
  • "Поддержка пейринга" – переключатель в "Настройках прошивки". Отвечает за возможность добавления устройства пользователями приложения 2Smart Cloud по стандартной процедуре. Если включен – устройство можно добавить в приложение с использованием функции сопряжения. Если выключен – пользователь сможет найти продукт в каталоге, но не запустит сопряжение.
Когда может потребоваться отключение функции? Возможность существует для вендоров, подготовивших особую прошивку, которая не поддерживает стандартное сопряжение. В таком случае пользователям можно предложить инструкцию по подключению устройства другими способами – например, через встроенный интерфейс устройства.
  • "Информация о подключении" – техническая информация для данного продукта с возможностью быстрого копирования каждого из параметров конфигурации. Подробнее обо всех параметрах можно узнать в документации платформы.
  • "Предпросмотр состояния" – текущие данные всех сенсоров устройства, подключенного к тестовой среде платформы.
  • "Очистить устройство" – кнопка, при нажатии на которую информация о состоянии устройства удаляется из тестового окружения. Такая возможность может потребоваться на этапе разработки и отладки прошивки продукта.
  • "Статус устройства" – индикатор подключения устройства с тестовой прошивкой и его текущего состояния. Позволяет убедиться, что устройство подключено, прошито актуальной версией прошивки и исправно функционирует.

Все пункты колонки “Прошивка” окна настроек продукта

Подключение к тестовой среде и создание мобильного приложения


1 - После обнаружения системой устройства с тестовой прошивкой можно создать мобильное приложение для управления устройством со смартфона. Кнопка “Создать интерфейс” теперь активна, нажмите ее.

Создать интерфейс

2 - Мастер настройки мобильного приложения полностью соответствует тому, что используется в визарде.
Окно настройки интерфейса мобильного приложения


Управлять устройством можно уже в процессе редактирования интерфейса приложения. Устройство моментально отзывается на переключение виджета реле на экране эмулятора мобильного приложения. И наоборот – при нажатии на кнопку переключения реле на плате в интерфейсе эмулятора мобильного приложения моментально изменится состояние виджета.

3 - Нажмите “Сохранить”, когда настройки приложения завершены. Вернуться к редактированию можно в любой момент – используйте ссылку “Изменить интерфейс”.

Ссылка для редактирования интерфейса мобильного приложения

4 - Теперь можно протестировать управление устройством со смартфона. Скачайте приложение (iOS | Android), включите в настройках режим разработки и найдите свое устройство в списке – по аналогии с тестированием при добавлении устройства визардом.

Сборка финальной прошивки и управление устройством со смартфона


Используйте Production прошивку для устройств, которые будут продаваться конечным потребителям. Рекомендуем оставить один прототип устройства с тестовой прошивкой для удобного тестирования новых возможностей или изменения интерфейса мобильного приложения.

1 - Для сборки Production прошивки нажмите соответствующую кнопку “Собрать прошивку”.

Ссылка для сборки Production прошивки

2 - Дождитесь завершения процесса и нажмите ссылку “Скачать”.

Скачать продакшн прошивку

3 - Прошейте устройство финальной прошивкой аналогично тому, как прошивали его тестовой версией.

Обратите внимание! Если на микроконтроллер уже записана прошивка, не забудьте удалить ее по инструкции в файле readme.md или согласно документации.

4 - После сборки финальной прошивки активировалась кнопка “Опубликовать” для вашего продукта. Нажмите ее, чтобы разместить IoT устройство в каталоге 2Smart Cloud.

Кнопка публикации готового продукта

5 - Подтвердите желание опубликовать новый продукт на платформе.


6 - После публикации появится уведомление “Опубликовано”, а статус продукта изменится с “draft” на “production”.

Страница продукта в панели вендора со статусом “Опубликовано”

7 - После публикации продукта можно добавить его в мобильное приложение 2Smart Cloud на своем смартфоне и приступить к использованию устройства. Опубликованный продукт смогут добавлять в приложение и ваши покупатели.

Обратите внимание, что продукт появится в общедоступном каталоге только после одобрения администраторами платформы. До этого добавить устройство можно только через процедуру сопряжения, выбрав пункт “Другие” в маркете.

Привязка устройства к приложению 2Smart Cloud


Посмотрите на устройство глазами вашего клиента. Зарегистрируйтесь в мобильном приложении 2Smart Cloud как обычный пользователь, отключив режим разработки. Протестируйте продукт в реальных условиях. Подробнее – в инструкции для визарда.

Виджеты для управления устройством в мобильном приложении 2Smart Cloud

Используйте дополнительные возможности по управлению устройством, которые есть у пользователей 2Smart Cloud: голосовые команды, Telegram бота, управление телефонным звонком. Попробуйте возможность поделиться доступом к управлению с другими пользователями. Подробные инструкции можно найти в блоге платформы.

Что дальше


Как видите, представленный выше способ создания нового устройства в 2Smart Cloud – более гибкий в сравнении с визардом. Он рекомендуется опытным вендорам, которые создали хотя бы один продукт и уже ориентируются в функционале платформы.

Обратите внимание, что вы всегда можете вернуться к уже опубликованному продукту, чтобы отредактировать прошивку и приложение. К примеру, если пользователи вашего продукта начали жаловаться на неудобное управление или недостаточный функционал приложения, вы можете внести необходимые изменения всего за несколько минут. Они будут видны вашим клиентам автоматически – достаточно перезапустить приложение 2Smart Cloud на смартфоне.

Подробнее о редактировании продукта – в отдельной инструкции.

Вы также можете работать со статистикой использования ваших устройств пользователями. Этому посвящена еще одна инструкция.

Чтобы присоединиться к 2Smart Cloud, не обязательно быть крупным производителем! Платформа открыта, в том числе, для DIY разработчиков, которые делают устройства для себя, как в этом примере с умным реле.

Ссылки:


Все статьи о создании и поддержке IoT устройства в 2Smart Cloud:

  1. Познакомься с IoT платформой – создай свое первое устройство без микроконтроллера и управляй им со смартфона
  2. Как создать Wi-Fi реле с управлением через мобильное приложение и Telegram бота
  3. Как создать новое IoT устройство всего за 4 шага
  4. Как создать IoT устройство на печатной плате – от прототипа к реальному продукту
  5. Как написать прошивку для IoT устройства на базе SDK
  6. Как за 5 минут обновить прошивку и мобильное приложение готовых устройств
  7. Сбор и анализ статистики – полезный инструмент для улучшения продукта
Made on
Tilda