feat(i18n): update pt-BR texts

Author: arcostasi

i18n/pt-BR/docusaurus-plugin-content-docs/current/chips-api/getting-started.md

@@ -29,7 +29,7 @@ Adicione o seguinte snippet ao seu diagram.json:
 
 `{ "type": "chip-i2c-counter", "id": "chip1", "top": 0, "left": 0, "attrs": {} },`
 
-O Wokwi gera automaticamente uma **placa de quebra** para o seu chip. Edite `i2c-counter.chip.json` para definir os pinos para sua peça. O array `pins` deve conter os nomes dos pinos do seu chip, começando pelo pino número `1`. Se você deseja pular alguns pinos (por exemplo, deseja que o quadro de acesso tenha apenas pinos no lado esquerdo), use uma string vazia (`""`) para o nome do pino.
+O Wokwi gera automaticamente uma **placa de expansão (breakout board)** para o seu chip. Edite `i2c-counter.chip.json` para definir os pinos para sua peça. O array `pins` deve conter os nomes dos pinos do seu chip, começando pelo pino número `1`. Se você deseja pular alguns pinos (por exemplo, deseja que o quadro de acesso tenha apenas pinos no lado esquerdo), use uma string vazia (`""`) para o nome do pino.
 
 ## Usando a API
 
@@ -60,7 +60,7 @@ As mensagens de depuração do seu chip serão impressas na cor verde:
 
 Além disso, você pode usar o [Analisador Lógico Wokwi](../guides/logic-analyzer) para depurar a comunicação com seu chip personalizado.
 
-## Referência da API do chip 📖
+## Referência da API dos chips 📖
 
 - [API de pinos GPIO](gpio)
 - [API Analógica](analog)

i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/esp32.md

@@ -23,11 +23,12 @@ Você pode contribuir com placas adicionais enviando um pull request para [wokwi
 
 ## Começando
 
-Você pode usar o simulador ESP32 de três maneiras:
+Você pode usar o simulador ESP32 para executar diferentes tipos de aplicativos:
 
-1. Crie projetos usando o ESP32 Arduino Core (incluindo projetos ESP-IDF)
-2. Execute projetos MicroPython (também CircuitPython no ESP32-S2)
-3. Simule arquivos de aplicativo bin que você construiu em sua máquina (por exemplo, usando ESP-IDF)
+1. Projetos ESP32 Arduino Core (incluindo projetos ESP-IDF)
+2. Projetos MicroPython e CircuitPython
+3. Projetos Rust (consulte https://wokwi.com/rust)
+4. Arquivos de firmware de aplicativos personalizados (por exemplo, aplicativos criados usando o ESP-IDF)
 
 ### Arduino Core
 
@@ -43,9 +44,15 @@ Comece com o [modelo de projeto MicroPython ESP32](https://wokwi.com/projects/ne
 
 Nota: Enquanto a simulação está em execução, pressione Ctrl+C dentro do Terminal Serial para entrar no _MicroPython REPL_. Alternativamente, você pode editar o código de Exemplo Blink e remover o loop while. Para obter mais informações, consulte o [Guia MicroPython](./micropython).
 
-### Aplicativo personalizado (.bin)
+### Firmware de aplicativo personalizado
 
-Abra o [modelo de projeto de aplicativo personalizado ESP32](https://wokwi.com/projects/305457271083631168), e pressione "F1" no editor de código. Em seguida, escolha "Carregar Arquivo HEX e Iniciar Simulação...". Escolha qualquer arquivo .bin em seu computador e a simulação será iniciada.
+Abra o [modelo de projeto de aplicativo personalizado do ESP32](https://wokwi.com/projects/305457271083631168) e pressione "F1" no editor de código. Em seguida, escolha "Fazer upload do firmware e iniciar a simulação...". Escolha qualquer arquivo .bin, .elf ou .uf2 do seu computador e a simulação será iniciada.
+
+:::info Informação
+Ao carregar um firmware personalizado, é recomendável criar um único arquivo .bin que contenha o gerenciador de inicialização, a tabela de partições e aplicativo. Você pode usar o [comando esptool merge_bin](https://docs.espressif.com/projects/esptool/en/latest/esp32/esptool/basic-commands.html#merge-binaries-for-flashing-merge-bin) para criar o arquivo.
+
+Para projetos ESP-IDF, você também pode criar um único arquivo UF2 usando o comando: `idf.py uf2`. O arquivo estará localizado em `build/uf2.bin`, que pode ser carregado no simulador.
+:::
 
 ## Exemplos no simulador
 

i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/logic-analyzer.md

@@ -71,7 +71,7 @@ Os nomes dos canais afetam apenas a saída do arquivo VCD. Os pinos de entrada d
 
 ### Visualizando os dados no PulseView
 
-PulseView é uma GUI de código aberto que suporta Analisadores Lógicos. Ele roda em Linux, Windows, Mac OS X e há até uma versão para Android. Você pode visitar a [página de downloads](https://sigrok.org/wiki/Downloads) para obter a última versão.
+PulseView é uma GUI de código aberto que suporta Analisadores Lógicos. Ele roda em Linux, Windows, Mac OS X e há até uma versão para Android. Você pode visitar a [página de downloads](https://sigrok.org/wiki/Downloads) para obter a última versão. Para usuários de computadores Mac com a arquitetura ARM (M1/M2), siga o [guia PulseView no Mac M1/M2](https://nishtahir.com/running-pulseview-on-an-m1-mac/).
 
 Carregue o arquivo de sinal gravado (VCD) clicando na pequena seta ao lado do botão "Open" e selecione a opção: "Import Value Change Dump data..."
 

i18n/pt-BR/docusaurus-plugin-content-docs/current/parts/wokwi-servo.md

@@ -34,6 +34,7 @@ Um Motor Micro Servo padrão
 ## Exemplos no simulador
 
 - [Sweep](https://wokwi.com/projects/344891730528567891)
+- [ESP32 Servo Sweep](https://wokwi.com/projects/323706614646309460)
 - [Knob](https://wokwi.com/projects/344892191015961170)
 - [Controlando 1 servo com dois botões no Arduino Nano](https://wokwi.com/projects/328312829780165204)
 - [Controlando 5 servos com Arduino Uno](https://wokwi.com/projects/305087394119418434)

i18n/pt-BR/docusaurus-plugin-content-docs/current/parts/wokwi-tm1637-7segment.md

@@ -9,12 +9,14 @@ Módulo display de LED sete segmentos com interface TM1637 de 4 fios
 
 ## Nome dos Pinos
 
-| Nome | Descrição                 |
-| ---- | ------------------------- |
-| CLK  | Segmento superior         |
-| DIO  | Segmento superior direito |
-| VCC  | Segmento inferior direito |
-| GND  | Segmento inferior         |
+| Nome | Descrição             |
+| ---- | --------------------- |
+| CLK  | Entrada de clock      |
+| DIO  | Entrada de dados \*   |
+| VCC  | Tensão de alimentação |
+| GND  | Terra                 |
+
+\* O pino DIO também é usado para reconhecer os dados recebidos do microcontrolador, colocando-o em nível lógico baixo para um ciclo de clock específico.
 
 ## Atributos
 

i18n/pt-BR/docusaurus-plugin-content-docs/current/vscode/debugging.md

@@ -0,0 +1,40 @@
+---
+title: Depurando seu código
+sidebar_label: Depurando
+---
+
+Você pode depurar seu código enquanto ele está sendo executado na simulação usando o depurador VS Code. Para configurar o depurador, siga estas etapas:
+
+1. Adicione a seguinte linha à seção `[wokwi]` de seu arquivo de configuração `wokwi.toml`:
+
+```toml
+gdbServerPort=3333
+```
+
+2. Crie um arquivo de configuração de inicialização para o VS Code em `.vscode/launch.json`. Aqui está um modelo que você pode usar:
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Wokwi GDB",
+      "type": "cppdbg",
+      "request": "launch",
+      "program": "${workspaceFolder}/build/your-firmware.elf",
+      "cwd": "${workspaceFolder}",
+      "MIMode": "gdb",
+      "miDebuggerPath": "/usr/local/bin/xtensa-esp32-elf-gdb",
+      "miDebuggerServerAddress": "localhost:3333"
+    }
+  ]
+}
+```
+
+Substitua o caminho `program` pelo caminho para o arquivo ELF do seu firmware e o `miDebuggerPath` pelo caminho para um executável GDB que suporte a arquitetura do seu projeto (por exemplo, para projetos AVR, use `avr-gdb`).
+
+3. Inicie o simulador Wokwi pressionando **F1** e selecionando a opção "**Wokwi: Start Simulator and Wait for Debugger**". O simulador será carregado, mas o programa ficará em pausa, aguardando a conexão do depurador. Em seguida, pressione **F5** para iniciar o depurador.
+
+:::caution Aviso
+Você precisa iniciar o Wokwi antes de iniciar o depurador. Se você iniciar o depurador primeiro, ele não conseguirá se conectar ao simulador.
+:::

i18n/pt-BR/docusaurus-plugin-content-docs/current/vscode/getting-started.md

@@ -0,0 +1,66 @@
+---
+title: Introdução ao Wokwi para VS Code
+sidebar_label: Iniciando
+---
+
+Wokwi for Visual Studio Code fornece uma solução de simulação para engenheiros de sistemas embarcados e IoT. A extensão se integra ao seu ambiente de desenvolvimento existente, permitindo que você simule seus projetos diretamente do seu editor de código.
+
+Você pode usar Wokwi para VS Code com Zehpyr Project, PlatformIO, ESP-IDF, Pi Pico SDK, NuttX, Rust, Arduino CLI e outras estruturas e cadeias de ferramentas de desenvolvimento incorporadas.
+
+:::caution Aviso
+Wokwi for VS Code está atualmente em beta público. Após a versão beta, alguns recursos estarão disponíveis apenas para usuários pagos.
+:::
+
+<figure>
+  <video src="https://wokwi.github.io/video-assets/vscode/wokwi-vscode-1s.mp4" autoPlay muted loop style={{width:'100%'}}></video>
+  <figcaption>Wokwi para VS Code executando um projeto ESP-IDF</figcaption>
+</figure>
+
+## Instalação
+
+Primeiro, instale a extensão [Wokwi for VS Code](https://marketplace.visualstudio.com/items?itemName=wokwi.wokwi-vscode). Em seguida, pressione `F1` e selecione "Wokwi: Solicitar uma nova licença". O VS Code solicitará que você confirme a abertura do site Wokwi em seu navegador. Confirme clicando em "Abrir".
+
+Em seguida, clique no botão roxo que diz "GET YOUR LICENSE". Você pode ser solicitado a entrar em sua conta Wokwi. Se você não tiver uma conta, poderá criar uma gratuitamente.
+
+O navegador pedirá uma confirmação para enviar a licença para o VS Code. Confirme (talvez seja necessário confirmar duas vezes, uma vez no navegador e outra no VS Code). Você verá uma mensagem no VS Code que diz "License activated for [seu nome]". Parabéns!
+
+## Exemplos de Projetos
+
+Para configurar o wokwi para seu próprio projeto, faça isso.
+
+Se você quiser começar rapidamente e brincar com o Wokwi para VS Code, aqui estão alguns projetos de exemplo, pré-configurados com os arquivos [diagram.json](../diagram-format) e [wokwi.toml](./project-config).
+
+:::info Aviso
+Antes de simular qualquer um dos projetos a seguir, você precisa compilar o código e gerar o arquivo firmware/ELF. Consulte o arquivo README do projeto para obter instruções sobre como compilar o código.
+:::
+
+### Exemplos do Platform IO
+
+- [Arduino Simon Game](https://github.com/wokwi/arduino-simon-game) - Jogo da memória com 4 LEDs, 4 botões, buzzer e display de 7 segmentos
+- [ESP32 Network Clock](https://github.com/wokwi/esp32-ntp-clock) - Sincroniza a hora da internet (NTP) e a exibe em um display LCD
+- [ESP32 Web Server](https://github.com/wokwi/esp32-http-server) - Servidor HTTP que controla 2 LEDs
+
+### Exemplos do ESP-IDF
+
+- [WiFi + FreeRTOS Tasks](https://github.com/wokwi/esp32-idf-hello-wifi)
+
+### ESP32 + Rust
+
+- [Hello Display](https://github.com/playfulFence/esp-hello-display/tree/feature/vscode-wokwi) - Usando o display ILI9341 com ESP32-C3
+- [esp-gallery](https://github.com/playfulFence/esp-gallery) - Galeria de arte interativa (ESP32-C3)
+- [ESP32-S2 Keypad Example](https://github.com/playfulFence/esp-keypad-example/tree/feature/vscode-wokwi)
+- [Scrolling text](https://github.com/playfulFence/esp-rolling-stone) - Usando a matriz de pontos com LED
+- [Etch-A-Sketch](https://github.com/playfulFence/esp-etch-a-sketch) - Desenhe matriz de pontos com LED usando um joystick analógico
+
+### Exemplos de extensões do Arduino
+
+:::caution Aviso
+A extensão Arduino do VS Code requer Arduino IDE 1.8 ou [Arduino CLI](https://github.com/microsoft/vscode-arduino/issues/1477#issuecomment-1278699661) instalado. Não funciona (ainda) com o Arduino IDE 2.0.
+:::
+
+- [Arduino LCD-1602 "Olá Mundo"](https://github.com/wokwi/arduino-lcd-helloworld)
+
+### Outros exemplos
+
+- [Custom chips example](https://github.com/wokwi/inverter-chip) - Um [chip personalizado](../chips-api/getting-started) que inverte o sinal de entrada
+- [Raspberry Pi Pico SDK](https://github.com/wokwi/pico-sdk-blink) - Blinky para Raspberry Pi Pico

i18n/pt-BR/docusaurus-plugin-content-docs/current/vscode/project-config.md

@@ -0,0 +1,69 @@
+---
+title: Configurando seu projeto (wokwi.toml)
+sidebar_label: Configurando seu projeto
+---
+
+Para simular seu projeto no Wokwi, você precisa criar dois arquivos no diretório raiz do seu projeto:
+
+- `wokwi.toml` - um arquivo de configuração que informa ao Wokwi como executar seu projeto.
+- `diagram.json` - um [arquivo de diagrama](../diagram-format) que descreve o circuito.
+
+## wokwi.toml
+
+Um arquivo `wokwi.toml` básico se parece com isto:
+
+```toml
+[wokwi]
+version = 1
+firmware = 'path-to-your-firmware.hex'
+elf = 'path-to-your-firmware.elf'
+```
+
+Substitua "path-to-your-firmware" pelo local do firmware compilado, **relativo** ao arquivo wokwi.toml (que é o diretório raiz do seu espaço de trabalho).
+
+A extensão do arquivo de firmware depende da placa que você está usando:
+
+| Placa                      | Tipos de firmware suportados |
+| -------------------------- | ---------------------------- |
+| Arduino Uno/Mega, ATtiny85 | .hex, .elf                   |
+| Raspberry Pi Pico          | .hex, .uf2                   |
+| ESP32 Family               | .bin, .uf2, .elf             |
+
+Verifique sua configuração pressionando **F1** e selecionando "**Wokwi: Start Simulator**".
+
+:::caution Aviso
+Evite usar barras invertidas (`\`) em seus caminhos. Em vez disso, use a barra (`/`), pois permite abrir seu projeto em qualquer plataforma (Windows, Mac e Linux).
+:::
+
+### Gateway IoT (ESP32 Wi-Fi)
+
+O Wokwi for VS Code inclui uma versão integrada do [Wokwi Private IoT Gateway](../guides/esp32-wifi#internet-access), que permite conectar o WiFi virtual do ESP32 simulado à sua rede local e à Internet.
+
+Você também pode se conectar ao ESP simulado do seu computador (por exemplo, você está executando um servidor web no ESP32). Para fazer isso, configure o encaminhamento de porta em wokwi.toml. Por exemplo, para encaminhar a porta local 8180 para a porta 80 no ESP32, adicione a seguinte configuração:
+
+```
+# Encaminhe http://localhost:8180 para a porta 80 no ESP32 simulado:
+[[net.forward]]
+from = "localhost:8180"
+to = "device:80"
+```
+
+Para um exemplo completo, consulte o projeto [ESP32 Web Server](https://github.com/wokwi/esp32-http-server).
+
+### Chips personalizados
+
+Você pode carregar chips personalizados para a simulação adicionando uma seção `[[chip]]` à sua configuração wokwi.toml. O exemplo a seguir carregará um chip de "chip/inverter.chip.wasm" e o disponibilizará sob o nome `chip-inverter` no diagrama do Wokwi:
+
+```toml
+[[chip]]
+name = 'inverter'  # Para usar o chip no diagram.json, adicione uma peça do tipo "chip-inverter".
+binary = 'chips/inverter.chip.wasm'
+```
+
+O Wokwi também requer um arquivo JSON que descreva os pinos do chip. O arquivo JSON deve ter o mesmo nome do binário wasm, mas com uma extensão json (por exemplo, `chips/inverter.chip.json` do exemplo acima). Para um exemplo completo, confira [o repositório do chip inversor](https://github.com/wokwi/inverter-chip).
+
+Você pode adicionar vários chips ao seu projeto adicionando várias seções `[[chip]]`, cada uma com um `nome` e `binário` diferentes.
+
+## diagram.json
+
+Você pode copiar o [arquivo de diagrama](../diagram-format) de um projeto existente em [Wokwi.com](https://wokwi.com). Por exemplo, se você estiver trabalhando em um projeto ESP32, poderá copiar o conteúdo do arquivo diagram.json de https://wokwi.com/projects/new/esp32.

i18n/pt-BR/docusaurus-plugin-content-docs/current/welcome.md

@@ -49,6 +49,8 @@ Aqui estão alguns exemplos rápidos de coisas que você pode fazer com o Wokwi:
 - [Analisador Lógico Virtual](guides/logic-analyzer) - Capture sinais digitais em sua simulação (por exemplo, UART, I2C, SPI) e analise-os em seu computador.
 - [Depuração avançada com GDB](gdb-debugging) - Poderoso depurador Arduino e Raspberry Pi Pico para usuários avançados.
 - [Simulação de cartão SD](parts/wokwi-microsd-card) - Armazene e recupere arquivos e diretórios do seu código. Os membros do [Club](getting-started/wokwi-club) também podem fazer upload de arquivos binários (como imagens)
+- [API dos chips](chips-api/getting-started) - Crie seus próprios chips e peças personalizados e compartilhe-os com a comunidade.
+- [Integração no Visual Studio Code](vscode/getting-started) - Simule seus projetos incorporados diretamente no VS Code.
 
 ## Quanto custa isso?