Piscar um LED na ESP32-C3
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
A placa que isto modela é uma ESP32-C3-DevKitM-1 real, não um substituto genérico: um chip RISC-V de núcleo único a 160 MHz, com sua própria numeração de GPIO que não corresponde de jeito nenhum à serigrafia dos pinos de um Arduino. Aqui não existe pino impresso com "13"; o LED embutido fica no GPIO 8, então LED_BUILTIN nesta placa significa 8, e é esse o pino ao qual o circuito acima liga um LED e um resistor externos também.
Aperte Rodar e tanto o LED da própria placa quanto o LED da protoboard piscam juntos, uma vez por segundo, com firmware que de fato é compilado para este chip e de fato roda no núcleo RISC-V modelado, e não numa animação de mentira.
Qual placa isto modela
Diga a placa exata, porque existe mais de uma placa ESP32-C3 e elas não são intercambiáveis: esta é a DevKitM-1, a placa de desenvolvimento oficial da Espressif, não as placas "SuperMini" menores de terceiros que usam o mesmo chip mas com um pinout e layout diferentes. Se você tem uma SuperMini, o GPIO 8 continua sendo o pino certo a procurar no código, mas não espere que as posições físicas dos pinos neste diagrama correspondam à serigrafia de uma placa diferente.
O chip por baixo de ambas as placas é o mesmo ESP32-C3: um núcleo RISC-V único, GPIO, uma UART e um SYSTIMER num mapa de memória real e documentado. O firmware dos periféricos que este simulador modela pode ir para uma DevKitM-1 física, onde ainda precisa de testes. O que difere entre placas com o mesmo chip é quais pinos são levados a um conector e em que ordem.
Ligando o LED em 3,3 volts, não em 5
Este é o único número que realmente muda entre um Arduino Uno e um ESP32-C3: os pinos GPIO do C3 fornecem 3,3 volts, não 5. Faça a mesma conta de resistor com essa alimentação, (3,3 V menos cerca de 2 V) dividido por 220 ohms, e a corrente sai mais perto de 6 miliampères, contra os cerca de 13,6 mA do Uno com o mesmo resistor. O mesmo LED ficará visivelmente mais fraco aqui, e vale a pena reduzir um pouco o resistor, para algo como 150 ohms, para recuperar um brilho parecido, em vez de assumir que os valores do Uno valem iguais.
O que muda sob as mesmas três chamadas
digitalWrite(), pinMode() e delay() são lidos da mesma forma em todas as placas que o Mokxi modela, e isso é proposital: o core do Arduino esconde o chip por baixo delas. O que muda aqui é tudo abaixo dessa linha. O C3 é um núcleo RISC-V de 32 bits a 160 MHz, contra o núcleo AVR de 8 bits do Uno a 16 MHz, e delay() aqui é cronometrado pelo SYSTIMER, um periférico que o ATmega328P não tem, em vez de um timer de uso geral recrutado para isso. Nada disso muda o que o sketch acima faz; muda quanta folga sobra para todo o resto que um projeto com C3 tende a querer fazer ao mesmo tempo, como ler um sensor por I2C ou controlar um pequeno display, o que é grande parte do motivo de este chip ser uma escolha comum quando um projeto ultrapassa um único LED piscando.
O código
O sketch tem a mesma forma do Uno, porque digitalWrite(), pinMode() e delay() são as mesmas chamadas estilo Arduino em todas as placas que o Mokxi modela; só o número do pino e o comentário que o descreve mudam.
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
delay(500);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Erros comuns
Os dois erros específicos desta placa, além dos erros de LED invertido e resistor faltando que valem em qualquer lugar: ler o número da serigrafia como se fosse o número do GPIO, o que geralmente não é numa placa de desenvolvimento com os pinos num conector rotulado com os próprios nomes do chip; e assumir que qualquer GPIO está livre para qualquer coisa. Alguns pinos do C3 são pinos de strapping, amostrados uma vez na inicialização para escolher coisas como o modo de boot, e forçá-los a nível baixo com um componente externo na energização pode impedir a placa de iniciar como você espera. O GPIO 8 não tem esse papel, o que é mais um motivo para ser o pino que o LED embutido e este exemplo usam.
Um terceiro erro que vale nomear porque é fácil cometer uma vez e nunca mais: assumir que analogWrite() se comporta aqui exatamente como num Uno. Ele faz o mesmo trabalho em ambos, mas não da mesma maneira: a chamada num Uno chega a um de seis pinos ligados à saída de comparação de um timer, e a do C3 chega a qualquer pino, porque os canais do LEDC são roteados pela matriz de GPIO em vez de soldados a um pad. A página sobre PWM fade cobre o que de fato muda entre as duas placas, e vale a pena lê-la antes de assumir que um sketch de fade será portado sem alterações.
E um quarto, fácil de ignorar porque aqui não custa nada errar: esquecer que o GPIO 8 também é o pino ao qual o LED da placa já está ligado. Ligar um LED externo ao mesmo pino está tudo bem, e é exatamente o que o circuito acima faz, mas significa que o LED da placa e o LED da protoboard vão sempre mostrar o mesmo estado; ligar um segundo LED independente exige um segundo GPIO não usado.
Alimentando a placa e o LED juntos
A DevKitM-1 é alimentada pelo seu próprio conector USB neste simulador, como na placa real, então nada no circuito do LED precisa alimentar o próprio chip. O que o LED e o resistor consomem vem do pino GPIO, a 3,3 V, e não de um trilho separado, e a conta de corrente acima já considera isso. Na placa real isso importa um pouco mais do que aqui: um pino GPIO tem uma corrente máxima real de saída, e um resistor pequeno demais é a diferença entre um LED com corrente limitada com segurança e um pino forçado a fornecer mais do que suporta.
Abra este circuito no editor. ESP32-C3: blink, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.
Perguntas
Este é o mesmo programa do exemplo de blink do Arduino Uno?
A mesma forma e as mesmas três chamadas, mas uma compilação separada: o ELF aqui visa um núcleo RISC-V no mapa de memória real do ESP32-C3, não o ATmega328P que os exemplos do Uno visam, e o GPIO 8 substitui o pino 13.
O WiFi funciona neste simulador?
O WiFi funciona numa rede simulada com as chamadas WiFi do Arduino. Não há rádio nem 802.11 e, com login feito, você pode ativar internet real. O Bluetooth é simulado da mesma forma, com um celular no painel de Bluetooth do editor.
Em quais pinos posso piscar um LED com segurança?
A maioria dos pinos GPIO disponíveis funciona bem para um LED simples com digitalWrite; a página da placa lista quais são pinos de strapping que vale a pena evitar para qualquer coisa acionada na energização.
O simulador do ESP32-C3 é grátis?
Sim, sem precisar de conta para abrir e experimentar, como acontece com todas as placas que o Mokxi simula.
Um firmware compilado aqui pode rodar numa ESP32-C3-DevKitM-1 real?
Para os periféricos que este simulador modela, um ELF compilado aqui usa os deslocamentos de registrador reais para GPIO, UART e código guiado por timer como este exemplo. Teste na placa física antes de depender dele.
Preciso saber assembly RISC-V para usar esta placa?
Não. Todos os exemplos aqui são escritos no mesmo C++ estilo Arduino dos exemplos do Uno; o núcleo RISC-V por baixo é o que de fato executa o programa compilado, mas nada em escrever um sketch para esta placa exige saber disso.
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.