CM-QS600: Linux: Getting started - Revision history

Ilya: /* Mount an NFS drive */

2016-01-03T13:23:28Z

‎Mount an NFS drive

Grinberg: /* Preparation steps */

2015-07-07T11:17:35Z

‎Preparation steps

Ilya: /* Install Images */

2015-05-28T10:56:14Z

‎Install Images

Grinberg: /* Install Images */

2014-12-25T08:20:08Z

‎Install Images

Grinberg: /* Install Images */

2014-09-29T10:05:46Z

‎Install Images

Show changes

Mike at 14:02, 6 August 2014

2014-08-06T14:02:40Z

Grinberg: /* See also */

2014-08-05T14:22:27Z

‎See also

New page

= Preparation steps =
* Obtain a Linux PC workstation (host).
* Make sure a {{parameter|fastboot}} utility is installed on the host machine. For more details about the {{parameter|fastboot}} utility refer to [[CM-QS600: Linux: Kernel#Getting_Fastboot|Getting Fastboot]] section of the [[CM-QS600: Linux: Kernel]] article.
* Get a USB Card reader and a micro SD Card. Use either the micro SD card, supplied with the CM-QS600 Evaluation kit, or obtain a new one.
* Plug the USB SD Card reader to a host Linux PC. Insert the micro SD Card into the USB Card reader. From now we assume the device name of the micro SD card on your Linux PC is {{filename|/dev/sdq}}.
* Download the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] from Compulab website. Unzip the package to a directory on your host workstation.
* All image files mentioned below can be found in {{filename|images}} subdirectory of the Demo package.

= Preparing micro SD card =
* Create GPT partition table and create one Linux filesystem (ext4) partition on it.
<pre>
Disk /dev/sdq: 3854336 sectors, 1.8 GiB
Logical sector size: 512 bytes
Disk identifier (GUID): 28631117-2266-4EE4-AD25-58BF5B06223B
Partition table holds up to 128 entries
First usable sector is 34, last usable sector is 3854302
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)

Number Start (sector) End (sector) Size Code Name
1 2048 3854302 1.8 GiB 8300 Linux filesystem
</pre>

The example below shows how to create the GPT table and the ext4 filesystem using {{parameter|gdisk}} and {{parameter|mkfs.ext4}} utilities respectively.
Alternatively, you can use {{parameter|gparted}} to create the GPT table and the ext4 partition.

* Create GPT partition table:
<pre>
echo -e "o\ny\nn\n\n\n8300\nw\ny\neof\n" | sudo gdisk /dev/sdq
</pre>
* Format ext4 partition:
<pre>
sudo mkfs.ext4 -L rootfs /dev/sdq1
</pre>
* Mount the partition under {{filename|/media/boot}} location:
<pre>
sudo mkdir -p /media/rootfs
sudo mount /dev/sdq1 /media/rootfs
</pre>

= Installing Linux root filesystem =
* Extract the Linux root filesystem on to the micro SD card:
<pre>
sudo tar --numeric-owner -xpf /path/to/cm-qs600-linux/images/debian-image.tar.bz2 -C /media/rootfs && sync
</pre>
* Unmount micro SD card:
<pre>
sudo umount /dev/sdq1
</pre>
* Remove the micro SD card from the SD card reader and insert it into the SB-QS600 micro SD card socket (P5).
* Continue to the [[#Installing Kernel | Installing Kernel]] section.

= Installing Kernel =
* Connect the host PC to the SB-QS600 base-board micro USB port (P7) via the USB to micro USB cable supplied with the evaluation kit.
* Connect the host PC to the SB-QS600 base-board mini USB port (P16) via the USB to mini USB cable supplied with the evaluation kit.
* Make sure the new {{filename|/dev/ttyUSBx}} device file is created by using the {cmd|ls /dev/ttyUSB*}} command. {{parameter|x}} is the last number of the ttyUSB device.
* Start the terminal emulation software on your PC's {{filename|/dev/ttyUSBx}}. Set baud rate to 115200 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
* Turn on the CM-QS600 evaluation system. The application boot-loader (LK) will start and you will get a command prompt.
* Run the following fastboot command on the host machine:
<pre>
fastboot flash boot /path/to/cm-qs600-linux/images/boot.img
</pre>
* Continue with the boot process:
<pre>
fastboot continue
</pre>
* Alternatively, power cycle the CM-QS600 evaluation system or run the following fastboot command on the host machine:
<pre>
fastboot reboot
</pre>

= See also =

* [[CM-QS600: Linux: Debian]]
* [[CM-QS600: Linux: Kernel]]
* [[Linux: Development for ARM modules]]
* [[Linux: Debian: Minimal ARM filesystem]]

[[Category:Linux]]
[[Category:CM-QS600]]

@@ Line 44: / Line 44: @@
 === Mount a USB Storage Device ===
-* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the USB storage device. Additionally, copy the proprietary firmware archive {{filename|qcom-linux-firmware.tar.bz2}} to the same location.
+* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the USB storage device. Additionally, copy the directory containing the proprietary firmware {{filename|cm-qs600-qcom-linux-firmware}} to the same location.
 * Plug the USB storage device to any USB host port (P13 or P14) on the SB-QS600.
 * The USB device is mounted automatically under /media/sdXY. Where X is the device letter and Y is the partition number.
@@ Line 55: / Line 55: @@
 === Mount an NFS drive ===
 * Connect the CM-QS600 Ethernet port (P13) to your local network.
-* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to a directory exported through NFS. Additionally, copy the proprietary firmware archive {{filename|qcom-linux-firmware.tar.bz2}} to the same location.
+* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to a directory exported through NFS. Additionally, copy the directory containing the proprietary firmware {{filename|cm-qs600-qcom-linux-firmware}} to the same location.
 * Obtain an IP address for the CM-QS600:
 ** Using DHCP:<pre>root@compulab:~# ifup `basename /sys/class/net/eth?`</pre>

@@ Line 3: / Line 3: @@
 * Make sure a {{parameter|fastboot}} utility is installed on the host machine. For more details about the {{parameter|fastboot}} utility refer to [[CM-QS600: Linux: Kernel#Getting_Fastboot|Getting Fastboot]] section of the [[CM-QS600: Linux: Kernel]] article.
 * Download the Linux package and the proprietary firmware archive for CM-QS600 from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Compulab website].
-* Please note that downloading the proprietary firmware archive requires signing the CompuLab - Qualcomm EULA. Please contact [mailto:sales@compulab.co.il CompuLab Sales Department] for further guidance.
+* Please note that downloading the proprietary firmware archive requires signing the CompuLab - Qualcomm EULA.
 * Unzip both packages to a directory on your host workstation.
 * All image files mentioned below can be found in {{filename|images}} subdirectory of the Demo package.
@@ Line 91: / Line 91: @@
 * Copy the proprietary firmware to the {{filename|/media/mmcblk0p13/lib/firmware}}:
 <pre>
-root@compulab:~# cp -a /mount/point/cm-qs600-qcom-linux-firmware/* -C /media/mmcblk0p13/lib/firmware/ && sync
+root@compulab:~# cp -a /mount/point/cm-qs600-qcom-linux-firmware/* /media/mmcblk0p13/lib/firmware/ && sync
 </pre>
 * Unmount the {{parameter|userdata}} partition:

@@ Line 2: / Line 2: @@
 * Obtain a Linux PC workstation (host).
 * Make sure a {{parameter|fastboot}} utility is installed on the host machine. For more details about the {{parameter|fastboot}} utility refer to [[CM-QS600: Linux: Kernel#Getting_Fastboot|Getting Fastboot]] section of the [[CM-QS600: Linux: Kernel]] article.
 * Download the Linux package and the proprietary firmware archive for CM-QS600 from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Compulab website].
-* The proprietary firmware archive is password protected and requires signing the CompuLab - Qualcomm EULA. Please contact [mailto:sales@compulab.co.il CompuLab Sales Department] for further guidance.
+* Please note that downloading the proprietary firmware archive requires signing the CompuLab - Qualcomm EULA. Please contact [mailto:sales@compulab.co.il CompuLab Sales Department] for further guidance.
 * Unzip both packages to a directory on your host workstation.
 * All image files mentioned below can be found in {{filename|images}} subdirectory of the Demo package.
@@ Line 34: / Line 34: @@
 === Mount a micro SD Card ===
-* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the micro SD card. The partition can be formatted either ext2/3/4 or FAT file system. Additionally, copy the proprietary firmware archive {{filename|qcom-linux-firmware.tar.bz2}} to the same location.
+* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the micro SD card. The partition can be formatted either ext2/3/4 or FAT file system. Additionally, copy the directory containing the proprietary firmware {{filename|cm-qs600-qcom-linux-firmware}} to the same location.
 * Insert the micro SD card into the SD socket (P5) on the SB-QS600 prior to booting into the installation environment.
 * The micro SD card is mounted automatically under /media/mmcblk1pX. Where X is the partition number.
@@ Line 89: / Line 89: @@
 root@compulab:~# tar --numeric-owner -xpf /mount/point/debian-image.tar.bz2 -C /media/mmcblk0p13 && sync
 </pre>
-* Extract the proprietary firmware from the {{filename|qcom-linux-firmware.tar.bz2}} archive to the {{filename|/media/mmcblk0p13/lib/firmware}}:
+* Copy the proprietary firmware to the {{filename|/media/mmcblk0p13/lib/firmware}}:
 <pre>
-root@compulab:~# tar -xpf /mount/point/qcom-linux-firmware.tar.bz2 -C /media/mmcblk0p13/lib/firmware/ && sync
+root@compulab:~# cp -a /mount/point/cm-qs600-qcom-linux-firmware/* -C /media/mmcblk0p13/lib/firmware/ && sync
 </pre>
 * Unmount the {{parameter|userdata}} partition:

@@ Line 2: / Line 2: @@
 * Obtain a Linux PC workstation (host).
 * Make sure a {{parameter|fastboot}} utility is installed on the host machine. For more details about the {{parameter|fastboot}} utility refer to [[CM-QS600: Linux: Kernel#Getting_Fastboot|Getting Fastboot]] section of the [[CM-QS600: Linux: Kernel]] article.
-* Download the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] from Compulab website. Unzip the package to a directory on your host workstation.
+* Download the Linux package and the proprietary firmware archive for CM-QS600 from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Compulab website].
 * All image files mentioned below can be found in {{filename|images}} subdirectory of the Demo package.
 * Connect the host PC to the SB-QS600 base-board micro USB port (P7) via the USB to micro USB cable supplied with the evaluation kit.
 * Connect the host PC to the SB-QS600 base-board mini USB port (P16) via the USB to mini USB cable supplied with the evaluation kit.
-* Make sure the new {{filename|/dev/ttyUSBx}} device file is created by using the {cmd|ls /dev/ttyUSB*}} command. {{parameter|x}} is the last number of the ttyUSB device.
+* Make sure the new {{filename|/dev/ttyUSBx}} device file is created by using the {{cmd|ls /dev/ttyUSB*}} command. {{parameter|x}} is the last number of the ttyUSB device.
 * Start the terminal emulation software on your PC's {{filename|/dev/ttyUSBx}}. Set baud rate to 115200 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
 * Turn on the CM-QS600 evaluation system. The application boot-loader (LK) will start and you will get a command prompt.
@@ Line 32: / Line 34: @@
 === Mount a micro SD Card ===
-* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the micro SD card. The partition can be formatted either ext2/3/4 or FAT file system.
+* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the micro SD card. The partition can be formatted either ext2/3/4 or FAT file system. Additionally, copy the proprietary firmware archive {{filename|qcom-linux-firmware.tar.bz2}} to the same location.
 * Insert the micro SD card into the SD socket (P5) on the SB-QS600 prior to booting into the installation environment.
 * The micro SD card is mounted automatically under /media/mmcblk1pX. Where X is the partition number.
@@ Line 42: / Line 44: @@
 === Mount a USB Storage Device ===
-* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the USB storage device.
+* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to the root directory of any partition on the USB storage device. Additionally, copy the proprietary firmware archive {{filename|qcom-linux-firmware.tar.bz2}} to the same location.
 * Plug the USB storage device to any USB host port (P13 or P14) on the SB-QS600.
 * The USB device is mounted automatically under /media/sdXY. Where X is the device letter and Y is the partition number.
@@ Line 53: / Line 55: @@
 === Mount an NFS drive ===
 * Connect the CM-QS600 Ethernet port (P13) to your local network.
-* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to a directory exported through NFS.
+* Copy the {{filename|boot-cm-qs600.img}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-qs600/#devres Linux package for CM-QS600] to a directory exported through NFS. Additionally, copy the proprietary firmware archive {{filename|qcom-linux-firmware.tar.bz2}} to the same location.
 * Obtain an IP address for the CM-QS600:
 ** Using DHCP:<pre>root@compulab:~# ifup `basename /sys/class/net/eth?`</pre>
@@ Line 83: / Line 85: @@
 root@compulab:~# mkdir -p /media/mmcblk0p13 && mount /dev/mmcblk0p13 /media/mmcblk0p13
 </pre>
-* Extract the content of {{filename|debian-image.tar.bz2}} onto the /media/mmcblk0p13:
+* Extract the content of {{filename|debian-image.tar.bz2}} onto the {{filename|/media/mmcblk0p13}}:
 <pre>
 root@compulab:~# tar --numeric-owner -xpf /mount/point/debian-image.tar.bz2 -C /media/mmcblk0p13 && sync
 </pre>
 * Unmount the {{parameter|userdata}} partition: