Bitsy setup

Instructions on how to install plan9 on the bitsy come with the distribution in /sys/src/9/bitsy/Booting101.

To install plan9 on the ipaq we used an compaq sp700 running plan9 and a IBM Thinkpad T21 running windows2000. The first step is to install a default install of plan9 w/ all updates on the sp700. We did a network install followed by the updates:

	wrap/inst -ov 03270425a.9gz
	wrap/inst -ov 03270507.9gz

It is easy to get the updates wrong, our initial attempt to install on the ipaq resulted in the prompter crashing on every boot, a reinstall of the plan9 build host fixed the problem.

Next build the arm distribution and bitsy loader and kernel:

	cd /sys/src
	mk clean
	objtype=arm mk install
	
	cd /sys/src/cmd/aux/flashfs
	objtype=arm mk install
	mk clean

	cd /sys/src/boot/arm
	objtype=arm mk install
	mk clean

	cd /sys/src
	mk clean

	cd /arm
	chgrp sys *
	chgrp sys */*
	chgrp sys */*/*
	chgrp -u sys *
	chgrp -u sys */*
	chgrp -u sys */*/*
	
	cd /sys/src/9/bitsy
	objtype=arm mk 'CONF=bitsy' 9bitsy

Next add any extra files you want to /sys/src/9/bitsy/sacfiles and make some modifications to the files as well as /sys/src/9/bitsy/armsac.proto Our setup is here . It is important to add the missing unicode.6.font file. Next make the ramdisk

	cd  /sys/src/9/bitsy
	objtype=arm mk ramdisk

The next step is to use the window box to save a copy of wince and then load the linux bootloader onto the ipaq. Instructions on how to do this are available from handhelds.org. The steps are:

Install activesync on the windows box from the cdrom that came with the ipaq.
Use activesync to copy osloader-1.3.0.exe to the ipaq using the serial cable
Run the osloader-1.3.0 program on the ipaq to save wince as 4 images files, using Tools->Flash->Save to Files. Instructions are available from handhelds.org.
Use Tools->Bootldr->Run to install the ram version of the bootloader.
Now install the flash version of the bootloader. (this can turn the ipaq into a paperweight if you do it wrong) First disconnect activesync and connect to the ipaq with a terminal emulator such as TeraTerm (settings: 115200 8N 1). Hit the enter key till you get the boot> prompt

bootldr-0000-2.14.5

protect the flash by typing:
```
		pflash 0 0xffff 1
	
```
Next load the plan9 kernel and ramdisk, It should be possible to use the plan9 box for this. However we used the windows box, as we were getting xmodem timeouts under plan9. After transfering the kernel and ramdisk to the windows box using TeraTerm at the boot> prompt enter:
```
		load kernel
	
```
and then start and xmodem download of the file. When that finishes enter:
```
		load ramdisk
	
```
after that finishes type boot.
The bisty should boot up and start the "prompter" a simple editor that lets you enter config info like in plan9.ini you need to add:
```
		user=your-user-name
		wvkey1=your-wavelankey
	
```
the other wavelankeys are called wvkey2...wvkey4 if you are using those. When you are dine hit the esc key on the simulated keyboard. Take a look at cpurc for the other things you can set.
add your password using:
```
		auth/iam
	
```

Much additional info on the bitsy has be posted to the 9fans mailing list, many by nemo@gsyc.escet.urjc.es here as some of the posts:

Last Modified: May 24 2002
dpx@acl.lanl.gov