# Wokwi

## Docs

- [Welcome to Wokwi](https://mintlify.wiki/wokwi/wokwi-docs/introduction.md): Online electronics and microcontroller simulator for Arduino, ESP32, Raspberry Pi Pico, STM32, and more
- [Quickstart](https://mintlify.wiki/wokwi/wokwi-docs/quickstart.md): Get started with Wokwi in minutes - create your first electronics simulation
- [Supported Hardware](https://mintlify.wiki/wokwi/wokwi-docs/supported-hardware.md): Complete list of microcontrollers, sensors, displays, and components available in Wokwi
- [Frequently Asked Questions](https://mintlify.wiki/wokwi/wokwi-docs/faq.md): Common questions about Wokwi electronics simulator
- [Interactive Diagram Editor](https://mintlify.wiki/wokwi/wokwi-docs/guides/diagram-editor.md): Use the Wokwi Diagram Editor to visually build and edit circuit simulations. Add components, wire connections, rotate, duplicate, and manage parts with intuitive keyboard shortcuts.
- [Editor Keyboard Shortcuts](https://mintlify.wiki/wokwi/wokwi-docs/guides/keyboard-shortcuts.md): Master Wokwi's keyboard shortcuts for simulation, code editing, and power editing operations.
- [Interactive Debugger](https://mintlify.wiki/wokwi/wokwi-docs/guides/debugger.md): Use Wokwi's built-in interactive debugger to step through code, set breakpoints, inspect variables, and explore call stacks.
- [GDB Debugging (Advanced)](https://mintlify.wiki/wokwi/wokwi-docs/guides/gdb-debugging.md): Use GDB to debug Arduino and Raspberry Pi Pico code directly in the Wokwi simulator. Launch web-based GDB sessions, step through code, set breakpoints and inspect variables.
- [The Serial Monitor](https://mintlify.wiki/wokwi/wokwi-docs/guides/serial-monitor.md): Interact with the serial interface of the Wokwi simulation to view output or send data.
- [Logic Analyzer Guide](https://mintlify.wiki/wokwi/wokwi-docs/guides/logic-analyzer.md): Use the Wokwi Logic Analyzer to debug and visualize digital signals, record VCD files, and analyze protocols using PulseView or GTKWave.
- [Arduino Libraries](https://mintlify.wiki/wokwi/wokwi-docs/guides/libraries.md): Add built-in, third-party, and custom Arduino libraries to your Wokwi projects using the Library Manager and the libraries.txt file.
- [MicroPython on Wokwi](https://mintlify.wiki/wokwi/wokwi-docs/guides/micropython.md): Create and run MicroPython projects in Wokwi using the Raspberry Pi Pico simulator.
- [CircuitPython on Wokwi](https://mintlify.wiki/wokwi/wokwi-docs/guides/circuitpython.md): Simulate CircuitPython on Wokwi using the Raspberry Pi Pico. This guide covers project setup, using Adafruit libraries, and exploring the CircuitPython REPL.
- [ESP32 Simulation](https://mintlify.wiki/wokwi/wokwi-docs/guides/esp32.md): Simulate ESP32, ESP32-C3, ESP32-S2, ESP32-S3, and other Espressif boards in Wokwi for IoT projects.
- [ESP32 WiFi Networking](https://mintlify.wiki/wokwi/wokwi-docs/guides/esp32-wifi.md): Simulate WiFi and internet access for ESP32 projects using Wokwi, including public/private gateways, HTTP/MQTT, and local networking.
- [Custom Chips as WASM](https://mintlify.wiki/wokwi/wokwi-docs/guides/custom-chips.md): Compile your custom chips to WASM for use with VS Code or the Wokwi CLI.
- [Getting Started with Wokwi for VS Code](https://mintlify.wiki/wokwi/wokwi-docs/vscode/getting-started.md): Simulate embedded and IoT projects directly inside Visual Studio Code using the Wokwi extension. Supports PlatformIO, ESP-IDF, Arduino, MicroPython, Rust, Zephyr and more.
- [Configuring Your Project (wokwi.toml)](https://mintlify.wiki/wokwi/wokwi-docs/vscode/project-config.md): Configure your project using wokwi.toml and diagram.json files, including firmware paths, serial forwarding, custom chips, and network settings.
- [Diagram Editor in VS Code](https://mintlify.wiki/wokwi/wokwi-docs/vscode/diagram-editor.md): Use the visual diagram editor in Wokwi for VS Code to open and edit diagrams, and run the simulation.
- [Debugging Your Code](https://mintlify.wiki/wokwi/wokwi-docs/vscode/debugging.md): Configure and use the VS Code debugger to debug code running in the Wokwi simulator, with support for AVR, ESP32, ESP-IDF, and PlatformIO projects.
- [Running Wokwi Offline](https://mintlify.wiki/wokwi/wokwi-docs/vscode/offline-mode.md): Running the simulation offline or in restricted network environments.
- [Tips and Tricks](https://mintlify.wiki/wokwi/wokwi-docs/vscode/tips-and-tricks.md): Useful tips for getting the most out of Wokwi for VS Code, including privacy mode for streaming.
- [Migrating Wokwi Projects to VS Code](https://mintlify.wiki/wokwi/wokwi-docs/vscode/migrating.md): Migrate your online Wokwi simulator projects to a local VS Code environment
- [MicroPython Projects in VS Code](https://mintlify.wiki/wokwi/wokwi-docs/vscode/micropython.md): Migrate or create MicroPython projects incorporating the Wokwi simulator in a local VS Code environment
- [Wokwi for CI and GitHub Actions](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/getting-started.md): Use Wokwi CI to automate embedded firmware testing in continuous integration workflows like GitHub Actions and GitLab CI. Learn about WITL (Wokwi in the Loop), automation scenarios, simulation limits, and integrating with AI agents using MCP.
- [Wokwi CLI Installation](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/cli-installation.md): Install the CLI to run and automate Wokwi simulations from your terminal.
- [Wokwi CLI Usage](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/cli-usage.md): Wokwi CLI command reference and usage guide.
- [ESP-IDF Simulation Extension Usage](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/idf-usage.md): idf-wokwi CLI command reference for ESP-IDF projects.
- [Using Wokwi in GitHub Actions](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/github-actions.md): Integrate Wokwi CI with GitHub Actions to automatically test your embedded firmware on every commit.
- [Wokwi Automation Scenarios](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/automation-scenarios.md): Automate simulations in Wokwi using YAML-based automation scenarios. Simulate button presses, sensor input, and verify serial output to test firmware programmatically.
- [Model Context Protocol (MCP) Support](https://mintlify.wiki/wokwi/wokwi-docs/wokwi-ci/mcp-support.md): Integrate AI agents like Copilot, Claude, Cursor, Gemini, and ChatGPT with Wokwi using the Model Context Protocol (MCP). This guide covers configuring the Wokwi MCP server, enabling real-time simulation, automated testing, and virtual hardware interaction.
- [diagram.json File Format](https://mintlify.wiki/wokwi/wokwi-docs/parts/diagram-format.md): Reference guide for the diagram.json file for Wokwi simulation projects. This file defines components, their attributes, layout positions, and the connections between them.
- [wokwi-arduino-uno](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-arduino-uno.md): Arduino Uno R3 board reference - the most popular Arduino board powered by the ATmega328p chip
- [wokwi-arduino-nano](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-arduino-nano.md): Arduino Nano board reference - similar to Arduino Uno but in a smaller form factor
- [wokwi-arduino-mega](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-arduino-mega.md): Arduino Mega 2560 board reference - powered by ATmega2560 with 54 digital pins and 16 analog inputs
- [wokwi-attiny85](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-attiny85.md): ATtiny85 microcontroller reference - a small 8-bit AVR chip with 8KB Flash and 512 bytes RAM
- [wokwi-pi-pico](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-pi-pico.md): Raspberry Pi Pico board reference - RP2040 microcontroller with dual-core ARM Cortex-M0+ processor
- [wokwi-franzininho](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-franzininho.md): Franzininho DIY board reference - a small ATtiny85-based development board popular in Brazil
- [board-franzininho-wifi](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-franzininho-wifi.md): Franzininho WiFi board reference - open source ESP32-S2 development board from Brazil
- [board-st-nucleo-c031c6](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-st-nucleo-c031c6.md): STM32 Nucleo-64 C031C6 board reference - ARM Cortex-M0+ with 32KB Flash and 12KB RAM
- [board-st-nucleo-l031k6](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-st-nucleo-l031k6.md): STM32 Nucleo-32 L031K6 board reference - ARM Cortex-M0+ with 32KB Flash, 8KB RAM, and 1KB EEPROM
- [board-stm32-bluepill](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-stm32-bluepill.md): STM32 Blue Pill board reference - ARM Cortex-M3 with 64KB Flash and 20KB RAM
- [7-Segment Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-7segment.md): Seven segment LED display with configurable digits and colors
- [TM1637 7-Segment Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-tm1637-7segment.md): Seven segment LED display module with TM1637 4-wire interface
- [LCD1602 Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-lcd1602.md): An LCD with 2 lines, 16 characters per line
- [LCD2004 Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-lcd2004.md): An LCD display with 4 lines, 20 characters per line
- [SSD1306 OLED Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-ssd1306.md): Monochrome 128x64 OLED display with I2C interface for Arduino and embedded projects
- [SSD1306 OLED Display (Deprecated)](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ssd1306.md): Monochrome 128x64 OLED display with I2C interface
- [Grove OLED Display (SH1107)](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-grove-oled-sh1107.md): Monochrome display with 128x128 resolution
- [ILI9341 TFT Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ili9341.md): Full color 240x320 2.8" LCD-TFT display with SPI interface
- [Nokia 5110 Screen](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-nokia-5110-screen.md): Graphic LCD screen with 84x48 pixel monochrome display
- [LED Matrix](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-led-matrix.md): WS2812 NeoPixel Compatible LED Matrix
- [MAX7219 LED Dot Matrix](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-max7219-matrix.md): 8x8 LED Dot Matrix with MAX7219 Controller
- [PAL TV Display](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-tv.md): Black and White analog PAL TV screen
- [LED](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-led.md): Standard 5mm LED with configurable color and brightness
- [RGB LED](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-rgb-led.md): 5mm Red, Green and Blue (RGB) LED
- [NeoPixel LED](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-neopixel.md): WS2812 NeoPixel Compatible Addressable LED
- [LED Strip](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-led-strip.md): WS2812 NeoPixel Compatible LED Strip
- [LED Ring](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-led-ring.md): WS2812 NeoPixel Compatible LED Ring
- [LED Bar Graph](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-led-bar-graph.md): 10-segment LED Bar Graph display
- [DHT22 Temperature & Humidity Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-dht22.md): Digital Humidity and Temperature sensor
- [DS18B20 Temperature Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ds18b20.md): Digital temperature sensor with 1-Wire interface
- [NTC Temperature Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ntc-temperature-sensor.md): Analog temperature sensor - NTC thermistor
- [BMP180 Barometric Pressure Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-bmp180.md): Barometric pressure and temperature sensor with I2C interface
- [MPU6050 6-Axis Accelerometer & Gyroscope](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-mpu6050.md): 3-axis accelerometer, 3-axis gyroscope and temperature sensor with I2C interface
- [HC-SR04 Ultrasonic Distance Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-hc-sr04.md): Ultrasonic distance sensor for measuring distances from 2cm to 400cm
- [Photoresistor (LDR) Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-photoresistor-sensor.md): Photoresistor (LDR) sensor module for measuring light intensity
- [PIR Motion Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-pir-motion-sensor.md): Passive Infrared (PIR) motion sensor
- [MQ2 Gas Sensor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-gas-sensor.md): MQ2 Gas Sensor module for detecting combustible gases
- [Pushbutton (12mm)](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-pushbutton.md): 12mm Tactile Switch Button - momentary push button
- [Pushbutton (6mm)](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-pushbutton-6mm.md): 6mm Tactile Switch Button - momentary push button
- [Slide Switch](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-slide-switch.md): Standard Single Pole Double Throw (SPDT) slide switch
- [DIP Switch (8-position)](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-dip-switch-8.md): Set of 8 electrical switches in a single package
- [Potentiometer](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-potentiometer.md): Knob-controlled variable resistor (linear potentiometer)
- [Slide Potentiometer](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-slide-potentiometer.md): Sliding variable resistor (linear potentiometer)
- [Analog Joystick](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-analog-joystick.md): Analog Joystick with two axes (horizontal/vertical) and integrated push button
- [4x4 Membrane Keypad](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-membrane-keypad.md): A standard 4x4 keypad - great for numeric input
- [KY-040 Rotary Encoder](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ky-040.md): KY-040 Rotary Encoder module with 20 steps per revolution
- [Infrared Remote Control](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ir-remote.md): 38KHz infrared remote with 20 function keys
- [Servo Motor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-servo.md): Standard Micro Servo Motor with 0-180 degree range of motion
- [Stepper Motor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-stepper-motor.md): Bipolar stepper motor with configurable size and gear ratio
- [Biaxial Stepper Motor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-biaxial-stepper.md): Concentric biaxial stepper motor containing two stepper motors in a single enclosure
- [A4988 Stepper Driver](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-a4988.md): A4988 Stepper Motor driver with microstepping support
- [Buzzer](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-buzzer.md): Piezoelectric buzzer for sound generation
- [DS1307 RTC Module](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ds1307.md): RTC (Real Time Clock) module with I2C interface and 56 bytes of NV SRAM
- [Relay Module](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-relay-module.md): Electrically operated switch with normally open and normally closed contacts
- [KS2E-M-DC5 Relay](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ks2e-m-dc5.md): Double Pole Double Throw (DPDT) Relay
- [MFRC522 RFID Reader](https://mintlify.wiki/wokwi/wokwi-docs/parts/board-mfrc522.md): RFID/NFC reader module with SPI interface for reading 13.56 MHz MIFARE cards and tags
- [HX711 Load Cell Amplifier](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-hx711.md): HX711 Load Cell Amplifier for reading load cells and strain gauges
- [74HC165 Shift Register](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-74hc165.md): 8-bit Parallel-In Serial-Out (PISO) Shift Register for expanding input pins
- [74HC595 Shift Register](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-74hc595.md): 8-bit Serial-In Parallel-Out (SIPO) Shift Register for expanding output pins
- [NLSF595 LED Driver](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-nlsf595.md): Serial (SPI) Tri-Color LED Driver for controlling RGB LEDs
- [microSD Card](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-microsd-card.md): microSD card with SPI interface and FAT16 filesystem support
- [IR Receiver](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-ir-receiver.md): 38KHz infrared receiver for receiving IR remote commands
- [Clock Generator](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-clock-generator.md): Configurable clock generator component for timing and clock signals
- [Resistor](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-resistor.md): Basic resistor component with configurable resistance value
- [Logic Analyzer](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-logic-analyzer.md): 8-Channel Digital Logic Analyzer for capturing and analyzing digital signals
- [Text Element](https://mintlify.wiki/wokwi/wokwi-docs/parts/wokwi-text.md): Simple text element for adding labels and annotations to your circuit
- [Getting Started with the Wokwi Custom Chips C API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/getting-started.md): Learn how to create custom simulation models and extend Wokwi functionality with the Chips API
- [Tutorial: 7-segment display](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/tutorial-7seg.md): Learn how to build a custom 7-segment display controller chip from scratch
- [Custom Chip JSON Format](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/chip-json.md): Define the pinout and properties of custom chips using the Chip Definition JSON format
- [GPIO pins API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/gpio.md): Control and monitor digital pins in your custom chips
- [Analog API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/analog.md): Read and write analog voltages on custom chip pins
- [Time simulation API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/time.md): Create and manage timers in your custom chips
- [UART API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/uart.md): Implement UART serial communication in custom chips
- [I2C Device API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/i2c.md): Create custom I2C peripheral devices for simulation
- [SPI Device API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/spi.md): Implement SPI peripheral devices in custom chips
- [Attributes](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/attributes.md): Define configurable parameters for custom chips that users can set in diagram.json
- [Framebuffer API](https://mintlify.wiki/wokwi/wokwi-docs/chips-api/framebuffer.md): Implement custom display chips with pixel-level control