Differences between revisions 1 and 9 (spanning 8 versions)
Revision 1 as of 2005-01-30 10:20:38
Size: 5737
Editor: anonymous
Comment:
Revision 9 as of 2005-02-01 00:46:39
Size: 6091
Editor: anonymous
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
These instructions are to install PocketWorkstation with X-Qt on the SL-6000 Sharp ROM. These instructions are to install PocketWorkstation with X-Qt on the Sharp ROM.
Line 4: Line 4:
## How much of this document is 6000 specific? Maybe this document should only hold the internal wireless hacks, and the rest put into it's own X/Qt document ##
Line 10: Line 9:
It's also recommended to install a copy of !["OpenSSH"]. It will be a great deal easier to install packages, edit config files, and any other preporation work needed remotely. You can download the packages you need from http://www.externe.net/zaurus/feeds/6000/ You will also need access to a shell to run the configuration scripts. You can use these terminals if you plan on using the Zaurus:

 * Qpe Terminal: http://www.myzaurus.com/downloads/qpe-terminal_1.5.0-2_arm.ipk
 * !["QKonsole"]: http://prdownloads.sourceforge.net/qpdf2/qkonsole_0.9.3-20040205_arm.ipk?download
or install !["OpenSSH"] and work remotely.
Line 13: Line 16:
The first step towards a working Debian setup is to have a working copy of X/Qt installed. X/Qt must be installed onto an ext2 formatted filesystem, the internal memory will work fine. The first step is to have a working copy of X/Qt installed. X/Qt must be installed onto an ext2 formatted filesystem, the internal memory will work fine.
Line 18: Line 21:
 1. Add http://xqt.sourceforge.jp/feed-testing/ to the end of the file {{{/etc/ipkg.conf}}}  1. Add http://xqt.sourceforge.jp/feed-testing/ to the end of the file {{{/etc/ipkg.conf}}} by typing
Line 20: Line 23:
 1. Type ipkg install xqt-server xqt-fonts-misc xbase-etc xqt-startup-scripts  1. Type ipkg install xqt-server xqt-fonts-misc xbase-etc
Line 29: Line 32:
 * blackbox
 * rxvt
 * xqt-startup-scripts
Line 37: Line 37:
Now there are two new icons available under the Apps tab of your Zaurus, X/QT Server, and Start X. Now don't close the terminal yet, the scripts package needs to be installed.
Line 39: Line 39:
##If any of the above information was incorrect, please edit this page and make the changes of what worked for you. I wrote all of this from memory.## Download a modified X/Qt startup scripts package here
http://www.matt.kincaid.name/6000/xqt-pocketworkstation-scripts_0.0.3_all.ipk.gz

This package will install the original X/Qt startup scripts modified for PocketWorkstation, and a setup script to configure PocketWorkstation. The depencies for blackbox and rxvt have also been removed.

(Until I can find a different host to hold the package it's on Yahoo. Because Yahoo only allows certain extensions I had to gzip it for them to accept it. Make sure you gunzip the file before you try and install it.)

xqt-pocketworkstation-scripts_0.0.3_all.ipk wasn't created by Klaus Weidner, so don't bother him if it doesn't work. He probably won't know what your talking about :) This package works for me on my SL-6000 and I expect it should work on other models. If you have any problems though feel free to email me at linux@matt.kincaid.name.
Line 72: Line 79:
Download a new keymap so the keys work correctly in X/Qt into the folder {{{/home/zaurus}}}{{{
  http://w3.mecanica.upm.es/~smuelas/.xmodmaprc
See [PocketWorkstation-Keymaps] for information on how to create an xmodmap file if your keyboard will not work correctly in X/Qt.

Download a new keymap file if needed into your home folder in the chroot environment. ie: {{{/usr/mnt.rom/cf/debroot/root}}}{{{
  
Line 75: Line 84:
Open {{{/home/zaurus/.xinitrc}}} and modify the LANG variable to look like this (if you speak US english):{{{
  export LANG=en_US
}}}
then remove the last two lines{{{
  rxvt &
  blackbox
}}}
All X software will be run under the chroot environment, so this software is useless. It was only installed to give the .xinitrc file to work from. Now add to the bottom of the .xinitrc file:{{{
  xmodmap /usr/mnt.rom/[cf or card]/debroot/root/.xmodmaprc
  su -c 'chroot /usr/mnt.rom/[cf or card]''debroot'' /startd'
}}}
Create a new file {{{/usr/mnt.rom/}}}{{{[cf or card}}}]{{{/debroot/startd}}}{{{
  #!/bin/sh
  #Startup Commands
  export DISPLAY=0:0
  swapon /swapfile
  /usr/bin/icewm-session
  #Shutdown Commands
  swapoff -a
}}}
Fix the permissions on the new startd file{{{
  chmod 755 /usr/mnt.rom/[cf or card]/debroot/startd
}}}
Create a swap file
Line 100: Line 85:
 1. dd if=/dev/zero of=swapfile bs=1024 count=65536
 1. mkswap swapfile
This will create a ["64MB"] swap file.
 1. Type pocketworkstation-postinst.sh
Line 104: Line 87:
Now it's time to start X/Qt. Click on the !StartX icon and wait for ["IceWM"] to appear. The postinst script will create a startup script in the debroot directory, a swap file, and link root's home to /home/root.
Line 106: Line 89:
The first time you chroot into debian you should create a link between /root and /home/root{{{
  ln -s /root /home/root
The PocketWorkstation installation that uses fbvnc sets up a rootcmd daemon that lets you run root commands outside the chroot environment from inside it. If your interested in that check out the postinst.sh script that comes with the zaurus-debian archive because this script won't set it up.

No scripts will mount the proc filesystem for you. If this is something you want add these lines to /etc/fstab on the original filesystem (not the chroot environment).{{{
  proc /proc proc defaults 0 0
  proc /usr/mnt.rom/cf/debroot/proc proc defaults 0 0
Line 110: Line 96:
##This home directory might need to be linked before you can boot into ["IceWM"]. I'm not sure, if someone tries it and you get away with doing it afterwords remove this note## '''Your done!'''
Line 112: Line 98:
=== Setting Up Wireless Internet ===
The internet can be controlled through Qtopia as it always has been. However the up and down scripts don't create a resolv.conf file for the chroot environment when using DHCP.
Add to the bottom of the /etc/pcmcia/network.functions file:{{{
  cp /etc/resolv.conf /usr/mnt.rom/cf/debroot/etc
}}}
Eveything should be setup now. Click on the PocketWorkstation icon under your Applications tab.
Line 118: Line 100:
NOTE: You won't see the taskbar at first because it is hidden beneath your Qtopia taskbar. Press your menu key to change to fullscreen mode.
=== Model Specifics ===
Make sure that you read the PocketWorkstation page for model specific information. (ie. wireless internet on the 6000)
Line 121: Line 105:
 * [http://translate.google.com/translate?u=http%3A%2F%2Fxqt.sourceforge.jp%2Fpukiwiki%2Fpukiwiki.php%["3FFAQ"]&langpair=ja%7Cen&hl=en&safe=off&ie=UTF-8&oe=UTF-8&prev=%2Flanguage_tools X/Qt Wiki (translated to English)]
Line 122: Line 107:
 * [http://w3.mecanica.upm.es/~smuelas/debianxqt.html Debian X-Qt instructions by smuelas.]  * [http://w3.mecanica.upm.es/~smuelas/debianxqt.html Debian X-Qt instructions by smuelas.]{{{
  
}}}

These instructions are to install PocketWorkstation with X-Qt on the Sharp ROM.


Before you can begin, a method of transfering files from the internet to your PDA must be established.

The most convienent and straightforward method is to just have Internet available on the PDA itself. That will allow you to use the ipkg package manager. There are many ways this can be done, for example using the built-in wireless, or masquerading through the USB TCP/IP connection.

You will also need access to a shell to run the configuration scripts. You can use these terminals if you plan on using the Zaurus:

or install !["OpenSSH"] and work remotely.

Installing X/Qt

The first step is to have a working copy of X/Qt installed. X/Qt must be installed onto an ext2 formatted filesystem, the internal memory will work fine.

If the PDA has access to the internet, the easiest way to install is to use the testing feed available from the X/Qt sourceforge site.

  1. Open a terminal
  2. Add http://xqt.sourceforge.jp/feed-testing/ to the end of the file /etc/ipkg.conf by typing

  3. Type ipkg update
  4. Type ipkg install xqt-server xqt-fonts-misc xbase-etc

If internet access is still unavailable, download/copy to the PDA all the following packages from http://xqt.sourceforge.jp/feed-testing/.

  • xqt-server 0.0.10 (1.9.0 doesn't work)
  • xqt-fonts-misc
  • xbase-client
  • xbase-etc
  • xlibs

Open up a terminal and install each of these packages.

  ipkg install xqt-server_0.0.10 xqt-fonts-misc_X.X.X... etc

Now don't close the terminal yet, the scripts package needs to be installed.

Download a modified X/Qt startup scripts package here http://www.matt.kincaid.name/6000/xqt-pocketworkstation-scripts_0.0.3_all.ipk.gz

This package will install the original X/Qt startup scripts modified for PocketWorkstation, and a setup script to configure PocketWorkstation. The depencies for blackbox and rxvt have also been removed.

(Until I can find a different host to hold the package it's on Yahoo. Because Yahoo only allows certain extensions I had to gzip it for them to accept it. Make sure you gunzip the file before you try and install it.)

xqt-pocketworkstation-scripts_0.0.3_all.ipk wasn't created by Klaus Weidner, so don't bother him if it doesn't work. He probably won't know what your talking about :) This package works for me on my SL-6000 and I expect it should work on other models. If you have any problems though feel free to email me at linux@matt.kincaid.name.

Installing Debian GNU/Linux

PocketWorkstation will need to be installed onto a ext2 filesystem with at least ["195MB"] of free space for the big package. When you start to install more software and libraries, another ["200MB"]-["300MB"] will quickly be needed.

Because more space is needed then is available on the internal memory, a memory chip will need to be formatted and used. Refer to the following table when needed.

Type

Filesytem

Mount Point

SD Card

/dev/mmcda1

/usr/mnt.rom/card

CF Card

/dev/hda1

/usr/mnt.rom/cf

Formatting a memory card

1. Open a terminal.

2. Unmount the filesystem being used.

  umount /usr/mnt.rom/[cf or card]

3. Format the filesystem as ext2.

  mkfs.ext ''dev''[mmcda1 or hda1]

4. Remount the filesystem.

  mount /usr/mnt.rom/[cf or card]

Extracting Debian

Plug your Zaurus into AC Power while extracting! You don't want the unit to suspend in the middle of all your hard work.

Copy the following files onto the ext2 filesystem you just formated.

Change to the directory with the above files and type:

  1. gunzip gnu-tar.gz
  2. chmod 755 gnu-tar
  3. mkdir debroot
  4. ./gnu-tar -C debroot -xvzpf zaurus-debian-big-v0.17.tgz

Final setup procedures

See [PocketWorkstation-Keymaps] for information on how to create an xmodmap file if your keyboard will not work correctly in X/Qt.

Download a new keymap file if needed into your home folder in the chroot environment. ie: /usr/mnt.rom/cf/debroot/root

  1. Change to your debroot directory
  2. Type pocketworkstation-postinst.sh

The postinst script will create a startup script in the debroot directory, a swap file, and link root's home to /home/root.

The PocketWorkstation installation that uses fbvnc sets up a rootcmd daemon that lets you run root commands outside the chroot environment from inside it. If your interested in that check out the postinst.sh script that comes with the zaurus-debian archive because this script won't set it up.

No scripts will mount the proc filesystem for you. If this is something you want add these lines to /etc/fstab on the original filesystem (not the chroot environment).

  proc  /proc  proc  defaults  0  0
  proc  /usr/mnt.rom/cf/debroot/proc  proc  defaults  0  0

Your done!

Eveything should be setup now. Click on the PocketWorkstation icon under your Applications tab.

NOTE: You won't see the taskbar at first because it is hidden beneath your Qtopia taskbar. Press your menu key to change to fullscreen mode.

Model Specifics

Make sure that you read the PocketWorkstation page for model specific information. (ie. wireless internet on the 6000)

Other Resources: