ref: c7d9da8f5a41b833946027c802e0e8d7dd014b22
dir: /sys/man/1/bitsyload/
.TH BITSYLOAD 1 .SH NAME bitsyload, 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 Bitsyload erases a section of flash memory on the Bitsy (iPAQ 3650 or 3830) and copies new information into it, using the format required by the Compaq boot loader. The required first argument is the destination, either .B k for .B /dev/flash/kernel or .B r for .BR /dev/flash/ramdisk . The optional second argument is the name of the file to load. The default kernel file is .B /sys/src/9/bitsy/9bitsy and the default ramdisk file is .BR /sys/src/9/bitsy/ramdisk . .PP .I Light sets the intensity of the display backlight. The values for .I intensity are: .IP on set intensity to maximum, the default .IP off turn off backlight .IP \fIn\fP sets the intensity to .IR n , where .I n is a value between 0 and 128. Intensity 0 doesn't turn off the backlight, it just sets it to the dimmest value. .PP .I Pencal calibrates the display with the touch screen on a Bitsy. It loops prompting the user with crosses whose center that the user must 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 Params copies the contents of the file .BR /dev/tmpparams , into the flash partition, .BR /dev/flash/params , or if the .B -f flag it set copies in the opposite direction. .PP .I Keyboard creates a virtual on-screen keyboard and, unless the .B -n option is specified, a scribble area. A user inputs characters by tapping the keys or by drawing characters in the scribble area (see .IR scribble (2)). It is usually run as the keyboard command for .IR rio (1) using .BR rio 's .B -k option. .PP .I Prompter is a small editor used to configure parameters when a Bitsy boots. It displays the file and starts up a keyboard and scribble pad for input. 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 Esc key on the keyboard causes .I prompter to write back the updated file and exit; .B Del causes .I prompter to exit without writing the file. The .B -n flag suppresses the scribble area. .SH EXAMPLE .PP .IR Prompter , .IR params , and .I calibrate are used in only one place, the Bitsy's .BR /rc/bin/cpurc : .sp .EX # set variables ramfs bitsy/params -f if(! grep -s '^calibrate=' /tmp/tmpparams) bitsy/pencal >>/tmp/tmpparams if not { eval `{grep '^calibrate=' /tmp/tmpparams} echo calibrate $calibrate > '#m/mousectl' } bitsy/prompter /tmp/tmpparams bitsy/params . /tmp/tmpparams .EE .SH SOURCE .B /sys/src/cmd/bitsy