Visualizador de GPIO do XIAO ESP32-S3 (Sense)

XIAO ESP32-S3 (Sense) GPIO Viewer é um monitor de GPIO em tempo real baseado em MicroPython para o Seeed Studio XIAO ESP32-S3 (Sense). Exibe em tempo real os estados dos pinos digitais (HIGH/LOW/TOUCH) por meio de uma interface web local usando o Thonny.
Informações exibidas na página web
- Monitoramento de GPIO e E/S: Exibe em tempo real os estados digitais dos GPIOs, leituras ADC em tempo real e mapeamentos claros dos números dos pinos GPIO.
- Informações de execução: Informa a frequência atual da CPU e o tempo de atividade do sistema para refletir o status operacional em tempo real.
- Memória e armazenamento: Mostra o uso da memória heap, porcentagem de uso do sistema de arquivos, tamanho da flash e disponibilidade de PSRAM quando suportado.
- Informações de rede: Fornece diagnósticos de rede incluindo endereço IP, SSID do Wi-Fi conectado, intensidade do sinal (RSSI), endereço MAC, gateway e servidor DNS.
- Firmware e sistema: Identifica o modelo do chip, número de núcleos da CPU, versão do MicroPython e informações da compilação do firmware.


Recursos
- Exibe em tempo real os estados digitais dos GPIOs e leituras ADC, permitindo depuração visual durante prototipagem e desenvolvimento
- Funciona como um servidor web embarcado leve rodando inteiramente no XIAO ESP32-S3 (Sense), sem necessidade de software externo ou serviços em nuvem após a implantação
- Fornece uma interface baseada em navegador acessível a partir de qualquer dispositivo na mesma rede local para monitoramento em tempo real
- Simplifica a validação de entradas de sensores, relés e módulos periféricos sem ferramentas adicionais de depuração
- Construído com MicroPython para legibilidade e iteração rápida, mantendo uso mínimo de recursos adequado para sistemas embarcados com restrições
Processo de construção
Este é um fluxo de trabalho amigável para iniciantes usando MicroPython e o Thonny IDE; ele irá guiá-lo passo a passo desde o início, começando pelo download das ferramentas necessárias até a execução do projeto GPIOViewer no seu XIAO ESP32-S3 (Sense).
Prepare seu computador
Antes de mexermos na placa XIAO, vamos baixar e instalar o Thonny IDE (seu editor Python).
- Abra seu navegador (como Chrome ou Safari).
- Vá para https://thonny.org – este é o site oficial.
- Clique no link de download para o seu computador (Windows, macOS ou Linux).
- Depois de baixar, execute o instalador e siga as instruções na tela (clique em “Next” → “Install” → “Finish”).
Thonny é o programa que você usará para escrever e enviar código Python para sua placa.
Instale as ferramentas Python necessárias (Esptool)
Para preparar a placa para o MicroPython, precisamos de uma pequena ferramenta chamada esptool.
- No seu computador, encontre e abra o Terminal (Mac/Linux) ou Prompt de Comando (Windows).
- Digite isto e pressione Enter:
pip install esptool
Isto instala a ferramenta que nos permitirá colocar o firmware MicroPython na sua placa XIAO.
Baixe o firmware MicroPython
Precisamos de um arquivo binário especial que permita à sua placa XIAO rodar MicroPython.
- Abra seu navegador em https://micropython.org/download/ESP32_GENERIC_S3/
- Clique para baixar o arquivo .bin mais recente (exemplo: ESP32_GENERIC_S3-xxxxx.bin).
- Salve-o em algum lugar fácil de encontrar, como a sua Área de Trabalho.
Conecte seu XIAO ESP32-S3 (Sense) ao computador
- Pegue um cabo USB-C e conecte o XIAO ao seu computador.
Se a placa não aparecer, mantenha pressionado o botão BOOT enquanto conecta o cabo.
- Após conectar, seu computador atribuirá à placa uma porta COM (Windows) ou um dispositivo tty no Mac/Linux.
Grave (instale) o MicroPython na placa
Agora vamos colocar o firmware MicroPython no seu XIAO.
1. Apague a memória flash antiga
Encontre a porta da sua placa e então, no Terminal / Prompt de Comando, digite:
esptool --chip esp32s3 --port COMX erase-flash
Substitua COMX pela porta que seu sistema mostrar; no Mac pode ser /dev/tty.usbmodemXXXX ou /dev/tty.usbserialXXXX, enquanto no Linux pode ser /dev/ttyUSB0 ou /dev/ttyACM0.
2. Grave o firmware
Ainda no Terminal, primeiro navegue até o local onde o arquivo bin está armazenado e então grave na flash.
cd Desktop
esptool.py --chip esp32s3 --port COMX write_flash -z 0x0 ESP32_GENERIC_S3-xxxx.bin
Certifique-se de que o nome do arquivo corresponde ao arquivo .bin que você baixou. Este comando instala o MicroPython na sua placa.
Abra o Thonny e conecte à placa
Feche o terminal, desconecte o cabo USB do XIAO, espere 5 segundos e, em seguida, conecte o XIAO novamente (apenas conecte, sem pressionar nenhum botão). Agora você verá o MicroPython em execução!
- Abra o Thonny no seu computador.
- Vá em Run → Configure Interpreter.
- Defina o Interpreter como “MicroPython (ESP32)”.
- Escolha a porta que corresponde ao seu XIAO.
- Clique em OK.

Agora você deverá ver um prompt do MicroPython na parte inferior do Thonny, onde pode digitar comandos Python. Tente digitar:
print("Hello from XIAO!")
e pressione Enter.

Baixe os arquivos do projeto GPIOViewer
Agora que sua placa roda MicroPython:
- Abra um navegador e vá para o projeto no GitHub: https://github.com/TuzaaBap/Seeed-Studio-XIAO-ESP32S3-GPIOViewer/tree/main
- Clique em Code → Download ZIP para salvar o projeto no seu computador.
- Extraia o ZIP baixado para uma pasta que você vá lembrar.
Envie o projeto para sua placa
No Thonny:
- Abra a barra lateral Files (View → Files).
- Navegue até a pasta do projeto que você extraiu. Você deverá ver boot.py e main.py.
- Clique com o botão direito em
boot.py→ Upload to / (root). - Repita para
main.py.
Isso coloca o código do GPIOViewer no seu XIAO e o configura para ser executado quando a placa iniciar.
Configure seu Wi-Fi (dentro de boot.py)
Antes de iniciar o projeto:
- No Thonny, abra o arquivo
boot.pyque você enviou. - Encontre as linhas para o SSID e a senha do Wi-Fi.
- Substitua
"Your_WiFi_SSID"e"Your_WiFi_Password"pelo nome e senha do seu Wi-Fi doméstico. - Salve o arquivo.

Execute e visualize o monitor de GPIO
- Com sua placa ainda conectada, pressione Run (botão verde) no Thonny.
- Depois de alguns segundos, sua placa se conectará ao Wi-Fi.
- Observe a saída do Thonny — ela mostrará o endereço IP que a placa recebeu.

- No seu computador, abra um navegador web e digite esse IP (por exemplo http://192.168.6.80:8080).
- Você verá o dashboard de GPIO em tempo real mostrando os estados dos pinos.


- Antes de Run, conecte a antena ao XIAO ESP32-S3 (Sense).
- Se você não conseguir abrir a página web e a seguinte situação ocorrer após o Thonny reconectar à placa:

Não se preocupe, este é um comportamento normal na configuração MicroPython + Thonny + Web Server. Basta pressionar uma vez o botão Reset na placa ou fechar o Thonny.
✨ Projeto de contribuidores
- Este projeto é apoiado pelo Contributor Project.
- Um agradecimento especial a Utkarsh Bhor Patil por seus esforços dedicados.
Suporte técnico e discussão de produto
Obrigado por escolher nossos produtos! Estamos aqui para oferecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.