Difference between revisions of "Troubleshooting Reinstall"

From MOD Wiki
Jump to navigation Jump to search
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[File:Duo-fel-button.jpg|450px|thumb|Location of the FEL button on the MOD Duo]]
+
General Troubleshooting section, divided by possible issues.
[[File:Duo-models.png|450px|thumb|Different MOD Duo models<br>LEFT: older model with nand flash; RIGHT: newer model with eMMC]]
 
  
 
== MOD boots the main system, but screens do not work ==
 
== MOD boots the main system, but screens do not work ==
Line 7: Line 6:
 
This can happen, for example, if the MOD lost power during the last step of the update process.
 
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:
+
This is fixable by reflashing the controller firmware, which can be done through the web interface or SSH.
 +
 
 +
=== reflashing controller via web interface ===
 +
 
 +
Open the [http://192.168.51.1/settings.html|web interface advanced settings] (accessible in the bottom-right corner of the regular web interface), then navigate to the "DANGEROUS" area.<br/>
 +
Simply follow the instructions for the "Reflash controller" section of the page.
 +
 
 +
[[File:Screenshot-advanced-settings-dangerous.png|thumb|Web interface advanced settings]]
 +
 
 +
=== reflashing controller via SSH ===
 +
 
 +
Connect to 192.168.51.1 via SSH (user 'root' and password 'mod') and then run the following command:
  
 
<code language="console">hmi-update /usr/share/mod/controller/mod*controller.bin</code>
 
<code language="console">hmi-update /usr/share/mod/controller/mod*controller.bin</code>
Line 13: Line 23:
 
Wait until you get confirmation of the flashing process being complete, and then turn off and on the unit.
 
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 ==
+
== MOD does not boot ==
  
If the main MOD OS kernel becomes unbootable, the MOD will automatically boot into restore mode (used for performing OS updates).<br>
+
If your unit seems unable to boot properly, we can force the unit to start in restore mode.<br>
 
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".
 
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.<br>
 
  
 
The method for manually starting recovery mode is:
 
The method for manually starting recovery mode is:
  
 
# Turn off your MOD
 
# 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)
+
# Hold the left knob and footswitch down (on the Dwarf and Duo X you can 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)
 
# 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
 
# Wait 5 seconds and let go of the knob and footswitch - the MOD is now booting into restore mode
Line 30: Line 38:
 
# Copy the mod*.tar file you just downloaded onto the new drive and use your OS option to safely remove the drive
 
# 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
 
# Disconnect the USB cable
 +
# Wait while the unit updates itself, it will reboot automatically when done
  
 
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.
 
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 ==
+
== MOD boots into recovery mode automatically ==
  
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.<br/>
+
If the main MOD OS kernel becomes unbootable, the MOD will automatically boot into restore mode (used for performing OS updates).<br>
If you have a MOD Duo X unit that cannot boot normally or in forced-restore mode, please contact [mailto:support@moddevices.com support@moddevices.com].<br/>
+
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".
'''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.<br/>
+
If this happens, we need to reinstall the latest release, which will allow the unit to boot normally again.<br>
The new unit models have their name (like "MOD Duo") written and engraved above the right display.<br/>
+
Simply allow the unit to boot into recovery mode, and then:
Knowing which type of unit you have is important as the reinstallation/reset procedure is not the same for each one.<br/>
 
(MOD Duo X units are always of the newer eMMC type)
 
  
'''For older Duo models:'''<br/>
+
# Connect the MOD to your PC (if not done yet) and wait for a new mass storage drive to appear
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.<br/>
+
# Download the latest release from [[Releases]]
This is the best option, if it works. (and applies to your unit, of course)<br/>
+
# Copy the mod*.tar file you just downloaded onto the new drive and use your OS option to safely remove the drive
If that does not work, you can perform a factory reset, which will erase all your data.
+
# Disconnect the USB cable
 +
# Wait while the unit updates itself, it will reboot automatically when done
  
'''For all Duo models:'''<br/>
+
== MOD does not boot at all, not even in restore mode ==
You can reinstalling the OS over USB, optionally formatting/reset the user data partition as well.<br/>
 
This method only works on Linux at the moment.
 
 
 
----
 
 
 
=== Reinstall bootloader ===
 
'''NOTE: Only for older MOD Duo units with nand flash'''
 
 
 
Requirements: Linux or macOS, basic command-line knowledge<br>
 
 
 
To begin:
 
# Click and hold down the FEL button on the back of the MOD Duo (in tiny hole), while you power it on.
 
# Hold it for 2 seconds, then release (The screens will freeze with the MOD logo and name)
 
# Connect the MOD Duo to your computer via USB cable
 
# Download https://github.com/moddevices/CT_NandBoot/archive/master.zip and extract it
 
# Open a terminal and 'cd' to the directory where master.zip was extracted, ie:
 
<code language="console">cd ~/Downloads/CT_NandBoot-master/</code>
 
 
 
If you're running '''macOS''', run:<br/>
 
<code language="console">./bootfix.osx</code><br/>
 
 
 
If you're running '''Linux''' 64bit, run:<br/>
 
<code language="console">./bootfix</code><br/>
 
(sudo will likely be needed here)
 
 
 
For non-64bit Linux systems, run 'make clean' and 'make' beforehand.
 
 
 
After the command finishes running, just power the MOD off and on again.<br/>
 
If it still doesn't boot after 2 minutes, a factory reset or OS reinstall via USB is needed.
 
 
 
----
 
 
 
=== MOD Duo Factory Reset ===
 
'''NOTE: Only for older MOD Duo units with nand flash'''
 
 
 
Requirements: Linux or macOS, basic command-line knowledge<br>
 
For a factory reset under Windows, see [[Troubleshooting_Reinstall_via_LiveSuit]]. (applies only to older MOD Duo units with nand flash)
 
 
 
To begin:
 
# Click and hold down the FEL button on the back of the MOD Duo (in tiny hole), while you power it on.
 
# Hold it for 2 seconds, then release (The screens will freeze with the MOD logo and name)
 
# Connect the MOD Duo to your computer via USB cable
 
# Download this file: http://download.moddevices.com/releases/modduo/reset/modduo-latest-reset-image.raw
 
# Download https://github.com/moddevices/CT_NandBoot/archive/master.zip and extract it
 
# Open a terminal and 'cd' to the directory where master.zip was extracted, ie:
 
<code language="console">cd ~/Downloads/CT_NandBoot-master/</code>
 
 
 
If you're running '''macOS''', run:<br/>
 
<code language="console">./bootfix.osx -w ~/Downloads/modduo-latest-reset-image.raw</code><br/>
 
(adjust the path to 'modduo-latest-reset-image.raw' as needed)
 
 
 
If you're running '''Linux''' 64bit, run:<br/>
 
<code language="console">./bootfix -w ~/Downloads/modduo-latest-reset-image.raw</code><br/>
 
(adjust the path to 'modduo-latest-reset-image.raw' as needed, sudo will likely be needed here)
 
 
 
For non-64bit Linux systems, run 'make clean' and 'make' beforehand.
 
 
 
Continuing:
 
# Wait until the 'bootfix' process finishes
 
# Power off and on the MOD Duo (by replugging the power cable)
 
# 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
 
# 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.<br/>
 
Power it off and on again one last time, and it will be good as new :)
 
 
 
If the LEDs are still blue for too long (actually they go to red and then return to blue) or the display shows the message "copy file, eject and unplug", please execute all this process again starting from the bootfix command.
 
 
 
----
 
 
 
=== Reinstall via USB boot ===
 
 
 
Requirements: Linux, basic command-line usage
 
 
 
To begin:
 
# Click and hold down the FEL button on the back of the MOD Duo (in tiny hole), while you power it on.
 
# Hold it for 2 seconds, then release (The screens will freeze with the MOD logo and name)
 
# Connect the MOD Duo to your computer via USB cable
 
# Download http://download.moddevices.com/releases/modduo/tools/mod-boot-fel-restore-v2.tar.gz and extract it
 
# Open a terminal and 'cd' to the directory where mod-boot-fel-restore.zip was extracted, ie:
 
<code language="console">cd ~/Downloads/mod-boot-fel-restore/</code>
 
 
 
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.<br/>
 
 
 
Continuing, we will run a command with different environment variables depending on the target unit.
 
 
 
For the new MOD Duo units with eMMC, run:<br/>
 
<code language="console">EMMC=1 ./boot-fel-restore.sh</code>
 
 
 
For non-kickstarter units, run:<br/>
 
<code language="console">MARS=1 ./boot-fel-restore.sh</code>
 
 
 
For kickstarter units, run:<br/>
 
<code language="console">./boot-fel-restore.sh</code>
 
 
 
''(NOTE: it might be possible that kickstarter units have the "MARS" model, and a non-kickstarter one not.''<br/>
 
''It is not possible to tell which kinda unit it is just by looking at it externally, so if the command with "MARS" does not work for you, try the one without and vice-versa.)''
 
  
# After the script finishes, wait for around 2 minutes and the MOD Duo will boot into recovery 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.
# Install a MOD OS release as usual.
 
  
Note: You can find all MOD OS software releases in the [[Releases]] section.
+
See the [[Troubleshooting Reinstall Dwarf]] page for how to reinstall the MOD OS in the Dwarf.<br/>
 +
See the [[Troubleshooting Reinstall Duo X]] page for how to reinstall the MOD OS in the Duo X.<br/>
 +
See the [[Troubleshooting Reinstall Duo]] page for how to reinstall the MOD OS in the Duo.

Latest revision as of 18:48, 26 February 2024

General Troubleshooting section, divided by possible issues.

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 by reflashing the controller firmware, which can be done through the web interface or SSH.

reflashing controller via web interface

Open the interface advanced settings (accessible in the bottom-right corner of the regular web interface), then navigate to the "DANGEROUS" area.
Simply follow the instructions for the "Reflash controller" section of the page.

Web interface advanced settings

reflashing controller via SSH

Connect to 192.168.51.1 via SSH (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

If your unit seems unable to boot properly, we can force the unit to start in restore mode.
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".

The method for manually starting recovery mode is:

  1. Turn off your MOD
  2. Hold the left knob and footswitch down (on the Dwarf and Duo X you can use the left endless-knob and the 1st button from the bottom-left)
  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
  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 mod*.tar file you just downloaded onto the new drive and use your OS option to safely remove the drive
  8. Disconnect the USB cable
  9. Wait while the unit updates itself, it will reboot automatically when done

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 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 this happens, we need to reinstall the latest release, which will allow the unit to boot normally again.
Simply allow the unit to boot into recovery mode, and then:

  1. Connect the MOD to your PC (if not done yet) and wait for a new mass storage drive to appear
  2. Download the latest release from Releases
  3. Copy the mod*.tar file you just downloaded onto the new drive and use your OS option to safely remove the drive
  4. Disconnect the USB cable
  5. Wait while the unit updates itself, it will reboot automatically when done

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.

See the Troubleshooting Reinstall Dwarf page for how to reinstall the MOD OS in the Dwarf.
See the Troubleshooting Reinstall Duo X page for how to reinstall the MOD OS in the Duo X.
See the Troubleshooting Reinstall Duo page for how to reinstall the MOD OS in the Duo.