Documentation Index
Fetch the complete documentation index at: https://mintlify.com/yousifamanuel/clawd-mochi/llms.txt
Use this file to discover all available pages before exploring further.
Open the sketch
Open
clawd_mochi.ino in Arduino IDE. This is the single .ino file at the root of the repository.Select the port
Go to Tools → Port and select the port for your device — for example,
/dev/ttyUSB0 on Linux or COM3 on Windows.The firmware is a single
.ino file (clawd_mochi.ino) by design — this makes it easy for beginners to read, modify, and flash without navigating multiple files.Boot sequence
When the firmware starts for the first time, it runs through the following sequence:- Boot splash — displays “Clawd Mochi” text on an orange background for ~1.2 seconds
- Logo reveal — plays the Clawd crab animation, drawn stroke by stroke
- WiFi info screen — shows the network credentials and URL to connect:
- SSID:
ClaWD-Mochi - Password:
clawd1234 - URL:
192.168.4.1
- SSID:
- Waiting — stays on the WiFi info screen until you make your first web request
Troubleshooting
Upload fails: port not found
Upload fails: port not found
- Check that your USB cable supports data transfer — some cables are charge-only
- Try a different USB port on your computer
- Check that the correct port is selected under Tools → Port
Upload fails: timeout
Upload fails: timeout
Ensure USB CDC On Boot is set to Enabled in your board settings. See software setup for instructions.
Display shows nothing
Display shows nothing
- Verify VCC is connected to 3.3V — never 5V
- Check all 8 wires are seated correctly
- Double-check that your GPIO assignments match the wiring table
Display is upside down or mirrored
Display is upside down or mirrored
The firmware sets
tft.setRotation(1), which is correct for the standard mounting orientation. If your display looks wrong, verify you have not modified this line in clawd_mochi.ino.