5737
Comment:
|
7213
|
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. ## 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 ## |
These instructions are to install PocketWorkstation with X-Qt on the Sharp ROM.{{{ Does anyone know if these instructions work for OZ? }}} |
Line 10: | Line 10: |
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 17: |
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 22: |
1. Add http://xqt.sourceforge.jp/feed-testing/ to the end of the file {{{/etc/ipkg.conf}}} | 1. Type echo "src xqt http://xqt.sourceforge.jp/feed-testing/" >> /etc/ipkg.conf |
Line 20: | Line 24: |
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 33: |
* blackbox * rxvt * xqt-startup-scripts |
|
Line 37: | Line 38: |
Now there are two new icons available under the Apps tab of your Zaurus, X/QT Server, and Start X. | Download a modified X/Qt startup scripts package here http://www.geocities.com/hatchetman1618/6000/xqt-pocketworkstation-scripts_0.0.3-3_all.ipk.gz |
Line 39: | Line 41: |
##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.## | This package will install the original X/Qt startup scripts modified for 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.) |
Line 42: | Line 46: |
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. | PocketWorkstation will need to be installed on an 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. |
Line 55: | Line 59: |
mkfs.ext ''dev''[mmcda1 or hda1] | mkfs.ext2 ''dev''[mmcda1 or hda1] |
Line 69: | Line 73: |
1. mkdir debroot 1. ./gnu-tar -C debroot -xvzpf zaurus-debian-big-v0.17.tgz |
1. mkdir .debroot 1. ./gnu-tar -C .debroot -xvzpf zaurus-debian-big-v0.17.tgz (If you extract using a PC, make sure your links between files don't become linked to the desktop.) The above commands install Debian into a hidden directory ({{{.debroot}}}) so that programs like Sharp's Media Player don't spend hours searching through it. You can change the name to whatever you like. |
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 }}} 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}}}{{{ |
1. Change to your debroot directory. Create a new file {{{startd}}}{{{ |
Line 90: | Line 84: |
if [ -f "${HOME}/.xmodmaprc" ] ; then xmodmap ~/.xmodmaprc fi |
|
Line 93: | Line 90: |
swapoff -a | swapoff /swapfile |
Line 95: | Line 92: |
Fix the permissions on the new startd file{{{ chmod 755 /usr/mnt.rom/[cf or card]/debroot/startd |
3. Set the permissions on the new startd file{{{ chmod 755 startd |
Line 98: | Line 95: |
Create a swap file 1. Change to your debroot directory |
4. Create a ["64MB"] swap file |
Line 102: | Line 98: |
This will create a ["64MB"] swap file. Now it's time to start X/Qt. Click on the !StartX icon and wait for ["IceWM"] to appear. The first time you chroot into debian you should create a link between /root and /home/root{{{ ln -s /root /home/root |
5. Link the home directory to root{{{ ln -s /root home/root }}} 6. Store the debroot location, type{{{ pwd > /etc/debroot |
Line 110: | Line 105: |
##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## | You can remove the {{{debroot/INSTALL.d}}} file since it wasn't used anyways. |
Line 112: | Line 107: |
=== 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:{{{ |
The PocketWorkstation installation that uses fbvnc sets up a rootcmd daemon. It will let you run root commands outside the chroot environment from inside of it. If your interested in that check out the postinst.sh script that comes with the zaurus-debian archive. See [PocketWorkstation-Keymaps] for information on how to create an xmodmap file if your keyboard does not work correctly in X/Qt. Download the new keymap file into your home folder in the chroot environment. ie: {{{/usr/mnt.rom/cf/debroot/root}}} The only thing left is to mount the proc filesystem.{{{ mount -t proc /proc /usr/mnt.rom/{cf or card}/debroot/proc }}} You only need to do this once after you turned your PDA on. You may need to unmount it if you want to eject the card that holds Debian. '''Your done!''' Eveything should be setup now. Click on the PocketWorkstation icon under your Applications tab. Note: The chroot command needs to start as root (su). If you have a password set on root, then you would see Pocketworkstation launch, and a few seconds later, exit. To fix this, open a Qtopia terminal window, and su into root. Type passwd, and press <enter> twice to set the root password to blank. 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 == === SL-6000 === ==== Internal Wireless Card ==== 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. An easy hack is to add the line{{{ |
Line 117: | Line 131: |
to the bottom of the {{{/etc/pcmcia/network.functions}}} files. | |
Line 118: | Line 133: |
I've had some problems with this hack, has anyone come up with a better solution? | |
Line 119: | Line 135: |
==== Keyboard Maps ==== The 6000 keyboard is all out of whack. Download a keymap or create your own. Put it in {{{debroot/root/.xmodmaprc}}} http://wiki.debian.net/index.cgi?PocketWorkstation-Keymaps |
|
Line 121: | Line 140: |
* [http://translate.google.com/translate?u=http%3A%2F%2Fxqt.sourceforge.jp%2Fpukiwiki%2Fpukiwiki.php&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 142: |
* [http://w3.mecanica.upm.es/~smuelas/debianxqt.html Debian X-Qt instructions by smuelas.] | * [http://w3.mecanica.upm.es/~smuelas/debianxqt.html Smuelas's Debian X-Qt Page] |
These instructions are to install PocketWorkstation with X-Qt on the Sharp ROM.
Does anyone know if these instructions work for OZ?
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:
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.
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.
- Open a terminal
Type echo "src xqt http://xqt.sourceforge.jp/feed-testing/" >> /etc/ipkg.conf
- Type ipkg update
- 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
Download a modified X/Qt startup scripts package here http://www.geocities.com/hatchetman1618/6000/xqt-pocketworkstation-scripts_0.0.3-3_all.ipk.gz
This package will install the original X/Qt startup scripts modified for 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.)
Installing Debian GNU/Linux
PocketWorkstation will need to be installed on an 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.ext2 ''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.
[http://www.pocketworkstation.org/files/zaurus-debian-big-v0.17.tgz zaurus-debian-big-v0.17.tgz]
[http://www.pocketworkstation.org/files/gnu-tar.gz gnu-tar.gz]
Change to the directory with the above files and type:
- gunzip gnu-tar.gz
- chmod 755 gnu-tar
- mkdir .debroot
- ./gnu-tar -C .debroot -xvzpf zaurus-debian-big-v0.17.tgz
(If you extract using a PC, make sure your links between files don't become linked to the desktop.)
The above commands install Debian into a hidden directory (.debroot) so that programs like Sharp's Media Player don't spend hours searching through it. You can change the name to whatever you like.
Final setup procedures
1. Change to your debroot directory. Create a new file startd
#!/bin/sh #Startup Commands export DISPLAY=0:0 if [ -f "${HOME}/.xmodmaprc" ] ; then xmodmap ~/.xmodmaprc fi swapon /swapfile /usr/bin/icewm-session #Shutdown Commands swapoff /swapfile
3. Set the permissions on the new startd file
chmod 755 startd
4. Create a ["64MB"] swap file
- dd if=/dev/zero of=swapfile bs=1024 count=65536
- mkswap swapfile
5. Link the home directory to root
ln -s /root home/root
6. Store the debroot location, type
pwd > /etc/debroot
You can remove the debroot/INSTALL.d file since it wasn't used anyways.
The PocketWorkstation installation that uses fbvnc sets up a rootcmd daemon. It will let you run root commands outside the chroot environment from inside of it. If your interested in that check out the postinst.sh script that comes with the zaurus-debian archive.
See [PocketWorkstation-Keymaps] for information on how to create an xmodmap file if your keyboard does not work correctly in X/Qt.
Download the new keymap file into your home folder in the chroot environment. ie: /usr/mnt.rom/cf/debroot/root
The only thing left is to mount the proc filesystem.
mount -t proc /proc /usr/mnt.rom/{cf or card}/debroot/proc
You only need to do this once after you turned your PDA on. You may need to unmount it if you want to eject the card that holds Debian.
Your done!
Eveything should be setup now. Click on the PocketWorkstation icon under your Applications tab.
Note: The chroot command needs to start as root (su). If you have a password set on root, then you would see Pocketworkstation launch, and a few seconds later, exit. To fix this, open a Qtopia terminal window, and su into root. Type passwd, and press <enter> twice to set the root password to blank.
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
SL-6000
Internal Wireless Card
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. An easy hack is to add the line
cp /etc/resolv.conf /usr/mnt.rom/cf/debroot/etc
to the bottom of the /etc/pcmcia/network.functions files.
I've had some problems with this hack, has anyone come up with a better solution?
Keyboard Maps
The 6000 keyboard is all out of whack. Download a keymap or create your own. Put it in debroot/root/.xmodmaprc http://wiki.debian.net/index.cgi?PocketWorkstation-Keymaps
Other Resources:
[http://xqt.sourceforge.jp X/Qt Server Project]
[http://translate.google.com/translate?u=http%3A%2F%2Fxqt.sourceforge.jp%2Fpukiwiki%2Fpukiwiki.php&langpair=ja%7Cen&hl=en&safe=off&ie=UTF-8&oe=UTF-8&prev=%2Flanguage_tools X/Qt Wiki (translated to English)]
[http://www.zaurususergroup.com/forums/index.php?showtopic=8125 Debian X/Qt ?ZaurusUserGroup Thread]
[http://w3.mecanica.upm.es/~smuelas/debianxqt.html Smuelas's Debian X-Qt Page]