Прошить аудиобейдж

Прошивка управляет записью, экраном и связью бейджа. Подготовленное устройство получает обновление по Wi-Fi. Через USB можно передать команду немедленного обновления; сам образ при этом тоже скачивается по сети.

Кто может: Участник испытаний с правом управления парком; для служебного экрана — разработчик
Где: Устройства → карточка бейджа → Прошивка
Заранее: Подготовленный бейдж, питание, настроенный Wi-Fi и доступная версия прошивки

Выбрать способ

Состояние бейджа	Что делать
Уже настроен и выходит на связь	Назначить обновление в парке
Работает, находится рядом и подключён к компьютеру	Запустить обновление через служебный экран
Новая плата, прошивки ещё нет	Первичная прошивка с командой испытаний
Не загружается или не выходит на связь после обновления	Проверить причину, затем согласовать восстановление

Подготовить бейдж

Завершите текущую запись и дождитесь отправки накопленного звука. Проверьте результат в «Очных записях».
Обеспечьте стабильное питание по схеме вашего опытного устройства. Во время установки не отключайте питание и не нажимайте сброс.
Проверьте Wi-Fi и доступность среды испытаний для самого бейджа. Подключения компьютера к интернету недостаточно.
Сверьте название устройства и текущую версию. Если версия неизвестна, сначала дождитесь связи или опросите устройство по кабелю.

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

Обновить по Wi-Fi

В среде испытаний откройте «Устройства» и карточку нужного бейджа.
Найдите блок «Прошивка». Сверьте установленную версию и версию в кнопке «Обновить до …».
Нажмите «Обновить до …». Платформа назначит целевую версию; установка начнётся, когда бейдж выйдет на связь.
Если бейдж спит, разбудите его кнопкой по инструкции для вашего прототипа. Оставьте его в зоне настроенного Wi-Fi.
Дождитесь скачивания и перезагрузки. В карточке должен появиться результат «Обновлено — новая прошивка вышла на связь» и новая версия.

Для этого способа USB-подключение к компьютеру не нужно. Устройство проверяет назначение при выходе на связь; во время сна оно обновления не получает. Назначенное сетевое обновление ждёт завершения записи и выгрузки, поэтому оставьте время на обслуживание после работы.

Что означают состояния

Состояние	Что происходит
Назначено / ждёт выхода на связь	Платформа сохранила цель, бейдж ещё не начал скачивание
Скачивание, процент	Бейдж получает образ по Wi-Fi; ход в парке обновляется автоматически
Перезагрузка	Образ записан, устройство запускается с новой прошивкой
Обновлено — новая прошивка вышла на связь	Платформа получила подтверждение новой версии
Прошивка не обновилась	Прочитайте причину в карточке и устраните её перед повтором

Дождитесь новой версии в карточке. Нажатая кнопка и даже 100 % скачивания ещё не подтверждают, что бейдж успешно запустился.

Запустить обновление через USB

Этот способ доступен на служебной странице «Тест устройства» (/audio-badge/device-test) в среде испытаний. Для неё нужен доступ разработчика. Обычному администратору компании достаточно обновления из парка.

Подключите бейдж к компьютеру кабелем с передачей данных. У текущего прототипа используйте служебный USB-разъём: второй разъём предназначен для работы микрофоном. Расположение уточните по схеме именно вашей платы.
Закройте другие вкладки и программы, занявшие последовательный порт. Откройте служебную страницу в браузере с поддержкой Web Serial, например Chrome или Edge на компьютере.
В шаге «Подключить плату кабелем» нажмите «Подключить», выберите порт платы в системном окне браузера. Дождитесь состояния «порт открыт».
Проверьте шаг «Подключить устройство к Wi-Fi». Если сеть ещё не настроена, нажмите «Найти сети», выберите доступную устройству сеть 2,4 ГГц, введите пароль и нажмите «Подключить к сети».
Проверьте шаг «Указать, куда отправлять записи». Адрес среды и ключ устройства должны быть настроены командой испытаний. Не заменяйте действующий ключ только ради обновления.
Раскройте «Прошивка устройства», сравните «На устройстве» и «На платформе», затем нажмите «Обновить сейчас».
Дождитесь скачивания по Wi-Fi и перезагрузки. Если кабельное соединение разорвалось при перезапуске, подключитесь снова и нажмите «Опросить устройство». Сверьте версию с назначенной.

Кнопка «Обновить без кабеля» на этом же экране назначает версию выбранному в реестре устройству. Она действует по тому же принципу, что обновление из парка.

Первая прошивка и восстановление

Новую плату сначала прошивает команда испытаний через служебный USB-порт средствами разработки. Для текущего прототипа используются проект прошивки badge-v0 и ESP-IDF. Кнопки обновления на платформе становятся полезны после этой подготовки.

Порядок обслуживания:

Уточнить ревизию платы и получить подходящую сборку у команды испытаний.
Подключить служебный порт и освободить его от монитора и других программ.
Записать согласованный комплект прошивки, включая необходимые загрузчик и таблицу разделов. Для устройства, которое уже обновлялось по Wi-Fi, отдельно учесть ранее выбранный раздел запуска.
Проверить запуск и версию, затем настроить сеть и привязку к среде испытаний.
Проверить связь с платформой и короткую запись с доставкой результата.

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

Обновить несколько бейджей

Над парком появляется полоса с доступной версией и кнопкой «Обновить все (N)». Подготовьте устройства, нажмите её и проверьте число бейджей и версию в подтверждении. Каждый получит обновление при своём выходе на связь.

Смотрите сводку «обновлено», «идёт», «ждут выхода на связь», «не обновились». Спящие бейджи нужно разбудить. Перед повтором откройте карточки устройств с ошибкой: повторная команда имеет смысл после устранения причины.

Если обновление не получилось

Что видно	Что проверить
Нет кнопки обновления	Право управления парком, известна ли текущая версия и есть ли более новая версия на платформе
«Образ не собран»	Попросить команду испытаний подготовить совместимую прошивку в этой среде
Долго ждёт связи	Питание, сон, настроенную сеть и завершение записи или выгрузки
«Порт занят»	Закрыть монитор прошивки и другие вкладки, затем подключиться снова
Не видно Wi-Fi	Сеть 2,4 ГГц, уровень сигнала; после запуска дать устройству подключиться и повторить поиск
«Нет сети» или не настроена отправка	Пройти шаги сети и подключения к среде испытаний до запуска обновления
Образ на платформе сменился	Сверить новую доступную версию и назначить обновление заново
Версия не установилась за три попытки	Проверить причину с командой испытаний, затем повторить назначение
После перезагрузки осталась прежняя версия	Возможен откат или неудачная установка; сохранить сообщение об ошибке и проверить устройство с командой

Автоматический откат зависит от прошивки и загрузчика конкретного прототипа. Его наличие не заменяет проверку результата.

Проверить после прошивки

Убедитесь, что бейдж снова на связи и сообщает нужную версию. Проверьте название и закрепление в парке. Сделайте короткую тестовую запись по согласованному сценарию, дождитесь её появления на платформе, прослушайте звук и откройте расшифровку. После этого устройство можно вернуть к испытаниям.