Skip to content

Troubleshooting

Kristian Jörg edited this page Nov 23, 2025 · 5 revisions

First run verification

Make sure you have followed the guidelines of the First Run section.

Glitch alert!

Important

If the yoke has been set up and working and it then suddenly is making weird things like slamming full force into a physical endstop, becoming unresponsive or behaving with jerky motion when turning the wheel back and forth - then it is very likely you have a glitch in the wiring. Please solder all wire connections near moving parts. This includes

  • The left and right IR sensors on the bottom of the frame.
  • All connections to both of the AS5600 encoders. This is especially important! If encoder position is lost or misread then all forces will push in the wrong direction, usually into an endstop with great force. Even if the motor power is disengaged at the endstop sensor, the inertia will remain.

You can get away with not soldering these initially during testing, but please do not leave them as such. They will become loose over time. Hot glue to fix pin header connectors can also be used, but bear in mind that since the pin headers for these components need to be bent a bit extra to not run into moving parts, they lose a bit of "length" and the connector needs to be pushed in fully, but may lose contact later. Soldering solves all this. Sorry for the blurry image.

soldering wires

Beep codes

Look at the Beep Codes section for beep code explanations.

Serial debugging of calibration

If malfunction is detected, i.e we get a sad beep but cannot understand its cause, then activate the Serial Monitor in the IDE and run a manual calibration by pushing the calibration button. There will be a message displayed with further information, e.g "Motor inverted!" indicating a wiring error (switched cables), or "Timeout!" which indicates that calibration waited for the endpoint to be found but it never did. This can be caused by no motor power (24 V not connected), miswiring at the motor driver or that the IR sensor at that end is not working.

[!Note] The serial debug log from the full calibration run is different from SERIAL_DEBUG setting in define.h which disables motors and only output logging of encoder positions, IR sensors and yoke buttons. Check out the First Run section for more information on debugging.

Clone this wiki locally