{"id":61,"date":"2026-10-10T14:59:21","date_gmt":"2026-10-10T14:59:21","guid":{"rendered":"https:\/\/sfelectronica.com\/bit\/?p=61"},"modified":"2026-10-10T15:06:17","modified_gmt":"2026-10-10T15:06:17","slug":"estacao-termo-estacao-ambiental-redonda-com-esp32-bme280-e-display-gc9a01","status":"publish","type":"post","link":"https:\/\/sfelectronica.com\/bit\/estacao-termo-estacao-ambiental-redonda-com-esp32-bme280-e-display-gc9a01\/","title":{"rendered":"Esta\u00e7\u00e3o Termo: esta\u00e7\u00e3o ambiental redonda com ESP32, BME280 e display GC9A01"},"content":{"rendered":"\n\n\n\n\n

A Esta\u00e7\u00e3o Termo<\/strong> mede o ambiente da casa num s\u00f3 s\u00edtio: temperatura, humidade relativa e absoluta, ponto de orvalho, press\u00e3o e altitude, calculadas a partir de um \u00fanico BME280<\/strong> e apresentadas num display redondo de 1,28 polegadas<\/strong>. Um ESP32<\/strong> com ESPHome<\/strong> desenha tudo, sincroniza a hora com o Home Assistant e apaga o ecr\u00e3 quando ningu\u00e9m est\u00e1 a ver. Tudo local, sem nuvem e sem subscri\u00e7\u00f5es.<\/p>\n\n\n\n

\n\n\t
Projeto<\/span>Esta\u00e7\u00e3o Termo (Esta\u00e7\u00e3o RC)<\/span><\/div>\n\n\t
Hardware<\/span>ESP32 \u00b7 BME280 \u00b7 Display GC9A01 1,28″ \u00b7 Tecla<\/span><\/div>\n\n\t
Firmware<\/span>ESPHome (min. 2024.6.0)<\/span><\/div>\n\n\t
Plataforma<\/span>Home Assistant<\/span><\/div>\n\n\t
Ficheiro<\/span>estacao_termo.yaml<\/span><\/div>\n\n\t
Rede<\/span>IP est\u00e1tico 192.168.1.238 \u00b7 captive portal<\/span><\/div>\n\n\t
Nuvem<\/span>Nenhuma \u2014 100% local<\/span><\/div>\n\n<\/div>\n\n\n\n
\n\n\t

Neste artigo<\/p>\n\n\t

    \n\n\t\t
  1. Vis\u00e3o geral do sistema<\/a><\/li>\n\n\t\t
  2. Hardware e esquema de liga\u00e7\u00e3o<\/a><\/li>\n\n\t\t
  3. Mapeamento dos GPIO<\/a><\/li>\n\n\t\t
  4. O YAML, bloco a bloco<\/a><\/li>\n\n\t\t
  5. Rede, gest\u00e3o e atualiza\u00e7\u00f5es<\/a><\/li>\n\n\t\t
  6. Instala\u00e7\u00e3o passo a passo<\/a><\/li>\n\n\t\t
  7. No Home Assistant<\/a><\/li>\n\n\t\t
  8. Diagn\u00f3stico e boas pr\u00e1ticas<\/a><\/li>\n\n\t\t
  9. Conclus\u00e3o<\/a><\/li>\n\n\t<\/ol>\n\n<\/div>\n\n\n\n

    Vis\u00e3o geral do sistema<\/h2>\n\n\n\n

    A ideia \u00e9 ter uma esta\u00e7\u00e3o meteorol\u00f3gica de interior<\/strong> que responda a duas perguntas: como est\u00e1 o ar da casa agora, e o que \u00e9 preciso fazer a respeito disso. Um \u00fanico BME280<\/strong> d\u00e1 temperatura, press\u00e3o e humidade relativa; o YAML faz o resto \u2014 humidade absoluta em g\/m\u00b3, ponto de orvalho e altitude calculadas a partir desses tr\u00eas valores, sem sensores adicionais.<\/p>\n\n\n\n

    O que distingue o projeto n\u00e3o \u00e9 o sensor, \u00e9 a forma como apresenta os dados<\/strong>: um display redondo de 1,28 polegadas onde o fundo \u00e9 uma imagem desenhada \u00e0 m\u00e3o (setores, \u00edcones, zonas) e o ESPHome escreve apenas os n\u00fameros por cima. O resultado l\u00ea-se de relance \u2014 temperatura em destaque no topo, hora por baixo, humidade \u00e0 esquerda, g\/m\u00b3 e ponto de orvalho \u00e0 direita, press\u00e3o e altitude na base \u2014 com o estado Online\/Offline<\/em> sempre vis\u00edvel.<\/p>\n\n\n\n

      \n
    • 240\u00d7240<\/strong> <\/span>Display redondo GC9A01A de 1,28″, SPI a 20\u00a0MHz<\/span><\/li>\n\n\n\n
    • 6<\/strong> <\/span>Grandezas no ecr\u00e3: temperatura, humidade, orvalho, g\/m\u00b3, press\u00e3o e altitude<\/span><\/li>\n\n\n\n
    • 60s <\/strong>Intervalo de leitura do BME280 (com offset de calibra\u00e7\u00e3o)<\/span><\/li>\n\n\n\n
    • 0<\/strong> <\/span>Servi\u00e7os externos ou depend\u00eancia da nuvem<\/span><\/li>\n<\/ul>\n\n\n\n

      O ecr\u00e3 n\u00e3o est\u00e1 sempre ligado: uma tecla<\/strong> acorda a retroilumina\u00e7\u00e3o a 100%, e depois de 20 segundos o display volta a baixar e a apagar-se sozinho. A retroilumina\u00e7\u00e3o \u00e9 tamb\u00e9m uma entidade light<\/em> no Home Assistant, portanto d\u00e1 para ligar, desligar e regular a luminosidade \u00e0 dist\u00e2ncia \u2014 ou por automa\u00e7\u00e3o, sem tocar em nada.<\/p>\n\n\n\n

      Hardware e esquema de liga\u00e7\u00e3o<\/h2>\n\n\n\n

      A lista de materiais \u00e9 curta \u2014 o projeto \u00e9 barato porque \u00e9 essencial:<\/p>\n\n\n\n

        \n
      • Placa ESP32<\/strong> (board: esp32dev<\/code>) \u2014 sobram pinos para o SPI, o I\u00b2C, a tecla e a retroilumina\u00e7\u00e3o.<\/li>\n\n\n\n
      • BME280<\/strong> \u2014 temperatura, press\u00e3o e humidade relativa num \u00fanico chip, por I\u00b2C. Cuidado: o BMP280<\/strong> \u00e9 quase igual e n\u00e3o mede humidade<\/em> \u2014 n\u00e3o confundir as siglas na compra.<\/li>\n\n\n\n
      • Display redondo TENSTAR ROBOT de 1,28″<\/strong> \u2014 240\u00d7240 pixels, controlador GC9A01A<\/strong>, interface SPI at\u00e9 20\u00a0MHz, com retroilumina\u00e7\u00e3o pr\u00f3pria.<\/li>\n\n\n\n
      • Tecla<\/strong> de contacto com pull-up<\/em> externo de 10\u00a0k\u03a9 \u2014 o GPIO usado \u00e9 de entrada pura e n\u00e3o tem resist\u00eancias internas.<\/li>\n\n\n\n
      • Dois ficheiros de assets<\/em><\/strong> ao lado do YAML: a imagem de fundo do ecr\u00e3 (icons\/imageround.png<\/code>) e a fonte Helvetica.ttf<\/code>. Sem eles, o ESPHome nem compila.<\/li>\n\n\n\n
      • Fonte 5\u00a0V<\/strong> \u2014 o regulador 3,3\u00a0V da pr\u00f3pria placa alimenta o display e o sensor; CAIXA com janela redonda ou suporte de bancada.<\/li>\n<\/ul>\n\n\n\n
        \"Esquema
        Liga\u00e7\u00e3o completa: ESP32 ao centro, sensor \u00e0 esquerda, display e tecla \u00e0 direita<\/figcaption><\/figure>\n\n\n\n
        \n\t!<\/span>\n\t

        Tr\u00eas erros de bancada que custam uma tarde:<\/strong> alimentar o display a 5 V (os m\u00f3dulos GC9A01 queimam \u2014 usa o 3,3 V da placa); esquecer o pull-up<\/em> da tecla no GPIO35<\/code>, que \u00e9 input-only<\/em> e n\u00e3o tem resist\u00eancia interna; e montar o BME280 coladinho ao ESP32, onde l\u00ea sempre 2\u20133 \u00b0C a mais.<\/p>\n<\/div>\n\n\n\n

        Mapeamento dos GPIO<\/h2>\n\n\n\n

        Nove pinos em uso, divididos por barramentos \u2014 SPI para o ecr\u00e3, I\u00b2C para o sensor e dois pinos avulsos para a retroilumina\u00e7\u00e3o e a tecla:<\/p>\n\n\n\n

        Sinal<\/th>GPIO<\/th>Dire\u00e7\u00e3o<\/th>Fun\u00e7\u00e3o<\/th><\/tr><\/thead>
        SPI MOSI<\/strong><\/td>GPIO27<\/td>Sa\u00edda<\/td>Dados do display (sem MISO \u2014 \u00e9 write-only)<\/td><\/tr>
        SPI CLK<\/strong><\/td>GPIO14<\/td>Sa\u00edda<\/td>Clock SPI a 20 MHz<\/td><\/tr>
        SPI CS<\/strong><\/td>GPIO33<\/td>Sa\u00edda<\/td>Chip select do GC9A01A<\/td><\/tr>
        SPI DC<\/strong><\/td>GPIO25<\/td>Sa\u00edda<\/td>Distin\u00e7\u00e3o dados\/comandos<\/td><\/tr>
        SPI RST<\/strong><\/td>GPIO26<\/td>Sa\u00edda<\/td>Reset do controlador<\/td><\/tr>
        I\u00b2C SDA<\/strong><\/td>GPIO21<\/td>Bidirecional<\/td>BME280 (endere\u00e7o 0x76)<\/td><\/tr>
        I\u00b2C SCL<\/strong><\/td>GPIO22<\/td>Sa\u00edda<\/td>Rel\u00f3gio do barramento<\/td><\/tr>
        Backlight<\/strong><\/td>GPIO32<\/td>Sa\u00edda PWM (LEDC)<\/td>Retroilumina\u00e7\u00e3o \u2014 entidade light<\/em><\/td><\/tr>
        Tecla<\/strong><\/td>GPIO35<\/td>Entrada (inverted<\/em>)<\/td>Acorda e apaga o ecr\u00e3<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        N\u00e3o h\u00e1 fio MISO no SPI porque o display nunca devolve dados: escreve e cala-se, o que tamb\u00e9m permite correr o barramento ao ritmo m\u00e1ximo sem seguran\u00e7as. O I\u00b2C \u00e9 o cl\u00e1ssico SDA 21<\/code> \/ SCL 22<\/code> com scan: true<\/code>, para que o endere\u00e7o apare\u00e7a no log na primeira arrancada.<\/p>\n\n\n\n

        O YAML, bloco a bloco<\/h2>\n\n\n\n

        O estacao_termo.yaml<\/code> separa-se bem: primeiro o ecr\u00e3, depois os sensores, depois as contas e por fim a retroilumina\u00e7\u00e3o. Estes s\u00e3o os excertos que interessam:<\/p>\n\n\n\n

        O display redondo: GC9A01A sobre SPI<\/h3>\n\n\n
        spi:\n  mosi_pin: GPIO27\n  clk_pin: GPIO14\n\nspi_device:\n  id: spidev\n  data_rate: 20<\/span>MHz\n\ndisplay:\n  - platform: ili9xxx\n    model: gc9a01a\n    invert_colors: true<\/span>\n    auto_clear_enabled: false<\/span>\n    id: gca901_display\n    cs_pin: GPIO33\n    dc_pin: GPIO25\n    reset_pin: GPIO26\n    rotation: 180<\/span>\n    lambda: |-\n      it.image(0<\/span>, 0<\/span>, id(img_back));\n\n      it.strftime(33<\/span>, 65<\/span>, id(helvetica_18), id(my_green), TextAlign::LEFT,\n                  \"%Y-%m-%d  %H:%M:%S\"<\/span>, id(esptime).now());\n\n      it.printf(97<\/span>, 25<\/span>, id(helvetica_24), \"%.1f \u00b0C\"<\/span>, id(bme280_temperature).state);\n      it.printf(46<\/span>, 112<\/span>, id(helvetica_24), \"%.1f %%\"<\/span>, id(bme280_humidity).state);\n\n      if<\/span> (id(system_status).state) {\n        it.print<\/span>(135<\/span>, 1<\/span>, id(helvetica_12), id(my_green), TextAlign::TOP_RIGHT, \"Online\"<\/span>);\n      } else<\/span> {\n        it.print<\/span>(135<\/span>, 1<\/span>, id(helvetica_12), id(my_red), TextAlign::TOP_RIGHT, \"Offline\"<\/span>);\n      }<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
        \n\tOK<\/span>\n\t
        Porqu\u00ea auto_clear_enabled: false<\/code>?<\/strong> Porque o fundo do ecr\u00e3 \u00e9 uma imagem que n\u00e3o muda: em vez de o ESPHome limpar o buffer a cada refresh<\/em> e voltar a desenhar tudo (vis\u00edvel como um relampejo), mant\u00e9m-se o buffer e escrevem-se apenas os n\u00fameros que mudam. Menos trabalho de CPU, ecr\u00e3 mais est\u00e1vel \u2014 e \u00e9 por isso que a lambda<\/code> come\u00e7a sempre com it.image(...)<\/code>.<\/p>\n<\/div>\n\n\n\n
        As restantes linhas do ecr\u00e3 seguem o mesmo padr\u00e3o \u2014 press\u00e3o em (20, 160), altitude em (135, 160), humidade absoluta em (160, 105) e ponto de orvalho em (160, 130) \u2014 todas com it.printf<\/code> e as coordenadas afinadas para assentar nas zonas do fundo.<\/p>\n\n\n\n
        O fundo \u00e9 uma imagem, n\u00e3o c\u00f3digo<\/h3>\n\n\n
        image:\n  - file: \"icons\/imageround.png\"<\/span>\n    id: img_back\n    type: RGB\n    transparency: alpha_channel\n\nfont:\n  - file: \"Helvetica.ttf\"<\/span>\n    id: helvetica_24\n    size: 24<\/span>\n  # helvetica_18, helvetica_14 e helvetica_12 no mesmo padr\u00e3o<\/span>\n\ncolor:\n  - id: my_green\n    red: 0<\/span>%\n    green: 100<\/span>%\n    blue: 0<\/span>%\n  # my_red, my_yellow, my_blue e my_gray no mesmo padr\u00e3o<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
        A imagem de fundo traz os setores, os \u00edcones (term\u00f3metro, gota, montanha, b\u00fassola) e as molduras prontas \u2014 o ESPHome s\u00f3 recebe a tarefa de p\u00f4r o texto certo em cada zona. Fazer o desenho num editor e deixar ao firmware apenas os n\u00fameros \u00e9 muito mais simples do que tentar construir a interface toda com it.line()<\/code> e it.rectangle()<\/code>.<\/p>\n\n\n\n
        \"Ecr\u00e3
        O resultado no ecr\u00e3: imagem de fundo com os valores do BME280 escritos por cima<\/figcaption><\/figure>\n\n\n\n
        \n\tOK<\/span>\n\t
        O ficheiro de imagem tem de ficar na pasta do projeto, em icons\/imageround.png<\/code>, e a fonte em Helvetica.ttf<\/code> ao lado do YAML \u2014 o ESPHome copia ambos para a placa na compila\u00e7\u00e3o. Se mudares o fundo, mant\u00e9m a mesma janela circular de 240\u00d7240 e refaz s\u00f3 as coordenadas do texto.<\/p>\n<\/div>\n\n\n\n
        O BME280 e o que ele d\u00e1 de borla<\/h3>\n\n\n
        i2c:\n  sda: 21<\/span>\n  scl<\/span>: 22<\/span>\n  scan<\/span>: true<\/span>\n  id<\/span>: bus_a\n\nsensor<\/span>:\n  - platform: bme280_i2c\n    temperature<\/span>:\n      name: \"BME Temperatura\"<\/span>\n      oversampling<\/span>: 1<\/span>x\n      filters<\/span>:\n        - offset: -2<\/span>\n      id<\/span>: bme280_temperature\n    pressure<\/span>:\n      name: \"BME Press\u00e3o\"<\/span>\n      oversampling<\/span>: 1<\/span>x\n      id<\/span>: bme280_pressure\n    humidity<\/span>:\n      name: \"BME280 Humidade Relativa\"<\/span>\n      oversampling<\/span>: 1<\/span>x\n      id<\/span>: bme280_humidity\n    address<\/span>: 0x76<\/span>\n    update_interval<\/span>: 60<\/span>s<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        Tr\u00eas valores por um chip s\u00f3, com oversampling: 1x<\/code> para leituras r\u00e1pidas e um offset: \u22122<\/code> aplicado \u00e0 temperatura \u2014 o suficiente para corrigir o calor que o pr\u00f3prio m\u00f3dulo devolve. O endere\u00e7o 0x76<\/code> \u00e9 o do m\u00f3dulo em quest\u00e3o; muitos BME280 v\u00eam de f\u00e1brica em 0x77<\/code>, por isso vale a pena deixar o scan: true<\/code> ligado pelo menos na primeira arrancada.<\/p>\n\n\n\n
        Grandezas derivadas: altitude, g\/m\u00b3 e ponto de orvalho<\/h3>\n\n\n
        sensor:\n  - platform: template\n    name<\/span>: \"Altitude\"<\/span>\n    id<\/span>: bme_altitude\n    lambda<\/span>: |-\n      const<\/span> float STANDARD_SEA_LEVEL_PRESSURE = 1013.25<\/span>; \/\/ em hPa<\/span>\n      return<\/span> ((id(bme280_temperature).state + 273.15<\/span>) \/ 0.0065<\/span>) *\n        (powf((STANDARD_SEA_LEVEL_PRESSURE \/ id(bme280_pressure).state), 0.190234<\/span>) - 1<\/span>);\n    update_interval: 60<\/span>s\n    unit_of_measurement<\/span>: 'm'<\/span>\n    icon<\/span>: 'mdi:signal'<\/span>\n\n  - platform: absolute_humidity\n    name<\/span>: \"Humidade Absoluta\"<\/span>\n    id<\/span>: bme_humidadeabs\n    temperature<\/span>: bme280_temperature\n    humidity<\/span>: bme280_humidity\n\n  - platform: template\n    name<\/span>: \"Ponto Orvalho\"<\/span>\n    id<\/span>: bme_orvalho\n    lambda<\/span>: |-\n      return<\/span> (243.5<\/span>*(log(id(bme280_humidity).state\/100<\/span>)+((17.67<\/span>*id(bme280_temperature).state)\/\n      (243.5<\/span>+id(bme280_temperature).state)))\/(17.67<\/span>-log(id(bme280_humidity).state\/100<\/span>)-\n      ((17.67<\/span>*id(bme280_temperature).state)\/(243.5<\/span>+id(bme280_temperature).state))));\n    unit_of_measurement: \u00b0C\n    icon<\/span>: 'mdi:thermometer-alert'<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        \n\ti<\/span>\n\t
        Porque o ponto de orvalho?<\/strong> \u00c9 a temperatura a que o ar satura e a \u00e1gua passa a condensar \u2014 janelas molhadas de manh\u00e3, espelhos emba\u00e7ados, bolor nos cantos. Se a temperatura de uma superf\u00edcie ficar abaixo<\/em> do ponto de orvalho medido, a\u00ed \u00e9 que a condensa\u00e7\u00e3o acontece. \u00c9 a grandeza que transforma um mostrador bonito numa ferramenta \u00fatil, e sai de gra\u00e7a das mesmas duas medi\u00e7\u00f5es. O mesmo com a humidade absoluta em g\/m\u00b3: \u00e9 ela que diz quanto \u00e9 que o ar realmente leva de \u00e1gua, independentemente da temperatura.<\/p>\n<\/div>\n\n\n\n
        Retroilumina\u00e7\u00e3o e tecla<\/h3>\n\n\n
        output:\n  - platform: ledc\n    pin<\/span>: GPIO32\n    id<\/span>: backlight\n\nlight<\/span>:\n  - platform: monochromatic\n    output<\/span>: backlight\n    name<\/span>: \"Backlight\"<\/span>\n    id<\/span>: luzback\n\nbinary_sensor<\/span>:\n  - platform: status\n    name<\/span>: \"Node Status\"<\/span>\n    id<\/span>: system_status\n  - platform: gpio\n    pin<\/span>:\n      number: GPIO35\n      inverted<\/span>: true<\/span>\n    name<\/span>: \"Tecla\"<\/span>\n    id<\/span>: tdisplay_button_input_1\n    on_click<\/span>:\n      then:\n        - light.turn_on:\n            id: luzback\n            brightness<\/span>: 100<\/span>%\n            transition_length: 2<\/span>s\n        - delay: 20<\/span>s\n        - light.turn_on:\n            id: luzback\n            brightness<\/span>: 15<\/span>%\n            transition_length: 60<\/span>s<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        O truque \u00e9 o LEDC: o mesmo GPIO que alimenta a retroilumina\u00e7\u00e3o \u00e9 gerido como uma entidade light<\/em>, o que d\u00e1 tr\u00eas coisas de uma vez \u2014 brilho regul\u00e1vel no Home Assistant, transi\u00e7\u00f5es suaves e uma sequ\u00eancia por automa\u00e7\u00e3o. Aqui a sequ\u00eancia \u00e9 simples: um clique acende a 100% com transi\u00e7\u00e3o de 2 s e, 20 segundos depois, o ecr\u00e3 come\u00e7a a baixar e a apagar-se \u2014 sem ningu\u00e9m precisar de se lembrar de o desligar.<\/p>\n\n\n\n
        \n\tOK<\/span>\n\t
        Nota de implementa\u00e7\u00e3o:<\/strong> no ficheiro original a sequ\u00eancia termina com um light.turn_off<\/code> imediatamente a seguir ao fade de 60 s, o que o corta antes de terminar. Se quiseres que o ecr\u00e3 afade at\u00e9 0 ao longo de um minuto, remove o turn_off<\/code> e deixa s\u00f3 o light.turn_on<\/code> com brightness: 0%<\/code> e transition_length: 60s<\/code>.<\/p>\n<\/div>\n\n\n\n
        Rede, gest\u00e3o e atualiza\u00e7\u00f5es<\/h2>\n\n\n\n
        Como nos outros projetos deste blog, a esta\u00e7\u00e3o vive inteiramente na rede local:<\/p>\n\n\n\n
          \n
        • IP est\u00e1tico<\/strong> \u2014 192.168.1.238<\/code>, com gateway<\/em> e DNS em 192.168.1.254<\/code>. O endere\u00e7o nunca muda, o que torna o dispositivo previs\u00edvel para automa\u00e7\u00f5es e para o web server<\/em>.<\/li>\n\n\n\n
        • Captive portal<\/strong> \u2014 configur\u00e1vel por telem\u00f3vel se o Wi-Fi n\u00e3o estiver presente (com a ressalva do ponto seguinte).<\/li>\n\n\n\n
        • Improv Serial<\/strong> \u2014 provisionamento de Wi-Fi pela porta s\u00e9rie, a primeira vez ou depois de um reset.<\/li>\n\n\n\n
        • OTA<\/strong> \u2014 atualiza\u00e7\u00f5es sem cabo, direto do ESPHome no Home Assistant.<\/li>\n\n\n\n
        • Web Server<\/strong> \u2014 p\u00e1gina local com sensores e logs, \u00fatil para diagn\u00f3stico sem abrir o HA.<\/li>\n\n\n\n
        • API nativo<\/strong> \u2014 liga\u00e7\u00e3o direta ao Home Assistant, incluindo o rel\u00f3gio usado no ecr\u00e3.<\/li>\n\n\n\n
        • dashboard_import<\/strong> \u2014 o dispositivo pode ser importado como pacote no ESPHome Dashboard.<\/li>\n<\/ul>\n\n\n
          wifi<\/span>:\n  ssid<\/span>: SF_24E<\/span>\n  password<\/span>: \"\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022\"\n  manual_ip<\/span>:\n    static_ip<\/span>: 192.168<\/span>.1<\/span>.238<\/span>\n    gateway<\/span>: 192.168<\/span>.1<\/span>.254<\/span>\n    subnet<\/span>: 255.255<\/span>.255<\/span>.0<\/span>\n    dns1<\/span>: 192.168<\/span>.1<\/span>.254<\/span>\n  #ap<\/span>: {}\n\ncaptive_portal<\/span>:\n\nweb_server<\/span>:\n\nota<\/span>:\n  -<\/span> platform<\/span>: esphome<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
          \n\t!<\/span>\n\t
          Duas notas de rede:<\/strong> o Access Point de emerg\u00eancia est\u00e1 comentado<\/strong> (#ap: {}<\/code>) \u2014 sem ele, o captive_portal<\/code> n\u00e3o tem por onde servir a p\u00e1gina de configura\u00e7\u00e3o e, se trocares de router ou mudares a palavra-passe, s\u00f3 recuperas o dispositivo por USB ou pela porta s\u00e9rie. E a palavra-passe do Wi-Fi est\u00e1 em texto no ficheiro: mant\u00e9m o estacao_termo.yaml<\/code> fora de reposit\u00f3rios p\u00fablicos e define api: encryption_key<\/code> e ota: password<\/code> antes de o publicares.<\/p>\n<\/div>\n\n\n\n
          Instala\u00e7\u00e3o passo a passo<\/h2>\n\n\n\n
          Do ficheiro em branco \u00e0 esta\u00e7\u00e3o montada, em seis passos:<\/p>\n\n\n\n
            \n
          1. Junta os assets<\/em>.<\/strong> Cria a pasta icons\/<\/code> ao lado do estacao_termo.yaml<\/code>, mete l\u00e1 o imageround.png<\/code> e copia o Helvetica.ttf<\/code> para a raiz do projeto. Sem estes dois ficheiros, a compila\u00e7\u00e3o falha antes de chegar ao resto.<\/li>\n\n\n\n
          2. Liga a fia\u00e7\u00e3o.<\/strong> Display por SPI (5 fios + 3,3\u00a0V e GND), BME280 por I\u00b2C (2 fios + 3,3\u00a0V e GND) e tecla entre o GPIO35 e o GND, com o pull-up<\/em> de 10\u00a0k\u03a9 para os 3,3\u00a0V.<\/li>\n\n\n\n
          3. Grava e confirma o barramento.<\/strong> Adiciona o dispositivo no ESPHome, ajusta SSID, palavra-passe e IP e envia. No log, procura a linha do i2c scan<\/code> \u2014 tem de l\u00e1 estar o 0x76<\/code>.<\/li>\n\n\n\n
          4. Aceita no Home Assistant.<\/strong> Surgem no minuto seguinte seis sensores, o light<\/em> da retroilumina\u00e7\u00e3o, a tecla e o estado do n\u00f3.<\/li>\n\n\n\n
          5. Calibra.<\/strong> Compara a temperatura com um term\u00f3metro de refer\u00eancia e ajusta o offset<\/code>; se a altitude der errada, troca os 1013,25\u00a0hPa do padr\u00e3o pela press\u00e3o m\u00e9dia do teu local.<\/li>\n\n\n\n
          6. Monta e testa.<\/strong> BME280 afastado do calor do ESP32, display \u00e0 vista e tecla acess\u00edvel. Clica: o ecr\u00e3 acende, e sozinho apaga-se passados os 20 segundos.<\/li>\n<\/ol>\n\n\n\n
            No Home Assistant<\/h2>\n\n\n\n
            A esta\u00e7\u00e3o n\u00e3o \u00e9 um gadget que s\u00f3 serve para olhar: cada valor que aparece no ecr\u00e3 \u00e9 uma entidade no Home Assistant, pronta para gr\u00e1ficos, automa\u00e7\u00f5es e alertas.<\/p>\n\n\n\n
            \n\n\t
            \n\t\t01<\/span>\n\t\t
            Seis sensores, uma entidade de estado<\/h3>\n\t\t
            BME Temperatura<\/em>, BME Press\u00e3o<\/em>, BME280 Humidade Relativa<\/em>, Altitude<\/em>, Humidade Absoluta<\/em> e Ponto Orvalho<\/em> \u2014 mais Wifi signal<\/em>, Uptime<\/em> e Node Status<\/em> para diagn\u00f3stico. \u00c9 o suficiente para montar um cart\u00e3o de ambiente completo sem comprar mais nada.<\/p>\n\t<\/div>\n\n\t
            \n\t\t02<\/span>\n\t\t
            A retroilumina\u00e7\u00e3o \u00e9 uma luz<\/h3>\n\t\t
            A entidade light.backlight<\/strong> aceita brilho como qualquer l\u00e2mpada inteligente. D\u00e1 para a ligar quando algu\u00e9m entra na sala, a escurecer \u00e0 noite ou a acender quando a humidade passa de um limite \u2014 sem escrever uma linha no ESPHome.<\/p>\n\t<\/div>\n\n\t
            \n\t\t03<\/span>\n\t\t
            A hora no ecr\u00e3 vem do HA<\/h3>\n\t\t
            O time<\/code> usa a plataforma homeassistant<\/code>: o rel\u00f3gio do display \u00e9 o mesmo do HA, sem NTP e sem desvios entre o que o ecr\u00e3 mostra e o que as automa\u00e7\u00f5es registam no logbook.<\/p>\n\t<\/div>\n\n\t
            \n\t\t04<\/span>\n\t\t
            Estado vis\u00edvel e p\u00e1gina web local<\/h3>\n\t\t
            O Online\/Offline<\/em> no canto do ecr\u00e3 \u00e9 a entidade status<\/code>, e o web server<\/em> do ESPHome permite abrir 192.168.1.238<\/code> no browser e ver sensores e logs mesmo quando o Home Assistant est\u00e1 em manuten\u00e7\u00e3o.<\/p>\n\t<\/div>\n\n<\/div>\n\n\n\n
            Automa\u00e7\u00f5es que valem a pena<\/h3>\n\n\n\n