📚 Documentação AIPES & ESP32-C3

Hardware: Conhecendo a ESP32-C3 Super Mini

A ESP32-C3 Super Mini é uma placa de desenvolvimento ultracompacta baseada no processador de arquitetura RISC-V de 32 bits (single-core a 160MHz). Seu maior destaque é o tamanho reduzido e o baixíssimo consumo de energia (apenas 43µA em Deep Sleep), tornando-a ideal para projetos de IoT (Internet das Coisas).

Especificações Técnicas Principais

ComponenteDetalhe
ProcessadorESP32-C3 (32-bit RISC-V, 160 MHz)
ConectividadeWi-Fi 2.4 GHz (b/g/n) e Bluetooth 5.0 (LE)
Memória400 KB SRAM / 4 MB Flash (QIO, 80MHz)
Interface USBUSB-C (Suporta USB CDC/WebSerial)
GPIOs11 Pinos (Suporta PWM, ADC, I2C, SPI, UART)
LED IntegradoGPIO 8 (Lógica Invertida: LOW = Aceso)
Botão BOOTGPIO 9

Modo Bootloader (Gravação Manual)

Se a placa não for reconhecida ao tentar gravar via USB, você pode forçar o modo de gravação (Bootloader):

  1. Mantenha pressionado o botão BOOT.
  2. Pressione e solte o botão RST (Reset).
  3. Solte o botão BOOT.

Referências e Fontes Externas:
- Random Nerd Tutorials: Getting Started with ESP32-C3
- Sudo.is / ESPHome: ESP32-C3 Docs

Manual da Plataforma AIPES

O AIPES (AI-Powered ESP System) é uma IDE na nuvem revolucionária que une Inteligência Artificial e compilação remota, permitindo que você programe microcontroladores diretamente do seu navegador, sem precisar instalar nada no seu computador.

1. Como pedir um código para a IA 🤖

No painel esquerdo, você encontrará uma caixa de texto. Digite o que você quer que a placa faça em linguagem natural (ex: "Crie um semáforo usando os pinos 2, 3 e 4").
Você também pode clicar no botão 🎤 Falar. O navegador pedirá permissão para usar o microfone e transcreverá sua voz automaticamente para a caixa de texto. Clique em "Gerar Código" e aguarde a IA escrever o programa em C++ e explicar o funcionamento.

2. Possibilidade de Editar o Código ✍️

No lado direito da tela, você tem um editor de código profissional (baseado no Monaco Editor, o mesmo do VSCode). Mesmo que a IA gere o código, você é totalmente livre para alterar variáveis, corrigir lógicas ou colar seus próprios códigos ali dentro antes de compilar.

3. Como Compartilhar um Código 🔗

Cada vez que um código é compilado ou gerado, o AIPES salva o projeto no banco de dados e adiciona um ID único na URL (ex: ?id=a1b2c3d4). Para compartilhar o seu projeto com um amigo, basta copiar o link inteiro da barra de endereços do navegador e enviar. Quando ele abrir, o código estará exatamente igual na tela dele!

4. Como Compilar o Código ⚙️

Antes de gravar, você deve transformar o código de texto em linguagem de máquina (binário). Siga os passos:

  1. Selecione a sua Placa no menu suspenso (ESP32-C3 ou ESP32 Clássica).
  2. Selecione o Modo de Gravação (OTA).
  3. Clique no botão azul ⚙️ Compilar Código. O servidor fará o trabalho pesado usando o arduino-cli e retornará uma mensagem verde de sucesso.

5. Modos de Gravação (Upload) 🚀

O AIPES suporta 4 formas incríveis de gravar o código na sua placa:

  • Apenas USB (WebSerial): Conecte a placa via cabo USB. Requer Google Chrome ou Edge. O sistema faz um Full Flash (Bootloader, Partições e App) direto pelo navegador. Ideal para o primeiro uso.
  • WiFi OTA (Conectar a uma Rede): O código gerado pela IA vai conectar a sua placa ao roteador da sua casa. Ideal para atualizar placas espalhadas pela casa via Wi-Fi.
  • WiFi OTA (Modo Access Point): A própria placa cria uma rede Wi-Fi (ex: "AIPES_OTA"). Você conecta o seu PC nessa rede e envia o código diretamente para ela, sem precisar de roteador!
  • Bluetooth BLE OTA: Usa a tecnologia WebBluetooth do navegador. É mais lento, mas ideal para atualizar equipamentos no campo onde não há Wi-Fi disponível.

⚠️ Dica importante para o modo WiFi: Como a sua placa não possui certificado HTTPS, o Chrome pode bloquear o envio por motivos de segurança (Mixed Content). Clique no ícone de "Cadeado" ao lado da URL no navegador, vá em "Configurações do Site" e altere a permissão de Conteúdo Inseguro (Insecure content) para Permitir.

📚 AIPES & ESP32-C3 Documentation

Hardware: Meet the ESP32-C3 Super Mini

The ESP32-C3 Super Mini is an ultra-compact development board based on a 32-bit RISC-V processor (single-core at 160MHz). Its standout features are its tiny footprint and ultra-low power consumption (down to 43µA in Deep Sleep), making it perfect for IoT projects.

Key Technical Specifications

ComponentDetail
ProcessorESP32-C3 (32-bit RISC-V, 160 MHz)
ConnectivityWi-Fi 2.4 GHz (b/g/n) & Bluetooth 5.0 (LE)
Memory400 KB SRAM / 4 MB Flash (QIO, 80MHz)
USB InterfaceUSB-C (Supports USB CDC/WebSerial)
GPIOs11 Pins (Supports PWM, ADC, I2C, SPI, UART)
Onboard LEDGPIO 8 (Inverted Logic: LOW = ON)
BOOT ButtonGPIO 9

Bootloader Mode (Manual Flashing)

If the board is not recognized when trying to flash via USB, you can force it into download mode (Bootloader):

  1. Hold down the BOOT button.
  2. Press and release the RST (Reset) button.
  3. Release the BOOT button.

References & External Sources:
- Random Nerd Tutorials: Getting Started with ESP32-C3
- Sudo.is / ESPHome: ESP32-C3 Docs

AIPES Platform Manual

AIPES (AI-Powered ESP System) is a revolutionary cloud IDE that merges Artificial Intelligence and remote compilation. It allows you to program microcontrollers directly from your web browser without installing any local software.

1. How to ask AI for code 🤖

On the left panel, you'll find a text box. Describe what you want the board to do in natural language (e.g., "Create a traffic light using pins 2, 3, and 4").
You can also click the 🎤 Falar (Speak) button. The browser will ask for microphone access and transcribe your voice into text automatically. Click "Generate Code" and wait for the AI to write the C++ program and explain how it works.

2. Editing the Code ✍️

On the right side of the screen is a professional code editor (powered by Monaco Editor, same as VSCode). Even though the AI generates the code, you are completely free to modify variables, fix logic, or paste your own code before compiling.

3. How to Share Code 🔗

Every time code is compiled or generated, AIPES saves the project to its database and appends a unique ID to your URL (e.g., ?id=a1b2c3d4). To share your project with a friend, simply copy the full link from your browser's address bar and send it. When they open it, they will see your exact code!

4. How to Compile ⚙️

Before uploading, you must convert the text code into machine language (binary). Follow these steps:

  1. Select your Board from the dropdown menu (ESP32-C3 or Classic ESP32).
  2. Select the OTA / Upload Mode.
  3. Click the blue ⚙️ Compile Code button. The server will handle the heavy lifting using arduino-cli and return a green success message.

5. Upload Methods 🚀

AIPES supports 4 amazing ways to flash your board:

  • USB Only (WebSerial): Connect the board via USB cable. Requires Google Chrome or Edge. The system performs a Full Flash (Bootloader, Partitions, and App) right from the browser. Best for first-time setup.
  • WiFi OTA (Station Mode): The AI-generated code will connect the board to your home router. Ideal for updating boards placed around your house via Wi-Fi.
  • WiFi OTA (Access Point Mode): The board creates its own Wi-Fi network (e.g., "AIPES_OTA"). You connect your PC to this network and flash the code directly to it, no router needed!
  • Bluetooth BLE OTA: Uses WebBluetooth technology. It is slower, but perfect for updating devices in the field where Wi-Fi is completely unavailable.

⚠️ Important tip for WiFi Mode: Because your board doesn't have an HTTPS certificate, Chrome might block the upload for security reasons (Mixed Content). Click the "Padlock" icon next to the URL in your browser, go to "Site Settings", and change the Insecure content permission to Allow.