Difference between revisions of "Troubleshooting"

From MOD Wiki
Jump to navigation Jump to search
 
(20 intermediate revisions by 4 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 ==
  
Certain Windows systems don't recognize the MOD as a network device or fail to find the correct driver.<br/>
+
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]].
Use this driver for such cases: https://modclouddownloadprod.blob.core.windows.net/shared/mod-rndis-driver-windows.zip
+
 
 +
Certain Windows systems don't recognise the MOD as a network device or fail to find the correct driver.<br/>
 +
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|Troubleshooting Windows Connection]].
 
For more information and to learn how to install the driver visit [[Troubleshooting_Windows_Connection|Troubleshooting Windows Connection]].
  
== Can't connect to the Web GUI in my Mac OS ==
+
== Can't connect to the Web GUI (HTTPS warning) ==
  
If you are not able to connect to your MOD device using Mac OS, please check [[Troubleshooting Mac OS Network]]
+
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/>
 +
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/>
 +
Basically, HTTPS will not work and this is completely expected.
  
== MOD does not boot, stuck on 'MOD Duo' screen ==
+
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.<br>
 +
Learn more on [[Troubleshooting#Device_loses_USB_connection_when_computer_enters_sleep_mode|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.<br/>
 
If the unit becomes unbootable for some reason, we might need to reinstall the OS inside.<br/>
Line 17: Line 30:
 
For more information see [[Troubleshooting_Reinstall|Troubleshooting Reinstall]].
 
For more information see [[Troubleshooting_Reinstall|Troubleshooting Reinstall]].
  
Note that the MOD Duo is not software brickable, you can always reinstall its OS.
+
Note that the MOD Dwarf is not software brickable, you can always reinstall its OS.
 
 
It is possible to make the MOD Duo X unbootable though, if the bootloader or restore partition are corrupted.<br/>
 
The only way that can happen is if you remove the power supply during the very small period of the software update when the bootloader and restore partition are replaced, or if you intentionally break them.<br/>
 
In such cases it is still possible to recover data, but one needs a imx8mq developer kit in order to boot a custom image/payload (which the MOD team has).
 
  
 
== MOD produces a lot of noise when plugged in my current setup (Ground Loop) ==
 
== MOD produces a lot of noise when plugged in my current setup (Ground Loop) ==
Line 36: Line 45:
 
* [https://en.wikipedia.org/wiki/Ground_loop_(electricity) Wikipedia]
 
* [https://en.wikipedia.org/wiki/Ground_loop_(electricity) Wikipedia]
 
* [https://www.youtube.com/watch?v=4YM1iwC6vhg Video Understanding Ground  Loops]
 
* [https://www.youtube.com/watch?v=4YM1iwC6vhg Video Understanding Ground  Loops]
 
== MOD Duo X screens freeze ==
 
 
If your Duo X unit's screen stops operating properly (basically frozen) after a few minutes of usage, please try disabling the audio peakmeter service (in the advanced settings of the web GUI).<br>
 
Use the advanced settings to trigger a power off of the unit, and then manual turn off and on the power again.<br>
 
If this indeed fixes the screen freeze issue, please contact support to get your unit replaced.
 
 
If the issue is not fixed, try enabling the workaround to automatically restart the screen (also in the advanced settings).<br>
 
Please post in our forums if you need to do this, so we can fix whatever causes it.
 
  
 
== Failed to connect to MOD Cloud ==
 
== Failed to connect to MOD Cloud ==
Line 71: Line 71:
 
It is common nowadays in modern music setups to have noise issues that require some thought and experience to sort out.
 
It is common nowadays in modern music setups to have noise issues that require some thought and experience to sort out.
  
We prepared a short guide to help you troubleshoot some noise issues that you may face using MOD devices.
+
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;
In the following sub-chapters we will check some common sources of noise on our devices and how should you approach to get it solved.
+
* 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.
=== Gain staging ===
 
It's not uncommon to have noise being listenable due to poorly set gain staging settings between the devices connected to your setup.
 
 
 
As gain amplifies each element of an audio signal, a poorly set gain staging can be increasing the noise present in your gear to an unusable point.
 
 
 
Often devices, when you can set one or multiple gains, have colourful LEDs or graphic representations. Optimal gain staging headroom is obtained when you play on the yellow area.
 
 
 
==== How to tackle issues with gain staging on your MOD device ====
 
If the input gain on your MOD device feels a bit too quiet, try to increase the gain on the device on your signal chain before the MOD devices, while decreasing on the MOD device output. You can do that either by decreasing the Master Volume, a gain plugin by the end of your pedalboard.
 
 
 
If by another end you find the output signal on your MOD device too quite perform the opposite as before. So you should increase the output levels on your MOD device (again, either by using a plugin by the end of your pedalboard or the master volume), simultaneously you should decrease the gain in the device connected in your signal chain after your MOD device.
 
 
 
When the output of your device is too "hot" (or loud) for the device that you have it plugged into, it's better for the range to turn down on the codec gain (on the settings of your device) than to do it using a plugin in the pedalboard.
 
 
 
'''Note:''' all these adjustments should be done according to your setup and fine-tuning, so you can avoid noise issues.
 
 
 
=== Pedalboard setup ===
 
Some noise issues are caused by your pedalboard arrangement and the plugins that you are using. Some amp or tape simulators color the signal with their own programmed enhancements and often can be dialed back when necessary. Yet, sometimes developers don't give control to the users on these enhancements.
 
 
 
For these types of cases, you need to use compressors or amplifiers in your pedalboard, you should use also a Noise Gate plugin to filter out all sounds happening below a threshold.
 
 
 
=== Ground loop issues ===
 
Ground loops are some of the most common issues causing noise on audio devices. It results often in a modulated hum around 50 and 60Hz.
 
Besides this normal hum, digital noise from all devices connected to your setup can also be introduced on the ground, and become audible when a loop is present. In other words, this means that the noise is not necessarily generated by a particular device, but by the combination of multiple devices.
 
 
 
You can read more about them [https://en.wikipedia.org/wiki/Ground_loop_(electricity) here].
 
 
 
There are mainly 3 identified causes for ground loops in MOD devices:
 
 
 
==== Multiple grounded audio devices in your setup plugged into different power sockets ====
 
- If your issue may fit into this situation you will need to limit the loop size of the power section between your devices.
 
 
 
In order to achieve that try to use the same power strip between all the devices connected via audio to the MOD device or keep the power cables closer together;
 
 
 
- Check if you have equipment connected in the room that may lead to interferences. Common issues can be found if you used dimmed LEDs or fluorescent lights;
 
 
 
- If none of the above helps you experiment connecting to other power sockets. Although this may increase your power loop size, sometimes different sockets can be less prone to interference due to their shape and orientation;
 
 
 
==== Unbalanced cables between MOD device and grounded gear ====
 
 
 
- If the device where you have your MOD device connected has a "ground lift" switch (some mixers for example have it), try using it;
 
 
 
- add a passive DI or a ground loop isolator if the receiving device has unbalanced inputs;
 
 
 
- if the receiving device has balanced inputs, use balanced/stereo cables;
 
 
 
- if none of the above works experiment with a passive DI or ground loop isolator and balanced/stereo cables.
 
 
 
==== USB connection to a grounded device (for example: a computer) ====
 
 
 
- use the MOD USB provided cable;
 
 
 
- try without a USB connected;
 
 
 
- try a different USB port;
 
  
- try through a USB hub;
+
For more detailed explanations and info, please check the "[[Dealing with noise issues]]" page.
  
- add a USB isolator.
+
== 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.
  
===== For MOD Dwarf users =====
+
The cause for this behavior is the "USB selective suspend" feature of your computer.
If you are a MOD Dwarf user and you believe that you are facing a ground loop issue try to use the ground loop compensation feature available for this device.
 
  
You can access this feature under "System Behaviour" on the settings of your MOD Dwarf.
+
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.
  
'''Note:''' enabling this feature reduces slightly the amount of available CPU power on your MOD Dwarf.
+
== 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.