首頁>編程相關>其他源碼
下載

BTHome THB1、THB2、THB3、BTH01、TH05（五金：v1.3..1.6）、TH05F

基於 PHY622x2 晶片組的塗鴉設備客製化韌體。

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_v19.hex THB1_v19.bin不
2泰銖BOOT_THB2_v19.hex THB2_v19.bin不
3泰銖BOOT_THB2_v19.hex THB2_v19.bin不
BTH01 BOOT_BTH01_v19.hex BTH01_v19.bin不
TH05_V1.4 BOOT_TH05_v19.hex TH05_v19.bin TH05_V1.4、TH05_V1.5、TH05_V1.6（晶片：BL55028）
TH05_V1.3 BOOT_TH05D_v19.hex TH05D_v19.bin RSH-TH05-V1.3（晶片：BL55072）
TH05F BOOT_TH05F_v19.hex TH05F_v19.bin TH05Y_V1.1、TH05Y_V1.2（晶片：QD01 2332 NT）

主要韌體檔案 BOOT_XXX_vXX.hex（用於透過 USB-COM 適配器編程）和 XXX_vXX.bin（用於 OTA）位於 bin 目錄中。

透過 OTA 更新啟動的檔案位於 update_boot 目錄中。 **

所有裝置的目前“FW Boot”版本均為v1.9 （已修復錯誤）。

內部 GPIO 引腳排列：

韌體感測器 SDA/SCL/電源LCD SDA/SCL/電源鑰匙引領TRG(德州)輸入（接收）
1泰銖P18/P20/- P34/P33/- P01 - P09 P10
2泰銖P18/P20/- - P07 P26 P20 P18
3泰銖P18/P20/- P34/P33/- P01 - P09 P10
BTH01 P33/P34/P00 - P14 P15 P20 P18
TH05 P33/P34/P00 P33/P34/P02 P14 - P20 P18
TH05D P31/P32/- P11/P14/- P02 - P09 P10
TH05F P33/P34/P00 P26/P31/P02 P14 - P20 P18

主要特點

使用預設設定：

  • 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
  • 新增了以華氏度為單位的溫度顯示
1.9
  • 修復了斷電後恢復更改的設備名稱的問題

韌體

可透過具有 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
  1. 安裝python3和必要的函式庫： 
 pip3 install -r requirements.txt

  1. 從bin目錄下載特定設備所需的BOOT_XXX_vXX.hex檔案。

  2. 跑步： 

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

  1. 開機刷寫完成。設備正在運作並且可以斷開適配器。

  2. 透過 OTA 下載完整版韌體。為此：

    1. 給感測器通電。
    2. 轉至 PHY62x2BTHome.html。
    3. 點擊Connect按鈕，尋找設備並連接。
    4. 連接後，請前往OTA選項卡，選擇所需的韌體 ( .bin )，然後按Start 。

  3. 設備應重新啟動並可供使用。

選修的：

  • 若要預先擦除整個閃存，請使用-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
  1. 儲存產生的 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選項或選擇不同的波特率。

  1. 韌體已刷新並且設備應該可以工作。

快閃記憶體分配（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 晶片的更多信息，請參閱此內容。

展開
附加信息
相關應用
爲您推薦
相關資訊 全部
網友評論