Блог 2Smart (UK)

Як створити новий IoT пристрій всього за 4 кроки

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

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

Збірка прототипу і реєстрація на платформі


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

Схема реле

Також мається на увазі, що ви вже реєструвалися на самій платформі та спробували її функціонал у режимі демонстрації.

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

Створення прошивки


1. Щоб перейти до створення нового IoT пристрою на платформі без використання покрокового помічника, відкрийте сторінку “Products” та натисніть “Add Product”.

Зверніть увагу! Аналогічна кнопка головного екрана кабінету запускає візард!

Кнопка створення нового продукту

2. Виберіть мікроконтролер, на основі якого створено розумний пристрій – у цьому випадку це ESP32. Натисніть «Next».

Вікно вибору мікроконтролера

3. У вікні налаштувань продукту ви можете вказати опис пристрою, створити прошивку та мобільний додаток. На відміну від візарду, послідовність цих кроків на цьому екрані може бути різною.

Вікно налаштувань нового продукту


4. Зверніть увагу на підказку-індикатор прогресу у створенні нового пристрою. З її допомогою ви побачите, які обов'язкові кроки вже пройдені, а які ще доведеться пройти, щоб пристрій можна було опублікувати на платформі.

Підказка-індикатор прогресу в створенні пристрою

5. У стовпці “General” введіть назву пристрою, його опис, завантажте іконку та фотографію.

  • Product Name (Назва продукту) – це ім'я, під яким продукт відображатиметься в маркеті 2Smart Cloud і за яким користувачі шукатимуть пристрій.
  • Description (Опис) – невеликий текст про продукт, який відображається у його картці у маркеті.
  • Product Icon (Іконка продукту) – графічне зображення, яке супроводжує назву в маркеті.
  • Product photo for market (Фото товару для маркету) – відображається у картці у маркеті, супроводжуючи текстовий опис.

За бажанням цей крок можна відкласти - всі ці дані можна редагувати будь-якої миті. Не забудьте повернутись до цього кроку до публікації продукту.

Поля для додавання опису нового продукту

6. Переходимо до створення прошивки. Натисніть кнопку “Add Firmware” у стовпці “Firmware” та виберіть один із доступних для вашого мікроконтролера варіантів.

Кнопка переходу до створення прошивки

7. Виберіть базу прошивки. Для мікроконтролерів ESP32 це варіанти ESPHome або Custom. Докладніше про різницю між ними – у цій статті.

Після вибору відповідної бази прошивки (у прикладі використаний ESPHome) натисніть “Next”.

Вікно вибору базової прошивки

Скопіюйте код прошивки 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

Вікно налаштування прошивки пристрою

Після налаштування коду натисніть “Save”.

8. Після того, як був доданий код прошивки, на екрані налаштування продукту з'явилися дві нові кнопки "Build Firmware" - для тестової та серійної прошивки.

Посилання для збірки тестової та серійної прошивок

Прошивка тестового пристрою це прошивка для тестування прототипу. Серійна – фінальна версія прошивки, яка встановлюється на пристрої призначені для кінцевих користувачів.

Докладніше про різницю між двома цими варіантами – у попередній статті.

9. Натисніть першу кнопку "Build Firmware", щоб створити прошивку тестового пристрою.

Посилання для збірки тестової прошивки

10. Вкажіть параметри своєї Wi-Fi мережі та натисніть “Save”.

Зверніть увагу! Пристрої на основі мікроконтролера ESP32 підтримують лише Wi-Fi мережі з частотним діапазоном 2,4 ГГц!

Вікно додавання параметрів Wi-Fi мережі

11. Після завершення процесу збірки натисніть на посилання “Download”.

Посилання на готовий архів із прошивкою

12. Усередині завантаженого архіву буде файл readme.md із описом процесу прошивки пристрою. Прошийте його за інструкцією.

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

Зверніть увагу! Якщо на мікроконтролері вже записана прошивка, не забудьте видалити її згідно з інструкціями у файлі readme.md або відповідно до документації.

Зміст архіву з тестовою прошивкою

Процесс прошивки пристрою

13. Після прошивки поверніться до особистого кабінету на платформі – статус пристрою зміниться на “Ready”, індикатор статусу стане зеленим. Це означає, що пристрій успішно виявлено платформою.

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

Статус Ready, що говорить про успішне виявлення пристрою

14. Зверніть увагу на всі пункти колонки “Firmware” після підключення пристрою:

  • "Update firmware" – використовуйте посилання для внесення змін до коду прошивки. Після редагування не забудьте зібрати нові версії тестової та серійної прошивок.
  • "Firmware Settings" – вендор може ввести власний текст інструкції для користувачів замість того, що використовується у 2Smart Cloud за замовчуванням.
  • "Pairing support" – перемикач в "Firmware Settings". Відповідає за можливість додавання пристрою користувачами 2Smart Cloud за стандартною процедурою. Якщо увімкнено, пристрій можна додати до додатка за допомогою функції приєднання. Якщо вимкнено – користувач може знайти продукт у каталозі, але не запустить приєднання.
Коли може знадобитися вимкнення функції? Можливість існує для розробників, які створили особливу прошивку, яка не підтримує стандартне приєднання. У такому випадку користувачам можна запропонувати інструкцію з підключення пристрою іншими способами, наприклад, через вбудований інтерфейс пристрою.
  • "Connection info" – технічна інформація для даного продукту з можливістю швидкого копіювання кожного параметра конфігурації. Докладніше про всі параметри можна дізнатися у документації платформи.
  • "State Preview" – поточні дані всіх сенсорів тестового пристрою, підключеного до платформи.
  • "Clear device" – кнопка, при натисканні на яку інформація про стан тестового пристрою видаляється з платформи. Така можливість може знадобитися на етапі розробки та налагодження прошивки продукту.
  • "Device status" – індикатор підключення пристрою з тестовою прошивкою та його поточного стану. Дозволяє переконатися, що пристрій підключено, прошито актуальною версією прошивки та справно функціонує.

Всі пункти колонки

Створення мобільного додатка


1. Після виявлення системного пристрою з тестовою прошивкою можна створити мобільний додаток для керування пристроєм зі смартфона. Кнопка «Add layout» тепер активна, натисніть її.

посилання на створення мобільного додатка

2. Майстер налаштування мобільного додатка повністю відповідає тому, що використовується у візарді.

Вікно налаштування інтерфейсу мобільного додатка

Керувати пристроєм можна в процесі редагування інтерфейсу додатка. Пристрій миттєво реагує на перемикання віджета реле на екрані емулятора мобільного додатка. І навпаки – при натисканні на кнопку перемикання реле на платі в інтерфейсі емулятора мобільного додатка миттєво зміниться стан віджету.

3. Натисніть “Save” після завершення налаштувань додатка. Повернутися до редагування можна будь-якої миті – використовуйте посилання “Edit layout”.

Посилання для редагування інтерфейсу мобільних додатків

4. Тепер можна протестувати керування пристроєм зі смартфона. Скачайте додаток ( iOS | Android ), увійдіть з тим самим логіном і паролем, що й на платформу. Ваш пристрій вже знаходиться на екрані "Devices". Керуйте прототипом із додатка - за аналогією з тестуванням при додаванні пристрою через візард.

Збірка серійної прошивки та керування пристроєм зі смартфона


Використовуйте серійну прошивку для пристроїв, які будуть продавати кінцевим користувачам. Рекомендуємо залишити один прототип пристрою з тестовою прошивкою для зручного тестування нових можливостей або зміни інтерфейсу мобільного додатка.

1. Для збірки серійної прошивки натисніть відповідну кнопку “Build Firmware”.

Посилання для складання серійної прошивки

2. Дочекайтеся завершення процесу та натисніть посилання “Download”.

Посилання на готовий архів із серійною прошивкою

3. Прошийте пристрій аналогічно до того, як прошивали його тестовою версією.

Зверніть увагу! Якщо на мікроконтролері вже записана прошивка, не забудьте видалити її згідно з інструкціями у файлі readme.md або відповідно до документації.

4. Після збірки серійної прошивки активувалася кнопка «Publish» для вашого продукту. Натисніть її, щоб розмістити пристрій IoT в каталозі 2Smart Cloud.

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

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

Вікно підтвердження публікації товару

6. Після публікації з’явиться повідомлення “Published”, статус продукту зміниться з “Draft” на “Production”.

Сторінка продукту на панелі вендора зі статусом “Published”

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

Зверніть увагу, що продукт з'явиться у загальнодоступному каталозі лише після схвалення адміністраторами платформи. До цього додати пристрій можна тільки через приєднання, вибравши пункт “Others” в маркеті.

Прив'язка серійного пристрою до додатка 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