Comece aqui

Vindo do Wokwi

Seus projetos do Wokwi abrem no Mokxi como estão. Veja como cada ideia do Wokwi é chamada aqui, e o que muda.

Traga um projeto

The import itself, file by file (the link, the zip, diagram.json, libraries.txt, custom chips, MicroPython) is on Importar um projeto do Wokwi; esta página é sobre como cada ideia do Wokwi se chama aqui.

Paste the project's link (https://wokwi.com/projects/...) into the página de importação, ou solte o zip do projeto do Wokwi, ou solte os próprios arquivos: diagram.json, the sketch and its tabs, libraries.txt, and wokwi.toml if it has one. A Wokwi for VS Code project in the PlatformIO layout (src/, include/, platformio.ini) works too. You can also type mokxi.com/ in front of the Wokwi link in the address bar. The import report lists everything that came across and everything that did not, with the reason, and the project you had open is kept: Undo on the summary line puts it back.

A diagram.json written by hand or by an AI tool imports too. Part types can be written plainly (esp32, bluepill, ssd1306, buzzer, logicanalyser), in any case, with _ or -, and parts Wokwi does not have but Mokxi does (battery, regulator, nrf24l01, multimeter) can be named by their Mokxi type. A part neither knows becomes a note, and the rest of the project still opens.

Every part type in Wokwi's catalog comes across: as the matching Mokxi part, or, for a board or screen Mokxi does not run yet, as a drawn part that keeps its wires (and a board its code). Wokwi's D flip-flops and 2-to-1 multiplexer are Mokxi's ideal flip-flops and multiplexador do Mokxi, e seu sensor de batimento cardíaco é o Pulse Sensor. Apenas um chip personalizado (chip-*) becomes a note.

Lado a lado

No Wokwi No Mokxi O que acontece na importação
diagram.json O diagrama: componentes, fios e notas no canvas Cada componente se torna o componente Mokxi equivalente, com seus pinos e configurações. Posições e rotações são mantidas.
Os attrs de um componente As propriedades do componente, no painel quando você clica nele Cor, valor, endereço I2C, quantidade de pixels, temperatura e as outras configurações que mudam o comportamento são mantidas.
connections Fios Cada um mantém sua cor. Dicas de roteamento viram os cantos do fio. Organizar fios os passa por fora dos componentes.
$bb (encaixado numa protoboard) Um pino encaixado num furo da protoboard O componente fica nos mesmos furos.
wokwi-junction Fios unidos num pino Todos os fios que se encontravam na junção ficam ligados.
wokwi-text Uma nota adesiva O texto fica onde estava.
sketch.ino e abas Os arquivos da placa, no painel de código Todos eles, como estão.
libraries.txt Bibliotecas incluídas Toda biblioteca que o Mokxi inclui já está lá e é grátis: nada para instalar. As que o Mokxi não tem são indicadas no relatório.
wokwi.toml Nada é necessário para um sketch O Mokxi compila um sketch do Arduino quando você aperta Rodar, então nenhum caminho de firmware é necessário. Um projeto do Pico SDK roda o .uf2 ou .elf indicado no arquivo, quando o upload o inclui. Uma pasta de cartão SD é colocada no microSD.
Fios do $serialMonitor O monitor serial Sempre conectado à placa. Não precisa de fios.
Configurações do serialMonitor O painel serial O plotter é o botão Plot. Linhas digitadas terminam com quebra de linha, como no Wokwi.
Wokwi-GUEST Wi-Fi A configuração de ponto de acesso da placa Definida como Wokwi-GUEST sem senha, para que seu WiFi.begin conecte sem mudanças.
wokwi-wifi-ap A configuração de ponto de acesso da placa O nome e a senha dela são copiados para a placa.
Analisador lógico Analisador lógico O do Mokxi tem quatro canais, então D4 a D7 vão para um segundo ao lado dele. Os nomes dos canais viram rótulos de nós.
Chips personalizados (chip-*) Chips personalizados Cada chip vem como um componente com seus pinos e roda seu próprio código, quando o chip.json e o código (.chip.c) ou o chip.wasm compilado dele estão na importação.
Atalhos de teclado em componentes (key) Clique no componente Aperte botões e gire botões giratórios com o mouse ou com o dedo.

O que conferir depois da importação

  • Posições iniciais. O botão de um potenciômetro, uma chave de deslizamento, a distância do HC-SR04 e outros componentes que você move com a mão começam em repouso no Mokxi. O relatório avisa quando o projeto do Wokwi começou um deles em outra posição. Mova-o no canvas enquanto o sketch roda.
  • Placas que o Mokxi desenha, mas ainda não roda. Algumas placas (a ESP32-S2, a ESP32-P4, a ESP-Mosaico, as placas STM32 Nucleo, a Pi Pico 2) vêm com seus fios e código, então você pode exportá-las para hardware real, mas o Mokxi Rodar ainda não as inicia. A TV de vídeo composto do Wokwi e seu painel MIPI DSI de 8 polegadas são desenhados da mesma forma. A lista completa está em Placas que ainda não são simuladas.
  • Bibliotecas que o Mokxi não inclui. O relatório as nomeia. Adicione uma como biblioteca personalizada para compilar o sketch.
  • MicroPython. Um projeto de MicroPython na Raspberry Pi Pico, num ESP32 clássico (o DevKit V1, o DevKitC ou o LOLIN32 Lite), num ESP32-S3, num ESP32-C3 ou num ESP32-C6 roda, no firmware oficial do MicroPython, e a rede de um ESP32 se chama Wokwi-GUEST sem senha, como no Wokwi. Em qualquer outra placa os arquivos .py são mantidos como texto, mas não rodam. Veja MicroPython no ESP32.
  • CircuitPython. Um projeto de CircuitPython (um code.py) para a Raspberry Pi Pico ou o Arduino Nano RP2040 Connect é importado com a placa configurada para CircuitPython e roda, no firmware oficial do CircuitPython. O Wokwi pode ter usado outra versão do CircuitPython; o relatório de importação diz qual roda aqui. Em outra placa os arquivos dele code.py é mantido como texto. Veja CircuitPython no Pico.
  • Pico SDK, ESP-IDF and Rust projects. A Pico SDK project runs its prebuilt .uf2 or .elf, and an ESP-IDF or Rust project on an ESP32 or ESP32-S3 board its .bin or .elf (see Rodar um firmware pré-compilado): inclua a pasta build/ folder in the upload, or let wokwi.toml name the file. On an ESP32-C3 or C6 an ESP-IDF build comes across as code and does not run yet.