Advanced Color BASIC Documentation

Advanced Color BASIC - New and updated features explained

Introduction

This document explains the version 0.0.7 of Advanced Color BASIC ROM found late in 2023.
It is from Robert Killgus' collection.
This is a very early version of the software and eventually became Deluxe Color BASIC.

Full screen editor is always available.

Hold alternate and arrow keys to move the cursor around. Alternate and 'I' will insert a space and move the characters after the cursor to the right one space. Alternate and 'D' will delete the character under the cursor and shift the remaining characters to the left. Alternate and 'E' will delete the characters after the cursor to the end of the line. Alternate and ‘H” will move the cursor to the top left corner of the screen. Right Arrow (without the alternate key) will move the cursor right 9 spaces. The break key will abort editing and put the cursor at the bottom left of the screen. Press the enter key to commit an edited line. You do not have to be at the end of a line.

New device number: #-3.

Sends and receives data to/from the new serial port. Uses: PRINT #-3, "HELLO WORLD"

RAM Disk

Drive 4 is a RAM Disk. It has 12 granules available. It is available even if there is no disk cartridge inserted.

If a disk cartridge is inserted on cold boot, you are presented with a menu option to go to BASIC or "Disk". If you choose "Disk" the equivalent of a DOS command is executed.

New commands

ERROR <value>

Will cause the computer to stop the program and issue the respective error.

RESUME <line number>

Resumes a program at line number from the error handler.

WHILE <boolean expression> / WEND

This is a loop construct that will execute the statements between WHILE and WEND repeatedly until the boolean expression is false.

TONE channel, toneperiod, amplitude

channel: 1-3 toneperiod: 0-4095 amplitude: 0-15

NOISE channel,noiseperiod,amplitude

channel: 1-3 noiseperiod: 0-31 amplitude 0-15

ENV param1,param2,param3,param4,param5

TBD 5 numeric parameters 0-65535 allowed

TONE 1,2048,15 ' start tone 2048 on channel 1 at max volume NOISE 2,31,15 ' start noise 31 on channel 2 at max volume NOISE 2,0 ' stop noise on channel 2 TONE 1,0,0 ' stop tone on channel 1 SOUND command unaltered TBD determine if PLAY command supports 3-voice like N60 BASIC (also by Microsoft) does

COMMON

Restrictive comment. For Example: 10 COMMON This is a comment : PRINT “HELLO WORLD” The text after the COMMON command will not be executed, but the command after the colon will. This is different from REM 10 REM This is a comment : PRINT “HELLO WORLD” The REM command will cause everything to be ignored on the whole line.

TERM

Executes the ROM based terminal program (the cursor changes from a blinking black one to a blinking blue one to let the user know that they are in terminal mode). Further details on commands within the terminal programming coming soon.

CONFIG

Configures the UART Serial port: CONFIG #-3,[1-15],[1-5],[5-8],[1-2] First parameter: BAUD 1 = 50 2 = 75 3 = 109.92 4 = 135.56 5 = 150 6 = 300 7 = 600 8 = 1200 9 = 1800 10 = 2400 11 = 3600 12 = 4800 13 = 7200 14 = 9600 15 = 19,200 Default: 6

Second Parameter: Sent to 6551 command register 1: $09 00001001 - No Parity 2: $29 00101001 - Odd Parity 3: $69 01101001 - Even Parity 4: $A9 10101001 - Mark Parity 5: $E9 11101001 - Space Parity Transmit interrupt disabled Default: 1

Third parameter: Data word length, 5 to 8. Default: 8

Fourth parameter: Stop Bits 1 = 1 stop bit 2 = 2 stop bits Default: 1

MAPMODE <value>

If the value is 0, the Color Computer is set to 0.89 MHz for the entire address space. If the value is 1, the Color Computer is set to 1.76 MHz speed when reading from ROM, and 0.89 MHz when reading or writing to RAM.

XOR

The exclusive or operator is true if 1 (and only 1) input is true, otherwise it is false. This is used in the same sense as AND and OR in if/then statements: IF A XOR B THEN 40 It is also use like AND and OR in bitwise expressions: C = A XOR B

ERR

Variable that contains the last error number.

ERL

Variable that contains the line number where the last error occurred.

TIME

Returns the current value for the 24 bit timer (the old Extended BASIC "TIMER" still works as a 16 bit timer).

TIME$

Will either return the current 24 hour clock value, or set the 24 hour clock value, using a string format. The string format is "HH:MM:SS", in 24 hour time format, so HH can be 0 to 23, MM can be 0 to 59, and SS can be 0 to 59. Examples:

 A$=TIME$
 TIME$="13:25:00"

STRIG(button)

This function returns the state of one of the four joystick buttons. Negative 1 if pressed, zero if not pressed.
Button numbers 1, 3, 5, 7 return the real time value of the button state. This allows rapid fire with the button held down.

• 1 - Left joystick button 1
• 3 - Left joystick button 2
• 5 - Right joystick button 1
• 7 - Right joystick button 2

Button numbers 0, 2, 4, 6 return -1 if the button was pressed since the last time this function was called.
It will then return 0 as long as the button is held down. A new button press will be required to get another -1. This is for single shot fire - the user needs to let go and press the button again in order to fire again.

• 0 - Left joystick button 1
• 2 - Left joystick button 2
• 4 - Right joystick button 1
• 6 - Right joystick button 2

INPUT$(count, device)

Used to scan an input device and accumulate a string: 10 A$=INPUT$(3,#0) 20 ? A$ Will pause the program and wait for three keypresses. They are put into A$.

ON ERROR GOTO <line number>

BASIC will jump to line number when an error is encountered. ERL and ERR will contain the line number with the error and the numeric error code, respectively.

Changed Commands:

The EDIT will now accept a single line number or a range. The command will clear the screen, list the program line/lines and put the cursor at the start of the screen.

A CLS value of 9 to 255 will cold start the computer. We suspect that this is a bug that should eventually be fixed.

A CLS value greater than 255 will cause an ?FC error.

Advanced Color BASIC - added ROM vector calls =

Like Color BASIC and Disk BASIC, which used Extended indirect addresses to call functions within the ROM’s (like JOYIN, DSKCON, etc.), Advanced Color BASIC seems to reserve from $8000-$8015 for additional calls as well. This allows the routines themselves to move around as the ROM was updated, but calling programs would have a set point to enter them. [$8000] - Calls $FB00, which is a 3 entry table of LBRA instructions: LBRA $FD32 LBRA $FB1A LBRA $FD92 [$8002] - Calls $FB09, which is a 1 entry table of LBRA instructions (I assume more would have been added later) LBRA $FE16 [$8004] - ??? (points to $09D4, which is in BASIC’s data area) [$8006] - ??? (points to $E968) [$8008] - ??? (points to $0ABE, which is in BASIC’s data area) [$800A] - ??? (points to $AD15) [$800C] - If $0A04=0, initialize the 6551 & it’s related variables including 128 byte receive buffer (calls $9254) [$800E] - ??? (points to $929D) [$8010] - ??? (points to $DE28) [$8012] - Calls $92E7, which will return a character from the 128 byte RS232 receive buffer, OR wait for an RS232 character to be received if the buffer is empty. [$8014] - Calls $92BD, which will transmit a character through the RS232.