Раздел

Прошивка

Прибор прошивается по USB. Основной способ — прямо из браузера: страница сама передаёт прибору готовый образ, командная строка и Python не нужны. Ниже — то же самое командой, для тех случаев, когда браузерная запись не подходит.

Из браузера

Браузер не поддерживает Web Serial. Откройте страницу в Chrome или Edge на компьютере. Страница открыта не по защищённому адресу: запись работает только по https или на localhost.

Образ: firmware/OBOD.bin.

Что нужно

Chrome или Edge на компьютере. Firefox, Safari и браузеры телефонов Web Serial не поддерживают — кнопки на них не будет.
Прибор подключён кабелем и виден системе как COM-порт.
Порт свободен: закройте монитор порта и всё остальное, что его держит.
Приём нот выключен. Если на странице OPTIONS включён MIDI IN, разъём отдан MIDI-интерфейсу и COM-порта нет: выключите приём, перезагрузите прибор — порт снова станет отладочным.

Командой

Другие способы

Из командной строки	`pwsh -File tools/idf.ps1 -p COM4 flash` — записывает загрузчик, таблицу разделов, данные OTA и приложение, каждое по своему адресу. Настройки и пресеты остаются на месте, менять формат разделов не нужно.
Только приложение	`idf.py -p COM4 app-flash` — когда загрузчик и таблица разделов уже на месте. Перезаписывает один раздел приложения, это заметно быстрее полной прошивки.
Склеенный образ	`esptool.py -p COM4 write_flash 0x0 tools/webflash/firmware/OBOD.bin` — один файл от нулевого адреса. Так пишет и браузерная страница: загрузчик, таблица разделов, данные OTA и приложение подряд. Настройки при этом стираются.
Свежий образ и своя страница	`pwsh -File tools/webflash/merge.ps1` склеивает четыре части в один файл и пересчитывает манифест, `pwsh -File tools/webflash/serve.ps1` поднимает страницу записи локально. Годится, когда браузерная прошивка нужна без выхода в сеть или на свежей сборке.
Журнал после прошивки	`pwsh -File tools/capture_boot.ps1 -Port COM4 -Seconds 18` — пишет загрузку в файл: видно версию, состояние пресетов, нагрузку и уровень батареи.

Что теряется

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

Хранение звука, слоты и то, как пресеты переживают смену прошивки, описаны на странице «Пресеты». Полное стирание при необходимости делается отдельно, командой esptool erase-flash.