1
0

bitsyload 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. .TH BITSYLOAD 1
  2. .SH NAME
  3. bitsyload, light, pencal, keyboard, params, prompter \- bitsy-specific utilities
  4. .SH SYNOPSIS
  5. .PP
  6. .B bitsy/bitsyload
  7. .B k|r
  8. [
  9. .I file
  10. ]
  11. .PP
  12. .B bitsy/light
  13. [
  14. .I intensity
  15. ]
  16. .PP
  17. .B bitsy/params
  18. [
  19. .B \-f
  20. ]
  21. .PP
  22. .B bitsy/pencal
  23. .PP
  24. .B bitsy/keyboard
  25. [
  26. .B \-n
  27. ]
  28. .PP
  29. .B bitsy/prompter
  30. [
  31. .B \-n
  32. ]
  33. .I file
  34. .SH DESCRIPTION
  35. .PP
  36. .I Bitsyload
  37. erases a section of flash memory on the Bitsy (iPAQ 3650 or 3830)
  38. and copies new
  39. information into it, using the format required by the Compaq
  40. boot loader. The required first argument is the destination, either
  41. .B k
  42. for
  43. .B /dev/flash/kernel
  44. or
  45. .B r
  46. for
  47. .BR /dev/flash/ramdisk .
  48. The optional second argument is the name of the file
  49. to load. The default kernel file is
  50. .B /sys/src/9/bitsy/9bitsy
  51. and the default ramdisk file is
  52. .BR /sys/src/9/bitsy/ramdisk .
  53. .PP
  54. .I Light
  55. sets the intensity of the display backlight.
  56. The
  57. values for
  58. .I intensity
  59. are:
  60. .IP on
  61. set intensity to maximum, the default
  62. .IP off
  63. turn off backlight
  64. .IP \fIn\fP
  65. sets the intensity to
  66. .IR n ,
  67. where
  68. .I n
  69. is a value between 0 and 128. Intensity 0 doesn't
  70. turn off the backlight, it just sets it to the dimmest
  71. value.
  72. .PP
  73. .I Pencal
  74. calibrates the display with the touch screen on a Bitsy.
  75. It loops prompting the user with crosses whose center that the user
  76. must touch with the stylus. After a consistent set of touches,
  77. it writes the calibration both to the kernel and to standard out.
  78. It is normally called by the bitsy's
  79. .BR /bin/cpurc .
  80. .PP
  81. .I Params
  82. copies the contents of the file
  83. .BR /dev/tmpparams ,
  84. into the flash partition,
  85. .BR /dev/flash/params ,
  86. or if the
  87. .B -f
  88. flag it set copies in the opposite direction.
  89. .PP
  90. .I Keyboard
  91. creates a virtual on-screen keyboard and, unless the
  92. .B -n
  93. option is specified, a scribble area.
  94. A user inputs characters by tapping the keys or
  95. by drawing characters in the
  96. scribble area (see
  97. .IR scribble (2)).
  98. It is usually run as the keyboard command for
  99. .IR rio (1)
  100. using
  101. .BR rio 's
  102. .B -k
  103. option.
  104. .PP
  105. .I Prompter
  106. is a small editor used to configure parameters when a Bitsy boots.
  107. It displays the file and starts up a keyboard and scribble pad for
  108. input.
  109. Clicking with the stylus in the text selects where input characters will go.
  110. Pressing Button 5 (top left side of the Bitsy) or typing the
  111. .B Esc
  112. key on the keyboard causes
  113. .I prompter
  114. to write back the updated file and exit;
  115. .B Del
  116. causes
  117. .I prompter
  118. to exit without writing the file.
  119. The
  120. .B -n
  121. flag suppresses the scribble area.
  122. .SH EXAMPLE
  123. .PP
  124. .IR Prompter ,
  125. .IR params ,
  126. and
  127. .I calibrate
  128. are used in only one place, the Bitsy's
  129. .BR /rc/bin/cpurc :
  130. .sp
  131. .EX
  132. # set variables
  133. ramfs
  134. bitsy/params -f
  135. if(! grep -s '^calibrate=' /tmp/tmpparams)
  136. bitsy/pencal >>/tmp/tmpparams
  137. if not {
  138. eval `{grep '^calibrate=' /tmp/tmpparams}
  139. echo calibrate $calibrate > '#m/mousectl'
  140. }
  141. bitsy/prompter /tmp/tmpparams
  142. bitsy/params
  143. . /tmp/tmpparams
  144. .EE
  145. .SH SOURCE
  146. .B /sys/src/cmd/bitsy