For the complete documentation index, see llms.txt. This page is also available as Markdown.

i.MX8 DXL SoM Quick Start Guide

The following guide provides information about the first with i.MX8dxl SoM and its reference carrier. It covers power-on, installation of our reference OS as well as some first steps on the console.

Revision and Notes

Date
Owner
Revision
Notes

Jan 12, 2023

0

Draft

May 21, 2023

1

Initial Release

Hardware Setup

Connections

  • Micro-Fit Cable: Connect Carrier to "V2X Adapter" board.

  • USB-A male to micro-USB male cable for console access. Connect to J5 on the "V2X Adapter" board, and the PC.

  • USB-A male to USB-A male, preferably with 10kOhm resistor in VCC. Connect J1 on the "V2X Adapter" board, and the PC.

  • Connect 12V DC power source to J10 on the "V2X Adapter" board.

Picture showing all components and cables required strictly for this guide

Boot Select

Ensure S1 DIP switch on the bottom of the carrier is configured to boot from eMMC:

Switch
1
2

selected by eFuses

0

0

eMMC

0

1

USB-OTG

1

0

Console

Start an application for serial console - such as PuTTY or tio. Configure it for baud rate 115200 and the COMx or ttyUSBy interface representing the USB-A to micro-USB console connection.

Picture showing PuTTY configuration

Power On

After enabling the DC supply, messages from the bootloader should show up on the console. When in doubt press the reset button on the bottom of the carrier (S1) once while watching the console to see whether the device is alive. If the console is still quiet, likely U-Boot has not been programmed, or corrupted on the eMMC. Please refer to the developer documentation for our i.MX8DXL BSP for additional information and instructions on flashing U-Boot.

Flash OS to eMMC

New SoMs ship with U-Boot preinstalled, but without an Operating System. We provide reference images of Debian 11 to flash on eMMC. Find and download the latest emmc.img.xz at images.solid-run.com.

Ensure the USB-A to USB-A cable is connected between the PC and the device. Then:

  1. reset or power-on the device

  2. Interrupt u-boot on the console at the timeout prompt for shell access:

  3. Start USB mass storage emulation for eMMC data partition:

  4. The PC should now recognise a new USB drive. Flash the disk image using your tool of choice, e.g. etcher.io.

    Note that etcher will automatically decompress the image file. With other tools make sure to extract the .xz file first!

  5. On the U-Boot console, cancel usb mass storage emulation by pressing ctrl+c, then reboot or reset the device.

First Steps with Debian reference system

Login

After flashing the eMMC and booting into Linux, the serial console is the only accessible commandline. Simply enter "root" and press return:

USB Networking

The system is preconfigured as a USB Ethernet Gadget. Via the same USB connection used for booting and flashing the eMMC, your computer should be detecting a generic usb network interface once Linux has booted. This allows e.g. for internet connection sharing, or simple peer to peer networking. By default the system tries to acquire an IP address and DNS configuration via DHCP.

Log-In via SSH

To log in via SSH, an ssh key must be installed first. Copy your favourite public key, e.g. from ~/.ssh/id_ed25519.pub, into a new file in the root users home directory at ~/.ssh/authorized_keys:

Expand Root Filesystem

After flashing the root filesystem is smaller than the eMMC. To utilize all space, resize both the rootfs partition - and then the filesystem:

  1. inspect partitions:

    Using fdisk, view the current partitions. Take note of the start sector for partition 1!

  2. resize partition 1:

    Drop and re-create partition 1 at the same starting sector noted before, keeping the ext4 signature when prompted:

  3. resize root filesystem:

    Linux supports online-resizing for the ext4 filesystem. Invoke resize2fs on partition 1 to do so:

Additional Information

Last updated