Mike: Getting started with Linux on CM-iGLX moved to CM-iGLX: Linux: Getting started

2009-12-23T08:03:34Z

Getting started with Linux on CM-iGLX moved to CM-iGLX: Linux: Getting started

New page

== Installation ==
=== Installation by EtherLink ===
# Obtain a standard PC with Windows XP/2000. It will be referred to as 'host PC' in this document.
# Connect a host PC serial port to the COM1 port on the ATX baseboard via a null modem cable, such as the one provided with the Eval Kit.
# Connect the module's Ethernet port (P10 on ATX baseboards) to the LAN (switch/hub) via a standard network cable, such as the one provided with the Eval Kit.
# Copy the contents of this Linux package’s ZIP file to the {{filename|C:\LIN_INST\}} folder on your PC. Unzip the {{filename|gentoo.img.gz}} file, to extract {filename|gentoo.img}}.
# Download and carefully read the {{filename|Etherlink.doc}} document available following [Developer] >> [CM-iGLX] >> [BIOS & Etherlink image]. Instal and setup a TFTPD32 server (provided with this package) on the host and an Etherlink TFTP client on the target as instructed. Set {{filename|c:\lin_inst\}} as the TFTP server base directory. For Windows tftpd32, choose '''Settings''' and browse for '''Base directory'''. Choose standard TFTP security.
# On the Host PC, open a Terminal Emulation program, such as HyperTerminal. Ensure that 'flow control' is set to NONE.
# Enter the BIOS setup on the CM-iGLX by pressing Ctrl-C on HyperTerminal and momentarily pressing the Reset button on the baseboard.
# Select “Basic CMOS Configuration”.
# In “DRIVE ASSIGNMENT ORDER”, select [Drive C:] as [Nand Flash]. Ensure that there are no external USB mass storage devices connected to the USB ports, as those may interfere with the on-board Flash Disk.
# Select “Write to CMOS and exit”.
# Again, enter the BIOS setup on the CM-iGLX by pressing Ctrl-C on HyperTerminal and momentarily pressing the Reset button on the baseboard.
# In the terminal window on the host, use [TAB] to select [Start EtherLink] from the main BIOS menu.
# Using the Etherlink menu, set the NAND image name to “gentoo.img”.
# Run “Download NAND image”. Do not interrupt the host PC and CM-iGLX until the process is complete!
# Wait for process completion, which takes several minutes. You can see the progress status by the state of the LED’s on the module:
#:Operation in progress – two LED’s are flashing
#:Operation completed successfully – one LED is on and other is off
# Return to the main menu by pressing any key. Press 0 to save the EtherLink configuration for future operations.
# Reboot and enjoy Linux on the CM-iGLX.

== After Installation ==

=== Connection and Logging In ===

Use the following username and password to login:
Account with administrative privileges:

<pre>
User: root
Password: 111111
</pre>

To login into the Linux system, you may use a serial console at 38400 bps (ttyS0, ttyS1), connect through the network (ssh protocol) or use a keyboard and VGA display.

=== IP Address ===

The IP addresses for both network interfaces are obtained automatically using DHCP.
To configure networking, edit {{filename|/etc/conf.d/net}}, {{filename|/etc/resolv.conf}} and {{filename|/etc/conf.d/hostname}}. For more information about Gentoo Linux network configuration, read: [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=4 Gentoo Network Configuration] guide.
Default settings assume that Ethernet controller of CM-iGLX is "eth1" and Ethernet controller of ATX is "eth0".

=== BIOS ===
Don’t forget to update BIOS time to avoid warning messages on booting.

=== Samba ===

Samba – server and client for a Microsoft Windows compatible network.
Use commands: {{cmd|smbmount}}, {{cmd|smbumount}}. In order to configure a Samba server, edit the configuration file {{filename|/etc/samba/smb.conf}} or use SWAT tool. More information about the Samba configuration can be obtained from Samba documentation.

=== Frequently Used Kernel Command Line Parameters ===

The following describes several Linux kernel command line parameters.

==== Root Device and Root File System ====
To specify the device containing the root file system:

<pre>
root=<block device>
</pre>

Example block devices:
{| border="2" width="30%" cellspacing="4" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show; text-align:left"
|-
! Device type
! Linux block device name
|-
| NAND flash
| /dev/sda2
|-
| IDE Compact flash
| /dev/hda1
|-
| Ramdisk
| /dev/ram0
|}

To specify a root file system type, for example ext3:

<pre>
rootfstype=ext3
</pre>

To allow Linux kernel to detect USB device containing root file system specify rootdelay:

<pre>
rootdelay=10
</pre>

==== Serial Consoles ====

To enable a console on the serial port:

<pre>
console=<tty>,<baud rate>
</pre>

The following is COM-tty mapping for different Linux versions:
{| border="2" width="20%" cellspacing="4" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show; text-align:left"
! Device
! Linux tty
|-
| COM 1 (UART)
| ttyS0
|-
| COM 2 (UART)
| ttyS1
|}

== See also ==
* [[CM-iGLX: Linux: Gentoo|Gentoo Linux for CM-iGLX]]
* [http://www.tldp.org/ The Linux Documentation Project]
* [http://www.kernel.org/ The Linux Kernel Archives]
* [http://www.gentoo.org The Gentoo Linux]

[[Category:Linux|Getting started]]
[[Category:CM-IGLX|Linux: Getting started]]

CM-iGLX: Linux: Getting started - Revision history

Mike: Getting started with Linux on CM-iGLX moved to CM-iGLX: Linux: Getting started