Acer Travelmate 803LCi

The coresponding thread to this tutorial can be found in the Gentoo-Forums ''If you want to contribute here, please also post your update in the Gentoo Acer 803LCi support thread (discussion section) so we all know you have ;-)
 * Gentoo Acer 803LCi support thread (discussion section)
 * Gentoo Acer 803LCi support thread (manual section)

Have fun --feffi 10:10, 2 Aug 2004 (GMT)

Updates

 * List of recent updates
 * 24.04.2005 Created articles for Framebuffer, Qingy and linked to them pi~
 * 28.01.2005 Added UDEV Section (finally) pi~
 * 08.10.2004 Added Bluetooth
 * 07.10.2004 Added comment in section smartcard reader
 * 07.09.2004 Added Beamer & external devices
 * 24.08.2004 Added acovea conclusions to CFLAGS
 * 02.03.2006 Corrected formatting error in Xdefaults

About this Howto

 * This Howto is intended to provide a usefull overview and installation & configuration guide for Gentoo-Linux on a ACER Travelmate 80x/2xx/. This Howto doesn't cover the ultimate truth, it's merely a compilation of work-reports, own testing, redoing of other howtos always with focus on an optimal stability and relyability on an ACER Travelmate 803 LCi. This howto doesn't cover the basic installation process of the Gentoo Linux distribution as this is exaustively covered by the Gentoo Installation Documents. The Howto is structured upon the inside-out-concept. All sections are optimized for work progress optimization (e.g hdparm before software-installation). So if you do this tutorial from beginning to end, the result should be a optimized stable and working Gentoo-Linux on your ACER-Travelmate 803 LCi. Also this howto is based on kernel 2.6. In special I would like to thank all those geeks in the Gentoo Forums for their help, suggestions, hints, tips, tricks and corrections for this tutorial as it would not be in this form without their help. Thank you !

for $user in ( smiler.se, ScubaStreb, treehugger, mrblade, kwaakie, svmaris, Baron FrostFire,  Fladnag, corey_s, tuxlover, miju, swell, fredrin, federico, |T5|, pjv, thepi,  Roessi ) do   echo 'thanx to ${user}' done

Important things to know about the ACER Travelmate 803 LCi

 * Reference:
 * Acer Worldwide
 * Toms Hardware Guide

General Handling

 * Although the Travelmate 803LCi looks relatively slim (overall height 34 mm) due to its 15.1" display, it is by no means small (area 333 x 284 mm). With 1400 x 1050 pixels, the display offers SXGA+-resolution. Perhaps the most conspicuous feature of the Travelmate (TM) 803LCi is the curved keyboard. The corresponding switches for enabling and disabling the WLAN, Bluetooth and IRDA modules are located on the front of the device. The combo drive is integrated on the right-hand side in the media bay. Anyone who does not require an optical drive while out and about can save himself around 100 grams in weight by using the supplied Weight Saver module. By way of an option, Acer offers an additional battery for this slot.
 * The rear side incorporates the ports for the modem, Ethernet, I/O port replicator, printer and VGA, in addition to the S-Video output. Acer has not fitted a flap to protect the ports from dust. The hard disk drive, RAM and WLAN modules are easily accessible via flaps on the underside, which greatly facilitates upgrading. To upgrade the memory, remember that there are actually two memory slots. One is easily accessible on the underside. The second one is located under the keyboard. To access this second RAM-slot the keyboard has to be temporarily removed. (to remove the keyboard first unscrew the two screws labeled "K" on the underside. Flip out the plastic cover located around the 'power switch' by lifting it in the middle above the F8 button and remove 2 additional keyboard screws below it, lift the keyboard at it's top being carefull not to crack the keyboard flatcable at it's bottom) I replaced both 256-MB modules with 1GB PC2700-200pin modules for a total of 2 GB.
 * From a purely statistical perspective, only one in ten people are left-handed writers. A mere two percent of all people are ambidextrous, and the majority of those left over are clearly right-handed. Despite this, Acer has integrated the USB and audio ports as well as the PC card slot on the left-hand side. Left-handed users will be delighted, although the odd one or two right-handed users might find this annoying. The PC card slot is positioned between the audio jacks and the USB ports. Beneath the slot, you will find a smartcard reader, which provides the device's security functions.

Battery Uptime

 * From my own experience I can give you two settings on this section: First section is Gentoo-Linux with minimal usage of disk and processor. Due to the use of 'speedfreq' and the complete powerdown of all unneccesary devices (e.g. LAN/WLAN) my longest uptime with this layout is about 6 hours of writing this tutorial.
 * Second section is Gentoo-Linux with full blown usage of both CPU and disc. With this layout you'll get a runtime of about 2 hours compiling XFree and GCC over and over again.

Falling down & Scratches

 * From my own hard experience I had to take the bitter pill of frustration when a friend of mine dropped my laptop from about 1 meter right on the floor. I think it hit on the lower right edge. As far as I know nothing bad happened to my hardware. Not even my display or harddrive. Another bad thing is letting a full blown desktop computer drop on your lid-open laptop. It hit my laptop right above the 'P1' key at the angle of the lid. I now have a little (1mm) scratch there, but despite that AGAIN nothing happened.

Output of 'lspci'
CPU: Intel Pentium-M 1600 MHz Memory: 512 MB DDR-RAM Graphics: ATI Radeon 9000 Mobility (64 MB) with VGA-Out / S-Video-Out Harddrive: 40 GB Optical-Drive: DVD/CD-RW-Combo (6x-24x/10x/24x) in MediaBay Soundcard: Intel AC'97 Sound-on-Board PCMCIA: Standard (i82365) O2Micro Smartcardreader Network: Broadcom Corporation BCM4401 10/100Base-T Wireless-LAN: Intel Corp. PRO/Wireless LAN 2100 3B Mini PCI Adapter Internal Modem: Intel AC97 Modem-on-Board Ports: Parallel Port (Standard) FastInfraRed (F-IR) USB (4x USB2.0 / EHCI / OHCI / UHCI) FireWire Texas Instruments TSB43AB21 (iLink/IEEE1394)

Output of 'lshw'
There is a really exhaustive hardware report in a seperate html file I made. Maybe this is helpfull to someone? Maybe more tricks? Be aware that this file's size is 280kb, so be patient: Extensive Hardware report

Compiler Flags

 * Reference:
 * GCC Documentation
 * CFLAGS Thread Gentoo Forum
 * USE-Flags Gentoo-Howto
 * USE-Flags Description
 * The experimental Freehackers

Design of the Pentium-M

 * As this section is the most essential for all packages that will be installed afterwards, it will be the first I would like to introduce. The internal layout of the Acer 803 is based upon the Centrino technology introduced by Intel. The Centrino package consist of two parts: The new Pentium-M processor and the Intel Wireless Network Adapter. Despite all rumors about the Pentium-M, often mistaken as an Pentium 4 Mobile (or Pentium 4-M) this processor is a new designed Pentium III. I know that several geeks are now starting to cry, but if you look at the stepping information of this processor it is from the Pentium III family, not the Pentium 4. Although the Pentium-M is not an Pentium 4, it has several improvements above the Pentium III. The compilerflags for GCC below are not the optimal as the GCC team has currently no working optimization setting especialy for the Pentium-M. Those flags only represent a hybrid set of optimizations. Also there are settings for the Pentium-M based upon the Pentium 4 layout that I maybe point out later.


 * As of gcc 3.4 there is a "-march=pentium-m" flag, I used this one for my first laptop(800Lci) gentoo install, but it didn't bootstrap properly, as gcc-3.4 isn't available yet, so I re-bootstrapped with -march=pentium3, and changed back to pentium-m afterwards. You have to use the specific portage profile for gcc-3.4 & kernel 2.6, I additionally enabled NPTL.

CFLAGS

 * The CFLAGS option is set in the '/etc/make.conf' file where all your global optimzations and variables reside. My currently working set of CFLAGS are as below:

CHOST="i686-pc-linux-gnu" CFLAGS="-march=pentium3 -pipe -O2 -fomit-frame-pointer -fforce-addr -frename-registers        -fprefetch-loop-arrays -falign-functions=64" CXXFLAGS="${CFLAGS}"
 * Be aware that the 'march=??' breaks compatability to other systems but enables a little more performance. For all other options despite the '-falign-functions=64' please look up the GCC Reference for further details. The '-falign-functions' option in detail aligns all system calls an funtions in orders of 64 byte, wich is exactly the size of the Pentium-M instruction pipe.

USE-Variables

 * The USE variables tell all packages you install on your system which extra components or interfaces to include. A usefull set of USE flags CAN be the following.

USE="acpi alsa avi cups curl dga doc dvd encode ethereal fbcon freetds gb gd gif gphoto2 gpm gtk2 imap innodb jpeg junit kerberos lcms lirc maildir mmx mozilla mpeg mpi mysql oggvorbis opengl pam pcmcia plotutils png pnp ppds quicktime samba sasl scanner sdl slp snmp socks5 sse ssl tcltk tiff trusted usb vmf wmf X x86 xinerama xml zlib -apm -arm -arts -alpha -berkdb -hppa -java -kde -mips -slang -sparc" Keep in mind that the flags above should be in ONE line. Also these flags heavily depend on the purpose your system is intended for. This is not the ultimate truth but a hint to start from.

Important Must-Have-Software

 * Before we go on I would recommend to install to most essential software. These tools are used in the sections ahead. If you don't want to install all the tools one-shot, each section has a requirement pointed out at the beginning. For all those who want to go through the complete tutorial, fire up a console as root and start the emerge below:

bash$ emerge sys-power/acpid sys-power/cpufreqd sys-apps/hdparm net-misc/dhcpcd net-wireless/wireless-tools media-sound/setmixer media-gfx/bootsplash sys-apps/hotplug app-admin/usbview

GEP (Gentoo Emerge.log Parser)

 * GEP - Gentoo Emerge.log Parser is little tool implementing a parser for the Gentoo emerge.log file and a webpage displaying analysis and statistics data about compile times on different hardware plattforms. The true intention ahead of this project is to include the statistical data processed and stored in a database by this tool into emerge. The goal is to enhance emerge to display the needed compilation times for your specific system. You will be able to forecast the times different packages need to compile and install. I already know there are tools to process the emerge.log but none of them are able to store the processed data in a central database.


 * In the next weeks I will put up this project I did for my studies, so you can test it.

Compile times for different applications
This is a rough estimation from the installation I've done: emerging Gnome lasts about 6 hours.

KDE stuff: about the same.

(none yet)

ACPI

 * Reference
 * Requirements
 * for Kernel 2.6.5
 * software-suspend-core-2.0-whole.bz2
 * software-suspend-linux-2.6.5-test16-whole.bz2
 * software-suspend-core-2.0.0.66-incremental.bz2
 * for Kernel 2.6.8-r1
 * 20-software-suspend-linux-2.6.8.1-rev1-whole
 * 30-software-suspend-core-2.0.0.104-whole
 * 20-software-suspend-linux-2.6.8.1-rev1-whole
 * 30-software-suspend-core-2.0.0.104-whole

General ACPI

 * The integration of ACPI is fully supported and working. The ACPI support can be enabled in kernel 2.6 by activating the following config:


 * This will enable all needed modules for the forthcoming sections in this tutorial. As the configuration of the ACPI implementation also mostly applies to other systems, this can be used by many different layouts of laptops. On kernel 2.6 you'll get the new '/sys' interface which can be used with the sys-apps/speedfreq package. If you're having trouble accessing the 'sys-interface', simply do the following:

bash$ cd / bash$ mkdir sys
 * to get it working correctly. Sometimes just the directory is not created or missing.

ACPI DSDT Table fixing

 * Like most of the notebook vendors nowadays, Acer provides us with a buggy DSDT Table. A lot has been said about this already, and this is not the place for rants. Anyway, you don't have to live with that. Just get the fixed DSDT table for the current BIOS (4a20, make sure you update your BIOS first!) and follow the instructions in the ACPI DSDT Howto. Of course, you can skip the steps where it says to get the DSDT table from memory and fix it, because that has been done for you already.

ACPI Event Handling

 * The acpid daemon by default has it's scripts and settings stored in '/etc/acpi/'. The default events like pressing the power-button and closing the lid are defined in '/etc/acpi/events/default'


 * Now let's install 'acpid' to your system, if you did not do this already in section 3 and add the daemon to your boot runlevel to have it available at boot time:

bash$ emerge sys-apps/acpid bash$ rc-update add acpid boot bash$ /etc/init.d/acpid start
 * Now you're ready to go: If you close your laptop-lid the blacklight of you LCD will go off and at anytime you hit your power-button the system will go to runlevel 0 and power-off your laptop.

Enhanced Speedstepping

 * With activating all settings for 'CPU Frequency Scaling' in kernel 2.6, you have prepared nearly everything you need. If you already loaded your new kernel this will get you a '/proc/acpi/processor/CPU0/performance' interface which can be used for accessing the Speedstepping features. You can look up your current frequency with

bash$ cat /proc/acpi/processor/CPU0/performance state count:            5 active state:           P1    states: P0:                 1600 MHz, 24000 mW, 10 uS      *P1:                  1400 MHz, 20000 mW, 10 uS       P2:                  1200 MHz, 18000 mW, 10 uS       P3:                   800 MHz, 16000 mW, 10 uS       P4:                   600 MHz, 12000 mW, 10 uS
 * And if you want to change this setting, just do a

bash$ echo "x" > /proc/acpi/processor/CPU0/performance
 * where "x" is your desired frequency. The only thing missing is the userspace tool 'speedfreq'. This tool runs as a daemon and is able to adjust the CPU frequency accordingly to your needs. If the CPU is not used it scales down to 600 MHz, if in full use it scales up to 1600 MHz. All you have to do now is to emerge and install it into your runlevel:

bash$ emerge speedfreq bash$ rc-update add speedfreq boot
 * The config for speedfreq can be found in /etc/conf.d/speedfreq. Here you can set the default behaviour of speedfreq and also control if users are able to monitor speedfreq. I would suggest to set the speed setting to 'dynamic' as this allows the feature described above.

I found that SPEEDFREQ_USERS="yes" won't work in a newer version Searching... [ Results for search key : speedfreq ] [ Applications found : 1 ] * sys-apps/speedfreq Latest version available: 0.7.2-r1 Latest version installed: 0.7.2-r1 Size of downloaded files: 30 kB      Homepage:    http://www.goop.org/~jeremy/speedfreq/ Description: daemon to control the CPU speed in 2.6 kernels License:    GPL-1
 * 1) emerge -s speedfreq

Instead you want to use SPEEDFREQ_OPTS like this:

bash$ /etc/init.d/speedfreq start
 * After that the speedfreqd daemon will come alive and set your frequency based on your policy. If you have set this setting to 'dynamic' you can monitor this process by typing

bash$ speedfreq -m
 * in an active console. If you start an compilejob now, you'll have a nice raise or drop in your scaling.

Support for Software Suspend
Just follow the steps of the Software Suspend v2 HOWTO and you should be set to go.

Suspend-to-RAM / Standby / ACPI S3
(Patches and howto by Doesi. Thanks a bunch!) Section "Device" BoardName   "RV250 Lf" BusID       "1:0:0" Driver      "radeon" Option    "RenderAccel" "true" Option "DynamicCLocks" "true" Identifier  "Card0" VendorName  "ATI" EndSection rmmod ehci-hcd rmmod uhci-hcd echo 3 > /proc/acpi/sleep
 * Requirements
 * Kernel: 2.6.11 + patch from http://www.doesi.gmxhome.de/linux/tm800s3/suspend.diff
 * Do not use framebuffer or else it won't work
 * X.Org >= 6.8.0
 * "radeon" driver (fglrx doesn't work). The relevant section from /etc/X11/XFree86Config (xorg.conf):
 * Before suspend unload ehci-hcd and uhci-hcd:
 * To suspend:

Hardware Sensors

 * The hardware sensors (like lm-sensors) are not working yet. This is owing to the fact that the PC87591E Sensor Chip which is used here doesn't have a driver. A driver for the PC87330 is in the works though, maybe it's similar enough to work. Until then, you should use the /proc/acpi/thermal_zone/* interface to monitor your system's health.

Despite the non-working sensor chip, it's possible to get some modules of the I2C section to work. It'll give access only to the RAM's EEPROM chips though. To enable these modules follow the kernel options below:


 * After recompiling the kernel you will be provided with the kernel modules you have to load. This can be done by setting the modules up in :


 * The information provided by these modules can be found in '/sys/bus/i2c/'.

UDEV

 * Reference
 * decibel's UDEV Primer
 * Requirements

UDEV is the new dynamic device manager system which is to replace the now obsolete devfs on 2.6 Kernels. To find out how to change your system to UDEV, first hop over to the Gentoo-Wiki HowTo or decibel's UDEV Primer, and follow those directions. After you've done that, change your udev rules accordingly. I made an example:

The only really important entry for a standard AcerTM installation is the touchpad's. I had cases when my ext. mouse was plugged in and was labelled mouse0 instead of the touchpad, so I wanted a fixed entry for it. If you use /dev/psaux for the Synaptics you propably won't need it. I find it better this way though :)

I don't know whether it's still needed, but there's a patch for the Frambuffer: fb_sysfs_udev.patch I didn't apply it, yet it works.

Harddrive & 'hdparm' Optimization

 * Reference
 * O'Reilly hdparm Howto
 * hdparm Thread Gentoo Forum
 * Requirements


 * The first thing we are doing is to set some harddriver parameters with hdparm. This will definetly optimize speed and throughoutput of your harddrive and will speed up disc usage a lot. But first let's check the possible settings and verify the HD correctness:

bash$ hdparm -I /dev/hda /dev/hda: ATA device, with non-removable media Model Number:      IC25N040ATCS04-0 Serial Number:     CSH406DDHN872B Firmware Revision: CA4OA71A Standards: Used: ATA/ATAPI-5 T13 1321D revision 3 Supported: 5 4 3 2 & some of 6 Configuration: Logical        max     current cylinders      16383   16383 heads          16      16 sectors/track  63      63 --      CHS current addressable sectors:   16514064 LBA   user addressable sectors:   78140160 device size with M = 1024*1024:      38154 MBytes device size with M = 1000*1000:      40007 MBytes (40 GB) Capabilities: LBA, IORDY(can be disabled) bytes avail on r/w long: 4     Queue depth: 1 Standby timer values: spec'd by Vendor, no device specific minimum R/W multiple sector transfer: Max = 16 Current = 16 Advanced power management level: 128 (0x80) DMA: mdma0 mdma1 mdma2 udma0 udma1 udma2 udma3 udma4 *udma5 Cycle time: min=120ns recommended=120ns PIO: pio0 pio1 pio2 pio3 pio4 Cycle time: no flow control=240ns IORDY flow control=120ns Commands/features: Enabled Supported: *   NOP cmd *   READ BUFFER cmd *   WRITE BUFFER cmd *   Host Protected Area feature set *   Look-ahead *   Write cache *   Power Management feature set Security Mode feature set *   SMART feature set *   Device Configuration Overlay feature set *   SET MAX security extension Address Offset Reserved Area Boot Power-Up In Standby feature set *   Advanced Power Management feature set *   SMART self-test *   SMART error logging Security: Master password revision code = 65534 supported not    enabled not    locked not    frozen not    expired: security count not    supported: enhanced erase 44min for SECURITY ERASE UNIT. HW reset results: CBLID- above Vih Device num = 0 determined by the jumper Checksum: correct
 * See the 'Checksum: correct' ? This should alway be the condition of a healthy harddrive. If this isn't in your case please contact your manufacturer as some hardware related problems could be occured and your Hd is in severe danger. But let's go on with some primary settings I use on my ACER 803 since it first contacted Gentoo:

bash$ hdparm -d1 -A1 -m16 -u1 -a64 -c3 /dev/hda -d1 : enable overall DMA access -A1 : enable drive read-lookahead -m16 : set multiple sector count to 16 -u1 : enable unmaskirq -a64 : enable fs readahead -c3 : enable IDE 32-bit IO access with sync
 * Please take a little time to test these settings and test their correctness for your system. After that you can also edit your /etc/conf.d/hdparm file accordingly to set these settings at boot time:

bash$ rc-update add hdparm boot bash$ vi /etc/conf.d/hdparm all_args="-d1 -A1 -m16 -u1 -a64 -c3" #EOF
 * And finally for all those who want to try a more extreme setting with hdparm, take those below, BUT BE WARNED:

bash$ hdparm -X udma5 -A1 -a1 -m16 -u1 -d1 -c3 /dev/hda
 * ATTENTION: PLEASE BE AWARE THAT MESSING AROUND WITH YOUR HARDDRIVE SETTINGS (hdparm) CAN SERIOUSLY DAMAGE YOUR HARDDRIVE OR RESULT IN LOSS OF DATA. BE CAREFULL ! I AM NOT RESPONSIBLE FOR ANY DAMAGE TO YOUR SYSTEM, YOU TRY THIS AT YOUR OWN RISK !

Networking LAN

 * Reference
 * Requirements

Broadcom 4400

 * The Acer 803 LCi runs network through a Broadcom Corporation BCM4401 10/100Base-T ethernet adapter which runs fine with the modules provided by both kernels:


 * This will give you a module named 'b44' in kernel 2.6 which also can be loaded at boot time through '/etc/modules.autoload.d/kernel-2.6':


 * Beneath that you also need to install the package 'dhcpcd' to get IP's from your DHCP-server (if you have one)


 * add the startup script for the network device 'eth0' to the boot runlevel


 * and on next boot you'll be given an IP automagically, if your device can find a DHCP server.

Networking Tools

 * Reference
 * IBM developerWorks - Keychain article
 * Gentoo Linux Documentation - Keychain
 * The MTR homepage
 * Requirements


 * Welcome to the fine art of networking tools. This section will introduce you to the secret (and not-so-secret) tools of everyday use in a networked enviroment. All tools pinned out here are usefull supplements for your work. Although some of them could be misused, so be warned to do nothing that could harm other against their will or without their knowledge. I'm not responsible for any trouble you might be exposed to, so don't complain.

SSH-Agent and Keychain

 * This section mainly covers passphraseless logins on remote-servers, by using openssh and a tool named keychain. First be sure you have openssh installed and configured correctly. If you don't have (what I don't expect), you need to install it first:

bash$ emerge net-misc/openssh
 * After your successfull installation and configuration of ssh and sshd we'll move on to install net-misc/keychain. Keychain in general will spawn a ssh-agent session which remembers your passphrases and ssh-keys for later use in a current session. This is extremely usefull as you only enter your passphrase once you login and have these keys available throughout your whole system without entering the passphrase again. Let's emerge:

bash$ emerge net-misc/keychain
 * Keychain doesn't need any configuration as all parameters are given at runtime. Let's move on

bash$ emerge net-misc/gtk2-ssh-askpass
 * or

bash$ emerge net-misc/x11-ssh-askpass
 * Depending on your favourites emerge one of those askpass-tools (I prefer the GTK2 - looks geekier). Now let's move on to include your keys:


 * As you can see above there are three lines of code you need to include. The first tells SSH what favour to use if it asks for a passphrase. The second one is the actual keychaining where you include your key(s). You can include more than one key (e.g. for different servers). Keychain creates some sort of PID-file for the spawned ssh-agent therefore I also specified the directory to put this file. I prefer to have the file in ~/.ssh/ but you can leave this option. Keychain then will put this PID-file in ~/.keychain/. The third line sources your PID-file to the current bash-session and makes the ssh-agent available. If you restart your xfree now, gtk2-ssh-askpass should ask you for your passphrase.
 * Last but not least we also need to edit our ~./.bashrc file for keychain to work correctly:


 * As you can see here, the same three lines are included. The purpose, why these lines are included inside the "case" is because I use xterm and I don't want to spawn keychain (and especially gtk2-ssh-askpass) on a normal text-console (without xfree running). Else this will produce a deadlock, where keychain is waiting for a passphrase and gtk2-ssh-askpass cannot ask you, because there is no display from xfree. This can be optimized by exporting different SSH_ASKPASS variables on different logins, but I need more research in this. If someone has a good hint, post it!! If you now open up a console in xfree, keychain will come to live, search for your key(s), a running ssh-agent and load them all. But what the heck?? We forgot to put our keys on the server?? surely we'll do!! All we need is to put our public keypart on the server to authenticate there with our private key:

cat ~/.ssh/your_key.pub | ssh username@machine.org "cat >> .ssh/authorized_keys"
 * Voila! If you now fire up another console and ssh to your remote-machine, no passphrase will be asked. Have fun!!

mtr

 * The little mtr combines the functionality of the 'traceroute' and 'ping' programs in a single network diagnostic tool. It features a console as well as a GTK based interface. To emerge it just do

bash$ emerge net-analyzer/mtr
 * After installing this little tool, you can start it with

bash$ mtr www.google.com
 * This tool is very usefull, as well as in Xfree as on text-based console to measure your network quality and output.

iptraf
IPTraf is an IP LAN monitor that generates various network statistics including TCP info, UDP counts, ICMP and OSPF information, Ethernet load info, node stats, IP checksum errors, and others. It is very usefull to monitor different networking devices or whole networks. bash$ emerge net-analyzer/iptraf After installation it can be started with bash$ iptraf Have fun with it.

Networking WLAN

 * Reference
 * ipw2100 source driver
 * Gentoo Forum Thread
 * ndiswrapper
 * Requirements
 * intel wlan driver for WindowsXP
 * ndiswrapper
 * intel wlan driver for WindowsXP
 * ndiswrapper
 * intel wlan driver for WindowsXP
 * ndiswrapper

ipw2100

 * The ipw2100 are the native intel drivers for the Intel Pro Wireless 2100 card. Fortunately for us, ipw2100 is in portage which makes it pretty easy. First of all you need to enable the Cryptographic API in your kernel, as the ipw2100 driver needs it for WEP support. It can be found here:


 * Now do an

$bash # emerge -va ipw2100
 * It should tell you that it will emerge hostap and ipw2100. Confirm the question with a yes which will automatically download and compile hostap (for the WEB stuff), as well as the most recent and stable ipw2100 firmware and driver. After the emerge you should be able to load the driver

$bash # modprobe ipw2100
 * If everything works, you can add it to /etc/modules.autoload.d/kernel- . Replace with your kernel base version e.g. 2.6

$bash # echo ipw2100 >>/etc/modules.autoload.d/kernel-2.6
 * You now have a eth1 interface with a wireless extension. Bring it up with

$bash # ifconfig eth1 up
 * And connect to your accesspoint.

$bash # iwconfig eth1 essid youressid $bash # iwconfig eth1 key s:key
 * You will see if it has connected to your accesspoint by looking at iwconfig. It should show your essid, the key and the hardware adress of your accesspoint. Now you can get your ip adress with dhcp and start browsing (well, you might have to set a proxy if there is one in your network).

$bash # dhcpcd eth1 &
 * If you have several locations with accesspoints and you don't want to do all of this manually i suggest you have a look at Wireless configuration and startup - The Gentoo way which will automatically connect to preferred accesspoints at startup including WEP and dhcp.


 * When you don't like the device name eth0 (or eth1) you should create the file /etc/modules.d/ipw2100 with this content

options ipw2100 ifname=wlan%d
 * After that you have to do

$bash # modules-update

/NOTE


 * Reboot the machine (or reload the driver) to get the device wlan0 (or wlan1) - this also works for the ipw2200 driver! But don't forget to symlink /etc/init.d/net.wlan0 to /etc/init.d/net.lo (see gentoo-handbook) and adapt your configs.


 * You may have to do a modprobe ieee80211_crypt_wep to make the wep encryption work in the ipw2100 driver.

ndiswrapper
Note: Using ndiswrapper is no longer needed, let alone recommended, as the Intel native drivers work without shortcomings.
 * The first tool that was known to emulate the NDIS structure of the win-drivers for the Intel 2100 Pro was the tool 'ndiswrapper'. As it is free and open-source it found acceptance than the commercial tools around. To get ndiswrapper working first you have to enable some options in your kernel config:


 * This will provide you with the interface in '/proc/net/wireless' which is used by the wireless-tools package and some other tools. After recompiling your kernel you'll have to install the ndiswrapper. The source is currently not in portage but you can download it. Untar it in some temporary directory (e.g. /tmp/ndiswrapper/). Follow the installation instructions to compile the driver and the utils. If you ever recompile your kernel, be sure to recompile 'ndiswrapper' as well! It won't work otherways because of linking problems. If you have done that, copy the file './driver/ndiswrapper.o' and './driver/ndiswrapper.ko' into the directory '/lib/modules/2.6.0/kernel/drivers/net/' and you'll have a new module for modprobe. Now do:

bash$ cd /tmp/ndiswrapper bash$ cp driver/ndiswrapper.o /lib/modules/2.6.0/kernel/drivers/net/ bash$ cp driver/ndiswrapper.ko /lib/modules/2.6.0/kernel/drivers/net/ bash$ modules-update bash$ mkdir /usr/local/bin/wlan bash$ cp utils/loadndisdriver /usr/local/bin/wlan/ bash$ ln -s /usr/local/bin/wlan/loadndisdriver /usr/local/bin/loaddriver
 * to set up the binary part of the ndiswrapper tool. All we need now is to copy the w70n51.inf and w70n51.sys files from the Intel Wireless Network Drivers for WindowsXP to your freshly installed directory:

bash$ cp w70n51.inf /usr/local/bin/wlan bash$ cp w70n51.sys /usr/local/bin/wlan
 * But how we are going to use it? Nothing easier that that: All you have to do, is to copy the little script provided below to '/etc/init.d/net.wlan'


 * Done that you have to add it to runlevel boot:

bash$ rc-update add net.wlan boot bash$ /etc/init.d/net.wlan start * Bringing WLAN (NDISwrapper) up... Calling putdriver ioctl Parsing the inf file. Driver version: 07/31/2003,1.2.0.58 Calling startdriver ioctl bash$ iwconfig lo     no wireless extensions. eth0  no wireless extensions. eth1  IEEE 802.11b  ESSID:"WWLAN" Mode:Managed Frequency:2.437GHz  Access Point: 00:60:B3:99:AD:30 Bit Rate=11Mb/s RTS thr=1600 B  Fragment thr=2344 B              Encryption key:off Power Management:off Link Quality:0 Signal level:180  Noise level:0 Rx invalid nwid:0 Rx invalid crypt:0  Rx invalid frag:0 Tx excessive retries:0 Invalid misc:0   Missed beacon:0
 * If your output looks somewhat like this you'll have a working eth1 interface which can be used with the wireless-tools mentioned above. Of course the most networking tools should work with that interface.

Exchanging the Intel Mini-PCI with a Dell Truemobile 1150

 * As mentioned below in this thread it is possible to replace the Intel Mini-PCI WLAN Card with a Dell Truemobile 1150 (costs about $49). So here is a small conclusion: The new Card needs Kernel 2.6 to run properly as the drivers in 2.4 aren't working correctly. The replacement of the card itself is a little bit missleading, as the antenna-cables look soldered right onto the board. However they are not. They do look like they are soldered, however they are not. They push down onto their ports so all you have to do is pull straight up and they will come off. The Truemobile has two antenna wire inputs and the connectors fit onto them perfectly. To disconnect the wires, just pull straight up. To reconnect them, push straight down.
 * Closeup of the antenna connectors
 * The installed card
 * In Kernel 2.6 config you'll need to enable


 * and


 * After that it should work right away. I can't proof this, because i don't have that piece of hardware, but it's reported to work.
 * ATTENTION: PLEASE BE AWARE THAT MESSING AROUND WITH YOUR HARDWARE CAN SERIOUSLY DAMAGE YOUR COMPUTER OR RESULT IN LOSS OF DATA. BE CAREFULL ! I AM NOT RESPONSIBLE FOR ANY DAMAGE TO YOUR SYSTEM, YOU TRY THIS AT YOUR OWN RISK !

Wireless Tools

 * Reference
 * Kismet Wireless WLAN Sniffer
 * Requirements

Kismet

 * Kismet is (as you probably all know) a wireless sniffing tool at the best. In fact its the standart of scanning or wardriving. At the moment, kismet standard is not able to handle the ipw2100 drivers, so we need to install the cvs version. Maybe this becomes obsolete the next time. First create a new directory for the kismet-cvs version:

bash$ cd /usr/portage/net-wireless bash$ mkdir kismet-cvs bash$ cd kismet-cvs
 * Now download the ebuild provided by the kismet developers either directly from their site kismetwireless.net or via wget:

bash$ wget http://dev.gentoo.org/~latexer/files/kismet-cvs-3.1.0.ebuild
 * Now we need to create the manifesto for this ebuild and then we're able to emerge kismet-cvs

bash$ ebuild kismet-cvs-3.1.0.ebuild manifest bash$ emerge kismet-cvs
 * After successfull installation, we now move on to configure kismet to use the correct sources for capturing:


 * Keep an eye on the defaultuser entry in this and the next config. This should be the name of your normal user as kismet drops priviledges to it. Now kismet is set to use the correct network device, but we also need to tell kismet where to find the capture sources:


 * These are only the main settings, so feel free to set your own settings depending on devices (e.g. GPS) you own or preferences you might have for scanning. After configuring, init the the kismet server via the init script in /etc/init.d/kismet:

bash$ /etc/init.d/kismet start
 * Some last words on using kismet: To use it you have to change to the home directory of the user you entered in the config files and then start kismet:

bash$ cd /home/user bash$ kismet
 * Happy scanning...

Bluetooth
Mobile phone, Bluetooth and GNOME
 * Reference
 * Requirements
 * bluez-utils
 * bluez-sdp

Configure the bluetooth-service

 * Then you have to emerge the bluez-utils and the bluez-sdp, they are in the portage so just

bash# emerge bluez-utils bluez-sdp -av if everything is ok, say yes and go on.
 * Now you have to set up your config the file is /etc/bluetooth/hcid.conf

be aware .. there is a file that the deamon call --> /usr/bin/bluepin that doesn't work for me.
 * So I change the PIN helper in the /etc/bluetooth/hcid.conf

pin_helper /usr/bin/my_bluepin; #this is my new file
 * 1) PIN helper
 * 2) pin_helper /usr/bin/bluepin;
 * This file have only to say to the other device what is the PIN, so I write a simple bash script that is


 * to tell the pin to my phone and I had replaced the original.
 * It has to be executable so

chmod 775 /usr/bin/my_bluepin
 * At this point you can add bluetooth to default profile and start it.

rc-update add bluetooth default && /etc/init.d/bluetooth start
 * You can scan with hcidtool

bash# hcitool scanning Scanning ... 00:08:C6:02:D9:A5      Fisio 82X now you can see your phone and what service are avaible with it bash# sdptool browse 00:08:C6:02:D9:A5 Browsing 00:08:C6:02:D9:A5 ... Service RecHandle: 0x10000 Service RecHandle: 0x10006 Service RecHandle: 0x1000d Service RecHandle: 0x10013 Service RecHandle: 0x10019 Service RecHandle: 0x1001f Service RecHandle: 0x10025 Service Name: Serial Port Service RecHandle: 0x10026 Service Class ID List: "Serial Port" (0x1101) "Generic Telephony" (0x1204) Protocol Descriptor List: "L2CAP" (0x0100) "RFCOMM" (0x0003) Channel: 5 Profile Descriptor List: "Serial Port" (0x1101) Version: 0x0100 Service Name: Dial-up networking Service RecHandle: 0x10027 Service Class ID List: "Dialup Networking" (0x1103) "Generic Networking" (0x1201) Protocol Descriptor List: "L2CAP" (0x0100) "RFCOMM" (0x0003) Channel: 2 Profile Descriptor List: "Dialup Networking" (0x1103) Version: 0x0100 Service Name: OBEX Object Push Service RecHandle: 0x10028 Service Class ID List: "OBEX Object Push" (0x1105) Protocol Descriptor List: "L2CAP" (0x0100) "RFCOMM" (0x0003) Channel: 4 "OBEX" (0x0008) Profile Descriptor List: "OBEX Object Push" (0x1105) Version: 0x0100 Service Name: Voice gateway Service RecHandle: 0x10029 Service Class ID List: "Headset Audio Gateway" (0x1112) "Generic Audio" (0x1203) Protocol Descriptor List: "L2CAP" (0x0100) "RFCOMM" (0x0003) Channel: 1 Profile Descriptor List: "Headset" (0x1108) Version: 0x0100 Service Name: Fax Service RecHandle: 0x1002a Service Class ID List: "Fax" (0x1111) "Generic Telephony" (0x1204) Protocol Descriptor List: "L2CAP" (0x0100) "RFCOMM" (0x0003) Channel: 6 Profile Descriptor List: "Fax" (0x1111) Version: 0x0100


 * The first time maybe you have to digit the same PIN you have choosen above in the phone.

I work with nautilus so the front-end application that I have choosen is gnome-bluetooth-manager bash# emerge gnome-bluetooth Lauch it bash# gnome-bluetooth-manager Scan when your phone is in the discoravable mode and then you can send and receive images.

If you have trouble try to launch th gnome-obex-serve with bash# gnome-obex-server

Internal modem

 * Reference
 * Requirements


 * The following introduction on the internal modem currently only works with kernel 2.6. Once more compile the kernel after enabling the following option:


 * This will make a module of the modem via ALSA. After reboot load the module with (or set it to load everytime):

bash$ modprobe snd_intel8x0m
 * Now simply add ALSA support to your make.conf and emerge slmodem which is in portage with

bash$ nano /etc/make.conf SUPPORT_ALSA=1 bash$ emerge slmodem
 * After a successfull emerge add the following line to /etc/modules.d/alsa. If the doesn't exist, just create it:

bash$ nano /etc/modules.d/alsa alias snd-card-1 snd-intel8x0m
 * For the first time run the driver with:

bash$ slmodemd -a hw:1 -c
 * Fill in the right above. Now you should have a device created at /dev/ttySL0. Next install the neccessary tools to use your dialin:

bash$ emerge ppp bash$ emerge pppconfig bash$ emerge wvdial
 * Now we go on with the setup of ppp and wvdial

bash$ pppconfig
 * or edit them manually at /etc/ppp/peers/YourISP. Follow the instructions and setup for your ISP, using /dev/ttySL0 as the modem device. I chose PAP and staticDNS. You might have to do this a couple times, because with me it didn't always stay the way I left it. Doesn't seem very stable.

bash$ wvdialconf /etc/wvdial.conf
 * and manually edit the /etc/wvdial.conf. Again follow instructions and once more fill in the data for your ISP. After configuring just run

bash$ wvdial
 * and it should connect you to your ISP. First dialup, then connecting and negotiating, and finally handing over to the pppd deamon. As long as it is running you are online. You can exit with Ctrl-C.

bash$ wvdial --> WvDial: Internet dialer version 1.53 --> Initializing modem. --> Sending: ATZ ATZ OK      --> Sending: ATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0 ATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0 OK      --> Modem initialized. --> Sending: ATDT0909 30 199 --> Waiting for carrier. ATDT0909 30 199 CONNECT 37333 --> Carrier detected. Waiting for prompt. ~[7f]}#@!}!O} }9}"}&} }*} } }#}%B#}%}%}&[1b][7f]x}9}'}"}(}"o[17]~      --> PPP negotiation detected.       --> Starting pppd at Fri Jul  2 17:48:09 2004       --> pid of pppd: 10753
 * Note: If you also have networking configured, you might have some problems with the default route. I think it's best that you first shutdown your network connection and turn off your ADSL modem by running:

bash$ /etc/init.d/net.eth0 stop
 * Ofcourse in real life you will only have 1 connection up. These are sane outputs:

bash$ ifconfig eth0     Link encap:Ethernet  HWaddr 00:C0:9F:20:D5:52 inet addr: Bcast:10.0.0.255  Mask:255.255.255.0 UP BROADCAST NOTRAILERS RUNNING MULTICAST MTU:1500  Metric:1 RX packets:42729 errors:0 dropped:0 overruns:0 frame:0 TX packets:42347 errors:0 dropped:0 overruns:0 carrier:5 collisions:118 txqueuelen:1000 RX bytes:57731041 (55.0 Mb) TX bytes:3175717 (3.0 Mb) Interrupt:5 ...      ppp0      Link encap:Point-to-Point Protocol inet addr: P-t-P:194.78.16.11  Mask:255.255.255.255 UP POINTOPOINT RUNNING NOARP MULTICAST MTU:1500  Metric:1 RX packets:4 errors:0 dropped:0 overruns:0 frame:0 TX packets:5 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:3 RX bytes:64 (64.0 b) TX bytes:97 (97.0 b)

bash$ ping -I ppp0 www.gentoo.org PING www.gentoo.org (203.112.31.164) from ppp0: 56(84) bytes of data. 64 bytes from 203.112.31.164: icmp_seq=1 ttl=44 time=477 ms      64 bytes from 203.112.31.164: icmp_seq=2 ttl=44 time=471 ms       64 bytes from 203.112.31.164: icmp_seq=3 ttl=44 time=460 ms       64 bytes from 203.112.31.164: icmp_seq=4 ttl=44 time=454 ms       --- www.gentoo.org ping statistics --- 5 packets transmitted, 4 received, 20% packet loss, time 4003ms rtt min/avg/max/mdev = 454.167/465.744/477.388/9.080 ms
 * Now just have a look at your routes with eth0 up

bash$ linux # route Kernel IP routing table Destination    Gateway         Genmask         Flags Metric Ref    Use Iface 194.78.16.11   *               255.255.255.255 UH    0      0        0 ppp0 10.0.0.0       *               255.255.255.0   U     0      0        0 eth0 loopback       localhost       255.0.0.0       UG    0      0        0 lo       default         sth.lan         0.0.0.0         UG    0      0        0 eth0
 * and your routes with eth0 down

bash$ linux # route Kernel IP routing table Destination    Gateway         Genmask         Flags Metric Ref    Use Iface 194.78.16.11   *               255.255.255.255 UH    0      0        0 ppp0 loopback       localhost       255.0.0.0       UG    0      0        0 lo       default         194.78.16.11    0.0.0.0         UG    0      0        0 ppp0
 * You also don't need to touch /etc/init.d/net.ppp0 or it's config. What you do need to do is make an init script for the slmodemd deamon. This is an adapted version from http://www.kcore.org/?menumain=4&menusub=1


 * Now to make the modem modules and also the pcscd deamon run at boot do

bash$ rc-update add pcscd boot bash$ rc-update add slmodemd default
 * It's as easy as that. And it practically works out of itself. These connections also go very well with the gnome 2.6 Network Monitor applets!

IRDA support

 * Reference
 * Tutorial via Email from tuxlover (THANX)
 * Requirements
 * sys-apps/irda-utils
 * app-misc/gscmxx (to connect to a Siemens mobile phone)


 * As the infrared-port (IRDA) works flawlessly on kernel 2.6 don't forget to enable them in your BIOS (I forgot it and almost threw my notebook out of the window)!. Just enable the following kernel options to get the correct modules:


 * You can insert the module into the kernel with the modprobe parameters, also it may or may not be nessacery to turn off UART mode for you serial port:

bash$ setserial /dev/ttyS1 uart none bash$ modprobe nsc-ircc io=0x2f8 irq=3 dma=1
 * After recompiling and installing your new kernel install the irda-utils, which provide all kinds of programms for accessing IRDA. Also you should add the /etc/init.d/irda to your default runlevel to initialize the IRDA device on boot:

bash$ emerge irda-utils bash$ rc-update add irda default
 * After rebooting with your new kernel, you can use irdadump to check if there's any traffic on your infrared port. By default, you should see your own computer's polling:

bash$ irdadump 13:51:49.342590 xid:cmd ebbe58d4 > ffffffff S=6 s=0 (14) 13:51:49.432474 xid:cmd ebbe58d4 > ffffffff S=6 s=1 (14) 13:51:49.522460 xid:cmd ebbe58d4 > ffffffff S=6 s=2 (14) 13:51:49.612446 xid:cmd ebbe58d4 > ffffffff S=6 s=3 (14) 13:51:49.702433 xid:cmd ebbe58d4 > ffffffff S=6 s=4 (14) 13:51:49.792418 xid:cmd ebbe58d4 > ffffffff S=6 s=5 (14) 13:51:49.882405 xid:cmd ebbe58d4 > ffffffff S=6 s=* linux hint=0400 [Computer] (20)
 * You should now make the IRDA device (/dev/ircom...) accessible for all users. To archive it just edit /etc/devfsd.conf and add the following line:

bash$ nano /etc/devfsd.conf REGISTER       ^ircomm.*     PERMISSIONS root.users  0660
 * Now, if you put an irda device in front of your irda port, it could look like this:

bash$ irdadump 13:57:22.291974 xid:cmd ebbe58d4 > ffffffff S=6 s=0 (14) 13:57:22.381857 xid:cmd ebbe58d4 > ffffffff S=6 s=1 (14) 13:57:22.471843 xid:cmd ebbe58d4 > ffffffff S=6 s=2 (14) 13:57:22.561830 xid:cmd ebbe58d4 > ffffffff S=6 s=3 (14) 13:57:22.651814 xid:cmd ebbe58d4 > ffffffff S=6 s=4 (14) 13:57:22.741804 xid:cmd ebbe58d4 > ffffffff S=6 s=5 (14) 13:57:22.823723 xid:rsp ebbe58d4 < 00481537 S=6 s=5 SIEMENS S45i hint=b124 [ PnP Modem Fax IrCOMM IrOBEX ] (29) 13:57:22.831790 xid:cmd ebbe58d4 > ffffffff S=6 s=* linux hint=0400 [Computer] (20)
 * Now you should be set to connect any IRDA devices to your notebook.

Siemens mobile phones

 * If you have a siemens mobile phone like I do (S25 to MT50), you can install app-misc/gscmxx and use it to manage your address book, pictures and similar things:

emerge app-misc/gscmxx
 * Put your phone close to your irda port, start gscmxx and configure it to use /dev/ircomm0, baudrate 115200, and set the timeouts to relatively high values.

PCMCIA

 * Reference
 * Requirements


 * The PCMCIA card slot of the Acer 803 Lci is fully supported by the yenta-compatible module, so all you have to do is to compile yourself a new kernel with the following options:


 * to get it working. By it's nature as a module you need to load the appropiate modules before you can use the tools by using the commands below:

modprobe pcmcia_core modprobe yenta_socket modprobe ds
 * You can also load those modules at boot-time by placing the settings in your '/etc/modules.autoload.d/kernel-2.6' file:


 * To configure and work with you PCMCIA-cards, you'll need to install the 'pcmcia-cs' package which will provide you with the neccessary tools:

emerge sys-apps/pcmcia-cs
 * After you installed these tools you can get some information about the sockets and the installed cards by typing:

bash$ cardctl status Socket 0: no card Socket 1: 5V 16-bit PC Card function 0: [ready]
 * The card that resides in Socket 1 displayed here is the O2Micro Smartcardreader which is currently not supported under Linux. You can also get more information about your plugged-in cards by:

bash$ cardctl ident Socket 0: no product info available Socket 1: product info: "O2Micro", "SmartCardBus Reader", "V1.0" manfid: 0xffff, 0x0001

Smartcardreader
The smartcard reader works using the new official driver with some patches for the new pcmcia structure in the latest kernels, and with the latest pcsc-lite. We are still looking for applications though. -- pjv 14-08-2006

Edit: Recently it stopped working and I needed to make the adjustments as posted at (mostly dropping the  in the udev rule). I also had the FF FF atr, which went away by either one of these: pcscd -f, having your card already in the reader before starting the commands, second run. -- pjv 11-10-2006

Driver and dependencies
Get the latest gentoo-sources kernel (in my case gentoo-sources-2.6.17-r5), compile and use it. The drivers will contain a solution for <2.6.13 and for 2.6.13<=...<2.6.16-somewhat. For >=2.6.16-somewhat will need patches as the drivers aren't up to date enough yet, see later on.

Emerge pcsc-lite >=1.2.9 (in my case 1.3.1-r1) and optionally also opensc (in my case 0.11.0-r1).

Download the latest driver (in my case O2Micro_PCMCIA_SCR_203_Linux_Kernel26_OpenSource.tar.gz) from O2Micro. Unpack it to (for example) as root.

We're now going to patch it for kernel version 2.6.17, and then we'll just follow the included install guide:

Download the two patches to the drivers rootdirectory: ozscrlx.c-patch-kernel-2.6.13-to-2.6.17configids-b-0001.bin (the actual update for 2.6.17) and ozscrlx.c-patch-kernel-2.6.17sysfs.bin (for adding basic sysfs functionality)(you can add this udev rule to under misc devices: ). More info about this can be found at, credits go fully to the people there. The driver is Windows-formatted so do:. Better backup first. Now apply the patches: cat /opt/OZSCR_2.0.3_Kern_2.6/ozscrlx.c-patch-kernel-2.6.13-to-2.6.17configids-b-0001.bin | patch -p1 cat /opt/OZSCR_2.0.3_Kern_2.6/ozscrlx.c-patch-kernel-2.6.17sysfs.bin | patch -p1

With both it will ask "File to patch:", answer with (just point to the right file):. It should finish with "patching file src/ozscrlx-2.6.13/ozscrlx.c" and certainly no HUNKS FAILED or you will have to try and apply it manually.

Next, just follow the guide (with your running 2.6.17 kernel and ditto symlink). It says to. This is the output: Found pcsclite 1.3.1 in /usr/lib Found kernel 2.6.17-gentoo-r5030 includes directory Building OZSCR modules... rm -f *.o rm -f .*.o.d rm -f *.ko rm -f *.mod.* rm -f .*.cmd rm -rf .tmp_* rm -f *~ make -C /lib/modules/`uname -r`/build SUBDIRS=`pwd` modules make[1]: Entering directory `/usr/src/linux-2.6.17-gentoo-r5' CC [M] /opt/OZSCR_2.0.3_Kern_2.6/src/ozscrlx-2.6.13/ozscrlx.o  Building modules, stage 2. MODPOST CC     /opt/OZSCR_2.0.3_Kern_2.6/src/ozscrlx-2.6.13/ozscrlx.mod.o  LD [M]  /opt/OZSCR_2.0.3_Kern_2.6/src/ozscrlx-2.6.13/ozscrlx.ko make[1]: Leaving directory `/usr/src/linux-2.6.17-gentoo-r5' cp -f ozscrlx.ko /lib/modules/`uname -r`/pcmcia rm -f *.o rm -f .*.o.d rm -f *.ko rm -f *.mod.* rm -f .*.cmd rm -rf .tmp_* rm -f *~ Copying files... Old /etc/reader.conf backedup as /etc/reader.conf.bak cp: kan stat niet toepassen op `etc/reader.conf.1.3.1': Onbekend bestand of map /etc/reader.conf updated OZSCR installation complete.

It only complains about. This is because the script has the expected version of pcsc-lite (so 1.2.9) hard-coded. Just copy it manually:.

Load the driver:. If I'm not forgetting anything then this is all you need to do. Now just run pcscd and see if it works:. Output: pcscdaemon.c:259:main pcscd set to foreground with debug send to stderr readerfactory.c:1095:RFInitializeReader Attempting startup of O2Micro SmartCardBus Reader 00 00. readerfactory.c:933:RFBindFunctions Loading IFD Handler 2.0 pcscdaemon.c:464:main pcsc-lite 1.3.1 daemon ready. hotplug_libusb.c:105:HPReadBundleValues Cannot open PC/SC drivers directory: /usr/lib/readers/usb hotplug_libusb.c:106:HPReadBundleValues Disabling USB support for pcscd. Card ATR: 3B 98 13 40 0A A5 03 01 01 01 AD 13 11

Applications
Belgian eID card: Browse to www.godot.be and use the applet that is loaded automatically (you might also need to make the symlink as indicated). Needless to say this application is very specific for eID cards. You will see things happening in your running pcscd too: winscard_msg_srv.c:203:SHMProcessEventsServer Common channel packet arrival winscard_msg_srv.c:212:SHMProcessEventsServer SHMProcessCommonChannelRequest detects: 7 pcscdaemon.c:151:SVCServiceRunLoop A new context thread creation is requested: 7 winscard_svc.c:129:ContextThread Thread is started: 7 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard_svc.c:171:ContextThread Client is protocol version 2:0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:159:SCardEstablishContext Establishing Context: 17015081 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:213:SCardConnect Attempting Connect to O2Micro SmartCardBus Reader 00 00 using protocol: 3 prothandler.c:130:PHSetProtocol Attempting PTS to T=0 winscard.c:323:SCardConnect Active Protocol: T=0 winscard.c:333:SCardConnect hCard Identity: 1d068 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0 winscard_msg_srv.c:274:SHMProcessEventsContext correctly processed client: 7 winscard.c:1464:SCardTransmit Send Protocol: T=0

Acer's green security card (360Degree PlatinumPAS/PlatinumSecret actually) I haven't found much useful here. It's not that it doesn't work, it's just that I haven't found an application yet to use it with, or read it out with.

When trying any of the commands from opensc, I get (long version, sorry): opensc-tool -avvvvvvv sc.c:168:sc_detect_card_presence: called sc.c:173:sc_detect_card_presence: returning with: 1 Connecting to card in reader O2Micro SmartCardBus Reader 00 00... card.c:110:sc_connect_card: called card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:6e:00:ff:45:73:74:45:49:44:20:76:65:72:20:31:2e:30 card.c:762:match_atr_table: ATR try : 3b:fe:94:00:ff:80:b1:fa:45:1f:03:45:73:74:45:49:44:20:76:65:72:20:31:2e:30:43 reader-pcsc.c:536:pcsc_connect: Requesting reader features ... reader-pcsc.c:567:pcsc_connect: SCardControl failed -2146435068 card.c:140:sc_connect_card: matching configured ATRs card.c:182:sc_connect_card: matching built-in ATRs card.c:188:sc_connect_card: trying driver: cardos card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:e2:00:ff:c1:10:31:fe:55:c8:02:9c card.c:762:match_atr_table: ATR try : 3b:f2:98:00:ff:c1:10:31:fe:55:c8:03:15 card.c:762:match_atr_table: ATR try : 3b:f2:98:00:ff:c1:10:31:fe:55:c8:04:12 card.c:762:match_atr_table: ATR try : 3b:f2:18:00:ff:c1:0a:31:fe:55:c8:06:8a card.c:762:match_atr_table: ATR try : 3b:f2:18:00:02:c1:0a:31:fe;55:c8:07:76 card.c:762:match_atr_table: ATR try : 3b:e9:00:ff:c1:10:31:fe:55:00:64:05:00:c8:02:31:80:00:47 card.c:762:match_atr_table: ATR try : 3b:fb:98:00:ff:c1:10:31:fe:55:00:64:05:20:47:03:31:80:00:90:00:f3 card.c:762:match_atr_table: ATR try : 3b:fc:98:00:ff:c1:10:31:fe:55:c8:03:49:6e:66:6f:63:61:6d:65:72:65:28 card.c:762:match_atr_table: ATR try : 3b:f4:98:00:ff:c1:10:31:fe:55:4d:34:63:76:b4 card.c:188:sc_connect_card: trying driver: cardos card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:e2:00:ff:c1:10:31:fe:55:c8:02:9c card.c:762:match_atr_table: ATR try : 3b:f2:98:00:ff:c1:10:31:fe:55:c8:03:15 card.c:762:match_atr_table: ATR try : 3b:f2:98:00:ff:c1:10:31:fe:55:c8:04:12 card.c:762:match_atr_table: ATR try : 3b:f2:18:00:ff:c1:0a:31:fe:55:c8:06:8a card.c:762:match_atr_table: ATR try : 3b:f2:18:00:02:c1:0a:31:fe;55:c8:07:76 card.c:762:match_atr_table: ATR try : 3b:e9:00:ff:c1:10:31:fe:55:00:64:05:00:c8:02:31:80:00:47 card.c:762:match_atr_table: ATR try : 3b:fb:98:00:ff:c1:10:31:fe:55:00:64:05:20:47:03:31:80:00:90:00:f3 card.c:762:match_atr_table: ATR try : 3b:fc:98:00:ff:c1:10:31:fe:55:c8:03:49:6e:66:6f:63:61:6d:65:72:65:28 card.c:762:match_atr_table: ATR try : 3b:f4:98:00:ff:c1:10:31:fe:55:4d:34:63:76:b4 card.c:188:sc_connect_card: trying driver: flex card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:95:15:40:20:68:01:02:00:00 card.c:762:match_atr_table: ATR try : 3B:95:15:40:FF:68:01:02:02:01 card.c:762:match_atr_table: ATR try : 3B:95:15:40:FF:68:01:02:02:04 card.c:762:match_atr_table: ATR try : 3B:85:40:20:68:01:01:05:01 card.c:762:match_atr_table: ATR try : 3B:95:94:40:FF:63:01:01:02:01 card.c:762:match_atr_table: ATR try : 3B:95:18:40:FF:64:02:01:01:02 card.c:762:match_atr_table: ATR try : 3B:95:18:40:FF:62:01:02:01:04 card.c:762:match_atr_table: ATR try : 3B:95:18:40:FF:62:04:01:01:05 card.c:762:match_atr_table: ATR try : 3B:E2:00:00:40:20:49:06 card.c:762:match_atr_table: ATR try : 3B:E2:00:00:40:20:49:05 card.c:762:match_atr_table: ATR try : 3B:E2:00:00:40:20:49:07 card.c:762:match_atr_table: ATR try : 3B:85:40:20:68:01:01:03:05 card.c:762:match_atr_table: ATR try : 3B:02:14:50 card.c:762:match_atr_table: ATR try : 3B:19:14:55:90:01:02:01:00:05:04:B0 card.c:762:match_atr_table: ATR try : 3B:32:15:00:06:80 card.c:762:match_atr_table: ATR try : 3B:32:15:00:06:95 card.c:762:match_atr_table: ATR try : 3B:19:14:59:01:01:0F:01:00:05:08:B0 card.c:762:match_atr_table: ATR try : 3B:19:14:55:90:01:01:01:00:05:08:B0 card.c:762:match_atr_table: ATR try : 3B:16:94:81:10:06:01:81:3F card.c:762:match_atr_table: ATR try : 3B:16:94:81:10:06:01:81:2F card.c:188:sc_connect_card: trying driver: cyberflex card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:95:15:40:20:68:01:02:00:00 card.c:762:match_atr_table: ATR try : 3B:95:15:40:FF:68:01:02:02:01 card.c:762:match_atr_table: ATR try : 3B:95:15:40:FF:68:01:02:02:04 card.c:762:match_atr_table: ATR try : 3B:85:40:20:68:01:01:05:01 card.c:762:match_atr_table: ATR try : 3B:95:94:40:FF:63:01:01:02:01 card.c:762:match_atr_table: ATR try : 3B:95:18:40:FF:64:02:01:01:02 card.c:762:match_atr_table: ATR try : 3B:95:18:40:FF:62:01:02:01:04 card.c:762:match_atr_table: ATR try : 3B:95:18:40:FF:62:04:01:01:05 card.c:762:match_atr_table: ATR try : 3B:E2:00:00:40:20:49:06 card.c:762:match_atr_table: ATR try : 3B:E2:00:00:40:20:49:05 card.c:762:match_atr_table: ATR try : 3B:E2:00:00:40:20:49:07 card.c:762:match_atr_table: ATR try : 3B:85:40:20:68:01:01:03:05 card.c:762:match_atr_table: ATR try : 3B:02:14:50 card.c:762:match_atr_table: ATR try : 3B:19:14:55:90:01:02:01:00:05:04:B0 card.c:762:match_atr_table: ATR try : 3B:32:15:00:06:80 card.c:762:match_atr_table: ATR try : 3B:32:15:00:06:95 card.c:762:match_atr_table: ATR try : 3B:19:14:59:01:01:0F:01:00:05:08:B0 card.c:762:match_atr_table: ATR try : 3B:19:14:55:90:01:01:01:00:05:08:B0 card.c:762:match_atr_table: ATR try : 3B:16:94:81:10:06:01:81:3F card.c:762:match_atr_table: ATR try : 3B:16:94:81:10:06:01:81:2F card.c:188:sc_connect_card: trying driver: gpk card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:27:00:80:65:A2:04:01:01:37 card.c:762:match_atr_table: ATR try : 3B:27:00:80:65:A2:05:01:01:37 card.c:762:match_atr_table: ATR try : 3B:27:00:80:65:A2:0C:01:01:37 card.c:762:match_atr_table: ATR try : 3B:A7:00:40:14:80:65:A2:14:01:01:37 card.c:762:match_atr_table: ATR try : 3B:A7:00:40:18:80:65:A2:08:01:01:52 card.c:762:match_atr_table: ATR try : 3B:A7:00:40:18:80:65:A2:09:01:01:52 card.c:762:match_atr_table: ATR try : 3B:A7:00:40:18:80:65:A2:09:01:02:52 card.c:762:match_atr_table: ATR try : 3B:A7:00:40:18:80:65:A2:09:01:03:52 card.c:188:sc_connect_card: trying driver: miocos card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:9D:94:40:23:00:68:10:11:4D:69:6F:43:4F:53:00:90:00 card.c:762:match_atr_table: ATR try : 3B:9D:94:40:23:00:68:20:01:4D:69:6F:43:4F:53:00:90:00 card.c:188:sc_connect_card: trying driver: mcrd card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:FF:94:00:FF:80:B1:FE:45:1F:03:00:68:D2:76:00:00:28:FF:05:1E:31:80:00:90:00:23 card.c:762:match_atr_table: ATR try : 3B:FE:94:00:FF:80:B1:FA:45:1F:03:45:73:74:45:49:44:20:76:65:72:20:31:2E:30:43 card.c:762:match_atr_table: ATR try : 3B:6E:00:FF:45:73:74:45:49:44:20:76:65:72:20:31:2E:30 card.c:188:sc_connect_card: trying driver: setcos card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:1F:11:00:67:80:42:46:49:53:45:10:52:66:FF:81:90:00 card.c:762:match_atr_table: ATR try : 3B:9F:94:40:1E:00:67:16:43:46:49:53:45:10:52:66:FF:81:90:00 card.c:762:match_atr_table: ATR try : 3b:9f:94:40:1e:00:67:00:43:46:49:53:45:10:52:66:ff:81:90:00 card.c:762:match_atr_table: ATR try : 3b:6b:00:ff:80:62:00:a2:56:46:69:6e:45:49:44 card.c:762:match_atr_table: ATR try : 3b:64:00:ff:80:62:00:a2 card.c:762:match_atr_table: ATR try : 3b:7b:00:00:00:80:62:00:51:56:46:69:6e:45:49:44 card.c:762:match_atr_table: ATR try : 3b:64:00:00:80:62:00:51 card.c:762:match_atr_table: ATR try : 3b:6e:00:00:00:62:00:00:57:41:56:41:4e:54:10:81:90:00 card.c:762:match_atr_table: ATR try : 3b:7b:94:00:00:80:62:11:51:56:46:69:6e:45:49:44 card.c:762:match_atr_table: ATR try : 3b:9f:94:80:1f:c3:00:68:10:44:05:01:46:49:53:45:31:c8:07:90:00:18 card.c:762:match_atr_table: ATR try : 3b:9f:94:80:1f:c3:00:68:11:44:05:01:46:49:53:45:31:c8:00:00:00:00 card.c:188:sc_connect_card: trying driver: starcos card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:B7:94:00:c0:24:31:fe:65:53:50:4b:32:33:90:00:b4 card.c:762:match_atr_table: ATR try : 3B:B7:94:00:81:31:fe:65:53:50:4b:32:33:90:00:d1 card.c:188:sc_connect_card: trying driver: tcos card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:BA:13:00:81:31:86:5D:00:64:05:0A:02:01:31:80:90:00:8B card.c:762:match_atr_table: ATR try : 3B:BA:14:00:81:31:86:5D:00:64:05:14:02:02:31:80:90:00:91 card.c:762:match_atr_table: ATR try : 3B:BA:96:00:81:31:86:5D:00:64:05:60:02:03:31:80:90:00:66 card.c:762:match_atr_table: ATR try : 3B:BA:96:00:81:31:86:5D:00:64:05:7B:02:03:31:80:90:00:7D card.c:188:sc_connect_card: trying driver: openpgp card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:fa:13:00:ff:81:31:80:45:00:31:c1:73:c0:01:00:00:90:00:b1 card.c:188:sc_connect_card: trying driver: jcop card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:E6:00:FF:81:31:FE:45:4A:43:4F:50:33:31:06 card.c:188:sc_connect_card: trying driver: oberthur card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:7D:18:00:00:00:31:80:71:8E:64:77:E3:01:00:82:90:00 card.c:762:match_atr_table: ATR try : 3B:7D:18:00:00:00:31:80:71:8E:64:77:E3:02:00:82:90:00 card.c:762:match_atr_table: ATR try : 3B:7D:11:00:00:00:31:80:71:8E:64:77:E3:01:00:82:90:00 card.c:762:match_atr_table: ATR try : 3B:7D:11:00:00:00:31:80:71:8E:64:77:E3:02:00:82:90:00 card.c:762:match_atr_table: ATR try : 3B:7B:18:00:00:00:31:C0:64:77:E3:03:00:82:90:00 card.c:188:sc_connect_card: trying driver: belpic card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3B:98:13:40:0A:A5:03:01:01:01:AD:13:11 card.c:762:match_atr_table: ATR try : 3B:98:94:40:0A:A5:03:01:01:01:AD:13:10 card.c:762:match_atr_table: ATR try : 3B:98:94:40:FF:A5:03:01:01:01:AD:13:10 card.c:188:sc_connect_card: trying driver: atrust-acos card.c:188:sc_connect_card: trying driver: emv card-emv.c:99:emv_match_card: ATR parse: TA1 = 0x11 TB1 = 0x00 TC1 = 0x00 TD1 = 0x81 TD2 = 0x71 card-emv.c:102:emv_match_card: historic bytes: 40 42 00 00 21 01 31 42 52 00 05 63 40 4B 01 @B..!.1BR..c@K. card.c:188:sc_connect_card: trying driver: incrypto34 card.c:754:match_atr_table: ATR    : 3b:ff:11:00:00:81:71:40:42:00:00:21:01:31:42:52:00:05:63:40:4b:01:0e:90:00:ef card.c:762:match_atr_table: ATR try : 3b:ff:18:00:ff:81:31:fe:55:00:6b:02:09:02:00:01:01:01:43:4e:53:10:31:80:9f card.c:762:match_atr_table: ATR try : 3b:ff:18:00:ff:81:31:fe:55:00:6b:02:09:02:00:01:01:01:44:53:44:10:31:80:92 card.c:188:sc_connect_card: trying driver: piv card-piv.c:1307:piv_match_card: called card.c:188:sc_connect_card: trying driver: default card.c:194:sc_connect_card: matched: Default driver for unknown cards card-default.c:51:autodetect_class: autodetecting CLA byte card-default.c:54:autodetect_class: trying with 0x00 apdu.c:504:sc_transmit_apdu: called card.c:289:sc_lock: called card.c:316:sc_unlock: called card.c:327:sc_unlock: Calling card logout function card.c:541:sc_select_file: called; type=2, path=3f00 apdu.c:504:sc_transmit_apdu: called iso7816.c:99:iso7816_check_sw: Wrong parameter(s) P1-P2 iso7816.c:458:iso7816_select_file: returning with: Incorrect parameters in APDU card.c:563:sc_select_file: returning with: Incorrect parameters in APDU card-default.c:75:autodetect_class: got strange SWs: 0x6D 0x00 card-default.c:82:autodetect_class: detected CLA byte as 0x00 card-default.c:86:autodetect_class: SELECT FILE returned 0 bytes card.c:219:sc_connect_card: card info: Unidentified card, -1, 0x0 card.c:220:sc_connect_card: returning with: 0 Using card driver Default driver for unknown cards. card.c:289:sc_lock: called Card ATR: 3B FF 11 00 00 81 71 40 42 00 00 21 01 31 42 52 ;.....q@B..!.1BR 00 05 63 40 4B 01 0E 90 00 EF                  ..c@K..... card.c:316:sc_unlock: called card.c:327:sc_unlock: Calling card logout function card.c:541:sc_select_file: called; type=2, path=3f00 apdu.c:504:sc_transmit_apdu: called iso7816.c:99:iso7816_check_sw: Wrong parameter(s) P1-P2 iso7816.c:458:iso7816_select_file: returning with: Incorrect parameters in APDU card.c:563:sc_select_file: returning with: Incorrect parameters in APDU card.c:234:sc_disconnect_card: called card.c:249:sc_disconnect_card: returning with: 0 ctx.c:728:sc_release_context: called The default driver matches but then it seems to speak a dialect opensc doesn't know, which is very logical since all the software from 360Degree is very proprietary (it's meant to be a security card!). I see things happening in pcscd as well. By the way it's not really secure whatsoever, it's just there to make you believe that, e.g..

Things I could also try: - try mounting it or using it via udev or via /proc or /sys. - try using it as a token for pam (was mentioned once on the forum i think), this way it would be secure. - (g)smartcard, but i couldn't get it to compile yet.

Any other ideas?

The information about the CardMan4000 drivers below is all deprecated:


 * I have got the smartcard to work with this laptop (from a certain point of view :) ). I just read in the forum that some of you already got this to work (as far as i did).


 * Get the cm4000-drivers from omnikey.com.


 * Install the newest pcsc-lite package from portage (at least v1.2.0):

[ ! -d /etc/portage] && mkdir -p /etc/portage echo 'sys-apps/pcsc-lite ~x86' >> /etc/portage/package.keywords emerge pcsc-lite


 * Create the necessary directories that pcsc uses.

mkdir -p /usr/lib/pcsc/drivers mkdir -p /usr/lib/usb/drivers
 * You probably wont be needing the usb-directory.


 * Run the install-script from the cm4000-source-directory, and it will compile the drivers and install runscripts and config-files.


 * Restart pcmcia if the script doesnt do that:

/etc/init.d/pcmcia restart


 * Start pcsc:

/etc/init.d/pcscd start


 * Try to run pcsc_demo, and see if it detects your smartcard-reader, if not continue on reading.


 * I had to edit some files. Check this line in /etc/reader.conf

LIBPATH /usr/lib/pcsc/drivers/libcm4000.so


 * My /etc/pcmcia/cardman_cs.conf looks like this:

device "cardman_cs" class "smartcard" module "cardman_cs" card "O2Micro" manfid 0xffff, 0x0001 bind "cardman_cs"


 * Check your manfid values with: cardctl info


 * Restart pcmcia


 * Try running pcscd from a terminal:

pcscd -f


 * Check again with pcsc_demo to see if it detects the reader.


 * You can try ejecting and inserting the card with cardctl

cardctl eject 1 cardctl insert 1


 * Make sure the system can find and use the library, cm4000.

ld -lcm4000
 * You will get a lot of output if it finds it, or else you get "cannot find". Check your /etc/ld.so.conf and add /usr/lib/pcsc/drivers


 * Hotplug will be able to load the driver cardman_cs if everything is ok, check lsmod.


 * This was written in a hurry, use the forum at forum.gentoo.org if you wonder about anything, maybe i'll see it and i can explain furthermore.


 * I was able to get pcsc_demo to detect my reader, but it didnt detect any card inserted, strange since it is actually inserted :)


 * But i thought someone had to start working on this smartcardreader. Feel free to test and write more.


 * --Fatrix


 * I followed your description step by step. After a couple of hours playing around and debugging I found out that this driver will not work. The smartcard reader does not respond to any commands from this driver (All readings from the I/O port return 0x00). I also found nobody actually working on a driver. O2Micro has a binary driver for Redhat 7.2 which will not work on actual distributions/kernels. I think that they have only licensed the smartcard technology and because of that they cannot release documentation or the source of the "old" driver.


 * --Bernhard beimoe**at**web. ;-)


 * The correct driver is available at http://www.musclecard.com/sourcedrivers.html - I've sofar not gotten it to work yet.


 * -- Jan *at* kcore *dot* org

Special Laptop-Keys aka FN-Keys

 * Reference
 * xOSD Homepage
 * Enlightened OSD
 * Requirements

Windows Keys

 * Because I'm using fluxbox I have no real need for those keys. But for one reason I include those keys here: I found it rather annoying to use FN+Home or FN+End to jump in text lines, so I remapped those for Home and End. This is a very simple task when using Xmodmap. Just add a file called 'Xmodmap' to your home directory and add the following lines:


 * Done this you need to tell your XFree server to load this remapping when starting your favourite window manager. To accomplish this just add the following line to your '.xsession' file:


 * This will invoke the usespace tool 'xmodmap' to redefine your keycodes. Of course you can also redifine other keys.

System Help

 * Key combination: FN+F1
 * This key comnation doesn't have any effect yet.

ACPI Standby/Sleep

 * Key combination: FN+F4
 * This combination triggers the ACPI sleep action which needs to be defined in '/etc/acpi/events/default'.

Video Out

 * Key combination: FN+F5
 * This combination uses raw BIOS calls and works out of the box.

External Display

 * Key combination: FN+F6
 * Again raw BIOS calls. But beware, you must connect your external device (e.g. Beamer, Monitor, etc.) BEFORE you power on.
 * If you don't, your device may get lost from the BIOS and doesn't work until reboot.

Touchpad Activator

 * Key combination: FN+F7
 * This key function activates/deactivates the touchpad directly without any os interference. But be carefull: Sometimes you could hit those without notice and afterwards wonder why your touchpad isn't working and maybe even call for support.
 * Be warned.

Mute Sound

 * Key combination: FN+F8
 * See Volume Keys

Display Bightness

 * Key combination: FN+LEFT/RIGHT
 * The display dimming or display brightness Keys are working with raw BIOS calls and so there are no special tricks to handle. They should work right out of the box.

Volume FN-Keys

 * To get the Volume keys to work we first need the correct keycodes for those keys. To aquire the keycodes they use just fire up a xterm in XFree and start 'xev'. Now press the keys and watch xev's reaction to it. The correct keycodes for my laptop were:
 * Raise Volume (Fn + UP) : 176
 * Lower Volume (Fn + DOWN): 174
 * Going on now we'll need to map these keycodes to specific events in XFree. Again we are using the 'Xmodmap' file and add the following:


 * After that you'll need to map these events to specific commands. As I use fluxbox I need to add some actions to my ~/.fluxbox/keys file:


 * Before this can work, as you've probably noticed, you need to emerge media-sound/setmixer. Now you're set to use your volume keys in XFree.
 * Hint: I don't use the keycode for mute (160) because it interferes with the button "e"!

Volume Keys and XFree OSD

 * So, as time goes by, I've discovered a cool feature (maybe some of you know already), the XFree-OSD library. You can display any message or text with the tool osd_cat directly on your XFree screen. This will enable us to implement all the funtions (and some more) the windows tools enable e.g. switching the sound. Let's begin installing the x11-libs/xosd package as it will provide you with all necessary tools:

bash$ emerge x11-libs/xosd
 * After successfull installation simply add a new file called osd.sh to your ~/bin directory (or somewhere similar):


 * Another way to do this, with using the amixer (included in the Alsa-Utils) instead of setmixer, with Mute functionality (in a way that don't need the Mute Switch in the Alsamixer, which seems to be broken in some cases):


 * After this make the file executable:

bash$ chmod 770 osd.sh
 * Executing this script will set a new volume and diplay it via OSD directly on your XFree screen. To use it with your already defined volume hotkeys (see above) simply change your keys assignments:


 * Now try it, it should produce a really nice OSD-Volume display. Just for the coders out there: You can paste anything (like tail -f ...) to the osd_cat command...really nice.
 * In case you're using KDE, just click through Control Center/Regional & Accessibility/Keyboard Layout and change your keyboard model to "Laptop/notebook Dell Inspiron 8xxx" et voilà, your volume keys are working!

Other FN-Keys

 * All other key combinations like numeric pad, numlock, scroll-lock, etc work right out of the box. They also make raw BIOS calls, thus the system is not required to be configured here.

Hints

 * If you don't like messing around with Xmodmap's config files directly, you can also emerge x11-misc/xkeycaps which is a GUI frontent for xmodmap.

The other way

 * This was found at tutorial for debian. Check the site for more options (german only)

bash$ emerge hotkeys

Acer Launchkeys & AcerHK

 * Reference
 * AcerHK Website
 * Requirements
 * http://www.informatik.hu-berlin.de/~tauber/acerhk/archives/acerhk-0.5.13.tar.bz2 (or: emerge acerhk)

Installing

 * To be able to use the four hotkeys (mail, web, P1 and P2) you need a special driver called acerhk. Beside the keys this driver will also give you control over the mail LED, the wireless LED and the bluetooth LED. This driver resides in portage as app-laptop/acerhk. Alternatively, you can install it manually. First you'll have to download the driver from http://www.informatik.hu-berlin.de/~tauber/acerhk/ and untar it in a directory of your choice. I prefer to include the acerhk driver directly into the kernel. The current version is acerhk-0.5.13. Note that support for the 800-series is still experimental, allthough it seems to work for me and others:

bash$ cd /usr/src/linux/drivers/misc bash$ wget http://www.informatik.hu-berlin.de/~tauber/acerhk/archives/acerhk-0.5.13.tar.bz2 bash$ tar xvfj acerhk-0.5.13.tar.bz2 bash$ mv acerhk-0.5.13 acerhk
 * As we copied the source files directly into the desired kernel directory. Now we just have to include the driver directory in the config files. Just add the following lines to the config file /usr/src/linux/drivers/misc/Kconfig as shown below:


 * Now include the acerhk directory in it's parents Makefile (/usr/src/linux/drivers/misc/Makefile) and add the following line:


 * Next you'll have to activate the misc drivers first by sourcing them:

bash$ source "drivers/misc/Kconfig"
 * One last step and the installation process is finished. Go to your favourite kernel config (make menuconfig, oldconfig, gconfig) and enable the acerhk driver by activating


 * Now recompile your kernel and install it. After a reboot with your new kernel you should have a fresh working acerhk module you can load. It's as easy as that!

Testing & Mapping

 * Now it's time to read the README file included with the driver (again the last part)... or you can read below. First load the module or put it in /etc/modules.autoload.d/kernel-2.6 to load it at every bootup automatically

bash$ modprobe acerhk
 * Now you can interact with the driver at:

bash$ cd /proc/driver/acerhk/ bash$ ls -al dr-xr-xr-x 2 root root 0 Jul  5 20:11. dr-xr-xr-x 4 root root 0 Jul  5 20:11 .. --w--w--w- 1 root root 0 Jul  5 20:11 blueled -r--r--r-- 1 root root 0 Jul  5 20:11 info -r--r--r-- 1 root root 0 Jul  5 20:11 key --w--w--w- 1 root root 0 Jul  5 20:11 led --w--w--w- 1 root root 0 Jul  5 20:11 wirelessled
 * If you can see these entries, all is set up and should work. Let's go on! First press some hotkeys and then type "dmesg" in a terminal. You'll see that the kernel has detected your keypresses (and releases). Here's what the README says about it:
 * If you have one of the newer models with the dritek hardware , use kernel 2.6 and get (after enabling it) kernel messages of the form:

atkbd.c: Unknown key pressed (translated set 2, code 0xf4 on isa0060/serio0). atkbd.c: Use 'setkeycodes e074 ' to make it known.
 * then you should do exactly what your told. In this case you could do

setkeycodes e074 158
 * to map the button with scancode e074 (hex) to keycode 158 (decimal).

... The keycode you give as parameter to setkeycodes is one out of the header file /usr/src/linux/include/linux/input.h ...
 * In my case I just had to do

setkeycodes e074 149
 * twice, once for e074 and once for e073. The keycode didn't matter because it seemed to choose it's own. It got set to 158 despite me asking for 149. Also all four keys got defined!?? So to get your keys working after boot, just edit /etc/conf.d/keycodes to map the scancodes to keycodes:


 * and install the keycodes rc script to your runlevel by typeing

bash$ rc-update add keycodes default
 * If your keycodes script is missing, just create it:


 * Thats it, you're almost done. After a reboot or start of the keycodes script you should be able to get some output from e.g. xev for your keys pressed. I mapped all keys to F17 to F20 with xmodmap so I can access them easily in XFree. Just edit your .Xmodmap file and add:

bash$ xmodmap /etc/X11/Xmodmap
 * After execution of xmodmap all your keys should be mapped ready for use. For the gnome 2.6 users amongst you: You can now define actions for these keys in the "Multimedia keys" dialog. My settings seemed a bit gibberish because my "Preferred applications" dialog wouldn't hangon to my choices at first (not even via GConf) and I also had to redefine the multimedia keys once by deleting them and redefining them... But anyhow, at least now they are staying where I put them.

Scripts

 * I would suggest we gather some nice ways of utilizing the keys and the LEDs here. I'll start with some scripts to automize mailprocessing with gnome 2.6 and Ximian Evolution:


 * Put a Postbus-Monitor-2.6 applet on your panel and copy these scripts to /usr/bin (with right chmod 755 ofcourse). Setup the applet and set "ledon" to be executed when a new mail arrives. Set "mailchecked" to be executed on a double click. Also put "mailchecked %s" as your mail application in the "Preferred applications" dialog and link the mail hotkey to opening your mail. Now, when "you've got mail!", your LED will blink until you press the mail hotkey, which will launch Evolution (eventually already writing a new mail to %s) and turn off the LED. The mailto:%s command from your browser will still work.

Graphics
Their are two normal ways to get your radeon mobility 9000 running with 3d acceleration in Xorg.

Xorg and OpenSource Drivers
Have a look at DRI with ATi Open-Source Drivers at that wiki, it is much more up-to-date than the older paragraph of this article.

By the way I choose this way, so I can add some further information - like my xorg.conf. Right now I have installed kernel-2.6.18-gentoo-r6 and Xorg 7.1, maybe in the future someone will be interested in that.

Insert into your /etc/make.conf VIDEO_CARDS="radeon"

Yes, you really need module intel-agp and not ati-agp.

Don't forget to reemerge x11-drm after updating to a new kernel.

I have two xorg.conf, one for laptop only use and one for dualhead mode at home, I switch them via an own runlevel for dualhead mode. Let me add both, may be I help someone.

This driver only support 3d acceleration up to 2048x2048, so if you have a bigger desktop like me in the dualhead mode, you have 3d acceleration only on a part of your desktop, for me it works on 1 and a half monitor.

Xorg and ATI ClosedSource Drivers (until ati-drivers-8.28-r1)
Caution: ATI removed support for the Radeon Mobility 9000 Series in later releases of its closed-source drivers. Which means that you'll be forced to stay with 2.6.17-kernels and older versions of XOrg - a great disadvantage considering better ipw2100-integration in later kernel versions and XOrg getting better with each release. It is therefore recommended to use the Radeon open-source drivers, which work flawlessly in combination with latest kernel and XOrg releases, including 3D-acceleration and AIGLX-support.

However, if you prefer to use fglrx, have a look at Fglrx at that wiki, it is much more up-to-date than the older paragraph of this article.

Console Framebuffer

 * To get an high resolution framebuffer console in normal text mode, you'll need to tune your kernel a little bit. For Information on how to do that, see Framebuffer Support HOWTO.


 * Hint: to get the native 1400x1050 resolution, vga="0x342" is the VESA mode you'll need.

Sound

 * Reference
 * Requirements


 * This topic is fairly easy as ALSA works right out of the box with kernel 2.6. To get the correct drivers you'll need to enable


 * in your kernel settings. This will give you the interfaces to your AC97 sound chip in '/dev/sound/' with access to all volume settings, a dsp, sequencers and a mixer. After that you should emerge 'alsamixer' or some other tool to adjust your volume settings (I prefer gkrellm).

Universal Serial Bus (USB)

 * Reference
 * pam_usb Project
 * PAM X509 Authentication Module
 * Requirements
 * sys-apps/hotplug
 * app-admin/usbview
 * sys-libs/pam_usb

General Hotplug

 * For the USB section ahead the package 'sys-apps/hotplug' is esseantial as it manages all module loading and unloading required for several devices you can use with USB. To install hotplug just do

bash$ emerge sys-apps/hotplug bash$ rc-update add hotplug default
 * Also hotplug needs to be added to runlevel 'default' as you can see. This will load the hotplugd daemon at boot time. Just a little hint from me: Don't add hotplug to runlevel 'boot' (pointed out in several howto's if read) as it needs several variables from runlevel default.

General USB

 * The USB-Hub-Controller of the Acer Travelmate 803 LCi is an EHCI USB 2.0 compatible device. So all you have to do is to change the settings in your kernel to support the device. Also, for using USB 1.1 compatible devices, you need to select the UHCI module:


 * Chosen this settings you'll have basic USB 1.1 and 2.0 support compiled into the kernel as modules. Ahead now comes the customization section where several devices are discussed, so keep on reading before you compile your kernel.

USB-Mouse

 * Most people nowadays use an USB-Mouse despite of the tbuilt in touchpad, because it's more comfortable. To install the support for the most common mouse devices, you'll just have to activate the following also residing in the USB section:


 * This will get you, in combination with hotplug a comfortable way to work with your mouse through the interface '/dev/input/mice' The USB kernel modules will automatically be loaded by hotplug if you plug in your device so no modules need to be loaded at boot time.

USB-Mouse and XFree support

 * To get your freshly installed mouse to work with XFree you need to tweak your 'InputDevice' section in '/etc/X11/XF86Config':

bash$ vi /etc/X11/XF86Config Section "InputDevice" Identifier "USBMouse" Driver     "mouse" Option "Protocol"   "ImPS/2" Option "Device"     "/dev/input/mice" Option "ZAxisMapping" "4 5" EndSection
 * The 'Option "ZAxisMapping" "4 5"' will also give you back your mouse-wheel and third button. After that you normally have to add the following lines to your 'ServerLayout' section as it needs to be registered as pointer device. The following lines will get the touchpad and the USB-Mouse working both at the same time:

Section "ServerLayout" InputDevice "USBMouse" "CorePointer" InputDevice "Mouse2" "SendCoreEvents" InputDevice "Keyboard1" "CoreKeyboard" EndSection
 * After a restart of XFree you're all set to use you USB-Mouse with XFree.

USB Tools

 * Just for making this topic complete I want to mention the tool usbview which is available through portage via:

bash$ emerge app-admin/usbview.
 * Now just start it in Xfree.

RootPlug

 * RootPlug is a fine thing to work with, as you only have to edit a file in your kernel directory. The file you need is '/usr/src/linux/security/root_plug.c'. But first you have to determine the vendor- and product-id of your root-plug-device. To do this, just fire up 'usbview' an look for your device. Next you'll have to extract the following information from the usbview-diplay:

Vendor Id: 033a Product Id: 025f
 * These are the values you need to edit your device section in the root-plug file mentioned above accordingly:


 * After you've managed this, you simply have to enable some kernel options as shown below:


 * After recompiling your kernel a module named 'root_plug' which can be loaded via

bash$ modprobe root_plug
 * But be warned: If ever your device is broken, you'll only be able to recover your root-state by circumventing your module loading phase by using a boot cdrom or another kernel (e.g. kernel 2.4.) without RootPlug support.

USB-Memory-Stick

 * A USB-Memory-Stick is a fine thing to make a quick backup of your config and favourite data or to store important data on. If you emerged the 'sys-apps/hotplug' package you nearly have all you need. Some kernel settings have to be adjusted to get the USB-Memory-Sticks work. First we need the SCSI section as this will give us a device in '/dev/scsi/' later if you plug in a memory stick.


 * Now we go on to the real USB section to enable all those neat USB mass storage devices.


 * The settings ahead are not neccessary as you already have the basic settings for your device, but who knows which hardware you'll have to combat with. If you wish you can in addition enable:


 * Recompiled and installed your new kernel it will now be able to send some events if you plug in your memory stick. These events will be handled by 'hotplug' which will start the correct modules for your memory device. After plugging in your memory stick a new device will be in '/dev/scsi/hostX...' with the endpoints 'disc' and 'partX' where 'X' stands for a generic number. The 'disc' device can be easily mounted via the normal mount commant. Although the most usb memory sticks have a vfat filesystem, some are reported to go fine with ext2. Here is a sample of mounting an usb memory stick:

bash$ mount -t vfat /dev/scsi/host0/target0/lun0/disc /mnt/usb
 * Or you can try a simple:

bash$ mount /dev/sda1 /mnt/usb
 * Now you can access your usb memory stick through '/mnt/usb'. Be aware to 'sync' AND unmount your usb stick BEFORE you unplug it. If you don't, you may loose data and sure get a kernel oops.

User Authentification via pam_usb

 * In this section I want to explain some basic user authentification via an USB stick using the pam_usb modules. To begin we first have to emerge the sys-libs/pam_usb with

bash$ emerge sys-auth/pam_usb
 * After the finished installation of the module we will have a application called usbadm which is responsible for managing keys and serial numbers stored on you USB stick. So the next step would be generating a key for your authentication e.g. for root. First mount your USB stick to something like /mnt/usb

bash$ mount -t vfat /dev/sda /mnt/usb
 * Then use the admin application to generate a appropiate key for your login:

bash$ usbadm keygen /mnt/usb root 4096
 * This will create a directory /mnt/usb/.auth where all your keys are stored. Optionally you can also cipher your key on the USB stick with a password or add a serial number so the only device that is valid with this key is the current mounted. Just go ahead and play a little bit with the options of usbadm. Now comes the tricky part as usb_pam needs a little workaround since we are using kernel 2.6. We need to tell PAM how to authenticate you with pam_usb. So we'll edit /etc/pam.d/system-auth:


 * For PAM to use pam_usb we simply add the line above. After saving you can already try it, just fire up a normal user shell:

bash$ su - [device.c:287] Forcing device /dev/sda [device.c:267] Creating temporary mount point... [device.c:273] Using /tmp/pam_usbp9Y5UT as mount point [device.c:167] Trying to mount /dev/sda on /tmp/pam_usbp9Y5UT using vfat [device.c:175] Device mounted, trying to open private key [device.c:150] Opening /tmp/pam_usbp9Y5UT/.auth/root.somemachine [device.c:183] Private key opened [auth.c:135] Private key imported [auth.c:143] Public key imported [dsa.c:78] Checking DSA key pair...      [dsa.c:88] Signing pseudo random data [1 time(s)]... [dsa.c:95] Valid signature [dsa.c:88] Signing pseudo random data [2 time(s)]... [dsa.c:95] Valid signature [dsa.c:88] Signing pseudo random data [3 time(s)]... [dsa.c:95] Valid signature [pam.c:88] Access granted bash root$ _
 * As you can see pam_usb will automagically mount /dev/sda and look for a key to authenticate your account. I've done this for the account 'root' here but you can also do this for every account you like by just logging in that account, mount the USB stick and generate a new key. The keyfile on the USB stick will have an automatical generated name. You can also generate keys for other machines beside you laptop (of course you'll have to install pam_usb on them too). If you're finished with configuring the module and keys, just remove the entry 'debug=1' from the line in /etc/pam.d/system-auth to prevent pam_usb spitting out all those debug messages.

Synaptics Touchpad
Please also see the dedicated Synaptics Touchpad guide.


 * Reference
 * Debian on an ACER TravelMate 800LCi
 * Requirements
 * http://www.tuxmobil.org/software/synaptics/


 * To get the touchpad working in XFree 4.x/X.org you'll need a synaptics-linux-driver which provides all the functionality of the touchpad under XFree/X.org. You can obtain this driver by emerging it:

bash$ emerge synaptics
 * Once emerged you'll have to change a few lines in your 'InputDevice' section in '/etc/X11/XF86Config' or '/etc/X11/xorg.conf':

Section "InputDevice" Identifier     "SynapticsTouchpad" Driver         "synaptics" Option         "Device"        "/dev/psaux" Option         "ZAxisMapping"  "4 5" Option         "Edges"         "1900 5400 1800 3900" Option         "Finger"        "25 30" Option         "MaxTapTime"    "180" Option         "MaxTapMove"    "220" Option         "VertScrollDelta"       "100" Option         "MinSpeed"      "0.02" Option         "MaxSpeed"      "0.18" Option         "AccelFactor"   "0.0007" Option         "SHMConfig"     "on" Option         "UpDownScrolling"       "on" Option         "Protocol"      "ImPS/2" Option         "CorePointer"   "" EndSection
 * All you need to do now is to register this device in the 'ServerLayout' section also in this file:

Section "ServerLayout" InputDevice "USBMouse" "SendCoreEvents" InputDevice "SynapticsTouchpad" "CorePointer" InputDevice "Keyboard1" "CoreKeyboard" EndSection
 * This will add a pointer device for the Synaptics Touchpad for use in XFree. To use your mouse in an console (framebuffer or not) you'll need to use the 'sys-libs/gpm' package. First you'll have to install this package:

bash$ emerge sys-libs/gpm
 * This will give you the config files for 'gpm'. Change the following lines accordingly to the following to get your USB-Mouse and Synaptics Touchpad working in your text-console:


 * Done that, you may add gpm to one of your runlevels by

bash$ rc-update add gpm default
 * If you want to test it now (without rebooting) start the service manually by typing

bash$ /etc/init.d/gpm start
 * Now a little text coursor should appear when you move your mouse in an text-console. You can also use copy and paste like in XFree.
 * To use the tapping feature of the synaptics driver, enable the Event interface in the kernel.

Device Drivers > Input device support --> <*> Event interface

Firewire IEEE 1394

 * Reference
 * Requirements


 * The Acer Travelmate 803 LCi also has a firewire IEEE 1394 device. the kernel modules support a wide variety of firewire devices like harddiscs, cameras or LAN-over-1394. To enable all these features and the different hardware specific modules, enable the following settings in your kernel config:


 * After recompiling your kernel, you'll get several modules you can use to attach and work your firewire hardware. In special you'll get:

bash$ modprobe ieee1394.o
 * This is the standard interface for firewire support in the kernel. This has to be loaded always if you want to work with firewire.

bash$ modprobe ohci1394.o
 * As the firewire chipset is a OHCI-1394 specification compliant, this modules also has to be loaded.

bash$ modprobe video1394.o
 * This module enables video device usage for OHCI-1394 cards. Enable this module only if you have an IEEE 1394 video device connected to an OHCI-1394 card.

bash$ modprobe sbp2.o
 * This module enables you to use SBP-2 devices connected to your IEEE 1394 bus. SBP-2 devices include firewire-harddrives and DVD/CDROM devices.

bash$ modprobe dv1394.o
 * This module allows you to transmit and receive DV (digital video) over the OHCI-1394 firewire port.

bash$ modprobe raw1394.o
 * The raw firewire module enables direct communication of user programs with the IEEE 1394 bus and thus with the attached peripherals.

bash$ modprobe cmp.o
 * This module enables the Connection Management Procedures (IEC61883-1) driver, which implements input and output plugs. This is generally a good idea, because newer hardware also supports this feature.

bash$ modprobe amdtp.o
 * This module enables the Audio & Music Data Transmission Protocol (IEC61883-6) module, which implements audio transmission over IEEE1394.
 * This should get all your firewire hardware to work on kernel basis. For special needs you naturally need some userspace tools to use these features.

Styleguide

 * Reference
 * Qingy Homepage
 * Lilo Graphics Tutorial
 * Enlightenment Homepage
 * Requirements
 * media-gfx/bootsplash
 * Parts of the Enlightenment CVS
 * Parts of the Enlightenment CVS
 * Parts of the Enlightenment CVS
 * Parts of the Enlightenment CVS

Exchanging XFree Cursors

 * XFree 4.3 supports the feature of semi-transparent mouse pointers with shadows. To exchange your boring standard XFree cursor you need to emerge one of the following packages:


 * To enable the installed cursors you just need to edit or create the file ".Xdefaults" in your home directory:
 * To enable the installed cursors you just need to edit or create the file ".Xdefaults" in your home directory:
 * To enable the installed cursors you just need to edit or create the file ".Xdefaults" in your home directory:
 * To enable the installed cursors you just need to edit or create the file ".Xdefaults" in your home directory:


 * Done this just reload your XFree server and enjoy your new fancy cursors.

Bootsplash

 * To get bootsplash up and running with Gentoo and kernel 2.6 you'll need a little patience as this not an easy task. First of all you have to install bootsplash

bash$ emerge media-gfx/bootsplash
 * to get your rc-scripts and some files in '/sbin' patched. Now follows the tricky part: Download the bootsplash diff-file for kernel 2.6.x from the bootsplash homepage and place it in '/usr/src'. Next we patch the kernel with

bash$ patch -p1 < /path/to/bootsplash-3.0.7-2.6.xxxx-vanilla.diff
 * to get the correct options in menuconfig. If patching was successfull, enable the following settings in your newly patched kernel:


 * Also be sure to disable ALL BootLogo options in


 * as the interfere with the bootsplash configuration. Now recompile your kernel with all the new options set and copy it to your /boot (or whatever you use) directory. Next we will set up an appropiate splashscreen as an initrd:

bash$ splash -f -s /etc/bootsplash/gentoo/config/bootsplash-*.cfg >> /boot/initrd-*
 * The * marks the desired screen size you want to use. The defaults are 800x600, 1024x768, 1280x1024 or 1600x1200. I prefer the size of 1400x1050 as it is the maximum this LCD can display correctly. To use an initrd with 1400x1050 you might have to edit your background images to suit your resolution. In this case simply take your current background image and resize it with gimp to 1400x1050 and afterwards edit your config file in your '/etc/bootsplash/...' directory to fit the resolution. Next you'll have to edit your '/etc/lilo.conf' again to introduce the new compiled kernel to the initrd and bootsplash options:

bash$ vi /etc/lilo.conf image = /boot/kernel_2.6_splash vga=0x342 #1400x1050 root = /dev/hda2 initrd = /boot/initrd-1400x1050 append = "video=vesa:1400x1050,mtrr splash=silent" label = 2.6_fb_splash read-only
 * After altering your 'lilo.conf' accordingly, you're just two commands away from your bootsplash screen:

bash$ lilo bash$ rc-update add bootsplash default
 * Now you should be all set for your bootsplash screen at boot time. If you wish to exchange the default Gentoo theme (which looks really nice), just go ahead and download them from your favourite themes archive around the corner.

Qingy

 * Qingy is a replacement of getty. To enable it, follow the instructions in the Qingy Howto.

LILO Graphical Menu

 * This topic was a really hard one. Not because it's hard to do the configuration itself, but because of the fact that there is merely no documentation about this topic available. First, this will give you a graphical boot menu in LILO (not bootsplash) instead of the text driven menu default. To archive this, you'll have to do several steps. First step is to prepare a nice bmp picture to load. Second step takes you to the LILO configuration. First go ahead and get some nice picture and load it with gimp. Now resize you picture to 640x480 pixels and crop down the colors to 16. Next save it to '/boot' as an bmp picture. If gimp asks you for RLE compression, go ahead and select it. Second: Edit your '/etc/lilo.conf'. There is an important line, that has to be changed in order to get graphics, so be aware. As the file differs from system to system, I only point out the major changes here.


 * Thats it. Remember to change the IMPORTANT lines. Just mess around some with the 'bmp-*' settings, as a description is included. More information can be found in the 'man lilo.conf'. Now fire up lilo and reboot. If everything works fine, you're setup for some cool graphics boot menu.

Engage as OSXbar (from e17)

 * I stumbled across this nifty little thing on my way through the Gentoo-Forums a while ago. This tool is called engage and it's main purpose is to emulate an applicationbar similar to the bar found in OSX. It looks really nice, so i gave it a try. I gathered some screenshots and even a little video demonstrating engage
 * Demonstration Video
 * Screenshots

There is currently no single ebuild available, so we have to check out the current CVS version: cd /usr/portage/distfiles/cvs-src cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment login cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment co misc/engage cd misc/engage
 * If CVS asks you for a password, just hit enter. Engage depends on some libraries found in the englightenment-cvs so we have to install them first before we go on

emerge esmart ewl
 * Done this, we can go on and build the engage package manually

WANT_AUTOMAKE="1.5" ./autogen.sh make && make install
 * Due to some broken Makefile we have to use another automake instead of the actual one, but that doesn't matter. So after compiling this little thing, we just have to start it.

engage
 * It will display a nice little OSXbar a the bottom of your screen. The detailed configuration of engage will follow soon.

xorg-cvs + shadow + true transparency
As I'm going to write this article not only for the Acer HOWTO, I'll just crosslink here for the full article.

***not finished yet, I'm on editing this Topic now***

Link Graveyard

 * Important things to know about the ACER Travelmate 803 LCi
 * Service guide for the travelmate 800 14mb pdf, not linked from Acer website
 * Compiler Flags
 * acovea
 * CFLAGS Thread Gentoo Forum
 * USE-Flags Gentoo-Howto
 * freenet dsl
 * USE-Flags Description
 * The experimental Freehackers
 * Harddrive & 'hdparm' Optimization
 * O'Reilly hdparm Howto
 * hdparm Thread Gentoo Forum
 * Networking Tools
 * IBM developerWorks - Keychain article
 * Gentoo Linux Documentation - Keychain
 * The MTR homepage
 * Networking WLAN
 * ipw2100 source driver
 * Gentoo Forum Thread
 * ndiswrapper
 * Wireless Tools
 * Kismet Wireless WLAN Sniffer
 * Special Laptop-Keys aka FN-Keys
 * xOSD Homepage
 * Enlightened OSD
 * Acer Launchkeys & AcerHK
 * AcerHK Website
 * Graphics
 * Gentoo DRI Howto
 * Gentoo Forum Thread - ATI Radeon Binary Drivers on Gentoo
 * Gentoo Forum Thread - ATI radeon Sticky
 * Gentoo Forum Thread - Direct rendering (DRI) using XFree-DRM HOWTO
 * Gentoo Forum Thread - radeon 9000 w/ ati driver problem plus how-to configure ATI
 * DRI Project Homepage
 * FreeBSD DRI FAQ
 * FreeBSD DRI Troubleshooting Guide
 * DRI Patches by Alan H. from the XFree Project
 * Universal Serial Bus (USB)
 * pam_usb Project
 * PAM X509 Authentication Module
 * Synaptics Touchpad
 * Debian on an ACER TravelMate 800LCi
 * Styleguide
 * Qingy Homepage
 * Lilo Graphics Tutorial
 * More Links
 * DSL-Blog

Missing Items & later additions

 * Later Additions (wanted)
 * Standby / Suspend to RAM / S3
 * How to take the acer tm 80x to suspend-to-RAM (standby, acpi s3)
 * working hardware sensors
 * http://www2.lm-sensors.nu/~lm78/cvs/browse.cgi/lm_sensors2/prog/hotplug/README.p4b
 * General Hints and Tricks
 * Optimization for speed, space, stability
 * Parallel-/USB-Printer & maybe CUPS
 * http://forums.gentoo.org/viewtopic.php?t=110931
 * Crypted root partition
 * CD-Writer and DVD playback
 * fetchmail/procmail || exim solution
 * Funny things
 * WLAN autoconfiguration
 * http://forums.gentoo.org/viewtopic.php?t=122435
 * Encrypted root filesystem
 * http://forums.gentoo.org/viewtopic.php?t=191052
 * http://forums.gentoo.org/viewtopic.php?t=31363
 * http://forums.gentoo.org/viewtopic.php?t=108162
 * http://forums.gentoo.org/viewtopic.php?t=143301
 * Missing Items
 * Smartcardreader & keycard login/logout