# Linux
ls /dev/ttyUSB*
# Should show: /dev/ttyUSB0

# macOS
ls /dev/cu.usbserial* /dev/cu.usbmodem*
# CH340: /dev/cu.usbserial-14320
# Native: /dev/cu.usbmodem14201

# Windows
mode
# Should show: COM3, COM4, etc.

# Auto-configure
zeroclaw peripheral add arduino-uno /dev/ttyUSB0

# Or manually edit ~/.zeroclaw/config.toml

[peripherals]
enabled = true

[[peripherals.boards]]
board = "arduino-uno"
transport = "serial"
path = "/dev/ttyUSB0"  # Adjust for your system
baud = 115200

# Test built-in LED (pin 13)
zeroclaw agent -m "Turn on the LED on Arduino"

# Should light up the built-in LED (orange LED labeled 'L')

Digital Pins:
0  = RX (Serial, avoid using)
1  = TX (Serial, avoid using)
2-12 = General GPIO
13 = Built-in LED + GPIO

PWM Pins (~ marked on board):
3, 5, 6, 9, 10, 11

Analog Pins:
A0-A5 (can also be used as digital GPIO)

Arduino         LED
───────         ───
Pin 9 ────────┬──▶│
                │    └─── GND
                └─── 220Ω

zeroclaw agent -m "Set pin 9 high on Arduino"

Arduino         Button
───────         ──────
Pin 7 ─────────┤  ├──── 5V
GND ───────────┤  ├
                └──┘

zeroclaw agent -m "Read pin 7 on Arduino"

# Configure Uno Q bridge
zeroclaw peripheral setup-uno-q --host robot.local

# Add to config
zeroclaw peripheral add arduino-uno-q bridge

{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}

{"id":"1","ok":true,"result":"done"}

# Open serial monitor
screen /dev/ttyUSB0 115200

# Type commands and press Enter:
{"id":"1","cmd":"ping","args":{}}
{"id":"2","cmd":"gpio_write","args":{"pin":13,"value":1}}
{"id":"3","cmd":"gpio_read","args":{"pin":13}}
{"id":"4","cmd":"capabilities","args":{}}

# Exit: Ctrl+A, then K, then Y

if (hasCmd(line, "analog_read")) {
  int pin = parseArg("pin", line);
  if (pin < 0 || pin > 5) {
    Serial.println("{\"id\":\"1\",\"ok\":false,\"error\":\"Invalid analog pin\"}");
    return;
  }
  int value = analogRead(A0 + pin);
  Serial.print("{\"id\":\"");
  Serial.print(idBuf);
  Serial.print("\",\"ok\":true,\"result\":\"");
  Serial.print(value);
  Serial.println("\"}");
  return;
}

# Check USB connection
# Linux
lsusb | grep -i "CH340\|arduino"

# macOS
system_profiler SPUSBDataType | grep -i "arduino\|ch340"

# Windows
# Device Manager > Ports (COM & LPT)

# Add user to dialout group
sudo usermod -aG dialout $USER

# Logout and login, or:
newgrp dialout

# Check port is correct
ls /dev/ttyUSB*

# Try manual reset
# Press reset button on Arduino, then immediately:
zeroclaw peripheral flash --port /dev/ttyUSB0

# Check avrdude is installed
avrdude -v

# Ubuntu/Debian
sudo apt install avrdude

# macOS
brew install avrdude

# Reset Arduino
# Press reset button (small button near USB port)

# Check baud rate
# Must be 115200 (set in firmware setup())

# Test with Arduino IDE Serial Monitor
# Tools > Serial Monitor
# Set to 115200 baud
# Type: {"id":"1","cmd":"ping","args":{}}

# Download CH340 driver
# https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver

# Or use Homebrew
brew tap mengbo/ch340g-ch34g-ch34x-mac-os-x-driver
brew install ch340g-ch34g-ch34x-mac-os-x-driver

# Reboot after installation

# If using Arduino Nano, Mega, etc.
# Edit firmware/zeroclaw-arduino/zeroclaw-arduino.ino
# Adjust pin definitions for your board

# Or flash appropriate firmware for your board