UCM-iMX7: Yocto Linux: Automatic Installation
Contents
Introduction
This article provides an installation guide for Yocto Linux on the UCM-iMX7 System-on-Module / Computer-on-Module eMMC internal storage device or NAND flash.
Preparation steps
- Obtain a PC workstation with a USB port.
 - Download the Yocto Linux package for UCM-iMX7 from CompuLab website. Unzip the package to a directory on your host workstation.
 - All image files mentioned below can be found in the install subdirectory.
 - Use the standard microUSB-to-USB cable to connect the host PC to the micro USB connector P7 on SBC-UCM-iMX7).
 - Make sure the new /dev/ttyUSBx device file is created by using the ls /dev/ttyUSB* command. x is the last number of the ttyUSB device.
 
Preparing installation media
- Obtain a micro SD card. Any commercially available micro SD card of 1GB (or larger) may be used.
 - Create a first partition on it. The partition can be formatted either ext2/3/4 or FAT file system.
 - For installation on eMMC copy all files found in the directory install from the unzipped Linux package to the first partition on the installation media (micro SD card).
 - For installation on NAND flash following files from the package directory install to the installation SD card:
- boot.scr
 - install.ext2
 - kernel.img
 - ramdisk.img
 - rootfs.tar.bz2
 - zImage
 - imx7d-sbc-ucm-imx7.dtb
 
 
Automatic Installation Procedure
- Start terminal emulation software on your PC with the following serial port settings:
 
Baud Rate Data Bits Stop Bits Parity Flow Control 115200 8 1 none none 
- Plug the installation media (SD/microSD card) into the SD socket:
- On SBC-iMX7 - SD socket P9
 - On SBC-IOT-iMX7 - micro-SD socket P18
 - On IOT-GATE-iMX7 - socket marked uSD
 
 - Turn on the system.
 - The system will boot from the SD card and start the automatic installation procedure.
 
Kernel release : Linux 4.14.98-cl-som-imx7-6.3 ===CompuLab Automatic Installation System 2.0.1 (Nov 20 2018)=== Press any key to cancel installation 0
The Automatic Installation Procedure can be terminated by pressing any key during the timeout.
- The installation script performs all necessary steps including installing Linux images onto the on-board storage device (eMMC) and setting up the boot environment.
 
| The Automatic Installation script deletes the storage device during the installation procedure. All data stored on the eMMC will be lost. | 
=== Installation Target: eMMC === * Mounting extra images * Loading extra modules ===Installing OS=== * Updating partitions * Formatting partitions * Copying kernel files * Extracting user space rootfs.tar.bz2 405MiB 0:06:37 [1.02MiB/s] [================================>] 100% * Unmounting extra images Please remove installation SD card ... Press any key to cancel restart 0 ...
- The system will reboot automatically to the newly installed Linux. Please reboot manually, if for some reason the system does not reboot automatically.
 - Please remember to remove the installation SD card.
 
Troubleshooting
- Automatic installation doesn't start.
 
The U-Boot environment should be set to default:
- Power on the board.
 - Press and hold Ctrl-C to get command prompt.
 - Set default U-Boot environment and boot the board:
 UCM-iMX7 # env default -a UCM-iMX7 # saveenv UCM-iMX7 # reset