Getting Started
QS93
First Steps
Install Quick Guide
Yocto Quick Guide
QS93-5210
Enable Display
Custom Panel
QSMP
First Steps
Install Quick Guide
Yocto Quick Guide
QSMP-2350
QSMP-2550
QSMP-1570
QSMP-1570W
QSMP-1530
QSMP-1351
QSRZ
First Steps
Install Quick Guide
Yocto Quick Guide
QSRZ-G2L0
QSRZ-G2L1
QS8M
First Steps
Install Quick Guide
Yocto Quick Guide
QS8M-MQ00
QS8M-ND00
QSXM
First Steps
Install Quick Guide
Yocto Quick Guide
QSXM-MM60
QSXP
First Steps
Install Quick Guide
Yocto Quick Guide
QSXP-ML81
TX8M
First Steps
Install Quick Guide
Yocto Quick Guide
TX8M-1610
TX8M-1620
TX8P
First Steps
Install Quick Guide
Yocto Quick Guide
TX8P-ML81
Enable Display
Custom Panel
TX93
First Steps
Install Quick Guide
Yocto Quick Guide
TX93-5210
Enable Display
Custom Panel
TXMP
First Steps
Install Quick Guide
Yocto Quick Guide
TXMP-1570
TXMP-1571
TXMP2
First Steps
Install Quick Guide
Yocto Quick Guide
TXMP-2550
TXRZ
First Steps
Install Quick Guide
Yocto Quick Guide
TXRZ-G2L0
TXRZ-G2L1
Next Steps
Next Steps Software
Next Steps Hardware
Hardware Documentation
QS-GUIDE
Concept
Unique Features
EMC Quality by Design
Advanced Soldering
Standard Pinout
Layout Guidelines
Land pattern
Solder Mask
GND Vias
Soldering Recommendations
Recommended stencil design
Solder Paste
Pick and Place
Pick offset
Thermal Considerations
Packaging
QS Standard Pinout
Power Supply, Reset and Boot mode
Power Supply
QS Operating conditions
QSX Operating conditions
NRST_PWREN - Reset and Peripheral Power Enable
QSMP
QS8M
QSX
BOOTMODE
USB
VBUS
Wiring example
USB3 Super Speed
SD Interface
Signals
SD-Card example diagram
Ethernet
Wiring example
CAN
I2C
SAI
Signals
SPI
UART
Display
Backlight and Display Control
18-bit RGB Display Interface
MIPI DSI Display
LVDS Display
Camera
PCIe
Disclaimer
Intended Audience
Acronyms and Abbreviations
TX-GUIDE
1. Concept
1.1. Disclaimer
1.2. Intended Audience
1.3. Copyright Notice
1.4. Acronyms and Abbreviations
2. Feature Overview
3. Connector Pin Assignments and Signal Descriptions
3.1. Power Supply
3.2. Reset & Bootmode
3.3. RTC & Power-Button
3.4. Ethernet Signals
3.4.1. Ethernet Physical Layer Layout Guidelines
3.4.2. Power and Ground Planes
3.4.3. 4 Layer Stackup
3.4.4. 2 Layer Stackup
3.4.5. Component Placement
3.4.6. Design Techniques for EMI Suppression
3.4.7. Controlled Impedance for Differential Signals
3.4.8. Magnetics Module
3.5. USB
3.5.1. USB Physical Layer Layout Guidelines
3.5.2. Controlled Impedance for USB Traces
3.5.3. Isolation of DP/DM Traces
3.5.4. Isolated shielding on the USB connector
3.5.5. USB recommendations
3.6. I2C
3.6.1. Example I2C Voltage Level Translator (TX27 and TX51 only)
3.6.2. I2C recommendations
3.7. PWM / 1-WIRE
3.8. CSPI - Configurable Serial Peripheral Interface
3.9. SDIO Interfaces
3.9.1. SD-Card example diagram using level shifters
3.9.2. SD-Card example diagram only for 3.3V modules
3.10. UARTs
3.10.1. UART Example diagram
3.11. Keypad Interface
3.12. Digital Audio Ports
3.13. CMOS Sensor Interface
3.14. Extended and 2nd CMOS Sensor Interface (TX51, TX53 and TX6 only)
3.15. LCD Interface
3.16. LVDS option
3.16.1. LVDS pin mapping
3.16.2. LVDS recommendations
3.16.3. USB3 pin mapping (TX8P only)
3.16.4. SATA pin mapping (TX53, TX6Q, TX6QP only)
3.16.5. SATA recommendations
3.17. CAN Interface
3.18. PCI express
3.18.1. PCI Express interface recommendations
3.18.1.1. PCI Express general routing guidelines
3.18.1.2. PCI Express coupling lane
3.18.2. PCIe recommendations
3.19. GPIO and module specific signals
3.20. TV out (TX51, TX53 only)
3.20.1. TV Encoder Recommendations
4. Optional Debugging Connector
4.1. Debug Connector Signal Assignment
4.2. Debug connector location
5. Mechanical
5.1. TX module outline
5.2. SO-DIMM connector
5.3. DIMM Connector PCB Layout example
5.4. TX Fastener Kit
5.5. TX Heatsink Kit (7 K/W)
5.5.1. Standard extruded heatsink – SK 560 – length 68mm
5.5.2. Heat conductive gel foil – GEL 28 S 25
5.6. TX Heatsink Kit (17 K/W)
5.6.1. Standard extruded heatsink – SK 473 – length 68mm
5.6.2. Heat conductive gel foil – GEL 10
5.7. TX Heat Spreader
Pinouts
QSBASE1
X1 LCD
X10 DEBUG UART
JTAG Header
Test Pad Numbering
QSBASE2
Test Pad Numbering
X7 DEBUG UART
X8 EXPANSION CONNECTOR
QSBASE3
X2 BOOTMODE
X3 DEBUG UART
X9 EXPANSION CONNECTOR
X6 MIPI DSI
X102 1st MIPI CSI
X103 2nd MIPI CSI
X101 M.2
QSBASE4
X13 BOOTMODE
X14 DEBUG UART
X7 EXPANSION CONNECTOR
X2 MIPI DSI
X8 MIPI CSI
X1 JTAG Header
QSBASE5
X12 BOOTMODE
X5 DEBUG UART
X6 EXPANSION CONNECTOR
X2 LVDS display connector
X9 MIPI CSI
X18 PCIe connector
X10 JTAG
QSBASE93
X3 USB-C
X15 USB-A
X12 BOOTMODE
X5 DEBUG UART
X6 EXPANSION CONNECTOR
X2 LVDS display connector
X9 MIPI CSI
X10 JTAG
TX-MIPI-LVDS Mainboard
X3 Header (Debug connector)
X4 Header
X9 Header
X10 Header
X11 Header
X14 Header (MIPI-CSI connector)
TX Mainboard 7
TX6UL Evaluation Kit
ST103 UART5 / CAN0
ST102 UART6 / CAN1
ST101 UART2 / UART3
ST100 UART1
ST104 MISC
ST105 LCD
TX Series Pinout Overview
QS Series Pinout Spreadsheet
Software Documentation
U-Boot
Introduction
Terminal Connection
Requirements
Terminal Program
Terminal Settings
Power-On and Reset Output
Environment
Reset of Variables
Automatically assigned variables
Configuring the network
General
DHCP
Manual IP
U-Boot Commands
Devicetree Overlays
Overview
List of Supported Baseboards
Overlay Filenames
Predefined Overlays
Automatic FDT overlay loading
FDT overlays debugging
Manually applying FDT overlays
HW Features
FDT overlays for various LCD/LVDS Displays
Building FDT Overlays with Yocto
Writing Custom Overlays
General syntax of an FDT overlay file
FDT Overlay Example
Adding overlays for a custom baseboard
Display Guide
Supported Displays
Raspberry Pi Touch Display
RGB Displays
MIPI Bridges
Texas Instruments SN65DSI83
Toshiba TC358867
Setting Display Resolution
MIPI to RGB Bridge
Loading Display DTB
STM display setting
QT Guide
Requirements
Build
Installing SDK
Installing QT Creator
Setup QT Creator
SDK
Device
Hello World
Electron
Introduction
Demo Video
Setup
Precompiled Images
Debian Setup
Yocto Setup
Start Demo Application
Remote Debugging
VS Code Cross-Compilation
Introduction
Prequisites
Get VS Code
Host Packages
Toolchain Setup
VS Code Project Setup
Project Folder
Install Extension
Sources
Settings
Cross-Compilation
Deploy to Target
Remote Debugging
Breakpoints
WiFi/BT Guide
Laird USB WiFi Module
Build
Usage
Laird PCIe WiFi Module
Introduction
Setup
Laird Devicetree
Ath9k Wifi Module
Ath9k Devicetree
Panasonic PAN9028 SDIO Wi-Fi and Bluetooth Combo module
Get drivers
Use module
Connecting WiFi
Set Up Bluetooth
Connect Bluetooth
Flashtools
Fast Flashing STM32MP1 Boards
Prerequisites
Start Fastboot
Execute UUU
Mfgtool
MFGTool Setup
Overview
Unpack MfgTool.zip
1. Execute MfgToolSetup.bat
2. Enter p/n
2.1. Installation type
3. Choosing Cutsom Files
4. MfgTool2 is Started
Adding Custom Files
Environment settings
Change mtdparts - NAND partition layout
Flashing RZ/G2L Boards
Initial Bootloader Flashing
Flashing via Fastboot
STM32CubeProgrammer
Installing STM32CubeProgrammer
USB serial link
Flash the eMMC
U-Boot Environment
UUU - Universal Update Utility
Getting uuu
udev Rules
STM32 based Modules
Usage
Running uuu
UUU with Custom Files
Creating Filesystems
Script Examples
Manual Installation
Files
Partitioning
USB Mass Storage
Host Computer
Copying a Filesystem
Copying single Files
Target Configuration
i.MX 8/9 Modules
NXP BSP
NXP Documentation
General
CPU Temperature
karo-image-weston
Test the GPU
Play a Video
Camera Guide
Camera Enablement
Camera DTB
Stream Camera
Machine Learning Guide
Introduction
Demo Video
Precompiled Images
Yocto Setup
Demos
Live Object Detection
Coral Edge TPU
Introduction
Setup
Getting Started
karo-image-ml
PyCoral Library
Run a Model on TPU
Next Steps
Cortex®-M coprocessor development for NXP processors
Installation of the MCUXpresso SDK
Tools and BSP setup
installation of the GNU Toolchain
installation of CMake
Customizing the BSP for coprocessor support
Build and run of a simple hello world application on the Cortex®-M4/7
Building the firmware
Deploying the firmware to the target
Starting the firmware
Build and run of Multicore RPMsg-Lite demo
precautions
boot M4/7 coprocessor from Tightly-Coupled Memory (TCM)
boot M4 coprocessor from DRAM on a TX8M-1610 SOM
boot M7 coprocessor from DRAM on a TX8M-ND00 SOM
boot Linux
load module
QSXP/TX8P: Build and run of Multicore RPMsg-Lite demo for CM7
precautions for the Linux build
precautions for the CM7 firmware build
kick the CM7 coprocessor from Tightly-Coupled Memory (TCM)
kick the CM7 coprocessor from DRAM on a QSXP-ML81
QS93/TX93: Build and run of Multicore RPMsg-Lite demo for CM33
precautions for the Linux build
precautions for the CM33 firmware build
boot CM33 coprocessor from Tightly-Coupled Memory (TCM)
Starting firmware using SYSFS interface
RZ/G2L Modules
Mainline BSP
General
Sleep Mode / Low Power
karo-image-weston
Test the GPU
Cortex®-M33 coprocessor development for Renesas processors
Installation of the Renesas Software packages
Setup of eval kit for CM33 debugging
Customizing the BSP for coprocessor support
Running the rpmsg demo sample from Renesas
SRAM (internal RAM)
DRAM (external RAM)
Default RZ/G2L Memory Map in the BSP
Deploying the firmware to the target
Starting the firmware from U-Boot
Starting the rpmsg_sample from Linux
STM32MP1 Modules
Mainline BSP
General
Sleep Mode / Low Power
karo-image-weston
Test the GPU
Play a Video
Cortex®-M4 development
Coprocessor Firmware Development
Coprocessor Management Overview
How to boot the Cortex® Coprocessor
How to configure system resources
Resource manager for coprocessing
Kernel Configurations needed
Device Tree Modifications needed
How to install the FDT overlay for copro support
How to use firmware sample projects of the STM32CubeMP1 package from ST
How to Control the Coprocessor from Linux
How to start the Coprocessor from the bootloader
Secure Boot
How to perform Secure Boot on QSMP-15* module
Create signature key
Copy the keys into the BSP directory
Putting signature key on the module
Set variables and build the image
STM32MP2 Modules
Camera Guide
Camera Enablement
Camera DTB
Stream Camera
Cortex®-M33 development
Coprocessor Firmware Development
STM32MP2 boot flavor
Differences Between A35-TD Flavor and M33-TD Flavor Boot Chains
A35-TD Flavor Boot Chain
M33-TD Flavor Boot Chain
How to prepare your Linux image for Cortex®-M33 Coprocessor support
How to install the FDT overlay for Coprocessor support
Deploying the firmware to the target
How to Control the Coprocessor from Linux
dynamic debugging
LVGL (Light and Versatile Graphics Library)
Building an LVGL application
Introduction
Precautions
Building the OS image
Building the SDK
Downloading and Cross-compiling the LVGL library and sample apps
Mount an NFS Share
NFS-Mount your host’s project folder on your target device
Starting the cross-compiled LVGL application on your target device
Using NXP GUI-Guider to build applications
Introduction
TX6 | TXUL
Mainline BSP
General
CPU Temperature
karo-image-weston
Test the GPU
Play a Video
Debian Guide
Debian 12
Using Flashimage
Manual installation
Build the Netinstaller Flashimage
References
BSP Setup
Setup Build Directory
Enable sstate cache
Build
Find the results
Boot the Netinstaller
Debian 12 Netinstaller Walkthrough
Debian 9
MFGTool DEBIAN-STRETCH
Environment
DTB
Kernel and kernel modules
Rootfs
MfgTool DEBIAN-NETINSTALLER
Environment
DTB
Kernel and kernel modules
Initrd RAM disk
Debian Netinstaller on TX6
1. Select language and location
2. Configure the network
3. Choose a mirror and download installer components
4. Set up users and passwords
5. Ignore partitioning warnings
6. Partitioning
7. Popularity-contest
8. Software selection
9. Ignore Grub warning
10. Continue without bootloader
Install Desktop Environment
Yocto Guide
Host Setup
Linux Virtual Machine
Enable Hyper-V
Create Virtual Machine
Change partition size
Image Deployment
Windows Subsystem for Linux (WSL)
Prerequisites
Install WSL
Check WSL version
Update
Connect USB devices
Install the USBIPD-WIN project
Attach a USB device
WSL NFS Server
Development Environment Setup
VS Code + DevContainer
Requirements
Get the repo tool
Get the BSP
Dev Container setup
Inside the Dev Container
Yocto Project BitBake Extension
NXP Yocto BSP Guide
BSP Setup
References
Requirements
Host Packages
Setting up Git
Setting up the Repo Utility
BSP Checkout
Building Images
Setup Build Directory
local.conf
Baseboards
WiFi/Bluetooth
Raspberry Pi Camera
Basler Camera
Build the Image
Getting the SDK
Image Deployment
Customizing the BSP
Create Custom Layer
Creating your own baseboard settings
Kernel & Devicetree
Menuconfig
Customizing the U-Boot Recipe
Add a custom DTB
Customizing the U-Boot configuration
Customizing the U-Boot Default Environment
Customizing the Linux Kernel Recipe
Create Custom Image
Basler Camera
Build Directory
Basler Layers
Patching Basler Layers
Building Image
Usage
Chromium
Running Chromium
NXP Documentation
Mainline Yocto BSP Guide
BSP Setup
References
Requirements
Host Packages
Setting up Git
Setting up the Repo Utility
BSP Checkout
Building Images
Setup Build Directory
local.conf
Baseboard (optional)
Machine Features
Distro Features
Raspberry Pi Camera
Build the Image
Getting the SDK
Image Deployment
QSRZ/TXRZ
QSMP/TXMP
TX6/TXUL
Customizing the BSP
Create Custom Layer
Creating your own baseboard settings
Kernel & Devicetree
Menuconfig
Customizing the U-Boot Recipe
Add a custom DTB
Customizing the U-Boot configuration
Customizing the U-Boot Default Environment
Customizing the Linux Kernel Recipe
Create Custom Image
Enable sstate cache
Sstate Cache Background
Sstate Cache Server
Verify Sstate is Working
Legacy Yocto
Yocto Thud Guide
Setup
References
Requirements
Host Packages
Setting up Git
Setting up the Repo Utility
BSP Checkout
Build Configuration
U-Boot Version
ARM® Trusted Firmware
Building an Image
Image Deployment
Enable sstate Cache
NXP Yocto Sumo Guide
Setup
References
Requirements
Host Packages
Setting up Git
Setting up the Repo Utility
BSP Checkout
Building Images
Building TX8M/QS8M Series
U-Boot Version
Building The Image
Restarting a build environment
Image Deployment
Building TX6/TXUL Series
U-Boot Hint
Building the image
Restarting a build environment
Image Deployment
Enable sstate cache
sstate cache background
sstate cache server
Verify the sstate is working
Chromium on TX8M
Running Chromium
Autostarting Chromium
Entropy problem
Creating Service
Yocto Rocko Guide
1. Setup
1.1. References
1.2. Requirements
1.3. Host packages
1.4. Upgrade git version
1.5. Setting up git
1.6. Setting up the repo utility
1.7. Yocto Project Setup
1.8. Choosing a machine
1.9. Set up the environment
1.10. U-Boot
1.11. Choosing an image target
1.12. Additional packages
1.13. Building an image target
1.14. Image Deployment
2. Enable sstate cache
2.1. sstate cache background
2.2. sstate cache server
3. Verify the sstate is working
4. Linux Kernel Version
5. Adding Layers to Yocto
If you’re new to Yocto
CRA Support Guide
Secure Updates (OTA)
RAUC
Introduction
Yocto Setup
Host Setup
Prerequisites for host PC
Building rauc for host PC from sources
Install rauc on host PC
Using rauc
Start the rauc service on the module
Create a bundle on host PC
Install the bundle on the module
HTTPS streaming of the bundle
Eclipse hawkBit™
Using Eclipse hawkBit™ as backend solution
hawkBit™ base server setup
Access hawkBit™ Management API via Swagger-UI
Control Management API via hawkBit™-UI
Custom partitioning and system.conf
SWUpdate Framework
Generating Software Bill of Materials (SBOM)
CVE Management
Yocto support
The cve-check class
The vex class
CVE mangement with open source tools
Installation of VulnScout
Secure Boot
Knowledge Base
How-To’s
Enabling USB-Bootmode
QS(X) Modules
TX Modules
Physical Pins
QSBASE1
QSBASE2
QSBASE3
QSBASE4
QSBASE5
QSBASE93
TX-(MIPI)-LVDS Mainboard
TX Mainboard 7
TXUL EvalKit
Engineering Boot Mode Details
Boot modes
Situation on the QSMP module
Situation on the TXMP module
TTL Converter Terminal Connection
Wiring
Accessing
Linux
Windows
Updating Files
USB Mass Storage
Serial Port
UUU way
Running UUU on Windows 7
Installing winusb file
Using Zadig to make UTP work
Linux WiFi Setup
1. Device Name
2. Bring up the Device
3. Scan WiFi
4. Connect
5. Optain IP
6. Test Connection
Converting ramdisk
.img
file for U-Boot
Troubleshooting
UUU USB Failures
UUU exits without displaying anything
Wait for Known USB Device Appear
TX8M-ND00 LIBUSB-HID-ERROR
Known Issues
Linux Issues
Compile errors with modern Kernel on Host
Problem:
Cause:
Workaround:
Procedure:
U-Boot Issues
Loading kernel is very slow
Problem:
Cause:
Workaround:
Procedure:
General Information
Documentation Help
Hints, Tips & Co.
Prompts
Yocto Sources Handling
Preamble
Sources in Yocto
Add-On Devices
WiFi/ Bluetooth
CAN
Camera
Display
Neural Network Processing
Frequently Asked Questions
Documentation Help
General Questions
Connecting TTL Terminal
Enabling USB Bootmode
Select Function of USBOTG port
Updating Single Files
UUU on Windows 7
Troubleshooting
UUU USB Failures
Compile Errors on Modern Kernel
Requested init /linuxrc failed
Changelog
Ka-Ro electronics GmbH
Docs
»
Yocto Guide
»
Development Environment Setup
View page source
Next
Previous
Development Environment Setup
¶
Ways to develop with Yocto.
VS Code + DevContainer
Homepage
https://karo-electronics.com
GitHub
https://github.com/karo-electronics
Related Links