O editor

Enviando um programa para uma placa real

Como colocar um sketch do Mokxi no seu Arduino, ESP32 ou Pico, num computador, num Chromebook ou num iPad.

A resposta curta

Aperte Enviar para a placa no cabeçalho do editor (ele fica ao lado de Exportar). Abre-se um cartão com os passos certos para a sua placa e o seu navegador. Enviar um sketch para uma placa real, por Upload ou por um arquivo .hex, .bin ou .uf2, faz parte do Pro; no Grátis, o botão mostra o que o Pro faz e oferece o teste grátis de 7 dias do Pro (é preciso um cartão, e nada é cobrado se você cancelar antes do fim). Compilar e simular continuam grátis, os passos da Arduino IDE de uma placa continuam grátis em todos os planos, e alunos em uma turma e crianças com menos de 13 anos continuam podendo enviar para placas, seja qual for o plano.

  • Chrome ou Edge em um computador ou Chromebook: o Mokxi compila o sketch e o grava na placa por um cabo USB. Aperte Upload e escolha a porta da placa.
  • Safari, Firefox, ou um iPad ou iPhone: esses navegadores não conseguem falar com uma placa USB, então não há um botão Upload que funcione. O cartão avisa isso, e dá o arquivo para baixar e os passos para terminar com a Arduino IDE.

O que cada placa recebe

Placa No Chrome ou Edge Em qualquer outro navegador
Arduino Uno, Nano, Mega 2560, Leonardo, Micro, Pro Mini, Pro Micro Upload por USB Baixar o arquivo .hex, depois a Arduino IDE ou o avrdude
ESP32-C3 DevKitM-1, XIAO ESP32-C3, ESP32-C3 SuperMini Upload por USB (o botão diz Enviar para a placa) Baixar o arquivo .bin, depois o esptool ou a Arduino IDE
Raspberry Pi Pico, Pico W, XIAO RP2040, RP2040-Zero, Nano RP2040 Connect, XIAO SAMD21 Um arquivo .uf2 para arrastar para a unidade USB da placa O mesmo arquivo, a partir de um computador
micro:bit V2 Um arquivo .hex para arrastar para a unidade MICROBIT O mesmo arquivo, a partir de um computador
ATtiny85, ATmega328P em uma protoboard Baixar o arquivo .hex e gravá-lo com um programador (um USBasp, ou um Uno rodando o ArduinoISP) O mesmo
Placas ESP32, ESP32-S3, ESP32-C6 e ESP8266 sem Upload Coloque na sua placa: os passos da Arduino IDE, mais Testar conexão, que identifica o chip na porta Os passos da Arduino IDE
Todas as outras placas (Uno R4, STM32) Coloque na sua placa: os passos da Arduino IDE para essa placa O mesmo

Testar conexão

Todo cartão com um botão Upload, e o cartão da Arduino IDE de toda placa ESP, também tem Testar conexão. Ele não grava nada. Pede a porta, reinicia a placa, tenta todos os bootloaders que o Mokxi fala (os do Arduino a 115200 e 57600 baud, o do Mega, e o loader do chip ESP), lê a assinatura ou o id do chip, e deixa o sketch que estava na placa rodar de novo. Depois ele diz o que encontrou e se essa é a placa do projeto:

  • "Encontrei um ATmega328P (assinatura 1E 95 0F), o chip de um Uno, um Nano ou um Pro Mini, com o bootloader do Arduino a 115200 baud. Isso corresponde ao Arduino Uno. Pronto para o upload."
  • "Encontrei um ESP32-S3, no loader do chip, mas o projeto é para o ESP32-C3 DevKitM-1 (ESP32-C3). Escolha uma placa ESP32-S3 (...) no Mokxi e tente de novo, ou conecte o ESP32-C3 DevKitM-1."
  • Em uma Nano, quando o clone tem o bootloader antigo: o cartão muda a lista Placa para Arduino Nano (old bootloader) por você.

Aperte-o primeiro quando você não tem certeza de qual placa está no cabo, qual porta é qual, ou se o cabo e o driver funcionam. Em uma Leonardo, Micro ou Pro Micro, ele reinicia a placa e pede que você escolha a porta de novo, como o Upload faz.

O log de upload

Depois de qualquer Upload ou Testar conexão, o cartão mostra um Log de upload recolhido. Ele guarda cada byte enviado e recebido da placa, cada mudança das linhas de reset e o momento de cada uma, com a placa, o chip e o navegador no topo. Nada pessoal está nele. Use Copiar log ou Baixar log e cole em um relato: com ele, uma falha pode ser lida sem a placa na mesa. O "Nos avise" ao lado de um erro o envia sozinho.

Um sketch que usa WiFi ainda não pode ser enviado do Mokxi (em um ESP32-C3 ou um Pico W), porque o WiFi aqui é simulado. Envie um sem WiFi, ou compile esse na Arduino IDE com o nome e a senha da sua rede.

Em uma Pico, Pico W, XIAO RP2040 ou RP2040-Zero, o Serial sai nos pinos GP0 (TX) e GP1 (RX) da placa real (os pinos TX e RX em uma Nano RP2040 Connect), não pelo cabo USB: leia com um adaptador serial USB de 3,3V.

Como envio um programa para o meu Uno?

  1. Abra seu projeto no Chrome ou Edge em um computador ou Chromebook.
  2. Conecte o Uno nele com um cabo USB.
  3. Aperte Enviar para a placa, depois Testar conexão, e escolha a porta do Uno na lista que o navegador mostra. O cartão diz o que encontrou; "Pronto para enviar" significa que o próximo passo vai funcionar.
  4. Aperte Upload e escolha a mesma porta.
  5. Espere a barra terminar. O Mokxi grava o sketch, lê cada byte de volta e só então diz Pronto. Seu sketch está rodando na placa.

Se a lista estiver vazia ou sua placa não estiver nela, veja a próxima seção. Se o upload falhar uma vez, feche primeiro a Arduino IDE e qualquer monitor serial: só um programa pode usar a porta.

A lista de portas está vazia, ou minha placa não está nela

O navegador lista só as placas que consegue ver. Quando a sua não aparece, o cartão abre Placa não está na lista? com estas verificações e um botão Tentar de novo:

  • Um cabo de dados. Muitos cabos USB só carregam: a placa acende, mas nenhuma porta aparece. Tente um cabo que você sabe que transmite dados.
  • O driver do chip USB. Olhe o chip pequeno ao lado do conector USB da placa, instale o driver dele, depois desconecte a placa e conecte de novo.
    • CH340 or CH341 (most clones): Windows, macOS. Linux e ChromeOS já o incluem.
    • CP2102 or CP2104: Windows e macOS. Linux e ChromeOS já o incluem.
    • Um Uno, Mega ou Leonardo original não precisa de nada no macOS, Linux ou ChromeOS; no Windows, instalar a Arduino IDE adiciona o driver.
    • Um ESP32-C3 na própria porta USB (um XIAO ou um SuperMini, listado como "USB JTAG/serial debug unit") não precisa de driver. Se não aparecer, segure BOOT enquanto conecta.
  • Nada mais usando a porta. Feche o Serial Monitor e o Serial Plotter da Arduino IDE, o PlatformIO e qualquer outra aba com o Mokxi aberto. Uma placa que aparece na lista mas não abre geralmente está retida por um deles. No Linux, se nada mais a estiver usando, adicione-se ao grupo dialout (sudo usermod -aG dialout $USER) e depois saia da conta e entre de novo.
  • Chrome ou Edge em um computador. Safari, Firefox e todo navegador em um iPhone ou iPad não conseguem acessar placas USB, então o cartão oferece o arquivo .hex ou .bin para baixar, com os passos da Arduino IDE.

Como coloco meu programa em um Arduino a partir de um iPad?

O Mokxi funciona no Safari de um iPad: você pode montar o circuito, escrever o código e rodar lá. Enviar para uma placa é a única coisa que um iPad não consegue fazer, porque o Safari, e o Chrome em um iPad (que é Safari por baixo), não têm como acessar uma placa USB.

Duas formas de terminar:

  • Use um computador para o último passo. Entre, abra o mesmo projeto em um computador com Chrome ou Edge e aperte Enviar para a placa. Seus projetos ficam salvos na sua conta, então vão com você.
  • Baixe o arquivo e use a Arduino IDE. Aperte Enviar para a placa e Baixar .hex, depois abra na Arduino IDE (ou copie o sketch para ela) em um computador.

Em um Chromebook

O Chrome em um Chromebook tem acesso USB, então o Upload funciona para as placas na tabela acima, sem instalar nada. Em um Chromebook gerenciado pela escola, o administrador pode desligar o acesso USB (a política DefaultSerialGuardSetting). Se a lista de portas continuar vazia, peça ao seu time de TI para liberar o mokxi.com, ou use os passos de download.

Usando o arquivo baixado

Para uma placa Arduino, o cartão mostra a linha avrdude da sua placa. Na Arduino IDE você também pode copiar o sketch (Copiar sketch), escolher sua placa em Ferramentas, Placa e apertar Upload. Para um ESP32-C3, o cartão mostra a linha do esptool e o offset onde gravar o .bin.