BSP Layers and Reference Images for Yocto Project Issue Tracker

Description: Booting a FIT image that includes a RAM disk is not working. Boot fails with the following errors: `Error: ramdisk overwritten`, `Ramdisk image is corrupt or invalid`.

Workaround: Update `UBOOT_RD_LOADADDRESS` in OE machine conf file.

Description: Update to Linux Kernel v6.1

Description: Colibri iMX6ULL doesn't wake up from suspend if the ethernet interface is disabled when the system is put to sleep. With the ethernet interface enabled, suspend / resume works.

Workaround: Don't disable the ethernet interface if you need to sleep/resume. Otherwise, use BSP 6.1 or later, this issue is already fixed there.

Description: USB RNDIS supports is getting deprecated [1], move USB Ethernet-over-USB functionality to USB NCM, updating libusbgx configuration. Starting with Windows 10 this USB protocol is also available in Windows and it has been available in Linux for a long time. [1] https://lore.kernel.org/all/20221123124620.1387499-1-gregkh@linuxfoundation.org/

Description: The instruction set used to compile userspace components is currently forced to be Thumb2 even for recipes which explicitly ask to be compiled for the ARM instruction set (the default for the armv7a machines was and stays Thumb2).

Workaround: No known issues because of this error

Description: In case a driver requests a firmware (even if it is optional) and this firmware is not present in the fs, the driver loading time will be delayed for 60 seconds, Atmel MXT capacitive touchscreen is affected by this bug

Workaround: Disable legacy `CONFIG_FW_LOADER_USER_HELPER` in kernel configuration

Description: USB over current polarity is currently not defined in the device tree file, leading to the following error: `imx_usb 2184000.usb: No over current polarity defined`

Workaround: This error message can be safely ignored

Description: The kernel might prints the following error message: `rtc rtc0: Timeout trying to get valid LPSRT Counter read`

Description: Default local.conf select upstream distro for i.MX6/6ULL/7 based SoM, downstream is no longer supported for these modules.

Description: USB OTG device/host role switching is not working

Description: Update Linux kernel for RT upstream distribution to version 6.0.0-rt11

Description: Add USB RNDIS support in minimal reference image

Description: Update Linux kernel for upstream distribution to version 6.0.x

Description: Drop custom Linux Kernel splash screen support

Workaround: Use plymouth or another standard splash-screen solution

Description: Remove the code trying to set `read_ahead_kb` emmc queue parameter.

Description: Remove `libsoc` deprecated package from tdxref image.

Description: Use random MAC addresses from the private IEEE range instead of `00:14:2d:ff:ff:ff` and `00:14:2d:ff:ff:fe` for the USB RNDIS ethernet interface

Description: Use LZ4 kernel compression algorithm instead of LZO.

Description: Update system critical shutdown threshold to match the SoC maximum junction temperature.

Description: Add WAKE#_MICO signal as default wake-up source for every module and carrier board.

Description: Sometime (around 20% of the time) it is not possible to resume from suspend.

Description: The custom fstab that's installed on our builds doesn't include the "defaults" option that gets substituted by "to" as part of the openembedded "read-only-rootfs" IMAGE_FEATURE. Because of this, setting the image feature doesn't achieve the desired result of having the rootfs mounted as read-only.

Workaround: Patch the file meta-toradex-demos/recipes-core/base-files/base-files/fstab and include the "defaults" option: - /dev/root / auto noatime 1 1 + /dev/root / auto defaults,noatime 1 1

Description: Add mii-tool to the image

Description: Sometimes audio playback time on SGTL5000 does not match the input file duration.

Description: Update to NXP released L5.4.70_2.3.7 (SECO, user-space, imx-boot)

Description: Fix SoC T-junction temperature reading

Description: Update Linux kernel to 5.4.161

Description: Do not override other meta-freescale recipe from our Open Embedded layers

Description: Do not store u-boot environment during boot unasked

Description: SD card is not detected in U-Boot if the Pull-up resistor is removed from the carrier Board

Description: The downstream BSP does not default parallel RGB to the VESA VGA resolution/timing. This may lead to such monitors not being able to display anything.

Workaround: Use upstream BSP.

Description: Update to latest kernel.org patch release and pull in latest patches from linux-imx 5.4.70_2.3.3 patch release.

Description: The assigned MAC address is not the same in U-Boot and Linux kernel.

Description: CMA memory allocation is a fixed value and takes up too much space on certain SKUs. Drop the configuration of the CMA in the device tree in favour of specifying it in the kernel config with a size of 256MB or 12% of total memory which ever is less.

Description: Drive strength settings were 87 Ohm at 3.3V and 50 Ohm at 1.8V. For impedance-matching, we need to set it to 50 Ohm at 3.3V and 30 Ohm at 1.8V.

Workaround: You may also find the patch fixing this here:
https://lore.kernel.org/patchwork/patch/1389632/

Description: The following crash can be observed during system reboot:To reproduce please type, reboot command and check for trace from weston ........ [ 54.358713] weston: unhandled page fault (11) at 0x636f6c33, code 0x005 [ 54.365339] pgd = d33edf7e [ 54.368125] [636f6c33] *pgd=00000000 [ 54.371718] CPU: 0 PID: 495 Comm: weston Not tainted 5.4.91-5.1.0-devel+git.6ad99da2c675 #1 [ 54.380101] Hardware name: Freescale i.MX6 Ultralite (Device Tree) [ 54.386291] PC is at 0x76d5cc88 [ 54.389459] LR is at 0x76d5cc79 [ 54.392604] pc : [<76d5cc88>] lr : [<76d5cc79>] psr: 600b0030 [ 54.398895] sp : 7e84c698 ip : 76eb1bfc fp : 7e84c810 [ 54.404121] r10: 01cf4cd8 r9 : 7e84c9fc r8 : 01cf9988 [ 54.409371] r7 : 01cf5308 r6 : 01cf9988 r5 : 01d51d78 r4 : 636f6c2f [ 54.415901] r3 : 01d22b40 r2 : 01cf305c r1 : 02000000 r0 : 636f6c2f [ 54.422467] Flags: nZCv IRQs on FIQs on Mode USER_32 ISA Thumb Segment user [ 54.429907] Control: 10c5387d Table: 9530406a DAC: 00000055 [ 54.435659] CPU: 0 PID: 495 Comm: weston Not tainted 5.4.91-5.1.0-devel+git.6ad99da2c675 #1 [ 54.444013] Hardware name: Freescale i.MX6 Ultralite (Device Tree) [ 54.450222] [<8010db6c>] (unwind_backtrace) from [<8010ae84>] (show_stack+0x10/0x14) [ 54.457980] [<8010ae84>] (show_stack) from [<808c9514>] (dump_stack+0x90/0xa4) [ 54.465218] [<808c9514>] (dump_stack) from [<8011194c>] (__do_user_fault+0xfc/0x100) [ 54.472972] [<8011194c>] (__do_user_fault) from [<80111d2c>] (do_page_fault+0x354/0x394) [ 54.481074] [<80111d2c>] (do_page_fault) from [<80111ed4>] (do_DataAbort+0x3c/0xc0) [ 54.488741] [<80111ed4>] (do_DataAbort) from [<80101ddc>] (__dabt_usr+0x3c/0x40) [ 54.496138] Exception stack(0x952fdfb0 to 0x952fdff8) [ 54.501199] dfa0: 636f6c2f 02000000 01cf305c 01d22b40 [ 54.509385] dfc0: 636f6c2f 01d51d78 01cf9988 01cf5308 01cf9988 7e84c9fc 01cf4cd8 7e84c810 [ 54.517567] dfe0: 76eb1bfc 7e84c698 76d5cc79 76d5cc88 600b0030 ffffffff\ ........

Description: Show EULA license on tdx-reference images that has to be accepted when installed with the Toradex Easy Installer. Note that our tdx-reference images can no longer be installed unattended using the Toradex Easy Installer.

Workaround: Remove the "license" line in the image.json file.

Description: Change OpenEmbedded recipes from Toradex to fetch from https instead of git where possible.
In an approach to make it more user-friendly, especially for big company customers that do not allow git-protocol in their networks we decided to use https as a fetching source.
We are aware that we cannot do this for each and every layer but at least for ours we decided to switch from git to https.

Description: Add device tree overlay to disable mcp251x spi-to-can transceiver and enable spidev.

Description: Update all components of userspace according to the release notes of the new NXP L5.4.70-2.3.0 release.

Description: Add missing display device tree overlays.

Description: We dropped support for fdt_fixup in favour of using device tree overlays.
https://developer.toradex.com/knowledge-base/device-tree-overlays-linux

Description: WIC images fail mounting /boot. Looks like classes/image_type_tezi.bbclass in meta-toradex-bsp-common is setting the label to all upper-case BOOT while WIC images are using all lower-case boot. This is particularly bad on Verdin iMX8M Plus as due to no Toradex Easy Installer being available as of yet we are using WIC images with the bmap tool for production flashing.

Description: Make sure to document on our developer website which display interfaces are used by default.

Description: Drop ptest from DISTRO_FEATURES. This should reduce total packages that have to be built.

Description: On NXP i.MX 6ULL and i.MX 7 based modules the qt-demo is not working due to the missing qt-wayland backend. Fix this.

Description: Use KBUILD_DEFCONFIG in OpenEmbedded to define the defconfig to build the kernel from. Toradex is now using the defconfigs from the kernel-repo instead of providing separate defconfigs in OpenEmbedded. However if you wish to provide your own defconfig in OpenEmbedded you can still do so.

Description: Update the developer website documentation about BSP device tree overlay support.

Description: With the move to the NXP L5.4.24-2.1.0 BSP we will have all our downstream and mainline/upstream Linux kernels based on 5.4. Using 5.4 based backports with this does not make any sense so drop it.

Description: With this ticket the OpenEmbedded image names changed: console-tdx-image --> tdx-reference-minimal-image verification-tdx-image --> tdx-reference-multimedia-image graphical-tdx-image got deleted and QT5 was added to tdx-reference-multimedia-image.

Description: Move to newer mainline U-Boot 2020.07.

Description: Update downstream kernel to the latest NXP BSP L5.4.24_2.1.0.

Description: Our BSP now exclusively provides Wayland/Weston with XWayland as graphical backend.

Description: Create udev rules to symlink ADC devices.

Description: Change udev rule symlink naming to uart instead of tty.

Description: Name Wi-Fi interfaces consistently.

Description: Add U-Boot boot count support.

Description: Add usbhubc to all our images and document its use.

Workaround: An OpenEmbedded recipe already exists which allows adding uhubctl to any custom image.
http://layers.openembedded.org/layerindex/recipe/85122/

Description: The mwifiex_sdio driver goes into an unrecoverable state after the firmware of the SDIO Wi-Fi module has crashed. Note: this only covers the Wi-Fi only use case while NXP is still working on the concurrent Wi-Fi Bluetooth use case (see ELB-3039).

Workaround: Use the mwifiex_sdio driver from backports-5.4 for robust Wi-Fi functionality. Note: this only covers the Wi-Fi only use case while NXP is still working on the concurrent Wi-Fi Bluetooth use case (see ELB-3039).

Description: Update downstream kernel to the latest NXP BSP L4.14.98_2.3.0.

Description: The Pin Settings in the Colibri iMX 6ULL for GPIOs are wrong.

Workaround: Use correct Pin Settings as documented in the Device Tree Customization article.

Description: Qt 4 was first released in 2005 and has been unsupported since 2015. For our 3.0 (thud based) release we remove meta-qt4 from the installed layers and remove related image recipes.

Workaround: Forward port applications to use Qt 5.

Description: Move to a newer mainline U-Boot for future-prove support.

Description: NXP released BSP L4.14.98_2.0.0_ga. Update the kernel to that release.

Description: Update to the OpenEmbedded Thud resp. Yocto Project 2.6 release. - Drop support for the Apalis T30 and Colibri T20/T30/VF.
- Drop support for the legacy update procedure. - Drop Qt4 from the default install - Change the distro from Angstrom to Poky based but keep systemd as the default init manager.

Description: Dropped support for the Lightweight X11 Desktop Environment (LXDE) in favour of single application use-case.

Workaround: Use the latest stable BSP 2.8.

Description: ADC readings may face a jump behavior due to keeper enabled by default.

Workaround: Disable keeper in ADC pinmuxings.

Description: hostapd systemd does not work on the startup

Workaround: In /lib/systemd/system/hostapd.service, change the line "After=network.target" to "After=multi-user.target"

Description: Apalis TK1, Apalis/Colibri iMX6*/7: SGTL5000 audio codec may produce clack/pop sounds while playing.

Workaround: Fix removing all found clacks/pops produced by SGTL5000 audio codec available in -next branches of toradex_tk1_l4t_r21.7 and toradex_4.9-2.3.x-imx.

Description: for operating Wi-Fi/BT capable modules with a single antenna please have a look at the following article on our developer website:
https://developer.toradex.com/knowledge-base/operating-wifibt-capable-modules-with-a-single-antenna

Description: Resuming after suspend may not work.

Description: The following temperature trip points are in effect now:
Throttling: 95°C
Shutdown: 105°C

Description: Doing ifdown/ifup may leave Ethernet PHY in an unknown state just permanently blinking preventing any communication. This is caused by an Ethernet PHY power-down without physically powering down resp. rail leaving the PHY in an unknown state which later upon powering it back up fails locking PLL. We may just disable PHY power-down bit (already implemented on Colibri VF50/61) or where possible properly implement powering down resp. rail.

Description: Back feeding on Ethernet rail when Ethernet is powered down.

Description: NXP released BSP 4.9.123_2.3.0_ga. Patches for the user space components are on the meta-freescale mailing list.

Description: Colibi imx6ull v1.0 supports BT 4.0 and BLE 4.1 Starting with imx6ull v1.1 we support BT\BLE 5.0

Description: Add a device tree which targets the aster carrier board. This also enables an easier integration of the Capacitive Touch 7" Parallel display.

Description: The Colibri iMX6ULL V1.0 and V1.1 HW has no discrete pull ups on the I2C bus to the touch controller. This may lead to unreliable communication with the internal 100k pull ups and the used 80kHz I2C clock.

Description: Add support for the new V1.1A hardware revisions of the Colibri iMX6ULL products.

Description: Image features (e.g. tools-debug or others documented at https://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-features-image) do currently not work with the console-tdx-image. The reason is that the image is inheriting from image as opposed to core-image.

Workaround: You may use core-image instead but it might have additional effects.

Description: Add support for RS485

Description: Our Yocto Project layer readmes may not be up-to-date.

Workaround: Make sure to use valid combinations e.g. as available as tagged repo meta data:
http://git.toradex.com/cgit/toradex-bsp-platform.git

Description: Colibri iMX6ULL Crashing After Resuming from Suspend on Iris

Workaround: A patch is available in toradex_4.9-1.0.x-imx-next "arm: imx: gpc: do not poweroff M/F mix in suspend"

Description: libsoc is a C library to interface with common peripherals found in System on Chips (SoC) through generic Linux Kernel interfaces. As libsoc supports more and more of our modules we add libsoc support to our regular images.

Description: Currently the Toradex configuration block parser suffers an off by one issue potentially leading to spurious printout during boot e.g.
Model: Toradex V1.2A,
instead of
Model: Toradex UNKNOWN MODULE V1.2A.

Workaround: Fix available on 2016.11-toradex-next branch of git.toradex.com/u-boot-toradex.git.

Description: To get atmel mxt based touchscreens with GPIO connected reset line to work GPIO needs to be configured as an output with appropriate level separately.

Description: In order to allow our customers easy re-flashing of the touch controller configuration, we need to add the mxt-app as well as the proper configuration files to our images.

Workaround: https://www.toradex.com/community/questions/25020/view.html

Description: Provide Toradex GPIO tool.

Description: The update to rocko (BSP 2.8b1) made automount fail for systems which do not trigger mounting through dbus/udisk2, i.e. which rely on udev rules.

Description: When building 2.8b1 building stress fails with "ERROR: stress-1.0.4-r0 do_fetch: Fetcher failure for URL: 'http://people.seas.harvard.edu/~apw/stress/stress-1.0.4.tar.gz'. Checksum mismatch!".

Workaround: Use 2.8b2 or remove the stress recipe under "meta-toradex-demos/recipes-support/stress/stress_1.0.4.bb" (this will use a fixed version of stress in openembedded-core/meta/recipes-extended/).

Description: In the demo images for BSP 2.8b1 the image viewer gpicview is not installed.

Workaround: Remove adwaita-icon-theme from BAD_RECOMMENDATIONS when building the image with openembedded.

Description: Add support for on-module Bluetooth

Description: Include hostapd in demo builds. Note that this is only about the naked daemon without any configuration which depends on resp. requirements. So nothing of the hostapd will be automatically started by default.

Description: Use ISO 8601 date format in the release_date property of the Toradex Easy Installer image JSON descriptor file.

Description: We are currently using 4.11 which is not really an LTS release however we opted to do that because we were relying on it for certain later features for certain Wi-Fi solutions we wanted to support. It may make sense to stabilise on an LTS release for the future.

Workaround: You may find our backports based on Linux kernel 4.14 here: http://git.toradex.com/cgit/backports-toradex.git/log/?h=toradex-4.14

Description: Update to the OpenEmbedded Rocko resp. Yocto Project 2.4 release.

Description: Add a -v parameter to fw_printenv/fw_setenv which outputs the U-Boot source version information.

Description: Add support for on-module Wi-Fi.

Description: Bring-up Colibri iMX6ULL 512MB WB IT V1.0A.

Description:
Working on Colibri iMX6ULL 256MB V1.0A, demo image 2.7b4 image:
- U-Boot boot loader
- Environment storage in NAND
- Ethernet
- Framebuffer support
- GPIO from cmdline
- MMC/SD cards
- RAM size auto detection
- Splash Screen
- Toradex Colibri configuration block handling
- UARTA, used for serial console
- USB storage as host on USB host port
- Linux kernel
- Analog input via IIO framework, channel AD0 and AD1
- CAN via MCP2515 on Evaluation Board
- Ethernet
- Ethernet MAC address, optional custom setting from bootloader
- Framebuffer for parallel RGB displays
- Framebuffer console
- GPIOlib /sys/class/gpio
- I2C via /dev/i2c-X
- MMC/SD card mmc0, 4bit wide
- RTC (SoC and I2C)
- Resistive Touch
- SPI
- Splash Screen
- UARTA, used for serial console
- UARTB, UARTC
- Serial number and board revision in /proc/cpuinfo
- SoC unique ID in /sys/bus/soc/devices/soc0/unique_id
- Suspend LP1
- USBH host port
- USB host audio driver
- USB device Ethernet RNDIS
- USB device/host detection aka OTG support on USBC
- Watchdog via /dev/watchdog
- Update
- Legacy update scripts
- Toradex Easy Installer

Not working or not tested:
- U-Boot boot loader
- USB device/host switching
- Linux kernel
- Flexcan, not tested
- IrDA, not supported
- PWM, currently not working, SW issues
- RS485, not tested
- USB WiFi, drivers and firmware not installed
- On-Module Bluetooth/WiFi, not yet implemented
- Linux user-space
- GPIOtool, not yet implemented

Description: XDG Base Directory Specification (e.g. `XDG_RUNTIME_DIR`) variables are not set when connecting over ssh using dropbear

Workaround: Move from dropbear to openssh or manually set the required variables

Description: With some external hardware combinations, the user could experience significant boot delays that are connected to the systemd-udev-settle.service being selected as a dependency for the rngd.service startup. One example of a hardware that could present this behavior is 3G modems.

Workaround: Masking the systemd-udev-settle.service should be enough to get boot times back to normal. Keep an eye on failures to start up the rngd.service as it depends on devices to be present when initialized.

Description: Later distros like Fedora 36 will fail to connect as follows unless the configuration is explicitly weakened: Unable to negotiate with 192.168.10.2 port 22: no matching host key type found. Their offer: ssh-rsa scp: Connection closed

Workaround: Put the following in your ~/.ssh/config below resp. host you are trying to connect to: PubkeyAcceptedAlgorithms +ssh-rsa HostkeyAlgorithms +ssh-rsa

Description: Sometimes during boot imx_thermal_probe() triggers a warning / kernel stack trace.

Description: CMA memory allocation is a fixed value and takes up too much space on certain SKUs. Drop the configuration of the CMA in the device tree in favour of specifying it in the kernel config with a size of 256MB or 12% of total memory which ever is less.

Description: Simultaneous use of Wi-Fi and Bluetooth interfaces can lead to crashes of the firmware and/or the Linux kernel driver of the SDIO Wi-Fi/BT solution.

Workaround: Unload (rmmod) the entire Wi-Fi and Bluetooth stack and reload (insmod) it again. Worst case an entire system reboot may be required. Note: NXP is still working on the concurrent Wi-Fi Bluetooth use case.

Description: Provide proper vidargs for mainline 5.4 in BSP 4.0.0

Description: Sync U-Boot DTS with the Linux mainline

Description: Add support for Bluetooth audio

Description: Add support for the memory bus

Description: Add support for HDA and/or AC97 and/or I2S

Description: Add support for the Analogue Camera Adapter (ACA)

Description: UHS-I modes must be set in the device tree, to make the feature work consistently.

Description: Setting the RTS pin low in idle state for RS485 communication is not possible.

Workaround: Put a hardware inverter on the carrier board resp. use the exact RS485 hardware design of our Evaluation Boards.

Description: While the CAN transceiver regulator is properly powered-down on non-use such functionality during suspend is currently missing in flexcan.c.

Workaround: A custom power-down GPIO may be implemented.

Description: Switching multiple times back and forth between USB device/host mode sometimes may freeze the module.

Description: Support continuous ADC sampling for iMX7 and iMX6ULL triggered by Software

Description: Currently native Compilation is not working in the regular Bsp (version > 2.8) due to a mismatch of GCC libraries.

Workaround: Do cross-compilation or create a custom image with GCC being pre-installed.
IMAGE_INSTALL_append = " packagegroup-sdk-target"

Description: If one moves desktop icons in LXDE they are not redrawn automatically.

Workaround: Click anywhere on the desktop and the icons reappear at the position they have been moved to.

Description: Colibri iMX6ULL 512MB WB IT V1.0A sometimes fails to read UBIFS when the temperature is below 0°C. This issue was not detected on later version of Colibri iMX6ULL 512MB WB IT

Description: Currently there is no suitable browser which fits in the LXQt recipe. Find a suitable browser and integrate it into the layers.

Description: The ath10k firmware for Qualcom Atheros QCA988x Wi-Fi devices is broken in BSP 2.8b1.

Workaround: Update resp. firmware in /lib/firmware/ath10k from latest linux-firmware git.

Description: When using UBIFS image type the resulting image is not bootable. Systemd fails to mount file systems and ultimately drops into an emergency shell. The reason is that the resulting image has wrong user/group ids assigned to directories and files.

Workaround: The utility mkfs.ubifs is compiled as a 32-bit binary for the legacy image format. Make sure to remove the 32-bit flag by removing meta-toradex-(demos|bsp-common)/recipes-devtools/mtd/mtd-utils_%.bbappend.

Description: An existing OE setup updated to 2.7b4 might show the following error: ERROR: devmem2-1.0-r7 do_populate_lic: QA Issue: devmem2: The LIC_FILES_CHKSUM does not match for file://devmem2.c;endline=38;md5=a9eb9f3890384519f435aedf986297cf This is caused by a file allready in your download directory.

Workaround: Execute the following: bitbake -c cleanall devmem2

Description: Certain USB memory sticks may not work reliably behind a USB hub. Please note that some (Apalis) if not all (Colibri) USB sockets on our evaluation boards are always behind an on-carrier USB hub.

Workaround: Switch to a different carrier board without an on-carrier USB hub like Iris or Ixora, try a different brand USB memory stick or revert to a completely different update media like an SD card.

Description: Kexec and Kdump is working for the kernel branch toradex_4.14-2.3.x-imx and was successfully tested for Colibri iMX7. This feature is not working anymore with the newest Kernel.

Description: Splash screen isn't shown during boot time