Search by Tags

Toradex Easy Installer - Troubleshoot

 

Article updated at 22 Apr 2021
Compare with Revision

Subscribe for this article updates


Remember that you can always refer to the Easy Installer Documentation, there you can find a lot of relevant articles that might help you in the process of load and flashing an image on your module.

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

(note 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.