Difference between revisions of "CM-T54: Linux: Getting started"

From Compulab Mediawiki
Jump to: navigation, search
(Install on mSATA drive)
(Mount an NFS drive)
 
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
This article provides an introduction on how to install the Debian example root filesystem image on the CompuLab CM-T54 System-on-Module / Computer-on-Module eMMC internal storage device.
+
This article provides an introduction on how to install the example root filesystem image on the CompuLab CM-T54 System-on-Module / Computer-on-Module eMMC internal storage device.
  
 
== Preparation steps ==
 
== Preparation steps ==
Line 14: Line 14:
 
== Boot into the installation environment (ramdisk) ==
 
== Boot into the installation environment (ramdisk) ==
 
The first step in CM-T54 Linux installation is starting the installation environment (Linux kernel and Ramdisk image).  
 
The first step in CM-T54 Linux installation is starting the installation environment (Linux kernel and Ramdisk image).  
This can be done using the following media:
+
This can be done using one of the following media:
 
* [[#Using installation environment on MMC/SD card|MMC/SD card]]
 
* [[#Using installation environment on MMC/SD card|MMC/SD card]]
 
* [[#Using installation environment from USB storage device|USB storage device]]
 
* [[#Using installation environment from USB storage device|USB storage device]]
Line 20: Line 20:
  
 
=== Using installation environment on MMC/SD card ===
 
=== Using installation environment on MMC/SD card ===
* Copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to the root directory on the first partition of the MMC/SD card.
+
* Copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from {{cmd|images/install_env}} sub-directory of [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to the root directory on the first partition of the MMC/SD card.
 
* Insert the MMC/SD card into the MMC/SD socket (P9) on the SB-T54 baseboard and reset the module.
 
* Insert the MMC/SD card into the MMC/SD socket (P9) on the SB-T54 baseboard and reset the module.
 
* The installation environment boot will start automatically.
 
* The installation environment boot will start automatically.
Line 30: Line 30:
 
CM-T54 # source 0x82000000
 
CM-T54 # source 0x82000000
 
</pre>
 
</pre>
* Continue to the [[#Install Kernel and Debian Linux Images | Install Kernel and Debian Linux Images]] section.
+
* Continue to the [[#Install Kernel and Root File System Images | Install Kernel and Root File System Images ]] section.
  
 
=== Using installation environment from USB storage device ===
 
=== Using installation environment from USB storage device ===
* Copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to the root directory on the first partition of the USB storage device.
+
* Copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from {{cmd|images/install_env}} sub-directory of [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to the root directory on the first partition of the USB storage device.
  
 
* Insert USB storage device into SB-T54 USB port (P25 or P26).
 
* Insert USB storage device into SB-T54 USB port (P25 or P26).
Line 44: Line 44:
 
</pre>
 
</pre>
  
* Continue to the [[#Install Kernel and Debian Linux Images | Install Kernel and Debian Linux Images]] section.
+
* Continue to the [[#Install Kernel and Root File System Images | Install Kernel and Root File System Images ]] section.
  
 
=== Using installation environment from TFTP server ===
 
=== Using installation environment from TFTP server ===
 
* Connect the SB-T54 Ethernet port to your local network.
 
* Connect the SB-T54 Ethernet port to your local network.
* Put {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, and {{filename|ramdisk.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to a location accessible by the TFTP server:
+
* Put {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, and {{filename|ramdisk.img}} from {{cmd|images/install_env}} sub-directory of [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to a location accessible by the TFTP server:
 
*: - On Windows machine: copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, and {{filename|ramdisk.img}} to the same folder and point the TFTP server to that folder
 
*: - On Windows machine: copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, and {{filename|ramdisk.img}} to the same folder and point the TFTP server to that folder
 
*: - On Linux machine: copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, and {{filename|ramdisk.img}} to TFTP server root directory, usually {{filename|/tftpboot}} or {{filename|/tftproot}}.
 
*: - On Linux machine: copy {{filename|kernel.img}}, {{filename|omap5-sbc-t54.dtb}}, and {{filename|ramdisk.img}} to TFTP server root directory, usually {{filename|/tftpboot}} or {{filename|/tftproot}}.
Line 73: Line 73:
 
</pre>
 
</pre>
  
* Continue to the [[#Install Kernel and Debian Linux Images | Install Kernel and Debian Linux Images]] section.
+
* Continue to the [[#Install Kernel and Root File System Images | Install Kernel and Root File System Images ]] section.
  
=== Install Kernel and Debian Linux Images ===
+
=== Install Kernel and Root File System  Images ===
 
After the ramdisk image is loaded the Linux login prompt will appear. Login as {{parameter|root}} into the system.
 
After the ramdisk image is loaded the Linux login prompt will appear. Login as {{parameter|root}} into the system.
 
<pre>
 
<pre>
Line 83: Line 83:
 
==== Mount the installation source media ====
 
==== Mount the installation source media ====
  
The next step is installing the kernel and Debian Linux images. The following media can be used as a source for installation:
+
The next step is installing the kernel and Root File System images. The following media can be used as a source for installation:
 
* [[#Mount an MMC/SD Card|MMC/SD Card]]
 
* [[#Mount an MMC/SD Card|MMC/SD Card]]
 
* [[#Mount a USB Storage Device|USB storage device]]
 
* [[#Mount a USB Storage Device|USB storage device]]
Line 89: Line 89:
  
 
===== Mount an MMC/SD Card =====
 
===== Mount an MMC/SD Card =====
* Copy the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to the root directory of any partition on the MMC/SD card. The partition can be formatted either ext2/3/4 or FAT file system.
+
* Choose the kernel and root file system image provided by [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54]:
 +
** For CM-T54 Linux release, based on Kernel '''v3.8.13''' use the '''{{filename|images/v3.8.13-cm-t54-5}}''' sub-directory and the {{filename|arago-project-image.tar.bz2}} root file system archive.
 +
*: '''or'''
 +
** For CM-T54 Linux release, based on Kernel '''v4.0.5''' use the '''{{filename|images/v4.0.5-cm-t54-5}}''' sub-directory and the {{filename|debian-image.tar.bz2}} root file system archive.
 +
* Copy the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the '''''root file system archive''''' to the root directory of any partition on the MMC/SD card. The partition can be formatted either ext2/3/4 or FAT file system.
 
* Insert the MMC/SD card into the SD socket (P9) on the SB-T54.
 
* Insert the MMC/SD card into the SD socket (P9) on the SB-T54.
 
* The MMC/SD card is mounted automatically under /media/mmcblk0pX. Where X is the partition number.
 
* The MMC/SD card is mounted automatically under /media/mmcblk0pX. Where X is the partition number.
Line 99: Line 103:
  
 
===== Mount a USB Storage Device =====
 
===== Mount a USB Storage Device =====
* Copy the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the {{filename|debian-image.tar.bz2}} from [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to the root directory of any partition on the USB storage device.
+
* Choose the kernel and root file system image provided by [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54]:
 +
** For CM-T54 Linux release, based on Kernel '''v3.8.13''' use the '''{{filename|images/v3.8.13-cm-t54-5}}''' sub-directory and the {{filename|arago-project-image.tar.bz2}} root file system archive.
 +
*: '''or'''
 +
** For CM-T54 Linux release, based on Kernel '''v4.0.5''' use the '''{{filename|images/v4.0.5-cm-t54-5}}''' sub-directory and the {{filename|debian-image.tar.bz2}} root file system archive.
 +
* Copy the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the '''''root file system archive''''' to the root directory of any partition on the USB storage device. The partition can be formatted either ext2/3/4 or FAT file system.
 
* Plug the USB storage device to any USB host port (P25 or P26) on the SB-T54.
 
* Plug the USB storage device to any USB host port (P25 or P26) on the SB-T54.
 
* The USB device is mounted automatically under /media/sdXY. Where X is the device letter and Y is the partition number.
 
* The USB device is mounted automatically under /media/sdXY. Where X is the device letter and Y is the partition number.
Line 110: Line 118:
 
===== Mount an NFS drive =====
 
===== Mount an NFS drive =====
 
* Connect the CM-T54 Ethernet port (P13) to your local network.
 
* Connect the CM-T54 Ethernet port (P13) to your local network.
* Copy the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the {{filename|debian-image.tar.bz2}} from the [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54] to a directory exported through NFS.
+
* Choose the kernel and root file system image provided by [http://compulab.co.il/products/computer-on-modules/cm-t54/#devres Linux package for CM-T54]:
 +
** For CM-T54 Linux release, based on Kernel '''v3.8.13''' use the '''{{filename|images/v3.8.13-cm-t54-5}}''' sub-directory and the {{filename|arago-project-image.tar.bz2}} root file system archive.
 +
*: '''or'''
 +
** For CM-T54 Linux release, based on Kernel '''v4.0.5''' use the '''{{filename|images/v4.0.5-cm-t54-5}}''' sub-directory and the {{filename|debian-image.tar.bz2}} root file system archive.
 +
* Copy the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the '''''root file system archive''''' to a directory exported through NFS.
 
* During Ramdisk image booting the CM-T54 attempts to obtain an IP address using DHCP. If from some reason the IP address has not been obtained, use the following commands to obtain IP address for the CM-T54:
 
* During Ramdisk image booting the CM-T54 attempts to obtain an IP address using DHCP. If from some reason the IP address has not been obtained, use the following commands to obtain IP address for the CM-T54:
 
** Obtain IP using DHCP:<pre>root@compulab:~# ifup eth0</pre>
 
** Obtain IP using DHCP:<pre>root@compulab:~# ifup eth0</pre>
 +
*: '''or'''
 
** If there is no DHCP server on the network, you can set a static IP address using {{cmd|ifconfig}}:<pre>root@compulab:~# ifconfig eth0 <ip address></pre>
 
** If there is no DHCP server on the network, you can set a static IP address using {{cmd|ifconfig}}:<pre>root@compulab:~# ifconfig eth0 <ip address></pre>
 
* Mount the NFS share containing the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the {{filename|debian-image.tar.bz2}} files:
 
* Mount the NFS share containing the {{filename|zImage-cm-t54}}, {{filename|omap5-sbc-t54.dtb}} and the {{filename|debian-image.tar.bz2}} files:
Line 150: Line 163:
 
root@compulab:~# cp /mount/point/zImage-cm-t54 /mount/point/omap5-sbc-t54.dtb /media/mmcblk0p1 && sync
 
root@compulab:~# cp /mount/point/zImage-cm-t54 /mount/point/omap5-sbc-t54.dtb /media/mmcblk0p1 && sync
 
</pre>
 
</pre>
* Extract the content of {{filename|debian-image.tar.bz2}} onto the second partition:
+
* Extract the content of the '''''root file system archive''''' onto the second partition:
<pre>
+
** For CM-T54 Linux release, based on Kernel '''v3.8.13''' use {{filename|arago-project-image.tar.bz2}}:
root@compulab:~# tar --numeric-owner -xvpjf /mount/point/debian-image.tar.bz2 -C /media/mmcblk0p2 && sync
+
*: <pre>root@compulab:~# tar --numeric-owner -xvpjf /mount/point/arago-project-image.tar.bz2 -C /media/mmcblk0p2 && sync</pre>
</pre>
+
*: '''or'''
 +
** For CM-T54 Linux release, based on Kernel '''v4.0.5''' use {{filename|debian-image.tar.bz2}}:
 +
*: <pre>root@compulab:~# tar --numeric-owner -xvpjf /mount/point/debian-image.tar.bz2 -C /media/mmcblk0p2 && sync</pre>
 +
 
 
* Remove MMC/SD card from SB-T54 MMC/SD card socket (if used for installation) and reboot the module:
 
* Remove MMC/SD card from SB-T54 MMC/SD card socket (if used for installation) and reboot the module:
 
<pre>
 
<pre>
Line 160: Line 176:
  
 
==== Install on mSATA drive ====
 
==== Install on mSATA drive ====
{{Note|The below procedure will work only on empty mSATA drive. If you have already used the drive, please delete all the partitions before proceeding.}}
+
{{Note|The below procedure will work only on empty mSATA drive. If you have already used the drive, please delete all the partitions before proceeding.
 +
Installation on mSATA drive is currently supported for CM-T54 Linux release, based on Kernel '''v4.0.5''' only. }}
 
* In this subsection the term {{filename|/mount/point}} can be:
 
* In this subsection the term {{filename|/mount/point}} can be:
 
** {{filename|/mnt/net}} if NFS is used
 
** {{filename|/mnt/net}} if NFS is used
Line 203: Line 220:
 
== After Installation ==
 
== After Installation ==
  
==== Select video out ====
+
=== Video Output ===
 
 
CM-T54 supports four video output devices: HDMI, DVI, LCD, LVDS. All of them are enabled by default.
 
Current version of Xorg driver of CM-T54 example root file system supports mirror video output mode only.
 
It causes last registered video output device (LVDS) resolution to be propagated to other devices.
 
 
 
  
In order to force a specific video output device to be selected as a primary device the U-Boot environment variables should be adjusted:
+
CM-T54 evaluation platform has four video output interfaces: LCD, DVI, LVDS and HDMI.
 +
Configuring a specific video output may vary depending on the kernel version release.
  
* HDMI/DVI output enabled (LCD/LVDS disabled)
+
The following articles describe video output configuration:
  
<pre>
+
* [[CM-T54: Linux: Debian#Display options |Display options]] for kernel '''v4.0.5'''
CM-T54 # setenv mmcloadfdt 'load mmc ${mmcdev} ${fdtaddr} ${fdtfile}; run fdt_adjust_video;'
+
* [[CM-T54: Linux: Arago Project#Display options |Display options]] for kernel '''v3.8.8'''
CM-T54 # setenv fdt_adjust_video 'fdt addr ${fdtaddr}; run fdt_disable_lvds; run fdt_disable_lcd'
 
CM-T54 # setenv fdt_disable_lvds 'fdt set /ocp/dss/encoder@58004000 status "disabled"; fdt rm /ocp/i2c@48070000/sn65dsi83@2c; fdt rm /aliases display3;'
 
CM-T54 # setenv fdt_disable_lcd 'fdt rm /display; fdt rm /ocp/dss/port/endpoint@1; fdt rm /aliases display2;'
 
CM-T54 # saveenv
 
</pre>
 
 
 
* LCD output enabled (LVDS disabled)
 
 
 
<pre>
 
CM-T54 # setenv mmcloadfdt 'load mmc ${mmcdev} ${fdtaddr} ${fdtfile}; run fdt_adjust_video;'
 
CM-T54 # setenv fdt_adjust_video 'fdt addr ${fdtaddr}; run fdt_disable_lvds'
 
CM-T54 # setenv fdt_disable_lvds 'fdt set /ocp/dss/encoder@58004000 status "disabled"; fdt rm /ocp/i2c@48070000/sn65dsi83@2c; fdt rm /aliases display3;'
 
CM-T54 # saveenv
 
</pre>
 
 
 
* Default settings
 
 
 
<pre>
 
CM-T54 # setenv mmcloadfdt 'load mmc ${mmcdev} ${fdtaddr} ${fdtfile};'
 
CM-T54 # saveenv
 
</pre>
 
  
 
=== Boot from mSATA drive ===
 
=== Boot from mSATA drive ===
 +
{{Note|Booting from mSATA drive is currently supported for CM-T54 Linux release, based on Kernel '''v4.0.5''' only. }}
 
* Set the {{parameter|bootargs}} environment variable:
 
* Set the {{parameter|bootargs}} environment variable:
 
<pre>
 
<pre>
Line 254: Line 247:
  
 
* [[CM-T54: Linux: Debian]]
 
* [[CM-T54: Linux: Debian]]
 +
* [[CM-T54: Linux: Arago Project]]
 
* [[CM-T54: Linux: Kernel]]
 
* [[CM-T54: Linux: Kernel]]
 
* [[Linux Development for ARM modules]]
 
* [[Linux Development for ARM modules]]

Latest revision as of 13:44, 18 June 2015

Introduction

This article provides an introduction on how to install the example root filesystem image on the CompuLab CM-T54 System-on-Module / Computer-on-Module eMMC internal storage device.

Preparation steps

  • Obtain a PC workstation with a serial communication port.
  • For networked installation you need to install a TFTP server on the host PC. For Windows machines we recommend TFTPD32 included in the Linux package for CM-T54 (link below).
  • Download the Linux package for CM-T54 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-T54 base-board (connector P11) via the serial cable supplied with the evaluation kit.
  • Start terminal emulation software on your PC. Set baud rate to 115200 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
  • Turn on the CM-T54 evaluation system. The U-Boot boot-loader will start and you will get a command prompt.
Admolition note.png If the boot settings of your CM-T54 are different than default, you may need to press and hold Ctrl-C while turning the CM-T54 on, in order to get command prompt.

Boot into the installation environment (ramdisk)

The first step in CM-T54 Linux installation is starting the installation environment (Linux kernel and Ramdisk image). This can be done using one of the following media:

Using installation environment on MMC/SD card

  • Copy kernel.img, omap5-sbc-t54.dtb, ramdisk.img and bootscr.img from images/install_env sub-directory of Linux package for CM-T54 to the root directory on the first partition of the MMC/SD card.
  • Insert the MMC/SD card into the MMC/SD socket (P9) on the SB-T54 baseboard and reset the module.
  • The installation environment boot will start automatically.
  • To start installation environment boot manually, use the following U-Boot commands:
CM-T54 # mmc dev 0
CM-T54 # mmc rescan
CM-T54 # load mmc 0 0x82000000 bootscr.img
CM-T54 # source 0x82000000

Using installation environment from USB storage device

  • Copy kernel.img, omap5-sbc-t54.dtb, ramdisk.img and bootscr.img from images/install_env sub-directory of Linux package for CM-T54 to the root directory on the first partition of the USB storage device.
  • Insert USB storage device into SB-T54 USB port (P25 or P26).
  • Remove MMC/SD card from the MMC/SD socket (P9) on the SB-T54 baseboard.
  • Use the following U-Boot commands to start installation environment boot:
CM-T54 # usb start
CM-T54 # load usb 0 0x82000000 bootscr.img
CM-T54 # source 0x82000000

Using installation environment from TFTP server

  • Connect the SB-T54 Ethernet port to your local network.
  • Put kernel.img, omap5-sbc-t54.dtb, and ramdisk.img from images/install_env sub-directory of Linux package for CM-T54 to a location accessible by the TFTP server:
    - On Windows machine: copy kernel.img, omap5-sbc-t54.dtb, and ramdisk.img to the same folder and point the TFTP server to that folder
    - On Linux machine: copy kernel.img, omap5-sbc-t54.dtb, and ramdisk.img to TFTP server root directory, usually /tftpboot or /tftproot.
  • Initialize CM-T54 Ethernet controller:
CM-T54 # usb start
  • You can use U-boot dhcp command to obtain IP address
CM-T54 # dhcp
or manually set ipaddr environment variable:
CM-T54 # setenv ipaddr <CM-T54 ip address>
  • Use the following U-Boot commands to start installation environment boot:
CM-T54 # setenv bootargs "root=/dev/ram0 rw ramdisk_size=16384 console=ttyO3,115200n8 vram=16M ip=dhcp"
CM-T54 # tftpboot 0x88000000 omap5-sbc-t54.dtb
CM-T54 # tftpboot 0x82000000 kernel.img
CM-T54 # tftpboot 0x88080000 ramdisk.img
CM-T54 # bootz 0x82000000 0x88080000 0x88000000

Install Kernel and Root File System Images

After the ramdisk image is loaded the Linux login prompt will appear. Login as root into the system.

compulab login: root

Mount the installation source media

The next step is installing the kernel and Root File System images. The following media can be used as a source for installation:

Mount an MMC/SD Card
  • Choose the kernel and root file system image provided by Linux package for CM-T54:
    • For CM-T54 Linux release, based on Kernel v3.8.13 use the images/v3.8.13-cm-t54-5 sub-directory and the arago-project-image.tar.bz2 root file system archive.
    or
    • For CM-T54 Linux release, based on Kernel v4.0.5 use the images/v4.0.5-cm-t54-5 sub-directory and the debian-image.tar.bz2 root file system archive.
  • Copy the zImage-cm-t54, omap5-sbc-t54.dtb and the root file system archive to the root directory of any partition on the MMC/SD card. The partition can be formatted either ext2/3/4 or FAT file system.
  • Insert the MMC/SD card into the SD socket (P9) on the SB-T54.
  • The MMC/SD card is mounted automatically under /media/mmcblk0pX. Where X is the partition number.
  • If for some reason the MMC/SD card hasn't been mounted automatically, use the following mount command:
root@compulab:~# mkdir -p /media/mmcblk0pX && mount /dev/mmcblk0pX /media/mmcblk0pX
Mount a USB Storage Device
  • Choose the kernel and root file system image provided by Linux package for CM-T54:
    • For CM-T54 Linux release, based on Kernel v3.8.13 use the images/v3.8.13-cm-t54-5 sub-directory and the arago-project-image.tar.bz2 root file system archive.
    or
    • For CM-T54 Linux release, based on Kernel v4.0.5 use the images/v4.0.5-cm-t54-5 sub-directory and the debian-image.tar.bz2 root file system archive.
  • Copy the zImage-cm-t54, omap5-sbc-t54.dtb and the root file system archive to the root directory of any partition on the USB storage device. The partition can be formatted either ext2/3/4 or FAT file system.
  • Plug the USB storage device to any USB host port (P25 or P26) on the SB-T54.
  • The USB device is mounted automatically under /media/sdXY. Where X is the device letter and Y is the partition number.
  • If for some reason the USB storage device hasn't been mounted automatically, use the following mount command:
root@compulab:~# mkdir -p /media/sdXY && mount /dev/sdXY /media/sdXY
Mount an NFS drive
  • Connect the CM-T54 Ethernet port (P13) to your local network.
  • Choose the kernel and root file system image provided by Linux package for CM-T54:
    • For CM-T54 Linux release, based on Kernel v3.8.13 use the images/v3.8.13-cm-t54-5 sub-directory and the arago-project-image.tar.bz2 root file system archive.
    or
    • For CM-T54 Linux release, based on Kernel v4.0.5 use the images/v4.0.5-cm-t54-5 sub-directory and the debian-image.tar.bz2 root file system archive.
  • Copy the zImage-cm-t54, omap5-sbc-t54.dtb and the root file system archive to a directory exported through NFS.
  • During Ramdisk image booting the CM-T54 attempts to obtain an IP address using DHCP. If from some reason the IP address has not been obtained, use the following commands to obtain IP address for the CM-T54:
    • Obtain IP using DHCP:
      root@compulab:~# ifup eth0
    or
    • If there is no DHCP server on the network, you can set a static IP address using ifconfig:
      root@compulab:~# ifconfig eth0 <ip address>
  • Mount the NFS share containing the zImage-cm-t54, omap5-sbc-t54.dtb and the debian-image.tar.bz2 files:
root@compulab:~#  mount -o nolock <host ip>:/path/to/nfs/share /mnt/net

Install Images on eMMC

Admolition note.png The below procedure will work only on empty eMMC chip. If you have already used the eMMC, please delete all the partitions before proceeding.
  • In this subsection the term /mount/point can be:
    • /mnt/net if NFS is used
    • /media/mmcblk0pX if an MMC/SD card is used, where X is the partition number.
    • /media/sdXY if USB storage is used, where X is the USB drive letter and Y is the partition number.
  • Create two partitions for the Linux kernel (FAT32 100M) and root file system (EXT4 the rest of the disk) on the eMMC:
root@compulab:~# echo -e "n\np\n1\n2048\n204800\na\n1\nt\nc\nn\np\n2\n204801\n\nw\neof\n" | fdisk -u /dev/mmcblk0
  • Refresh the device nodes:
root@compulab:~# mdev -s && umount /dev/mmcblk0p1 && umount /dev/mmcblk0p2
  • Format the first partition with FAT32 file system:
root@compulab:~# mkfs.vfat -n boot /dev/mmcblk0p1
  • Format the second partition with EXT4 file system:
root@compulab:~# mkfs.ext4 /dev/mmcblk0p2
  • Mount both partitions:
root@compulab:~# mkdir -p /media/mmcblk0p1 && mount /dev/mmcblk0p1 /media/mmcblk0p1
root@compulab:~# mkdir -p /media/mmcblk0p2 && mount /dev/mmcblk0p2 /media/mmcblk0p2
  • Copy the zImage-cm-t54 and the omap5-sbc-t54.dtb to the first (FAT) partition:
root@compulab:~# cp /mount/point/zImage-cm-t54 /mount/point/omap5-sbc-t54.dtb /media/mmcblk0p1 && sync
  • Extract the content of the root file system archive onto the second partition:
    • For CM-T54 Linux release, based on Kernel v3.8.13 use arago-project-image.tar.bz2:
    root@compulab:~# tar --numeric-owner -xvpjf /mount/point/arago-project-image.tar.bz2 -C /media/mmcblk0p2 && sync
    or
    • For CM-T54 Linux release, based on Kernel v4.0.5 use debian-image.tar.bz2:
    root@compulab:~# tar --numeric-owner -xvpjf /mount/point/debian-image.tar.bz2 -C /media/mmcblk0p2 && sync
  • Remove MMC/SD card from SB-T54 MMC/SD card socket (if used for installation) and reboot the module:
root@compulab:~# reboot

Install on mSATA drive

Admolition note.png The below procedure will work only on empty mSATA drive. If you have already used the drive, please delete all the partitions before proceeding.

Installation on mSATA drive is currently supported for CM-T54 Linux release, based on Kernel v4.0.5 only.

  • In this subsection the term /mount/point can be:
    • /mnt/net if NFS is used
    • /media/mmcblk0pX if an MMC/SD card is used, where X is the partition number.
    • /media/sdXY if USB storage is used, where X is the USB drive letter and Y is the partition number.
  • Identify mSATA drive special device file
export SATA_DRIVE=/dev/`basename /sys/devices/44000000.ocp/4a140000.sata/ata1/host0/target0:0:0/0:0:0:0/block/sd?`
  • Create two partitions for the Linux kernel (FAT32 100M) and root file system (EXT4 the rest of the disk) on mSATA drive:
root@compulab:~# echo -e "n\np\n1\n\n+100M\na\n1\nt\nc\nn\np\n2\n\n\nw\neof\n" | fdisk ${SATA_DRIVE}
  • Format the first partition with FAT32 file system:
root@compulab:~# mkfs.vfat -n boot ${SATA_DRIVE}1
  • Format the second partition with EXT4 file system:
root@compulab:~# mkfs.ext4 ${SATA_DRIVE}2
  • Mount both partitions:
root@compulab:~# mkdir -p /media/boot && mount ${SATA_DRIVE}1 /media/boot
root@compulab:~# mkdir -p /media/rootfs && mount ${SATA_DRIVE}2 /media/rootfs
  • Copy the zImage-cm-t54 and the omap5-sbc-t54.dtb to the first (FAT) partition:
root@compulab:~# cp /mount/point/zImage-cm-t54 /mount/point/omap5-sbc-t54.dtb /media/boot && sync
  • Extract the content of debian-image.tar.bz2 onto the second partition:
root@compulab:~# tar --numeric-owner -xvpjf /mount/point/debian-image.tar.bz2 -C /media/rootfs && sync
  • Reboot the module:
root@compulab:~# reboot

After Installation

Video Output

CM-T54 evaluation platform has four video output interfaces: LCD, DVI, LVDS and HDMI. Configuring a specific video output may vary depending on the kernel version release.

The following articles describe video output configuration:

Boot from mSATA drive

Admolition note.png Booting from mSATA drive is currently supported for CM-T54 Linux release, based on Kernel v4.0.5 only.
  • Set the bootargs environment variable:
CM-T54 # setenv bootargs "root=/dev/sda2 rootfstype=ext4 rw rootwait console=ttyO3"
  • To boot Linux, type:
CM-T54 # setenv bootdelay 3
CM-T54 # setenv bootcmd 'load scsi 0 ${loadaddr} zImage-cm-t54 && load scsi 0 ${fdtaddr} omap5-sbc-t54.dtb && bootz ${loadaddr} - ${fdtaddr}'
CM-T54 # saveenv
CM-T54 # boot

See also