If you got problems with your hardware platform we first recommend to read our troubleshooting guide. Here are some hardware platform specific steps:
If you got problems with your platform try to enable
debug first. As
described in the
general debugging section of our
troubleshooting guide this is done by adding
debug: true to your
This will add a lot more debugging and might slow down MPF a bit. We recommend to disable/remove it after finishing debugging.
Your display is not showing your slides? Check if your brightness is set
high enough. You can adjust brightness in your
default: # your DMD
brightness: .8 # adjust the brightness of your display if it is too bright or dim
Your hardware is not working at all
If your hardware is not working at all make sure that you removed the
--vpx from your
mpf both or
command line. Those options will overwrite the settings in your
hardware section and MPF will not even try to connect to your
hardware. If you got config errors we suggest you add
-X to figure
things out without interfacing real hardware all the time. Just keep
that option in mind.
Another stupid thing to check: Is your hardware connected to your PC? We know it is stupid but a loose USB connector has happened to most of us.
On Linux you might want to run the command
lsusb which should show
both of your micro controllers connected. You should see two lines
Bus 002 Device 014: ID 0483:5740 STMicroelectronics Virtual COM Port
Bus 002 Device 015: ID 0483:5740 STMicroelectronics Virtual COM Port
If you are unsure about the output, run the command once with your controllers connected and once without. If there is no difference, then for sure the USB device is not properly connected.
Add debugging to related devices
If you got problems with some switches also add
debug: true to those
as it will give to more insights into the intentions of those devices.
Same will work for flippers, coils, lights, servos, steppers and more.
general debugging section for details.
Run MPF with verbose flag
general debugging section for details. TLDR: run
mpf both -t -v -V.
Report Your Issue and Ask For Help
If you cannot find the issue yourself please prepare some information about your issue according to our troubleshooting guide and ask in our forum.
Consider Improving the Documentation
Did you solve your issue but found that some relevant information in the documentation is missing or should be linked/located elsewhere? Either tell us in the forum or consider improving the documentation yourself to save future users some troubles the same way others saved you some troubles by writing this documentation.
Something missing or wrong? You can fix it!
This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?
Please help us! You can fix it yourself and be an official "open source" contributor!
It's easy! See our Beginner's guide to editing the docs.
Page navigation via the keyboard: < >
You can navigate this site via the keyboard. There are two modes:
General navigation, when search is not focused:
- F , S , / : open search dialog
- P , , : go to previous page
- N , . : go to next page
While using the search function:
- Down , Up : select next / previous result
- Esc , Tab : close search
- Enter : go to highlighted page in the results