# Wokwi

[toc]

---
## Instalando Wokwi no vscode
Vá em estensôes(passo 1), procure por "wokwi" e instale a extensão "Wokwi Simulator"(passo 2).

---
## Preparando o workspace
### Compilando o Código
De começo, o seu código no platformio estará assim:

Compile o código clicando em "build" e espere até aparecer "SUCCES" verde:


Com a compilação do código foram gerados alguns arquivos dentro de "*.pio\build\\(nome_do_enviroment)*".
Dentre eles, o "**firmware.bin**" e o "**firmware.elf**", você deverá copiar o caminho deles mais tarde.

Agora, você deverá criar dois arquivos (não precisarão estar em pastas):

---
### wokwi.toml:

Clique com o botão direito nessa área da esquerda e crie um novo arquivo.

Coloque o nome do arquivo de "**wokwi.toml**":

Escreva no arquivo as seguintes linhas:

[wokwi]
version = 1
firmware = ''
elf = ''


Em firmware você devrá colocar o caminho do **framework.bin** entre as aspas simples, e em elf o caminho do **framework.elf**.
Para copiar o caminho, é só clicar com o botão direito no arquivo e ir em *Copy Relative Path*



Note que para você, onde está escrito "abc" no path estará escrito outra coisa, por conta do nome do seu enviroment. O meu é abc.

---

### diagram.json
Crie um arquivo, do mesmo modo que o wokwi.toml foi criado, mas agora com o nome "**diagram.json**"
Dentro desse arquivo, você deverá colocar o diagrama do circuito, em formato json, que você fez no wokwi(obs: site, e não extensão do vscode).


Cole o texto que está escrito dentro do diagram.json do seu vscode.

---

## Licença
Agora, você precisará colocar uma licença para poder usar a simulação. A licensa poderá ser facilmente obtida.
Clique em **F1** para abrir um campo de pesquisa e pesquise por "**Wokwi: Request a New License**" e clique nessa opção:

Abrirá uma janela, clique em open:


Você será redirecionado para um site, é necesaário que você tenha uma conta no wokwi. Você deverá se conectar na sua conta, feito isso, clique em "**GET YOUR LICENSE**"

Clique em "**Abrir Visual Studio Code**"

Clique em open

E, por fim, irá aparecer que a sua licença foi concedida

---

## Simulação
Com o código escrito na main. Agora é a hora de simular de fato o circuito. Lembre-se sempre de compilar o código toda vez depois de alterar ele, para usar a simulação.

Clique em **F1** para abrir novamente o campo de pesquisa. Agora, pesquise por "**Wokwi: Start Simulator**"

Note que temos duas opções, as duas fazem simulações.
A diferença delas é que a opção **"Wokwi: Start Simulator"** inicia assim:

e a opção **"Wokwi: Start Simulator for Debugguer"** permite a vizualização de algumas informações a mais parafins de debug: