Difference between revisions of "Troubleshooting"

From MOD Wiki
Jump to navigation Jump to search
 
(71 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Windows doesn’t recognize MOD as you plug it ==
+
== Windows doesn’t recognise MOD as you plug it ==
  
=== Windows 7 or Windows 10 64-bit ===
+
In order to be properly recognised by Windows computers, your MOD device needs to have its USB-B mode set correctly in the [[Dwarf_Device_Settings#USB-B_Mode|Device Settings]].
  
1. Make Windows look for drivers, and when given the option select "Browse my computer for driver software"
+
Certain Windows systems don't recognise the MOD as a network device or fail to find the correct driver.<br/>
<br clear=all>
+
Use this driver for such cases: https://download.mod.audio/shared/mod-rndis-driver-windows.zip
[[File:Win7-usb-1.png]]
 
  
2. Click 'Pick from a list of devices in my computer'
+
For more information and to learn how to install the driver visit [[Troubleshooting_Windows_Connection|Troubleshooting Windows Connection]].
<br clear=all>
 
[[File:Win7-usb-2.png]]
 
  
3. Select 'Network Adapters' and press 'Next'
+
== Can't connect to the Web GUI (HTTPS warning) ==
<br clear=all>
 
[[File:Win7-usb-3.png]]
 
  
4. Select 'Microsoft Corporation'
+
When you are connecting to the MOD device for the first time through a web browser, the browser might try to use an HTTPS connection.<br/>
<br clear=all>
+
The connection to the device is a local one (which means that doesn't require an internet connection to access), thus the communication cannot be encrypted through the usual means.<br/>
[[File:Win7-usb-4.png]]
+
Basically, HTTPS will not work and this is completely expected.
  
5. Select 'Remote NDIS Compatible device' and press 'Next'
+
So if/when the web browser complains about the connection being non-secure, this is normal and expected.
<br clear=all>
 
[[File:Win7-usb-5.png]]
 
  
=== Windows 10 (32-bit) ===
+
== Can't connect to the Web GUI in macOS ==
  
If using the 32bit version of Windows 10, the 'Microsoft Corporation' does not appear as an option when browsing for drivers.<br/>
+
If you are not able to connect to your MOD device using macOS, please make sure that your computer didn't enter sleep mode while you had your MOD device connected via USB.<br>
In this case we need to download and install a custom driver.
+
Learn more on [[Troubleshooting#Device_loses_USB_connection_when_computer_enters_sleep_mode|Device loses USB connection when computer enters sleep mode]].
  
1. Download http://web1.moddevices.com/shared/mod-duo-ethernet.zip, and extract the contents
+
Otherwise, please check [[Troubleshooting Mac OS Network]]
2. Make Windows look for drivers, and when given the option select "Browse my computer for driver software"
 
<br clear=all>
 
[[File:Win10-usb-1.png]]
 
  
3. Click 'Pick from a list of devices in my computer'
+
== MOD does not boot, stuck on 'MOD Dwarf' screen ==
<br clear=all>
 
[[File:Win10-usb-2.png]]
 
  
4. Click the 'Have Disk...' button
+
If the unit becomes unbootable for some reason, we might need to reinstall the OS inside.<br/>
<br clear=all>
+
We can boot the unit in recovery mode for safe reinstall, boot over USB if recovery partition is broken, or perform a full factory reset (which will erase all your data).
[[File:Win10-usb-3.png]]
 
  
5. Click the 'Browse' button
+
For more information see [[Troubleshooting_Reinstall|Troubleshooting Reinstall]].
<br clear=all>
 
[[File:Win10-usb-4.png]]
 
  
6. Navigate to where you extracted the file you downloaded before, and make it open the 'mod-duo-ethernet' file
+
Note that the MOD Dwarf is not software brickable, you can always reinstall its OS.
<br clear=all>
 
[[File:Win10-usb-5.png]]
 
  
7. Click 'OK'
+
== MOD produces a lot of noise when plugged in my current setup (Ground Loop) ==
<br clear=all>
 
[[File:Win10-usb-6.png]]
 
  
8. You should now see 'MOD Duo Ethernet' listed. Select it and press 'Next'
+
If you use other equipment along with your MOD and it starts producing loud noises when plugged in, you might be experiencing a Ground Loop. This could be other pedals, an amplifier, or even your computer.
<br clear=all>
 
[[File:Win10-usb-7.png]]
 
  
 +
In short, ground loops may occur when you have multiple audio equipments grounded to different power sources but connected between each other. This situation can happen with MOD Duo X because it is a device that is actually referenced to earth.
 +
 +
To check if that is the case, try to isolate the power of your MOD device and see if it changes your results. One thing that helps is to make sure your MOD device and all other equipment are connected to the same power socket. 
 +
 +
Another way these ground loops can occur is by connecting to a PC or laptop which has a really bad power supply, so try disconnecting it from the PC.
 +
 +
References on Ground Loops:
 +
* [https://en.wikipedia.org/wiki/Ground_loop_(electricity) Wikipedia]
 +
* [https://www.youtube.com/watch?v=4YM1iwC6vhg Video Understanding Ground  Loops]
 +
 +
== Failed to connect to MOD Cloud ==
 +
 +
If you see the "Failed to connect to MOD Cloud" message, you should try the following:
 +
 +
* First of all, double-check your internet connection
 +
* There have been reports of some browser extensions that might prevent the MOD Web GUI to connect to the cloud. Try deactivating some extensions. One extension reported was the "Firefox Privacy Badger". Do you know any other extension that is causing issues? Please share with us!
  
 
== Using Firefox and 'noscript' add-on prevents loading of cloud pedalboards ==
 
== Using Firefox and 'noscript' add-on prevents loading of cloud pedalboards ==
Line 62: Line 57:
 
Open noscript preferences, then go to the advanced tab, then 'ABE'.
 
Open noscript preferences, then go to the advanced tab, then 'ABE'.
 
The system ruleset should look like this:
 
The system ruleset should look like this:
<source>
+
<pre>
 
# Prevent Internet sites from requesting LAN resources.
 
# Prevent Internet sites from requesting LAN resources.
 
Site LOCAL
 
Site LOCAL
Line 68: Line 63:
 
Accept from http://integrate.moddevices.com/
 
Accept from http://integrate.moddevices.com/
 
Deny
 
Deny
</source>
+
</pre>
  
 
Note the new 'Accept from ...' rule.
 
Note the new 'Accept from ...' rule.
 
This makes noscript accept requests from cloud pedalboards into the local network.
 
This makes noscript accept requests from cloud pedalboards into the local network.
 +
 +
== Dealing with noise issues ==
 +
It is common nowadays in modern music setups to have noise issues that require some thought and experience to sort out.
 +
 +
If you are experiencing noise issues on your setup we recommend you to check the following aspects on your setup:
 +
* Gain staging: check the gain levels both on the input and on the output of all of the devices in your setup;
 +
* Pedalboard: check the effects on your pedalboard (both virtual inside your MOD Device or other physical devices in your setup) and pay attention for potential sources of noise;
 +
* Ground loop: check for potential ground loop issues in your setup. Multiple grounded devices in your setup may generate noise issues.
 +
 +
For more detailed explanations and info, please check the "[[Dealing with noise issues]]" page.
 +
 +
== Device loses USB connection when computer enters sleep mode ==
 +
If your computer enters sleep mode while your MOD device is connected to it, you may lose the USB connection to that machine. As a consequence, you stop being able to access the WebGUI.
 +
 +
The cause for this behavior is the "USB selective suspend" feature of your computer.
 +
 +
In order to solve it, there are three options:
 +
* After the computer wakes up from sleep mode, unplug and replug the USB cable between the MOD device and the computer. This will re-establish the USB connection;
 +
* Set up the computer so that it doesn't automatically enter sleep mode. For users with Apple products: this is the solution that Apple officially recommends on their forums.
 +
* Depending on the OS of your computer, you can disable the "USB selective suspend" feature for individual USB ports in system settings. However, if you are using an external USB hub (for example, if there is only USB-C and you need to use an external hub), you very likely can't make use of this feature.
 +
 +
== Issues updating the MOD Footswitch ==
 +
If you are having problems updating the firmware of your MOD Footswitch via WebGUI, please try to follow the manual steps described [[Control_Chain_Releases#Manual_update|here]]. <br/>
 +
If it still doesn't work for you please write us at [mailto:support@mod.audio support@mod.audio].

Latest revision as of 17:29, 7 August 2024

Windows doesn’t recognise MOD as you plug it

In order to be properly recognised by Windows computers, your MOD device needs to have its USB-B mode set correctly in the Device Settings.

Certain Windows systems don't recognise the MOD as a network device or fail to find the correct driver.
Use this driver for such cases: https://download.mod.audio/shared/mod-rndis-driver-windows.zip

For more information and to learn how to install the driver visit Troubleshooting Windows Connection.

Can't connect to the Web GUI (HTTPS warning)

When you are connecting to the MOD device for the first time through a web browser, the browser might try to use an HTTPS connection.
The connection to the device is a local one (which means that doesn't require an internet connection to access), thus the communication cannot be encrypted through the usual means.
Basically, HTTPS will not work and this is completely expected.

So if/when the web browser complains about the connection being non-secure, this is normal and expected.

Can't connect to the Web GUI in macOS

If you are not able to connect to your MOD device using macOS, please make sure that your computer didn't enter sleep mode while you had your MOD device connected via USB.
Learn more on Device loses USB connection when computer enters sleep mode.

Otherwise, please check Troubleshooting Mac OS Network

MOD does not boot, stuck on 'MOD Dwarf' screen

If the unit becomes unbootable for some reason, we might need to reinstall the OS inside.
We can boot the unit in recovery mode for safe reinstall, boot over USB if recovery partition is broken, or perform a full factory reset (which will erase all your data).

For more information see Troubleshooting Reinstall.

Note that the MOD Dwarf is not software brickable, you can always reinstall its OS.

MOD produces a lot of noise when plugged in my current setup (Ground Loop)

If you use other equipment along with your MOD and it starts producing loud noises when plugged in, you might be experiencing a Ground Loop. This could be other pedals, an amplifier, or even your computer.

In short, ground loops may occur when you have multiple audio equipments grounded to different power sources but connected between each other. This situation can happen with MOD Duo X because it is a device that is actually referenced to earth.

To check if that is the case, try to isolate the power of your MOD device and see if it changes your results. One thing that helps is to make sure your MOD device and all other equipment are connected to the same power socket.

Another way these ground loops can occur is by connecting to a PC or laptop which has a really bad power supply, so try disconnecting it from the PC.

References on Ground Loops:

Failed to connect to MOD Cloud

If you see the "Failed to connect to MOD Cloud" message, you should try the following:

  • First of all, double-check your internet connection
  • There have been reports of some browser extensions that might prevent the MOD Web GUI to connect to the cloud. Try deactivating some extensions. One extension reported was the "Firefox Privacy Badger". Do you know any other extension that is causing issues? Please share with us!

Using Firefox and 'noscript' add-on prevents loading of cloud pedalboards

Open noscript preferences, then go to the advanced tab, then 'ABE'. The system ruleset should look like this:

# Prevent Internet sites from requesting LAN resources.
Site LOCAL
Accept from LOCAL
Accept from http://integrate.moddevices.com/
Deny

Note the new 'Accept from ...' rule. This makes noscript accept requests from cloud pedalboards into the local network.

Dealing with noise issues

It is common nowadays in modern music setups to have noise issues that require some thought and experience to sort out.

If you are experiencing noise issues on your setup we recommend you to check the following aspects on your setup:

  • Gain staging: check the gain levels both on the input and on the output of all of the devices in your setup;
  • Pedalboard: check the effects on your pedalboard (both virtual inside your MOD Device or other physical devices in your setup) and pay attention for potential sources of noise;
  • Ground loop: check for potential ground loop issues in your setup. Multiple grounded devices in your setup may generate noise issues.

For more detailed explanations and info, please check the "Dealing with noise issues" page.

Device loses USB connection when computer enters sleep mode

If your computer enters sleep mode while your MOD device is connected to it, you may lose the USB connection to that machine. As a consequence, you stop being able to access the WebGUI.

The cause for this behavior is the "USB selective suspend" feature of your computer.

In order to solve it, there are three options:

  • After the computer wakes up from sleep mode, unplug and replug the USB cable between the MOD device and the computer. This will re-establish the USB connection;
  • Set up the computer so that it doesn't automatically enter sleep mode. For users with Apple products: this is the solution that Apple officially recommends on their forums.
  • Depending on the OS of your computer, you can disable the "USB selective suspend" feature for individual USB ports in system settings. However, if you are using an external USB hub (for example, if there is only USB-C and you need to use an external hub), you very likely can't make use of this feature.

Issues updating the MOD Footswitch

If you are having problems updating the firmware of your MOD Footswitch via WebGUI, please try to follow the manual steps described here.
If it still doesn't work for you please write us at support@mod.audio.