La respuesta corta
Presiona Enviar a la placa en el encabezado del editor (está junto a Exportar). Se abre una tarjeta con los pasos que corresponden a tu placa y a tu navegador. Enviar un sketch a una placa real, mediante Cargar o un archivo .hex, .bin o .uf2, es parte de Pro; en Gratis el botón muestra qué hace Pro y ofrece la prueba gratis de 7 días de Pro (se necesita una tarjeta, y no se cobra nada si la cancelas antes de que termine). Compilar y simular siguen siendo gratis, los pasos del Arduino IDE de una placa siguen gratis en todos los planes, y los estudiantes de una clase y los menores de 13 años pueden seguir enviando a placas sin importar el plan.
- Chrome o Edge en una computadora o Chromebook: Mokxi compila el sketch y lo escribe en la placa mediante un cable USB. Presiona Cargar y elige el puerto de la placa.
- Safari, Firefox, o un iPad o iPhone: estos navegadores no pueden comunicarse con una placa USB, así que no hay un botón Cargar que funcione. La tarjeta lo indica, y te da el archivo para descargar y los pasos para terminar con el Arduino IDE.
Qué recibe cada placa
| Placa | En Chrome o Edge | En cualquier otro navegador |
|---|---|---|
| Arduino Uno, Nano, Mega 2560, Leonardo, Micro, Pro Mini, Pro Micro | Cargar por USB | Descarga el archivo .hex, luego el Arduino IDE o avrdude |
| ESP32-C3 DevKitM-1, XIAO ESP32-C3, ESP32-C3 SuperMini | Cargar por USB (el botón dice Cargar a la placa) | Descarga el archivo .bin, luego esptool o el Arduino IDE |
| Raspberry Pi Pico, Pico W, XIAO RP2040, RP2040-Zero, Nano RP2040 Connect, XIAO SAMD21 | Un archivo .uf2 para arrastrar a la unidad USB de la placa | El mismo archivo, desde una computadora |
| micro:bit V2 | Un archivo .hex para arrastrar a la unidad MICROBIT | El mismo archivo, desde una computadora |
| ATtiny85, ATmega328P en una protoboard | Descarga el archivo .hex y escríbelo con un programador (un USBasp, o un Uno con ArduinoISP) | Lo mismo |
| Placas ESP32, ESP32-S3, ESP32-C6 y ESP8266 sin opción de Cargar | Ponlo en tu placa: los pasos del Arduino IDE, más Probar conexión, que identifica el chip en el puerto | Los pasos del Arduino IDE |
| Cualquier otra placa (Uno R4, STM32) | Ponlo en tu placa: los pasos del Arduino IDE para esa placa | Lo mismo |
Probar conexión
Toda tarjeta con un botón Cargar, y la tarjeta del Arduino IDE de todas las placas ESP, también tiene Probar conexión. No escribe nada. Pide el puerto, reinicia la placa, prueba todos los bootloaders que Mokxi habla (los de Arduino a 115200 y 57600 baudios, el del Mega, y el cargador del chip ESP), lee la firma o el id del chip, y deja que el sketch que estaba en la placa vuelva a ejecutarse. Luego dice qué encontró y si es la placa para la que es el proyecto:
- "Se encontró un ATmega328P (firma 1E 95 0F), el chip de un Uno, un Nano o un Pro Mini, con el bootloader de Arduino a 115200 baudios. Coincide con el Arduino Uno. Listo para cargar."
- "Se encontró una ESP32-S3, en su cargador de chip, pero el proyecto es para la ESP32-C3 DevKitM-1 (ESP32-C3). Elige una placa ESP32-S3 (...) en Mokxi e inténtalo de nuevo, o conecta la ESP32-C3 DevKitM-1."
- En una Nano, cuando el clon tiene el bootloader antiguo: la tarjeta cambia su lista Placa a Arduino Nano (old bootloader) por ti.
Pruébalo primero cuando no sepas qué placa está en el cable, qué puerto es cuál, o si el cable y el controlador funcionan. En una Leonardo, Micro o Pro Micro reinicia la placa y te pide elegir el puerto otra vez, igual que Cargar.
El registro de carga
Después de cualquier Carga o Prueba de conexión, la tarjeta muestra un Registro de carga contraído. Contiene cada byte enviado y recibido de la placa, cada cambio de las líneas de reset y el momento de cada uno, con la placa, el chip y el navegador al inicio. No tiene nada personal. Usa Copiar registro o Descargar registro y pégalo en un reporte: con él, una falla se puede leer sin tener la placa en la mesa. "Avisarnos" junto a un error lo envía por sí solo.
Un sketch que usa WiFi aún no se puede enviar desde Mokxi (en un ESP32-C3 o un Pico W), porque el WiFi aquí es simulado. Envía uno sin WiFi, o compila ese en el Arduino IDE con tu propio nombre de red y contraseña.
En un Pico, Pico W, XIAO RP2040 o RP2040-Zero, Serial sale por los pines GP0 (TX) y GP1 (RX) en la placa real (los pines TX y RX en una Nano RP2040 Connect), no por el cable USB: léelo con un adaptador serie USB de 3.3V.
¿Cómo envío un programa a mi Uno?
- Abre tu proyecto en Chrome o Edge en una computadora o Chromebook.
- Conecta la Uno con un cable USB.
- Presiona Enviar a la placa, luego Probar conexión, y elige el puerto de la Uno en la lista que muestra el navegador. La tarjeta dice lo que encontró; "Listo para cargar" significa que el siguiente paso funcionará.
- Presiona Cargar y elige el mismo puerto.
- Espera a que la barra termine. Mokxi escribe el sketch, lee cada byte de vuelta y solo entonces dice Listo. Tu sketch se está ejecutando en la placa.
Si la lista está vacía o tu placa no aparece, ve a la siguiente sección. Si la carga falla una vez, cierra primero el Arduino IDE y cualquier monitor serie: solo un programa puede tener el puerto.
La lista de puertos está vacía, o mi placa no aparece
El navegador lista solo las placas que puede ver. Cuando falta la tuya, la tarjeta abre ¿Tu placa no está en la lista? con estas verificaciones y un botón Intentar de nuevo:
- Un cable de datos. Muchos cables USB solo cargan: la placa enciende, pero no aparece ningún puerto. Prueba un cable que sepas que transfiere datos.
- El controlador del chip USB. Mira el chip pequeño junto al conector USB de la placa, instala su controlador, luego desconecta la placa y vuélvela a conectar.
- CH340 or CH341 (most clones): Windows, macOS. Linux y ChromeOS lo traen integrado.
- CP2102 or CP2104: Windows y macOS. Linux y ChromeOS lo traen integrado.
- Una Uno, Mega o Leonardo original no necesita nada en macOS, Linux o ChromeOS; en Windows, instalar el Arduino IDE agrega su controlador.
- Un ESP32-C3 en su propio puerto USB (una XIAO o una SuperMini, listada como "USB JTAG/serial debug unit") no necesita controlador. Si no aparece, mantén presionado BOOT mientras lo conectas.
- Nada más usando el puerto. Cierra el monitor serie y el Serial Plotter del Arduino IDE, PlatformIO y cualquier otra pestaña con Mokxi abierta. Una placa que aparece en la lista pero no abre suele estar retenida por uno de ellos. En Linux, si nada más la tiene, agrégate al grupo
dialout(sudo usermod -aG dialout $USER) y luego cierra y vuelve a iniciar sesión. - Chrome o Edge en una computadora. Safari, Firefox y todos los navegadores de un iPhone o iPad no pueden acceder a placas USB, así que la tarjeta te da el archivo .hex o .bin para descargar, con los pasos del Arduino IDE.
¿Cómo paso mi programa a un Arduino desde un iPad?
Mokxi funciona en Safari en un iPad: puedes armar el circuito, escribir el código y ejecutarlo ahí. Enviarlo a una placa es lo único que un iPad no puede hacer, porque Safari, y Chrome en un iPad (que es Safari por dentro), no tienen forma de acceder a una placa USB.
Dos formas de terminar:
- Usa una computadora para el último paso. Inicia sesión, abre el mismo proyecto en una computadora con Chrome o Edge y presiona Enviar a la placa. Tus proyectos se guardan en tu cuenta, así que te siguen a donde vayas.
- Descarga el archivo y usa el Arduino IDE. Presiona Enviar a la placa y Descargar .hex, luego ábrelo con el Arduino IDE (o copia el sketch ahí) en una computadora.
En una Chromebook
Chrome en una Chromebook tiene acceso USB, así que Cargar funciona para las placas de la tabla de arriba, sin nada que instalar. En una Chromebook administrada por la escuela, el administrador puede desactivar el acceso USB (la política DefaultSerialGuardSetting). Si la lista de puertos sigue vacía, pide a tu equipo de TI que lo permita para mokxi.com, o usa los pasos de descarga.
Usar el archivo descargado
Para una placa Arduino, la tarjeta muestra la línea de avrdude para tu placa. En el Arduino IDE también puedes copiar el sketch (Copiar sketch), elegir tu placa en Herramientas, Placa y presionar Cargar. Para un ESP32-C3, la tarjeta muestra la línea de esptool y el desplazamiento donde escribir el .bin.
Related
- Exportar y descargar: todos los archivos que Mokxi genera, incluido el código como zip del Arduino IDE o de PlatformIO.
- Ejecutar un firmware ya compilado: al revés, un archivo que compilaste ejecutándose en Mokxi.
- Instalar Mokxi como aplicación