Download THB2 - Download do código-fonte THB2

THB2

Outro código-fonte

v1.8

Baixar

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

Firmware personalizado para dispositivos Tuya baseado no chipset PHY622x2.

THB1	THB2	THB 3	BTH01	TH05_V1.3	TH05_V1.4	TH05F

Este firmware funciona com Home Assistant e outros softwares executados no formato BTHome.

Todo firmware suporta qualquer um destes sensores: CHT8215 (CHT8310), CHT8305, AHT20..30.

Software para configurar e fazer BLE OTA: PHY62x2BTHome.html.

O upload de arquivos OTA para PHY62x2BTHome.html é automático. Você não precisa baixar arquivos deste repositório para OTA.

Para executar PHY62x2BTHome.html offline, basta copiar o arquivo html para uma pasta local.

Introdução ao dispositivo

Para trabalhar com o dispositivo, você precisa gravar o firmware FW Boot no dispositivo por meio de um adaptador USB-COM. O firmware de inicialização é um programa com funcionalidade reduzida e fornece atualizações OTA seguras.

A seguir, utilizando a conexão BLE em PHY62x2BTHome.html através da aba OTA, é gravado o principal programa operacional do FW APP .

FW APP também pode ser gravado usando um adaptador USB-COM.

Firmware de inicialização e aplicativo

O firmware de inicialização possui funções mínimas. FW Boot é usado apenas para baixar via OTA a versão completa do FW APP (arquivos .bin ).

O tipo de dispositivo pode ser distinguido externamente pelo símbolo de rosto sorridente na tela.

Dispositivo	Arquivo de inicialização	Arquivo OTA	Rotulagem de placas de circuito impresso
THB1	BOOT_THB1_v19.hex	THB1_v19.bin	não
THB2	BOOT_THB2_v19.hex	THB2_v19.bin	não
THB 3	BOOT_THB2_v19.hex	THB2_v19.bin	não
BTH01	BOOT_BTH01_v19.hex	BTH01_v19.bin	não
TH05_V1.4	BOOT_TH05_v19.hex	TH05_v19.bin	TH05_V1.4, TH05_V1.5, TH05_V1.6 (chip: BL55028)
TH05_V1.3	BOOT_TH05D_v19.hex	TH05D_v19.bin	RSH-TH05-V1.3 (chip: BL55072)
TH05F	BOOT_TH05F_v19.hex	TH05F_v19.bin	TH05Y_V1.1, TH05Y_V1.2 (chip: QD01 2332 NT)

Os principais arquivos de firmware, BOOT_XXX_vXX.hex (para programação via adaptador USB-COM) e XXX_vXX.bin (para OTA), estão localizados no diretório bin.

Os arquivos para atualização de inicialização via OTA estão localizados no diretório update_boot. **

A versão atual do `FW Boot' é v1.9 para todos os dispositivos (erros corrigidos).

Pinagem GPIO interna:

Firmware	Sensor SDA/SCL/Potência	LCD SDA/SCL/Alimentação	Chave	LIDERADO	TRG(TX)	ENTRADA(RX)
THB1	P18/P20/-	P34/P33/-	P01	-	P09	P10
THB2	P18/P20/-	-	P07	P26	P20	P18
THB 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

Principais características

Com configurações padrão :

O intervalo de anúncio BLE no formato BTHome v2 é de 5 segundos.
O sensor de umidade e temperatura é pesquisado a cada segundo intervalo de anúncio BLE - período de 10 segundos.
A medição da tensão da bateria é feita a cada minuto.
Gravação do histórico a cada 30 minutos.
O botão é usado para conexão rápida com adaptadores BT antigos. Pressionar o botão muda o intervalo de publicidade BLE para um período mais curto (1562,5ms). A ação continuará por 60 segundos, depois o intervalo será restaurado ao definido nas configurações.
O consumo médio medido de uma fonte de 3,3 V ao digitalizar os termômetros THB2 e BTH01 no modo passivo é de até 8 µA.
Para TH05_V1.4 o consumo médio é de cerca de 23 µA (esta é a corrente dos componentes instalados). Outras versões com tela: 12 a 14 µA com LCD ligado e 7 a 12 µA com LCD desligado.
Intervalo de conexão com latência de conexão (900ms).
Tratamento do contato do contador de entrada para eventos de abertura/fechamento transmitidos
Processamento do contato de saída comutável por temperatura e/ou umidade definida com histerese.
Suporta repetidor de publicidade BLE para Zigbee de baixo custo

Histórico de versões

Versão	Descrição
1,0	Primeira versão de lançamento.
1.1	Adicionado gatilho - saída TX2 acionada por valores definidos de temperatura e/ou umidade com histerese. Transmissão do estado da saída RX2 quando conectada. Adicionada exibição de carinha sorridente com “conforto” para termômetros com tela. Nome do dispositivo e MAC alterados.
1.2	Processamento e transmissão de eventos de abertura/fechamento com contador da saída denominada "RX2" (para THB2 - "RX1").
1.3	Adicionados THB1 e TH05_V1.3. O próximo passo é reduzir o consumo nas versões com display LCD, adicionando a opção de desligar o display.
1.4	Conexão estabilizada para todas as variantes de dispositivos. Adicionado TH05F. Corrigido o progresso do RTC. Nome BLE alterado para TH05_V1.3 para "TH05D". Adicionados arquivos para atualização de inicialização OTA.
1,5	Adicionada opção para criptografar anúncios BLE com BindKey.
1.6	Adicionada média do cálculo da tensão da bateria Adicionada duplicação de contato aberto/fechado Adicionado status do contador 12 a 20 segundos (múltiplo do intervalo do anúncio) após o acionamento e a cada 30 minutos.
1.7	Erro corrigido (> 42 C) para sensor CHT8305
1,8	Adicionada exibição de temperatura em graus Fahrenheit
1,9	Corrigido o bug de restaurar o nome do dispositivo alterado após a reinicialização da energia

Firmware

É possível atualizar o dispositivo com o programa Boot via adaptador USB-COM com saídas de 3,3V.

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

Adaptador	Dispositivo
GND	-Vbat
+3,3 V	+Vbat
Texas	RX1
RX	TX1
RTS	REINICIAR

Se não houver nenhum pino RST no adaptador, coloque o pino RESET em curto com GND (-Vbat) e abra-o rapidamente quando o script for iniciado (podem ser necessárias algumas tentativas).

O nome dos pinos do dispositivo pode ser encontrado na descrição nos links:

THB1
THB2
THB 3
BTH01
TH05_V1.3
TH05_V1.4

Instale o python3 e as bibliotecas necessárias:

 pip3 install -r requirements.txt

Baixe o arquivo BOOT_XXX_vXX.hex necessário para o dispositivo específico no diretório bin.
Correr:

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

O flash de inicialização está completo. O dispositivo está operacional e o adaptador pode ser desconectado.
Baixe a versão completa do firmware via OTA. Para fazer isso:
1. Aplique energia ao sensor.
2. Vá para PHY62x2BTHome.html.
3. Clique no botão Connect , procure o dispositivo e conecte-se.
4. Uma vez conectado, vá para a guia OTA , selecione o firmware necessário ( .bin ) e clique em Start .
O dispositivo deve reiniciar e estar pronto para uso.

Opcional:
Para limpar previamente todo o flash, use a opção -a .
Para limpar previamente o espaço de trabalho flash, use a opção -e .
Com o adaptador USB-COM é possível escrever o firmware principal (APP) imediatamente:
 python3 rdwr_phy62x2.py -p COM11 -r we 0x10000 XXX_vXX.bin

Salvando o firmware original

Conecte GND, TX, RX, RTS-RESET, VCC (+3,3B).
Correr:

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

Salve o arquivo ff_thb2.bin resultante.

Restaurando o firmware original

O firmware original do Tuya para um tipo de dispositivo específico pode ser obtido nos links da tabela no início deste README.

Pegue o arquivo ff_thb2.bin salvo do firmware original.
Conecte GND, TX, RX, RTS-RESET, VCC (+3,3B).
Correr:

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

Nem todos os adaptadores USB-COM suportam 1Mbit. Em seguida, remova a opção -b 1000000 ou selecione uma taxa de transmissão diferente.

O firmware foi atualizado e o dispositivo deve funcionar.

Alocação de flash (512 kilobytes)

Endereço	Descrição	Tamanho
0x00000	ROM usada	8 quilobytes
0x02000	Informações de inicialização para ROM	4 quilobytes
0x03000	Inicialização FW com função OTA	52 quilobytes
0x10000	APLICATIVO FW	128 quilobytes
0x30000	Gravação de histórico	304 quilobytes
0x7C000	Salvar configurações (EEP)	16 quilobytes

Inicialização FW e OTA

FW Boot possui uma função OTA, mas não possui uma função de histórico ou quaisquer outros complementos. Ele é usado para lidar com OTA em caso de atualizações incorretas ou com falha.
FW APP não tem função OTA, para OTA ele reinicia em FW Boot . Possui recursos e extensões adicionais.

Ação do botão quando o dispositivo está ligado:

Se o botão for pressionado na inicialização, FW Boot sempre será iniciado.
Se o botão não for pressionado, a entrada FW APP será verificada ou não. Se houver um FW APP , ele inicia o FW APP . Se não houver FW APP , FW Boot será iniciado.

Em termômetros com tela, se a exibição da hora não estiver ligada, durante a inicialização ou reinicialização, o seguinte será exibido por um breve período:

"Bot 14" - FW Boot versão 1.4

"APP 15" - FW APP versão 1.5

Existem duas maneiras de forçar a reinicialização do FW Boot a partir FW APP :

Desligue a energia e mantenha pressionado o botão para ligá-la.
Digite o comando 7233 no menu Service do programa PHY62x2BTHome.html.

Reinicialização completa: Digite o comando 7201 no menu Service do programa PHY62x2BTHome.html.

Através do adaptador USB-UART, o APP pode ser gravado imediatamente após a inicialização. Por exemplo:

 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

Evento de abertura/fechamento e contagem de pulsos

Desde a versão 1.2 é suportado o polling de um pino conectado a um reed switch ou um contato em curto com GND.

A frequência máxima de comutação é de 100 vezes por segundo.

Se o contato estiver chacoalhando, é aconselhável desviar o contato com um capacitor.

Ao fechar ou abrir, um bloco de 5 anúncios BLE é transmitido um após o outro após um período de 50 ms.

A cada evento “Aberto” é adicionado um contador.

O valor do contador é transmitido junto com cada evento "Abrir/Fechar".

Contato de entrada na placa do termômetro:

No THB1 - rotulado como RX .
No THB2 - rotulado como RX .
No THB3 - rotulado como RX .
No BTH01 - rotulado como RX2 .
Em TH05_V1.3 - rotulado como RX0 .
Em TH05_V1.4 - rotulado como RX2 .

imagem

Saída de controle de temperatura e/ou umidade de um dispositivo externo

O contato na placa de circuito impresso identificado como “TX” ou “TX2” é controlado com pontos de ajuste de histerese para temperatura e umidade. É possível mudar para controle de saída inverso.

A configuração é feita no programa PHY62x2BTHome.html.

A operação de saída é atribuída definindo o valor da histerese:

Se o valor da histerese for zero, não haverá comutação.
Se o valor da histerese for maior que zero, a comutação (ligação) ocorrerá em um valor inferior ao setpoint + histerese.
Se o valor da histerese for menor que zero, a comutação (ligação) ocorrerá em um valor superior ao setpoint + histerese.

Redefinir configurações básicas

Para redefinir os parâmetros básicos para os valores iniciais, use um smartphone Android e o aplicativo "nRFConnect". Conecte-se ao dispositivo e no serviço 0xFCD2 com característica 0xFFF4 escreva 56 .

imagem

Pressionar/soltar o botão altera temporariamente o intervalo de conexão para conexão. Pressione o botão brevemente e conecte em 60 segundos. Se não tiver tempo, aperte o botão com mais frequência...
O firmware verifica todas as configurações quanto à conformidade com os padrões Bluetooth SIG.

Se o intervalo for superior a 10 segundos, será definido 10 segundos, pois é o máximo no padrão. O mesmo acontece com outras configurações. Porém, nem todos os adaptadores BT podem funcionar com intervalo de 10 segundos para conexão.