Troubleshooting¶
Something is not working. Find the stage you are stuck at, then open that page.
| Stage | You are here when | Page |
|---|---|---|
| Setting up | Installing MARLIN, or getting the Controller and robot brain connected. Nothing has run yet. | Problems setting up MARLIN |
| Starting a program | You pressed a phase button. Either nothing launched, or the program failed before your code took over. | Problems starting your program |
| Running | The program started. Something goes wrong while it is running: an error, a stopped robot, or bad data. | Problems while the program runs |
Find your error message¶
| Message or symptom | Page |
|---|---|
'python' is not recognized / the Microsoft Store opens |
Setting up |
| No marlin icon in the VS Code sidebar | Setting up |
| A message about the Python version | Setting up |
No module named 'marlin' |
Setting up |
Extension not reachable at tcp://127.0.0.1:5172 |
Setting up |
| The Controller is not in the port dropdown | Setting up |
| Several ports listed, and you do not know which is the Controller | Setting up |
| Connect succeeds but the Controller never responds | Setting up |
| The robot brain is not in the Rescan list | Setting up |
| Repeated pool server connection errors | Setting up |
| Nothing happens, or a toast error, when starting a phase | Starting |
[OUT] [API] ... run() was not given ... |
Starting |
| The robot will not enter a phase | Starting |
SyntaxError, IndentationError, or another traceback |
Starting |
| Your edits seem to have no effect | Starting |
Configuration mismatch RuntimeError |
Starting |
| A port key or hardware type is rejected | Starting |
Timed out waiting for the robot to confirm its configuration. |
Starting |
LinkError from robot.run() |
Starting |
| The robot moves once, then sits still | Running |
Something set in initialize() never happens |
Running |
Something set up in initialize() never happens |
Running |
robot.overtemp or robot.estopped is True |
Running |
KeyError, TypeError, AttributeError, or LookupError from an accessor |
Running |
ValueError from joystick() or button() |
Running |
| A thruster or servo will not go past a certain point | Running |
[OUT] [API] ... is not a usable number |
Running |
| The robot creeps with the sticks released, or never reaches full speed | Running |
A sensor reading has ok == False, or link_ok is false |
Running |
If the problem is a mistake in how you wrote the program rather than an error message, Common mistakes covers the patterns learners hit most.