Difference between revisions of "CM-T3530: Linux: Angstrom"

From Compulab Mediawiki
Jump to: navigation, search
(Package contents)
(Digital Video SDK)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
== Introduction ==
+
= Introduction =
 +
The example run-time Linux filesystem image for CM-T3530 is based on Angstrom Linux 2010.
 +
The [http://compulab.co.il/products/computer-on-modules/cm-t3530/#devres CompuLab Linux package for CM-T3530] includes ready to run Angstrom Linux filesystem image, Linux kernel and source code patches.
  
The example run-time Linux filesystem image for CM-T3530 is based on Angstrom Linux 2009. The [http://www.compulab.co.il/t3530/download/t3530-linux.zip CompuLab Linux package for CM-T3530] includes ready to run NAND flash image, Linux kernel configuration and source code patches, and OpenEmbedded configuration files used to build the Angstrom Linux filesystem image.
+
The default Angstrom Linux image includes more than 1000 software packages. Among them:
 
 
The default Angstrom Linux image takes approximately 250 megabytes of flash space, and includes more than 1000 software packages. Among them:
 
 
* Core system
 
* Core system
 
* X11 Windowing System
 
* X11 Windowing System
* Enlightment E17 desktop manager
+
* Enlightenment v0.16 desktop manager
* Firefox and Midory web browsers
+
* Midory web browser
* Office applications
+
* Totem and MPlayer media players
* GIMP
+
* GStreamer with multiple plugins
* Totem, MPlayer and omapfbplay media players
+
* The Graphics SDK version 4.05.00.03 including the Linux graphics (SGX) drivers and ready to run SGX functionality demos
  
The [[CM-T3530: Linux: Getting started|Getting started with Linux on CM-T3530]] page provides a brief introduction on how to install the run-time Linux image. This article describes package structure and peripheral device options specific to the CM-T3530.
+
The [[CM-T3530: Linux: Getting started|Getting started with Linux on CM-T3530]] page provides a brief introduction on how to install the run-time Linux image.
 +
This article describes package structure and peripheral device options specific to the CM-T3530.
  
== Package contents ==
+
= Package contents =
  
=== version.txt ===
+
== version.txt ==
 
The contents of the {{filename|version.txt}} identifies the package version.
 
The contents of the {{filename|version.txt}} identifies the package version.
  
=== images ===
+
== images ==
* {{filename|Angstrom-image.ubi}} - ready to run Angstrom Linux image for installation onto CM-T3530 NAND
+
* {{filename|uImage-cm-t3530}} - ready to run Linux kernel image binary for CM-T3530
* {{filename|uImage-cm-t35.bin}} - kernel image binary for  installation onto CM-T3530 NAND
+
* {{filename|angstrom-image-cm-t3530.tar.bz2}} - archive of Angstrom root file system
* {{filename|Angstrom-image.tar.bz2}} - archive of root file system
+
* {{filename|angstrom-image-cm-t3530.ubi}} - ready to run Angstrom Linux image for installation onto CM-T3530 NAND
 
* {{filename|bootscr.img}} - U-Boot script used for image installation
 
* {{filename|bootscr.img}} - U-Boot script used for image installation
* {{filename|kernel.img}} - Kernel image required for NAND image installation
+
* {{filename|kernel.img}} - Kernel image required for CM-T3530 Linux and Angstrom images installation
* {{filename|ramdisk.img}} - Ramdisk image required for NAND image installation
+
* {{filename|ramdisk.img}} - Ramdisk image required for Linux and Angstrom images installation
  
=== kernel ===
+
== kernel ==
* {{parameter|additional_modules}} - additional modules required by CM-T3530 for video playback. Please refer the [[CM-T3530:_Linux:_Video_playback#Kernel_modules|Video modules installation guide]] for more information.
+
* {{filename|uImage-3.0.87-cm-t35-4.bin}} - ready to run Linux kernel 3.0.87-cm-t35-4 for CM-T3530
* {{parameter|first_release}} - previously released Linux kernel image, configuration files and patch for CM-T3530
+
* {{filename|linux-3.0.87-cm-t35-4.config}} - Linux kernel 3.0.87-cm-t35-4 configuration file
* {{filename|uImage-2.6.32-cm-t35-3.bin}} - ready to run Linux kernel 2.6.32-cm-t35-3 for CM-T3530
+
* {{filename|linux-3.0.87-cm-t35-4.patch}} - patch vs. [http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/commit/?id=61bfa77de71ef9d84614d3a7f0a3ca1c7af82058 Linux stable kernel 3.0.87] with support for CM-T3530 peripherals
* {{filename|linux-2.6.32-cm-t35-3.defconfig}} - Linux kernel 2.6.32-cm-t35-3 configuration file
+
* {{filename|patches}} - ordered collection of patches, that form the single patch above ({{filename|linux-3.0.87-cm-t35-4.patch}})
* {{filename|linux-2.6.32-omap1-cm-t35.pm.defconfig}} - Linux kernel 2.6.32-omap1 configuration file with enabled power management features same as in previous release
 
* {{filename|linux-2.6.32-cm-t35-3.patch}} - patch vs. [http://git.kernel.org/?p=linux/kernel/git/tmlind/linux-omap-2.6.git Linux-omap kernel 2.6.32] with support for CM-T3530 peripherals
 
  
=== oe ===
+
== oe ==
The {{filename|oe}} directory contains configuration files and CM-T3530 specific package definition for OpenEmbedded.
+
The {{filename|oe}} directory contains configuration files and CM-T3530 specific package definitions for OpenEmbedded.
 +
* {{filename|base-revision}} - the OpenEmbedded commit id that was used to create the Angstrom root file system image.
 +
* {{filename|local.conf}} - configuration file used to build Angstrom Linux image for CM-T3530. This file should be placed in ${OEBASE}/build/conf directory.
 +
* {{filename|openembedded-cm-t3x30.patch}} - patch vs. OE commit id specified in the {{filename|base-revision}} to support CM-T3530
 +
* {{filename|patches}} - ordered collection of patches, that form the single patch above ({{filename|openembedded-cm-t3x30.patch}})
 +
* {{filename|extra}} - directory contains miscellaneous files and examples
 +
** {{filename|oe_sample_appl.zip}} - archive of a sample Bitbake recipe that allows building a basic "Hello world" application
  
* {{filename|local.conf}} - configuration file used to build Angstrom Linux image for CM-T3530. This file should be placed in {{filename|${OEBASE}/build/conf}} directory.
+
== utilities ==
* {{filename|cm-t35.patch}} - CM-T3530 specific additions to OpenEmbedded.
+
The {{filename|utilities}} directory contains miscellaneous utilities useful for development
* {{filename|base-revision}} - specifies revision of [http://cgit.openembedded.org/cgit.cgi/openembedded/log/ OpenEmbedded git tree] used as a baseline for CM-T3530 patches generation.
+
* {{filename|angstrom-image.cfg}} - configuration file used by {{filename|ubinize}} utility for {{filename|angstrom-image-cm-t3530.ubi}} generation.
 +
* {{filename|tftpd32.zip}} - TFTP server for Windows users
 +
* {{filename|eeprom-util}} - CompuLab EEPROM utility for reading information found inside the EEPROM on CompuLab boards
 +
* {{filename|bootscr.src}} - U-Boot script source used for booting into the installation environment.
  
=== utilities ===
+
== extra ==
 +
The {{filename|extra}} files that are not directly connected to the Linux kernel or the OE framework
 +
* {{filename|Graphics_SDK_4_05_00_03}} - graphics (SGX) related files
 +
** {{filename|graphics_sdk_04_05_00_03-cm-t3x30.patch}} - patch to fix the Graphics SDK v4.05.00.03 compile time errors
 +
** {{filename|patches}} - ordered collection of patches, that form the single patch above ({{filename|graphics_sdk_04_05_00_03-cm-t3x30.patch}})
  
{{filename|utilities}} directory contains miscellaneous utilities useful for development
+
= Using Angstrom Linux on CM-T3530 =
 +
== Installation ==
  
* {{filename|Angstrom-image.cfg}} - configuration file used by {{filename|ubinize}} utility for {{filename|Angstrom-image.ubi}} generating. For more information about UBIFS images please refer the [[Linux_Development_for_ARM_modules#UBIFS_images|Linux Development for ARM modules]] article.
+
Angstrom Linux performs self configuration on the first boot. This process may take a few minutes.
* {{filename|first_boot.scr}} - U-Boot script for booting kernel and ramdisk from MMC/SD card or network.
 
* {{filename|tftpd32.zip}} - TFTP server for Windows users.
 
* {{filename|capture}} - simple video capture example.
 
  
== Using Angstrom Linux on CM-T3530 ==
+
On the fist boot the user will be prompted to create a new user profile:
=== Display options ===
+
* Please, enter the new user name and password.
CM-T3530 evaluation platform has four video output interfaces: LCD, DVI, LVDS and TV-out. Default configuration of Angstrom Linux for CM-T3530 uses Toppoly LCD supplied with the evaluation kit as primary video output. It is possible to switch between LCD and DVI interfaces on the fly. TV-out can be used simultaneously with LCD or DVI interface.  
+
* When prompted with the language selection dialogue box, please press {{cmd|Next}} button.
 +
* When prompted with the Angstrom profile selection dialogue box, please select {{cmd|Angstrom}}.
  
 +
== Display options ==
 +
CM-T3530 evaluation platform has four video output interfaces: LCD, DVI, LVDS and TV-out. Default configuration of Angstrom Linux for CM-T3530 uses DVI as primary video output.
 +
It is possible to switch between the DVI and LCD interfaces on the fly. TV-out can be used simultaneously with LCD or DVI interface.<br>
 
Linux implementation of the OMAP3 display subsystem is described in detail in {{filename|[http://gitorious.org/linux-omap-dss2/linux/blobs/master/Documentation/arm/OMAP/DSS Documentation/arm/OMAP/DSS]}} file in the Linux kernel source tree.  
 
Linux implementation of the OMAP3 display subsystem is described in detail in {{filename|[http://gitorious.org/linux-omap-dss2/linux/blobs/master/Documentation/arm/OMAP/DSS Documentation/arm/OMAP/DSS]}} file in the Linux kernel source tree.  
  
==== Display resolutions ====
+
=== Display resolutions ===
 
* The Toppoly LCD supplied with CM-T3530 evaluation kit supports 480x640 resolution with 18 bits per color
 
* The Toppoly LCD supplied with CM-T3530 evaluation kit supports 480x640 resolution with 18 bits per color
 +
* The DataImage LCD supplied with CM-T3530 evaluation kit supports 480x800 resolution with 18 bits per color
 
* DVI output can be configured for standard resolutions using kernel command line parameter {{parameter|omapfb.mode}}:
 
* DVI output can be configured for standard resolutions using kernel command line parameter {{parameter|omapfb.mode}}:
 
*: 1024x768 - omapfb.mode=dvi:1024x768-24@60
 
*: 1024x768 - omapfb.mode=dvi:1024x768-24@60
Line 65: Line 80:
 
* TV-out supports PAL and NTSC standards
 
* TV-out supports PAL and NTSC standards
  
==== Examples ====
+
=== Examples ===
===== Switch from LCD to DVI =====
+
 
 +
==== Switch from LCD to DVI ====
 
<pre>
 
<pre>
 
mgr0=/sys/devices/platform/omapdss/manager0
 
mgr0=/sys/devices/platform/omapdss/manager0
Line 79: Line 95:
 
echo "" > $mgr0/display
 
echo "" > $mgr0/display
 
fbset -fb /dev/fb0 -xres $w -yres $h -vxres $w -vyres $h
 
fbset -fb /dev/fb0 -xres $w -yres $h -vxres $w -vyres $h
# at this point you have to switch the dvi/lcd dip-switch from the omap board
 
 
echo "dvi" > $mgr0/display
 
echo "dvi" > $mgr0/display
 
echo "1" > $dvi/enabled
 
echo "1" > $dvi/enabled
 
</pre>
 
</pre>
  
===== Clone GFX overlay to LCD and TV =====
+
==== Clone GFX overlay to LCD and TV ====
 
<pre>
 
<pre>
 
ovl0=/sys/devices/platform/omapdss/overlay0
 
ovl0=/sys/devices/platform/omapdss/overlay0
Line 110: Line 125:
 
</pre>
 
</pre>
  
===== Switch TV-out from PAL to NTSC =====
+
==== Switch TV-out from PAL to NTSC ====
 
<pre>
 
<pre>
 
tv=/sys/devices/platform/omapdss/display2
 
tv=/sys/devices/platform/omapdss/display2
Line 118: Line 133:
 
</pre>
 
</pre>
  
=== 3D Demos ===
+
== Touchscreen ==
Angstrom Linux for CM-T3530 includes OpenGLES libraries and 3D demos. OMAP3 3D support is limited to 16-bit colors, therefore it is necessary to ensure that display subsystem has proper color mode configuration. For example for 1024x768 resolution the {{parameter|omapfb.mode}} should be set to '''omapfb.mode=dvi:1024x768-16@60'''.
+
CM-T3530 Evaluation Kit can be equipped with either of the following LCD touch panels: Toppoly TDO35S or DataImage SCF0403.
 +
See [[CM-T3530: Linux: Getting started#Select LCD model|Select LCD model]] to enable support for the particular LCD touch panel.
 +
The X Windows system of CM-T3530 uses tslib X server input driver to get the input from the touchscreen.
  
The OpenGLES demos can be found in {{filename|/usr/demos/}} directory in the target filesystem.
+
=== Touchscreen calibration ===
 +
Touchscreen calibration can be performed with {{cmd|xinput_calibrator}} utility.
 +
To calibrate the touchscreen run the following commands:
 +
<pre>
 +
root@cm-t3530:~# export DISPLAY=:0
 +
root@cm-t3530:~# xinput_calibrator
 +
</pre>
  
=== Video playback ===
+
* Follow the calibration utility instructions and touch the touchscreen corners.
Angstrom Linux for CM-T3530 supports playback of MPEG2, MPEG4 and H.264 video formats.
+
* Add the calibration output results into {{filename|/etc/X11/xorg.conf}} configuration file.
For further information regarding video playback, please refer to [[CM-T3530: Linux: Video playback|Video playback]] article.  
 
  
=== GPIO access ===
+
== GPIO access ==
Linux provides simple and convenient GPIO access via {{filename|sysfs}} interface. A GPIO should be requested using {{filename|/sys/class/gpio/export}}. After the GPIO is exported it is possible to change its direction and value using {{filename|/sys/class/gpio/gpioX/direction}} and {{filename|/sys/class/gpio/gpioX/value}} attributes.
+
Linux provides simple and convenient GPIO access via {{filename|sysfs}} interface. A GPIO should be exported using {{filename|/sys/class/gpio/export}}. After the GPIO is exported it is possible to change its direction and value using {{filename|/sys/class/gpio/gpioX/direction}} and {{filename|/sys/class/gpio/gpioX/value}} attributes.
  
==== Example ====
+
=== Example ===
 
The following example demonstrates how to configure GPIO 140 as output and produce a 1usec pulse:
 
The following example demonstrates how to configure GPIO 140 as output and produce a 1usec pulse:
 
 
<pre>
 
<pre>
 
echo 140 > /sys/class/gpio/export
 
echo 140 > /sys/class/gpio/export
echo 1 > /sys/class/gpio/gpio140/direction
+
echo out > /sys/class/gpio/gpio140/direction
 
echo 0 > /sys/class/gpio/gpio140/value
 
echo 0 > /sys/class/gpio/gpio140/value
 
echo 1 > /sys/class/gpio/gpio140/value
 
echo 1 > /sys/class/gpio/gpio140/value
Line 142: Line 163:
 
</pre>
 
</pre>
  
=== Angstrom Linux package management ===
 
Angstrom Linux for CM-T3530 includes {{cmd|opkg}} package manager. It can be run either from command line, or using GUI. Go to "Settings" -> "Package Manager" to start the application, select packages you'd like to install and press "Apply" button.
 
  
=== Power management ===
 
The Angstrom Linux for CM-T3530 supports very low power sleep mode and dynamic frequency scaling.  Please refer to [[CM-T3530: Linux: Power management]] article for further details.
 
  
== See also ==
+
== Angstrom Linux package management ==
* [[CM-T3530: Linux: Getting started|Getting started with Linux on CM-T3530]]
+
Angstrom Linux for CM-T3530 includes {{cmd|opkg}} package manager. It can be run from terminal command line.
* [[CM-T3530: Linux: Kernel|Linux kernel for CM-T3530]]
+
 
* [[CM-T3530: Linux: Booting from MMC/SD card|Booting from MMC/SD card]]
+
== Digital Video SDK ==
* [[CM-T3530: Linux: Building images|Building Linux images]]
+
 
* [[Linux Development for ARM modules]]
+
The TI DM3530 platform includes a built-in TMS320C64X+ DSP Core that provides advanced hardware acceleration support for media encoding / decoding.<br>
 +
For further details, refer to the OMAP35x Technical Reference Manual.
 +
The Digital Video SDK (DVSDK) version [http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/dvsdk/DVSDK_4_00/4_01_00_09/index_FDS.html 4.01.00.09] provides multiple resources for evaluation and application development for the TI DM3530 platform.
 +
{{Note|Although TI DVSDK is known to work with Linux kernel version 2.6.32, it is '''NOT''' compatible with kernel version 3.0.y.}}
 +
 
 +
== Graphics SDK ==
 +
The CM-T3530 Linux package contains pre-built and ready to run SGX functionality demo programs.
 +
The SGX configuration script must be run on CM-T3530 before '''first use''':
 +
<pre>
 +
root@cm-t3530:~# /etc/init.d/omap-demo
 +
</pre>
 +
 
 +
* The SGX kernel modules must be loaded prior running the demos:
 +
<pre>
 +
root@cm-t3530:~# /etc/init.d/rc.pvr start
 +
</pre>
 +
 
 +
=== Running Graphics SDK OpenGL ES1.x Demos ===
 +
To run OpenGL ES1.x demos, perform the following:
 +
<pre>
 +
root@cm-t3530:~# cd /opt/gfxsdkdemos/ogles
 +
root@cm-t3530:/opt/gfxsdkdemos/ogles# ./OGLESSkybox
 +
</pre>
 +
This will execute the {{filename|OGLESSkybox}} demo. Press {{parameter|‘q’}} on the CM-T3530 console to stop the demo execution.
 +
Similarly, any other OpenGL ES1.x demo can be executed.
 +
 
 +
For more information and command line options of the OpenGL ES1.x demos, please refer to the SDK user guide: {{filename|Graphics_SDK_4_05_00_03/GFX_Linux_SDK/OGLES/SDKPackage/OpenGL ES SDK.User Guide.1.20f.External.pdf}}.
 +
 
 +
=== Running Graphics SDK OpenGL ES2.0 Demos ===
 +
To run OpenGL ES2.x demos, perform the following:
 +
<pre>
 +
root@cm-t3530:~# cd /opt/gfxsdkdemos/ogles2
 +
root@cm-t3530:/opt/gfxsdkdemos/ogle2s# ./OGLES2Coverflow
 +
</pre>
 +
This will execute the {{filename|OGLES2Coverflow}} demo. Press {{parameter|‘q’}} on the CM-T3530 console to stop the demo execution.
 +
Similarly, any other OpenGL ES2.0 demo can be executed.
 +
 
 +
For more information and command line options on the OpenGL ES2.0 demos, please refer to the SDK user guide: {{filename|Graphics_SDK_4_05_00_03/GFX_Linux_SDK/OGLES2/SDKPackage/OpenGL ES 2.x SDK.User Guide.1.20f.External.pdf}}.
 +
 
 +
= See also =
 +
* [[CM-T3530: Linux: Getting started]]
 +
* [[CM-T3530: Linux: Kernel]]
 +
* [[CM-T3730: Linux: Camera]]
 +
* [[CM-T3530: Linux: Building images]]
 +
* [[Linux: Development for ARM modules|Linux Development for ARM modules]]
 
* [http://www.angstrom-distribution.org Angstrom Distribution]
 
* [http://www.angstrom-distribution.org Angstrom Distribution]
 
* [http://www.openembedded.org OpenEmbedded]
 
* [http://www.openembedded.org OpenEmbedded]
 +
* [http://processors.wiki.ti.com/index.php/Graphics_SDK_Quick_installation_and_user_guide Graphics SDK Quick installation and user guide]
 
* [http://wiki.omap.com Texas Instruments Embedded Processors Wiki]
 
* [http://wiki.omap.com Texas Instruments Embedded Processors Wiki]
  
 
[[Category:Linux|Angstrom]]
 
[[Category:Linux|Angstrom]]
 
[[Category:CM-T3530|Linux: Angstrom]]
 
[[Category:CM-T3530|Linux: Angstrom]]

Latest revision as of 05:51, 29 October 2013

Introduction

The example run-time Linux filesystem image for CM-T3530 is based on Angstrom Linux 2010. The CompuLab Linux package for CM-T3530 includes ready to run Angstrom Linux filesystem image, Linux kernel and source code patches.

The default Angstrom Linux image includes more than 1000 software packages. Among them:

  • Core system
  • X11 Windowing System
  • Enlightenment v0.16 desktop manager
  • Midory web browser
  • Totem and MPlayer media players
  • GStreamer with multiple plugins
  • The Graphics SDK version 4.05.00.03 including the Linux graphics (SGX) drivers and ready to run SGX functionality demos

The Getting started with Linux on CM-T3530 page provides a brief introduction on how to install the run-time Linux image. This article describes package structure and peripheral device options specific to the CM-T3530.

Package contents

version.txt

The contents of the version.txt identifies the package version.

images

  • uImage-cm-t3530 - ready to run Linux kernel image binary for CM-T3530
  • angstrom-image-cm-t3530.tar.bz2 - archive of Angstrom root file system
  • angstrom-image-cm-t3530.ubi - ready to run Angstrom Linux image for installation onto CM-T3530 NAND
  • bootscr.img - U-Boot script used for image installation
  • kernel.img - Kernel image required for CM-T3530 Linux and Angstrom images installation
  • ramdisk.img - Ramdisk image required for Linux and Angstrom images installation

kernel

  • uImage-3.0.87-cm-t35-4.bin - ready to run Linux kernel 3.0.87-cm-t35-4 for CM-T3530
  • linux-3.0.87-cm-t35-4.config - Linux kernel 3.0.87-cm-t35-4 configuration file
  • linux-3.0.87-cm-t35-4.patch - patch vs. Linux stable kernel 3.0.87 with support for CM-T3530 peripherals
  • patches - ordered collection of patches, that form the single patch above (linux-3.0.87-cm-t35-4.patch)

oe

The oe directory contains configuration files and CM-T3530 specific package definitions for OpenEmbedded.

  • base-revision - the OpenEmbedded commit id that was used to create the Angstrom root file system image.
  • local.conf - configuration file used to build Angstrom Linux image for CM-T3530. This file should be placed in ${OEBASE}/build/conf directory.
  • openembedded-cm-t3x30.patch - patch vs. OE commit id specified in the base-revision to support CM-T3530
  • patches - ordered collection of patches, that form the single patch above (openembedded-cm-t3x30.patch)
  • extra - directory contains miscellaneous files and examples
    • oe_sample_appl.zip - archive of a sample Bitbake recipe that allows building a basic "Hello world" application

utilities

The utilities directory contains miscellaneous utilities useful for development

  • angstrom-image.cfg - configuration file used by ubinize utility for angstrom-image-cm-t3530.ubi generation.
  • tftpd32.zip - TFTP server for Windows users
  • eeprom-util - CompuLab EEPROM utility for reading information found inside the EEPROM on CompuLab boards
  • bootscr.src - U-Boot script source used for booting into the installation environment.

extra

The extra files that are not directly connected to the Linux kernel or the OE framework

  • Graphics_SDK_4_05_00_03 - graphics (SGX) related files
    • graphics_sdk_04_05_00_03-cm-t3x30.patch - patch to fix the Graphics SDK v4.05.00.03 compile time errors
    • patches - ordered collection of patches, that form the single patch above (graphics_sdk_04_05_00_03-cm-t3x30.patch)

Using Angstrom Linux on CM-T3530

Installation

Angstrom Linux performs self configuration on the first boot. This process may take a few minutes.

On the fist boot the user will be prompted to create a new user profile:

  • Please, enter the new user name and password.
  • When prompted with the language selection dialogue box, please press Next button.
  • When prompted with the Angstrom profile selection dialogue box, please select Angstrom.

Display options

CM-T3530 evaluation platform has four video output interfaces: LCD, DVI, LVDS and TV-out. Default configuration of Angstrom Linux for CM-T3530 uses DVI as primary video output. It is possible to switch between the DVI and LCD interfaces on the fly. TV-out can be used simultaneously with LCD or DVI interface.
Linux implementation of the OMAP3 display subsystem is described in detail in Documentation/arm/OMAP/DSS file in the Linux kernel source tree.

Display resolutions

  • The Toppoly LCD supplied with CM-T3530 evaluation kit supports 480x640 resolution with 18 bits per color
  • The DataImage LCD supplied with CM-T3530 evaluation kit supports 480x800 resolution with 18 bits per color
  • DVI output can be configured for standard resolutions using kernel command line parameter omapfb.mode:
    1024x768 - omapfb.mode=dvi:1024x768-24@60
    800x600 - omapfb.mode=dvi:800x600-24@60
    640x480 - omapfb.mode=dvi:640x480-24@60
  • TV-out supports PAL and NTSC standards

Examples

Switch from LCD to DVI

mgr0=/sys/devices/platform/omapdss/manager0
lcd=/sys/devices/platform/omapdss/display0
dvi=/sys/devices/platform/omapdss/display1
fb0=/sys/class/graphics/fb0

w=`cat $dvi/timings | cut -d "," -f 2 | cut -d "/" -f 1`
h=`cat $dvi/timings | cut -d "," -f 3 | cut -d "/" -f 1`

echo "0" > $lcd/enabled
echo "" > $mgr0/display
fbset -fb /dev/fb0 -xres $w -yres $h -vxres $w -vyres $h
echo "dvi" > $mgr0/display
echo "1" > $dvi/enabled

Clone GFX overlay to LCD and TV

ovl0=/sys/devices/platform/omapdss/overlay0
ovl1=/sys/devices/platform/omapdss/overlay1
tv=/sys/devices/platform/omapdss/display2
fb0=/sys/class/graphics/fb0
fb1=/sys/class/graphics/fb1

w=`cat $tv/timings | cut -d "," -f 2 | cut -d "/" -f 1`
h=`cat $tv/timings | cut -d "," -f 3 | cut -d "/" -f 1`

echo "0" > $ovl0/enabled
echo "0" > $ovl1/enabled

echo "" > $fb1/overlays
echo "0,1" > $fb0/overlays

echo "$w,$h" > $ovl1/output_size
echo "tv" > $ovl1/manager

echo "1" > $ovl0/enabled
echo "1" > $ovl1/enabled

echo "1" > $tv/enabled

Switch TV-out from PAL to NTSC

tv=/sys/devices/platform/omapdss/display2
echo "0" $tv/enabled
echo "ntsc" $tv/timings
echo "1" $tv/enabled

Touchscreen

CM-T3530 Evaluation Kit can be equipped with either of the following LCD touch panels: Toppoly TDO35S or DataImage SCF0403. See Select LCD model to enable support for the particular LCD touch panel. The X Windows system of CM-T3530 uses tslib X server input driver to get the input from the touchscreen.

Touchscreen calibration

Touchscreen calibration can be performed with xinput_calibrator utility. To calibrate the touchscreen run the following commands:

root@cm-t3530:~# export DISPLAY=:0
root@cm-t3530:~# xinput_calibrator
  • Follow the calibration utility instructions and touch the touchscreen corners.
  • Add the calibration output results into /etc/X11/xorg.conf configuration file.

GPIO access

Linux provides simple and convenient GPIO access via sysfs interface. A GPIO should be exported using /sys/class/gpio/export. After the GPIO is exported it is possible to change its direction and value using /sys/class/gpio/gpioX/direction and /sys/class/gpio/gpioX/value attributes.

Example

The following example demonstrates how to configure GPIO 140 as output and produce a 1usec pulse:

echo 140 > /sys/class/gpio/export
echo out > /sys/class/gpio/gpio140/direction
echo 0 > /sys/class/gpio/gpio140/value
echo 1 > /sys/class/gpio/gpio140/value
usleep 1
echo 0 > /sys/class/gpio/gpio140/value


Angstrom Linux package management

Angstrom Linux for CM-T3530 includes opkg package manager. It can be run from terminal command line.

Digital Video SDK

The TI DM3530 platform includes a built-in TMS320C64X+ DSP Core that provides advanced hardware acceleration support for media encoding / decoding.
For further details, refer to the OMAP35x Technical Reference Manual. The Digital Video SDK (DVSDK) version 4.01.00.09 provides multiple resources for evaluation and application development for the TI DM3530 platform.

Admolition note.png Although TI DVSDK is known to work with Linux kernel version 2.6.32, it is NOT compatible with kernel version 3.0.y.

Graphics SDK

The CM-T3530 Linux package contains pre-built and ready to run SGX functionality demo programs. The SGX configuration script must be run on CM-T3530 before first use:

root@cm-t3530:~# /etc/init.d/omap-demo
  • The SGX kernel modules must be loaded prior running the demos:
root@cm-t3530:~# /etc/init.d/rc.pvr start

Running Graphics SDK OpenGL ES1.x Demos

To run OpenGL ES1.x demos, perform the following:

root@cm-t3530:~# cd /opt/gfxsdkdemos/ogles
root@cm-t3530:/opt/gfxsdkdemos/ogles# ./OGLESSkybox

This will execute the OGLESSkybox demo. Press ‘q’ on the CM-T3530 console to stop the demo execution. Similarly, any other OpenGL ES1.x demo can be executed.

For more information and command line options of the OpenGL ES1.x demos, please refer to the SDK user guide: Graphics_SDK_4_05_00_03/GFX_Linux_SDK/OGLES/SDKPackage/OpenGL ES SDK.User Guide.1.20f.External.pdf.

Running Graphics SDK OpenGL ES2.0 Demos

To run OpenGL ES2.x demos, perform the following:

root@cm-t3530:~# cd /opt/gfxsdkdemos/ogles2
root@cm-t3530:/opt/gfxsdkdemos/ogle2s# ./OGLES2Coverflow

This will execute the OGLES2Coverflow demo. Press ‘q’ on the CM-T3530 console to stop the demo execution. Similarly, any other OpenGL ES2.0 demo can be executed.

For more information and command line options on the OpenGL ES2.0 demos, please refer to the SDK user guide: Graphics_SDK_4_05_00_03/GFX_Linux_SDK/OGLES2/SDKPackage/OpenGL ES 2.x SDK.User Guide.1.20f.External.pdf.

See also