home *** CD-ROM | disk | FTP | other *** search
/ Emulator Universe CD / emulatoruniversecd1998.iso / Gameboy / ROMs / GBBASIC.TXT < prev    next >
Encoding:
Text File  |  1997-11-04  |  9.3 KB  |  225 lines
  1.  
  2.                GB Basic V1.21 Documentation
  3.  
  4.  GB Basic is a floating-point BASIC interpreter for GameBoy that
  5. allows you to write & execute programs up to 7.4K bytes in size.
  6.  
  7.  Currently string variables are not supported, but may be in the
  8. future.
  9.  
  10.  Long variable names are not supported. Variable names may be
  11. a letter or a letter and a number.
  12.  
  13.  Each line requires a line number.
  14.  
  15.  &H may be used for entering hex values. (Ex: POKE &HFF00,&HFF)
  16.  
  17. The following commands are supported:
  18.  
  19. ABS(x)           -       Return the absolute value of x.
  20.  
  21. AUTO             -       Enable Auto load & run program on reset.
  22.                          (Note: Use AUTO command last since SAVE
  23.                           disables auto mode.)
  24.  
  25. CLEAR            -       Clear all variables.
  26.  
  27. CLS              -       Clear the screen
  28.  
  29. COLOR x          -       Set drawing color to x. 0=Black, 1=Dark Gray,
  30.                          2=Light Gray, 3=White, & 4=XOR. (Defaults
  31.                          to XOR on program execution.)
  32.  
  33. COS(x)           -       Return the cosine of x given in radians.
  34.  
  35. DIM              -       Only single dimension arrays are currently
  36.                          supported. If not explicitly defined by a
  37.                          DIM statement, it is assumed to be a size
  38.                          of 10 upon first reference.
  39.  
  40. DATA x,...       -       Data in program.
  41.         
  42. DELAY x          -       Delay from 10ms to 655 seconds.
  43.                          (Delay length = x * 10ms)
  44.  
  45. END              -       End program.
  46.  
  47. FOR/NEXT         -       Program loop.       
  48.  
  49. FREE             -       Display remaining amount of free memory.
  50.  
  51. GOSUB            -       Execute a subroutine.
  52.  
  53. GOTO             -       Goto specific line.
  54.  
  55. IF/THEN          -       Conditional execution.
  56.  
  57. INPUT            -       Input data from user.
  58.  
  59. INT(x)           -       Returns the integer of x.
  60.  
  61. KEYPAD(x)        -       If x=0, the following bits are returned
  62.                          if that button is pressed.
  63.                            128 - Start    8 - Down
  64.                             64 - Select   4 - Up
  65.                             32 - B        2 - Left
  66.                             16 - A        1 - Right
  67.                          If x>0, then x is ANDed with the bits
  68.                          above. If the result = zero, 0 is returned.
  69.                          If result <> zero, a 1 is returned.
  70.  
  71. LET              -       Assign a value to a variable. (Optional)
  72.  
  73. LINE x1,y1,x2,y2 -       Draw a line on the screen using COLOR.
  74.                          (0<=x<=127,0<=y<=119)
  75.  
  76. LINK x           -       Link 0 - Don't use game link port.
  77.                          Link 1 - Configure port for external terminal.
  78.                          Link 2 - Configure port for external keyboard.
  79.  
  80.                           Gameboy must be reset or power must be cycled
  81.                          for changes to take effect. The last setting is
  82.                          saved in battery backed RAM. (External terminal
  83.                          won't currently work when SERVOs are enabled
  84.                          because of interrupt conflicts.)
  85.  
  86. LIST [x][-][x]   -       List lines of the program. Starting and/or
  87.                          ending line numbers are optional.
  88.  
  89. LOAD             -       Load program from battery-backed RAM.
  90.  
  91. LOCATE           -       Position cursor with coordinates Y,X.
  92.  
  93. MEMTOP x         -       Set Last address of RAM for GB Basic to use.
  94.                          On power up or reset this defaults to $dfff.
  95.                          Lowering this value reserves memory for
  96.                          USR for example. NOTE: All variables are
  97.                          CLEARed when this instruction is executed.
  98.  
  99. PEEK(x)          -       Return value of a memory location x.
  100.  
  101. POINT x,y        -       Draw a point on the screen using COLOR.
  102.                          (0<=x<=127,0<=y<=119)
  103.  
  104. POKE x,y         -       Write value y to a memory location x.
  105.  
  106. PRINT            -       Print to screen.
  107.  
  108. READ             -       Read data contained in DATA statements.
  109.  
  110. REGBC x          -       Sets value of cpu BC registers for entry
  111.                          into USR routine.
  112.  
  113. REGDE x          -       Sets value of cpu DE registers for entry
  114.                          into USR routine.
  115.  
  116. REM              -       Remark. Also ' is supported.
  117.  
  118. RENUM            -       Renumber program.
  119.  
  120. RESTORE          -       Set DATA pointer to a specific line number. If
  121.                          no line number present, beginning of program.
  122.  
  123. RETURN           -       Return from subroutine.
  124.  
  125. RND(x)           -       Returns a random number between 0 and 1.
  126.                          x is ignored.
  127.  
  128. RUN              -       Execute program.
  129.  
  130. SAVE             -       Save program to battery-backed RAM.
  131.  
  132. SCREEN x         -       If x=0, set text mode. If x=1, set graphics mode.
  133.  
  134. SERVO x,y        -       Controls the position of up to 8 memory-mapped
  135.                          servos. SERVO 0,a defines the memory address of
  136.                          the servos output port and enables the servo
  137.                          interrupt routine. SERVO x,y outputs a high
  138.                          pulse to servo x for 693+(y*7.6) microseconds
  139.                          giving a pulse range of .7 to 2.3 ms. A value of
  140.                          y = 0 disables the output pulse of that servo.
  141.                          This pulse is sent out every 20 ms. Servos may be
  142.                          set before issuing SERVO 0,a to enable them. On
  143.                          reset, servos default to off (y=0) and disabled.
  144.                          NOTE: When enabled, servos slow down system about
  145.                          15% due to servo interrupt servicing. Use SERVO 0,0
  146.                          to disable all servos once they have been enabled.
  147.                          (1<=x<=8,0<=y<=210)
  148.  
  149. SGN(x)           -       Returns 1 if x > or = 0. Else returns value -1.
  150.  
  151. SIN(x)           -       Return the sine of x given in radians.
  152.  
  153. SOUND x,y        -       Generate a sound of frequency x for y milliseconds.
  154.                          If y=65535, sound will stay on infinitely. If y=0,
  155.                          sound is turned off.
  156.  
  157. SQR(x)           -       Returns the square root of x.
  158.  
  159. STEP             -       Used with FOR for specifying increment.
  160.  
  161. STOP             -       Same as end but displays line number last executed.
  162.  
  163. TAB(x)           -       Used with PRINT command for moving cursor to
  164.                          column x.
  165.  
  166. TAN(x)           -       Returns the tangent of x given in radians.
  167.  
  168. USR(x)           -       Call user assembly language program at address x.
  169.                          Return value reflects cpu HL registers contents.
  170.  
  171. Revision History
  172. ----------------
  173.  
  174. V1.0  - Original release
  175. V1.01 - Rearranged on-screen keyboard.
  176.         Reassigned key controls.
  177.         Fixed exponent display problem.
  178. V1.02 - Completed RENUM routine.
  179.         Added restore [line#] ability.
  180.         Added hex entry of numbers using prefix &h.
  181. V1.03 - Fixed 'cursor disappear' when arrow buttons pressed.
  182.         Greatly speeded up CLS command.
  183.         Added SCREEN, POINT, & LINE routines.
  184.         Break now works for lines that GOTO themselves.
  185.         Rearranged on-screen keyboard again for faster entry.
  186. V1.04 - Select & Start are BOTH now required to break.
  187.         This was done to allow individual buttons to be pressed
  188.         and read with the new KEYPAD command.
  189.         Added COLOR command.
  190. V1.05 - Added AUTO command.
  191.         Credit screen disappears after 10 seconds.
  192. V1.06 - Fixed bugs in LIST options. Up & down buttons now
  193.         speed up or slow down LIST command. Pressing break
  194.         now halts LIST command.
  195.         Added SOUND command.
  196. V1.07 - Added SERVO command.
  197.         Changed DELAY increments from 1ms to 10ms
  198.          in order to implement SERVO command.
  199.         Select Button is now a caps lock.
  200.         Credit screen now disappears after 4 seconds.
  201.         Carat symbol added to onscreen menu.
  202.         FOR,GOTO,INPUT,LIST,NEXT,PRINT,RUN & THEN
  203.          now can be entered by first letter followed by period.
  204. V1.08 - Shift & Caps Lock now supported on external keyboard.
  205.         CLS now redraws onscreen menu properly in text mode.
  206.         Basic commands can now be entered in lower or upper case.
  207.         DELAY added to 'first letter' list above.
  208. V1.10 - Fixed bug that would randomly display line numbers
  209.          incorrectly.
  210.         Game link port now supports external terminal I/O.
  211.         Added LINK command to configure game link port.
  212.         V1.08 didn't work on VGB. Haven't figured out why yet.
  213. V1.20 - MAJOR BUG FIXES.
  214.         Added better handshaking to link port for reliable
  215.          file download using GB Terminal.
  216.         Fixed bug in floating point conversion that would
  217.          randomly mess up many functions due to interrupts.
  218.         Writing to screen is now much more reliable with no
  219.          more random trash displayed on screen.
  220.         SERVO 0,0 now disables all servo output pulses.
  221.         Added MEMTOP, REGBC, REGDE, & USR commands.
  222. V1.21   Individual servos pulses may now be turned off by
  223.         issuing SERVO x,0. On many servos this lowers battery
  224.         drain when they're not in use.
  225.