Difference between revisions of "CL-SOM-iMX7: Linux: Automatic Installation"
(→Troubleshooting) |
imported>Igor.vaisbein (→Introduction) |
||
(6 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
== Introduction == | == Introduction == | ||
− | This article provides an installation guide for Linux kernel and Debian root file system on the CompuLab CL-SOM-iMX7 System-on-Module / Computer-on-Module | + | This article provides an installation guide for Linux kernel and Debian root file system on the CompuLab CL-SOM-iMX7 System-on-Module / Computer-on-Module internal storage device, either eMMC or NAND flash. |
+ | {{Note|Current demo root filesystem image provided by CompuLab is NOT designed for installation onto the 128MB/1GB NAND flash and will not fit these storage options. For 128MB/1GB NAND flash the following installation procedure assumes properly sized root filesystem image.}} | ||
== Preparation steps == | == Preparation steps == | ||
* Obtain a PC workstation with a serial communication port. | * Obtain a PC workstation with a serial communication port. | ||
− | * Download the | + | * Download the BSP binary package for CL-SOM-iMX7 from [http://www.compulab.com/products/computer-on-modules/cl-som-imx7-freescale-i-mx-7-system-on-module/#devres CompuLab website]. Unzip the package to a directory on your host workstation. |
− | * All image files mentioned below can be found in the {{filename| | + | * All image files mentioned below can be found in the {{filename|install}} subdirectory. |
* Connect the host PC to the SBC-iMX7 base-board (connector P8) via the serial cable supplied with the evaluation kit. | * Connect the host PC to the SBC-iMX7 base-board (connector P8) via the serial cable supplied with the evaluation kit. | ||
− | * Continue to the [[#Preparing installation media | Preparing installation media]] subsection. | + | <!--* Continue to the [[#Preparing installation media | Preparing installation media]] subsection.--> |
=== Preparing installation media === | === Preparing installation media === | ||
* Obtain an MMC/SD card. Any commercially available MMC/SD card of 1GB (or larger) may be used. | * Obtain an MMC/SD card. Any commercially available MMC/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. | * Create a first partition on it. The partition can be formatted either ext2/3/4 or FAT file system. | ||
− | * | + | * For installation on eMMC storage copy all files found in the directory {{filename|install}} from the [http://www.compulab.com/products/computer-on-modules/cl-som-imx7-freescale-i-mx-7-system-on-module/#devres BSP binary package for CL-SOM-iMX7] to the first partition on the installation media (MMC/SD card). |
− | * Continue to the [[#Automatic Installation Procedure | Automatic Installation Procedure]] section. | + | * For installation on NAND flash, copy the following files from the package directory {{filename|install}} to the installation SD card: |
+ | ** {{filename|boot.scr}} | ||
+ | ** {{filename|config}} | ||
+ | ** {{filename|install.ext2}} | ||
+ | ** {{filename|firmware.ext2}} | ||
+ | ** {{filename|modules.ext2}} | ||
+ | ** {{filename|kernel.img}} | ||
+ | ** {{filename|ramdisk.img}} | ||
+ | ** {{filename|rootfs.tar.bz2}} - please use a properly sized root filesystem image | ||
+ | ** {{filename|zImage}} | ||
+ | ** {{filename|imx7d-sbc-imx7.dtb}} | ||
+ | {{Note|Please do not use multiple ''*.dtb'' files for installation on NAND flash.}} | ||
+ | <!--* Continue to the [[#Automatic Installation Procedure | Automatic Installation Procedure]] section.--> | ||
== Automatic Installation Procedure == | == Automatic Installation Procedure == | ||
− | + | {{:Transclusion: CL-SOM-iMX7: Linux: Automatic Installation: Procedure}} | |
− | |||
− | {{: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Troubleshooting == | == Troubleshooting == |
Latest revision as of 08:55, 16 February 2020
Contents
Introduction
This article provides an installation guide for Linux kernel and Debian root file system on the CompuLab CL-SOM-iMX7 System-on-Module / Computer-on-Module internal storage device, either eMMC or NAND flash.
Preparation steps
- Obtain a PC workstation with a serial communication port.
- Download the BSP binary package for CL-SOM-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.
- Connect the host PC to the SBC-iMX7 base-board (connector P8) via the serial cable supplied with the evaluation kit.
Preparing installation media
- Obtain an MMC/SD card. Any commercially available MMC/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 storage copy all files found in the directory install from the BSP binary package for CL-SOM-iMX7 to the first partition on the installation media (MMC/SD card).
- For installation on NAND flash, copy the following files from the package directory install to the installation SD card:
- boot.scr
- config
- install.ext2
- firmware.ext2
- modules.ext2
- kernel.img
- ramdisk.img
- rootfs.tar.bz2 - please use a properly sized root filesystem image
- zImage
- imx7d-sbc-imx7.dtb
![]() |
Please do not use multiple *.dtb files for installation on NAND flash. |
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:
CL-SOM-iMX7 # env default -a CL-SOM-iMX7 # saveenv CL-SOM-iMX7 # reset