Интеграция LED-люстры в умный дом. Часть 2

—

от автора

Вместо предисловия

В первой части я рассказывал, как подружил с Home Assistant дешёвую LED-люстру с Алиэкспресса. Сниффер на nRF24, расшифровка протокола XN297, свой передатчик на ESP32 в чашке люстры, настенный Zigbee-выключатель вместо обычного. Закончилась она на грустной ноте: первая люстра работает идеально, вторая не работает вообще.

Там же я пообещал: «Родной пульт ею управляет, значит, и мы сможем. Рано или поздно :-)».

Спойлер: смогли. Но совсем не так, как я думал. А «рано или поздно» оказалось заметно ближе к «поздно». По дороге были новый радиомодуль, две недели ожидания, пайка, которая не хотела паяться, три ИИ-консультанта и одно приложение на телефоне, которое за десять минут сделало то, чего не смогли недели экспериментов.

Дисклеймер из первой части в силе: всё, что касается 220 В, делайте при выключенном автомате в щитке. Первое может убить, второе — только ваши нервы. И перехватывайте и повторяйте радиосигналы только своих устройств.

Почему вторая люстра не слушается

Люстры одинаковые. Пульты одинаковые. Протокол одинаковый, ID снят с родного пульта. Первая люстра мой передатчик слушается, вторая делает вид, что его не существует.

Ответ нашёлся в чашке. У второй люстры когда-то умер драйвер, и я его заменил. Да, я. И благополучно забыл 🙂 Купил там же на Алике такой же блок питания (ну по крайней мере выглядела коробочка так же и с такими же параметрами).

Свой приёмник, своя прошивка, и новый пульт. На удивление, каким-то магическим образом с новым блоком питания заработал пульт от старого. А так как он мне нравился больше, ну и для единообразия оставил его. А новый куда-то закинул.

На плате драйвера главный чип помечен TMALLGENIE TG711B. Даташита нет, гугл вежливо молчит. Рядом ещё один маленький чип со своим кварцем. Запомните эту маркировку, она ещё всплывёт.

Чип TMALLGENIE TG711B

Чип TMALLGENIE TG711B

TMALLGENIE TG711B. В тот момент мне это ничего не сказало

Моя гипотеза была такой. Пульт построен на настоящем XN297L, а nRF24 его только имитирует. Родной приёмник первой люстры терпим к подделке, а новый — придирчив. Значит, нужен передатчик, который умеет точнее повторить сигнал.

Был и план Б: забыть про радио и управлять драйвером напрямую, ШИМом с ESP32. (Спасибо вашим комментариям к первой части. Они реально помогают) Я даже раскладывал плату и искал дорожки с подписью PWM. Но даташит я не нашел, опыта такого небыло, рядом сидят силовые ключи на 650 В. Этот план я отложил до лучших времён.

План А — модуль на TI CC2500. У него можно тонко настроить модуляцию, девиацию и скорость, и проект DIY-Multiprotocol уже умеет эмулировать на нём XN297. Звучало логично. Сейчас, зная конец истории, я смеюсь над этим абзацем.

CC2500: найти, заказать и ждать

Найти CC2500 оказалось отдельным квестом. Магазины электроники составили стройный хор: nRF24 — сколько угодно, CC2500 — ни одного. Значит, Алиэкспресс и ко.

По дороге я собрал коллекцию грабель:

  • «Лучше, чем nRF24 и CC2500». Так продавец описывал модуль на AMIC A7105. Чип хороший, но эмуляции XN297 на нём никто не писал. Мне нужен был не лучший чип, а тот, для которого уже есть готовый код.

  • Ловушка в названиях Ebyte. Серия E07 — это CC1101 на 433/868 МГц, совсем другой диапазон. CC2500 у них в серии E03.

  • Цена вопроса.

  • Антенна. Модуль с антенной-дорожкой на плате я так и не нашёл. Везде разъём IPEX (u.FL), а антенна — отдельным лотом.

  • PA+LNA. Почти все модули что я нашел которые казались мне подходящими идут с усилителем на передачу и приём, с дальностью «до километра». Мой передатчик живёт в паре сантиметров от приёмника, так что километр мне нужен как рыбе зонтик. Но выбора не было, а мощность всегда можно убавить программно.

В итоге я заказал модуль GC-02: CC2500, PA+LNA, разъём IPEX, размер 3,3 × 1,7 см. Заказ ушёл 18 октября, посылка пришла 3 ноября. Две недели, за которые люстра продолжала вежливо меня игнорировать. Вот почему вторая часть вышла не через неделю после первой 🙂

Модуль GC-02 на CC2500 с антенной

Модуль GC-02 на CC2500 с антенной

Тот самый GC-02: CC2500, усилитель и антенна на разъёме IPEX

Пайка, которая не хотела паяться

Модуль пришёл, и началось самое интересное. Никаких штырьков у него нет, только ряд из 10 полуотверстий по краю. Шаг около 1,5 мм, а не привычные 2,54. В макетку такое не вставишь, и обычная гребёнка тоже не подойдёт. На производстве такие модули ставят на плату-носитель и прогоняют через печь. У меня печи нет, как и опыта такой пайки. Есть паяльник, терпение и желание победить эту лампу.

Зато на обороте нашлись подписи. И сюрприз: кроме привычных SPI-ног, там есть PA_EN и RX_EN. Усилителем нужно управлять вручную: перед передачей включать PA, перед приёмом — LNA. Итого 9 проводов к ESP32, и только GDO2 можно не подключать.

Подписи выводов GC-02

Подписи выводов GC-02

Подписи на обороте GC-02. Обратите внимание на шаг контактов и соседство VCC и GND

Первая попытка — тонкие монтажные провода. Зазор между ними крошечный, а VCC и GND стоят рядом. Чуть согнул — и короткое замыкание. Не мой путь. (Это еще если не говорить о «соплях» на плате при пайке. Но с этим нужно бороться в любом случае)

Решением оказался лакированный медный провод 0,3 мм для намотки трансформаторов. Он тонкий, а лак защищает от замыкания: соседние провода могут лежать вплотную. Снимать изоляцию ножом не нужно. Приложил конец к капле припоя с флюсом, лак обгорел, медь залудилась.

Ещё пара грабель, чтобы вы на них не наступали:

  • Я залудил пятачки, и припой закрыл отверстия. Не беда: расплавляешь припой и втыкаешь провод прямо в жидкую каплю. Но лучше сначала вставить провод, а потом паять.

  • Провод 0,3 мм не держится в макетке: пружины там рассчитаны на штырь 0,6 мм. Контакт то есть, то нет. Пришлось распаять всё намертво сразу в плату.

  • На модуле нет ни одного светодиода. Живой он или нет, по виду не понять.

Если сильно не присматриваться, то норм. Олег конечно не одобрил бы. Но исопропанол для оттирания следов флюса использован был. Я доволен. 🙂

А главное, все звонится, что должно звонится. Не коротит там где не надо. Контакт надежный.

Расспросить модуль о здоровье я поручил тому же агенту Claude Code в VS Code, что и в первой части. Тест по SPI читает регистры-удостоверения чипа. Первый прогон: PARTNUM = 0x00 вместо 0x80. Причины оказались банальными: сначала не было земли, потом проседало питание в режиме приёма. После перепайки всё сошлось:

PARTNUM   = 0x80   (CC2500)VERSION   = 0x03MARCSTATE = 0x0D   (RX)RSSI      ≈ −104 дБм (фон эфира)

CC2500 работает. Люстра — нет

Дальше всё шло как по нотам. CC2500 уверенно принимал родной пульт второй люстры, с верным CRC, и из комнаты с компьютером, и из комнаты с люстрами. Кварц модуля немного «уплыл», поправку частоты подобрали (FSCTRL0 = −25). Наши кадры совпадали с кадрами пульта байт в байт.

Люстры висят в другой комнате, поэтому для полевых испытаний делал автономную прошивку. Никакого Wi-Fi: кнопка BOOT на плате отправляет команду, светодиод мигает цветом, лог пишется во flash. Зарядка от телефона — и лаборатория готова.

Момент истины. Первая люстра слушается CC2500 с полоборота. Вторая — ничего. Вот неполный список того, что её не впечатлило:

  • точные повторы записанных кадров с родного пульта;

  • свежие счётчики, больше чем у пульта;

  • пять уровней мощности;

  • канал 50, канал 5, прыжки по 14 каналам;

  • три варианта начала и конца кадра, включая точную копию кадра пульта.

Была и одна странность, которую мы тогда не смогли объяснить. Агент прогнал обзор эфира по каналам, пока я жал кнопки пульта. На одном канале, в стороне от знакомых 50 и 5, при каждом нажатии был всплеск энергии. Пульт там явно что-то передавал, но расшифровать это не удавалось никак. Ни адреса, ни CRC, просто шум с характером. Мы записали его в «странное» и пошли дальше. Как оказалось, зря.

И вот тут моя гипотеза про «придирчивый приёмник» затрещала. Два совершенно разных передатчика, nRF24 и CC2500, оба работают с первой люстрой. И оба совершенно одинаково не работают со второй. Если бы дело было в качестве сигнала, хотя бы один вариант дал бы хоть что-то. А тут — ровный ноль.

Пора было остановиться и подумать, а не перебирать дальше.

Сформулировать задачу заново

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

Наш приёмник видит только то, на что он настроен. Что если пульт шлёт что-то ещё, чего мы никогда не видели?

Этот текст я отдал трём разным ИИ и получил три длинных ответа. Они во многом пересекались:

  • защита от повтора и хитрые счётчики;

  • девиация: у нас 127 кГц, а по спецификации XN297L должно быть 150–180;

  • преамбула, смещение частоты, подтверждения;

  • «запишите всё на SDR» (спасибо, SDR у меня нет).

Но один ответ сказал то, чего не сказали другие. Многие современные китайские драйверы люстр управляются по Bluetooth Low Energy. Пульт таких ламп заодно шлёт и старый 2,4G-кадр для старых драйверов. А мой CC2500 такие пакеты не увидит никогда: BLE идёт на 1 Мбит/с, а он умеет только до 500 кбит/с.

Тут у меня в голове щёлкнули две вещи.

Первая: в первой части я гордо «исключил» BLE. Приложение LampSmart Pro люстру не нашло, значит, не Bluetooth. Но такие пульты ничего не сопрягают. Они просто кричат в эфир короткие advertising пакеты, которые в настройках Bluetooth телефона не показываются.

Вторая: TMALLGENIE. Tmall Genie — умный дом от Alibaba, и его светильники обычно работают по Bluetooth. Чип, который я сфотографировал несколько недель назад, всё это время смотрел на меня и намекал.

А проверка стоила смешно: телефон, бесплатное приложение и десять минут.

Телефон знал больше моего сниффера

Я поставил на айфон nRF Connect, открыл сканер без фильтров, положил рядом пульт и нажал кнопку. В списке среди соседских датчиков появилось безымянное устройство с сигналом −20 дБм. А в нём строчка:

Manufacturer Data: <FFF0> 02 55 5D 73 00 45 91 FD
nRF Connect: список устройств

nRF Connect: список устройств

Безымянное устройство с сигналом −20 дБм — это пульт в сантиметре от телефона

Узнаёте? Я узнал сразу, и по спине пробежали мурашки. Это те же самые 8 байт, что и в кадре XN297 из первой части:

Байты

Значение

Что это

02

фаза

номер кадра в пачке

55 5D 73 00

ID

ID второй люстры

45

команда

05 (ВКЛ) + флаг 0x40

91

счётчик

FD

контрольная сумма

02+55+5D+73+00+45+91 = 0x1FD

Контрольная сумма сходится, так что это не совпадение. Нажимаю «ВЫКЛ» и получаю 01 55 5D 73 00 49 95 04. Команда 49 = 09 + 0x40, точно по таблице из первой части. Приложение ещё и подмигивает: «Connectable: No». Пульт ни с кем не соединяется, он просто бродкастит.

nRF Connect: пакет кнопки ВЫКЛ

nRF Connect: пакет кнопки ВЫКЛ

ВЫКЛ: та же структура, команда 49, счётчик вырос

Картина сложилась целиком. Пульт отправляет каждую команду дважды, на двух разных «языках»:

Сигнал

Кто слушает

Кадр XN297L, 250 кбит/с

Родной драйвер первой люстры

Рекламный пакет BLE, 1 Мбит/с

Новый драйвер второй люстры (Tmall Genie)

Все мои идеальные кадры XN297 вторая люстра просто не слушала. Дело было не в качестве сигнала. Я говорил с ней не на том языке.

Дальше агент написал BLE-сканер на самой ESP32 и разложил пакеты по полочкам. За 6 нажатий поймали 68 пакетов, все с верной контрольной суммой:

  • Тип: ADV_NONCONN_IND, без соединения и без ответа на сканирование.

  • Адрес: 73:70:65:65:64:6D, один и тот же всегда. В ASCII это «speedm». Похоже на подпись производителя.

  • Данные: флаги 0x1A и Manufacturer Data с кодом компании 0xFFF0. И больше ничего.

  • Тайминг: пакет каждые ~13 мс. На одно нажатие 2–3 пачки с интервалом ~194 мс.

  • Фазы: в фазе 00 чистая команда, в 01 и 02 команда + 0x40. Счётчик растёт на 1 с каждой пачкой.

ESP32 заговорила на Bluetooth

И тут самое приятное. Для BLE не нужен никакой дополнительный радиомодуль: Bluetooth уже встроен в ESP32-S3. Тот самый, что уже висит в чашке второй люстры и управляет первой.

Просто повторить пакет, правда, не вышло. Адрес «speedm» начинается с битов 01. По спецификации BLE это так называемый resolvable private address, который должен генерироваться и меняться. Китайский пульт на это плюёт, а вот Bluetooth-стек NimBLE на ESP32 такой адрес установить не даёт.

Но проверяет это именно стек, а не само радио. Поэтому агент обошёл стек и стал отправлять Bluetooth-контроллеру сырые HCI-команды через VHCI. Контроллер сказал «ок» (status 0x00) и послушно закричал от имени «speedm». Данные рекламы мы тоже задали байт в байт, чтобы стек не подменил странные флаги 0x1A своими.

Единственное, чего не повторить, — интервал. Пульт шлёт пакет каждые 13 мс, а по стандарту для таких пакетов минимум 20 мс. Китайский пульт и тут стандарта не читал 🙂

Момент истины номер два. Плата в комнате с люстрами, жму BOOT… и вторая люстра включается. Жму ещё раз — выключается. В этот момент я понял, что чувствуют люди, когда запускают ракету. Ну, почти 🙂

Потом были несколько проверок:

  • Счётчик. Отправили команду со счётчиком на 16 меньше последнего, потом на 112 меньше, даже через переход FF → 00. Люстра послушалась. Рост счётчика она не проверяет, значит, сохранять его не нужно.

  • Интеграция. В ESPHome-компонент из первой части добавилась маршрутизация по ID. ID из списка ble_lamp_ids идут по Bluetooth, остальные по nRF24. Имена сущностей не поменялись, так что автоматизации Home Assistant ничего не заметили.

  • Страховка. Перед обновлением по воздуху я сверил файлы в Home Assistant с репозиторием, поставил git-тег на рабочую версию и скачал себе её .bin. Плата висит под потолком, и лезть туда с USB-кабелем и стремянкой не хотелось.

В итоге одна плата в чашке второй люстры управляет обеими: первой через nRF24, второй через свой же Bluetooth. Нового железа — ноль. А CC2500, ради которого всё затевалось, отправился в ящик. Впрочем, свою работу он сделал: доказал, что наши кадры корректны, и тем самым заставил искать причину в другом месте.

Надёжность: люстра, которая дремлет

После обновления прошивки по воздуху вторая люстра включалась и выключалась не всегда. Чаще всего терялась первая команда после паузы, иногда случались и случайные промахи. И это при том, что плата висит в паре сантиметров от приёмника!

Что проверили:

  • Мощность. На −12 дБм сработала 1 команда из 5, на 0 дБм — 4 из 5. Дальше, вплоть до +20 дБм, лучше не становилось. Значит, дело не только в ней.

  • Wi-Fi. Wi-Fi и Bluetooth на ESP32 делят одно радио. Агент научил плату считать, сколько пакетов реально ушло в эфир. Вышло около 100%, так что Wi-Fi ни при чём.

  • Сон приёмника. Похоже, в простое приёмник люстры слушает эфир урывками и пропускает короткую первую пачку.

Решение подсказал сам пульт. Он шлёт около 11 одинаковых копий подряд, и люстра считает их одним нажатием. Значит, первую фазу можно смело растянуть. Мы удлинили её с 194 мс до 1 секунды и добавили 100 мс паузы перед отправкой. Результат: 20 команд из 20.

Итоги

Обе люстры теперь живут в Home Assistant, и управляет ими одна плата в чашке второй люстры:

Люстра

Драйвер

Как управляем

Первая

Родной

nRF24, кадры XN297L

Вторая

Заменённый, Tmall Genie

Встроенный Bluetooth ESP32-S3, advertising пакеты

Что я для себя вынес:

  • Приёмник видит только то, на что настроен. Я неделями смотрел на пульт через замочную скважину в 250 кбит/с и честно думал, что вижу всё.

  • Одинаковые снаружи — не значит одинаковые внутри. Особенно если внутри копался вы сами и забыли об этом.

  • Сначала дешёвые проверки. Я шёл от дорогого к дешёвому: новый чип, доставка, пайка, прошивки. А ответ нашёлся за десять минут в бесплатном приложении на телефоне.

  • Когда застрял, переформулируй задачу. Именно нейтральное описание проблемы, без моих гипотез, натолкнуло на правильный вопрос.

  • Меньше компонентов — меньше сюрпризов. Это про железо, и про автоматизации тоже.

И несколько честных оговорок. Надёжность «после долгой тишины» ещё проверяется жизнью. Переключатели для A/B-тестов пока остаются в прошивке. А вторая люстра теперь слушается плату с чужим адресом «speedm» и ID родного пульта. В следующий раз, возможно, попробую спарить ESP32 как настоящий новый пульт со своим ID.

А пока любимая люстра тёщи — и вторая тоже — включаются с выключателя, из Home Assistant и голосом. Обещание «рано или поздно» выполнено. Поздно, но выполнено 🙂

Код и описание протокола, включая новую часть про BLE, лежат в том же репозитории, что и в первой части. Если у вас люстра с похожим пультом, сначала откройте nRF Connect. Возможно, это сэкономит вам несколько недель.

ссылка на оригинал статьи https://habr.com/ru/articles/1110094/