====== Zaurus Tips ==
===== Links ==

[[http://www.oesf.org/index.php?title=Zaurus_How-To_Docs|Zaurus Howto Docs]] (great!), www.linuxontour.de is a German formum, [[http://www.psionwelt.de/besprech/zaurus/zaurus.htm|Comparison Psion <-> Zaurus]] (in german), [[http://www.oesf.org/index.php?title=General#Where_can_I_buy_a_Zaurus_in_Germany.3F|Where to buy?]], [[http://trisoft.de/pdf/c3000qse.pdf|Manual from Trisoft]] (The manual from Pulster.de is not for free)

===== Installing Cacko ROM ==

[[http://my-zaurus.narod.ru/cacko.html|Cacko ROM]] is one of [[http://www.oesf.org/index.php?title=Distributions|several]] distributions for the Zaurus. 

The download links at the Cacko homepage didn't work and the links at zaurususergroup.org neigther. But I found the package with a web search for the filename ''SL-C1000-Qtopia-1.23-1029311005.zip'' at [[http://www.tyrannozaurus.com/?q=cacko|tyrannozaurus.com]] which has also good installation instructions. ([[http://sharpromfeed.home.linuxtogo.org/download/cacko/|download alternative]]) --- 2007-05-14 14:33

Accessing the maintenance menu as described at tyrannozaurus.com or at [[http://my-zaurus.narod.ru/cacko-tips.html|Cacko Installation Tips]] did not work for me. (Somehow the old currently installed OS (pdaXrom) always booted automatically.) So it was necessary to download and install a NAND-Backup (''C1000NAND240305.zip'') first. Instructions an backup is available at [[http://trisoft.de/en_c1000howto.htm|trisoft.de]]

After that, flashing the Cacko ROM worked.

===== Misc. Configuration Issues ==
==== UDB drive permissions ==

If you plug in an usb stick it will automatically get mounted, but only root has write permission to all files and directories on the stick. To get access for a normal user, first save your original fstab:

''cp /etc/fstab /etc/fstab.org''

Then edit the last line in /etc/fstab from:
''/dev/sda1  /mnt/usbstorage  auto  noauto,owner,noatime,iocharset=utf8  0  0''

to:
''/dev/sda1  /mnt/usbstorage  auto  umask=000,noauto,owner,noatime,iocharset=utf8  0  0''

For me this works fine, but I dont't know if this is the proper method :?:


==== Shell Aliases ==

Create ''/etc/profile'' with this content:
<code bash>
alias o='less'
alias ll='ls -alF'
alias v='ls -hlF'
alias d='ls -F'
alias ..='cd ..'
alias ...='cd ../..'
</code>




===== Keyboard Setup ==

This section is biased toward a german keyboard. It gets all necessary german special characters working, but leaves everything else where it it is painted on the keys. Only Y and Z are swapped. Almost everything is done with the file ''keyhelper.xml''.

To get special characters working you have to edit the file ''/home/zaurus/Settings/keyhelper.xml''. [[http://www.oesf.org/index.php?title=Introduction_to_KeyHelper|oesf.org]] explains the syntax. I took some entrys from the original cacko file, from [[http://www.trisoft.de/download/keyhelper.zip|trisoft.de]] (which I found by help of linuxontour.de) and from [[http://www.linuxontour.de/modules/newbb/viewtopic.php?topic_id=7592|linuxontour.de]] and made my own. Access to the special characters is described in the comments, e.g. ''Fn+A = ä'' means: Press [Fn] and [A] to get an 'ä'.

Dont forget to issue ''khctl reload'' after modifying your keyhelper.xml:

<code xml>
<?xml version="1.0"?>
<!-- file: /home/zaurus/Settings/keyhelper.xml
    Encoding: UTF-8 (for proper display of the special characters in comments!)
    -->
<keyhelper>
    <modifiers>
        <!-- left Kanji-Key (down/left from X-Key) = Control (again) -->
        <define key="F26" type="Control">
            <release key="F31"/>
        </define>

        <!-- right Kanji-Key (down/right from X-Key) = Alt -->
        <define key="F21" type="Alt">
            <release key="F25"/>
        </define>

        <!-- Home key = User1 for app launch, see below -->
        <define key="F12" type="User1"/>

        <!-- omit toggle attribut for sticky Shift??? -->
        <define key="Shift" type="Shift" toggle="True"/>
    </modifiers>

    <mappings>
        <!-- Fn+N = { -->
        <define code="2019">
            <map code="0x7b"/>
            <map_unicode code="0x7b"/>
        </define>

        <!-- Fn+M = } -->
        <define code="201a">
            <map code="0x7d"/>
            <map_unicode code="0x7d"/>
        </define>

        <!-- Fn+A = ä -->
        <define code="2017">
            <map code="0x0e4"/>
            <map_unicode code="0x0e4"/>
        </define>

        <!-- Fn+S = ß -->
        <define code="2018">
            <map code="0x0df"/>
            <map_unicode code="0x0df"/>
        </define>

        <!-- Fn+O = ö -->
        <define code="2015">
            <map code="0x0f6"/>
            <map_unicode code="0x0f6"/>
        </define>

        <!-- Fn+U = ü -->
        <define key="cent">
            <map code="0x0fc"/>
            <map_unicode code="0x0fc"/>
        </define>

        <!-- Shift+Fn+A = Ä -->
        <define code="2017">
            <modifier Shift="On"/>
            <map code="0x0c4"/>
            <map_unicode code="0x0c4"/>
            <map_modifier Shift="Off"/>
        </define>

        <!-- Shift+Fn+O = Ö -->
        <define code="2015">
            <modifier Shift="On"/>
            <map code="0x0d6"/>
            <map_unicode code="0x0d6"/>
            <map_modifier Shift="Off"/>
        </define>

        <!-- Shift+Fn+U = Ü -->
        <define key="cent">
            <modifier Shift="On"/>
            <map code="0x0dc"/>
            <map_unicode code="0x0dc"/>
            <map_modifier Shift="Off"/>
        </define>

        <!-- Shift+Fn+E = € (also accessable with Fn+5) -->
        <define key="Equal">
            <modifier Shift="On"/>
            <map code="0x20ac"/>
            <map_unicode code="0x20ac"/>
            <map_modifier Shift="Off"/>
        </define>

        <!-- Swap Y and Z -->
        <define key="Y">
            <map key="Z"/>
            <map_unicode char="z"/>
        </define>
        <define key="Y">
            <modifier Shift="On"/>
            <map key="Z"/>
            <map_unicode char="Z"/>
        </define>
        <define key="Z">
            <map key="Y"/>
            <map_unicode char="y"/>
        </define>
        <define key="Z">
            <modifier Shift="On"/>
            <map key="Y"/>
            <map_unicode char="Y"/>
        </define>
    </mappings>

    <repeater>
        <repeat delay="300" period="30"/>
    </repeater>

    <extensions>
        <!-- Shift+Home = switch to next task -->
        <define key="F12" kind="switch">
            <modifier Shift="On"/>
        </define>

        <!-- Shift+Menu = display task selector -->
        <define key="F11" kind="select">
            <modifier Shift="On"/>
        </define>

        <!-- Home+key = app launch, for keys see keyhelper.conf -->
        <define key="All" kind="launch">
            <modifier User1="On"/>
        </define>
    </extensions>
</keyhelper>

</code>

After this there still remains a little hassle with the wired behaviour of the [/,]-key (hanging Shift). To get around this, I made a small modification in the file ''/home/zaurus/Application/cyrillica/deutsch''. Look for this 2 lines:
  ','     ','     '/'
  '/'     ','     ','
and modify them to:
  #','     ','     '/'
  '/'     '/'     ','
This makes comma accessible without Shift, Slash needs Shift and the [/,]-key behaves normal then. After this, go to Settings-> Keyboard and select ''deutsch'' as keymap!

===== Network Setup ==
==== Via Ethernet ==

Just plug in your compact flash ethernet card (I use a circom 10 FIXME), check if it is recognized with ''cardctl status'', add a LAN Card at QT-menu-> Settings-> Network and fill in ip-address, network mask etc. Use autoconnect if you have only 1 network configuration. Check your connection with ''ifconfig'', an "eth0"-entry should appear. [[http://www.oesf.org/index.php?title=Ethernet_Card_Support|More]]




==== Via WLAN ==

I use a D-Link DCF-660W. ''cardctl ident'' shows:
  product info: "D-Link", "DCF-660W", ""
  manfid: 0xd601, 0x0005
  function: 6 (network)

According to [[http://my-zaurus.narod.ru/cacko-faq.html|cacko-faq]] there must be an entry in ''/etc/pcmcia/hostap_cs.conf'' for the used card. This is the case. The entry binds the card to ''hostap_cs'' kernel module. Checking with ''lsmod'' before and after inserting the card confirms that hostap_cs gets loaded automatically.

FIXME 

[[http://www.linuxontour.de/modules/newbb/viewtopic.php?post_id=47218#forumpost47218|Wellenreiter1]] [[http://www.linuxontour.de/modules/newbb/viewtopic.php?post_id=41584|Wellenreiter2]] [[http://www.linuxontour.de/modules/newbb/viewtopic.php?post_id=41461#forumpost41461|Encryption]] http://www.oesf.org/index.php?title=Wireless_Card_Support







==== Via GSM/GPRS ==

Using a Audiovox RTM-8000 GSM/GPRS CF Card. When inserting, ''dmesg'' says:
  ttyS03 at port 0xf6000400 (irq = 135) is a 16C950/954
  pxa_pcmcia_suspend(0)
and ''cardctl ident'' states:
  Socket 0:
    product info: "GPRS Modem", "", "", ""
    manfid: 0x0279, 0x950b
    function: 2 (serial)

Setting up a GPRS Connection according to [[http://www.oesf.org/forums/?showtopic=1382|oesf.org]] (Link found at [[http://www.linuxontour.de/modules/newbb/viewtopic.php?post_id=47658|linuxontour.de]]). This mainly comprised setting ''SERIAL_OPTS="uart 16550A"'' at ''/etc/pcmcia/serial.opts''.

With connection settings for Vodafone taken from [[http://www.heise.de/mobil/artikel/90100|heise.de]] with ''event.vodafone.de'' as APN does //not// work. Cacko network setup gui uses ''ttyS3'' as serial port, this can be seen at ''etc/ppp''

Minicom installed. It saves its typical ''minirc.dfl'' to ''/home/root/usr/local/etc'' and not to ''/etc'', dont't know why. Minicom configurated with 115200/8N1 to use ttyS3, ttyS03 and ttyS0, neighter of them connected to the card modem!

=> Up to now, setting up the card remains unsolved :-(

FIXME Try ''cardctl resume'' and the special minicom settings from [[http://tuxmobil.org/pcmcia_cf_anycom_gprs.html|tuxmobil.org]]

Probably useful links:
  * http://www.teltarif.de/i/gprs-config.html
  * http://www.heise.de/mobil/tarife/daten.shtml
  * http://www.teltarif.de/i/gprs-config.html http://www.teltarif.de/i/gprs-kosten.html
  * http://kapsi.fi/~mcfrisk/linux_gprs.html
  * http://turtiainen.dna.fi/GPRS-HOWTO

==== SSH ==

A log in from the zaurus into a remote machine works out of the box, just issue ''ssh'' in the console.

For logging into the (remote) zaurus from any local machine, you have to set passwords on the zaurus first. ''passwd'' command will do it. Set a password for the root user too: Type ''su'', than ''passwd''. The ssh deamon of cacko works out of the box. Just type ''ssh zaurus@<zaurus_host_name>'' on your local machine.



===== Installing / removing Software ==

FIXME
  * All install information lies in ''/home/root/usr/lib/ipkg/''
  * Doc install software! http://www.oesf.org/index.php?title=Installing_IPKs_from_the_command_line
  * Where is a software overview? http://web.mol.ru/~zaurus/feed/Packages and http://bryandeluca.com/cacko/feed/Packages, the first seems to be more current
  * Where is the list of installed apps in the filesystem?


===== Todo ==

  * Checkout [[http://www.wbcd.org/computing/zaurus/part_8.html#2|Doom]]
  * Test: bookreader treeexplorer tximage mooview supertux
  * ogg player??
  * better picture viewer?
  * Howto make Backups?