Difference between revisions of "Troubleshooting Reinstall Duo"

From MOD Wiki
Jump to navigation Jump to search
(duo with mainline)
Line 4: Line 4:
 
Troubleshooting section dedicated to the MOD Duo.
 
Troubleshooting section dedicated to the MOD Duo.
  
−
== A note on different models ==
+
== A note on different models and old kernel ==
  
 
Please note that there are 2 different kinds of MOD Duo units - older ones with nand flash and newer ones with eMMC.<br/>
 
Please note that there are 2 different kinds of MOD Duo units - older ones with nand flash and newer ones with eMMC.<br/>
−
The new unit models have their name (like "MOD Duo") written and engraved above the right display.<br/>
+
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 re-installation/reset procedure is not the same for each one.<br/>
 
  
−
'''For older Duo models:'''<br/>
+
Since version 1.10, we changed the kernel used by the Duo, but this update only automatically applies to new unit models.<br/>
−
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/>
+
For the older models, we need to either do a special update step, or a full factory reset.<br/>
−
This is the best option, if it works. (and applies to your unit, of course)<br/>
+
In both cases the disk contents (user data) is completely wiped out.
−
If that does not work, you can perform a factory reset, which will erase all your data.
 
  
−
'''For all Duo models:'''<br/>
+
You can check which kernel version you are running by looking at the "System information" in the advanced settings.<br/>
−
You can reinstalling the OS over USB, optionally formatting/reset the user data partition as well.<br/>
+
Kernel release <b>5.4.38-rt21-modduo</b> is the newer one, while <b>3.4.104-rt139-modduo</b> is the older one.<br/>
−
This method only works on Linux at the moment.
+
The new kernel offers better performance and reliability, so you are still using the old one please update!
  
−
== Reinstall bootloader ==
+
== Special update for nand units ==
 
'''NOTE: Only for older MOD Duo units with nand flash'''
 
'''NOTE: Only for older MOD Duo units with nand flash'''
  
−
Requirements: Linux or macOS, basic command-line knowledge<br>
+
In order to make older MOD Duo units switch to the new kernel we can use a special update file.<br/>
 +
This was created mainly for those users who are using Windows or are not comfortable with the command-line.
 +
 
 +
''Please do not power off your unit once the procedure has started!''
  
 
To begin:
 
To begin:
−
# Click and hold down the FEL button on the back of the MOD Duo (in tiny hole), while you power it on.
+
# Put the unit into recovery mode. See [[Releases#Releases]] if you need help on that.
−
# Hold it for 2 seconds, then release (The screens will freeze with the MOD logo and name)
+
# Download this special update file [http://download.moddevices.com/releases/modduo/tools/modduo-convert-nand_20200529.tar modduo-convert-nand_20200529.tar]
−
# Connect the MOD Duo to your computer via USB cable
+
# Install the tar file in the previous step, and wait until the unit boots itself again in restore mode
−
# Download https://github.com/moddevices/CT_NandBoot/archive/master.zip and extract it
+
# Install a factory restore image from the [[Factory Reset Images]] section.
−
# 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 ==
 
== MOD Duo Factory Reset ==
Line 54: Line 41:
 
# Hold it for 2 seconds, then release (The screens will freeze with the MOD logo and name)
 
# 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
 
# 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 this file: http://download.moddevices.com/releases/modduo/tools/duo-nand-mainline-factory-reset.tar.gz and extract it
−
# Download https://github.com/moddevices/CT_NandBoot/archive/master.zip and extract it
+
# Open a terminal and 'cd' to the directory where duo-nand-mainline-factory-reset.tar.gz was extracted, ie:
−
# Open a terminal and 'cd' to the directory where master.zip was extracted, ie:
+
<code language="console">cd ~/Downloads/duo-nand-mainline-factory-reset</code>
−
<code language="console">cd ~/Downloads/CT_NandBoot-master/</code>
 
  
−
If you're running '''macOS''', run:<br/>
+
Now simply run:<br/>
−
<code language="console">./bootfix.osx -w ~/Downloads/modduo-latest-reset-image.raw</code><br/>
+
<code language="console">./boot-fel-factory-restore.sh</code><br/>
−
(adjust the path to 'modduo-latest-reset-image.raw' as needed)
+
(sudo will likely be needed here)
−
 
 
−
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/>
+
For non-64bit Linux or macOS systems, use the sunxi-fel binary from your distribution.
−
''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.
+
# After the script finishes, wait for around 1 minute and the MOD Duo will boot into recovery mode.
−
# Install a MOD OS release as usual.
+
# Install a MOD OS factory reset image.
 +
# Wait for the installation to complete (the unit will restart automatically).
  
−
Note: You can find all MOD OS software releases in the [[Releases]] section.
+
Note: You can find all MOD factory reset images in the [[Factory Reset Images]] section.

Revision as of 08:17, 29 May 2020

Location of the FEL button on the MOD Duo
Different MOD Duo models
LEFT: older model with nand flash; RIGHT: newer model with eMMC

Troubleshooting section dedicated to the MOD Duo.

A note on different models and old kernel

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.

Since version 1.10, we changed the kernel used by the Duo, but this update only automatically applies to new unit models.
For the older models, we need to either do a special update step, or a full factory reset.
In both cases the disk contents (user data) is completely wiped out.

You can check which kernel version you are running by looking at the "System information" in the advanced settings.
Kernel release 5.4.38-rt21-modduo is the newer one, while 3.4.104-rt139-modduo is the older one.
The new kernel offers better performance and reliability, so you are still using the old one please update!

Special update for nand units

NOTE: Only for older MOD Duo units with nand flash

In order to make older MOD Duo units switch to the new kernel we can use a special update file.
This was created mainly for those users who are using Windows or are not comfortable with the command-line.

Please do not power off your unit once the procedure has started!

To begin:

  1. Put the unit into recovery mode. See Releases#Releases if you need help on that.
  2. Download this special update file modduo-convert-nand_20200529.tar
  3. Install the tar file in the previous step, and wait until the unit boots itself again in restore mode
  4. Install a factory restore image from the Factory Reset Images section.

MOD Duo Factory Reset

NOTE: Only for older MOD Duo units with nand flash

Requirements: Linux or macOS, basic command-line knowledge
For a factory reset under Windows, see Troubleshooting_Reinstall_via_LiveSuit. (applies only to older MOD Duo units with nand flash)

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 (The screens will freeze with the MOD logo and name)
  3. Connect the MOD Duo to your computer via USB cable
  4. Download this file: http://download.moddevices.com/releases/modduo/tools/duo-nand-mainline-factory-reset.tar.gz and extract it
  5. Open a terminal and 'cd' to the directory where duo-nand-mainline-factory-reset.tar.gz was extracted, ie:

cd ~/Downloads/duo-nand-mainline-factory-reset

Now simply run:
./boot-fel-factory-restore.sh
(sudo will likely be needed here)

For non-64bit Linux or macOS systems, use the sunxi-fel binary from your distribution.

  1. After the script finishes, wait for around 1 minute and the MOD Duo will boot into recovery mode.
  2. Install a MOD OS factory reset image.
  3. Wait for the installation to complete (the unit will restart automatically).

Note: You can find all MOD factory reset images in the Factory Reset Images section.

Retrieved from "http://wiki.mod.audio/index.php?title=Troubleshooting_Reinstall_Duo&oldid=12029"