humidity temperature sensor TH05F

BTHome THB1, THB2, THB3, BTH01, TH05 (HW: v1.3..1.6), TH05F

Dies ist ein Fork von:https://github.com/pvvx/THB2 Benutzerdefinierte Firmware für Tuya-Geräte basierend auf dem PHY622x2-Chipsatz.

Installationsschritte werden auch hier erklärt: https://youtu.be/AD2KduDTjf8

THB1	THB2	THB3	BTH01	TH05_V1.3	TH05_V1.4	TH05F

Diese Firmware funktioniert mit Home Assistant und anderer Software, die im BTHome-Format ausgeführt wird.

Die gesamte Firmware unterstützt einen dieser Sensoren: CHT8215 (CHT8310), CHT8305, AHT20..30.

Software zum Einrichten und Erstellen von BLE OTA: PHY62x2BTHome.html.

Das Hochladen von OTA-Dateien auf PHY62x2BTHome.html erfolgt automatisch. Für OTA müssen Sie keine Dateien aus diesem Repository herunterladen.

Um PHY62x2BTHome.html offline auszuführen, kopieren Sie einfach die HTML-Datei in einen lokalen Ordner.

Erste Schritte mit dem Gerät

Um mit dem Gerät arbeiten zu können, müssen Sie die FW Boot -Firmware über einen USB-COM-Adapter auf das Gerät schreiben. Boot-Firmware ist ein Programm mit eingeschränkter Funktionalität und bietet sichere OTA-Updates.

Anschließend wird mithilfe der BLE-Verbindung in PHY62x2BTHome.html über die Registerkarte OTA das Hauptbetriebsprogramm der FW APP aufgezeichnet.

• FW APP kann auch mit einem USB-COM-Adapter aufgezeichnet werden.

Boot- und App-Firmware

Die Boot-Firmware verfügt über minimale Funktionen. FW Boot wird nur zum Herunterladen der Vollversion der FW APP ( .bin Dateien) über OTA verwendet.

• Der Gerätetyp ist äußerlich am Smiley-Symbol auf dem Bildschirm zu erkennen.

Gerät	Boot-Datei	OTA-Datei	Beschriftung von Leiterplatten
THB1	BOOT_THB1_v18.hex	THB1_v18.bin	NEIN
THB2	BOOT_THB2_v18.hex	THB2_v18.bin	NEIN
THB3	BOOT_THB2_v18.hex	THB2_v18.bin	NEIN
BTH01	BOOT_BTH01_v18.hex	BTH01_v18.bin	NEIN
TH05_V1.4	BOOT_TH05_v18.hex	TH05_v18.bin	TH05_V1.4, TH05_V1.5, TH05_V1.6 (Chip: BL55028)
TH05_V1.3	BOOT_TH05D_v18.hex	TH05D_v18.bin	RSH-TH05-V1.3 (Chip: BL55072)
TH05F	BOOT_TH05F_v18.hex	TH05F_v18.bin	TH05Y_V1.1, TH05Y_V1.2 (Chip: QD01 2332 NT)

Die wichtigsten Firmware-Dateien BOOT_XXX_vXX.hex (für die Programmierung über USB-COM-Adapter) und XXX_vXX.bin (für OTA) befinden sich im bin-Verzeichnis.

Dateien zum Aktualisieren des Bootvorgangs über OTA befinden sich im Verzeichnis update_boot. Der Vorgang der Aktualisierung des Startvorgangs über OTA ist nicht sicher. Bitte prüfen Sie vorher den Batteriestand. Wenn der Start einwandfrei funktioniert, ist kein Update auf die neue Version erforderlich. Die Notwendigkeit, Boot durch eine neue Version zu ersetzen, wird später bekannt gegeben.

Die aktuelle FW Boot' version is **v1.7** for devices with CHT8305 sensor. For other variants, ist ab Version v1.4 kein FW-Boot erforderlich.

Hauptmerkmale

Mit Standardeinstellungen :

• Das BLE-Werbeintervall im BTHome v2-Format beträgt 5 Sekunden.
• Der Feuchtigkeits- und Temperatursensor wird in jedem zweiten BLE-Ankündigungsintervall abgefragt – Zeitraum von 10 Sekunden.
• Die Messung der Batteriespannung erfolgt jede Minute.
• Aufzeichnung der Historie alle 30 Minuten.
• Der Knopf dient der schnellen Verbindung mit alten BT-Adaptern. Durch Drücken der Taste wird das BLE-Werbeintervall auf einen kürzeren Zeitraum (1562,5 ms) umgeschaltet. Die Aktion wird 60 Sekunden lang fortgesetzt, dann wird das Intervall auf das in den Einstellungen festgelegte Intervall zurückgesetzt.
• Der gemessene durchschnittliche Verbrauch einer 3,3-V-Quelle beim Scannen der THB2- und BTH01-Thermometer im passiven Modus beträgt bis zu 8 µA.
  Für TH05_V1.4 beträgt der durchschnittliche Verbrauch etwa 23 µA (das ist der Strom der verbauten Komponenten). Andere Versionen mit Bildschirm: 12 bis 14 µA bei eingeschaltetem LCD und 7 bis 12 µA bei ausgeschaltetem LCD.
• Verbindungsintervall mit Verbindungslatenz (900 ms).
• Behandlung des Eingangszählerkontakts für übertragene Open/Close-Ereignisse
• Verarbeitung des Ausgangskontakts umschaltbar durch eingestellte Temperatur und/oder Luftfeuchtigkeit mit Hysterese.
• Unterstützt kostengünstige BLE-zu-Zigbee-Werbe-Repeater

Versionsverlauf

Version	Beschreibung
1,0	Erste Release-Version.
1.1	Trigger hinzugefügt – TX2-Ausgang wird durch eingestellte Temperatur- und/oder Feuchtigkeitswerte mit Hysterese ausgelöst. Übertragung des Status des RX2-Ausgangs bei Verbindung. Anzeige von Smiley-Gesicht mit „Komfort“ für Thermometer mit Bildschirm hinzugefügt. Gerätename und MAC geändert.
1.2	Verarbeitung und Übertragung von Öffnungs-/Schließereignissen mit Zähler vom Ausgang mit der Bezeichnung „RX2“ (für THB2 – „RX1“).
1.3	THB1 und TH05_V1.3 hinzugefügt. Der nächste Schritt besteht darin, den Verbrauch für Versionen mit LCD-Display zu senken, indem eine Option zum Ausschalten des Displays hinzugefügt wird.
1.4	Stabilisierte Verbindung für alle Gerätevarianten. TH05F hinzugefügt. RTC-Fortschritt behoben. BLE-Name für TH05_V1.3 in „TH05D“ geändert. Dateien für OTA-Boot-Update hinzugefügt.
1.5	Option zum Verschlüsseln von BLE-Anzeigen mit BindKey hinzugefügt.
1.6	Mittelung der Batteriespannungsberechnung hinzugefügt Duplizierung des Öffnungs-/Schließkontakts hinzugefügt Zählerstatus 12..20 Sek. (Vielfaches des Werbeintervalls) nach Auslösung und dann alle 30 Min. hinzugefügt.
1.7	Fehler (> 42 °C) für Sensor CHT8305 behoben
1,8beta	Anzeige der Temperatur in Grad Fahrenheit hinzugefügt

Firmware

Es ist möglich, das Gerät mit dem Boot-Programm über einen USB-COM-Adapter mit 3,3-V-Ausgängen zu flashen.

1. Verbinden Sie GND, TX, RX, RTS-RESET, VCC (+3,3B):

Adapter	Gerät
GND	-Vbat
+3,3V	+Vbat
TX	RX1
RX	TX1
RTS	ZURÜCKSETZEN

Wenn am Adapter kein RST-Pin vorhanden ist, schließen Sie den RESET-Pin mit GND (-Vbat) kurz und öffnen Sie ihn schnell, wenn das Skript startet (es kann einige Versuche dauern).

Die Bezeichnung der Pins am Gerät finden Sie in der Beschreibung unter den Links:

• THB1
• THB2
• THB3
• BTH01
• TH05_V1.3
• TH05_V1.4

2. Installieren Sie Python3 und die erforderlichen Bibliotheken:

 pip3 install -r requirements.txt

3. Laden Sie die für das jeweilige Gerät erforderliche Datei BOOT_XXX_vXX.hex aus dem bin-Verzeichnis herunter.

4. Laufen:

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

5. Das Boot-Flashen ist abgeschlossen. Das Gerät ist betriebsbereit und der Adapter kann abgezogen werden.

6. Laden Sie die Vollversion der Firmware über OTA herunter. Gehen Sie dazu wie folgt vor:

   1. Versorgen Sie den Sensor mit Strom.
   2. Gehen Sie zu PHY62x2BTHome.html.
   3. Klicken Sie auf die Schaltfläche Connect , suchen Sie nach dem Gerät und stellen Sie eine Verbindung her.
   4. Sobald die Verbindung hergestellt ist, gehen Sie zur Registerkarte OTA , wählen Sie die erforderliche Firmware ( .bin ) aus und klicken Sie auf Start .

7. Das Gerät sollte neu starten und betriebsbereit sein.

Optional:

• Um den gesamten Flash vorab zu löschen, verwenden Sie die Option -a .
• Um den Flash-Arbeitsbereich vorab zu löschen, verwenden Sie die Option -e .
• Mit dem USB-COM-Adapter ist es möglich, die Haupt-Firmware (APP) sofort zu schreiben:

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

Speichern der Original-Firmware

1. Verbinden Sie GND, TX, RX, RTS-RESET, VCC (+3,3 B).
2. Laufen:

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

3. Speichern Sie die resultierende Datei ff_thb2.bin.

Wiederherstellen der Original-Firmware

Die Original-Tuya-Firmware für einen bestimmten Gerätetyp kann über die Links in der Tabelle am Anfang dieser README-Datei bezogen werden.

1. Nehmen Sie die gespeicherte Datei ff_thb2.bin der Original-Firmware.
2. Verbinden Sie GND, TX, RX, RTS-RESET, VCC (+3,3 B).
3. Laufen:

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

Nicht alle USB-COM-Adapter unterstützen 1 Mbit. Entfernen Sie dann die Option -b 1000000 oder wählen Sie eine andere Baudrate.

4. Die Firmware wurde geflasht und das Gerät sollte funktionieren.

Flash-Zuteilung (512 Kilobyte)

Adresse	Beschreibung	Größe
0x00000	Verwendetes ROM	8 Kilobyte
0x02000	Boot-Info für ROM	4 Kilobyte
0x03000	FW-Boot mit OTA-Funktion	52 Kilobyte
0x10000	FW-APP	128 Kilobyte
0x30000	Verlaufsaufzeichnung	304 Kilobyte
0x7C000	Einstellungen speichern (EEP)	16 Kilobyte

FW-Boot und OTA

• FW Boot verfügt über eine OTA-Funktion, verfügt jedoch nicht über eine Verlaufsfunktion oder andere Add-Ons. Es wird verwendet, um OTA bei fehlgeschlagenen oder falschen Aktualisierungen zu behandeln.

• FW APP hat keine OTA-Funktion, für OTA startet es im FW Boot neu. Es verfügt über zusätzliche Funktionen und Erweiterungen.

Aktion der Taste beim Einschalten des Geräts:

• Wenn die Taste beim Start gedrückt wird, startet immer FW Boot .

• Wenn die Taste nicht gedrückt wird, wird der FW APP Eintrag überprüft oder nicht. Wenn eine FW APP vorhanden ist, wird die FW APP gestartet. Wenn keine FW APP vorhanden ist, wird FW Boot gestartet.

Bei Thermometern mit Bildschirm wird bei nicht eingeschalteter Zeitanzeige beim Start oder Neustart kurzzeitig Folgendes angezeigt:

„Bot 14“ – FW Boot Version 1.4

„APP 15“ – FW APP Version 1.5

Es gibt zwei Möglichkeiten, einen Neustart zum FW Boot von FW APP aus zu erzwingen:

1. Schalten Sie den Strom aus und halten Sie die Taste gedrückt, um den Strom einzuschalten.
2. Geben Sie den Befehl 7233 im Service des Programms PHY62x2BTHome.html ein.

Vollständiger Neustart: Geben Sie im Service des Programms PHY62x2BTHome.html den Befehl 7201 ein.

Über den USB-UART-Adapter kann die APP sofort nach dem Booten geschrieben werden. Zum Beispiel:

 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

Öffnen/Schließen-Ereignis und Impulszählung

Seit Version 1.2 wird die Abfrage eines mit einem Reed-Schalter verbundenen Pins oder eines mit GND kurzgeschlossenen Kontakts unterstützt.

Die maximale Schaltfrequenz beträgt 100 Mal pro Sekunde.

Wenn der Kontakt klappert, empfiehlt es sich, den Kontakt mit einem Kondensator zu überbrücken.

Beim Schließen oder Öffnen wird nach einer Zeitspanne von 50 ms ein Block von 5 BLE-Advertisements nacheinander gesendet.

Bei jedem „Offen“-Ereignis wird ein Zähler hinzugefügt.

Der Zählerstand wird zusammen mit jedem „Open/Close“-Ereignis übertragen.

Eingangskontakt auf der Thermometerplatine:

• Auf THB1 – gekennzeichnet als RX .
• Auf THB2 – gekennzeichnet als RX .
• Auf THB3 – gekennzeichnet als RX .
• Auf BTH01 – gekennzeichnet als RX2 .
• Auf TH05_V1.3 – gekennzeichnet als RX0 .
• Auf TH05_V1.4 – gekennzeichnet als RX2 .

Temperatur- und/oder Feuchtigkeitskontrollausgang eines externen Geräts

Der mit „TX“ oder „TX2“ beschriftete Kontakt auf der Leiterplatte wird mit Hysterese-Sollwerten für Temperatur und Luftfeuchtigkeit gesteuert. Es besteht die Möglichkeit, auf eine inverse Leistungsregelung umzuschalten.

Die Einstellung erfolgt im Programm PHY62x2BTHome.html.

Der Ausgangsbetrieb wird durch Einstellen des Hysteresewerts zugewiesen:

• Wenn der Hysteresewert Null ist, findet keine Umschaltung statt.
• Wenn der Hysteresewert größer als Null ist, erfolgt das Schalten (Einschalten) bei einem Wert, der kleiner ist als der Sollwert + Hysterese.
• Ist der Hysteresewert kleiner als Null, erfolgt die Umschaltung (Einschaltung) bei einem Wert größer als Sollwert + Hysterese.

Grundeinstellungen zurücksetzen

Um Grundparameter auf Ausgangswerte zurückzusetzen, nehmen Sie ein Android-Smartphone und die App „nRFConnect“. Verbinden Sie sich mit dem Gerät und schreiben Sie im Dienst 0xFCD2 mit der Charakteristik 0xFFF4 56 .

• Durch Drücken/Loslassen der Taste wird das Verbindungsintervall für die Verbindung vorübergehend geändert. Drücken Sie kurz die Taste und verbinden Sie sich in 60 Sekunden. Wenn Sie keine Zeit haben, drücken Sie den Knopf öfter...
• Die Firmware überprüft alle Einstellungen auf Übereinstimmung mit den Bluetooth SIG-Standards.

Wenn das Intervall mehr als 10 Sekunden beträgt, werden 10 Sekunden eingestellt, da dies das Maximum im Standard ist. Nehmen Sie auch andere Einstellungen vor. Allerdings können nicht alle BT-Adapter mit einem 10-Sekunden-Intervall für die Verbindung arbeiten.

• Bei der Arbeit mit BLE unter Linux ist es zwingend erforderlich, Bluez-Optionen und/oder Kernel-Patches zu ändern!

Firmware erstellen

Zum Erstellen der Firmware wird die GNU Arm Embedded Toolchain verwendet.

Um in Eclipse zu arbeiten, verwenden Sie den Projektimport und installieren Sie toolchain.path.

Weitere Informationen zu PHY62xx-Chips finden Sie hier.