Repository navigation
Arduino IDE Multi Platform Setup Guide
Setting up the Arduino IDE to be a universal workstation for multiple microcontroller families (Arduino, ESP32, STM32, and others) is a great move. This guide provides the initial configuration to turn your Arduino IDE into a multi-platform powerhouse.
One-time setup to turn a stock Arduino IDE 2.x install into a universal workstation covering Arduino, ESP32, ESP8266, STM32, and RP2040 (Pico) boards from a single install - the specific driver/board-package combination that trips people up on a fresh setup.
Six steps: install IDE 2.x (not legacy 1.8.x), add third-party board manager URLs, install the actual board packages those URLs unlock, tune compiler/upload preferences for easier debugging, install cross-platform sensor/communication libraries, and install the USB-to-serial drivers (CH340/CP210x) that clone and third-party boards need but official Arduino boards don't.
Eliminate the most common first-time failure mode with multi-board Arduino IDE setups - a board not showing up in the ports list because of a missing USB driver, or a board not appearing in the boards list because its package URL was never added.
- Setting up a new machine for embedded/hardware hacking work spanning multiple microcontroller families
- Adding ESP32/STM32/RP2040 support to an existing Arduino-only IDE install
- Troubleshooting a board that won't show up in Tools > Board or Tools > Port (check Steps 2-3 and 6 respectively)
Step 1: Use Arduino IDE 2.x
If you haven't already, download the latest Arduino IDE 2.x (not the legacy 1.8.x version). Version 2 brings a modern code editor, auto-completion, faster compile times, and a much better board/library manager.
By default, the IDE only knows about official Arduino boards. To add ESP32, STM32, and other popular architectures, you need to point the IDE to their core files.
- Open the Arduino IDE.
- Go to File > Preferences (Windows/Linux) or Arduino > Settings (macOS).
- Look for the field labeled "Additional boards manager URLs".
- Click the small window icon next to the text box to open it in a larger list, and paste the following URLs (one on each line):
https://espressif.github.io/arduino-esp32/package_esp32_index.json
https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json
https://arduino.esp8266.com/stable/package_esp8266com_index.json
https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json
(Note: The ESP8266 and the Raspberry Pi RP2040/Pico URLs are included as well, since they are incredibly common in multi-board setups).
Now that the IDE knows where to look, you need to download the actual board packages.
- Click the Boards Manager icon on the left sidebar (it looks like an Arduino Uno board).
- Search for and install the following packages:
-
esp32by Espressif Systems -
STM32 MCU based boardsby STMicroelectronics -
esp8266by ESP8266 Community -
Raspberry Pi Pico/RP2040by Earle F. Philhower, III (Highly recommended over the official Arduino mbed core for Pico). -
Arduino AVR Boards(Usually installed by default, but good to verify for classic Unos/Nanos).
-
While you are in File > Preferences, tweak these settings for a much better developer experience:
- Show verbose output during: Check "compile" and "upload". This is crucial for troubleshooting when a board refuses to flash or code fails.
- Compiler warnings: Set this to "All" or "More". It helps catch sloppy code and memory leaks before they become runtime bugs.
- Display line numbers: Checked (Essential for debugging).
- Enable Code Folding: Checked (Helps navigate large files).
- Auto save: Checked (Saves you from losing work).
Click the Library Manager icon on the left sidebar (it looks like a stack of books) and install a few baseline libraries that are almost universally used across these platforms:
- Adafruit Unified Sensor: The backbone for almost all Adafruit sensor libraries.
- PubSubClient: The gold standard for MQTT/IoT projects (crucial for ESP32).
- U8g2 or Adafruit GFX: The best libraries for driving OLEDs and LCD screens across different architectures.
- ArduinoJson: Essential for parsing web data, configuration files, and APIs.
Because you are using third-party boards (especially ESP32s and cloned Arduinos), your computer might not recognize them out of the box. Ensure you have the following drivers installed on your operating system:
- CH340 / CH341: Extremely common on NodeMCU ESP32/ESP8266 boards and Arduino clones.
- CP210x (Silicon Labs): Common on higher-end ESP32 dev boards.
You are all set! Switching from programming a standard Arduino Uno to a dual-core Wi-Fi enabled ESP32 or a powerful STM32 is now as simple as selecting a different board from the dropdown menu at the top of the IDE.
- README.md - Documentation section index: all guides and cheat sheets in this directory
- vscode.md - VS Code + PlatformIO: a modern alternative to Arduino IDE with project-level board config
- evil_m5.md - Evil-M5Project firmware built with Arduino IDE targeting the M5Cardputer (ESP32-S3)
- bruce_firmware.md - Bruce firmware for ESP32 boards; same Arduino IDE + ESP32 board core workflow
- flipper_zero_guide.md - Flipper Zero ESP32 Wi-Fi Marauder co-processor setup uses Arduino IDE for ESP32 firmware flashing
- ../HardwareHacking/Chapter1.md - Hardware hacking fundamentals that Arduino IDE supports (serial, I2C, SPI)
๐ Source: Documentation/arduinoIDE.md | โ๏ธ Suggest an edit | โฌ
๏ธ Back to Technical Guides & Cheat Sheets
- ๐บ๏ธ Browse by Topic
- ๐ All Repository Files
- ๐งญ Learning Paths
- ๐ Master Guide
- ๐ค Glossary
- โ๏ธ Legal & Disclaimer
๐ Foundations & Learning
๐ก๏ธ Defense & Investigations
- Incident Response
- Open Source Intelligence (OSINT)
- Reverse Engineering
- Operations Security (OPSEC)
- Compliance
โ๏ธ Platforms & Infrastructure
๐ก Hardware, Wireless & Field Projects
- PNWC Cyberdeck
- Hardware Testing
- Hardware Hacking
- Software-Defined Radio
- Wardriving
- uConsole
- Space Security
๐งฐ Assessment & Field Reference
๐ฆ Downloads & Project Resources
๐๏ธ Additional Topics