147 lines
2.8 KiB
Plaintext
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
|