BITSYLOAD(1)                                         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 destination, 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 val-
          ues for intensity 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 cen-
          ter that the user must touch with the stylus.  After a con-
          sistent 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

     BITSYLOAD(1)                                         BITSYLOAD(1)

          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 option.

          Prompter is a small editor used to configure parameters when
          a Bitsy boots.  It displays the file and starts up a key-
          board and scribble pad for input.  Clicking with the stylus
          in the text selects where input characters will go.  Press-
          ing 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