Яндекс Станция Миди, Станция 2, Лайт 2, Мини 2, Мини 3, Мини 3 Про и Мини первого поколения как локальный голосовой спутник и умная колонка для Home Assistant — без облака Яндекса.
| Модель | Кодовое имя | Статус | Данные о модели |
|---|---|---|---|
| Станция Миди | cucumber |
проверена мейнтейнером | станция мейнтейнера |
| Станция Лайт 2 | plum |
проверена мейнтейнером | станция мейнтейнера |
Станция Лайт 2, плата prune |
prune |
экспериментально, см. Лайт 2 на плате prune | контрибьютор: #57 |
| Станция 2 | station-midi |
экспериментально, см. Станция 2 | контрибьютор: #58 |
| Станция Мини 2 | station-mini2 |
экспериментально, см. Мини 2 | контрибьюторы: #9, станция из #38 |
| Станция Мини 3 | bergamot |
экспериментально, см. профиль | контрибьютор: #30 |
| Станция Мини 3 Про | pickle |
экспериментально, см. профиль | контрибьютор: #52 |
| Станция Мини | yandexmini |
по данным контрибьютора, см. Мини | контрибьютор: #35 |
Вместо штатного стека Яндекса (maind) на колонке работает небольшой нативный демон. Он говорит с
Home Assistant по протоколу ESPHome Native API и выглядит в HA как обычное ESPHome-устройство.
Для Music Assistant он дополнительно является нативным
Sendspin-плеером.
Железо колонки используется полностью и штатными средствами прошивки:
- «Алиса» / «Яндекс» — родная модель активационной фразы Яндекса и родное шумоподавление/эхоподавление (VQE) по микрофонам колонки (Миди — 4, Станция 2 — 4, Лайт 2 — 2, Мини 2 — 4, Мини 3 — 3, Мини 3 Про — 3, Мини — 4) с вычитанием звука собственных динамиков.
- Локальные голосовые команды — «стоп», «громче», «тише», «продолжи» и т. д. выполняются на самой колонке, без HA и без «Алиса» (родная модель команд Яндекса).
- Отвечает ближайшая колонка — если «Алису» услышали несколько колонок с pulsar, отвечает та, что услышала громче.
- Динамики — воспроизведение HTTP-потоков через GStreamer прошивки, громкость через ALSA.
- Светодиоды — панель или кольцо, часы, кнопки, переключатель микрофона, датчик освещённости — по моделям; у Мини нет части из них (см. Мини), у Станции 2 вместо кольца светодиодная панель 88 светодиодов (см. Станция 2).
- Zigbee (Миди, экспериментально) — встроенный Zigbee-модуль колонки на собственной прошивке pulsar работает полноценным координатором для Zigbee2MQTT и ZHA (как USB-стик ConBee) или роутером (ретранслятором) в существующей сети (см. Zigbee).
Ни одна проприетарная библиотека Яндекса в репозитории не распространяется: демон загружает их с самой колонки во время работы.
Проект не связан с Яндексом. Всё, что вы делаете с устройством, — на ваш страх и риск.
Если не указано иное, сущность есть на всех моделях. Часы (все сущности и действия clock_show_*)
есть у Миди, Лайт 2 на плате plum и Мини 3 Про, а у Мини 2 и Мини 3 — если панель найдена при
старте; у Мини, Лайт 2 на плате prune и Станции 2 часов нет. Датчик освещённости — у Миди, Лайт 2
на плате plum, Мини 3, Мини 3 Про и Станции 2, у Мини 2 — если найден при старте.
«Clock auto brightness» — при наличии часов и успешно открытого датчика. Аппаратный переключатель
микрофона — у Миди, Станции 2, Лайт 2, Мини 2, Мини 3 и Мини 3 Про. Что есть и чего нет у Мини — в
разделе Мини.
| Сущность | Что делает |
|---|---|
| Assist satellite | Голосовой ассистент: активационные фразы «Алиса» / «Яндекс», таймеры, объявления (assist_satellite.announce), продолжение диалога |
| Media player | Воспроизведение медиа и TTS, громкость, mute (полная тишина: музыка, ответы, объявления и звуки колонки); при обрыве сети поток переподключается (3 попытки) с того же места; виден в Music Assistant через провайдер «Home Assistant» |
| Switch «Microphones» | Микрофоны: включён — колонка слушает, выключен — нет (мут из HA или кнопкой на корпусе). Раньше сущность называлась «Mute microphones» с обратной полярностью. «Выключить» ставит мут из HA, «включить» снимает его, если мут кнопкой не активен. Если микрофоны выключены только из HA, кнопку мута нужно нажать два раза: первое нажатие включает мут кнопкой, второе выключает его и заодно снимает мут из HA (у Мини — см. Мини) |
| Switch «Clock display» | Часы на передней панели |
| Switch «Clock colon blink» | Мигание двоеточия при показе времени; по умолчанию включено. Выключено — двоеточие горит постоянно |
| Switch «Clock auto brightness» | Автояркость часов по датчику освещённости: в темноте часы гаснут почти полностью, на свету горят в полную силу. Выключено — часы светятся на уровне «Clock brightness» при любом свете |
| Switch «Clock spoken numbers» | Числа из ответа голосового ассистента на часах; по умолчанию выключен. Как показываются — ниже, после таймеров |
| Number «Clock brightness» | Яркость часов (при включённой автояркости — верхний предел, по датчику в темноте она падает; при выключенной — уровень как есть) |
| Text «Clock text» | Свой текст на часах (до 64 символов): латиница, цифры, приближённая кириллица; : зажигает двоеточие. До 4 знаков — по центру, длиннее — бегущая строка по кругу, пока текст не очищен |
| Select «Clock face» | Рожицы на часах (Smiley, Sad, OwO, >w< и др.) и анимации Blink / All faces; текст и рожица заменяют друг друга |
| Number «Clock text speed» | Скорость бегущей строки, мс на шаг (100–2000) |
| Select «Clock music» | Музыка на часах во время воспроизведения: Off (по умолчанию) / Levels — у каждой цифры свой уровень (нижний, средний, верхний сегмент) по двум соседним полосам спектра, в пределах того, как эти полосы менялись за последние секунды (так видны изменения, а не общий тембр песни); время периодически показывается. Заданные «Clock text» или «Clock face» скрывают «Clock music». Источник тот же, что у «Music visualization» |
| Select «Clock format» | Формат времени: 24h (по умолчанию) / 12h — часы 1–12 без ведущего нуля, полночь и полдень — 12:00. Отметки AM/PM нет ни на одной модели: светодиода, который подошёл бы для неё на всех панелях, нет |
Actions clock_show_text / clock_show_face |
esphome.<устройство>_clock_show_text (text, seconds) и …_clock_show_face (face, seconds): временно показать текст или рожицу поверх «Clock text» / «Clock face»; seconds ≤ 0 — один проход строки или 5 с, максимум 3600; пустое значение убирает показ |
| Light «Ring» / «Panel» | Кольцо как обычная лампа: цвет, яркость, плавные переходы (transition, до 60 с), эффекты Rainbow, Breathe, Color loop, Comet, Twinkle, Fire, Aurora, Lava lamp, Candle, Night light — одинаковые на всех моделях с кольцом (на Миди лента из 24 светодиодов, на Мини 3 Про — 16, на Лайт 2 — 3, у Мини 2, Мини 3 и Мини — 6); если есть датчик освещённости, в темноте кольцо и логотип приглушаются. У Станции 2 вместо кольца LED-панель: сущность называется «Panel», а список эффектов свой — Radar, Ripple, Rain, Matrix, Plasma, Waves, Spiral, Heartbeat |
| Select «Music visualization» | Светомузыка во время воспроизведения: Off / All styles (по умолчанию: Spectrum → Pulse → Disco → Polar по кругу) / Spectrum / Pulse / Disco / Polar. Источник — визуализатор Sendspin (Music Assistant), если сервер его присылает, иначе спектр звука, который играет сама колонка. Включённая лампа («Ring» или «Panel») важнее светомузыки |
| Number «LED speed» | Скорость эффектов и светомузыки, 0,25–4× |
| Number «Follow-up duration» | Сколько ждать начала следующей реплики, если после ответа HA продолжает разговор: 0–10 с, по умолчанию 10; 0 — не слушать продолжение |
| Number «Command start offset» | Команда, сказанная сразу после активационной фразы, без паузы («Алиса который час»), не теряет начало: в запрос идёт и звук сразу после фразы, начиная с точки, где колонка её распознала, со сдвигом на это число мс: −100…200, по умолчанию 0. Если в тексте запроса появляется хвост фразы («Так, включи свет»), сдвиньте вправо на 10–20; если теряется начало команды («Закрой» вместо «Открой») — влево. Сдвиг вправо больше, чем колонка тратит на подтверждение фразы (обычно 150–250 мс), уже ничего не меняет: запрос начинается с момента подтверждения. Сохраняется между перезапусками. Заменяет прежний переключатель «Command right after wake word»; если после обновления он остался в HA недоступным, его можно удалить |
| Number «Microphone gain» | Усиление голоса перед отправкой в Home Assistant: 0–40 дБ, по умолчанию 0 — без усиления (на распознавание идёт тот же канал, что берёт штатная прошивка). Прибавьте, если ваш распознаватель плохо разбирает тихую речь; слишком большое усиление перегружает звук и портит распознавание. На срабатывание активационной фразы не влияет. Сохраняется между перезапусками |
| Switch «Voice indication» | Показывать на кольце (панели) и часах «слушает / думает / отвечает» (ошибка и звонок таймера видны всегда) |
| Switch «Wake sound» | Звук начала прослушивания после активационной фразы и по кнопке действия; по умолчанию включён. Если выключить и его, и «Voice indication», колонка начинает слушать без звука и без индикации |
| Select «Case color» | Коррекция цвета под ткань корпуса (матрицы штатной прошивки из /system/vendor/quasar/ledconfigs); None — без коррекции; если матриц нет (у Мини и Станции 2 их нет, на некоторых прошивках Мини 2 каталог пуст), сущность не публикуется — на любой модели |
Action led_show |
esphome.<устройство>_led_show (effect, color, seconds): временно показать эффект (или сплошной цвет при пустом effect) цветом #RRGGBB (пусто — белый) на полной яркости поверх лампы и светомузыки; временные сигналы колонки (громкость, ассистент, таймер, краткий сигнал переключения микрофонов) идут поверх показа; seconds ≤ 0 — 5 с, максимум 3600; пустые effect и color снимают показ |
| Binary sensor «Hardware mic mute» | Аппаратный переключатель микрофонов на корпусе (нет у Мини) |
| Sensor «Illuminance» | Датчик освещённости, лк |
| Event «Button» | Для автоматизаций: volume_up, volume_down, action, action_long (нет у Мини) |
| Button «Restart» | Перезапуск демона на колонке |
| Update «Firmware» | Новая версия pulsar из GitHub Releases: «Установить» в HA (см. Обновление из Home Assistant) |
| Switch «Auto update» | Ставить новые версии автоматически (по умолчанию выключен) |
| Switch «Nearest station answers» | Отвечает ближайшая колонка (по умолчанию включён, см. Несколько колонок) |
| Диагностика | «Wi-Fi signal» (дБм), «Uptime», «IP address», «Version» |
Часовой пояс для часов берётся из Home Assistant. Журнал демона виден в HA (журналы устройства ESPHome). К колонке могут одновременно подключаться несколько клиентов (до 4), например HA и ESPHome Dashboard; голосовой конвейер обслуживает последний подписавшийся на него клиент, а когда тот отключается или отписывается — снова предыдущий (обычно HA).
«Follow-up duration» сохраняется между перезапусками. Отсчёт идёт с момента, когда HA начал слушать продолжение; если вы заговорили, ожидание снимается и реплика не обрывается. Если ответа нет, разговор заканчивается тихо, без ошибки на кольце. Ограничение по времени работает, когда начало речи определяет сам HA; с распознавателем, который сам определяет конец фразы (например, HA Cloud STT v2 из Labs), настройка только включает или выключает продолжение. 0 закрывает и уже открытое ожидание.
Таймеры: на часах обратный отсчёт ближайшего из запущенных таймеров (если все на паузе —
таймера с наименьшим остатком); он показывается вместо clock_show_*, «Clock text» и «Clock face»,
а короткие анимации (пауза, смена трека) ненадолго перекрывают отсчёт.
Если HA не продвигает диалог (30 с прослушивания или 120 с обработки без событий), колонка сама
завершает его и показывает ошибку на кольце.
Приоритет на часах: код сопряжения > громкость при нажатии кнопок > звонок таймера >
число из ответа > голосовой ассистент > установка обновления (часы гаснут) > анимации запуска
и паузы / переключения трека > таймер > clock_show_* > «Clock text» / «Clock face» >
«Clock music» > время.
Числа из ответа ассистента показываются, только если включён «Clock spoken numbers» (по
умолчанию выключен). Двузначные числа чередуются: первое слева, второе справа, третье слева.
Каждое держится минимум 3 с; длинное число успевает прокрутиться целиком. Числа показываются по
порядку после запуска воспроизведения ответа; поздний текст начинает показ с первого числа.
Точной синхронизации со словами нет. После конца ответа оставшиеся числа продолжают показ, в
том числе когда продолжение разговора кончается без новой реплики; отмена и новый диалог
убирают их, новый ответ заменяет. Если текста нет, чисел нет. Поддерживаются цифры, русские
числительные до 99 и время (ЧЧ:ММ, в формате «Clock format»). Источник текста —
голосовой ассистент HA.
Текст и рожица на часах не сохраняются между перезапусками (после перезапуска — время), скорость, «Clock music», «Clock format» и «Clock spoken numbers» сохраняются. Выключатель «Clock display» гасит всё, кроме кода сопряжения Sendspin.
- Кнопка действия: короткое нажатие — начать диалог без активационной фразы; пока станция слушает или ждёт ответа — отменить диалог; во время ответа — прервать его; при звонке таймера — выключить. Долгое нажатие только отправляет событие в HA.
- Громкость +/−: шаг 5 % (с промежуточной громкости — до ближайшей ступени), уровень
показывается на кольце и на часах (если они есть), звучит штатный щелчок; тот же щелчок у
«громче» / «тише». Щелчка нет, когда уровень не изменился (0 % или 100 %), пока станция слушает
или отвечает, во время объявления и звонка таймера, а также при изменении громкости из HA или
Music Assistant. На Миди, Лайт 2 на плате
plum, Мини 2, Мини 3 и Станции 2 шкала громкости та же, что у штатной прошивки: 5 % — одна её ступень, 10 % в HA соответствует «1» у Алисы (у Мини — см. Мини). - Кольцо (у Станции 2 — панель): анимации в стиле штатной Алисы (те же цвета и ритм,
нарисованы заново): слушает, думает, отвечает, ошибка, звонок таймера, запуск таймера (зелёные
точки гаснут за 15 с), громкость. Отключение микрофонов: на Миди и Мини 3 Про — красная волна по
ленте и красный логотип, на Лайт 2, Мини 2 и Мини 3 — вспышка и ровный тусклый красный, на Мини —
красное кольцо, на Станции 2 — красная волна по панели и ровный тусклый красный; у всех моделей,
кроме Миди и Мини 3 Про, этот красный перекрывает лампу («Ring» или «Panel») и светомузыку, но
уступает временным сигналам колонки (громкость, ассистент, таймер,
led_show). Красная вспышка после «Алиса» значит, что голосовой ассистент HA не подписан на колонку (HA не подключён или ассистент не выбран). - Часы (Миди, Лайт 2 на плате
plum, Мини 3 Про; у Мини 2 и Мини 3 — если панель найдена при старте): анимации штатной прошивки Лайт 2 (нарисованы заново, одинаковые на этих моделях): «глаза» при запуске демона, слушает / думает / отвечает (с «Voice indication»), звонок таймера, «||» при паузе (голосом или из HA) и бегущие столбики при «дальше» / «назад». Средняя точка между точками двоеточия есть на Лайт 2 на платеplum, Мини 3 и Мини 3 Про.
Модель команд слушает всегда, как на стоке: в тишине, на паузе, во время музыки, ответа ассистента, объявления и звонка таймера. Пока вы говорите с HA и пока он думает, все команды действуют только первые 2,5 с после «Алиса» («Алиса, громче»), чтобы слова запроса не срабатывали как команды. После этого окна, а также с самого начала диалога по кнопке, из HA или в продолжении диалога действуют только «стоп» и «хватит»: они отменяют диалог, как короткое нажатие кнопки (ответа не будет, музыка играет дальше). Если звонит таймер, слово выключает только звонок: запрос с другими словами уходит в HA, а фразу из одних стоп-слов затем отменяет проверка текста (ниже). Если HA уже распознал запрос и начал его выполнять, сделанное не откатывается. Эти слова внутри самого запроса («хватит ли бензина») тоже могут его отменить. Без «Алиса» колонки не договариваются, кто выполняет команду, поэтому каждая выполняет только своё: «стоп» и «хватит» — везде; «громче» и «тише» — если колонка звучит (музыка, ответ, объявление, таймер) или её музыка на паузе; «пауза», «продолжи», «дальше», «назад» — только для своей музыки. Музыка на паузе (или остановленная в Music Assistant) остаётся своей 2 часа.
Во время диалога pulsar также проверяет готовый текст распознавания HA, так что «стоп» действует, даже если модель команд его пропустила. Проверка принимает только стоп-слова без других слов запроса, в том числе повтор («стоп, стоп»). Она выключает звонок таймера и отменяет диалог, как короткое нажатие кнопки; музыку на паузу не ставит, поэтому «Алиса, стоп», пропущенное моделью команд, для паузы нужно повторить.
| Фраза | Действие |
|---|---|
| стоп / хватит | выключить звонок таймера, иначе отменить диалог или прервать ответ, иначе пауза музыки («Алиса, стоп» отменяет запрос и ставит музыку на паузу) |
| пауза | пауза |
| продолжи / играй | продолжить воспроизведение |
| громче / тише | громкость на деление шкалы Алисы (10 %) вверх / вниз; с промежуточной громкости — до ближайшего деления |
| дальше / следующий, назад | следующий / предыдущий трек (Sendspin) |
Колонки с pulsar в одной сети договариваются, кто ответит: услышав активационную фразу, каждая сообщает соседям по сети, насколько громко её услышала, и коротко ждёт ответов. Отвечает колонка, которая услышала фразу громче, то есть обычно ближайшая; колонка, которая в этот момент отвечает, читает объявление или звонит таймером, своё слово не уступает. На остальных кольцо мигает и гаснет, звука нет, «Алиса, громче» меняет громкость только у ответившей. Звук сигнала активации из-за ожидания запаздывает на доли секунды; сказанное сразу после «Алиса» не теряется.
С выключенным «Nearest station answers» (или если пакеты не доходят: точка доступа режет широковещательный трафик, колонки в разных подсетях) отвечает та, чей запрос первым дошёл до HA: остальные HA отклоняет как повтор, и они молча гаснут. Другие голосовые спутники (Voice PE и т. п.) в договорённости не участвуют.
Колонка:
- Яндекс Станция Миди, Станция 2, Лайт 2, Мини 2, Мини 3, Мини 3 Про или Мини первого поколения с
root-доступом по adb:
adb shellот root, по сети или USB. Сам рут в этот проект не входит. - Прошивки: на Миди (
0.351.1.6.4197281754.20260528.142) и Лайт 2 на платеplum(0.369.1.46.4778258659.20261013.133) работа проверена мейнтейнером. Данные контрибьюторов: Мини 2 — прошивка0.369.1.46.4778262943.20261013.299, Мини 3 —0.369.1.50.4794652521.20261021.117, Мини (платаaxg_s420_v03) —1.369.4.24.4711907614.20260928, Лайт 2 на платеprune—0.369.1.50.4794654278.20261021.133, Станция 2 —0.369.1.46.4793639783.20261020.295; Мини 3 Про — прошивка не указана.
Компьютер: Windows, macOS или Linux в той же сети, что и колонка. Ставить ничего не нужно:
установщик сам скачает adb, если его нет (см. Установка).
Home Assistant 2025.x или новее с интеграцией ESPHome и настроенным конвейером Assist (STT/TTS с поддержкой русского).
Скачайте архив для своего компьютера из
последнего релиза, распакуйте и запустите
pulsar-install.
| Компьютер | Архив |
|---|---|
| Windows | pulsar-windows-amd64.zip |
| macOS (Apple Silicon) | pulsar-macos-arm64.tar.gz |
| macOS (Intel) | pulsar-macos-amd64.tar.gz |
| Linux x86-64 | pulsar-linux-amd64.tar.gz |
| Linux ARM64 (например, Raspberry Pi) | pulsar-linux-arm64.tar.gz |
Linux и macOS (подставьте имя своего архива):
curl -fLO https://github.com/Morvex885/pulsar/releases/latest/download/pulsar-linux-amd64.tar.gz
tar -xzf pulsar-linux-amd64.tar.gz && cd pulsar
./pulsar-install # найти колонки в сети и выбрать, куда ставить
./pulsar-install 192.168.1.50 # или сразу по адресу
./pulsar-install --list # только показать найденноеWindows (PowerShell или командная строка):
curl.exe -fLO https://github.com/Morvex885/pulsar/releases/latest/download/pulsar-windows-amd64.zip
tar -xf pulsar-windows-amd64.zip
cd pulsar
.\pulsar-install.exeМожно и распаковать архив в Проводнике и запустить pulsar-install.exe двойным щелчком (см.
Windows и macOS).
В архиве уже собраны программы для всех поддерживаемых моделей колонок и dropbear, рядом лежат служебные скрипты.
Установщику нужен adb. Если его нет в PATH, при первом запуске установщик скачивает Android
SDK Platform-Tools с dl.google.com (условия Google) в каталог platform-tools рядом с собой. Для
Linux ARM64 Google их не собирает — поставьте adb сами (sudo apt install adb).
Без адреса установщик находит Станции через mDNS (и штатные, и уже переведённые на pulsar). Затем он подключается к ним по adb, определяет модель и показывает список. Поддерживаемые колонки с root-доступом пронумерованы. Остальные (другие модели, adb без root) перечислены с причиной пропуска.
Если колонка не находится, --scan ищет открытый adb (порт 5555) по всей подсети /24. Тогда
другие Android-устройства в сети могут показать запрос «Разрешить отладку?» — его можно отклонить.
Установщик из копии репозитория сначала собирает программу: нужны инструменты сборки (см. docs/development.md, «Сборка»). Затем на каждую выбранную колонку он:
- копирует демон и служебные скрипты в
/data/pulsar; если бинарник изменился, прежний сохраняется как.prev(тот же бинарник не копируется и.prevне трогает); - записывает скрипт автозапуска
/etc/init.d/S99zpulsar. При загрузке система выполняет его после скрипта Яндекса; он запускает/data/pulsar/boot.shи dropbear, если тот установлен. Для записи корневая ФС на несколько секунд перемонтируется на запись и сразу возвращается в режим только для чтения; если файл уже актуален, ничего не перемонтируется. Если корневая ФС защищена (dm-verity, device-mapper) или/etcлежит не на ней, скрипт не записывается: установщик сообщает причину и в конце пишет, что после перезагрузки pulsar сам не запустится; - если прежняя версия добавляла строки автозапуска в
/data/quasar/rootkeeper.sh, удаляет ровно эти строки (резервная копияrootkeeper.sh.bak-<время>); остальное содержимое файла не меняется; - останавливает стек Яндекса и запускает демон; через ~10 с и ещё раз через ~30 с проверяет по журналу, что он поднялся и не падал, и при неудаче предлагает вернуть прежний бинарник.
Вне /data установщик пишет только /etc/init.d/S99zpulsar, больше системный раздел не трогается.
Повторный запуск обновляет установленную версию. --yes ставит на все найденные колонки без
вопросов, --no-enable не останавливает стек Яндекса и не запускает демон (шаг 4).
Дальше в Home Assistant: Настройки → Устройства и службы. Колонка обнаружится сама как
ESPHome-устройство yandex-midi-xxxxxx, yandex-station2-xxxxxx, yandex-lite2-xxxxxx,
yandex-mini2-xxxxxx, yandex-mini3-xxxxxx, yandex-mini3pro-xxxxxx или yandex-mini-xxxxxx.
Если не обнаружилась, добавьте интеграцию ESPHome вручную с IP колонки и портом 6053; ключ
шифрования HA создаст сам (см. Шифрование API). В настройках устройства
выберите конвейер Assist и активационную фразу.
./pulsar-install --ssh # дополнительно поставит dropbearУстанавливает dropbear в /data/dropbear на порт 22. Вход под root с пустым паролем (-B).
Ставьте только в доверенной сети или поменяйте флаги в ssh/start.sh.
Установщик для Windows и macOS пока не проверен на реальных компьютерах. Если что-то не работает, напишите в issues.
- Windows.
pulsar-install.exe— консольная программа: если запустить её двойным щелчком, окно в конце ждёт Enter, чтобы можно было прочитать вывод. Архив, скачанный браузером и распакованный в Проводнике, может вызвать SmartScreen: «Система Windows защитила ваш компьютер» → «Подробнее» → «Выполнить в любом случае»; у архива, скачанного черезcurl.exeи распакованногоtar, как в разделе Установка, такой пометки нет. Еслиadbуже есть вPATH(например, из Android Studio), используется он. Подключение колонки по USB не описано: используйте adb по сети. - macOS. Скачивайте архив через
curl, как в разделе Установка. Для архива, уже скачанного браузером:xattr -dr com.apple.quarantine pulsar. Если поиск ничего не находит или adb пишет «No route to host», разрешите терминалу доступ к локальной сети: «Системные настройки» → «Конфиденциальность и безопасность» → «Локальная сеть». Сборка демона на macOS не поддерживается — используйте архив.
Колонка сама проверяет релизы через минуту после
запуска и затем каждые 6 часов; проверить сразу — «Проверить наличие обновлений» в HA
(homeassistant.update_entity). Учитываются только стабильные релизы (не пре-релизы). Когда
выходит новая версия, сущность «Firmware» в HA показывает её со ссылкой на релиз; кнопка
«Установить» ставит её. Колонка скачивает pulsar-<arch>.bin по HTTPS (сертификат проверяется),
сверяет с SHA256SUMS релиза и проверяет, что программа запускается на этой колонке и сообщает
нужную версию. Только после этого она заменяет бинарник (прежний остаётся как .prev) и
перезапускается — разговор или музыка в этот момент прервутся. Пока идёт установка, часы
погашены; если установка не удалась, они снова показывают время.
С включённым переключателем «Auto update» колонка ставит новую версию сама, дождавшись тишины (нет диалога, музыки, объявления или звонка таймера). Если новая версия не запустится, через автоматический откат (см. ниже) вернётся прежняя, и эту версию автообновление больше не будет ставить; вручную её поставить можно.
Сборки не из релиза (версия — хеш коммита, например 1fa4934) обновление тоже видит, но
автоматически не обновляются: только кнопкой. Обновляется демон (на Миди — и образы Zigbee-модуля);
boot.sh, supervise.sh и ctl.sh обновляет установщик.
Если демон 5 раз подряд падает, не проработав 5 минут, вместо него ставится .prev (сломанный
бинарник сохраняется как .bad); если падает и он — колонка возвращается стеку Яндекса, как после
ctl.sh disable. Перезапуск кнопкой «Restart» в HA или через ctl.sh restart падением не
считается, если демон до этого проработал хотя бы 5 с.
Откат на предыдущую версию вручную:
cd /data/pulsar && mv pulsar.prev pulsar && ./ctl.sh restartВернуть стек Яндекса, удалить /data/pulsar и скрипт автозапуска (корневую ФС нужно ненадолго
перемонтировать на запись):
/data/pulsar/ctl.sh disable
rm -rf /data/pulsar
mount -o remount,rw / && rm -f /etc/init.d/S99zpulsar; mount -o remount,ro /Music Assistant с поддержкой Sendspin находит колонку сам: плеер «Яндекс Станция Миди», «Яндекс Станция 2», «Яндекс Станция Лайт 2», «Яндекс Станция Мини 2», «Яндекс Станция Мини 3», «Яндекс Станция Мини 3 Про» или «Яндекс Станция Мини» с типом Sendspin. Музыка идёт без потерь (FLAC), громкость и голосовые команды колонки управляют плеером MA. Синхронное воспроизведение в группах с другими Sendspin-плеерами заложено протоколом, но пока не проверялось. Задержку вывода задают в настройках Sendspin-плеера в Music Assistant; MA хранит её сам и присылает при каждом подключении. Для Миди прошивка Яндекса использует поправку около 22 мс (не измерено) — можно начать с неё.
По умолчанию колонка принимает Sendspin-подключения без сопряжения. Чтобы требовать сопряжение:
adb shell 'echo 0 > /data/pulsar/sendspin/unpaired_access'
adb shell /data/pulsar/ctl.sh restartПосле этого при запросе сопряжения на часах появляется «----»: нажмите кнопку действия, и колонка
покажет код сопряжения. У Мини часов и кнопки действия нет: код сопряжения пишется в журнал
(/data/pulsar/ctl.sh log).
Экспериментально. Проверено на одной Миди: координатор в Zigbee2MQTT (zigbee-herdsman) и ZHA (zigpy) — создание сети с параметрами из их конфига, перезапуски без пересоздания, сканирование эфира, подключение кнопки Aqara (интервью, нажатия, обновление прошивки модуля без потери сети); роутер в сети Zigbee2MQTT. Перенос живой сети со стика и большие сети ещё не проверялись.
В Миди есть Zigbee-модуль, на котором работает весь стек Zigbee; сеть (PAN ID, ключи,
подключённые устройства) хранится в его собственной флеш-памяти. pulsar ставит в модуль свою
прошивку (собирается из radio/ на открытом Telink Zigbee SDK и устанавливается рядом с
демоном). Роль выбирается в HA (сущность «Zigbee role»):
- Off (по умолчанию) — pulsar модуль не трогает.
- Coordinator — сетевой координатор для Zigbee2MQTT и ZHA, как USB-стик ConBee: колонку указывают в их настройках, дальше всё управление (сопряжение, устройства, группы, бэкапы) — из их интерфейса. Параметры сети (PAN ID, расширенный PAN ID, ключ, канал, IEEE-адрес координатора) задаёт Zigbee2MQTT или ZHA.
- Router — колонка становится роутером (ретранслятором) в чужой сети, как любое Zigbee-устройство с питанием от сети: например, в сети Zigbee2MQTT с USB-стиком. Порт 6638 в этой роли закрыт.
При выборе роли pulsar перезапускается и, если в модуле не та прошивка, записывает нужную через
загрузчик модуля (20–30 секунд; ход виден в сенсоре «Zigbee»; перезапуск и обновление из HA в это
время не выполняются). Каждая прошивка хранит свою сеть в своей области флеш-памяти, поэтому сети
обеих ролей переживают переключение туда и обратно; сеть, которую создал Яндекс, тоже остаётся в
модуле, и прошивка Яндекса вернётся сама, если включить родной стек (ctl.sh disable). Если
обновление pulsar принесло новую сборку прошивки текущей роли, она записывается в модуль сама при
первом запуске (сеть сохраняется). Если запись прервалась (например, отключилось питание), pulsar
при следующем запуске запишет прошивку заново. Прошивка, которую модуль не принял, повторно не
записывается до смены роли или следующего обновления.
pulsar отдаёт модуль по протоколу deCONZ (ConBee/RaspBee) на TCP-порту 6638:
- Zigbee2MQTT:
При первом запуске Zigbee2MQTT создаёт в модуле сеть со своими
serial: port: tcp://<IP колонки>:6638 adapter: deconz
pan_id,ext_pan_id,network_keyи каналом; дальше перезапуски сеть не трогают. Чтобы перенести сеть с другого адаптера (например, USB-стика), оставьте в конфиге те жеpan_id,ext_pan_id,network_keyи канал и файлcoordinator_backup.json: Zigbee2MQTT запишет в модуль IEEE-адрес и счётчик кадров из резервной копии, и устройства должны остаться в сети (на живой сети не проверено). Индивидуальные ключи устройств Zigbee 3.0, выданные старым адаптером, не переносятся: такое устройство работает дальше, но если оно потеряет сеть (смена канала, долгое отключение), его придётся подключить заново. Старый адаптер после переноса отключите — два координатора с одной сетью мешают друг другу. - ZHA находит его сам (mDNS
_zigbee-coordinator._tcp): «Настройки → Устройства и службы» покажет найденный Zigbee-координатор «Яндекс Станция Миди». Вручную: ZHA → тип радио deCONZ, путьsocket://<IP колонки>:6638.
Одновременно работает один клиент: новое подключение вытесняет старое. Порт 6638 открыт без авторизации (как у сетевых координаторов вообще): любой в локальной сети может подключиться, вытеснить HA, открыть сеть для подключения, управлять устройствами или стереть сеть.
Ограничения: ключи устройств только по общему ключу ZigBeeAlliance09 (install code не поддерживается), таблицы соседей и маршрутов самого координатора не отдаются (карта сети строится по роутерам), Green Power (кнопки без батареек) не поддерживается.
Подключение к сети в роли Router:
- В Zigbee2MQTT (или ZHA) разрешите подключение устройств («Permit join»).
- В HA нажмите кнопку «Zigbee join network» у колонки. Модуль ищет открытую сеть на всех каналах; через несколько секунд колонка появится в Zigbee2MQTT как роутер, а сенсор «Zigbee» покажет «router: in network …».
- Кнопка «Zigbee leave network» выводит колонку из сети (координатор получает Leave).
В роли роутера колонка подключается к первой найденной открытой сети: держите подключение открытым только в своей сети.
На колонке (adb shell или ssh):
/data/pulsar/ctl.sh status # кто сейчас работает: демон или стек Яндекса
/data/pulsar/ctl.sh log 100 # журнал (/tmp/pulsar.log)
/data/pulsar/ctl.sh restart
/data/pulsar/ctl.sh reload # перезапустить и надзорный скрипт (после обновления supervise.sh)
/data/pulsar/ctl.sh api-key # задан ли ключ шифрования API (сам ключ не выводится); см. ниже
/data/pulsar/ctl.sh disable # вернуть стек Яндекса, в том числе после перезагрузки
/data/pulsar/ctl.sh enable
/data/pulsar/pulsar --versionЖурнал лежит в /tmp (обнуляется при перезагрузке) и ротируется при 1 МБ.
Настройки (громкость, свет, часы, активационная фраза, часовой пояс, автообновление) хранятся в
/data/pulsar/state.conf; после отката на .prev колонка читает тот же файл и играет так же
громко.
Колонка поддерживает шифрование ESPHome API (Noise), как обычные ESPHome-устройства. Пока ключа
нет, API работает без шифрования, и свежий Home Assistant при подключении сам создаёт ключ и
записывает его на колонку (/data/pulsar/api_key); дальше соединение шифруется.
Задать ключ вручную (base64 от 32 байт, как в ESPHome) или убрать его:
/data/pulsar/ctl.sh api-key <base64> # задать ключ, демон перезапустится; затем ввести его в HA
/data/pulsar/ctl.sh api-key clear # удалить ключ, демон перезапуститсяПосле смены или удаления ключа вручную HA попросит переавторизовать устройство. Внимание:
версии демона без поддержки шифрования (и откат на такую через .prev) не смогут общаться с HA,
который уже хранит ключ: удалите ключ в настройках устройства в HA или удалите и заново добавьте
устройство.
Данные контрибьютора (#57); pulsar на этой плате
ещё не запускался. Прошивка (deviceType plum), звуковой тракт и кольцо те же, что у Лайт 2 на
плате plum; часов и датчика освещённости нет, поэтому нет и сущностей часов и «Illuminance».
Установщик определяет колонку как Yandex Station Lite 2 (prune), в HA она называется
yandex-lite2-xxxxxx. Что проверено, а что нет — в
docs/lite2.md.
Данные контрибьютора (#58); что проверено, а что нет, — в docs/station2.md. Установщик ставит armhf-сборку: ядро на колонке 64-битное, пользовательский режим 32-битный.
- Вместо кольца — LED-панель из 88 светодиодов: лампа называется «Panel», эффекты у неё свои (см. Что появляется в Home Assistant).
- Часов нет; датчик освещённости, аппаратный переключатель микрофонов, кнопка действия и кнопки громкости есть.
- Кодовое имя в device-tree —
station-midi: это внутреннее имя Станции 2, а не розничной «Станции Миди» (у неёcucumber). - Zigbee не поддерживается: радио этой модели устроено иначе, чем у Миди.
Установщик ставит armhf-сборку: ядро на колонке 64-битное, пользовательский режим 32-битный.
- Голосовой сценарий с HA, воспроизведение (включая Sendspin), кольцо из 6 светодиодов, кнопки и отключение микрофонов проверены на ранней версии демона (#9). Логотипа и Zigbee нет.
- Качество распознавания не измерялось: своих моделей спотера у Мини 2 нет, используются модели Лайт 2.
- Часы и датчик освещённости есть не на всех колонках: на колонке из #9 (прошивка 0.369) их нет — вероятно, это вариант без часов: по вики Мини 2 продаётся с часами и без; на колонке из #38 (0.372) есть. Подстройка яркости по датчику на Мини 2 пока не проверялась.
Экспериментальный профиль: что проверено, а что нет — в docs/mini3.md. Датчик освещённости есть; часы — если панель найдена при старте.
Экспериментальный профиль по данным контрибьютора (#52): что проверено, а что нет — в docs/mini3pro.md. Установщик ставит aarch64-сборку. Кольцо из 16 светодиодов, логотип, часы и датчик освещённости есть; Zigbee-модуль в колонке есть, но pulsar его не использует. Автозапуск после перезагрузки сохраняется не на всех прошивках — см. docs/mini3pro.md, «Userland и хранилище».
Данные контрибьютора (#35). Установщик ставит armhf-сборку.
- Нет часов, датчика освещённости, аппаратного переключателя MUTE, кнопки TALK, кнопок громкости, логотипа и Zigbee; значит, нет и сущностей часов, «Illuminance» и события «Button». Кольцо — 6 светодиодов.
- Кнопка отключения микрофонов переключает программный мут: состояние сохраняется на диск сразу и переживает перезапуск. Начать диалог с самой колонки можно только фразой «Алиса» / «Яндекс».
- Громкость программная (через HA, голосом или Sendspin), по той же кривой в дБ, что softvol остальных моделей: одна ступень 5 % — те же ~2,5 дБ, поэтому 6 % в HA звучат так же тихо, как на Миди.
- Код сопряжения Sendspin выводится только в журнал. USB-плеер и AirPlay-приёмник не поддерживаются.
- Пока HA не записал ключ шифрования, API открыт без шифрования любому в сети: добавьте колонку в
HA сразу после установки (или задайте ключ через
ctl.sh api-key). - Колонка по-прежнему использует DNS (
unbound) и NTP прошивки, которые настроены на серверы Яндекса, и остаётся привязанной к аккаунту Яндекса. - Обновления прошивки Яндекса pulsar не блокирует и не отслеживает: защита от OTA — задача
владельца колонки и способа рута. Обновление прошивки может заменить системный раздел, и тогда
пропадут автозапуск pulsar (
/etc/init.d/S99zpulsar) и правки, сделанные способом рута. Автозапуск возвращается повторным запуском установщика, если root-доступ сохранился. - Zigbee (экспериментально): порт 6638 без авторизации, install code и Green Power не поддерживаются, сеть Яндекса с устройствами Алисы pulsar не использует; роутером колонка входит в любую открытую сеть — см. Zigbee. На Лайт 2, Мини 2, Мини 3 и Мини Zigbee нет; у Мини 3 Про модуль есть, но pulsar его не использует; на Станции 2 Zigbee не поддерживается.
- SSH — вход под root без пароля, только в доверенной сети (см. SSH).
- Установщик для Windows и macOS не проверен на реальных компьютерах.
- Мини, Мини 2, Мини 3, Мини 3 Про, Лайт 2 на плате
pruneи Станция 2 — данные контрибьюторов; ограничения Мини — в разделе Мини. - Голос ответов — тот, что выбран в TTS Home Assistant; голоса Алисы нет.
Сборка из исходников — только на Linux или WSL2; инструменты и их версии — docs/development.md, «Сборка». Устройство демона, железо станций, Zigbee и протокол тестов на колонках — docs/; правила репозитория и процедуры для разработчиков и агентов — AGENTS.md и .agents/skills/.
GNU AGPL-3.0. Прошивки Zigbee-радио (radio/) основаны на Telink Zigbee SDK и, как и он,
распространяются под Apache License 2.0. Сторонние библиотеки, которые скачиваются при сборке,
распространяются под своими лицензиями: sendspin-cpp, ArduinoJson, noise-c, IXWebSocket, micro-flac,
micro-opus, dropbear, OpenSSH. Установщик написан на Go (стандартная библиотека и
golang.org/x/net, лицензия BSD). adb в архивы не входит: установщик скачивает Android SDK
Platform-Tools с сайта Google, они распространяются на условиях Google.