O editor

Chips personalizados escritos em C

Um chip personalizado é um componente cujo comportamento é código: um sensor para o qual o Mokxi não tem componente, um driver de display ou uma memória. Chips do Wokwi funcionam como estão.

These are different from the chips que você cria a partir de componentes. Aqueles são um circuito dobrado em uma caixa. Um chip personalizado é um programa.

Traga um chip do Wokwi

Um chip vem junto com o projeto em que está. Importe o projeto do jeito usual e seus chips vêm junto como componentes, com seus pinos e seus fios:

  • Um projeto do Wokwi para VS Code ou do Wokwi CLI já tem cada chip compilado: o chip.wasm que o wokwi.toml indica, ao lado de um chip.json. O Mokxi executa esse arquivo.
  • Um projeto do wokwi.com tem cada chip em dois arquivos, <name>.chip.json e <name>.chip.c. Traga os dois. Um chip.json e um chip.c soltos, um chip em uma pasta própria, ou o chip.json e o src/main.c de um projeto do Wokwi para VS Code também funcionam, e o mesmo vale para cabeçalhos que o código do chip inclui de junto dele.
  • Um chip que o projeto indica em dependencies no seu diagram.json, como "chip-pwm": "github:Dlloydev/Wokwi-Chip-PWM@1.0.6", é baixado desse release no GitHub, como o Wokwi faz.

O relatório de importação diz quais chips vieram e o que faltou em algum deles. Um chip cujos arquivos não estavam no upload vira uma nota no canvas, no lugar onde ele estava.

O código de um chip nunca faz parte do sketch da placa. Um arquivo .c que inclui wokwi-api.h mas veio sem seu .chip.json é citado no relatório: adicione o .chip.json e importe de novo para executá-lo. Código de chip colado em uma das abas da placa fica fora da compilação da placa, com um aviso nessa aba dizendo que é um chip personalizado, então o sketch continua rodando. Para executá-lo, crie um chip com Novo chip personalizado e cole o código no .chip.c dele.

Escreva o seu

Abra o menu Mais da barra de ferramentas do canvas e escolha Novo chip personalizado…. Dê um nome a ele, e o chip vai para o canvas, começando como um inversor. Ele também aparece no painel de componentes em Chips neste projeto, então você pode posicionar quantos precisar.

Os dois arquivos do chip abrem no painel de código, escolhidos como os arquivos de uma placa na lista no topo dele:

  • O <name>.chip.json nomeia seus pinos, em ordem a partir do pino 1, e pode adicionar controles deslizantes (controls) e um display. A posição de um pino na lista é onde ele fica no chip: descendo o lado esquerdo e subindo o direito.
  • O <name>.chip.c é o que ele faz, em C, com a API de chips do Wokwi: pin_init, pin_watch, pin_write, timer_start, attr_read, i2c_init, spi_init, uart_init e o resto.

Aperte Rodar e o Mokxi compila primeiro o código do chip, no seu navegador. Um erro no código aparece na linha de compilação acima do código, e clicar nela vai para a linha. Um chip escrito no Mokxi também é um chip do Wokwi: os mesmos dois arquivos funcionam lá.

Rodar

Aperte Rodar. Cada chip executa seu próprio código junto ao circuito, na velocidade da simulação: um timer de chip de um milissegundo dispara após um milissegundo simulado.

  • O que o chip imprime com printf aparece no monitor serial, sob o id do chip.
  • Um chip com display desenha no próprio corpo.
  • Um chip com controles (uma temperatura, um nível de luz) tem um controle deslizante para cada um no painel dele. Clique no chip e mova o controle enquanto o circuito roda; o chip lê o novo valor na hora.

As outras configurações de um chip são suas propriedades, como no diagram.json do Wokwi.

Seguro para executar

O código de um chip roda em uma caixa própria. Ele não pode alcançar a página, seus arquivos, a rede ou qualquer outra parte do circuito, exceto pelos seus próprios pinos. Ele recebe no máximo 16 MB de memória. Se o código dele travar em um loop sem fim, o Mokxi para só aquele chip, avisa no monitor serial, e o resto do circuito continua rodando.

Como difere do Wokwi

O Mokxi simula tensões e o Wokwi não, então um pino de chip lê nível alto acima de 2,5 V. Um circuito que só funcionava no Wokwi porque os níveis lá são perfeitos pode precisar de um resistor aqui, como precisaria numa bancada de verdade. As saídas de um chip acionam com a tensão no pino VCC dele, então um chip numa placa de 3,3 V aciona com 3,3 V.

As funções experimentais do Wokwi para ler a memória do microcontrolador compilam, mas ainda não fazem nada no Mokxi: elas respondem 0, e um chip que as usa avisa no monitor serial.

Chips escritos em Rust rodam como seus autores os publicaram (o chip.wasm deles), e o que imprimem com debugPrint também aparece no monitor serial.