Troubleshooting Reinstall

From MOD Wiki
Jump to navigation Jump to search
Location of the FEL button on the MOD Duo

MOD boots into restore mode by default

If the main MOD OS becomes unbootable for some reason, 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".

When this happens we need to force a new installation of the MOD OS.
We do this by starting the restore mode with a special "force install" flag.

The method for starting this special mode is:

  1. Turn off your MOD
  2. Hold the left knob and footswitch down
  3. Turn on the MOD (while still holding the knob and footswitch down)
  4. Wait 5 seconds and let go of the knob and footswitch
    The MOD is now booting into restore mode, but will allow the installation of any valid MOD release (including the same as already installed or downgrades).
  5. Connect the MOD to your PC (if not done yet) and wait for a new mass storage drive to appear
  6. Download the latest release from Releases
  7. Copy the modduo*.tar file onto the new drive and use your OS option to safely remove the drive
  8. Disconnect the USB cable

On some rare cases the MOD 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 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 OS inside.
You can perform a factory reset (which will erase all your data) or keep your data by reinstalling the system over USB.
The method for keeping user data only works on Linux at the moment.

Factory Reset

Requirements: Linux or macOS, basic command-line knowledge

To begin:

  1. Click and hold down the FEL button on the back of the MOD Duo (in tiny hole), while you power it on.
  2. Hold it for 2 seconds, then release
  3. Connect the MOD Duo to your computer via USB cable
  4. Download this file: http://download.moddevices.com/releases/modduo/reset/modduo-v1.3.2.362-reset-image.raw
  5. Download https://github.com/moddevices/CT_NandBoot/archive/master.zip and extract it
  6. Open a terminal and 'cd' to the directory where master.zip was extracted, ie:

cd ~/Downloads/CT_NandBoot-master/

If you're running macOS, run:
./bootfix.osx -w ~/Downloads/modduo-v1.3.2.362-reset-image.raw
(adjust the path to 'modduo-v1.3.1.351-reset-image.raw' as needed)

If you're running Linux 64bit, run:
./bootfix -w ~/Downloads/modduo-v1.3.2.362-reset-image.raw
(adjust the path to 'modduo-v1.3.1.351-reset-image.raw' as needed, sudo will likely be needed here)

For non-64bit Linux systems, run 'make clean' and 'make' beforehand.

Continuing:

  1. Wait until the 'bootfix' process finishes
  2. Power off and on the MOD Duo (by replugging the power cable)
  3. Wait until its LEDs turn blue, after around 30 seconds. If the LEDs don't light up after one minute, replug the power cable once again
  4. Wait until the LEDs turn red, then green. This should take around 10 minutes.

Once the LEDs are green, the MOD Duo has finished its factory reset.
Power it off and on again one last time, and it will be good as new :)


Reinstall via USB boot

Requirements: Linux, basic command-line usage

To begin:

  1. Click and hold down the FEL button on the back of the MOD Duo (in tiny hole), while you power it on.
  2. Hold it for 2 seconds, then release
  3. Connect the MOD Duo to your computer via USB cable
  4. Download http://download.moddevices.com/releases/modduo/reset/mod-boot-fel-restore.tar.gz and extract it
  5. Open a terminal and 'cd' to the directory where mod-boot-fel-restore.zip was extracted, ie:

cd ~/Downloads/mod-boot-fel-restore/

If not you're running 64bit, install sunxi-tools from your Linux distribution, and copy /usr/bin/sunxi-fel to the current directory, overriding the existing file there.

Continuing:

  1. Run: ./boot-fel-restore.sh
  2. Wait for around 2 minutes, and the MOD Duo will boot into recovery mode.
  3. Install a MOD OS release as usual.

Note: You can find all MOD OS software releases in the Releases section.