CM-X300: Linux: Debian - Revision history

Grinberg: /* X Windows system */

2013-09-29T13:47:31Z

‎X Windows system

Igor: /* Wireless lan support */

2011-04-13T07:40:27Z

‎Wireless lan support

Grinberg: /* IP Address */

2010-06-29T07:34:12Z

‎IP Address

Mike: /* See also */

2010-06-01T07:43:29Z

‎See also

Mike: 1 revision(s)

2010-04-22T08:59:41Z

1 revision(s)

Mike: /* EABI incompatibility */

2010-04-22T08:57:34Z

‎EABI incompatibility

Mike at 15:52, 22 December 2009

2009-12-22T15:52:18Z

New page

== Overview ==
The Linux file system for CompuLab CM-X300 module is based on Debian GNU/Linux 4.0 (etch) distribution and includes the following components:
* Package manager (apt-get, dpkg …)
* Telnet client
* SSH server/client
* FTP server/client
* Web server thttpd
* SAMBA
* Editor – nano
* Various Linux utilities (basic Debian set of utilities from debootstrap)
* Madplay - command-line mp3 player
* X Windows system with BlackBox window manager
* Dillo (web browser), aterm – X Windows applications.

== CM-X300 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-X300 allows anonymous FTP access.
To login into the Linux system, you may use a serial console (ttyS2) at 38400 bps, or connect through the network, or use a keyboard and LCD display (tty1, tty2, tty3).

=== IP Address ===
The IP addresses for both network interface are obtained automatically using DHCP.
To configure networking, edit ''/etc/network/interfaces'', ''/etc/resolv.conf'', and ''/etc/hostname''. For more information about Debian Linux network configuration read [http://www.debian.org/doc/manuals/reference/ch-gateway.en.html Network configuration] 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 VGA 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 at such device the following or similar message will appear on active console:
INIT: Id "T0" respawning too fast: disabled for 5 minutes
This is not an error message, it is just a warning that can be eliminated by editing ''/etc/inittab'' file.

=== THTTPD Web Server ===
Use ''/etc/thttpd/thttpd.conf'' to configure THTTPD web server.
The THTTP server is very sensitive to file permissions.
In summary, data files should be mode 644 (rw-r--r--), directories should be 755 (rwxr-xr-x) if you want to allow indexing and 711 (rwx--x--x) to disallow it, and CGI programs should be mode 755 (rwxr-xr-x) or 711 (rwx--x--x).
Try <nowiki>http://<your.target.ip.address>/users/thttpd.htm</nowiki>

=== X Windows system ===
CompuLab distribution contains small-footprint Kdrive based X Server optimized for embedded devices, and BlackBox window manager.
Before starting X Windows, connect USB mouse and keyboard to the system.
You can run X Windows by typing '''''startx'''''.

X server contained in CompuLab distribution supports screen rotation by 90, 180 and 270 degrees.
To change screen resolution or color depth, or to enable screen rotation append option
'''-screen <XRes>x<YRes>@<angle>x<bpp>''' option to X Server invocation command. '''XRes''' and '''YRes''' are horizontal and vertical screen resolution and angle is desired rotation angle, and '''bpp''' is color depth in bits. Note, that color depth change is not fully supported on PXA frame buffer device.

There are some X applications in distribution:
* Aterm (X terminal)
* Dillo (Web browser)

=== Audio and Touchscreen ===
CM-X300 uses WM9715 (Wolfson) AC97 codec with integrated touchscreen controller.
Both audio and touchscreen drivers are modularized if you use default CM-X300 configuration.
The following commands enable audio support and touchscreen support respectively:
<pre>
modprobe snd-soc-em-x270
modprobe wm97xx-ts
</pre>
Enabling touchscreen driver without AC97 controller driver is meaningless, since '''wm97xx-ts''' driver uses AC97 bus to access the touchscreen device.<br>
Note, that the same codec and driver is used on Compulab EM-X270 module.
More information about Linux audio subsystem can be found at [http://www.alsa-project.org ALSA project official website].

=== Touchscreen calibration ===
Touchscreen calibration can be performed with '''''ts_calibrate''''' utility. To calibrate the touchscreen:
* Make sure X Server is not running
* Load touchscreen driver as described in [[Debian_Linux_for_CM-X300#Audio_and_Touchscreen|Audio and Touchscreen]] section
* Set the '''TSLIB_TSDEVICE''' system variable:
<pre>
cd /sys/class/input
name=""
for tsdir in *; do
if [ -f $tsdir/name ] ; then
name=`cat $tsdir/name`
fi;
echo $name | grep -i "touchscreen" >& /dev/null
if [ $? -eq 0 ] ; then
name=`ls -1 $tsdir | grep event\[0-9\] | grep -v :`
break;
fi;
done;
export TSLIB_TSDEVICE=/dev/input/$name
</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''.

=== Wireless lan support ===
CompuLab Debian Linux package supports Wireless LAN on CM-X300L modules.

To enable Wireless LAN interface type:
<pre>
modprobe libertas_sdio
</pre>

The firmware for the Wireless LAN controller is included in the Debian Linux image and can be found at ''/lib/firmware'' directory.

To setup Wireless LAN parameters Linux standard [http://linux.die.net/man/8/ifconfig ifconfig] and [http://linux.die.net/man/8/iwconfig iwconfig] and [http://linux.die.net/man/8/wpa_supplicant wpa_supplicant] utilities can be used.

=== MMC/SD ===
The support for MMC/SD card on CM-X300 is available as loadable kernel module. You need to

<pre>
modprobe mmc_block
modprobe pxamci
</pre>

to enable these drivers.

Afterwards, to mount the memory card, monitor ''/proc/partitions'' to see what partitions were detected on the MMC/SD card. Next, if there's approptiate device node in ''/dev'', you can directly mount it, otherwise you should create the device node first. For example, suppose MMC/SD partition you'like to mount is ''mmcblk0p1'' then:

<pre>
if [ ! -b /dev/mmcblk0p1 ]; then mknod /dev/mmcblk0p1 b 253 1; fi
mount /dev/mmcblk0p1 /mnt/mmc
</pre>

== Software Management ==

Debian Linux for CM-X300 image 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.

== Boot time optimization for JFFS2 users ==

The JFFS2 Debian image for CM-X300 boot takes relatively much time.
The delays during the boot are partially related to JFFS2 mount time and partially to Debian image configuration.

JFFS2 designed for robust operation in embedded environment where sudden power interruptions are frequent. As a trade off for reliability in this situations, JFFS2 has long mount time. The mount time scales linearly with flash partition size. To speed up the boot process you can partition the NAND flash so it'll contain relatively small partition holding root filesystem and another partition(s) for applications and data. Mounting of applications and data partitions can be done in the background concurrently with init scripts execution.

Another reason for slow boot is Debian configuration. We tried to make the Debian image for CM-X300 as generic as possible. Therefore it contains a lot of services that may not be required for your application. Removing the unneeded services will reduce the boot time. Also, we have not modified default Debian scripts to allow better system updatability. Because of it, one of the init scripts remounts and checks the root file system several times. You can amend /etc/init.d/checkroot.sh to skip root filesystem remounts and checks.

== See also ==

* [[Getting started with Linux on CM-X300]]
* [[Linux Development for XScale modules|Software Development for XScale modules]]
* [[Linux Kernel for CM-X300]]

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

@@ Line 1: / Line 1: @@
 == Overview ==
-The example run-time Linux filesystem image for CM-X300 is based on Debian GNU/Linux Sid. The CompuLab Linux package for CM-X300 includes ready to run NAND flash image, archive of the root filesystem used to create the image and Linux kernel configuration and source code patches.
+The example run-time Linux filesystem image for CM-X300 is based on Debian GNU/Linux Sid. The CompuLab Linux package for CM-X300 includes ready to run NAND flash image, Linux kernel configuration and source code patches, and an archive of the root filesystem the UBI image was created from.
 * Core system
 * Debian package management system
 * X11 Windowing System
-* Enlightment E17 desktop manager
+* Enlightenment desktop manager
 * Netsurf web browser
 * Samba connectivity suite
 * SSH and FTP server and client
-The [[CM-X300: Linux: Getting started|Getting started with Linux on CM-X300]] 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-X300.
+The [[CM-X300: Linux: Getting started|Getting started with Linux on CM-X300]] page provides a brief introduction on how to install the run-time Linux image.
 == CM-X300 specific settings ==
@@ Line 44: / Line 46: @@
 === X Windows system ===
-CompuLab distribution contains full featured X Windows system with Enlightment window manager.
+CompuLab package contains full featured X Windows system with Enlightment window manager.
 Before starting X Windows, connect USB mouse and keyboard to the system.
 You can run X Windows by typing '''''startx'''''.
@@ Line 51: / Line 53: @@
 CM-X300 uses WM9715 (Wolfson) AC97 codec with integrated touchscreen controller.
 Both audio and touchscreen drivers are modularized if you use default CM-X300 configuration.
-The following commands enable audio support and touchscreen support respectively:
+The following commands enable audio support:
 <pre>
 modprobe snd-soc-em-x270
 modprobe wm97xx-ts
 </pre>
@@ Line 88: / Line 95: @@
 CompuLab Debian Linux package supports wireless LAN on CM-X300 modules.
-To enable Wireless LAN interface type:
+The firmware for the wireless LAN controller is included in the filesystem image and can be found at {{filename|/lib/firmware}} directory.
 To setup wireless LAN parameters, standard Linux [http://linux.die.net/man/8/ifconfig ifconfig], [http://linux.die.net/man/8/iwconfig iwconfig], [http://linux.die.net/man/8/iwlist iwlist] and [http://linux.die.net/man/8/wpa_supplicant wpa_supplicant] utilities can be used.
@@ Line 104: / Line 106: @@
 === MMC/SD ===
-The support for MMC/SD card on CM-X300 is available as loadable kernel module. You need to
+To mount the memory card, monitor ''/proc/partitions'' to see what partitions were detected on the MMC/SD card. Next, if there's an appropriate device node in ''/dev'', you can directly mount it; otherwise you should create the device node first. For example, suppose the MMC/SD partition you want to mount is ''mmcblk0p1'', then use the following command:
 <pre>
@@ Line 119: / Line 112: @@
 mount /dev/mmcblk0p1 /mnt/mmc
 </pre>
 == Software Management ==
-Debian Linux for CM-X300 image 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.
+Debian Linux for CM-X300 image includes all the information required to use Debian package management utilities.
 == Boot time optimization for JFFS2 users ==
@@ Line 132: / Line 129: @@
 Another reason for slow boot is Debian configuration. We tried to make the Debian image for CM-X300 as generic as possible. Therefore it contains a lot of services that may not be required for your application. Removing the unneeded services will reduce the boot time. Also, we have not modified default Debian scripts to allow better system updatability. Because of it, one of the init scripts remounts and checks the root file system several times. You can amend /etc/init.d/checkroot.sh to skip root filesystem remounts and checks.

@@ Line 2: / Line 2: @@
 The example run-time Linux filesystem image for CM-X300 is based on Debian GNU/Linux Sid. The CompuLab Linux package for CM-X300 includes ready to run NAND flash image, archive of the root filesystem used to create the image and Linux kernel configuration and source code patches.
-The default Angstrom Linux image takes approximately 170 megabytes of flash space, and includes more than 400 software packages. Among them:
+The default Debian Sid Linux image takes approximately 170 megabytes of flash space, and includes more than 400 software packages. Among them:
 * Core system
@@ Line 12: / Line 12: @@
 * SSH and FTP server and client
 The [[CM-X300: Linux: Getting started|Getting started with Linux on CM-X300]] 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-X300.
 == CM-X300 specific settings ==
@@ Line 35: / Line 35: @@
 To login into the Linux system, you may use a serial console (ttyS2) at 38400 bps, or connect through the network, or use a keyboard and LCD display (tty1, tty2, tty3).
-=== IP Address ===
+=== Networking ===
 To configure networking, edit ''/etc/network/interfaces'', ''/etc/resolv.conf'', and ''/etc/hostname''. For more information about Debian Linux network configuration read [http://www.debian.org/doc/manuals/reference/ch-gateway.en.html Network configuration] chapter in the [http://www.debian.org/doc/manuals/reference/index.en.html Debian Reference].

← Older revision		Revision as of 08:57, 22 April 2010
Line 140:		Line 140:

	Another reason for slow boot is Debian configuration. We tried to make the Debian image for CM-X300 as generic as possible. Therefore it contains a lot of services that may not be required for your application. Removing the unneeded services will reduce the boot time. Also, we have not modified default Debian scripts to allow better system updatability. Because of it, one of the init scripts remounts and checks the root file system several times. You can amend /etc/init.d/checkroot.sh to skip root filesystem remounts and checks.		Another reason for slow boot is Debian configuration. We tried to make the Debian image for CM-X300 as generic as possible. Therefore it contains a lot of services that may not be required for your application. Removing the unneeded services will reduce the boot time. Also, we have not modified default Debian scripts to allow better system updatability. Because of it, one of the init scripts remounts and checks the root file system several times. You can amend /etc/init.d/checkroot.sh to skip root filesystem remounts and checks.
		+
		+	== Known issues ==
		+
		+	=== EABI incompatibility ===
		+	Debian root filesystem and software packages are built with old ABI, resulting incompatibility with current default Linux kernel EABI.<br>
		+	The incompatibility is known to break CM-X300 audio and bluetooth support.<br>
		+	Broken Bluetooth support results in corrupted MAC address reading and inability to connect to any Bluetooth device. Broken audio support results in inability to run alsamixer tool and no sound can be heard. <br>
		+	Currently, there are two solutions that are known to fix the problem:
		+	* Recompiling the Linux kernel without EABI support.
		+	* Upgrading the Debian filesystem image to armel version if Debian Squeeze/Sid.

	== See also ==		== See also ==

@@ Line 85: / Line 85: @@
 The calibration results are saved to file ''/etc/pointercal''.
-=== Wireless lan support ===
+=== Wireless LAN support ===
-CompuLab Debian Linux package supports Wireless LAN on CM-X300L modules.
+CompuLab Debian Linux package supports wireless LAN on CM-X300 modules.
 To enable Wireless LAN interface type:
 <pre>
 modprobe libertas_sdio
 </pre>
-The firmware for the Wireless LAN controller is included in the Debian Linux image and can be found at ''/lib/firmware'' directory.
+The firmware for the wireless LAN controller is included in the Debian Linux image and can be found at {{filename|/lib/firmware}} directory.
-To setup Wireless LAN parameters Linux standard [http://linux.die.net/man/8/ifconfig ifconfig] and [http://linux.die.net/man/8/iwconfig iwconfig] and [http://linux.die.net/man/8/wpa_supplicant wpa_supplicant] utilities can be used.
+To setup wireless LAN parameters, standard Linux [http://linux.die.net/man/8/ifconfig ifconfig], [http://linux.die.net/man/8/iwconfig iwconfig], [http://linux.die.net/man/8/iwlist iwlist] and [http://linux.die.net/man/8/wpa_supplicant wpa_supplicant] utilities can be used.
 === MMC/SD ===

@@ Line 1: / Line 1: @@
 == Overview ==
-The Linux file system for CompuLab CM-X300 module is based on Debian GNU/Linux 4.0 (etch) distribution and includes the following components:
+The example run-time Linux filesystem image for CM-X300 is based on Debian GNU/Linux Sid. The CompuLab Linux package for CM-X300 includes ready to run NAND flash image, archive of the root filesystem used to create the image and Linux kernel configuration and source code patches.
-* Package manager (apt-get, dpkg …)
-* Telnet client
+The default Angstrom Linux image takes approximately 170 megabytes of flash space, and includes more than 400 software packages. Among them:
-* SSH server/client
-* FTP server/client
+* Core system
-* Web server thttpd
+* Debian package management system
-* SAMBA
+* X11 Windowing System
-* Editor – nano
+* Enlightment E17 desktop manager
-* Various Linux utilities (basic Debian set of utilities from debootstrap)
+* Netsurf web browser
-* Madplay - command-line mp3 player
+* Samba connectivity suite
-* X Windows system with BlackBox window manager
+* SSH and FTP server and client
-* Dillo (web browser), aterm – X Windows applications.
 == CM-X300 specific settings ==
@@ Line 42: / Line 43: @@
 INIT: Id "T0" respawning too fast: disabled for 5 minutes
 This is not an error message, it is just a warning that can be eliminated by editing ''/etc/inittab'' file.
 === X Windows system ===
-CompuLab distribution contains small-footprint Kdrive based X Server optimized for embedded devices, and BlackBox window manager.
+CompuLab distribution contains full featured X Windows system with Enlightment window manager.
 Before starting X Windows, connect USB mouse and keyboard to the system.
 You can run X Windows by typing '''''startx'''''.
 === Audio and Touchscreen ===
@@ Line 141: / Line 128: @@
 Another reason for slow boot is Debian configuration. We tried to make the Debian image for CM-X300 as generic as possible. Therefore it contains a lot of services that may not be required for your application. Removing the unneeded services will reduce the boot time. Also, we have not modified default Debian scripts to allow better system updatability. Because of it, one of the init scripts remounts and checks the root file system several times. You can amend /etc/init.d/checkroot.sh to skip root filesystem remounts and checks.
 == See also ==
-* [[Getting started with Linux on CM-X300]]
+* [[CM-X300: Linux: Getting started]]
-* [[Linux Development for XScale modules|Software Development for XScale modules]]
+* [[CM-X300: Linux: Kernel]]
-* [[Linux Kernel for CM-X300]]
+* [[Linux: Development for ARM modules]]
 [[Category:Linux|Debian]]
 [[Category:CM-X300|Linux: Debian]]

← Older revision	Revision as of 08:59, 22 April 2010
(No difference)