Differences between revisions 16 and 18 (spanning 2 versions)
Revision 16 as of 2005-02-01 06:36:41
Size: 6460
Editor: anonymous
Comment:
Revision 18 as of 2005-02-02 04:17:59
Size: 6731
Editor: anonymous
Comment:
Deletions are marked like this. Additions are marked like this.
Line 39: Line 39:
http://www.matt.kincaid.name/6000/xqt-pocketworkstation-scripts_0.0.3-2_all.ipk.gz http://www.geocities.com/hatchetman1618/6000/xqt-pocketworkstation-scripts_0.0.3-3_all.ipk.gz
Line 41: Line 41:
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. This package will install the original X/Qt startup scripts modified for PocketWorkstation. The depencies for blackbox and rxvt have also been removed.
Line 45: Line 45:
If you have any problem with the above package, feel free to email the packager at linux@matt.kincaid.name.
Line 79: Line 78:
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
 1. dd if=/dev/zero of=swapfile bs=1024 count=65536
 1. 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.
Line 82: Line 111:

Now configure your PDA to run Debian with X/Qt
 1. Change to your debroot directory
 1. 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. It will also make note of where you extracted debroot into {{{/etc/debroot}}}.

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.
Line 109: Line 130:
I've had some problems with this hack, has anyone come up with a better solution?
Line 115: Line 138:
 * [http://www.zaurususergroup.com/forums/index.php?showtopic=8125 Debian X/Qt ZaurusUserGroup Thread]{{{
  
}}}
 * [http://www.zaurususergroup.com/forums/index.php?showtopic=8125 Debian X/Qt ZaurusUserGroup Thread]

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:

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. Type echo "src xqt http://xqt.sourceforge.jp/feed-testing" >> /etc/ipkg.conf

  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

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.

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

Note: 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

  1. dd if=/dev/zero of=swapfile bs=1024 count=65536
  2. 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: 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: