Hi, I’m the Toradex AI Assistant.
I might make mistakes or occasionally get you wrong. Our support team will step in if needed.
Troubleshooting Linux Host Issues with Toradex Easy Installer
When the ./recovery-linux.sh script hangs or doesn’t respond on a Linux host, there are several troubleshooting steps you can take based on the Toradex documentation(1).
Common Issues and Solutions
1. USB Enumeration Problems
The Toradex Easy Installer SPL/U-Boot bootloader re-enumerates as different USB devices during recovery mode(1). This can cause issues similar to what you’re experiencing.
If you’re using an Ixora Carrier Board, ensure that X9 is configured in OTG mode by removing JP2(1).
2. USB Cable and Port Issues
Try the following hardware troubleshooting steps(1):
- Use a different USB cable
- Connect to a non-USB3 port on your host machine
- Avoid using USB hubs between the PC and the USB OTG port(2)
3. Check USB Device Recognition
On your Linux host, you can monitor USB device detection using:
dmesg | tail -f
This will show you if the device is being detected and re-enumerating during the recovery process.
You can also check connected USB devices with:
lsusb
4. Network-Related Issues
If the script hangs during download, some firewalls have issues with TCP window scale option(1). You can disable this using:
sysctl -w "net.ipv4.tcp_window_scaling=0"
5. Serial Console Access
There’s a serial console available on UART1/UART_A which you can use to access the Easy Installer’s shell(1). The main UI process outputs debug messages to:
/var/volatile/tezi.log
To view the current log content:
cat /var/volatile/tezi.log
6. Boot Arguments
The Toradex Easy Installer boot scripts start with a fixed set of Linux kernel parameters, but also append any variables defined in teziargs(1). You can add debug parameters such as debug to get full kernel debug output(1).
Additional Recommendations
- Restart the Recovery Process: If downloading gets stuck or fails, try starting over from the Recovery Mode setup(2)
- Check Permissions: Ensure you have proper permissions to access USB devices on your Linux system
- Verify Module is in Recovery Mode: Double-check that your Verdin iMX8M Plus is properly in recovery mode before running the script
If these steps don’t resolve the issue, the problem might be related to your specific Linux distribution’s USB handling or driver configuration.
Best regards, Toradex AI Assistant.
Did you like my answer?

If I answered your question, please tick the “Solution” checkbox.
For follow-up questions to me, please use @ToradexAI in your post.