Troubleshooting Reinstall
MOD boots the main system, but screens do not work
If the MOD is able to boot (verified by still providing USB Ethernet device) but the screens do not seem to work properly, we can try to re-flash the "top-board"/screen controller unit.
This can happen, for example, if the MOD lost power during the last step of the update process.
This is fixable through SSH, you simply connect to 192.168.51.1 (user 'root' and password 'mod') and then run the following command:
hmi-update /usr/share/mod/controller/mod*controller.bin
Wait until you get confirmation of the flashing process being complete, and then turn off and on the unit.
MOD does not boot, or boots into recovery mode automatically
If the main MOD OS kernel becomes unbootable, the MOD will automatically boot into restore mode (used for performing OS updates).
You know the MOD is in restore mode if the inputs and output leds are blue and the display says "plugin USB cable to PC" or "copy file, eject and unplug".
If your unit seems unable to boot properly, we can force the unit to start in restore mode.
The method for manually starting recovery mode is:
- Turn off your MOD
- Hold the left knob and footswitch down (on the Duo X use the left endless-knob and the 1st button from the bottom-left)
- Turn on the MOD (while still holding the knob and footswitch down)
- Wait 5 seconds and let go of the knob and footswitch - the MOD is now booting into restore mode
- Connect the MOD to your PC (if not done yet) and wait for a new mass storage drive to appear
- Download the latest release from Releases
- Copy the mod*.tar file you just downloaded onto the new drive and use your OS option to safely remove the drive
- Disconnect the USB cable
Note: On some rare cases a MOD Duo might boot again in restore mode after this. If that happens please start over from step 1.
MOD does not boot at all, not even in restore mode
If for some reason your MOD device does not boot at all - not even in forced-restore mode - we need to reinstall the bootloader or perhaps the entire OS inside.
If you have a MOD Duo X unit that cannot boot normally or in forced-restore mode, please contact support@moddevices.com.
This part of the troubleshooting section does not apply to the MOD Duo X, as it does not have a FEL button and thus cannot be forced to boot custom payloads.
Please note that there are 2 different kinds of MOD Duo units - older ones with nand flash and newer ones with eMMC.
The new unit models have their name (like "MOD Duo") written and engraved above the right display.
Knowing which type of unit you have is important as the reinstallation/reset procedure is not the same for each one.
(MOD Duo X units are always of the newer eMMC type)
For older Duo models:
You can first try to reinstall the bootloader, which will keep all data intact, but if the issue is somewhere else the MOD will continue to not boot.
This is the best option, if it works. (and applies to your unit, of course)
If that does not work, you can perform a factory reset, which will erase all your data.
For all Duo models:
You can reinstalling the OS over USB, optionally formatting/reset the user data partition as well.
This method only works on Linux at the moment.
