plan9fox/sys/man/1/bitsyload
2017-12-11 19:58:06 -05:00

147 lines
2.8 KiB
Plaintext

.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