These are different from the chips que haces con componentes. Aquellos son un circuito plegado en una caja. Un chip personalizado es un programa.
Traer un chip desde Wokwi
Un chip viene con el proyecto en el que está. Importa el proyecto de la forma habitual y sus chips llegan como componentes, con sus pines y sus cables:
- Un proyecto de Wokwi para VS Code o Wokwi CLI ya tiene cada chip compilado: el
chip.wasmque nombra suwokwi.toml, junto a unchip.json. Mokxi ejecuta ese archivo. - Un proyecto de wokwi.com tiene cada chip como dos archivos,
<name>.chip.jsony<name>.chip.c. Trae ambos. Unchip.jsony unchip.csueltos, un chip en su propia carpeta, o loschip.jsonysrc/main.cde un proyecto de Wokwi para VS Code también funcionan, y lo mismo los headers que el código del chip incluye desde archivos junto a él. - Un chip que el proyecto nombra bajo
dependenciesen sudiagram.json, como"chip-pwm": "github:Dlloydev/Wokwi-Chip-PWM@1.0.6", se descarga de esa versión en GitHub, igual que Wokwi.
El informe de importación dice qué chips pasaron y qué faltó en los que no. Un chip cuyos archivos no estaban en lo subido queda como una nota en el lienzo donde estaba.
El código de un chip nunca es parte del sketch de la placa. Un archivo .c que incluye wokwi-api.h pero llegó sin su .chip.json se nombra en el informe: agrega su .chip.json e importa de nuevo para ejecutarlo. El código de chip pegado en una de las pestañas de la placa queda fuera de la compilación de la placa, con un aviso en esa pestaña que dice que es un chip personalizado, así el sketch sigue ejecutándose. Para ejecutarlo, crea un chip con Nuevo chip personalizado y pega el código en su .chip.c.
Escribe el tuyo
Abre el menú Más de la barra de herramientas del lienzo y elige Nuevo chip personalizado…. Ponle nombre y el chip queda en el lienzo, empezando como un inversor. También aparece en el panel de componentes bajo Chips en este proyecto, para que coloques tantos como necesites.
Los dos archivos del chip se abren en el panel de código, y se eligen como los archivos de una placa desde la lista de arriba:
<name>.chip.jsonnombra sus pines, en orden desde el pin 1, y puede agregar deslizadores (controls) y una pantalla. El lugar de un pin en la lista es donde está en el chip: bajando por el lado izquierdo y luego subiendo por el derecho.<name>.chip.ces lo que hace, en C, con la API de chips de Wokwi:pin_init,pin_watch,pin_write,timer_start,attr_read,i2c_init,spi_init,uart_inity el resto.
Presiona Ejecutar y Mokxi compila primero el código del chip, en tu navegador. Un error en el código aparece en la línea de compilación sobre el código, y al presionarla va a esa línea. Un chip escrito en Mokxi también es un chip de Wokwi: los mismos dos archivos funcionan ahí.
Ejecutarlo
Presiona Ejecutar. Cada chip ejecuta su propio código junto al circuito, a la velocidad de la simulación: un temporizador del chip de un milisegundo se dispara después de un milisegundo simulado.
- Lo que el chip imprime con
printfaparece en el monitor serie, bajo el id del chip. - Un chip con pantalla dibuja sobre su cuerpo.
- Un chip con controles (una temperatura, un nivel de luz) tiene un deslizador para cada uno en su panel. Haz clic en el chip y mueve un deslizador mientras el circuito se ejecuta; el chip lee el nuevo valor de inmediato.
Las demás configuraciones de un chip son sus propiedades, como en el diagram.json de Wokwi.
Seguro de ejecutar
El código de un chip se ejecuta en un espacio propio. No puede alcanzar la página, tus archivos, la red ni ninguna otra parte del circuito, excepto a través de sus propios pines. Recibe como máximo 16 MB de memoria. Si su código se queda atascado en un bucle sin fin, Mokxi detiene solo ese chip, lo avisa en el monitor serie, y el resto del circuito sigue funcionando.
En qué se diferencia de Wokwi
Mokxi simula voltajes y Wokwi no, así que un pin de un chip lee alto por encima de 2.5 V. Un circuito que solo funcionaba en Wokwi porque ahí los niveles son perfectos puede necesitar una resistencia aquí, como la necesitaría en un banco de trabajo real. Las salidas de un chip manejan el voltaje que hay en su pin VCC, así que un chip en una placa de 3.3 V entrega 3.3 V.
Las funciones experimentales de Wokwi para leer la memoria del microcontrolador compilan pero aún no hacen nada en Mokxi: responden 0, y un chip que las usa lo avisa en el monitor serie.
Los chips escritos en Rust se ejecutan tal como sus autores los publicaron (su chip.wasm), y lo que imprimen con debugPrint también se muestra en el monitor serie.