MicroHydra — це зручний лончер застосунків на MicroPython для ESP32-S3, створений спеціально під M5Stack Cardputer та сумісні пристрої. Завдяки простій структурі користувач може запускати, перемикати й видаляти апи без складних налаштувань, а також встановлювати їх прямо з microSD чи внутрішньої пам’яті. Система працює за принципом «один процес — одна апка», що мінімізує ризик збоїв і витоків пам’яті.
MicroHydra — це простий запуск програм на базі MicroPython з деякими функціями, подібними до ОС.
Цей код був зібраний за допомогою MicroPython версії 1.23 для ESP32-S3.
Головна функція MicroHydra полягає в наданні інтерфейсу для легкого перемикання між програмами MicroPython. А також у зниженні бар’єрів для входу для тих, хто хоче розробляти програми для свого Cardputer (або іншого підтримуваного пристрою!). Скрипти Python можна розмістити в папці /apps вашого пристрою (на флеш накопичувачі) або в папці /apps на карті micro SD. Програма запуску сканує ці два місця під час запуску.
Перегляньте вікі, щоб знайти основні посібники для початку роботи з застосунком MicroPython. А репозиторій спільнотних програм MicroHydra дивіться тут.
MicroHydra запускає лише один «додаток» одночасно та перемикається між ними, зберігаючи дані в пам’яті RTC та скидаючи MicroPython.
Програма запуску, main.py, та інші вбудовані програми імпортують hydra.loaderмодуль для зберігання або завантаження рядків у пам’ять RTC.
MicroPython автоматично запускається main.pyпід час запуску, main.pyшукає збережений шлях до програми та імпортує його, якщо він існує. В іншому випадку він запускає програму запуску.
Цей підхід було обрано для запобігання проблемам з керуванням пам’яттю або конфліктам імпорту між програмами. Скидання всього пристрою означає, що єдине, що завантажується перед програмою, це легковажний модуль hydra.loaderта main.pyмодулі.
Коли MicroHydra попередньо компілюється у файли .mpy (і тому не потребує компіляції перед запуском), це скидання відбувається досить швидко. А коли вона заморожена в прошивці MicroPython, скидання відбувається майже миттєво.
Програми, яким потрібно передавати інформацію одна одній, можуть використовувати той самий hydra.loaderмодуль для зчитування/зберігання додаткових аргументів у RTC.
Наприклад, коли ви використовуєте програму «Файли» для відкриття файлу в текстовому редакторі, програма «Файли» додає до пам’яті RTC як шлях до текстового редактора, так і шлях до текстового файлу.
Програми розроблені для дуже простої роботи в цьому лаунчері. Будь-який файл Python, розміщений у папці “apps” на флеш-накопичувачі або SD-карті, буде знайдено та його можна буде запустити як програму. Це також працює з файлами .mpy, тобто машинний код, написаний іншими мовами, також можна підключити та запустити як програму (хоча я ще не тестував це).
Програми MicroHydra можуть бути простими однофайловими скриптами або міститися в папці з розширенням __init__.py, як стандартний модуль Python. Ви можете дізнатися більше про ці особливості в розділі формату програм вікі.
Деякі спільні програми для MH можна знайти тут (і саме тут вбудований додаток “GetApps” знаходить програми для завантаження).
Ви можете встановити MicroHydra кількома різними способами.
Встановіть поверх звичайної інсталяції MicroPython: прошивіть Micropython на ваш Cardputer та скопіюйте вміст файлу
DEVICENAME_compiled.zip(абоDEVICENAME_raw.zip) з розділу “releases” на флеш-пам’ять на вашому пристрої.Це найзручніший спосіб встановлення для розробників, оскільки ви можете просто відкрити файли MicroHydra, щоб побачити, що відбувається. Однак,
rawверсія програмного забезпечення (тобто, що закінчується на “.py”) набагато більш схильна до проблем з пам’яттю, ніж інші методи встановлення, тому рекомендується використовувати скомпільовану (.mpy) версію для будь-яких файлів, з якими ви не працюєте безпосередньо.Прошивання MH як скомпільованої прошивки: Ви можете прошити MicroHydra (разом з MicroPython) безпосередньо на свій пристрій, використовуючи
DEVICENAME.binфайл з розділу «Релізи». (Ви також зазвичай можете знайти найновіші збірки на M5Burner). Це найшвидша та найпростіша у використанні форма MH!У цій установці файли MicroHydra були «заморожені» в прошивці MicroPython. Це значно пришвидшує завантаження вбудованих файлів і дозволяє їм використовувати менше пам’яті. Перед встановленням переконайтеся, що ви очистили флеш-пам’ять, а під час підключення переведіть пристрій у режим завантаження, утримуючи G0.
Примітка для розробників: Вміст src/необхідно обробити для виведення збірок MicroHydra, специфічних для пристрою. Щоб дізнатися більше, перегляньте цю сторінку вікі.
Це детальний посібник з встановлення MicroHydra на звичайну інсталяцію MicroPython за допомогою Thonny.
Thonny — це інструмент, який забезпечує дуже простий спосіб прошивки MicroPython, редагування коду та перегляду/редагування файлів на пристрої. Ви можете виконати інструкції, щоб встановити його тут: https://thonny.org/
Переконайтеся, що ви використовуєте нову версію; старіші версії можуть не прошити ESP32-S3. Деякі джерела Thonny (наприклад, деякі вбудовані менеджери пакетів) можуть призводити до дивних проблем із дозволами або відсутніми залежностями. Якщо під час налаштування thonny виникла проблема, і немає іншого чіткого рішення вашої проблеми, можливо, варто спробувати встановити його з іншого джерела.
Далі нам потрібно прошити MicroPython на вашому пристрої
Відкрийте Thonny, натисніть цю кнопку внизу праворуч і виберіть “Налаштувати інтерпретатор”:
Має відкритися таке меню:
натисніть “встановити або оновити micropython”, і ви побачите ще одне вікно:
Тепер вам потрібно перевести пристрій у режим завантажувача та підключити його до комп’ютера. Для цього просто утримуйте G0кнопку під час підключення до ПК.
Ви також можете утримувати G0та натискати кнопку скидання, щоб перейти в режим завантажувача. Якщо ви використовуєте пристрій, такий як TDeck, який не вмикається після підключення, вам потрібно утримувати g0та потім увімкнути вимикач живлення.
У розділі «цільовий порт» ви маєте побачити пристрій з назвою типу «USB JTAG». Встановіть параметри, як показано, та натисніть «Встановити»:
Для пристрою з Octal-SPIRAM (як-от TDeck) вам доведеться завантажити певний варіант Octal-SPIRAM з веб-сайту MicroPython. Якщо встановлення не розпочалося, перевірте, чи вибрано правильний пристрій, і чи він перебуває в режимі завантажувача.
Після прошивки за допомогою MicroPython від’єднайте пристрій від мережі та знову під’єднайте його. Thonny може не виявити його автоматично одразу. Якщо ні, ви можете вибрати його тут, внизу праворуч: Також, можливо, вам доведеться натиснути червону кнопку «зупинити/перезапустити» вгорі, щоб він з’явився.
Якщо ви бачите щось подібне в нижньому терміналі, ви успішно прошили його!
Тепер ви можете завантажити та встановити MicroHydra. Щоб отримати відповідні файли для вашого пристрою, вам слід перейти до розділу «Релізи» на сторінці GitHub та знайти DEVICENAME_compiled.zipфайл DEVICENAME_raw.zip.
Розпакуйте .zip-файл і поверніться до Thonny. Нам потрібно скористатися файловим браузером Thonny. Якщо ви не бачите його ліворуч, ви можете відкрити його, натиснувши «Вигляд» > «Файли» у верхньому лівому куті.
У верхній половині вікна перегляду файлів перейдіть до папки, куди ви розпакували zip-файл MicroHydra. Потім виберіть весь вміст і натиснітьUpload to /
Після передачі файлів ви можете перевірити його, відключивши та ввімкнувши. Якщо все працює, ви повинні побачити, як відкриється головне вікно запуску! Якщо у вас виникнуть будь-які проблеми, не соромтеся звертатися. MH все ще розвивається, і мені цікаво почути про будь-які проблеми, які він може вам створювати.
Це детальний посібник з прошивки MicroHydra на вашому пристрої за допомогою Thonny.
Thonny — це інструмент, який забезпечує дуже простий спосіб прошивки MicroPython, редагування коду та перегляду/редагування файлів на пристрої. Ви можете виконати інструкції, щоб встановити його тут: https://thonny.org/
Переконайтеся, що ви використовуєте нову версію; старіші версії можуть не прошити ESP32-S3. Деякі джерела Thonny (наприклад, деякі вбудовані менеджери пакетів) можуть призводити до дивних проблем із дозволами або відсутніми залежностями. Якщо під час налаштування thonny виникла проблема, і немає іншого чіткого рішення вашої проблеми, можливо, варто спробувати встановити його з іншого джерела.
Тепер ви можете завантажити та встановити MicroHydra. Щоб отримати відповідну прошивку для вашого пристрою, вам слід перейти до розділу «Релізи» на сторінці GitHub, знайти DEVICENAME.binфайл та завантажити його.
Відкрийте Thonny, натисніть цю кнопку внизу праворуч і виберіть “Налаштувати інтерпретатор”:
Має відкритися таке меню:
натисніть “встановити або оновити micropython”, і ви побачите ще одне вікно:
Тепер вам потрібно перевести пристрій у режим завантажувача та підключити його до комп’ютера. Для цього просто утримуйте G0кнопку під час підключення до ПК.
Ви також можете утримувати G0та натискати кнопку скидання, щоб перейти в режим завантажувача. Якщо ви використовуєте пристрій, такий як TDeck, який не вмикається після підключення, вам потрібно утримувати g0та потім увімкнути вимикач живлення.
Далі ми виберемо завантажений нами файл прошивки .bin. Натисніть маленьку кнопку меню та виберіть « Перейти до завантаженого файлу .bin» і виберіть його. Переконайтеся, що ви також вибрали свій пристрій у випадаючому списку «Цільовий порт» (він повинен мати назву типу «USB JTAG»).Select local MicroPython image ...
Ваше вікно має виглядати приблизно так:
Натисніть кнопку «Встановити» і нехай воно зробить свою справу! Якщо встановлення не розпочалося, перевірте, чи вибрано правильний пристрій, і чи він перебуває в режимі завантажувача. Після прошивки ви можете перевірити його роботу, відключивши та ввімкнувши. Якщо все працює, ви повинні побачити, як відкриється головне вікно запуску!
