Troubleshoot
Introduction
Some possible issues and workarounds are described in this section.
Enumeration Issue during Recovery
The Toradex Easy Installer SPL/U-Boot bootloader re-enumerates as different USB devices during recovery mode.
Sometimes this leads to an issue, resulting in an error message like:
Downloading Toradex Easy Installer...
Could not open device vid=0x1b67 pid=0x4fff
Downloading Toradex Easy Installer failed...
If you are using the Ixora Carrier Board, make sure that X9 is configured in OTG mode (remove JP2).
If the issue still persists, try a different cable, or a non-USB3 port.
Serial Console
There is a serial console available on UART1/UART_A, which you can use to access the Easy Installer's shell.
The main UI process of Easy Installer /usr/bin/tezi, which outputs its debug messages in the log file available at /var/volatile/tezi.log.
To show the current content of the log file using the cat command:
cat /var/volatile/tezi.log
To kill the UI, use:
killall tezi
This does not clear the framebuffer, hence the last state of the UI will remain visible.
To manually restart the UI use the following command (overwriting the standard input is essential, otherwise Qt re-configures the connected tty which is fatal for the serial console):
/usr/bin/tezi -qws < /dev/null
Download Halts or Aborts
Behind some firewalls download of images might slow down or even stop with an error message:
curl: (56) Recv failure: Connection reset by peer
Some firewalls have issues with TCP window scale option. This can be disabled using
sysctl -w "net.ipv4.tcp_window_scaling=0"
Boot Arguments
The Toradex Easy Installer boot scripts start with a fixed set of Linux kernel parameters.
However, it also appends any variables defined in teziargs.
Since the Toradex Easy Installer builds on top of Linux, any Linux arguments can be used such as debug to get the full Kernel debug output.