Usage
Troubleshooting
| Symptom | Fix |
|---|---|
Ultrasonic returns -1 / "sensor failing" | Reseat the 4-pin cable. TRIG → D2, ECHO → D3. Power red = 3V3/5V, black = GND. Test: python3 -c 'from picarx import Picarx; print(Picarx().ultrasonic.read())'. Intermittent bad reads under motor EMI are expected and tolerated since v3.9.5. |
| Turns are too slight | Default turn duration is 2.0 s (v3.9.4). Override per-call with duration, or increase the steering angle. |
GPIO busy on startup | The adapter releases all claims and retries Picarx(). If it persists: sudo killall python3 or reboot. |
A sudo prompt appears | The adapter pre-creates config and blocks runtime sudo. If a config dir exists but isn't writable, fix permissions per the setup guide. |
| LLM planner errors | Ensure ANTHROPIC_API_KEY is set and aether-robotics[full] (or anthropic) is installed. |
›
New to AETHER? Start with the docs for concepts, architecture, and the safety model.