From de2730f7276d716b24f4d1ed07df502771750402 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 12:47:24 +0200 Subject: [PATCH 01/12] Starting the translation of README.md --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index b2859bd..d749bc5 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,36 @@ # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F -Custom firmware for Tuya devices on the PHY622x2 chipset +Custom firmware for Tuya devices based on the PHY622x2 chipset | [THB1](https://pvvx.github.io/THB1) | [THB2](https://pvvx.github.io/THB2) | [THB3](https://pvvx.github.io/THB3) | [BTH01](https://pvvx.github.io/BTH01/) | [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | [TH05_V1.4](https://pvvx.github.io/TH-05) | [TH05F](https://pvvx.github.io/TH05F) | |:---:|:---:|:---:|:---:|:---:|:---:|:---:| | ![THB1](https://pvvx.github.io/THB1/img/THB1.jpg) | ![THB2](https://pvvx.github.io/THB2/img/THB2.jpg) | ![THB3](https://pvvx.github.io/THB3/img/THB3.jpg) | ![BTH01](https://pvvx.github.io/BTH01/img/BTH01.jpg) | ![TH05V1.3](https://pvvx.github.io/TH05-v1.3/img/TH05-V1.3.jpg) | ![TH05V1.4](https://pvvx.github.io/TH-05/img/TH05V14.jpg) | ![TH05F](https://pvvx.github.io/TH05F/img/TH05F.jpg) All firmware supports any of the sensors: CHT8215 (CHT8310), CHT8305, AHT20..30. -* Программа для настройки и BLE OTA [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html). -* Подгрузка файлов OTA в [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) производится автоматически - загружать из файлы из данного репозитория для OTA не требуется. -* Для автономной работы [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) достаточно скопировать [html](https://github.com/pvvx/THB2/blob/master/bthome_phy6222/web/PHY62x2BTHome.html) файл в локальную папку. +* Software for setting up and BLE OTA [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html). +* Uploading OTA files to [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) is automatic. You don't need to download files from this repository for OTA. +* To run [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) offline, just copy the [html](https://github.com/pvvx/THB2/blob/master/bthome_phy6222/web/PHY62x2BTHome.html) file to a local folder. -## Прошивки Boot и APP +## Boot and App firmware -* Прошивка [Boot](https://github.com/pvvx/THB2?tab=readme-ov-file#fw-boot-%D0%B8-ota) имеет минимум функций. Boot используются только для выполнения OTA - для загрузки полнофункциональной версии APP (Application - файлы *.bin). -* Внешне отличить тип устройства возможно по символу смайлика на экране. +* The [Boot](https://github.com/pvvx/THB2?tab=readme-ov-file#fw-boot-%D0%B8-ota) firmware has minimal functions. Boot is used only for OTA - for downloading the full-featured version of APP (Application - *.bin files). +* The device type can be distinguished externally by the smiley face symbol on the screen. -| Устройство | Файл Boot | Файл OTA | Маркировка на печатной плате | +| Device | Boot file | OTA file | Printed circuit board labelling | |:---:|:---:|:---:|:---:| -| [THB1](https://pvvx.github.io/THB1) | BOOT_THB1_v17.hex | THB1_v17.bin | нет | -| [THB2](https://pvvx.github.io/THB2) | BOOT_THB2_v17.hex | THB2_v17.bin | нет | -| [THB3](https://pvvx.github.io/THB3) | BOOT_THB2_v17.hex | THB2_v17.bin | нет | -| [BTH01](https://pvvx.github.io/BTH01) | BOOT_BTH01_v17.hex | BTH01_v17.bin | нет | -| [TH05_V1.4](https://pvvx.github.io/TH-05) | BOOT_TH05_v17.hex | TH05_v17.bin | TH05_V1.4, TH05_V1.5, TH05_V1.6 с чипом BL55028 | -| [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | BOOT_TH05D_v17.hex | TH05D_v17.bin | RSH-TH05-V1.3 с чипом BL55072 | -| [TH05F](https://pvvx.github.io/TH05F) | BOOT_TH05F_v17.hex | TH05F_v17.bin | TH05Y_V1.1, TH05Y_V1.2 с чипом QD01 2332 NT | +| [THB1](https://pvvx.github.io/THB1) | BOOT_THB1_v17.hex | THB1_v17.bin | no | +| [THB2](https://pvvx.github.io/THB2) | BOOT_THB2_v17.hex | THB2_v17.bin | no | +| [THB3](https://pvvx.github.io/THB3) | BOOT_THB2_v17.hex | THB2_v17.bin | no | +| [BTH01](https://pvvx.github.io/BTH01) | BOOT_BTH01_v17.hex | BTH01_v17.bin | no | +| [TH05_V1.4](https://pvvx.github.io/TH-05) | BOOT_TH05_v17.hex | TH05_v17.bin | TH05_V1.4, TH05_V1.5, TH05_V1.6 (chip: BL55028) | +| [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | BOOT_TH05D_v17.hex | TH05D_v17.bin | RSH-TH05-V1.3 (chip: BL55072) | +| [TH05F](https://pvvx.github.io/TH05F) | BOOT_TH05F_v17.hex | TH05F_v17.bin | TH05Y_V1.1, TH05Y_V1.2 (chip: QD01 2332 NT) | -Основные файлы прошивок, BOOT_xxx_vxx.hex для программирования через USB-COM адаптер и xxx_vxx.bin для OTA, находятся в директории [bin](https://github.com/pvvx/THB2/tree/master/bin). +The main firmware files, BOOT_XXX_vXX.hex for programming via USB-COM adapter and XXX_vXX.bin for OTA, are located in the [bin](https://github.com/pvvx/THB2/tree/master/bin) directory. -Файлы для обновления Boot по OTA находятся в директории [update_boot](https://github.com/pvvx/THB2/tree/master/update_boot). Процесс обновления boot через OTA не является безопасным. Перед этим действием проверьте уровень батареи. Если boot работает нормально, то обновлять на новую версию не требуется. О необходимости замены boot на новую версию будет объявляется дополнительно. +Files for updating boot via OTA are located in the [update_boot](https://github.com/pvvx/THB2/tree/master/update_boot) directory. **The process of updating boot via OTA is not safe. Please check the battery level before doing this. If boot is working fine, there is no need to update to the new version. The need to replace boot with a new version will be announced later.** -Актуальная версия boot - **v1.7** для устройств с датчиком CHT8305. Для остальных вариантов обновлений boot не требуется с версии **v1.4**. +The current boot version is **v1.7** for devices with CHT8305 sensor. For other variants, boot is not required from version **v1.4**. ## Основные характеристики From df80e3252e7d8e86f9e6d5c73e10a1d0abb27f33 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 14:53:33 +0200 Subject: [PATCH 02/12] Update README.md --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index d749bc5..662a20d 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,6 @@ +[![english](https://img.shields.io/badge/language-english-blue?style=for-the-badge)]() +[![russian](https://img.shields.io/badge/language-russian-red?style=for-the-badge)]() + # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F Custom firmware for Tuya devices based on the PHY622x2 chipset From 2033024ee8679419abcddace8123e5df3bba504a Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 14:58:21 +0200 Subject: [PATCH 03/12] Create README-ru.md --- README-ru.md | 250 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 250 insertions(+) create mode 100644 README-ru.md diff --git a/README-ru.md b/README-ru.md new file mode 100644 index 0000000..b2859bd --- /dev/null +++ b/README-ru.md @@ -0,0 +1,250 @@ +# BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F + +Custom firmware for Tuya devices on the PHY622x2 chipset +| [THB1](https://pvvx.github.io/THB1) | [THB2](https://pvvx.github.io/THB2) | [THB3](https://pvvx.github.io/THB3) | [BTH01](https://pvvx.github.io/BTH01/) | [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | [TH05_V1.4](https://pvvx.github.io/TH-05) | [TH05F](https://pvvx.github.io/TH05F) | +|:---:|:---:|:---:|:---:|:---:|:---:|:---:| +| ![THB1](https://pvvx.github.io/THB1/img/THB1.jpg) | ![THB2](https://pvvx.github.io/THB2/img/THB2.jpg) | ![THB3](https://pvvx.github.io/THB3/img/THB3.jpg) | ![BTH01](https://pvvx.github.io/BTH01/img/BTH01.jpg) | ![TH05V1.3](https://pvvx.github.io/TH05-v1.3/img/TH05-V1.3.jpg) | ![TH05V1.4](https://pvvx.github.io/TH-05/img/TH05V14.jpg) | ![TH05F](https://pvvx.github.io/TH05F/img/TH05F.jpg) + +All firmware supports any of the sensors: CHT8215 (CHT8310), CHT8305, AHT20..30. + +* Программа для настройки и BLE OTA [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html). +* Подгрузка файлов OTA в [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) производится автоматически - загружать из файлы из данного репозитория для OTA не требуется. +* Для автономной работы [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) достаточно скопировать [html](https://github.com/pvvx/THB2/blob/master/bthome_phy6222/web/PHY62x2BTHome.html) файл в локальную папку. + +## Прошивки Boot и APP + +* Прошивка [Boot](https://github.com/pvvx/THB2?tab=readme-ov-file#fw-boot-%D0%B8-ota) имеет минимум функций. Boot используются только для выполнения OTA - для загрузки полнофункциональной версии APP (Application - файлы *.bin). +* Внешне отличить тип устройства возможно по символу смайлика на экране. + +| Устройство | Файл Boot | Файл OTA | Маркировка на печатной плате | +|:---:|:---:|:---:|:---:| +| [THB1](https://pvvx.github.io/THB1) | BOOT_THB1_v17.hex | THB1_v17.bin | нет | +| [THB2](https://pvvx.github.io/THB2) | BOOT_THB2_v17.hex | THB2_v17.bin | нет | +| [THB3](https://pvvx.github.io/THB3) | BOOT_THB2_v17.hex | THB2_v17.bin | нет | +| [BTH01](https://pvvx.github.io/BTH01) | BOOT_BTH01_v17.hex | BTH01_v17.bin | нет | +| [TH05_V1.4](https://pvvx.github.io/TH-05) | BOOT_TH05_v17.hex | TH05_v17.bin | TH05_V1.4, TH05_V1.5, TH05_V1.6 с чипом BL55028 | +| [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | BOOT_TH05D_v17.hex | TH05D_v17.bin | RSH-TH05-V1.3 с чипом BL55072 | +| [TH05F](https://pvvx.github.io/TH05F) | BOOT_TH05F_v17.hex | TH05F_v17.bin | TH05Y_V1.1, TH05Y_V1.2 с чипом QD01 2332 NT | + +Основные файлы прошивок, BOOT_xxx_vxx.hex для программирования через USB-COM адаптер и xxx_vxx.bin для OTA, находятся в директории [bin](https://github.com/pvvx/THB2/tree/master/bin). + +Файлы для обновления Boot по OTA находятся в директории [update_boot](https://github.com/pvvx/THB2/tree/master/update_boot). Процесс обновления boot через OTA не является безопасным. Перед этим действием проверьте уровень батареи. Если boot работает нормально, то обновлять на новую версию не требуется. О необходимости замены boot на новую версию будет объявляется дополнительно. + +Актуальная версия boot - **v1.7** для устройств с датчиком CHT8305. Для остальных вариантов обновлений boot не требуется с версии **v1.4**. + +## Основные характеристики + +! _При настройках по умолчанию_ ! + +* Интервал BLE рекламы в формате [BTHome v2](https://bthome.io) равен 5 секундам. +* Опрос датчика влажности и температуры производится каждый второй интервал BLE рекламы - период 10 секунд. +* Измерение напряжения батареи происходит каждую минуту. +* Кнопка используется для быстрого подключения к старым BT-адаптерам. Нажатие кнопки переключает интервал BLE рекламы на более короткий период (1562.5 мс). Действие продолжится 60 секунд, затем интервал восстановится на установленный в настройках. +* Измеренное среднее потребление от источника в 3.3В при сканировании термометров THB2 и BTH01 в пассивном режиме составляет до 8 мкА. Для TH05_V1.4 среднее потребление около 23 мкА - [таков ток установленных компонентов](https://github.com/pvvx/THB2/issues/8#issuecomment-1908982171). Остальные версии с экраном: при включенном LCD - от 12 до 14 мкА, c отключенным LCD - от 7 до 12 мкА. +* Запись итории каждые 30 минут +* Интервал соединения с учетом Connect Latency - 900 мс +* Поддерживаемые сенсоры температуры и влажности: AHT30, CHT8305, CHT8215, CHT8310 +* Обработка входного контакта со счетчиком для передаваемых событий [Open/Close](https://github.com/pvvx/THB2/issues/10#issuecomment-1935169274) +* Обработка выходного контакта переключаемого по устанавливаемой температуре и/или влажности с гистерезисом +* Поддержка недорогого [повторителя рекламы BLE в Zigbee](https://github.com/pvvx/TLB2Z) + +## История версий + +| N | Описание | +|---|--- | +| 1.0 | Первая релизная версия | +| 1.1 | Добавлен триггер - вывод TX2 срабатывающий по установленным значениям температуры и/или влажности с гистерезисами. Передача состояния вывода RX2 при connect. Для термометров с экраном добавлен показ смайлика с "комфортом". Дополнены: изменение имени и MAC устройства. | +| 1.2 | Обработка и передача событий open/close со счетчиком с вывода маркированного "RX2" (для THB2 - "RX1"). | +| 1.3 | Добавлен THB1 и TH05V1.3. Следующий этап уменьшения потребления для версий с LCD дисплеем и опция отключения дисплея. | +| 1.4 | Стабилизация соединения для всех вариантов устройств. Добавлен [TH05F](https://pvvx.github.io/TH05F). Коррекция хода RTC. Изменено BLE имя для TH05_V1.3 на "TH05D". Добавлены файлы для обновления Boot по OTA. | +| 1.5 | Добавлен вариант шифрования BLE рекламы с помощью BindKey. | +| 1.6 | Добавлено усреднение расчета напряжения батареи, дублирование состояния контакта open/close и счетчика через 12..20 сек (кратно интервалу рекламы) после срабатывания и далее каждые 30 минут. | +| 1.7 | Исправление ошибки (> 42 C) для сенсора CHT8305 | + +## Прошивка + +Прошить устройство програмой Boot возможно через USB-COM адаптер с выходами на 3.3В: + +1. Соединить GND, TX, RX, RTS–RESET, VCC (+3.3B). + +| Адаптер | Устройство | +|---|---| +| GND | -Vbat | +| +3.3В | +Vbat | +| TX | RX1 | +| RX | TX1 | +| RTS | RESET | + +Если на адаптере отсутствует RST пин, тогда следует замкнуть вывод RESET с GND(-Vbat) и быстро разомкнуть при старте скрипта (вомзожно потребуется несколько попыток) + +Название контактов на устройстве смотреть в описании по ссылкам: [THB1](https://pvvx.github.io/THB1), [THB2](https://pvvx.github.io/THB2), [THB3](https://pvvx.github.io/THB3), [BTH01](https://pvvx.github.io/BTH01/), [TH05_V1.3](https://pvvx.github.io/TH05-v1.3), [TH05_V1.4](https://pvvx.github.io/TH-05) + +2. Установить python3 и необходимые библиотеки + +```txt +pip3 install -r requirements.txt +``` + +3. Скачать необходимый для конкретного устройства файл BOOT_xxx_vxx.hex из директории bin. + +4. Запустить: + +```txt +python3 rdwr_phy62x2.py -p COM11 -e -r wh BOOT_xxx_vxx.hex +``` + +5. Прошивка Boot завершена. Устройство работает. Адаптер можно отсоединить. + +6. Загружаем полную версию прошивки по OTA. Для этого: + 1. Подаем питание на датчик (устройство). + 2. Переходим на [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/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. Прошивка зашита. Устройство работает. + +## Распределение Flash 512 килобайт + +| Адрес | Описание | Размер | +|---|---|---| +| 0x00000 | Используется ROM | 8 килобайт | +| 0x02000 | Boot Info для ROM | 4 килобайта | +| 0x03000 | FW Boot с функцией OTA | 52 килобайта | +| 0x10000 | FW APP | 128 килобайт | +| 0x30000 | Запись истории | 304 килобайт | +| 0x7C000 | Сохранение настроек (EEP) | 16 килобайт | + +## FW Boot и OTA + +* `FW Boot` имеет функцию OTA, но не имеет функции записи истории и прочих дополнений. Служит для обработки OTA при любых неудачных или неправильных обновлениях. + +* `FW APP` не имеет функции OTA, для OTA перезагружается в `FW Boot`. Имеет дополнительные функции и расширения. + +Поддерживаемые функции и сервисы описываются включенными битами в 32-х битном поле `dev_id.services`. + +`FW Boot` запускается по старту, и если не нажата кнопка, проверяет есть или нет запись `FW APP`. Если есть – запускает `FW APP`. Если кнопка при старте нажата - запускается `FW Boot`. + +При соединении указывается: + +_Software:_ **V**x.x - значит работает `FW APP` +_Software:_ **B**x.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 +``` + +## Событие Open/Close и счет импульсов + +С версии 1.2 поддерживается опрос вывода подключенного к геркону или контакту, замыкающемуся на GND. + +Максимальная частота переключения - 100 раз в секунду. + +Если контакт имеет дребезг, тогда желательно зашунтировать контакт конденсатором. + +При замыкании или размыкании передается блок из 5 BLE реклам следующих друг за другом через период в 50 мс. + +При каждом событии "Open" прибавляется счетчик. + +Значение счетчика передается совместно с каждым событием "Open/Close". + +Входной контакт на плате термометра: + +* На [THB1](https://pvvx.github.io/THB1) - маркирован как `RX` +* На [THB2](https://pvvx.github.io/THB2) - маркирован как `RX` +* На [THB3](https://pvvx.github.io/THB3) - маркирован как `RX` +* На [BTH01](https://pvvx.github.io/BTH01/) - маркирован как `RX2` +* На [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) - маркирован как `RX0` +* На [TH05_V1.4](https://pvvx.github.io/TH-05) - маркирован как `RX2` + +![image](https://github.com/pvvx/THB2/assets/12629515/09f6f810-f2e2-4b61-9c84-f7c3770bb76a) + +![image](https://github.com/pvvx/THB2/assets/12629515/40de4978-2d97-4f79-af9d-565236d0ba2a) + +## Вывод управления внешним устройством по температуре и/или влажности + +Контакт на печатной плате с маркировкой "TX" или "TX2" управляется с помощью уставок с гистерезисами по температуре и влажности. +Имеется возможность переключения на инверсное управление выводом. + +Настройка производится в PHY62x2BTHome.html. + +Работа выхода назначается с помощью установки значения гистерезиса: + +* Если значение гистерезиса равно нулю - переключений не будет. +* Если значение гистерезиса больше нуля - переключение (включение) произойдет при значении ниже уставка + гистерезис. +* Если значение гистерезиса меньше нуля - переключение (включение) произойдет при значении выше уставка + гистерезис. + +## Сброс основных настроек + +Для установки основных параметров в начальные значения берете смартфон с Android и программу "nRFConnect". +Соединяетесь с устройством и в сервис `0xFCD2` c характеристикой `0xFFF4` записываете `56`. + +![image](https://github.com/pvvx/THB2/assets/12629515/85cfaf06-e430-492e-930a-536afb163b5b) + +* Нажатие/отпускание кнопки временно меняет интервал соединения для подключения. Коротко нажмите кнопку и подключитесь за 60 сек. Если не успеваете - нажимайте кнопку чаще... +* В прошивке проверяются все установки на соответствие стандартам Bluetooth SIG. +Если интервал более 10 сек, то поставит 10 сек - это максимум в стандарте. Так и другие параметры. +Но не все BT адаптеры могут работать с интервалом 10 сек для соединения. +* **При работе с BLE в Linux обязательно требуется изменение опций Bluez и/или патчи kernel!** + +--- + +## Сборка прошивки + +Для сборки прошивки используется GNU Arm Embedded Toolchain. + +Для работы в Eclipce используете импорт проекта и установите toolchain.path. + +Дополнительная информация по чипам [PHY62xx](https://github.com/pvvx/PHY62x2). From f614fd1cc6a6c6a8770bc3d9dfd23b4c438f9a30 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 14:59:53 +0200 Subject: [PATCH 04/12] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 662a20d..6e967fe 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ -[![english](https://img.shields.io/badge/language-english-blue?style=for-the-badge)]() -[![russian](https://img.shields.io/badge/language-russian-red?style=for-the-badge)]() +[![english](https://img.shields.io/badge/language-english-blue?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README.md) +[![russian](https://img.shields.io/badge/language-russian-red?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README-ru.md) # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F From cc47dd80b15462772fc0772ee5b176dd1a3dd232 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:00:26 +0200 Subject: [PATCH 05/12] Update README-ru.md --- README-ru.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README-ru.md b/README-ru.md index b2859bd..514b29d 100644 --- a/README-ru.md +++ b/README-ru.md @@ -1,3 +1,6 @@ +[![english](https://img.shields.io/badge/language-english-blue?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README.md) +[![russian](https://img.shields.io/badge/language-russian-red?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README-ru.md) + # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F Custom firmware for Tuya devices on the PHY622x2 chipset From c2c487f4b5ca55a4a4cb5f7781ddd052021a4bd9 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:03:55 +0200 Subject: [PATCH 06/12] Update README-ru.md --- README-ru.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README-ru.md b/README-ru.md index 514b29d..d205240 100644 --- a/README-ru.md +++ b/README-ru.md @@ -1,5 +1,5 @@ -[![english](https://img.shields.io/badge/language-english-blue?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README.md) -[![russian](https://img.shields.io/badge/language-russian-red?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README-ru.md) +[![russian](https://img.shields.io/badge/language-russian-C1C1C1?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README-ru.md) +[![english](https://img.shields.io/badge/also%20available%20in-english-blue?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README.md) # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F From 0bb891ff6c14f0a56107bf2023e4660aa9ee6ddf Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:04:52 +0200 Subject: [PATCH 07/12] Update README-ru.md From 6b876ad5b6f29e509b8b0cc9f206e6d97797b8c7 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:07:00 +0200 Subject: [PATCH 08/12] Update README-ru.md --- README-ru.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README-ru.md b/README-ru.md index d205240..442787a 100644 --- a/README-ru.md +++ b/README-ru.md @@ -1,5 +1,5 @@ -[![russian](https://img.shields.io/badge/language-russian-C1C1C1?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README-ru.md) -[![english](https://img.shields.io/badge/also%20available%20in-english-blue?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README.md) +[![russian](https://img.shields.io/badge/language-russian-C1C1C1?style=for-the-badge)](README-ru.md) +[![english](https://img.shields.io/badge/also%20available%20in-english-blue?style=for-the-badge)](README.md) # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F From b60449e41742b8ae56471873ad4db760ae19983a Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:08:14 +0200 Subject: [PATCH 09/12] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 6e967fe..f0d9b87 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ -[![english](https://img.shields.io/badge/language-english-blue?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README.md) -[![russian](https://img.shields.io/badge/language-russian-red?style=for-the-badge)](https://github.com/devmlb/PHY622x-custom-firmware/blob/master/README-ru.md) +[![english](https://img.shields.io/badge/language-english-C1C1C1?style=for-the-badge)](README.md) +[![russian](https://img.shields.io/badge/also%20available%20in-russian-blue?style=for-the-badge)](README-ru.md) # BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F From 4dfd3e477085cc54ce07a1d71aa5532dcd84f2d7 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:50:58 +0200 Subject: [PATCH 10/12] Finishing the translation of README.md --- README.md | 242 +++++++++++++++++++++++++++--------------------------- 1 file changed, 119 insertions(+), 123 deletions(-) diff --git a/README.md b/README.md index f0d9b87..b156a78 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ [![english](https://img.shields.io/badge/language-english-C1C1C1?style=for-the-badge)](README.md) [![russian](https://img.shields.io/badge/also%20available%20in-russian-blue?style=for-the-badge)](README-ru.md) -# BTHome THB1, THB2, THB3, BTH01, TH05(HW: v1.3..1.6), TH05F +# BTHome THB1, THB2, THB3, BTH01, TH05 (HW: v1.3..1.6), TH05F Custom firmware for Tuya devices based on the PHY622x2 chipset | [THB1](https://pvvx.github.io/THB1) | [THB2](https://pvvx.github.io/THB2) | [THB3](https://pvvx.github.io/THB3) | [BTH01](https://pvvx.github.io/BTH01/) | [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | [TH05_V1.4](https://pvvx.github.io/TH-05) | [TH05F](https://pvvx.github.io/TH05F) | @@ -35,219 +35,215 @@ Files for updating boot via OTA are located in the [update_boot](https://github. The current boot version is **v1.7** for devices with CHT8305 sensor. For other variants, boot is not required from version **v1.4**. -## Основные характеристики +## Main Features -! _При настройках по умолчанию_ ! +! _With default settings_ ! -* Интервал BLE рекламы в формате [BTHome v2](https://bthome.io) равен 5 секундам. -* Опрос датчика влажности и температуры производится каждый второй интервал BLE рекламы - период 10 секунд. -* Измерение напряжения батареи происходит каждую минуту. -* Кнопка используется для быстрого подключения к старым BT-адаптерам. Нажатие кнопки переключает интервал BLE рекламы на более короткий период (1562.5 мс). Действие продолжится 60 секунд, затем интервал восстановится на установленный в настройках. -* Измеренное среднее потребление от источника в 3.3В при сканировании термометров THB2 и BTH01 в пассивном режиме составляет до 8 мкА. Для TH05_V1.4 среднее потребление около 23 мкА - [таков ток установленных компонентов](https://github.com/pvvx/THB2/issues/8#issuecomment-1908982171). Остальные версии с экраном: при включенном LCD - от 12 до 14 мкА, c отключенным LCD - от 7 до 12 мкА. -* Запись итории каждые 30 минут -* Интервал соединения с учетом Connect Latency - 900 мс -* Поддерживаемые сенсоры температуры и влажности: AHT30, CHT8305, CHT8215, CHT8310 -* Обработка входного контакта со счетчиком для передаваемых событий [Open/Close](https://github.com/pvvx/THB2/issues/10#issuecomment-1935169274) -* Обработка выходного контакта переключаемого по устанавливаемой температуре и/или влажности с гистерезисом -* Поддержка недорогого [повторителя рекламы BLE в Zigbee](https://github.com/pvvx/TLB2Z) +* BLE advertisement interval in [BTHome v2](https://bthome.io) format is 5 seconds. +* Humidity and temperature sensor is polled every second BLE advertisement interval - period of 10 seconds. +* Battery voltage measurement is done every minute. +* The button is used for quick connection to old BT adapters. Pressing the button switches the BLE advertising interval to a shorter period (1562.5ms). The action will continue for 60 seconds, then the interval will be restored to the one set in the settings. +* The measured average consumption from a 3.3V source when scanning THB2 and BTH01 thermometers in passive mode is up to 8 µA. For TH05_V1.4 the average consumption is about 23 µA - [this is the current of the installed components](https://github.com/pvvx/THB2/issues/8#issuecomment-1908982171). Other versions with screen: with LCD on - 12 to 14 µA, with LCD off - 7 to 12 µA. +* Recording of history every 30 minutes +* Connection interval with Connect Latency - 900ms +* Supported temperature and humidity sensors: AHT30, CHT8305, CHT8215, CHT8310. +* Handling of input counter contact for transmitted [Open/Close events](https://github.com/pvvx/THB2/issues/10#issuecomment-1935169274) +* Processing of output contact switchable by set temperature and/or humidity with hysteresis. +* Support low-cost [BLE to Zigbee advertising repeater](https://github.com/pvvx/TLB2Z) -## История версий +## Version History -| N | Описание | +| Version | Description | |---|--- | -| 1.0 | Первая релизная версия | -| 1.1 | Добавлен триггер - вывод TX2 срабатывающий по установленным значениям температуры и/или влажности с гистерезисами. Передача состояния вывода RX2 при connect. Для термометров с экраном добавлен показ смайлика с "комфортом". Дополнены: изменение имени и MAC устройства. | -| 1.2 | Обработка и передача событий open/close со счетчиком с вывода маркированного "RX2" (для THB2 - "RX1"). | -| 1.3 | Добавлен THB1 и TH05V1.3. Следующий этап уменьшения потребления для версий с LCD дисплеем и опция отключения дисплея. | -| 1.4 | Стабилизация соединения для всех вариантов устройств. Добавлен [TH05F](https://pvvx.github.io/TH05F). Коррекция хода RTC. Изменено BLE имя для TH05_V1.3 на "TH05D". Добавлены файлы для обновления Boot по OTA. | -| 1.5 | Добавлен вариант шифрования BLE рекламы с помощью BindKey. | -| 1.6 | Добавлено усреднение расчета напряжения батареи, дублирование состояния контакта open/close и счетчика через 12..20 сек (кратно интервалу рекламы) после срабатывания и далее каждые 30 минут. | -| 1.7 | Исправление ошибки (> 42 C) для сенсора CHT8305 | +| 1.0 | First release version | +| 1.1 | Added trigger - TX2 output triggered by set temperature and/or humidity values with hysteresis. Transmission of the state of the RX2 output when connected. For thermometers with screen added display of smiley face with "comfort". Added: change of device name and MAC. | +| 1.2 | Processing and transmission of open/close events with counter from the output labelled "RX2" (for THB2 - "RX1"). | +| 1.3 | Added THB1 and TH05V1.3. Next step to reduce consumption for versions with LCD display and option to switch off the display. | 1.4 | Added THB1 and TH05V1.3. +| 1.4 | Connection stabilisation for all device variants. Added [TH05F](https://pvvx.github.io/TH05F). Correction of RTC progress. Changed BLE name for TH05_V1.3 to "TH05D". Added files for OTA Boot update. | +| 1.5 | Added option to encrypt BLE ads with BindKey. | +| 1.6 | Added averaging of battery voltage calculation, duplication of open/close contact and counter status 12..20 sec (multiple of ad interval) after triggering and then every 30 min. | +| 1.7 | Error correction (> 42 C) for sensor CHT8305 | -## Прошивка +## Firmware -Прошить устройство програмой Boot возможно через USB-COM адаптер с выходами на 3.3В: +It is possible to flash the device with the Boot program via USB-COM adapter with 3.3V outputs. -1. Соединить GND, TX, RX, RTS–RESET, VCC (+3.3B). +1. Connect GND, TX, RX, RTS-RESET, VCC (+3.3B). -| Адаптер | Устройство | +| Adapter | Device | |---|---| | GND | -Vbat | -| +3.3В | +Vbat | +| +3.3V | +Vbat | | TX | RX1 | | RX | TX1 | | RTS | RESET | -Если на адаптере отсутствует RST пин, тогда следует замкнуть вывод RESET с GND(-Vbat) и быстро разомкнуть при старте скрипта (вомзожно потребуется несколько попыток) +If there is no RST pin on the adapter, then short the RESET pin to GND (-Vbat) and quickly open it when the script starts (it may take a few tries). -Название контактов на устройстве смотреть в описании по ссылкам: [THB1](https://pvvx.github.io/THB1), [THB2](https://pvvx.github.io/THB2), [THB3](https://pvvx.github.io/THB3), [BTH01](https://pvvx.github.io/BTH01/), [TH05_V1.3](https://pvvx.github.io/TH05-v1.3), [TH05_V1.4](https://pvvx.github.io/TH-05) +The name of the pins on the device can be found in the description at the links: [THB1](https://pvvx.github.io/THB1), [THB2](https://pvvx.github.io/THB2), [THB3](https://pvvx.github.io/THB3), [BTH01](https://pvvx.github.io/BTH01/), [TH05_V1.3](https://pvvx.github.io/TH05-v1.3), [TH05_V1.4](https://pvvx.github.io/TH-05) -2. Установить python3 и необходимые библиотеки +2. Install python3 and the necessary libraries -```txt +``` pip3 install -r requirements.txt ``` -3. Скачать необходимый для конкретного устройства файл BOOT_xxx_vxx.hex из директории bin. +3. Download the BOOT_XXX_vXX.hex file required for the specific device from the [bin](bin) directory. -4. Запустить: +4. Run: -```txt +``` python3 rdwr_phy62x2.py -p COM11 -e -r wh BOOT_xxx_vxx.hex ``` -5. Прошивка Boot завершена. Устройство работает. Адаптер можно отсоединить. +5. Boot flashing is complete. The device is operational. The adapter can be disconnected. -6. Загружаем полную версию прошивки по OTA. Для этого: - 1. Подаем питание на датчик (устройство). - 2. Переходим на [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html). - 3. Жмем кнопку `Соединение`, ищем устройство, подключаемся. - 4. После подключение переходим на вкладку `OTA`, выбираем необходимую прошивку и жмем `Старт`. +6. Download the full version of the firmware via OTA. To do this: + 1. Apply power to the sensor. + 2. Go to [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html). + 3. Click the `Connect` button, look for the device, and connect. + 4. Once connected, go to the `OTA` tab, select the required firmware (`.bin`) and click `Start`. -7. Устройство должно перезагрузиться и быть готово для использования. +7. The device should reboot and be ready for use. -Дополнительно: +> Optional: +> * To pre-wipe the entire Flash, use the `-a` option. +> * To pre-wipe the Flash workspace, use the `-e` option. +> * With the USB-COM adapter it is possible to write the main firmware (APP) immediately: +> ``` +> python3 rdwr_phy62x2.py -p COM11 -r we 0x10000 XXX_vXX.bin +> ``` -* Для предварительного стирания всей Flash используйте опцию `-a`. +## Saving the original firmware -* Для предварительного стирания рабочей области 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. Запустить: +1. Connect GND, TX, RX, RTS-RESET, VCC (+3.3B). +2. Run: ``` python3 rdwr_phy62x2.py -p COM11 -r rc 0x11000000 0x80000 ff_thb2.bin ``` -3. Полученный файл ff_thb2.bin сохранить. +3. Save the resulting ff_thb2.bin file. -## Восстановление оригинальной прошивки +## Restoring the original firmware -* Оригинальную Tuya прошивку на конкретный тип устройства можно взять по ссылкам в таблице, находящейся в самом начале README. +> Original Tuya firmware for a specific device type can be obtained from the links in the table at the beginning of this README. -1. Взять сохраненный файл ff_thb2.bin оригинальной прошивки. -2. Соединить GND, TX, RX, RTS–RESET, VCC (+3.3B). -3. Запустить: +1. Take the saved ff_thb2.bin file of the original firmware. +2. Connect GND, TX, RX, RTS-RESET, VCC (+3.3B). +3. Run: ``` python3 rdwr_phy62x2.py -p COM11 -b 1000000 -r we 0 ff_thb2.bin ``` -Не все адаптеры USB-COM поддерживают 1Mbit. Тогда удалите опцию `-b 1000000` или выберите другой Baud rate. +> Not all USB-COM adapters support 1Mbit. Then remove the `-b 1000000` option or select a different baud rate. -4. Прошивка зашита. Устройство работает. +4. The firmware has been flashed. The device works. -## Распределение Flash 512 килобайт +## 512 kilobyte flash allocation -| Адрес | Описание | Размер | +| Address | Description | Size | |---|---|---| -| 0x00000 | Используется ROM | 8 килобайт | -| 0x02000 | Boot Info для ROM | 4 килобайта | -| 0x03000 | FW Boot с функцией OTA | 52 килобайта | -| 0x10000 | FW APP | 128 килобайт | -| 0x30000 | Запись истории | 304 килобайт | -| 0x7C000 | Сохранение настроек (EEP) | 16 килобайт | +| 0x00000 | ROM used | 8 kilobytes | +| 0x02000 | Boot Info for ROM | 4 kilobytes | +| 0x03000 | FW Boot with OTA function | 52 kilobytes | +| 0x10000 | FW APP | 128 kilobytes | +| 0x30000 | History Recording | 304 kilobytes | +| 0x7C000 | Save Settings (EEP) | 16 kilobytes | 16 kilobytes | -## FW Boot и OTA +## FW Boot and OTA -* `FW Boot` имеет функцию OTA, но не имеет функции записи истории и прочих дополнений. Служит для обработки OTA при любых неудачных или неправильных обновлениях. +* `FW Boot` has an OTA function, but does not have a history function or any other add-ons. It is used to handle OTA for any failed or incorrect updates. -* `FW APP` не имеет функции OTA, для OTA перезагружается в `FW Boot`. Имеет дополнительные функции и расширения. +* `FW APP` has no OTA function, for OTA it reboots into `FW Boot`. It has additional features and extensions. -Поддерживаемые функции и сервисы описываются включенными битами в 32-х битном поле `dev_id.services`. +Supported features and services are described by the enabled bits in the 32-bit `dev_id.services` field. -`FW Boot` запускается по старту, и если не нажата кнопка, проверяет есть или нет запись `FW APP`. Если есть – запускает `FW APP`. Если кнопка при старте нажата - запускается `FW Boot`. +`FW Boot` starts on startup, and if no button is pressed, checks whether or not there is an `FW APP` entry. If there is, it starts `FW APP`. If the button is pressed at startup, `FW Boot` is started. -При соединении указывается: +When connected, it specifies: -_Software:_ **V**x.x - значит работает `FW APP` -_Software:_ **B**x.x - значит работает `FW Boot` +_Software:_ **V**x.x - means `FW APP` is running. +_Software:_ **B**x.x means `FW Boot` is running. -На термометрах с экраном, если не включено отображение времени, при первом старте показывает: +On screen thermometers, if time display is not enabled, the first startup shows: -* "Bot 12" - работает Boot версия 1.2 -* "APP 12" - работает APP версия 1.2 +* "Boot 12" - Boot version 1.2 is running. +* "APP 12" - APP version 1.2 is running. -Принудительно перезагрузиться в `FW Boot` из `FW APP` возможно двумя способами: +There are two ways to force a reboot to `FW Boot` from `FW APP`: -1. Отключить питание и удерживая кнопку включить питание. -2. Подать команду `7233` в меню `Service` программы PHY62x2BTHome.html и отключить соединение. +1. Switch off the power and hold down the button to switch on the power. +2. Issue the `7233` command in the `Service` menu of the PHY62x2BTHome.html program and disconnect the connection. -Полная перезагрузка - Подать команду `7201` в меню `Service` программы PHY62x2BTHome.html и отключить соединение. - -Через USB-UART адаптер App можно записать сразу после boot. Пример: +Complete reboot - Issue the `7201` command in the `Service` menu of the PHY62x2BTHome.html program and disconnect the connection. +Through USB-UART adapter, APP can be written immediately after boot. For example: ``` 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 ``` -## Событие Open/Close и счет импульсов +## Open/Close event and pulse counting -С версии 1.2 поддерживается опрос вывода подключенного к геркону или контакту, замыкающемуся на GND. +Since version 1.2 it is supported to poll a pin connected to a reed switch or a contact shorted to GND. -Максимальная частота переключения - 100 раз в секунду. +The maximum switching frequency is 100 times per second. -Если контакт имеет дребезг, тогда желательно зашунтировать контакт конденсатором. +If the contact is rattling, then it is advisable to shunt the contact with a capacitor. -При замыкании или размыкании передается блок из 5 BLE реклам следующих друг за другом через период в 50 мс. +When closing or opening, a block of 5 BLE adverts is transmitted following each other after a period of 50 ms. -При каждом событии "Open" прибавляется счетчик. +At each "Open" event a counter is added. -Значение счетчика передается совместно с каждым событием "Open/Close". +The counter value is transmitted together with each "Open/Close" event. -Входной контакт на плате термометра: +Input contact on the thermometer board: -* На [THB1](https://pvvx.github.io/THB1) - маркирован как `RX` -* На [THB2](https://pvvx.github.io/THB2) - маркирован как `RX` -* На [THB3](https://pvvx.github.io/THB3) - маркирован как `RX` -* На [BTH01](https://pvvx.github.io/BTH01/) - маркирован как `RX2` -* На [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) - маркирован как `RX0` -* На [TH05_V1.4](https://pvvx.github.io/TH-05) - маркирован как `RX2` +* On [THB1](https://pvvx.github.io/THB1) - labelled as `RX`. +* On [THB2](https://pvvx.github.io/THB2) - labelled as `RX`. +* On [THB3](https://pvvx.github.io/THB3) - labelled as `RX`. +* On [BTH01](https://pvvx.github.io/BTH01/) - labelled as `RX2`. +* On [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) - labelled as `RX0`. +* On [TH05_V1.4](https://pvvx.github.io/TH-05) - labelled as `RX2`. ![image](https://github.com/pvvx/THB2/assets/12629515/09f6f810-f2e2-4b61-9c84-f7c3770bb76a) ![image](https://github.com/pvvx/THB2/assets/12629515/40de4978-2d97-4f79-af9d-565236d0ba2a) -## Вывод управления внешним устройством по температуре и/или влажности +## Temperature and/or humidity control output of an external device -Контакт на печатной плате с маркировкой "TX" или "TX2" управляется с помощью уставок с гистерезисами по температуре и влажности. -Имеется возможность переключения на инверсное управление выводом. +The contact on the printed circuit board labelled "TX" or "TX2" is controlled with hysteresis setpoints for temperature and humidity. +It is possible to switch to inverse output control. -Настройка производится в PHY62x2BTHome.html. +The setting is made in PHY62x2BTHome.html. -Работа выхода назначается с помощью установки значения гистерезиса: +Output operation is assigned by setting the hysteresis value: -* Если значение гистерезиса равно нулю - переключений не будет. -* Если значение гистерезиса больше нуля - переключение (включение) произойдет при значении ниже уставка + гистерезис. -* Если значение гистерезиса меньше нуля - переключение (включение) произойдет при значении выше уставка + гистерезис. +* If the hysteresis value is zero, there will be no switching. +* If the hysteresis value is greater than zero - switching (switching on) will occur at a value lower than the setpoint + hysteresis. +* If the hysteresis value is less than zero - switching (switching on) will take place at a value higher than setpoint + hysteresis. -## Сброс основных настроек +## Reset basic settings -Для установки основных параметров в начальные значения берете смартфон с Android и программу "nRFConnect". -Соединяетесь с устройством и в сервис `0xFCD2` c характеристикой `0xFFF4` записываете `56`. +To reset basic parameters to initial values, take an Android smartphone and the "nRFConnect" app. +Connect to the device and in the service `0xFCD2` with characteristic `0xFFF4` write `56`. ![image](https://github.com/pvvx/THB2/assets/12629515/85cfaf06-e430-492e-930a-536afb163b5b) -* Нажатие/отпускание кнопки временно меняет интервал соединения для подключения. Коротко нажмите кнопку и подключитесь за 60 сек. Если не успеваете - нажимайте кнопку чаще... -* В прошивке проверяются все установки на соответствие стандартам Bluetooth SIG. -Если интервал более 10 сек, то поставит 10 сек - это максимум в стандарте. Так и другие параметры. -Но не все BT адаптеры могут работать с интервалом 10 сек для соединения. -* **При работе с BLE в Linux обязательно требуется изменение опций Bluez и/или патчи kernel!** +* Pressing/releasing the button temporarily changes the connection interval for connection. Press the button briefly and connect in 60 sec. If you don't have time, press the button more often... +* The firmware checks all settings for compliance with Bluetooth SIG standards. +If the interval is more than 10 sec, it will set 10 sec is the maximum in the standard. So do other settings. +But not all BT adapters can work with 10 sec interval for connection. +* **When working with BLE in Linux it is mandatory to change Bluez options and/or kernel patches!** --- -## Сборка прошивки +## Build Firmware -Для сборки прошивки используется GNU Arm Embedded Toolchain. +The GNU Arm Embedded Toolchain is used to build the firmware. -Для работы в Eclipce используете импорт проекта и установите toolchain.path. +To work in Eclipse, use project import and install toolchain.path. -Дополнительная информация по чипам [PHY62xx](https://github.com/pvvx/PHY62x2). +See [this](https://github.com/pvvx/PHY62x2) for more information on PHY62xx chips. From 69acac038d92e0f52a541d32c705adf7ed75d0e6 Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 15:58:35 +0200 Subject: [PATCH 11/12] Update README.md --- README.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index b156a78..56ce685 100644 --- a/README.md +++ b/README.md @@ -3,20 +3,21 @@ # BTHome THB1, THB2, THB3, BTH01, TH05 (HW: v1.3..1.6), TH05F -Custom firmware for Tuya devices based on the PHY622x2 chipset +Custom firmware for Tuya devices based on the PHY622x2 chipset. | [THB1](https://pvvx.github.io/THB1) | [THB2](https://pvvx.github.io/THB2) | [THB3](https://pvvx.github.io/THB3) | [BTH01](https://pvvx.github.io/BTH01/) | [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | [TH05_V1.4](https://pvvx.github.io/TH-05) | [TH05F](https://pvvx.github.io/TH05F) | |:---:|:---:|:---:|:---:|:---:|:---:|:---:| | ![THB1](https://pvvx.github.io/THB1/img/THB1.jpg) | ![THB2](https://pvvx.github.io/THB2/img/THB2.jpg) | ![THB3](https://pvvx.github.io/THB3/img/THB3.jpg) | ![BTH01](https://pvvx.github.io/BTH01/img/BTH01.jpg) | ![TH05V1.3](https://pvvx.github.io/TH05-v1.3/img/TH05-V1.3.jpg) | ![TH05V1.4](https://pvvx.github.io/TH-05/img/TH05V14.jpg) | ![TH05F](https://pvvx.github.io/TH05F/img/TH05F.jpg) -All firmware supports any of the sensors: CHT8215 (CHT8310), CHT8305, AHT20..30. +All firmware supports any of these sensors: CHT8215 (CHT8310), CHT8305, AHT20..30. -* Software for setting up and BLE OTA [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html). -* Uploading OTA files to [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) is automatic. You don't need to download files from this repository for OTA. -* To run [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) offline, just copy the [html](https://github.com/pvvx/THB2/blob/master/bthome_phy6222/web/PHY62x2BTHome.html) file to a local folder. +**Software for setting up and making BLE OTA: [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html).** +> Uploading OTA files to [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) is automatic. You don't need to download files from this repository for OTA. + +> To run [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) offline, just copy the [html](https://github.com/pvvx/THB2/blob/master/bthome_phy6222/web/PHY62x2BTHome.html) file to a local folder. ## Boot and App firmware -* The [Boot](https://github.com/pvvx/THB2?tab=readme-ov-file#fw-boot-%D0%B8-ota) firmware has minimal functions. Boot is used only for OTA - for downloading the full-featured version of APP (Application - *.bin files). +The [Boot](#fw-boot-and-ota) firmware has minimal functions. Boot is only used for downloading via OTA the full-featured version of APP (`.bin` files). * The device type can be distinguished externally by the smiley face symbol on the screen. | Device | Boot file | OTA file | Printed circuit board labelling | From 1e80645293bd9bb9d6024e90883caff42a430f7b Mon Sep 17 00:00:00 2001 From: Mlb <97614168+devmlb@users.noreply.github.com> Date: Sun, 30 Jun 2024 16:52:05 +0200 Subject: [PATCH 12/12] Cleaning README.md --- README.md | 82 +++++++++++++++++++++++++++++-------------------------- 1 file changed, 43 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index 56ce685..598fc0d 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ All firmware supports any of these sensors: CHT8215 (CHT8310), CHT8305, AHT20..3 **Software for setting up and making BLE OTA: [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html).** > Uploading OTA files to [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) is automatic. You don't need to download files from this repository for OTA. -> To run [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) offline, just copy the [html](https://github.com/pvvx/THB2/blob/master/bthome_phy6222/web/PHY62x2BTHome.html) file to a local folder. +> To run [PHY62x2BTHome.html](https://pvvx.github.io/THB2/web/PHY62x2BTHome.html) offline, just copy the [html](bthome_phy6222/web/PHY62x2BTHome.html) file to a local folder. ## Boot and App firmware @@ -30,24 +30,25 @@ The [Boot](#fw-boot-and-ota) firmware has minimal functions. Boot is only used f | [TH05_V1.3](https://pvvx.github.io/TH05-v1.3) | BOOT_TH05D_v17.hex | TH05D_v17.bin | RSH-TH05-V1.3 (chip: BL55072) | | [TH05F](https://pvvx.github.io/TH05F) | BOOT_TH05F_v17.hex | TH05F_v17.bin | TH05Y_V1.1, TH05Y_V1.2 (chip: QD01 2332 NT) | -The main firmware files, BOOT_XXX_vXX.hex for programming via USB-COM adapter and XXX_vXX.bin for OTA, are located in the [bin](https://github.com/pvvx/THB2/tree/master/bin) directory. +The main firmware files, BOOT_XXX_vXX.hex (for programming via USB-COM adapter) and XXX_vXX.bin (for OTA), are located in the [bin](bin) directory. -Files for updating boot via OTA are located in the [update_boot](https://github.com/pvvx/THB2/tree/master/update_boot) directory. **The process of updating boot via OTA is not safe. Please check the battery level before doing this. If boot is working fine, there is no need to update to the new version. The need to replace boot with a new version will be announced later.** +Files for updating boot via OTA are located in the [update_boot](update_boot) directory. **The process of updating boot via OTA is not safe. Please check the battery level before doing this. If boot is working fine, there is no need to update to the new version. The need to replace boot with a new version will be announced later.** -The current boot version is **v1.7** for devices with CHT8305 sensor. For other variants, boot is not required from version **v1.4**. +> The current boot version is **v1.7** for devices with CHT8305 sensor. For other variants, boot is not required from version **v1.4**. -## Main Features +## Main features -! _With default settings_ ! +**With default settings**: * BLE advertisement interval in [BTHome v2](https://bthome.io) format is 5 seconds. * Humidity and temperature sensor is polled every second BLE advertisement interval - period of 10 seconds. * Battery voltage measurement is done every minute. +* Recording of history every 30 minutes. * The button is used for quick connection to old BT adapters. Pressing the button switches the BLE advertising interval to a shorter period (1562.5ms). The action will continue for 60 seconds, then the interval will be restored to the one set in the settings. -* The measured average consumption from a 3.3V source when scanning THB2 and BTH01 thermometers in passive mode is up to 8 µA. For TH05_V1.4 the average consumption is about 23 µA - [this is the current of the installed components](https://github.com/pvvx/THB2/issues/8#issuecomment-1908982171). Other versions with screen: with LCD on - 12 to 14 µA, with LCD off - 7 to 12 µA. -* Recording of history every 30 minutes -* Connection interval with Connect Latency - 900ms -* Supported temperature and humidity sensors: AHT30, CHT8305, CHT8215, CHT8310. +* The measured average consumption from a 3.3V source when scanning THB2 and BTH01 thermometers in passive mode is up to 8 µA. + For TH05_V1.4 the average consumption is about 23 µA ([this is the current of the installed components](https://github.com/pvvx/THB2/issues/8#issuecomment-1908982171)). + Other versions with screen: 12 to 14 µA with LCD on and 7 to 12 µA with LCD off. +* Connection interval with Connect Latency (900ms). * Handling of input counter contact for transmitted [Open/Close events](https://github.com/pvvx/THB2/issues/10#issuecomment-1935169274) * Processing of output contact switchable by set temperature and/or humidity with hysteresis. * Support low-cost [BLE to Zigbee advertising repeater](https://github.com/pvvx/TLB2Z) @@ -56,20 +57,20 @@ The current boot version is **v1.7** for devices with CHT8305 sensor. For other | Version | Description | |---|--- | -| 1.0 | First release version | -| 1.1 | Added trigger - TX2 output triggered by set temperature and/or humidity values with hysteresis. Transmission of the state of the RX2 output when connected. For thermometers with screen added display of smiley face with "comfort". Added: change of device name and MAC. | -| 1.2 | Processing and transmission of open/close events with counter from the output labelled "RX2" (for THB2 - "RX1"). | -| 1.3 | Added THB1 and TH05V1.3. Next step to reduce consumption for versions with LCD display and option to switch off the display. | 1.4 | Added THB1 and TH05V1.3. -| 1.4 | Connection stabilisation for all device variants. Added [TH05F](https://pvvx.github.io/TH05F). Correction of RTC progress. Changed BLE name for TH05_V1.3 to "TH05D". Added files for OTA Boot update. | -| 1.5 | Added option to encrypt BLE ads with BindKey. | -| 1.6 | Added averaging of battery voltage calculation, duplication of open/close contact and counter status 12..20 sec (multiple of ad interval) after triggering and then every 30 min. | -| 1.7 | Error correction (> 42 C) for sensor CHT8305 | +| 1.0 | | +| 1.1 | | +| 1.2 | | +| 1.3 | +| 1.4 | | +| 1.5 | | +| 1.6 |