glenda.party
term% ls -F
term% cat index.txt
BITSYLOAD(1)                General Commands Manual               BITSYLOAD(1)



NAME
       bitsyload,  light,  pencal, keyboard, params, prompter - bitsy-specific
       utilities

SYNOPSIS
       bitsy/bitsyload k|r [ file ]

       bitsy/light [ intensity ]

       bitsy/params [ -f ]

       bitsy/pencal

       bitsy/keyboard [ -n ]

       bitsy/prompter [ -n ] file

DESCRIPTION
       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  destina‐
       tion,  either k for /dev/flash/kernel or r for /dev/flash/ramdisk.  The
       optional second argument is the name of the file to load.  The  default
       kernel  file is /sys/src/9/bitsy/9bitsy and the default ramdisk file is
       /sys/src/9/bitsy/ramdisk.

       Light sets the intensity of the display backlight.  The values for  in‐
       tensity are:

       on     set intensity to maximum, the default

       off    turn off backlight

       n      sets  the  intensity to n, where n is a value between 0 and 128.
              Intensity 0 doesn't turn off the backlight, it just sets  it  to
              the dimmest value.

       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 /bin/cpurc.

       Params  copies  the contents of the file /dev/tmpparams, into the flash
       partition, /dev/flash/params, or if the -f flag it set  copies  in  the
       opposite direction.

       Keyboard creates a virtual on-screen keyboard and, unless the -n option
       is specified, a scribble area.  A user inputs characters by tapping the
       keys  or  by drawing characters in the scribble area (see scribble(2)).
       It is usually run as the keyboard command for rio(1) using rio's -k op‐
       tion.

       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  Esc  key on the keyboard causes prompter to write back the
       updated file and exit; Del causes prompter to exit without writing  the
       file.  The -n flag suppresses the scribble area.

EXAMPLE
       Prompter, params, and calibrate are used in only one place, the Bitsy's
       /rc/bin/cpurc:

       # 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

SOURCE
       /sys/src/cmd/bitsy



                                                                  BITSYLOAD(1)