ESP-NOW é o protocolo de rádio de placa a placa da Espressif: um ESP envia uma mensagem curta direto para o endereço MAC de outro, e o rádio do outro confirma o recebimento. No Mokxi os quadros realmente cruzam entre as placas que você coloca no canvas. Cada placa ESP compartilha o mesmo ar, como duas placas sobre uma mesma mesa, então você liga cada placa apenas aos seus próprios componentes.
Funciona em todas as placas ESP: a ESP32, ESP32-S3, ESP32-C3 e ESP32-C6 e as placas construídas sobre elas (esp_now.h, chamadas do ESP-IDF), e as placas ESP8266, NodeMCU, D1 mini e ESP-01 (espnow.h, chamadas do core do ESP8266). Uma ESP32 e uma ESP8266 conversam entre si, como fazem em uma mesa. As pessoas pesquisam por esp now, esp-now ou espnow.
Experimentar
Open Botão e LED com ESP-NOW: dois ESP32s, um botão no da esquerda e um LED no da direita. Aperte Run, then press the
button. The sender's serial monitor prints Delivery success and the
receiver's prints the message and lights its LED.
ESP-NOW em duas NodeMCU é a mesma ideia com espnow.h: uma ESP8266 envia uma contagem e a leitura de um potenciômetro a cada dois segundos, e a outra as imprime.
Endereços MAC
Um tutorial manda você rodar o receptor primeiro, copiar o MAC que ele imprime e colar no sketch do transmissor. Isso funciona aqui também:
WiFi.macAddress()imprime o MAC da placa. Cada placa ESP no canvas recebe o seu, calculado a partir do id do componente, então é o mesmo sempre que você roda o projeto.- Para usar o MAC que o sketch de um tutorial já tem, clique no receptor e digite esse endereço na configuração wifiMac dele (por exemplo
24:0A:C4:AE:AE:44). Os exemplos fazem isso.
Envie para um MAC que nenhuma placa tenha e nada chega: o callback de envio recebe ESP_NOW_SEND_FAIL (ou 1 em uma ESP8266) depois que o rádio tenta cinco vezes, exatamente a falha que você perseguiria em uma mesa.
O que o rádio faz
- Unicast e broadcast. Um quadro para um MAC é confirmado pelo rádio dessa placa, e o callback de envio informa sucesso quando o ACK volta. Um quadro para
FF:FF:FF:FF:FF:FFchega a toda placa que roda ESP-NOW, e seu callback informa sucesso assim que é enviado, porque ninguém confirma um broadcast. Em uma ESP32 o endereço de broadcast precisa ser adicionado como peer primeiro, como o ESP-IDF exige. - Tempo. Um quadro começa com o preâmbulo de 192 microssegundos do 802.11b e vai a 1 Mbit/s: uma mensagem de 10 bytes fica no ar por cerca de 0,4 ms, uma de 250 bytes por cerca de 2,9 ms. O callback de recebimento roda em menos de um milissegundo após o último byte, a partir do substituto da tarefa de WiFi, então roda enquanto seu sketch está em
delay()ou entre doisloop()s. - Canais. O rádio fica no canal 1 até a placa entrar no WiFi, depois no canal do ponto de acesso (6), ou no que
esp_wifi_set_channel()escolheu. Placas em canais diferentes não se ouvem, que é o motivo comum de o ESP-NOW parar de funcionar quando uma placa se conecta ao WiFi. - Dois ao mesmo tempo. Uma placa espera um ar silencioso antes de enviar. Dois quadros que colidem se perdem; um unicast é enviado de novo, um broadcast não.
- Tamanhos. As placas ESP32 falam ESP-NOW v2 (até 1470 bytes, como o ESP-IDF 5.4 e posteriores); a ESP8266 fala v1, no máximo 250 bytes, e descarta um quadro maior sem confirmá-lo.
Os dois formatos de callback compilam na ESP32: o void onSent(const wifi_tx_info_t *info, esp_now_send_status_t status) e void onRecv(const esp_now_recv_info_t *info, const uint8_t *data, int len) do core 3.3, e os mais antigos que recebem um const uint8_t *mac.
O que não é simulado
- Sem alcance. Toda placa ESP no canvas ouve todas as outras, por mais distante que você as coloque. Não há paredes, nem atenuação, nem interferência.
- Sem modelo de sinal. Um quadro recebido informa um RSSI de -40 dBm sempre; configurações de potência de saída e taxa são aceitas e não mudam nada.
- Sem criptografia no ar. Chaves e peers criptografados são armazenados, e os quadros continuam indo em claro, então os quadros de um peer criptografado chegam mesmo com a chave errada.
- Não no MicroPython. O ESP-NOW é para sketches de Arduino; o módulo
espnowdo MicroPython não está disponível aqui.
Bluetooth e WiFi têm páginas próprias: WiFi, simulated e Bluetooth, simulado.