Grinberg: /* Troubleshooting */

2017-01-12T07:55:15Z

‎Troubleshooting

New page

== 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 [http://compulab.co.il/products/computer-on-modules/cm-fx6/#devres CompuLab website]. Unzip the package to a directory on your host workstation.
* All image files mentioned below can be found in the {{filename|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 | 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 {{filename|images}} from the [http://compulab.co.il/products/computer-on-modules/cm-fx6/#devres Linux package for CM-FX6] to the first partition on the installation media (MMC/SD card).
* Continue to the [[#Automatic Installation Procedure | Automatic Installation Procedure]] section.

== Automatic Installation Procedure ==
* Start terminal emulation software on your PC with the following serial port settings:
<blockquote>
{{:SB-SOM: serial port parameters table}}
</blockquote>
* 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.
<pre>
Kernel release : Linux Linux 4.1.15-cm-fx6-8.0

Press any key to cancel installation 5
</pre>
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.
{{Note| The Automatic Installation script cleans up the SSD device during the installation procedure. All data stored on the SSD device will be lost.}}
<pre>
=== 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
...
</pre>
* Please remember to remove the installation SD card.

== Troubleshooting ==
===== Automatic installation doesn't start =====
<blockquote>
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:
<pre>
CM-FX6 # env default -a
CM-FX6 # run bootcmd
</pre>
</blockquote>
===== The installer was not able to unmount the SSD and terminated with an error =====
<blockquote>
* Clean up the SSD boot area and {{cmd|halt}} the board.
<pre>
# dd if=/dev/zero of=/dev/sda bs=1M count=16
# halt
</pre>
* Power on the board.
* Press and hold Ctrl-C to get command prompt.
* Set default U-Boot environment and boot the board:
<pre>
CM-FX6 # env default -a
CM-FX6 # run bootcmd
</pre>
</blockquote>

== See also ==
* [[CM-FX6: Linux: Getting started|CM-FX6: Linux: Manual Linux installation]]
* [[CM-FX6: Linux: Debian]]
* [[CM-FX6: Linux: Kernel]]
* [[Linux Development for ARM modules]]

[[Category:Linux]]
[[Category:CM-FX6]]

CM-FX6: Linux: Automatic Installation - Revision history

Grinberg: /* Troubleshooting */