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?
- Abra seu projeto no Chrome ou Edge em um computador ou Chromebook.
- Conecte o Uno nele com um cabo USB.
- 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.
- Aperte Upload e escolha a mesma porta.
- 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.
Related
- Exportar e baixar: todos os arquivos que o Mokxi gera, incluindo o código como um zip da Arduino IDE ou do PlatformIO.
- Rodar um firmware pronto: o caminho inverso, rodar no Mokxi um arquivo que você compilou.
- Instalando o Mokxi como um app