Custom firmware for Tuya devices on the PHY622x2 chipset

THB1	THB2	BTH01	TH05_V1.3	TH05_V1.4	TH05F

• Программа для настройки и BLE OTA PHY62x2BTHome.html.
• Подгрузка файлов OTA в PHY62x2BTHome.html производится автоматически - загружать из файлы из данного репозитория для OTA не требуется.
• Для автономной работы PHY62x2BTHome.html достаточно скопировать html файл в локальную папку.

• Прошивка Boot имеет минимум функций. Boot используются только для выполнения OTA - для загрузки полнофункциональной версии APP (Application - файлы *.bin).
• Внешне отличить тип устройства возможно по символу смайлика на экране.

Основные файлы прошивок, BOOT_xxx_vxx.hex для программирования через USB-COM адаптер и xxx_vxx.bin для OTA, находятся в директории bin.

Файлы для обновления Boot по OTA находятся в директории update_boot. Процесс обновления boot через OTA не является безопасным. Перед этим действием проверьте уровень батареи. Если boot работает нормально, то обновлять на новую версию не требуется. О необходимости замены boot на новую версию будет объявлено дополнительно. Актуальная версия boot - v1.4.

! При настройках по умолчанию !

• Интервал BLE рекламы в формате BTHome v2 равен 5 секундам.
• Опрос датчика влажности и температуры производится каждый второй интервал BLE рекламы - период 10 секунд.
• Измерение напряжения батареи происходит каждую минуту.
• Кнопка используется для быстрого подключения к старым BT-адаптерам. Нажатие кнопки переключает интервал BLE рекламы на более короткий период (1562.5 мс). Действие продолжится 60 секунд, затем интервал восстановится на установленный в настройках.
• Измеренное среднее потребление от источника в 3.3В при сканировании термометров THB2 и BTH01 в пассивном режиме составляет до 8 мкА. Для TH05_V1.4 среднее потребление около 23 мкА - таков ток установленных компонентов. Остальные версии с экраном: при включенном LCD - от 12 до 14 мкА, c отключенным LCD - от 7 до 12 мкА.
• Запись итории каждые 30 минут
• Интервал соединения с учетом Connect Latency - 900 мс
• Поддерживаемые сенсоры температуры и влажности: AHT30, CHT8305, CHT8215, CHT8310
• Обработка входного контакта со счетчиком для передаваемых событий Open/Close
• Обработка выходного контакта переключаемого по устанавливаемой температуре и/или влажности с гистерезисом

Прошить устройство програмой Boot возможно через USB-COM адаптер с выходами на 3.3В:

1. Соединить GND, TX, RX, RTS–RESET, VCC (+3.3B).

Если на адаптере отсутствует RST пин, тогда следует замкнуть вывод RESET с GND(-Vbat) и быстро разомкнуть при старте скрипта (вомзожно потребуется несколько попыток)

Название контактов на устройстве смотреть в описании по ссылкам: THB1, THB2, BTH01, TH05_V1.3, TH05_V1.4

2. Установить python3 и необходимые библиотеки

pip3 install -r requirements.txt

3. Скачать необходимый для конкретного устройства файл BOOT_xxx_vxx.hex из директории bin.

4. Запустить:

python3 rdwr_phy62x2.py -p COM11 -e -r wh BOOT_xxx_vxx.hex

5. Прошивка Boot завершена. Устройство работает. Адаптер можно отсоединить.

6. Загружаем полную версию прошивки по OTA. Для этого:

   1. Подаем питание на датчик (устройство).
   2. Переходим на PHY62x2BTHome.html.
   3. Жмем кнопку Соединение, ищем устройство, подключаемся.
   4. После подключение переходим на вкладку OTA, выбираем необходимую прошивку и жмем Старт.

7. Устройство должно перезагрузиться и быть готово для использования.

Дополнительно:

• Для предварительного стирания всей Flash используйте опцию -a.

• Для предварительного стирания рабочей области Flash используйте опцию -e.

• С помощью USB-COM адаптера возможно сразу дописать основную прошивку (APP)

python3 rdwr_phy62x2.py -p COM11 -r we 0x10000 xxx_vxx.bin

1. Соединить GND, TX, RX, RTS–RESET, VCC (+3.3B).
2. Запустить:

python3 rdwr_phy62x2.py -p COM11 -r rc 0x11000000 0x80000 ff_thb2.bin

3. Полученный файл ff_thb2.bin сохранить.

• Оригинальную Tuya прошивку на конкретный тип устройства можно взять по ссылкам в таблице, находящейся в самом начале README.

1. Взять сохраненный файл ff_thb2.bin оригинальной прошивки.
2. Соединить GND, TX, RX, RTS–RESET, VCC (+3.3B).
3. Запустить:

python3 rdwr_phy62x2.py -p COM11 -b 1000000 -r we 0 ff_thb2.bin

Не все адаптеры USB-COM поддерживают 1Mbit. Тогда удалите опцию -b 1000000 или выберите другой Baud rate.

4. Прошивка зашита. Устройство работает.

• FW Boot имеет функцию OTA, но не имеет функции записи истории и прочих дополнений. Служит для обработки OTA при любых неудачных или неправильных обновлениях.

• FW APP не имеет функции OTA, для OTA перезагружается в FW Boot. Имеет дополнительные функции и расширения.

Поддерживаемые функции и сервисы описываются включенными битами в 32-х битном поле dev_id.services.

FW Boot запускается по старту, и если не нажата кнопка, проверяет есть или нет запись FW APP. Если есть – запускает FW APP. Если кнопка при старте нажата - запускается FW Boot.

При соединении указывается:

Software: Vx.x - значит работает FW APP Software: Bx.x - значит работает FW Boot

На термометрах с экраном, если не включено отображение времени, при первом старте показывает:

• "Bot 12" - работает Boot версия 1.2
• "APP 12" - работает APP версия 1.2

Принудительно перезагрузиться в FW Boot из FW APP возможно двумя способами:

1. Отключить питание и удерживая кнопку включить питание.
2. Подать команду 7233 в меню Service программы PHY62x2BTHome.html и отключить соединение.

Полная перезагрузка - Подать команду 7201 в меню Service программы PHY62x2BTHome.html и отключить соединение.

Через USB-UART адаптер App можно записать сразу после boot. Пример:

python3 rdwr_phy62x2.py -p COM11 -e wh ./bin/BOOT_TH05V13_v13.hex
python3 rdwr_phy62x2.py -p COM11 -r we 0x10000 ./bin/TH05V13_v13.bin

С версии 1.2 поддерживается опрос вывода подключенного к геркону или контакту, замыкающемуся на GND.

Максимальная частота переключения - 100 раз в секунду.

Если контакт имеет дребезг, тогда желательно зашунтировать контакт конденсатором.

При замыкании или размыкании передается блок из 5 BLE реклам следующих друг за другом через период в 50 мс.

При каждом событии "Open" прибавляется счетчик.

Значение счетчика передается совместно с каждым событием "Open/Close".

Входной контакт на плате термометра:

• На THB1 - маркирован как RX
• На THB2 - маркирован как RX
• На BTH01 - маркирован как RX2
• На TH05_V1.3 - маркирован как RX0
• На TH05_V1.4 - маркирован как RX2

Контакт на печатной плате с маркировкой "TX" или "TX2" управляется с помощью уставок с гистерезисами по температуре и влажности. Имеется возможность переключения на инверсное управление выводом.

Настройка производится в PHY62x2BTHome.html.

Работа выхода назначается с помощью установки значения гистерезиса:

• Если значение гистерезиса равно нулю - переключений не будет.
• Если значение гистерезиса больше нуля - переключение (включение) произойдет при значении ниже уставка + гистерезис.
• Если значение гистерезиса меньше нуля - переключение (включение) произойдет при значении выше уставка + гистерезис.

Для установки основных параметров в начальные значения берете смартфон с Android и программу "nRFConnect". Соединяетесь с устройством и в сервис 0xFCD2 c характеристикой 0xFFF4 записываете 56.

• Нажатие/отпускание кнопки временно меняет интервал соединения для подключения. Коротко нажмите кнопку и подключитесь за 60 сек. Если не успеваете - нажимайте кнопку чаще...
• В прошивке проверяются все установки на соответствие стандартам Bluetooth SIG. Если интервал более 10 сек, то поставит 10 сек - это максимум в стандарте. Так и другие параметры. Но не все BT адаптеры могут работать с интервалом 10 сек для соединения.
• При работе с BLE в Linux обязательно требуется изменение опций Bluez и/или патчи kernel!

Для сборки прошивки используется GNU Arm Embedded Toolchain.

Для работы в Eclipce используете импорт проекта и установите toolchain.path.

Дополнительная информация по чипам PHY62xx.