Toradex Easy Installer Issue Tracker

Description: The Colibri iMX7 and Colibri iMX6 ULL eMMC variants have a fixed Ethernet MAC address (`00:14:2d:00:00:00`) when loaded using USB recovery.

Workaround: Use Toradex Easy Installer 5.

Description: Update UUU to version 1.5.165 and use a dynamically linked binary (instead of a statically linked binary).

Description: WinCE image installation fails with error `Finished with exit code: 1 Error: "Error creating partition table"`.

Workaround: Use Easy Installer 5.7.6 to install WinCE images

Description: Image installation might fail with the "Too few blocks for viable filesystem" error on eMMC based SoMs.

Description: Tezi is very slow, to the point that installation could actually fail with timeout on low-end module variants

Workaround: Disconnect any HDMI monitor and use VNC.

Description: This adds the halt and poweroff commands to the TEZI rootfs. Due to the simple init used the tools need to bypass init and directly direct call the kernel systemcalls. I.e. they need to be called with the `-f` parameter.

Description: Image installation might fail with the "Too few blocks for viable filesystem" error on eMMC based SoMs.

Description: The NAND bad block table is getting corrupted at every boot because of a configuration mismatch between U-Boot (using OOB data for bad blocks) and Linux (using an in-band table at the end in the last 2 NAND blocks). This could potentially cause data loss in case a bad block is reused and the error is not recoverable with ECC.

Workaround: Set `CONFIG_SYS_NAND_USE_FLASH_BBT=y` in U-Boot configuration.

Description: Support for PID8 naming scheme when assembly version >25 (config block generation)

Description: Issues with `tezictl` when no images are available on the current feed

Description: Detection of the Colibri iMX7D 1GB eMMC (0039) V.1.1B is not working correctly, because of that the wrong device tree is selected and Tezi is not able to read the config block.

Description: Replacement of eMMC chips with different manufacturers can sometimes change some parameters like the boot partition size. When using Toradex Easy Installer to write configuration blocks (raw images) it is not possible to select a negative offset to count from the end of the partition, making image.json files incompatible between old and new eMMC chips.

Workaround: Use a wrapup.sh script to calculate the size of the boot partition and write the configuration block there. Tezi 5.6.0 will introduce a new offset parameter for this use case.

Description: Toradex Easy Installer is falling into a "installation-loop" if autoinstall in image.json is set to true. The Easy Installer is supposed to only auto-install newer Easy Installer versions.

Description: All 3 display interfaces DVI-D aka HDMI, parallel RGB as well as VGA should be brought up concurrently just like the Toradex Easy Installer 1.8 used to do. But currently, only the former two are brought up while analogue VGA requires manual intervention.

Workaround: To bring up analogue VGA as well you may manually add the following device tree overlay to the overlay.txt file:
apalis-imx6_vga_overlay.dtbo

Description: Add support for the new eMMC and 1GB RAM variant of Colibri iMX6ULL to the same colibri-imx6ull Easy Installer machine.

Description: An already installed BSP U-Boot should not be able to boot an Easy Installer image that is plugged into e.g. an SD-Card slot.

Workaround: TBD

Description: If one installs an image which requires a newer Toradex Easy Installer and one wants to use the autoinstall feature one can provide the newer installer alongside the image to be installed. Then the new installer is installed first followed by the installation of the image. The versions 2.0b4-2.0b7 however do not automatically reboot after installation of the newer Toradex Easy Installer but rather show the standard dialogue /Power off/Reboot/Return to menu/ instead

Description: Restoring a completely erased NAND flash fails using Toradex Easy Installer 2.x.

Workaround: Use Toradex Easy Installer 1.8 via recovery mode instead and erase the flash before installation.

Description: Resolution of the Toradex Easy Installer HDMI is not plugged-in is not 640x480, this leads to Remote Desktop not showing the complete Toradex Easy Installer.

Workaround: Set 1024x768 as resolution manually in the Remote Desktop settings.

Description: The Toradex Easy Installer may hang trying to installing images with the 'autoinstall' property enabled in its image.json file.

Description: Unfortunately, the default display interface detection (required on Apalis iMX8 QuadXPlus 2GB ECC IT without DSI to HDMI chip being assembled) is not working as it seems to depend on some userspace intervention not happening during boot when executed from rc.local. This can be seen by the following message being printed during boot:
sh: bad number
On the aforementioned module, this leads to no UI being visible on parallel RGB.

Workaround: Either use VNC to remotely connect to the board or type the following in the serial debug console to get parallel RGB working
/ # killall tezi weston dbus-daemon
/ # rm /var/run/dbus/pid
/ # /etc/rc.local

Description: Add support for Apalis iMX8QXP 2GB WB IT V1.1B.

Description: The analogue VGA display output is not working on Apalis iMX6.

Workaround: Until this feature is fixed in version 2.x please use stable version 1.8.

Description: Add support for Apalis iMX8QP 2GB V1.1B.

Description: Add support for Colibri iMX8QXP 2GB IT V1.0D.

Description: Add support for Colibri iMX8DX 1GB V1.0D.

Description: Add support for Verdin iMX8M Mini Quad 2GB WB IT V1.1A.

Description: Add support for Verdin iMX8M Mini DualLite 1GB WB IT V1.1A.

Description: Add Support for Apalis iMX8X V1.1B and Colibri iMX8X V1.0C with i.MX8QXP C0 and PF8X00 C1 requiring up-to-date SCFW and different SECO firmware.

Description: Optimise feed loading based on machine or product ID.

Description: By default the flash is not erased when installing a new image, but simply overwritten by the new image. The U-Boot environment however is typically not overwritten. This might influence the next image installation. Since installing the Toradex Easy Installer onto a device usually means that one would like to have the module behave like after a factory reset, installing the Toradex Easy Installer image should erase the Environment by default.

Description: Add support to announce servers with HTTPS trough Zeroconf.

Description: VNC backend screenshare instance crashes at times.

Workaround: Unfortunately, once it crashed the Toradex Easy Installer needs to be rebooted to be able to try again.

Description: If connecting to the Toradex Easy Installer with VNC the keyboard layout is messed up. E.g. when using a Swiss-German configuration one can't input characters like slash /. It messes up the keyboard input so hard that not even US input will work.

Workaround: As a workaround switch the host-side to US-English layout as follows: setxkbmap usvncviewer ...

Description: SD card is not usable.

Workaround: Load images via Ethernet/Internet or use a USB memory stick.

Description: Provide a HTTP API to control the Toradex Easy Installer. Please contact your Toradex sales representative for further details.

Description: Announce VNC capability via zeroconf.

Description: Support Windows host for Toradex Easy Installer recovery.

Workaround: For the time being just use a Linux workstation optionally running in a VM of choice.

Description: Currently it is not possible to display the GUI in multiple screens at the same time.

Description: Implement VNC support for Weston.

Description: The Toradex Easy Installer crashes during boot if the regular off-module PCIe link can not be brought up. This is e.g. the case on the Apalis Evaluation Board if the PCIe switch is kept in reset (e.g. by removing jumper X3-4) or on Ixora if no mini-PCIe device is plugged in.

Workaround: On the Apalis Evaluation Board make sure the PCIe switch is not kept in reset (e.g. by placing jumper X3-4). On Ixora make sure a mini-PCIe device is plugged in. Alternatively, one may completely disable any PCIe functionality by specifying a tdxargs of initcall_blacklist=imx_pcie_init from within U-Boot:
setenv teziargs initcall_blacklist=imx_pcie_init
fastboot 0

Description: Kernel crashes when using Toradex Easy Installer 2.0b3 to recover an Apalis iMX8 module on a Ixora carrier board.

Workaround: Use previous Toradex Easy Installer or the Apalis Evaluation Carrier board.

Description: The CONFIG_EXT4_FS_SECURITY Linux kernel configuration was missing which prevented xattr from working properly.

Description: Add support for Apalis iMX8X.

Description: While the tezi.png icon is deployed with the package it is currently not shown in the image list as it is missing from image.json.

Description: TEZI provisioning container images on TorizonCore

Description: The certificates CN does not match the modules hostname.

Description: Add support for the zstd (Zstandard) data compression algorithm.

Description: The Ethernet link may constantly go up/down with the following messages in dmesg:
[ 2.237374] IPv6: ADDRCONF(NETDEV_UP): usb0: link is not ready
[ 2.739249] configfs-gadget gadget: high-speed config #1: RNDIS
[ 2.739922] IPv6: ADDRCONF(NETDEV_CHANGE): usb0: link becomes ready
[ 11.385522] fec 20b4000.ethernet eth0: Link is Up - 100Mbps/Full - flow control off
[ 11.385637] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready
[ 13.385379] fec 20b4000.ethernet eth0: Link is Down
[ 16.385482] fec 20b4000.ethernet eth0: Link is Up - 100Mbps/Full - flow control off
[ 20.385077] fec 20b4000.ethernet eth0: Link is Down

Workaround: Re-loading the Toradex Easy Installer may recover the Ethernet link to a stable condition.

Description: Images using the 3.10 L4T Kernel which get flashed with Tezi 2.0b1 do not boot. The kernel is not able to mount the file system and reports an error:
JBD2: Unrecognised features on journal

Description: Using remote connection with RDP constantly leaks memory.

Workaround: Restart the Toradex Easy installer if needed.

Description: Support uuu without libudev support (e.g. for containerized environments).

Description: Add support for iMX8 modules in the tezi images

Description: Updated Openembedded layers to thud

Description: When trying to install a Toradex Easy Installer from a running Toradex Easy Installer in a iMX6ULL 512MB WiFi, the image will be displayed as incompatible.

Workaround: Download the Easy Installer image provided in our developer site. Extract the zip files and look for the image.json. In the supported_product_ids field add "0045" to the list. The image will now appear in the Easy Installer as installable.

Description: When the Easy Installer untars the tarballs during installation, extended attributes do not get retrieved by tar if --xattrs-include=* is not passed as an argument together with --xattrs. This is in contradiction with the tar documentation, according to which --xattrs on its own suffices for tar to extract extended attributes.

Description: Some file system settings are not available through command line of the mkfs utilities. Currently the settings file is stored in /etc/mke2fs.conf, which is in the read only part. Hence the current situation prevents to use a custom mke2fs.conf file.

Workaround: We have added the tune2fs utility into the tezi images, which can be invoked in the wrapup script to change the filesystem attributes after installation.

Description: The Toradex Easy Installer version 1.8 may hang during boot with the following message shown last on its serial debug UART:
[ 0.456751] tegra-hdmi 54280000.hdmi: failed to get PLL regulator
Resp. without quiet:
[ 2.567691] tegra-ahci 70027000.sata: 70027000.sata supply target-12v not found, using dummy regulator

Workaround: This particular Linux kernel version seems to be susceptible to a AHCI SATA initialisation issue most likely related to clocking/PLL only happening on a few modules at lower temperatures. As AHCI SATA was never officially supported in the Toradex Easy Installer we just disabled it for now in the version 1.9 maintenance release. Alternatively, using any of the later Toradex Easy Installer versions like 2.0b6 also alleviates the issue.

Description: Start Toradex Easy Installer based on configurations defined on an SD card

Description: Show detailed information of the selected image. The image.json description field will be shown more prominently as the image list appearance has been improved.

Description: Forward ported commit 7ad9771527d2 ("apalis-tk1: fix pcie reset for reliable gigabit ethernet operation") was never validated. Turns out it does not work and may lead to PCIe gigabit bring-up issues.

Description: After startup mouse and keyboard sometimes stops responding completely for 10-15 seconds. The system seems to recover on its own, and mouse/keyboard continue to work just fine.

Description: Toradex Easy Installer 1.7 does not work for Colibri iMX6DL 512MB IT V1.0A.

Description: Add support for Colibri iMX6ULL 512MB IT V1.0A.

Description: When raw NAND devices are erased completely (e.g. using nand erase.chip in U-Boot), the boot configuration block has not been restored so far. With this release the Toradex Easy Installer will write a boot configuration block whenever the config block is missing (which is located in the same erase block.

Description: The field offset_in_sectors allows to specify a particular partition offset. By default, the minimal valid offset is used (for the first partition this is 8192 sectors/4MiB, for the subsequent ones depending on the size of the previous partition). Due to a "off-by-1" error the minimal offset leads to an error "Fixed partition offset too low".

Workaround: Since the minimal offset is the default anyway, do not specify "offset_in_sectors" if the minimal offset is required.

Description: The Toradex Easy Installer executes prepare/wrap-up scripts with a timeout of 30s. However, if the scripts exceed the 30s, the installer ignores that and simply continues executing, assuming the script succeeded. Instead of using a timeout without a reasonable error handling wait forever until the script ended. Also print a warning after 30s.

Description: Support USB device mass storage and RNDIS access in the Toradex Easy Installer for Apalis TK1.

Workaround: Revert to regular Ethernet, SD card or USB host support for now.

Description: Erase flash currently does not seem to work probably due to missing downstream Linux kernel discard functionality.

Workaround: Manually erase flash e.g. using U-Boot's 'emmc erase' command.

Description: When using the USB mass storage emulation functionality and ejecting a device, re-enabling the USB mass storage emulation does not show the USB mass storage partitions again.

Workaround: Restart Toradex Easy Installer and enable the USB mass storage emulation again.

Description: By default the Toradex Easy Installer does generate partition table in the DOS format. This adds support for GUID partition tables (GPT) by using the "table_type" property on block device level.

Description: The Toradex Easy Installer for Apalis TK1 currently does not support the 'Erase Flash (c)' button functionality.

Workaround: Either use the "mmc erase" U-Boot command or format your eMMC from Linux user space.

Description: Toradex Easy Installer does not detect when Ethernet gets disconnected and does not recognize when a different Network gets connected after having a previous connection established.

Description: Upstream libusbgx accepted our implementation of OS Descriptor support.

Description: The ethernet interface (eth0) does not get a link-local IPv6 address assigned. This prevents IPv6 neighbor discovery protocol from working (SLAAC).

Description: fw_setenv cannot be used in a wrap-up script due to wrong configuration file.

Description: Add an additional feed for 3rd party images.

Description: Print version of Toradex Easy Installer on the serial output

Description: Flashing a WinCE image with empty pages between resources leads to a flashing error: "Short read, expected X bytes.".

Description: This adds a new dialog to manage external/additional http image lists directly within Toradex Easy Installer. Allow to disable/enable image lists and add secondary image lists for nightly builds/testing images.

Description: Support Colibri iMX7 Dual 1GB modules using eMMC flash.

Description: Unified Toradex Easy Installer for Colibri iMX7 modules

Description: The Toradex Easy Installer does not validate the JSON file before writing the image. Important parts could be missing. A JSON validation step helps to detect issues early and prevent failures during the flashing procedure.

Description: On devices with eMMC the Config Block gets temporarily stored in RAM during erase operation. When turning off during erasing or immediately after, the Config Block can get lost.

Workaround: Wait until erase completed and additional 50 seconds until write cache timeout passed or flash an image (which will force the write cache flush).

Description: In case a module has an Antmicro provided Android image installed, flashing a new image might fail.

Workaround: Erase flash before installing the new image.

Description: Drücken diesen da 'Erase Flash (c)' machen alles kaputt!

Description: A module enters the recovery mode implicitly e.g. when no bootloader has been found (typically after erasing flash). Using Toradex Easy Installer recovery in this case fails unexpectedly. The downloaded U-Boot tries to boot from local storage and network.

Workaround: Enter recovery mode explicitly using the documented methods.

Description: Some volatile directories are missing resulting in tools needing them failing. E.g. fw_printenv and fw_setenv which access and modify the U-Boot environment fail as follows: / # fw_printenv Error opening lock file /var/lock/fw_printenv.lock /var/lock is a symlink to /run/lock, but /run/lock does not exist.

Workaround: Create the missing directories with: / # /etc/init.d/populate-volatile.sh start

Description: If there is no Internet connection, tezi.toradex.com can not be reached which creates an error and stops processing image lists downloaded over network connectivity.

Workaround: Use image on local media or make sure there is Internet connection available.

Description: The legacy update scripts can only handle some UBI volume layout. Make sure the Toradex Easy Installer uses a layout which can be processed by the legacy update scripts.

Workaround: Erase UBI partition before using legacy update scripts (run erase.part ubi).

Description: Currently the GUI still reads 'Toradex Easy Install v1.1' but we decided to leave that version aka v away for software artefacts.

Description: In case the Toradex Config Block isn't found on the module, a dialog is now shown which allows to restore the Config Block information by entering the information from the module sticker.

Description: Provide Toradex Easy Installer support for Colibri iMX7 Solo 256MB and Dual 512MB modules.

Description: The U-Boot shipped with Toradex Easy Installer does not read the Config Block which leads to Linux not using the module individual MAC address with Toradex OUI.

Description: So far a generic Product ID and Vendor ID has been used, which some Windows 10 versions seem not to recognize. With this release, MS OS Descriptors are used for better compatibility across various Windows versions.

Description: When entering recovery mode via bmode usb command in a v2016.11 U-Boot, downloading Toradex Easy Installer via recovery mode failed.

Description: Provide initial support for Toradex Easy Installer on Apalis iMX6 modules.

Description: Random MAC address leading to ever changing IP address when launched via USB recovery mode even though ConfigBlock is intact.

Description: After flashing a Verdin iMX8M Plus ConfigBlock into an Apalis iMX6 the Toradex Easy Installer displays such without doing any further checks. It could easily detect this inconsistency and display the same dialog as if the ConfigBlock could not be read.

Description: Add the commands poweroff and shutdown

Description: In recovery mode U-Boot cannot read the config block which leads to assign a random MAC address.

Description: Toradex Easy Installer should support using DNS-SD to discover an appropriate image server.

Workaround: Use server discovery using zeroconf technologies or use a custom local DNS Server which resolves tezi.toradex.com to a local image server.

Description: Add a check box which allows to also show images which are not compatible with the currently used hardware. By default the check-box is not selected and only compatible images are shown.

Description: Provide a mechanism for raw files which allows to write at a specific offset from the end of the partition. This is useful to handle WinCE Config Block which is located at the end of the eMMC boot partition. Because eMMC boot partition sizes can vary the offset from the beginning depends on the exact product and product version.

Workaround: Use the wrapup.sh script to dd the configblock (or any other file) with a calculated offset from the end of the partition. For example: ... IMAGE_FOLDER=$4 ... OFFSET=$(($(cat /sys/block/mmcblk0boot0/size)-17)) echo "Writing configblock.bin to offset ${OFFSET}" dd if=${IMAGE_FOLDER}/configblock.bin of=/dev/mmcblk0boot0 count=16 seek=$OFFSET This also makes sure that the static config block does not get accidentally overwritten in case configblock.bin is too long. Note that this only works for images read from a local media, since only then configblock.bin is simply available in $IMAGE_FOLDER.

Description: The default U-boot shipped on modules with Tezi no longer includes a U-boot environment partition on the flash. This is an issue for customers who don’t replace the U-boot that comes on the module but want to set kernel arguments (e.g. video settings).

Workaround: Flash a U-boot which includes an environment partition & support for saveenv.

Description: While launching the Toradex Easy Installer via recovery mode works on Windows 10 it may fail on Windows 7.

Description: Installing tezi 0.5 beta and doing a full power-cycle fails running it.

Description: Loading the image list might generate errors even if the user started an image installation already (e.g. installing from a local device). This error message(s) do not disturb or interrupt the installation, but are confusing and unnecessary.

Workaround: Ignore "Error downloading image list" messages during installation.

Description: RDP does not work when network is changed and Toradex Easy Installer gets a new IP.

Workaround: Flash Toradex Easy Installer with correct network attached and do not change it on runtime.

Description: FreeRDP commit 753b9c7ce9af ("Enable server heartbeat PDU by default.") changed heartbeat to be enabled by default which fails connecting to the Toradex Easy Installer running Weston RDP backend.

Workaround: Start FreeRDP with heartbeat being disabled e.g. as follows
xfreerdp -heartbeat -v:192.168.11.1

Description: Attempting to install a BSP 2.6 or later on an older Apalis iMX6 V1.0A, V1.1A, V1.1B (Apalis iMX6Q 2GB IT before 2017-05-30 only) or Colibri iMX6 V1.0A module for the first time may subsequently fail booting due to SoC fusing not being possible.

Workaround: Either use the legacy update procedure or an older Toradex Easy Installer version like stable 1.8.

Description: Un-plugging HDMI during runtime makes the other display flicker/slow-down and gives a kernel backtrace.

Workaround: Do not un-plug HDMI during runtime.

Description: If the RTC does not provide a valid time and there is no internet connectivity, the Toradex Easy Installer sets the time to the build time. This time is used to generate the RDP certificate. When using the Toradex Easy Installer later than one year after the build time, the certificate will no longer be valid. The validity should be set to a reasonable long lifetime.

Description: Windows RDP client exits with an "internal error" when connecting to Tradex Easy Installer.

Workaround: Use Linux RDP client.

Description: With us moving to Qt 5, we dropped VNC support in favour of using RDP.

Description: The exported registry file for i.mx6 is not valid and re-importing it restores the default registry instead.

Description: -

Description: Port Toradex Easy Installer to Colibri iMX8X modules.

Description: Rebooting the system from the Easy Installer wrapup script is possible (by issuing the `reboot -f` command), but busybox will not unmount volumes on reboot, so such a reboot might lead to data corruption on an image from an SD card.

Description: The following is displayed in the serial debug console upon boot:
[ 17.672131] cpu cpu0: failed to scale vddarm up: -22
[ 17.677125] cpufreq: __target_index: Failed to change cpu frequency: -22

Description: The image.json should provide an option to filter by full product number (8 digit) in addition to product id only (4 digit).

Description: USB ports at times do not work

Workaround: Power cycle the device

Description: Trying to automatically install an older or equal version of the Toradex Easy Installer from a running Toradex Easy Installer is not allowed. This is desired in most use cases (e.g. installing from an SD card), but it can become a problem in others, particularly when re-flashing the Toradex Easy Installer from a recovery image.

Workaround: Currently the workaround for this is setting `isinstaller: false` in the json config, but this may cause problems of infinite install loops.

Description: The USB hub on the carrier board is not working. This renders the USB host ports on connectors X53 and X54 unusable, except for the first port on X54 (USBH3).

Description: Add support for filesystem_type: "swap", so that a swap partition can be setup during an Easy Installer installation.

Description: Distroboot from USB Stick/SD Card may allow you to load Toradex Easy Installer into a Toradex SoM without the need of going through recovery mode, which involves exposing a USB OTG interface and using a computer.
While this seems easier, due to limitations on the SoC vendors BSP - such as the SCU firmware - it is not a maintainable feature and therefore not supported by Toradex.

Workaround: Keep in mind that Toradex Easy Installer is a production programming tool, not meant to be used as an update tool. If you need to update the full OS image for devices on the field and still insist on using it, make sure that your hardware design is aware of the requirements for entering recovery mode. Alternatively, consider adopting an OTA solution: for instance, if you are using Torizon, consider adopting Torizon OTA.

Description: Add new Feed: pressing numbers selects/unselects servers (even in input field).

Description: To allow using Toradex Easy Installer on carrier boards which use non Colibri/Apalis standard functionality the Toradex Easy Installer should make sure to not mux/use any non-essential pin.

Description: To validate integrity of the image a checksum for each file getting written to the flash should be stored in the image description file.

Description: Due to a combination of hardware and software architecture issues it is currently not easily possible to clone the same output to HDMI and parallel RGB.

Description: Use the new Toradex versioning scheme.

Description: Add support for Apalis iMX8X 1.1A

Description: Support Toradex Capacitive Touch Display 10.1"

Description: Support LVDS Screen in Toradex Easy Installer

Description: Currently the Toradex Easy Installer downloads every image.json references in a image list just to check whether the image is compatible with the module at hand. This does not scale well as we add support for more and more modules. Introduce a image list format which states which modules a particular image is for.

Description: When using RNDIS to download an image list from a custom server in a host, tezi silently fails.

Description: Assess and generalize recovery mode handling. Make sure upon recovery mode detection the default U-Boot environment is used rather than the one stored in flash to avoid any bad side-effects. Once U-Boot proper is running automatically start USB fastboot to allow for downloading further parts like e.g. the Toradex Easy Installer ITB.

Workaround: The downstream bring-up i.MX 8/8X/8MM U-Boot already behaves like that and maybe consulted for guidance.