ホーム>プログラミング関連>その他のソースコード
ダウンロード

BTHome THB1、THB2、THB3、BTH01、TH05 (HW: 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

このファームウェアは、ホーム アシスタントおよび 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 、 FW APPのフル機能バージョン ( .binファイル) を OTA 経由でダウンロードする場合にのみ使用されます。

  • デバイスのタイプは、画面上のスマイルマークによって外部から区別できます。
デバイスブートファイル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 経由でブートを更新するプロセスは安全ではありません。これを行う前にバッテリー残量を確認してください。ブートが正常に動作している場合は、新しいバージョンに更新する必要はありません。ブートを新しいバージョンに置き換える必要性については、後で発表されます。

FW Boot' version is **v1.7** for devices with CHT8305 sensor. For other variants,バージョンv1.4以降は「FW ブート」は必要ありません。

主な特長

デフォルト設定の場合:

  • BTHome v2 形式の BLE アドバタイズメント間隔は 5 秒です。
  • 湿度および温度センサーは、BLE アドバタイズメント間隔 (10 秒) ごとにポーリングされます。
  • バッテリー電圧の測定は 1 分ごとに行われます。
  • 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。
  • Connect Latency (900ms) での接続間隔。
  • 送信されたオープン/クローズイベントの入力カウンタ接点の処理
  • 設定温度・湿度によりヒステリシス付き出力接点を切替える処理。
  • Zigbee アドバタイジング リピーターへの低コストの BLE をサポート

バージョン履歴

バージョン説明
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) を接続します。
アダプタデバイス
GND -Vbat
+3.3V +Vbat
テキサス州RX1
RX TX1
RTSリセット

アダプターに RST ピンがない場合は、RESET ピンを GND (-Vbat) に短絡し、スクリプトの開始時にすぐに開きます (数回の試行がかかる場合があります)。

デバイスのピンの名前は、リンク先の説明に記載されています。

  • 1バーツ
  • 2バーツ
  • 3バーツ
  • BTH01
  • TH05_V1.3
  • TH05_V1.4
  1. python3 と必要なライブラリをインストールします。 
 pip3 install -r requirements.txt

  1. 特定のデバイスに必要な BOOT_XXX_vXX.hex ファイルを bin ディレクトリからダウンロードします。

  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 ファイルを保存します。

元のファームウェアの復元

特定のデバイス タイプ用のオリジナルの 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 アダプタが 1M ビットをサポートしているわけではありません。次に、 -b 1000000オプションを削除するか、別のボーレートを選択します。

  1. ファームウェアはフラッシュされており、デバイスは動作するはずです。

フラッシュ割り当て (512 キロバイト)

住所説明サイズ
0x00000使用ROM 8キロバイト
0x02000 ROMのブート情報4キロバイト
0x03000 OTA機能によるFWブート52キロバイト
0x10000 FWアプリ128キロバイト
0x30000履歴の記録304キロバイト
0x7C000設定の保存 (EEP) 16キロバイト

FWブートと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を強制的に再起動するには 2 つの方法があります。

  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 に短絡された接点のポーリングがサポートされています。

最大スイッチング周波数は 1 秒あたり 100 回です。

接点がガタつく場合は、接点をコンデンサで短絡することをお勧めします。

閉じるときまたは開くときに、5 つの BLE 広告のブロックが 50 ミリ秒後に連続して送信されます。

「Open」イベントごとにカウンターが追加されます。

カウンタ値は、各「Open/Close」イベントとともに送信されます。

温度計基板の入力接点:

  • 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 秒以内に接続します。時間がない場合は、ボタンを何度も押してください...
  • ファームウェアは、Bluetooth SIG 標準に準拠しているかどうかすべての設定をチェックします。

間隔が 10 秒を超える場合は、規格上の最大値である 10 秒が設定されます。他の設定も同様に行います。ただし、すべての BT アダプターが 10 秒の接続間隔で動作できるわけではありません。

  • Linux で BLE を使用する場合は、Bluez オプションやカーネル パッチを変更することが必須です。

ファームウェアの構築

ファームウェアの構築には、GNU Arm Embedded Toolchain が使用されます。

Eclipse で作業するには、プロジェクトのインポートを使用し、toolchain.path をインストールします。

PHY62xx チップの詳細については、これを参照してください。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて