Téléchargement THB2 - Téléchargement du code source THB2

2 THB

Autre code source

v1.8

Télécharger

BTHome THB1, THB2, THB3, BTH01, TH05 (matériel : v1.3..1.6), TH05F

Firmware personnalisé pour les appareils Tuya basé sur le chipset PHY622x2.

1 THB	2 THB	3 THB	BTH01	TH05_V1.3	TH05_V1.4	TH05F

Ce firmware fonctionne avec Home Assistant et d'autres logiciels fonctionnant au format BTHome.

Tous les firmwares prennent en charge n'importe lequel de ces capteurs : CHT8215 (CHT8310), CHT8305, AHT20..30.

Logiciel de mise en place et de réalisation de BLE OTA : PHY62x2BTHome.html.

Le téléchargement des fichiers OTA vers PHY62x2BTHome.html est automatique. Vous n'avez pas besoin de télécharger des fichiers depuis ce référentiel pour OTA.

Pour exécuter PHY62x2BTHome.html hors ligne, copiez simplement le fichier html dans un dossier local.

Premiers pas avec l'appareil

Pour travailler avec l'appareil, vous devez écrire le micrologiciel FW Boot sur l'appareil via un adaptateur USB-COM. Le micrologiciel de démarrage est un programme aux fonctionnalités réduites et fournit des mises à jour OTA sécurisées.

Ensuite, en utilisant la connexion BLE dans PHY62x2BTHome.html via l'onglet OTA, le programme d'exploitation principal de l' FW APP est enregistré.

FW APP peut également être enregistré à l’aide d’un adaptateur USB-COM.

Micrologiciel de démarrage et d'application

Le micrologiciel de démarrage a des fonctions minimales. FW Boot est uniquement utilisé pour télécharger via OTA la version complète de FW APP (fichiers .bin ).

Le type d'appareil peut être distingué de l'extérieur par le symbole du visage souriant sur l'écran.

Appareil	Fichier de démarrage	Fichier OTA	Étiquetage des circuits imprimés
1 THB	BOOT_THB1_v19.hex	THB1_v19.bin	Non
2 THB	BOOT_THB2_v19.hex	THB2_v19.bin	Non
3 THB	BOOT_THB2_v19.hex	THB2_v19.bin	Non
BTH01	BOOT_BTH01_v19.hex	BTH01_v19.bin	Non
TH05_V1.4	BOOT_TH05_v19.hex	TH05_v19.bin	TH05_V1.4, TH05_V1.5, TH05_V1.6 (puce : BL55028)
TH05_V1.3	BOOT_TH05D_v19.hex	TH05D_v19.bin	RSH-TH05-V1.3 (puce : BL55072)
TH05F	BOOT_TH05F_v19.hex	TH05F_v19.bin	TH05Y_V1.1, TH05Y_V1.2 (puce : QD01 2332 NT)

Les principaux fichiers du firmware, BOOT_XXX_vXX.hex (pour la programmation via un adaptateur USB-COM) et XXX_vXX.bin (pour OTA), se trouvent dans le répertoire bin.

Les fichiers de mise à jour du démarrage via OTA se trouvent dans le répertoire update_boot. **

La version actuelle de « FW Boot » est la v1.9 pour tous les appareils (erreurs corrigées).

Brochage GPIO interne :

Micrologiciel	Capteur SDA/SCL/Puissance	LCD SDA/SCL/alimentation	Clé	DIRIGÉ	TRG(TX)	DANS(RECEPTION)
1 THB	P18/P20/-	P34/P33/-	P01	-	P09	P10
2 THB	P18/P20/-	-	P07	P26	P20	P18
3 THB	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

Principales caractéristiques

Avec les paramètres par défaut :

L'intervalle de publicité BLE au format BTHome v2 est de 5 secondes.
Le capteur d'humidité et de température est interrogé tous les deux intervalles de publicité BLE - période de 10 secondes.
La mesure de la tension de la batterie est effectuée toutes les minutes.
Enregistrement de l'historique toutes les 30 minutes.
Le bouton est utilisé pour une connexion rapide aux anciens adaptateurs BT. En appuyant sur le bouton, l'intervalle de publicité BLE est réduit sur une période plus courte (1 562,5 ms). L'action se poursuivra pendant 60 secondes, puis l'intervalle sera rétabli à celui défini dans les paramètres.
La consommation moyenne mesurée à partir d'une source de 3,3 V lors du balayage des thermomètres THB2 et BTH01 en mode passif peut atteindre 8 µA.
Pour TH05_V1.4, la consommation moyenne est d'environ 23 µA (c'est le courant des composants installés). Autres versions avec écran : 12 à 14 µA avec LCD allumé et 7 à 12 µA avec LCD éteint.
Intervalle de connexion avec Connect Latency (900 ms).
Gestion du contact du compteur d'entrée pour les événements d'ouverture/fermeture transmis
Traitement du contact de sortie commutable par température et/ou humidité réglée avec hystérésis.
Prise en charge du répéteur publicitaire BLE vers Zigbee à faible coût

Historique des versions

Version	Description
1.0	Première version.
1.1	Déclencheur ajouté - Sortie TX2 déclenchée par des valeurs de température et/ou d'humidité définies avec hystérésis. Transmission de l'état de la sortie RX2 une fois connectée. Ajout de l'affichage du smiley avec "confort" pour les thermomètres avec écran. Nom de l'appareil et MAC modifiés.
1.2	Traitement et transmission des événements d'ouverture/fermeture avec compteur depuis la sortie étiquetée "RX2" (pour THB2 - "RX1").
1.3	Ajout de THB1 et TH05_V1.3. L'étape suivante consiste à réduire la consommation pour les versions avec écran LCD en ajoutant une option pour éteindre l'écran.
1.4	Connexion stabilisée pour toutes les variantes d'appareils. Ajout du TH05F. Correction de la progression du RTC. Changement du nom BLE pour TH05_V1.3 en "TH05D". Ajout de fichiers pour la mise à jour OTA Boot.
1,5	Ajout d'une option pour chiffrer les publicités BLE avec BindKey.
1.6	Ajout de la moyenne du calcul de la tension de la batterie Ajout de la duplication du contact ouvert/fermé Ajout du statut du compteur 12..20 sec (multiple d'intervalle d'annonce) après le déclenchement puis toutes les 30 min.
1.7	Correction d'une erreur (> 42 C) pour le capteur CHT8305
1.8	Ajout de l'affichage de la température en degrés Fahrenheit
1.9	Correction du bug de restauration du nom de l'appareil modifié après la réinitialisation de l'alimentation

Micrologiciel

Il est possible de flasher l'appareil avec le programme Boot via un adaptateur USB-COM avec sorties 3,3V.

Connectez GND, TX, RX, RTS-RESET, VCC (+3,3B) :

Adaptateur	Appareil
GND	-Vbat
+3,3V	+Vbat
Émission	RX1
RX	TX1
RTS	RÉINITIALISER

S'il n'y a pas de broche RST sur l'adaptateur, court-circuitez la broche RESET sur GND (-Vbat) et ouvrez-la rapidement au démarrage du script (cela peut prendre quelques essais).

Le nom des broches de l'appareil peut être trouvé dans la description sur les liens :

1 THB
2 THB
3 THB
BTH01
TH05_V1.3
TH05_V1.4

Installez python3 et les bibliothèques nécessaires :

 pip3 install -r requirements.txt

Téléchargez le fichier BOOT_XXX_vXX.hex requis pour le périphérique spécifique à partir du répertoire bin.
Courir:

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

Le flashage de démarrage est terminé. L'appareil est opérationnel et l'adaptateur peut être débranché.
Téléchargez la version complète du firmware via OTA. Pour ce faire :
1. Mettez le capteur sous tension.
2. Accédez à PHY62x2BTHome.html.
3. Cliquez sur le bouton Connect , recherchez l'appareil et connectez-vous.
4. Une fois connecté, allez dans l'onglet OTA , sélectionnez le firmware requis ( .bin ) et cliquez sur Start .
L'appareil doit redémarrer et être prêt à être utilisé.

Facultatif:
Pour pré-effacer l'intégralité du flash, utilisez l'option -a .
Pour pré-effacer l'espace de travail Flash, utilisez l'option -e .
Avec l'adaptateur USB-COM, il est possible d'écrire immédiatement le firmware principal (APP) :
 python3 rdwr_phy62x2.py -p COM11 -r we 0x10000 XXX_vXX.bin

Sauvegarde du firmware d'origine

Connectez GND, TX, RX, RTS-RESET, VCC (+3,3B).
Courir:

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

Enregistrez le fichier ff_thb2.bin résultant.

Restauration du firmware d'origine

Le micrologiciel Tuya original pour un type d'appareil spécifique peut être obtenu à partir des liens dans le tableau au début de ce README.

Prenez le fichier ff_thb2.bin enregistré du firmware d'origine.
Connectez GND, TX, RX, RTS-RESET, VCC (+3,3B).
Courir:

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

Tous les adaptateurs USB-COM ne prennent pas en charge 1 Mbit. Supprimez ensuite l'option -b 1000000 ou sélectionnez un débit en bauds différent.

Le firmware a été flashé et l'appareil devrait fonctionner.

Allocation Flash (512 kilo-octets)

Adresse	Description	Taille
0x00000	ROM utilisée	8 kilo-octets
0x02000	Informations de démarrage pour la ROM	4 kilo-octets
0x03000	FW Boot avec fonction OTA	52 kilo-octets
0x10000	APPLICATION FW	128 kilo-octets
0x30000	Enregistrement de l'historique	304 kilo-octets
0x7C000	Enregistrer les paramètres (EEP)	16 kilo-octets

Démarrage micrologiciel et OTA

FW Boot a une fonction OTA, mais n'a pas de fonction d'historique ni aucun autre module complémentaire. Il est utilisé pour gérer l’OTA pour toute mise à jour échouée ou incorrecte.
FW APP n'a pas de fonction OTA, pour OTA, il redémarre dans FW Boot . Il possède des fonctionnalités et des extensions supplémentaires.

Action du bouton lorsque l'appareil est allumé :

Si le bouton est enfoncé au démarrage, FW Boot démarre toujours.
Si le bouton n'est pas enfoncé, l'entrée FW APP est cochée ou non. S'il existe une FW APP , elle lance la FW APP . S'il n'y a pas de FW APP , FW Boot est lancé.

Sur les thermomètres à écran, si l'affichage de l'heure n'est pas activé, lors du démarrage ou du redémarrage, ce qui suit s'affiche pendant un court instant :

"Bot 14" - FW Boot version 1.4

"APP 15" - FW APP version 1.5

Il existe deux manières de forcer un redémarrage vers FW Boot à partir de FW APP :

Coupez l'alimentation et maintenez le bouton enfoncé pour remettre l'appareil sous tension.
Entrez la commande 7233 dans le menu Service du programme PHY62x2BTHome.html.

Redémarrage complet : Saisissez la commande 7201 dans le menu Service du programme PHY62x2BTHome.html.

Grâce à l'adaptateur USB-UART, l'application peut être écrite immédiatement après le démarrage. Par exemple:

 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

Événement d'ouverture/fermeture et comptage d'impulsions

Depuis la version 1.2, il est pris en charge pour interroger une broche connectée à un interrupteur à lames ou un contact court-circuité à GND.

La fréquence de commutation maximale est de 100 fois par seconde.

Si le contact tremble, il est conseillé de shunter le contact avec un condensateur.

A la fermeture ou à l'ouverture, un bloc de 5 annonces BLE est transmis les unes après les autres après une période de 50 ms.

A chaque événement "Open" un compteur est ajouté.

La valeur du compteur est transmise avec chaque événement "Ouvert/Fermé".

Contact d'entrée sur la carte thermomètre :

Sur THB1 - étiqueté RX .
Sur THB2 - étiqueté RX .
Sur THB3 - étiqueté RX .
Sur BTH01 - étiqueté RX2 .
Sur TH05_V1.3 - étiqueté RX0 .
Sur TH05_V1.4 - étiqueté RX2 .

Sortie de contrôle de température et/ou d'humidité d'un appareil externe

Le contact sur le circuit imprimé étiqueté « TX » ou « TX2 » est contrôlé avec des points de consigne d'hystérésis pour la température et l'humidité. Il est possible de passer au contrôle de sortie inverse.

Le paramétrage est effectué dans le programme PHY62x2BTHome.html.

Le fonctionnement de la sortie est attribué en définissant la valeur d'hystérésis :

Si la valeur d'hystérésis est nulle, il n'y aura pas de commutation.
Si la valeur d'hystérésis est supérieure à zéro, la commutation (mise sous tension) se fera à une valeur inférieure à la consigne + hystérésis.
Si la valeur d'hystérésis est inférieure à zéro, la commutation (mise sous tension) s'effectuera à une valeur supérieure à la consigne + hystérésis.

Réinitialiser les paramètres de base

Pour réinitialiser les paramètres de base aux valeurs initiales, munissez-vous d'un smartphone Android et de l'application « nRFConnect ». Connectez-vous à l'appareil et dans le service 0xFCD2 avec la caractéristique 0xFFF4 écrivez 56 .

Appuyer/relâcher le bouton modifie temporairement l'intervalle de connexion pour la connexion. Appuyez brièvement sur le bouton et connectez-vous en 60 secondes. Si vous n'avez pas le temps, appuyez plus souvent sur le bouton...
Le micrologiciel vérifie tous les paramètres pour vérifier leur conformité aux normes Bluetooth SIG.

Si l'intervalle est supérieur à 10 secondes, il sera défini sur 10 secondes car il s'agit du maximum dans la norme. Faites donc d’autres réglages. Cependant, tous les adaptateurs BT ne peuvent pas fonctionner avec un intervalle de 10 secondes pour la connexion.