humidity temperature sensor TH05F

BTHome THB1、THB2、THB3、BTH01、TH05（硬件：v1.3..1.6）、TH05F

这是来自：https://github.com/pvvx/THB2 的分支，用于基于 PHY622x2 芯片组的 Tuya 设备的自定义固件。

这里还解释了安装步骤：https://youtu.be/AD2KduDTjf8

1泰铢	2泰铢	3泰铢	BTH01	TH05_V1.3	TH05_V1.4	TH05F

该固件可与 Home Assistant 和其他以 BTHome 格式运行的软件配合使用。

所有固件均支持以下任何传感器：CHT8215 (CHT8310)、CHT8305、AHT20..30。

用于设置和制作 BLE OTA 的软件：PHY62x2BTHome.html。

上传 OTA 文件到 PHY62x2BTHome.html 是自动的。您无需从该存储库下载 OTA 文件。

要离线运行 PHY62x2BTHome.html，只需将 html 文件复制到本地文件夹即可。

开始使用设备

要使用该设备，您需要通过 USB-COM 适配器将FW Boot固件写入设备。启动固件是一个功能减少的程序，并提供安全的 OTA 更新。

接下来，通过OTA选项卡使用PHY62x2BTHome.html中的BLE连接，记录FW APP的主要操作程序。

• FW APP也可以使用 USB-COM 适配器进行录制。

启动和应用程序固件

启动固件的功能很少。 FW Boot仅用于通过OTA下载全功能版本的FW APP （ .bin文件）。

• 设备类型可以通过屏幕上的笑脸符号从外部区分。

设备	启动文件	OTA文件	印刷电路板贴标
1泰铢	BOOT_THB1_v18.hex	THB1_v18.bin	不
2泰铢	BOOT_THB2_v18.hex	THB2_v18.bin	不
3泰铢	BOOT_THB2_v18.hex	THB2_v18.bin	不
BTH01	BOOT_BTH01_v18.hex	BTH01_v18.bin	不
TH05_V1.4	BOOT_TH05_v18.hex	TH05_v18.bin	TH05_V1.4、TH05_V1.5、TH05_V1.6（芯片：BL55028）
TH05_V1.3	BOOT_TH05D_v18.hex	TH05D_v18.bin	RSH-TH05-V1.3（芯片：BL55072）
TH05F	BOOT_TH05F_v18.hex	TH05F_v18.bin	TH05Y_V1.1、TH05Y_V1.2（芯片：QD01 2332 NT）

主要固件文件 BOOT_XXX_vXX.hex（用于通过 USB-COM 适配器编程）和 XXX_vXX.bin（用于 OTA）位于 bin 目录中。

通过 OTA 更新启动的文件位于 update_boot 目录中。通过 OTA 更新启动的过程并不安全。执行此操作之前请检查电池电量。如果启动正常，则无需更新到新版本。需要用新版本替换 boot 的情况将在稍后公布。

FW Boot' version is **v1.7** for devices with CHT8305 sensor. For other variants,从版本v1.4开始不需要“FW boot”。

主要特点

使用默认设置：

• BTHome v2 格式的 BLE 通告间隔为 5 秒。
• 每隔 10 秒的 BLE 广告间隔就会对湿度和温度传感器进行轮询。
• 每分钟进行一次电池电压测量。
• 每 30 分钟记录一次历史记录。
• 该按钮用于快速连接旧的 BT 适配器。按下按钮将 BLE 广播间隔切换为更短的周期 (1562.5ms)。该动作将持续60秒，然后时间间隔将恢复至设置中设定的时间间隔。
• 在无源模式下扫描 THB2 和 BTH01 温度计时，从 3.3V 电源测得的平均功耗高达 8 µA。
  对于 TH05_V1.4，平均功耗约为 23 µA（这是已安装组件的电流）。其他带屏幕的版本：LCD 打开时为 12 至 14 µA，LCD 关闭时为 7 至 12 µA。
• 连接间隔和连接延迟 (900 毫秒)。
• 处理传输的打开/关闭事件的输入计数器触点
• 处理可通过设置温度和/或湿度（带滞后）切换的输出触点。
• 支持低成本BLE转Zigbee广告中继器

版本历史

版本	描述
1.0	第一个发布版本。
1.1	添加了触发器 - TX2 输出由具有滞后功能的设定温度和/或湿度值触发。连接时传输 RX2 输出的状态。 为带屏幕的温度计添加了“舒适”笑脸显示。 更改了设备名称和 MAC。
1.2	使用标记为“RX2”的输出（对于 THB2 -“RX1”）的计数器处理和传输打开/关闭事件。
1.3	添加了 THB1 和 TH05_V1.3。 下一步是通过添加关闭显示屏的选项来减少配备 LCD 显示屏的版本的功耗。
1.4	所有设备型号的稳定连接。 添加了TH05F。 修复了 RTC 进度。 将 TH05_V1.3 的 BLE 名称更改为“TH05D”。 添加了 OTA 启动更新的文件。
1.5	添加了使用 BindKey 加密 BLE 广告的选项。
1.6	增加了电池电压计算的平均值 添加了打开/关闭触点的重复 添加了触发后 12..20 秒（广告间隔的倍数）的计数器状态，然后每 30 分钟一次。
1.7	修复了传感器 CHT8305 的错误 (> 42 C)
1.8测试版	添加了以华氏度为单位的温度显示

固件

可以通过具有 3.3V 输出的 USB-COM 适配器使用引导程序刷新设备。

1. 连接GND、TX、RX、RTS-RESET、VCC（+3.3B）：

适配器	设备
接地	-Vbat
+3.3V	+Vbat
TX	接收1
接收	TX1
实时传输系统	重置

如果适配器上没有 RST 引脚，则将 RESET 引脚短接至 GND（-Vbat），并在脚本启动时快速打开（可能需要尝试几次）。

设备上引脚的名称可以在链接的描述中找到：

• 1泰铢
• 2泰铢
• 3泰铢
• BTH01
• TH05_V1.3
• TH05_V1.4

2. 安装python3和必要的库：

 pip3 install -r requirements.txt

3. 从bin目录中下载特定设备所需的BOOT_XXX_vXX.hex文件。

4. 跑步：

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

5. 开机刷写完成。设备正在运行并且可以断开适配器。

6. 通过 OTA 下载完整版固件。为此：

   1. 给传感器通电。
   2. 转至 PHY62x2BTHome.html。
   3. 单击Connect按钮，查找设备并连接。
   4. 连接后，转到OTA选项卡，选择所需的固件 ( .bin )，然后单击Start 。

7. 设备应重新启动并可供使用。

选修的：

• 要预擦除整个闪存，请使用-a选项。
• 要预擦除闪存工作区，请使用-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 文件。

恢复原来的固件

特定设备类型的涂鸦原始固件可以从本自述文件开头表格中的链接获取。

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选项或选择不同的波特率。

4. 固件已刷新并且设备应该可以工作。

闪存分配（512 KB）

地址	描述	尺寸
0x00000	使用的ROM	8 KB
0x02000	ROM 的启动信息	4 KB
0x03000	具有 OTA 功能的 FW Boot	52 KB
0x10000	固件APP	128 KB
0x30000	历史记录	304 KB
0x7C000	保存设置 (EEP)	16 KB

固件启动和 OTA

• FW Boot具有OTA功能，但没有历史记录功能或任何其他附加功能。它用于处理任何失败或不正确的更新的 OTA。

• FW APP没有 OTA 功能，OTA 时会重新启动到FW Boot 。它具有附加功能和扩展。

设备开启时按钮的操作：

• 如果在启动时按下该按钮， FW Boot始终启动。

• 如果不按下该按钮，则是否检查FW APP条目。如果有FW APP ，则启动FW APP 。如果没有FW APP ，则启动FW Boot 。

对于带屏幕的温度计，如果未打开时间显示，则在启动或重新启动期间会短时间显示以下内容：

“Bot 14”- FW Boot版本 1.4

“APP 15”- FW APP版本1.5

有两种方法可以从FW APP强制重新启动到FW Boot ：

1. 关闭电源并按住按钮即可打开电源。
2. 在 PHY62x2BTHome.html 程序的Service菜单中输入7233命令。

完全重启：在 PHY62x2BTHome.html 程序的Service菜单中输入7201命令。

通过USB-UART适配器，开机后即可立即写入APP。例如：

 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 次。

如果触点发出嘎嘎声，建议用电容器并联触点。

关闭或打开时，50 毫秒后会依次传输 5 个 BLE 广告块。

在每个“打开”事件中都会添加一个计数器。

计数器值与每个“打开/关闭”事件一起传输。

温度计板上的输入触点：

• 在 THB1 上 - 标记为RX 。
• 在 THB2 上 - 标记为RX 。
• 在 THB3 上 - 标记为RX 。
• 在 BTH01 上 - 标记为RX2 。
• 在 TH05_V1.3 上 - 标记为RX0 。
• 在 TH05_V1.4 上 - 标记为RX2 。

外部设备的温度和/或湿度控制输出

印刷电路板上标有“TX”或“TX2”的触点由温度和​​湿度的滞后设定点控制。可以切换到反向输出控制。

该设置是在 PHY62x2BTHome.html 程序中进行的。

通过设置迟滞值来分配输出操作：

• 如果滞后值为零，则不会发生切换。
• 如果迟滞值大于零，则将在低于设定点 + 迟滞的值处发生切换（接通）。
• 如果迟滞值小于零，则将在高于设定点 + 迟滞的值处进行切换（接通）。

重置基本设置

要将基本参数重置为初始值，请使用 Android 智能手机和“nRFConnect”应用程序。连接到设备并在具有特征0xFFF4的服务0xFCD2中写入56 。

• 按下/释放按钮可暂时更改连接的连接间隔。短按按钮并在 60 秒内连接。如果您没有时间，请多按几次按钮...
• 固件会检查所有设置是否符合蓝牙 SIG 标准。

如果间隔超过 10 秒，则将设置为 10 秒，因为这是标准中的最大值。其他设置也是如此。然而，并非所有 BT 适配器都可以以 10 秒间隔进行连接。

• 在 Linux 中使用 BLE 时，必须更改 Bluez 选项和/或内核补丁！

构建固件

GNU Arm 嵌入式工具链用于构建固件。

要在 Eclipse 中工作，请使用项目导入并安装 toolchain.path。

有关 PHY62xx 芯片的更多信息，请参阅此内容。