CM-T3517: Linux: Debian - Revision history

Grinberg: /* WL12xx calibration tool */

2014-02-25T11:09:32Z

‎WL12xx calibration tool

Grinberg: /* Running Graphics SDK OpenGL ES2.0 Demos */

2013-12-30T07:08:12Z

‎Running Graphics SDK OpenGL ES2.0 Demos

Lifshitz: /* Running Graphics SDK OpenGL ES2.0 Demos */

2013-01-15T11:48:33Z

‎Running Graphics SDK OpenGL ES2.0 Demos

Show changes

Grinberg: /* Host Controller Interface (HCI) Initialization */

2012-11-14T09:59:54Z

‎Host Controller Interface (HCI) Initialization

Grinberg at 13:16, 17 October 2012

2012-10-17T13:16:18Z

Show changes

Ilya: /* Socket CAN utilities */

2011-04-12T12:35:17Z

‎Socket CAN utilities

Grinberg: /* Software Management */

2010-12-29T09:00:51Z

‎Software Management

New page

== Overview ==
The example run-time Linux filesystem image for CM-T3517 is based on Debian GNU/Linux Sid. The CompuLab Linux package for CM-T3517 includes ready to run NAND flash image, Linux kernel configuration and source code patches and an archive of the root filesystem, used to create the image.

The default Debian Sid Linux image takes approximately 170 megabytes of flash space, and includes more than 400 software packages. Among them:

* Core system
* Debian package management system
* X11 Windowing System
* Fluxbox desktop manager
* Netsurf web browser
* Samba connectivity suite
* SSH and FTP server and client

The [[CM-T3517: Linux: Getting started|Getting started with Linux on CM-T3517]] 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-T3517.

== CM-T3517 specific settings ==

=== Connection and Logging In ===
Use the following usernames and passwords to login:

Account with administrative privileges:
<pre>
User: root
Password: 111111
</pre>

Regular user account:
<pre>
User: user
Password: 111111
</pre>

In addition to these accounts CM-T3517 allows anonymous FTP access.
To login into the Linux system, you may use a serial console (ttyS2) at 115200 bps, or connect through the network, or use a keyboard and DVI/LCD display (tty1, tty2, tty3).

=== Networking ===
To configure networking, edit {{filename|/etc/network/interfaces}}, {{filename|/etc/udev/rules.d/70-persistent-net.rules}}, {{filename|/etc/resolv.conf}}, {{filename|/etc/hostname}} and {{filename|/etc/hosts}}. For more information about Debian Linux network configuration read [http://www.debian.org/doc/manuals/reference/ch05.en.html Network setup] chapter in the [http://www.debian.org/doc/manuals/reference/index.en.html Debian Reference].

=== Consoles ===
Linux file system image is designed to suit different kernel versions and configurations. Therefore, during the operating system startup, consoles at several serial ports and DVI display are enabled. Some of these devices may not be supported, either because of kernel versions incompatibilities, or because the kernel was not configured to support these devices. When the console is enabled for such a device, the following or similar message can appear on active console:
<pre>
INIT: Id "T0" respawning too fast: disabled for 5 minutes
</pre>
This is not an error message, it is just a warning that can be eliminated by editing {{filename|/etc/inittab}} file.

=== X Windows system ===
CompuLab distribution contains full featured X Windows system with Fluxbox window manager.
Before starting X Windows, connect USB mouse and keyboard to the system.
You can run X Windows by typing '''''startx'''''.

=== Audio ===
CM-T3517 uses the TLV320AIC23B (TI) audio codec.
The audio drivers are modularized if you use default CM-T3517 configuration. To automatically load the audio driver on Linux boot, "{{filename|snd-soc-cm-t3517}}" has to be added to the {{filename|/etc/modules}}. If the audio driver is not loaded, the following command will load the audio driver and enable audio support:
<pre>
modprobe snd-soc-cm-t3517
</pre>
More information about Linux audio subsystem can be found at [http://www.alsa-project.org ALSA project official website].

=== Touchscreen ===
CM-T3517 uses the TSC2046 (TI) touchscreen controller.
The touchscreen driver is modularized if you use default CM-T3517 configuration and is loaded by {{filename|udev}} automatically on Linux boot. If the touchscreen driver is not loaded, the following command will load the touchscreen driver:
<pre>
modprobe ads7846
</pre>

The X Windows system of CM-T3517 uses tslib X server input driver to get the input from the touchscreen.

=== Touchscreen calibration ===
Touchscreen calibration can be performed with '''''ts_calibrate''''' utility available in package ''libts-bin''. To calibrate the touchscreen:
* Make sure X Server is not running
* Make sure the touchscreen driver is loaded as described in [[CM-T3517: Linux: Debian#Touchscreen|Touchscreen]] section
* Set the '''TSLIB_TSDEVICE''' system variable:
<pre>
export TSLIB_TSDEVICE=/dev/input/by-path/platform-omap2_mcspi.1-event
</pre>
* Run '''''ts_calibrate''''' utility. For proper calibration you are required to touch the touchscreen corners and center in the following order: top-left, top-right, bottom-right, bottom-left, center. The calibration results are saved to file ''/etc/pointercal''.<br>
* Use '''''ts_test''''' utility to test the calibration results.

=== MMC/SD ===
The support for MMC/SD card on CM-T3517 is built into the Linux kernel.
To mount the memory card, monitor ''/proc/partitions'' to see what partitions were detected on the MMC/SD card. For example, suppose MMC/SD partition you'd like to mount is ''mmcblk0p1'' then:
<pre>
if [ ! -d /mnt/mmcblk0p1 ]; then mkdir /mnt/mmcblk0p1; fi
mount /dev/mmcblk0p1 /mnt/mmcblk0p1
</pre>

== Software Management ==

Debian Linux image for CM-T3517 includes all the information required to use Debian package management utilities. You can use [http://linux.die.net/man/8/apt-get apt-get] and [http://www.wlug.org.nz/dpkg(8) dpkg] out of the box.

== See also ==

* [[CM-T3517: Linux: Getting started]]
* [[CM-T3517: Linux: Kernel]]
* [[Linux: Development for ARM modules]]
* [[Linux: Debian: Minimal ARM filesystem]]

[[Category:Linux|Debian]]
[[Category:CM-T3517|Linux: Debian]]

@@ Line 150: / Line 150: @@
 The CM-T3517 Linux package contains the statically compiled {{cmd|calibrator}} utility from [http://linuxwireless.org/en/users/Drivers/wl12xx/calibrator ti-utils] support package for WL12xx.
-For more details please read [http://processors.wiki.ti.com/index.php/OMAP_Wireless_Connectivity_Calibration_Proccess_NLCP OMAP Wireless Connectivity Calibration Proccess NLCP] article.
+For more details please read [http://processors.wiki.ti.com/index.php/WL12xx_NLCP_Calibration_Proccess OMAP Wireless Connectivity Calibration Proccess NLCP] article.
 Example of reading WLAN MAC address stored in NVS file:

@@ Line 545: / Line 545: @@
 === Graphics SDK ===
 The CM-T3517 Linux package contains pre-built and ready to run SGX functionality demo programs.
-* The SGX configuration script must be run on CM-T3730 before '''first use''':
+* The SGX configuration script must be run on CM-T3517 before '''first use''':
 <pre>
 root@cm-debian:~# /etc/init.d/omap-demo
@@ Line 567: / Line 567: @@
 <pre>
 root@cm-debian:~# cd /opt/gfxsdkdemos/ogles2
-root@cm-debian:/opt/gfxsdkdemos/ogle2s# ./OGLES2FilmTV
+root@cm-debian:/opt/gfxsdkdemos/ogles2# ./OGLES2FilmTV
 </pre>
 This will execute the {{filename|OGLESFilmTV}} demo. Press {{parameter|‘q’}} on the CM-T3517 console to stop the demo

@@ Line 259: / Line 259: @@
 ==== Host Controller Interface (HCI) Initialization ====
-* Attach the ttyO1 serial UART to the HCI Bluetooth stack:
+* Attach the ttyO1 serial port to the HCI Bluetooth subsystem:
 <pre>
 root@cm-debian:~#  hciattach -s 115200 /dev/ttyO1 texas 3000000

@@ Line 83: / Line 83: @@
 if [ ! -d /mnt/mmcblk0p1 ]; then mkdir /mnt/mmcblk0p1; fi
 mount /dev/mmcblk0p1 /mnt/mmcblk0p1
 </pre>