Якщо ви почали знайомство з платформою з цієї статті – рекомендуємо перейти в інструкцію для візарду, яка містить важливі деталі, пропущені в тексті нижче.
Збірка прототипу і реєстрація на платформі
Складання прототипу розумного Wi-Fi реле докладно описано у попередній статті. Для опису особливостей створення нового IoT пристрою на платформі без візарду буде використана та сама схема.
Також мається на увазі, що ви вже реєструвалися на самій платформі та спробували її функціонал у режимі демонстрації.
Створення прошивки
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 ГГц!
11. Після завершення процесу збірки натисніть на посилання “Download”.
12. Усередині завантаженого архіву буде файл readme.md із описом процесу прошивки пристрою. Прошийте його за інструкцією.
Прошивка можлива з пристроїв на Mac OS, Linux та Windows.
Зверніть увагу! Якщо на мікроконтролері вже записана прошивка, не забудьте видалити її згідно з інструкціями у файлі readme.md або відповідно до документації.
13. Після прошивки поверніться до особистого кабінету на платформі – статус пристрою зміниться на “Ready”, індикатор статусу стане зеленим. Це означає, що пристрій успішно виявлено платформою.
Іноді для виявлення пристрою системою потрібно відключити прошитий IoT пристрій від живлення та підключити його знову.
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”.
7. Після публікації продукту можна додати його в мобільний додаток 2Smart Cloud на своєму смартфоні та розпочати використання пристрою. Опублікований продукт зможуть додавати в додаток та ваші покупці.
Зверніть увагу, що продукт з'явиться у загальнодоступному каталозі лише після схвалення адміністраторами платформи. До цього додати пристрій можна тільки через приєднання, вибравши пункт “Others” в маркеті.
Прив'язка серійного пристрою до додатка 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/uk/blog
Всі статті про створення та підтримку IoT пристрою в 2Smart Cloud:
- Познайомся з IoT платформою – створи свій перший пристрій без мікроконтролера та керуй ним зі смартфона
- Як створити Wi-Fi реле з керуванням за допомогою мобільного додатка та Telegram-бота
- Як створити новий IoT пристрій всього за 4 кроки
- Як створити IoT пристрій на друкованій платі – від прототипу до реального продукту
- Як написати прошивку для IoT пристрою на базі SDK
- Як за 5 хвилин оновити прошивку і мобільний додаток готових пристроїв
- Збір та аналіз статистики – корисний інструмент для покращення продукту
