Comece aqui

Importe um projeto de outra ferramenta

Traga um projeto do Wokwi, Tinkercad, Fritzing, KiCad, EasyEDA, LTspice, da IDE do Arduino, do Project Hub e outros, sem posicionar cada componente de novo.

Digite mokxi.com/ na frente de um link do Wokwi, CircuitJS, GitHub, gist, GitLab, Bitbucket, Codeberg, site de colagem, Dropbox, Google Drive, Instructables, Arduino Project Hub, Hackster ou um link compartilhado do Arduino Cloud na barra de endereços do navegador, por exemplo mokxi.com/wokwi.com/projects/322062421191557714, e aperte Enter. O editor abre com aquele projeto importado. Não é precisa conta. Um link do Tinkercad cai na página de importação, com os passos para o Tinkercad. Um link do Cirkit Designer não funciona assim: cole-o na página de importação.

Onde importar

Open the página de importação, ou no editor abra a ▾ beside Save and choose Import a project. You can also paste a project link, a diagram.json or a sketch anywhere on the canvas, or drop files, a folder or a zip straight onto the editor. Mokxi works out what the project is from what is inside it, not from its name.

O que acontece quando ele abre

  • O projeto que estava aberto é guardado. Desfazer na linha de resumo da importação o traz de volta, e Salvar ▾ > Voltar ao meu último projeto o abre depois.
  • A linha de resumo diz o que veio. Aperte-a para o relatório completo: o que virou uma nota no canvas e o que está faltando (conexões, arquivos e bibliotecas), cada um com o motivo.
  • Componentes que o Mokxi não tem viram notas rosa onde estavam, e uma linha "Deixado de fora:" no relatório nomeia cada um.
  • Os fios são organizados para você. Onde a fonte desenhou seus fios (Wokwi, Cirkit, muitos arquivos do Fritzing), eles seguem o mesmo caminho. Onde não desenhou (um esquemático, uma netlist, um arquivo de placa do Tinkercad), uma importação de até 30 fios é disposta com Organizar fios ao abrir. Uma maior mantém fios retos: aperte T para organizá-los.
  • O Mokxi AI pode terminar. Quando algo ficou de fora, a linha de resumo oferece Pedir ao Mokxi AI para terminar. O Mokxi AI propõe o componente do Mokxi mais próximo para cada nota, com os pinos ligados, e a biblioteca a instalar ou o #include a mudar para cada um que estiver faltando. Cada componente e pino é conferido primeiro com o catálogo real. Nada muda até você apertar um botão em uma linha (Adicionar ao canvas, Instalar, Mudar o include), e cada apertada é um passo de Desfazer.
  • Conte-nos envia de onde o projeto veio e o que estava faltando (nunca o seu código). Uma pessoa de verdade lê cada relato. Uma importação que falha oferece Tentar de novo quando outra tentativa pode ajudar.

Fontes nesta página

Wokwi, Cirkit Designer, GitHub, GitLab, Bitbucket e Codeberg, sites de colagem, Dropbox e Google Drive, Instructables, Project Hub, Hackster e Arduino Cloud, Fritzing, SimulIDE, KiCad, EasyEDA, Qucs e gEDA, Falstad CircuitJS, Tinkercad, PlatformIO, a IDE do Arduino, um arquivo .hex compilado, um link do Mokxi, texto colado, uma foto, LTspice, e Proteus, Multisim e CircuitMaker.

Do Wokwi

Full guide: Importar um projeto do Wokwi, com um link que abre já importado.

Novo no Mokxi vindo do Wokwi? Coming from Wokwi coloca cada ideia do Wokwi ao lado do nome dela aqui, e diz o que muda.

Use qualquer uma destas opções:

  • Um link. Cole o link de um projeto público, como https://wokwi.com/projects/322062421191557714. O servidor do Mokxi busca os arquivos do projeto em wokwi.com, e somente lá, e o seu navegador os lê. Um projeto privado não pode ser buscado por ninguém além de você: abra-o no Wokwi, baixe o zip do projeto e solte-o aqui.
  • Os arquivos. Solte ou escolha diagram.json, o sketch (sketch.ino ou como quer que se chame), quaisquer abas extras .h e .cpp, e libraries.txt.
  • O zip. O zip do projeto baixado do Wokwi funciona como está.

O que vem junto:

  • Componentes. Placas, LEDs, resistores, botões, chaves deslizantes, potenciômetros, servos, buzzers, LCDs de caracteres (com ou sem o módulo I2C), OLEDs, NeoPixels, anéis e fitas, displays de sete segmentos e TM1637, matrizes MAX7219, telas ILI9341, o HC-SR04, DHT22, PIR, DS18B20, MPU6050, DS1307 e HX711, teclados matriciais, encoders rotativos, joysticks, relés, drivers e motores de passo, registradores de deslocamento, cartões microSD e portas lógicas viram o componente equivalente no Mokxi, com sua cor, valor, endereço I2C e contagem de pixels.
  • Fios. Cada conexão entre dois componentes mapeados vira um fio, com os nomes dos pinos traduzidos (GND.2 é o segundo pino GND da placa, V+ em um servo é VCC, e assim por diante) e a cor de fio do Mokxi mais próxima. Um fio segue o traçado desenhado no Wokwi; um sem traçado recebe um único cotovelo. Aperte Organizar fios para roteá-los ao redor dos componentes.
  • Protoboards. Um componente encaixado numa protoboard do Wokwi é encaixado nos mesmos furos numa protoboard do Mokxi. Quando o componente do Mokxi tem um tamanho diferente (um resistor é mais curto aqui), uma perna fica no seu furo e as demais são ligadas por fio aos seus.
  • Rótulos. Um rótulo de texto do Wokwi se torna uma nota adesiva.
  • Código. O sketch e suas abas viram os arquivos da placa.

O que não vem, e como você fica sabendo:

  • Custom chips come across as parts that run their own code when the chip's files come with them (<name>.chip.json and <name>.chip.c, a bare chip.json and chip.c, a chip in a folder of its own, or a built chip.wasm), or when diagram.json names them under dependencies. See chips personalizados. O código de um chip nunca vira uma aba do sketch da placa. Um chip cujos arquivos faltam vira uma nota rosa, e o relato diz o que faltava, como um .chip.c that came without its .chip.json.
  • Componentes que o Mokxi ainda não tem viram uma nota rosa no canvas no lugar onde estava o componente, com o nome dele. Os fios aparecem listados no relato.
  • As conexões do monitor serial do Wokwi ficam de fora: o monitor serial do Mokxi está sempre conectado à placa.
  • Projetos MicroPython rodam no Raspberry Pi Pico e nas placas ESP32 clássicas (a DevKit V1, a DevKitC e a LOLIN32 Lite). Em outras placas os arquivos .py são mantidos como texto, mas não rodam.
  • Projetos CircuitPython (um code.py) rodam no Raspberry Pi Pico e no Arduino Nano RP2040 Connect, no firmware oficial do CircuitPython. Em outras placas o code.py é mantido como texto, e o relato diz o porquê.

Do Cirkit Designer

Full guide: Abra o link de um projeto do Cirkit Designer, com a lista de componentes e os passos.

Cole o link de um projeto compartilhado (https://app.cirkitdesigner.com/project/<id>, com ou sem número de versão no final) na página de importação ou no canvas. O servidor do Mokxi busca o arquivo do projeto no Cirkit, e só lá, sem login. Um projeto que não está compartilhado não pode ser lido.

  • Componentes. O Arduino Uno, Nano e Mega, o ESP32 e o ESP32-S3, o Raspberry Pi Pico, LEDs e LEDs RGB, resistores com seu valor, botões de pressão, buzzers, servos, potenciômetros, o DHT11 e o DHT22, o HC-SR04, OLEDs SSD1306, LCDs 16x2 (com ou sem I2C), relés, o 74HC595, o L298N, o DS18B20, o MPU6050, receptores de infravermelho, sensores PIR, módulos sensores de luz, teclados matriciais, NeoPixels, anéis e fitas, displays TM1637 e MAX7219 e displays de sete segmentos.
  • Os fios seguem os trajetos desenhados no Cirkit.
  • Código. O sketch de uma placa vem para essa mesma placa.
  • Qualquer outra coisa vira uma nota rosa com o nome dela, e o relato a lista.

Do GitHub

Full guide: Do GitHub para o Mokxi, passo a passo, com um exemplo que abre aqui.

Cole um link para um repositório público, uma pasta dentro dele, um único arquivo .ino ou um gist. Um projeto PlatformIO ou uma pasta de sketch do Arduino chega com seu código e sua lista de bibliotecas. Um link para um platformio.ini, ou para um arquivo na pasta src/ de um projeto PlatformIO, traz o projeto inteiro ao redor dele. O servidor do Mokxi busca projetos públicos apenas do GitHub, não envia nenhum tipo de login e limita o tamanho (10 MB para um repositório, 2 MB para um arquivo ou gist). Para um repositório privado, baixe o zip do GitHub e solte-o aqui.

Do GitLab, Bitbucket e Codeberg

Igual ao GitHub: cole o link para um repositório público, uma pasta dentro dele ou um único arquivo de sketch em gitlab.com, bitbucket.org ou codeberg.org. O Mokxi lê o próprio zip do site do repositório (10 MB no máximo) e abre a pasta que você vinculou, ou o arquivo (2 MB no máximo). Repositórios privados exigem login, e o Mokxi nunca envia um, então baixe o zip lá e solte-o aqui.

De um site de paste

Cole um link para um paste em pastebin.com, paste.ee, dpaste.org ou hastebin.com. O Mokxi busca o texto puro e o lê como lê qualquer coisa colada: um sketch, um diagram.json, uma exportação do CircuitJS. Um paste que o site mantém atrás de um login (o hastebin.com agora pede um) não pode ser lido; copie o texto e cole-o aqui.

Do Dropbox e do Google Drive

Um link de arquivo ou pasta do Dropbox, e um link de arquivo do Google Drive, funcionam quando qualquer pessoa com o link pode abri-los sem fazer login. Uma pasta do Dropbox chega como o zip que o próprio Dropbox cria, e é lida como um zip solto. Uma pasta do Drive, um Google Doc, um arquivo que pede login e um arquivo grande demais para o Drive verificar vírus não podem ser lidos: o Mokxi avisa, e você pode baixar o arquivo e soltá-lo aqui. Arquivos têm limite de 2 MB, e zips de 10 MB.

Do Instructables

Cole o endereço do projeto (instructables.com/<Project-Name>/). O Mokxi lê os links de anexos da página e abre os arquivos .ino, .zip e .fzz anexados, além de qualquer anexo .txt que contenha código. Ele lê apenas o instructables.com e seu servidor de arquivos, e no máximo oito anexos, 8 MB no total. Um projeto sem arquivo anexado não tem nada para ler: copie o código dos passos e cole-o.

Do Arduino Project Hub, Hackster e Arduino Cloud

Full guides: Arduino Project Hub, Hackster and Arduino Cloud, cada um com os passos e o que a página lê.

Cole o endereço de uma página de projeto (projecthub.arduino.cc/<user>/<project> ou hackster.io/<user>/<project>). O Mokxi lê o código colado na página (a seção Code, e qualquer bloco no texto que seja um sketch), e os arquivos .ino, .zip, .fzz, .h, .cpp e .txt de código anexados. O primeiro sketch abre como <project>.ino; outros blocos de código viram abas dele, e um segundo sketch completo (as páginas costumam mostrar duas versões) é mantido como uma aba .txt. Comandos de shell e tabelas de componentes ficam de fora. Quando a página não tem código próprio mas aponta para o GitHub, o Mokxi abre o projeto do GitHub indicado. O hardware listado na página chega como uma nota no relatório, não como componentes: coloque-os você mesmo. Imagens de esquemático e de protoboard, arquivos de impressão 3D e vídeos não são trazidos. O Mokxi lê apenas o site da própria página e seu servidor de arquivos, no máximo oito arquivos, 8 MB no total.

Um sketch do Arduino Cloud compartilhado (um link app.arduino.cc/sketches/<id>, ou um link create.arduino.cc/editor/.../preview de Compartilhar Sketch) abre com seus arquivos de código, quando o dono o definiu como Público, qualquer pessoa com o link pode ver o sketch. Um sketch privado não pode ser lido sem login: baixe-o lá (Baixar Sketch, que gera um zip) e solte o zip na página de importação.

Do Fritzing

Full guide: Fritzing para o Mokxi, passo a passo, com um exemplo que abre aqui.

Solte o arquivo .fzz (Arquivo, Salvar no Fritzing cria um). Ele é um zip com o sketch e o código da aba Code do Fritzing, e ambos são trazidos. Um .fz puro também funciona, com o .ino solto ao lado dele.

  • O que é lido. A visão de protoboard: cada componente, onde ele está, cada fio, e as trilhas da protoboard. As visões de esquemático e de PCB não são lidas, pois um fio desenhado só lá nunca esteve na protoboard; o relatório conta os componentes que estão apenas lá.
  • Componentes. A biblioteca principal do Fritzing: o Arduino Uno, Nano e Mega 2560, resistores com seu valor, LEDs com sua cor, LEDs RGB, botões de pressão, chaves alternadoras, de inclinação e reed, potenciômetros, capacitores cerâmicos e eletrolíticos, diodos e zeners, transistores NPN e PNP, um MOSFET de canal N, o regulador 7805, LDRs, termistores, o LM35, FSRs, o HC-SR04, o RHT03 (DHT22), alto-falantes piezo, servos, motores DC, o LCD 16x2, um display de sete segmentos, o 555, o 74HC595, a ponte H L293D e baterias de 9 V e AA; também diodos, capacitores e reguladores de qualquer encapsulamento, jacks DC, um chip que o Mokxi tenha pelo número de componente (um LM358, um 4N35, o CI genérico do Fritzing rotulado 595), um ATmega168 ou 328 puro (roda como o Uno do qual é o coração), e as fontes, o multímetro e o osciloscópio do simulador.
  • Placas de ilhas. As trilhas de cobre, e os cortes nelas, são unidas por fios do mesmo jeito que as trilhas de uma protoboard.
  • Barra de pinos e pontas de teste são conectores, não componentes: ficam de fora, e os fios que se encontravam neles continuam se encontrando.
  • Protoboards. A própria protoboard não é trazida. Os componentes de cada uma de suas trilhas são unidos por fios, o que conecta exatamente os mesmos pinos.
  • Notas. As notas do Fritzing viram notas adesivas.
  • Componentes de outras bibliotecas e componentes personalizados viram uma nota rosa com seus nomes.

Do SimulIDE

Full guide: SimulIDE para o Mokxi, passo a passo, com um exemplo que abre aqui.

Solte o arquivo de circuito: .sim1 do SimulIDE 1.0 em diante, ou .simu de versões mais antigas.

  • O que é lido. Cada componente, onde está e como está girado, cada fio, nós de junção e túneis (dois túneis com o mesmo nome são uma conexão). Rótulos de texto viram notas adesivas.
  • Componentes. Resistores, capacitores, indutores, LEDs, diodos e zeners, potenciômetros, LDRs, termistores, terra, tensões fixas, trilhos e baterias, BJTs, MOSFETs, amplificadores operacionais, o LM555, botões e chaves, motores DC, servos, o DHT22, o HC-SR04, o LCD HD44780, displays de sete segmentos, portas AND, OR e XOR de duas entradas, clocks, e o Arduino Uno, Nano e Mega (seus pinos são lidos pelo rótulo, como D13 e A0); também chips 74xx e CD4000, redes de resistores, barras de LED, displays de vários dígitos, portas com mais entradas (como uma cadeia de portas de duas entradas), pontas de prova, medidores, o osciloscópio e o analisador lógico, os displays Nokia 5110, SSD1306 e ILI9341, e um ATmega puro (como o Uno). O SimulIDE alimenta seus chips e displays sem fios, então a importação liga a alimentação deles.
  • Código. O SimulIDE guarda o sketch no seu próprio editor e carrega um .hex compilado na placa, e o Mokxi compila a partir do código-fonte, então coloque o .ino na pasta ou no zip junto com o circuito. O relatório avisa quando só havia o caminho do .hex.

Do KiCad

Full guide: Do KiCad para o Mokxi, passo a passo, com um exemplo que abre aqui.

Solte o esquemático: um .kicad_sch (KiCad 6 em diante), o .kicad_pro ou um zip da pasta do projeto (o Mokxi abre o esquemático raiz do projeto), ou o .sch do KiCad 4 e 5. Copiar e colar o texto do arquivo também funciona.

  • O que é lido. Todo símbolo, onde está, como está girado e espelhado, todo fio e junção, rótulos, rótulos globais e símbolos de alimentação. Os nós são feitos do jeito que o KiCad faz: pontas de fio, pinos e rótulos que se encontram são unidos, um pino ou rótulo no meio de um fio se junta a ele, fios que apenas se cruzam não, e rótulos ou símbolos de alimentação com o mesmo nome formam um só nó. Os pinos de alimentação ocultos de um chip (como VCC e GND de um 74HC595) entram no nó com o próprio nome, como no KiCad.
  • Componentes. Arduino Uno, Nano e Mega, módulos ESP32, ESP32-S3, ESP32-C3 e Pico, resistores, capacitores, indutores, LEDs e LEDs RGB, diodos e zeners, potenciômetros, botões de dois pinos, chaves deslizantes de três, transistores e MOSFETs, buzzers, baterias, chips 74xx e CD4000, o 555, amplificadores operacionais, reguladores lineares (78xx, AMS1117), NeoPixels e os módulos comuns de sensor e display pelo nome. Componentes de dois pinos mantêm a direção em que o esquemático os desenha.
  • Deixados como notas. Um símbolo para o qual o Mokxi não tem um componente equivalente vira uma nota com rótulo no lugar onde estava, e o relatório o lista com as conexões que levou junto. Um componente só é mapeado quando realmente é aquele componente: um array de diodos TVS não é um diodo, um motor de corrente alternada não é um motor de corrente contínua, uma chave de quatro pinos ou uma chave SPST não é a chave do Mokxi, e um conector rotulado "OLED" ainda é um barramento de pinos. Barramentos de pinos, pontos de teste e furos de montagem são onde os cabos se conectam, então ficam de fora e são citados no relatório.
  • Folhas dentro de folhas. Uma subfolha cujo arquivo acompanha o upload e que é usada uma vez é lida e unida pelos seus rótulos hierárquicos e pelos pinos de folha do pai. Uma subfolha que não está no upload, ou que é usada mais de uma vez, fica de fora e é citada no relatório.
  • Arquivos antigos. Um .sch do KiCad 4 ou 5 não traz seus símbolos, então os pinos são procurados no -cache.lib ou no .lib que o acompanha. Adicione-o ao upload. Sem ele, os componentes viram notas e o relatório explica o porquê; nenhum pino é adivinhado.
  • Código. Um esquemático não tem. Adicione o .ino ao upload e ele vai para a placa.
  • Não é lido. Barramentos (fios de barramento, entradas de barramento e rótulos como D[0..7]), a placa de circuito (.kicad_pcb), modelos de simulação e símbolos marcados como não populados.
  • Posições. Os componentes mantêm suas posições relativas na folha. Os fios são organizados com Organizar conforme o projeto abre (até 30 fios); um esquemático maior fica com fios retos, pino a pino, até você apertar Organizar fios.

Do EasyEDA

Full guide: Do EasyEDA para o Mokxi, passo a passo, com um exemplo que abre aqui.

Abra o esquemático no editor EasyEDA Standard, escolha File, depois Export, depois EasyEDA Source, e solte aqui o arquivo .json (ou cole o texto dele). Um link para um projeto do EasyEDA ou do OSHWLab não é baixado: o Mokxi mostra estes passos em vez disso. Projetos do EasyEDA Pro (.epro) são outro formato e ainda não são lidos. Arquivos com mais de 1 MB são ignorados, então exporte só o esquemático quando o projeto for grande.

  • O que é lido. Todo componente com seu designador, valor, encapsulamento e pinos; os fios; as junções; os rótulos de nó; e as bandeiras de alimentação e terra. Um arquivo-fonte do EasyEDA não tem netlist, então o Mokxi encontra as conexões do jeito que o editor as desenha: um fio une tudo ao longo dele, e rótulos e bandeiras com o mesmo nome são uma só conexão, em todas as folhas. As folhas são dispostas lado a lado.
  • Componentes. Resistores, capacitores, indutores, LEDs, diodos, transistores, chaves, potenciômetros, módulos comuns e chips 74xx e CD4000, além de placas tipo Arduino, identificados por designador, valor, encapsulamento e nomes de pinos (a mesma tabela que os leitores de KiCad e SPICE usam). Um componente sem equivalente no Mokxi vira uma nota rosa com o nome dele, e o relatório o lista.
  • Pinos. Um pino sem correspondência no componente do Mokxi é listado no relatório e deixado desconectado, nunca adivinhado.
  • Não lido. A placa (PCB) no mesmo projeto, desenhos e textos na folha, e bibliotecas de componentes. Um quadro ou logotipo sem pinos fica de fora.
  • Código. Um esquemático não tem código. Adicione o .ino ao upload e ele vai para a placa.

Do Qucs e do gEDA

Full guides: Qucs and gEDA e Lepton EDA, cada um com um esquemático de exemplo que abre aqui.

Solte o esquemático, um arquivo .sch. O Mokxi lê o que está dentro para descobrir qual ferramenta o salvou: Qucs (e Qucs-S e QucsStudio, que salvam do mesmo jeito) ou gEDA gschem (e Lepton EDA, que continua o gEDA). Você também pode colar o texto do arquivo na caixa.

  • Componentes. Resistores, capacitores, indutores, diodos e zeners, BJTs (NPN e PNP), MOSFETs, terra, fontes de tensão DC e fontes senoidais, das duas ferramentas; do gEDA também LEDs, baterias, potenciômetros, botões de pressão e símbolos de alimentação (Vcc, +5V, +3.3V). Qualquer outro componente vira uma nota adesiva com o nome dele, e o relatório o lista.
  • Pinos e nós. Nenhum dos dois arquivos diz onde estão os pinos de um componente: o Qucs guarda isso no programa e o gEDA no arquivo .sym de cada símbolo. O Mokxi conhece os pinos dos componentes acima e descobre onde cada um fica conforme o componente é girado e espelhado. Fios e nós que se encontram se conectam, rótulos de fio do Qucs e nomes de nó do gEDA com o mesmo nome formam um só nó, e os símbolos de alimentação do gEDA são nós nomeados. Um símbolo do gEDA incorporado no esquemático traz os próprios pinos, então ele também é lido.
  • Fica de fora. Blocos de simulação (.DC, .TR), equações, diagramas, diretivas e modelos SPICE, blocos de título e desenhos: o Mokxi roda o circuito por conta própria, então coloque uma ponta de prova, medidor ou osciloscópio onde você quer observar. Um valor que o Qucs pega de uma variável (R = Rload) recebe o padrão do Mokxi, e o relatório indica qual.
  • KiCad. Um .sch do KiCad é outro formato: veja Do KiCad acima.

Do Falstad CircuitJS

Full guide: Falstad CircuitJS para o Mokxi, passo a passo, com um exemplo que abre aqui.

Use qualquer uma destas opções:

  • Um link. Cole um link do CircuitJS com ?ctz= ou ?cct=, vindo de File, Export As Link. O circuito fica guardado no próprio link, então o Mokxi o lê de lá e não baixa nada.
  • O texto. Cole o texto de File, Export As Text, ou solte um arquivo de circuito salvo. Tanto o formato de texto antigo quanto o formato XML mais recente são lidos.

O que vem: resistores, capacitores, indutores, fontes e trilhos de corrente contínua, fontes senoidais, quadradas, triangulares, dente de serra e de pulso (como um gerador), terra, chaves, diodos, zeners, LEDs com sua cor, transistores NPN e PNP, MOSFETs, amplificadores operacionais, potenciômetros, o 555, LDRs, termistores, motores de corrente contínua, portas lógicas (mais de duas entradas viram uma cadeia de portas de duas entradas), inversores, entradas e saídas lógicas, flip-flops tipo D e JK, contadores, multiplexadores e chaves analógicas (como chips 74HC e CD4000 com sua alimentação), relés, lâmpadas, displays de sete segmentos e de números, e voltímetros e amperímetros (como um multímetro). Nós rotulados unem todos os nós com o mesmo nome, e o texto vira uma nota adesiva.

Duas coisas são diferentes no Mokxi, e o relatório diz isso: um amplificador operacional do CircuitJS é alimentado sem fios, então a importação adiciona uma alimentação e um terra para ele; e o CircuitJS não precisa de símbolo de terra, então adicione um onde está o 0 V do circuito, se ele não tinha nenhum. Todo outro elemento (transformadores, linhas de transmissão, subcircuitos personalizados e afins) vira uma nota rosa com o nome dele.

Do Tinkercad

Full guide: Tinkercad para o Mokxi, passo a passo, com um exemplo que abre aqui.

O Tinkercad Circuits consegue exportar um circuito como um arquivo de placa, que guarda todos os componentes e todos os fios. Com o código ao lado, o projeto inteiro vem, já ligado:

  1. O circuito. Abra o circuito no Tinkercad, aperte Export e baixe o arquivo .brd.
  2. O código. Abra Code, mude para Text e aperte o botão de download para salvar o .ino (ou selecione tudo e copie).
  3. Solte os dois na página de importação ou no editor, juntos.

O Mokxi coloca cada componente que ele tem onde estava: o Uno e o micro:bit, LEDs com sua cor, LEDs RGB, resistores e potenciômetros com seu valor, botões, chaves deslizantes e DIP, piezos, servos, motores de corrente contínua e com engrenagem, o TMP36, fotoresistores e fototransistores, o HC-SR04, PIR, receptor de infravermelho, sensores de solo, de força e de gás, o teclado 4x4, LCDs 16x2 e I2C, displays de sete segmentos, NeoPixels, transistores, diodos, capacitores, a bateria de 9 V e a fonte de alimentação, relés, o 7805, o L293D, o LM741, o 555, chips 74HC e o CD4511. Cada um vem ligado como o Tinkercad tinha, e o código vai para a placa. A protoboard não vem: suas trilhas já estão na ligação. Um componente que o Mokxi não tem (um sensor Parallax PING, por exemplo) é uma nota com o nome dele, e o relato o lista.

O arquivo de placa não tem código nem configurações como a tensão de uma fonte de alimentação (definida como 5 V) ou um endereço I2C, então o relatório diz isso quando é importante.

Sem .brd? Copie a tabela Component List (ou baixe como CSV), cole na caixa de importação com o código abaixo dela, ou solte o .csv e o .ino juntos. Os componentes chegam em linhas com seus valores, para você ligar.

O Mokxi nunca lê as páginas do Tinkercad: um link do Tinkercad exige login, então a página de importação explica como exportar.

Do PlatformIO

Full guide: PlatformIO para o Mokxi, passo a passo, com um exemplo que abre aqui.

Solte a pasta do projeto, ou um zip dela, com o platformio.ini na raiz.

  • A placa vem do ambiente que compila por padrão (default_envs, senão o primeiro [env:...]), lida do board do mesmo jeito que a exportação do PlatformIO escreve, e você pode escolher outra.
  • O código. O src/main.cpp vira o sketch.ino da placa (seu #include <Arduino.h> e declarações funcionam como estão), e os outros arquivos em src/ e include/ vêm ao lado. Arquivos em pastas dentro de src/ não vêm, já que um projeto do Mokxi não tem pastas.
  • Bibliotecas. Cada entrada de lib_deps é verificada como uma linha do libraries.txt do Wokwi, e as bibliotecas próprias do projeto em lib/ vêm junto como bibliotecas próprias do projeto. Uma biblioteca que o PlatformIO busca de uma URL do Git é apontada como faltando.
  • Outros frameworks. O Mokxi compila sketches do Arduino; o relatório diz isso quando o projeto usa outro framework, como o ESP-IDF.

Da IDE do Arduino

Full guide: Abra um arquivo .ino online, com o palpite da placa, a ligação que o Mokxi adiciona e um sketch de exemplo.

Solte um .ino, a pasta inteira do sketch ou um zip dela, ou cole o sketch na caixa de importação. Cada aba .ino, .h, .cpp e .c ao lado do sketch vem junto. Arquivos em pastas dentro do sketch (como src/) não vêm, porque um projeto do Mokxi não tem pastas: mova-os para junto do sketch e inclua-os pelo nome.

Quando a pasta do sketch tem um sketch.yaml (da Arduino IDE 2 e do arduino-cli) ou um sketch.json (de um download do Arduino Cloud), a placa vem de lá, e as bibliotecas são verificadas, junto com a linha depends= de cada biblioteca em uma pasta libraries/. O thingProperties.h de um sketch do Arduino Cloud é mantido, mas uma placa simulada não consegue acessar o Arduino IoT Cloud, então suas variáveis de nuvem mantêm os valores iniciais.

Caso contrário, a Arduino IDE não registra a placa, então o Mokxi adivinha a partir do sketch: WiFi.h ou ledcWrite indica uma ESP32, ESP8266WiFi.h uma ESP8266, Serial1 ou o pino 40 uma Mega, A7 uma Nano, e assim por diante. Escolha a certa na lista de Placa antes de abrir.

Um sketch vem sem circuito, então o Mokxi liga um a partir do que o código diz: as bibliotecas que ele inclui (Servo, DHT, LiquidCrystal_I2C, Adafruit_SSD1306, Adafruit_NeoPixel e outras) e os pinos que ele configura e usa. Um LED ganha seu resistor de 220 ohms. O resumo diz o que foi ligado, como "Ligamos: servo no 9, LED no 13 (com 220 ohms)"; mova ou religue tudo que diferir do seu circuito. Quando o código não diz nada sobre o que está ligado, o projeto começa com apenas a placa, pronto para você ligar. Para responder à dúvida de alguém no fórum com o código corrigido e rodando, use mokxi.com/fix (veja Ajude alguém a corrigir o código).

De um arquivo .hex compilado

Drop a compiled program, the .hex file the Arduino IDE saves with Sketch, Export Compiled Binary, or one somebody sent you, and it runs as it is: the project opens with the board alone, running that program as the one uploaded in its painel de Firmware. Ele começa na Uno, ou na Mega 2560 quando o programa é grande demais para uma Uno. Um .hex does not say which board it was built for, so pick the right one from the Board list before opening: the list offers the AVR boards whose flash holds it (Uno, Nano, Mega 2560, Leonardo, Pro Mini and ATtiny85). When the Arduino IDE saved two, the one without with_bootloader in its name is used.

Um programa compilado não tem código para editar. Ligue componentes aos pinos como de costume; para mudar o que ele faz, importe o sketch de origem.

Um link do Mokxi colado na caixa de importação, como mokxi.com/p/... ou um link de editor compartilhado do app.mokxi.com, já é um projeto do Mokxi, então não há nada para importar: a caixa avisa isso e o abre.

Colar

A caixa de importação lê o que assistentes de chat e fóruns colam: código dentro de cercas Markdown (```), um diagram.json do Wokwi e seu sketch em dois blocos de uma mesma resposta, e um projeto com texto ao redor. Um link para um site que o Mokxi não consegue ler indica onde esse site guarda o projeto e como trazê-lo (uma pasta do Drive, um link do OneDrive ou do Mega, um vídeo do YouTube).

Uma foto ou uma captura de tela

O Mokxi não consegue ler sozinho uma imagem de um circuito. Solte uma e a importação oferece Copiar prompt da foto: entregue esse prompt e a imagem ao ChatGPT, Claude ou Gemini, e cole a resposta aqui. Ele escreve o circuito no formato de projeto de IA do Mokxi e lista o que precisou adivinhar.

Do LTspice

Full guide: Do LTspice para o Mokxi, passo a passo, com um exemplo que abre aqui.

Solte o esquemático (.asc) na página de importação ou no editor, ou cole seu texto. O LTspice guarda onde cada símbolo está e onde cada fio passa, não quais pinos estão unidos, então o Mokxi calcula os nós como o LTspice faz: um pino, uma ponta de fio ou uma flag no mesmo ponto formam um nó, uma ponta de fio que cai sobre outro fio se junta a ele, fios que apenas se cruzam não, e flags com o mesmo nome formam um nó. Uma flag chamada 0 é o terra, e cada uma se torna um componente de terra.

O que é trazido: resistores, capacitores (também polarizados), indutores, diodos (também Schottky e zener), LEDs, transistores NPN e PNP, MOSFETs de canal N e P, fontes de tensão DC (como uma fonte flutuante), fontes senoidais e de pulso (como um gerador, quando o pino negativo da fonte está no terra), e os amplificadores operacionais de cinco pinos (UniversalOpamp2, opamp2) quando o pino de alimentação negativa está no terra. Um nome de modelo é mantido quando o Mokxi tem exatamente esse componente (2N3904, 1N4007, IRLZ44N; um grupo de ganho como BC337-40 é o seu componente), caso contrário o componente é o padrão do Mokxi para o tipo, e o relatório avisa. Uma linha .param é usada para preencher um {name} em um valor. Comentários viram notas adesivas.

The simulation commands (.tran, .op, .ac, .step and the rest) are read into the report's notes. Mokxi runs live, so press Run and watch the nodes with a scope or a meter; a frequency or DC sweep is not carried.

O que não é trazido, cada um como uma nota rosa que o nomeia: fontes de corrente, fontes comportamentais, PWL e outras fontes especiais, uma senoide ou pulso cujo pino negativo não está no terra, um amplificador operacional com alimentação negativa, todo símbolo que não seja um dos padrão acima (CIs, chaves, linhas de transmissão, subcircuitos), pois as posições dos pinos ficam no arquivo de símbolo que o LTspice guarda, e não no esquemático. Cartões de modelo e bibliotecas (.model, .lib) não são importados. O LTspice em si não é necessário, e nada no arquivo é executado.

Uma netlist SPICE exportada pelo LTspice (View > SPICE Netlist, um .net ou um .cir) abre como netlist, como na próxima seção.

Do Proteus, Multisim e CircuitMaker

Proteus, Multisim e CircuitMaker guardam os projetos em formatos fechados próprios, que só eles abrem. No Multisim, escolha Transfer, depois Export Netlist; no CircuitMaker, escolha File, depois Export, depois SPICE Netlist. Abra o .cir com Save ▾ > Open JSON or SPICE. Do Proteus, tire uma captura de tela e use o prompt da foto. Uma netlist do LTspice (.net, do View > SPICE Netlist) abre do mesmo jeito que qualquer deck SPICE, e um esquemático do LTspice (.asc) é importado diretamente (veja Do LTspice).

Bibliotecas

O relatório verifica todas as bibliotecas que o projeto menciona, no libraries.txt do Wokwi, no lib_deps do PlatformIO e nas linhas #include do sketch:

  • Incluída. O Mokxi compila com ela como ela é, como Servo.h, LiquidCrystal_I2C.h, Adafruit_SSD1306.h, Adafruit_NeoPixel.h e DHT.h.
  • Use isto. O Mokxi tem um driver que faz o mesmo trabalho com outro nome, e o relato indica qual cabeçalho incluir.
  • Faltando. Nada no Mokxi fornece isso.

Um zip com uma pasta libraries/ pasta (o layout do sketchbook do Arduino) ou uma pasta PlatformIO lib/ do PlatformIO traz suas bibliotecas junto como bibliotecas próprias do projeto, em qualquer plano. Veja os planos.

Tirando um projeto de novo

Nada prende um projeto. O botão Exportar no cabeçalho do editor baixa o projeto como um projeto Wokwi (diagram.json, sketch.ino e libraries.txt, em zip), uma pasta de sketch do Arduino IDE ou um projeto PlatformIO. A exportação para o Wokwi traz os componentes e os fios além do código; componentes sem equivalente no Wokwi são listados no README, e as trilhas de uma protoboard viram fios diretos.

Segurança

Nada do que você importa é executado enquanto é lido. Uploads, zips e texto colado têm limite de tamanho; um caminho que sai do projeto (../) ou começa em uma unidade de disco é recusado e citado no relato; só arquivos de código e de projeto são mantidos; arquivos XML que declaram um tipo de documento ou entidades são recusados, então nenhuma entidade é jamais expandida ou baixada; um link do CircuitJS é desempacotado com limite; e arquivos de biblioteca seguem as mesmas regras de uma biblioteca enviada no editor.