CoCopedia - The Tandy/Radio Shack Color Computer Wiki - User contributions [en]

Deluxe Color Computer

2024-11-15T04:49:42Z

Lcurtisboyle: /* Hardware */

= Deluxe Color Computer =

== Pre-Production Boards ==

Three pre-production (PP) boards for the canceled Deluxe Color Computer exist:
* Boisy Pitre has gathered two of the Deluxe pre-production boards, one from John Prickett and one from Greg Zumwalt which did not have Advanced or Deluxe ROMs.
* Brian Weiseler has Robert Kilgus' Deluxe with Advanced Color BASIC 00.00.07 ROMs intact

== Hardware ==

The Deluxe Color Computer upgrades the [[Color Computer 2]] to include new hardware and software features
* Motorola 6847 T1 Video Display Generator (VDG) with true lowercase and lowercase descender characters
* General Instruments AY-3-8913 Programmable Sound Generator the same as [[Speech/Sound Cartridge (26-3144A)]], [[Symphony-12]], [[Philharmonic-12]], or [[CoCo PSG]]
* American Megatrends (AMI) S6551P Asynchronous Communication Interface Adapter (ACIA) the same as used in the [[Deluxe RS232 Pak]]
* Additional circuitry for 60Hz timer interrupts
* Additional color burst control
* Additional address decoding to make the PSG and S6551 into the CoCo memory map
* 2 button joystick support
==== Memory Map ====
* $FF00 - $FF1F - PIA 0
* $FF20 - $FF2F - PIA 1
* $FF30 - Option Control Register
{| class="wikitable"
|+ Option Control Register Description
|-
! Bit Position!! Function
|-
| 0|| A14
|-
| 1|| A15
|-
| 2|| Enable above for RAM range: $4000-$7FFF
|-
| 3|| Alternate color set (blue / green alpha display)
|-
| 4|| N/A
|-
| 5|| N/A
|-
| 6|| Enable 60Hz interrupt
|-
| 7|| Enable cartridge select: 1 internal / 0 external
|}
<gallery>
Deluxe_Option_Register_Description.jpg|Option Register
</gallery>
* $FF38 AY-3-8910 Data register
* $FF39 AY-3-8910 Control Register Latch
* $FF3C SY6551 Transmit / Receive Register
* $FF3D SY6551 Read status registers
* $FF3E SY6551 Command register
* $FF3F SY6551 Control Register

== Software ==

The Deluxe Color Computer contains an upgraded Color BASIC which merges Color BASIC, Extended Color BASIC, and Disk Extended Color BASIC into a single 32K Advanced Color BASIC ROM image.

Advanced Color BASIC includes a number of new features as well:
* [[Advanced Color BASIC Documentation]]

[https://www.pagetable.com/?p=43 Bill Gates' Easter Egg] exists in the Advanced Color BASIC as well from BF67 to BF70

== Pictures ==

<gallery>
DeluxeCoCoMotherboard.jpg|Main board
Deluxe_coco_daughter_card_front.jpg|Front of daughter card
deluxe_coco_daughter_card_back.jpg|Back of daughter card
</gallery>

Advanced Color BASIC Documentation

2024-05-22T06:06:29Z

Lcurtisboyle: /* COMMON */

== 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. There are known bugs (ON ERROR GOTO error codes are not contiguous is an example), and it includes Disk Extended BASIC (to support the built in 32K RAM drive).

=== Allows lowercase characters in keywords. ===
(This includes mixing the case within a keyword.)

=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program). I believe strings were planned - current if passing a string or string array, the string lengths come through, but the ptr to the actual string data gets cleared.
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the '''Videotex''' screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will change the 32x16 text display to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)
''PLEASE NOTE'': The VDG in the Deluxe is not a full implementation of the T1 VDG that appeared in late model Coco 2's (and were duplicated in the Coco 3). It does not support border (green/black) control, and some of the characters are different from both a regular VDG and a T1 VDG (the pipe symbol is an example).

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:44:42Z

Lcurtisboyle: /* Introduction */

== 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. There are known bugs (ON ERROR GOTO error codes are not contiguous is an example), and it includes Disk Extended BASIC (to support the built in 32K RAM drive).

=== Allows lowercase characters in keywords. ===
(This includes mixing the case within a keyword.)

=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the '''Videotex''' screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will change the 32x16 text display to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)
''PLEASE NOTE'': The VDG in the Deluxe is not a full implementation of the T1 VDG that appeared in late model Coco 2's (and were duplicated in the Coco 3). It does not support border (green/black) control, and some of the characters are different from both a regular VDG and a T1 VDG (the pipe symbol is an example).

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:43:27Z

Lcurtisboyle: /* Introduction */

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

=== Allows lowercase characters in keywords. ===
(This includes mixing the case within a keyword.)

=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the '''Videotex''' screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will change the 32x16 text display to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)
''PLEASE NOTE'': The VDG in the Deluxe is not a full implementation of the T1 VDG that appeared in late model Coco 2's (and were duplicated in the Coco 3). It does not support border (green/black) control, and some of the characters are different from both a regular VDG and a T1 VDG (the pipe symbol is an example).

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:43:10Z

Lcurtisboyle: /* Allows lowercase characters in keywords. */

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

=== Allows lowercase characters in keywords. === (This includes mixing the case within a keyword.)

=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the '''Videotex''' screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will change the 32x16 text display to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)
''PLEASE NOTE'': The VDG in the Deluxe is not a full implementation of the T1 VDG that appeared in late model Coco 2's (and were duplicated in the Coco 3). It does not support border (green/black) control, and some of the characters are different from both a regular VDG and a T1 VDG (the pipe symbol is an example).

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:39:33Z

Lcurtisboyle: /* TERM */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the '''Videotex''' screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will change the 32x16 text display to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)
''PLEASE NOTE'': The VDG in the Deluxe is not a full implementation of the T1 VDG that appeared in late model Coco 2's (and were duplicated in the Coco 3). It does not support border (green/black) control, and some of the characters are different from both a regular VDG and a T1 VDG (the pipe symbol is an example).

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:38:20Z

Lcurtisboyle: /* Changed Commands: */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the Vidtex/Videotex screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will change the 32x16 text display to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)
''PLEASE NOTE'': The VDG in the Deluxe is not a full implementation of the T1 VDG that appeared in late model Coco 2's (and were duplicated in the Coco 3). It does not support border (green/black) control, and some of the characters are different from both a regular VDG and a T1 VDG (the pipe symbol is an example).

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:36:24Z

Lcurtisboyle: /* Changed Commands: */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the Vidtex/Videotex screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

'''SCREEN''' has a new option for it's first parameter. -1 will changing to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:36:05Z

Lcurtisboyle: /* Changed Commands: */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the Vidtex/Videotex screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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''' command 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. NOTE: While EDIT lets you select a line number range (and will display them) only the last line changed on screen will actually be committed to the BASIC program (if you edit line 10 and line 20, and hit ENTER to accept the changes after editing line 20, any changes to line 10 will be ignored).

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.

SCREEN has a new option for it's first parameter. -1 will changing to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:33:42Z

Lcurtisboyle: /* Changed Commands: */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the Vidtex/Videotex screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

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

SCREEN has a new option for it's first parameter. -1 will changing to true lowercase. So the acceptable values for the first parameter (the 2nd parameter is optional, for the colorset 0 or 1) are:
* SCREEN -1 (true lowercase)
* SCREEN 0 (inverse lowercase)
* SCREEN 1 (graphics mode)

== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:22:56Z

Lcurtisboyle: /* TERM */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon. It appears to support most of the Vidtex/Videotex screen controls (although without RLE graphics support).
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:21:28Z

Lcurtisboyle: /* ENV param1,param2,param3,param4,param5 */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD). It appears that each parameter is actual two individual byte values

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. (At first glance, it does not appear to)

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:16:23Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>''' Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:16:08Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* '''POKE &HA00,<key repeat delay value>''' (0=no key repeat). Default value is 10 (1/6th of a second)
* '''POKE &H9FF,<key repeat start delay value>'''. Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:15:35Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* POKE &HA00,<key repeat delay value> (0=no key repeat). Default value is 10 (1/6th of a second)
* POKE &H9FF,<key repeat start delay value>. Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:14:14Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
* POKE &HA00,<key repeat delay value> (0=no key repeat). Default value is 10 (1/6th of a second)
* POKE &H9FF,<key repeat start delay value> Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:13:46Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
POKE &HA00,<key repeat delay value> (0=no key repeat). Default value is 10 (1/6th of a second)
POKE &H9FF,<key repeat start delay value> Default value is 30 (1/2 a second)
Both delay values are a count of 1/60th second VSYNC interrupts. NOTE: I would not recommend changing the key repeat start delay value to below 15 (or even 20) as it will start repeating quick that it begins to operate with keybounce.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:12:26Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
POKE &HA00,<key repeat delay value> (0=no key repeat). Default value is 10 (1/6th of a second)
POKE &H9FF,<key repeat start delay value> Default value is 30 (1/2 a second)

Both delay values are a count of 1/60th second VSYNC interrupts.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-05-22T05:12:08Z

Lcurtisboyle: /* Key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===
While there is no BASIC command to change either the key repeat speed, or the delay time before key repeat starts, Advanced Color Basic does initialize 2 memory locations in RAM with defaults, that one can change after the fact:
POKE &HA00,<key repeat delay value> (0=no key repeat). Default value is 10 (1/6th of a second)
POKE &H9FF,<key repeat start delay value> Default value is 30 (1/2 a second)

Both delay values are a count of 1/60th second VSYNC interrupts.

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN ===

Chains to another BASIC program. Optional line number to start 2nd program running from.

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-23T17:02:14Z

Lcurtisboyle: /* TIME */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. ===

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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 number of 1/60th clock ticks that the current TIME$ value represents (including hours, minutes and seconds).
 Please note that it rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-23T17:00:17Z

Lcurtisboyle: /* New commands */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. ===

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

If no COMMON command has been issued before CHAIN, then all variables are initialized in the called program (same as RUN). However, any numeric variables or arrays defined in a COMMON command will be passed intact to the called program.

=== COMMON ===
This defines variables to pass along to a CHAIN'ed program. From what I can tell, these can only be be numeric (either straight variables or arrays), but not strings. For regular variables, specify the 1 or 2 character variable name. For arrays, specify the array name with open and closes parenthesis, but with no number to designate how many elements (the chained program will inherit the size used by the calling program).
COMMON A,B,C,SC()

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-23T16:50:55Z

Lcurtisboyle: /* RESTORE enhancement */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. ===

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-23T16:50:21Z

Lcurtisboyle: /* New device number: #-4 - tbd */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== RESTORE enhancement ===
The RESTORE command by itself (as before) will reset the READ/DATA ptr to the first DATA line in the current BASIC program. A new option of specifying the line number of the DATA statement that the next READ should come from has been added.
ex.
RESTORE 1000:'This sets the next READ to get data from line 1000.

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. ===

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-13T05:05:30Z

Lcurtisboyle: /* CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== New device number: #-4 - tbd ===

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. ===

CHAIN "PROGRAM[.BAS][,<line number>]

Line number can be a variable.

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-13T05:04:28Z

Lcurtisboyle: /* CHAIN - tbd. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== New device number: #-4 - tbd ===

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - Chains to another BASIC program. Optional line number to start 2nd program running from. ===

CHAIN "PROGRAM[.BAS][,<line number>]

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-13T04:57:51Z

Lcurtisboyle: /* Allows lowercase characters in keywords, and key repeat is built in. */

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

=== Allows lowercase characters in keywords. ===
=== Key repeat is built in. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== New device number: #-4 - tbd ===

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - tbd. ===

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-13T04:52:11Z

Lcurtisboyle: /* TERM */

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

=== Allows lowercase characters in keywords. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== New device number: #-4 - tbd ===

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - tbd. ===

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-03-13T04:51:50Z

Lcurtisboyle: /* TERM */

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

=== Allows lowercase characters in keywords. ===

=== 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, Control-I) will move the cursor right 8 spaces.
* Left Arrow (without the alternate key, Control-H) will move the cursor one space to the left, and clear the character.
* Control and 'U', Shift-Left Arrow will clear the line and move the cursor to the left.
* The break key will abort editing and put the cursor at the bottom left of the screen.
* CLEAR (Control-L) will abort editing and clear 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"

=== New device number: #-4 - tbd ===

=== 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 ===
* 5 numeric parameters 0-65535 allowed (TBD)

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

=== CHAIN - tbd. ===

=== 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 and Escape sequences within the terminal programming coming soon.
ALT-BREAK = Exit terminal
F1 = toggle CR / CR LF
F2 = toggle Local Echo on/off

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-02-22T07:46:16Z

Lcurtisboyle:

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

=== Allows lowercase characters in keywords. ===

=== 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"

=== New device number: #-4 - tbd ===

=== 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

=== CHAIN - tbd. ===

=== 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 = 1,200
* 9 = 1,800
* 10 = 2,400
* 11 = 3,600
* 12 = 4,800
* 13 = 7,200
* 14 = 9,600
* 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.78 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 bit wise 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). 
This counter increments 60 times per second and rolls over at 24 hours.

=== 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 key presses. They are put into A$. This will support cassette, serial and disk file I/O.

=== 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 (executes the TERM (terminal program) command, I believe)
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] - Call $9254, which checks the 6551 initialized flag (>$0A04). If it is 0 (not initialized), it will initialize the 6551 & it’s related variables including 128 byte receive buffer. If not, it just returns.

[$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.

Advanced Color BASIC Documentation

2024-02-19T00:41:56Z

Lcurtisboyle: /* MAPMODE */

Advanced Color BASIC Documentation

2024-02-19T00:40:30Z

Lcurtisboyle: /* Advanced Color BASIC - added ROM vector calls = */

Advanced Color BASIC Documentation

2024-02-19T00:39:38Z

Lcurtisboyle: /* Advanced Color BASIC - added ROM vector calls = */

Advanced Color BASIC Documentation

2024-02-19T00:39:14Z

Lcurtisboyle: /* Advanced Color BASIC - added ROM vector calls = */

Advanced Color BASIC Documentation

2024-02-19T00:27:59Z

Lcurtisboyle: /* Advanced Color BASIC - added ROM vector calls = */

Advanced Color BASIC Documentation

2024-02-19T00:27:21Z

Lcurtisboyle: /* TERM - tbd. */

Advanced Color BASIC Documentation

2024-02-19T00:26:05Z

Lcurtisboyle: /* TIME$ - tbd */

Advanced Color BASIC Documentation

2024-02-19T00:23:54Z

Lcurtisboyle: /* TIME */

Advanced Color BASIC Documentation

2024-02-19T00:23:33Z

Lcurtisboyle: /* TIME - returns the current value for the 24 bit timer (the old Extended BASIC "TIMER" still works as a 16 bit timer) */

Advanced Color BASIC Documentation

2024-02-19T00:23:05Z

Lcurtisboyle: /* TIME - tbd */