CM-FX6: Linux: Automatic Installation

From Compulab Mediawiki
Jump to: navigation, search

Introduction

This article provides an installation guide for Linux kernel and Debian root file system on the CompuLab CM-FX6 System-on-Module / Computer-on-Module SSD internal storage device.

Preparation steps

  • Obtain a PC workstation with a serial communication port.
  • Download the Linux package for CM-FX6 from CompuLab website. Unzip the package to a directory on your host workstation.
  • All image files mentioned below can be found in the images subdirectory.
  • Connect the host PC to the SB-FX6 base-board (connector P8) via the serial cable supplied with the evaluation kit.
  • Continue to the Preparing installation media subsection.

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.
  • Copy all files found in the directory images from the Linux package for CM-FX6 to the first partition on the installation media (MMC/SD card).
  • Continue to the Automatic Installation Procedure section.

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 (MMC/SD card) to the SD socket (P6) on the SB-FX6
  • Turn on the CM-FX6 evaluation system.
  • The system will boot from the SD card and start the automatic installation procedure.
    Kernel release : Linux Linux 4.1.15-cm-fx6-8.0

Press any key to cancel installation   5

The Automatic Installation Procedure can be terminated by pressing any key during the timeout.

  • The installation script performs all required steps including installing Linux images onto the SSD storage device and setting up the boot environment.
Admolition note.png The Automatic Installation script cleans up the SSD device during the installation procedure. All data stored on the SSD device will be lost.
=== Mount Source /dev/mmcblk2p1 ===
* mount_source [  ]
===Installing OS===
* Updating partitions
* Formatting partitions
* mount_destination [  ]
* Copying kernel files
* Extracting user space rootfs.tar.bz2
 218MiB 0:02:49 [1.29MiB/s] [================================>] 100%            
* unmount_destination [  ]
===Updating OS===
* mount_destination [  ]
* Extracting user space kernel.update.tar.bz2
7.04MiB 0:00:04 [1.47MiB/s] [================================>] 100%            
* unmount_destination [  ]
=== Unmount Source /dev/mmcblk2p1 ===
* unmount_source [  ]
Please remove installation SD card ...
Press any key to cancel restart   0
...
  • 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:
CM-FX6 # env default -a
CM-FX6 # run bootcmd
The installer was not able to unmount the SSD and terminated with an error
  • Clean up the SSD boot area and halt the board.
# dd if=/dev/zero of=/dev/sda bs=1M count=16
# halt
  • Power on the board.
  • Press and hold Ctrl-C to get command prompt.
  • Set default U-Boot environment and boot the board:
CM-FX6 # env default -a
CM-FX6 # run bootcmd

See also