01
Use Chrome or Edge
Web Serial is the browser feature that lets XOBIT install firmware and talk to the ESP32 over USB. Safari and Firefox do not provide the same setup path.
Absolute beginner path
First object walkthrough
This is the slow path from an empty board to a named, backed-up, scriptable XOBIT object. It assumes you have never used the project before.
1. Prepare
02
Use a data USB cable
Many USB cables only charge. If the board does not appear in the browser serial chooser, try another cable before changing anything else.
2. Install Firmware
03
Open the Install tab
Use Open Editor in the guide header, then choose Install. This is the clean path for putting XOBIT firmware on a fresh ESP32 Classic board.
04
Set install options only when needed
The default install is enough for most boards. Use the settings panel for a board name, WiFi details, clearing old data, or slow upload when USB is troublesome.
05
Install XOBIT firmware
Press Install XOBIT and wait until the progress bar finishes. Do not unplug while the upload is running.
3. Connect And Name The Board
06
Connect over USB
Use the connection button in Code to talk to the freshly installed board. Choose the USB device if the browser asks again.
07
Name the board
Open Settings > General and give the board a human name. This appears in the status bar and makes online links easier to recognize.
08
Add WiFi
Open Settings > WiFi, enter the network name and password, and save. WiFi makes online control possible, but does not by itself grant access.
09
Add an online user when needed
Open Settings > Users if you want MQTT control without USB. Fresh boards do not allow online control until you add a named user or explicitly enable a guest mode.
4. Upload A First Sketch
Start with a sketch that proves the compile/upload/log loop before adding LEDs or external parts.
10
Paste a small heartbeat sketch
This sketch proves that editing, uploading, and reading serial logs work before you add LEDs, relays, or external parts.
// Prints a heartbeat once per second.
var lastPrintAt = 0;
function setup() {
println("XOBIT ready");
}
function loop() {
if ((millis() - lastPrintAt) >= 1000) {
lastPrintAt = millis();
println("alive");
}
delay(10);
}
5. Save The Work
11
Keep projects, revisions, and backups
Each generated or uploaded change can become a revision. Use the project and revision menus to move through the work, then export the project JSON when you want a backup outside the browser.
12
Use Circuit to check the physical setup
Move to the physical object slowly. Add one part at a time, upload, test, then compare the generated circuit view with the wiring on the table.