.TH BITSYLOAD 1.SH NAMEbitsyload, light, pencal, keyboard, params, prompter \- bitsy-specific utilities.SH SYNOPSIS.PP.B bitsy/bitsyload.B k|r[.I file].PP.B bitsy/light[.I intensity].PP.B bitsy/params[.B \-f].PP.B bitsy/pencal.PP.B bitsy/keyboard[.B \-n].PP.B bitsy/prompter[.B \-n].I file.SH DESCRIPTION.PP.I Bitsyloaderases a section of flash memory on the Bitsy (iPAQ 3650 or 3830)and copies newinformation into it, using the format required by the Compaqboot loader.  The required first argument is the destination, either.B kfor.B /dev/flash/kernelor.B rfor.BR /dev/flash/ramdisk .The optional second argument is the name of the fileto load.  The default kernel file is.B /sys/src/9/bitsy/9bitsyand the default ramdisk file is.BR /sys/src/9/bitsy/ramdisk ..PP.I Lightsets the intensity of the display backlight.Thevalues for.I intensityare:.IP onset intensity to maximum, the default.IP offturn off backlight.IP \fIn\fPsets the intensity to.IR n ,where.I nis a value between 0 and 128.  Intensity 0 doesn'tturn off the backlight, it just sets it to the dimmestvalue..PP.I Pencalcalibrates the display with the touch screen on a Bitsy.It loops prompting the user with crosses whose center that the usermust touch with the stylus.  After a consistent set of touches,it writes the calibration both to the kernel and to standard out.It is normally called by the bitsy's.BR /bin/cpurc ..PP.I Paramscopies the contents of the file.BR /dev/tmpparams ,into the flash partition,.BR /dev/flash/params ,or if the.B -fflag it set copies in the opposite direction..PP.I Keyboardcreates a virtual on-screen keyboard and, unless the.B -noption is specified, a scribble area.A user inputs characters by tapping the keys orby drawing characters in thescribble area (see.IR scribble (2)).It is usually run as the keyboard command for.IR rio (1)using.BR rio 's.B -koption..PP.I Prompteris a small editor used to configure parameters when a Bitsy boots.It displays the file and starts up a keyboard and scribble pad forinput.Clicking with the stylus in the text selects where input characters will go.Pressing Button 5 (top left side of the Bitsy) or typing the.B Esckey on the keyboard causes.I prompterto write back the updated file and exit;.B Delcauses.I prompterto exit without writing the file.The.B -nflag suppresses the scribble area..SH EXAMPLE.PP.IR Prompter ,.IR params ,and.I calibrateare used in only one place, the Bitsy's.BR /rc/bin/cpurc :.sp.EX# set variablesramfsbitsy/params -fif(! grep -s '^calibrate=' /tmp/tmpparams)	bitsy/pencal >>/tmp/tmpparamsif not {	eval `{grep '^calibrate=' /tmp/tmpparams}	echo calibrate $calibrate > '#m/mousectl'}bitsy/prompter /tmp/tmpparamsbitsy/params. /tmp/tmpparams.EE.SH SOURCE.B /sys/src/cmd/bitsy