This is the Commander X16 ROM containing BASIC, KERNAL, and DOS. BASIC and KERNAL are derived from the Commodore 64 versions.
- BASIC is fully compatible with Commodore BASIC V2, with some additions.
- KERNAL
- supports the complete $FF81+ API.
- adds lots of new API, including joystick, mouse and bitmap graphics.
- supports the same $0300-$0332 vectors as the C64.
- does not support tape (device 1) or software RS-232 (device 2).
- DOS
- is compatible with Commodore DOS (
$
,SCRATCH
,NEW
, ...). - works on SD cards with FAT32 filesystems.
- supports long filenames, timestamps.
- supports partitions and subdirectories (CMD-style).
- is compatible with Commodore DOS (
- CodeX Interactive Assembly Environment
- edit assembly code in RAM
- save program, and debug information
- run and debug assembly programs
Each release of the X16 emulator includes a compatible build of rom.bin
. If you wish to build this yourself (perhaps because you're also building the emulator) see below.
WARNING: The emulator will currently work only with a contemporary version of
rom.bin
; earlier or later versions are likely to fail.
Building this source code requires only GNU Make, Python 3.7 (or higher) and the cc65 assembler. GNU Make is almost invariably available as a system package with any Linux distribution; cc65 less often so.
- Red Hat/CentOS:
sudo yum install make cc65
- Debian/Ubuntu:
sudo apt-get install make cc65
On macOS, cc65 in homebrew, which must be installed before issuing the following command:
- macOS:
brew install cc65
If cc65 is not available as a package on your system, you'll need to install or build/install it per the instructions below.
If lzsa is not available as a package on your system, you'll need to install or build/install it per the instructions below.
To check the version of python you have use python3 --version
.
Once the prerequisites are available, type make
to build rom.bin
. To use that with the emulator, copy it to the same directory as the x16emu
binary or use x16emu -rom .../path/to/rom.bin
.
Additional Notes: For users of Red Hat Enterprise Linux 8, you will need to have CodeReady builder repositories enabled, for CentOS, this is called PowerTools. Additionally, you will need Fedora EPEL installed as well as cc65 does not come usually within the official repositories.
You'll need the basic set of tools for building C programs:
- Debian/Ubuntu:
sudo apt-get install build-essential git
The cc65 source is on GitHub; clone and build it with:
git clone https://github.com/cc65/cc65.git
make -j4 # -j4 may be left off; it merely speeds the build
This will leave the binaries in the bin/
subdirectory; you may use thes directly by adding them to your path, or install them to a standard directory:
# This assumes you have ~/.local/bin in your path.
make install PREFIX=~/.local
Consult the Nesdev Wiki Installing CC65 page for some hints, including Windows installs. However, the Debian packages they suggest from trikaliotis.net appear to have signature errors.
The lzsa
compression utility is used for some resources packaged into the ROM, and is available on Github; clone and build it with:
git clone [email protected]:emmanuel-marty/lzsa.git
make
The lzsa
utility will be left in the root directory of the repository. It can be copied into a directory in your path, such as ~/.local/bin
.
The lzsa
repository contains project files for both Visual Studio 2017 and XCode, which should allow it to be built for Windows and OS X.
See LICENSE.md
This is mainly a minor bugfix release.
- KERNAL
- Changes to the joystick polling routine released with R45 had a bad interaction with the emulator, causing the emulated buttons to shift by one bit. This affects the emulator but not real hardware. The polling sequence and timing were changed to be in line with how it was done in R44. [stefan-b-jakobsson]
- Caps Lock incorrectly shifted the
'
key to"
in the ABC/X16 keyboard layout. [stefan-b-jakobsson] mouse_scan
had a race againstmouse_get
, specifically if the KERNAL interrupt service routine happend in the middle of reading out one of the 16-bit values of X/Y, the high and low values could be returned out of sync. [stefan-b-jakobsson]
- UTILITIES
- Stefan B. Jakobsson's X16-Edit has been updated to fix a hang that happens if it is launched without an SD card present.
- META
- The meaning of the version byte at bank 0 $FF80 has been updated to comport with the original intent of having prereleases as a negative number and releases as a positive number. Release R45 will have 45/
$2D
in this spot, while later builds should show as -46/$D2
to indicate R46 prerelease. This should make minimum version checking in applications a lot easier for custom builds and for in-between updates. - Dependency improvements in the Makefile.
lzsa
is now a build dependency as it compresses X16-Edit's help text.- VERA firmware versions earlier than 0.3.x will display a deprecation warning on the splash screen.
- The meaning of the version byte at bank 0 $FF80 has been updated to comport with the original intent of having prereleases as a negative number and releases as a positive number. Release R45 will have 45/
- KERNAL
- Paired with updates in SMC firmware 45.1.0, Intellimouse support has been added. This allows for reading the scroll wheel and potentially buttons higher than 3, depending on the mouse type.
- clock_get_date_time and clock_set_date_time can now return and set the RTC's day of week field. [markjreed]
- New block-wise write call
MCIOUT
to complement the block-wise read callMACPTR
. This seems to acceleratesave
type calls by about 5x. CINT
call now uploads the default X16 palette to the VERA.- New I2C batch read and write commands
i2c_batch_read
andi2c_batch_write
.
- DOS/FAT32
- Fully split DOS and FAT32 into two separate banks, freeing up ample space for fixes and enhancements.
MCIOUT
call implementation for FAT32
- BASIC
- new
EXEC
command plays back scripted input from a RAM location. MENU
now produces a menu of built-in applications.- Improvements to the layout of the second BASIC bank (annex) allowing for more functions to be moved to this area, making room for new features.
- new system variable
MWHEEL
returns the mouse wheel delta since the last call as a signed 8-bit value. - new
TILE
comamnd, making pokes to layer 1 screen memory easier. - new
EDIT
command, invoking the built-in text editor X16-Edit. - new sprite-handling commands
MOVSPR
,SPRITE
, andSPRMEM
. The first two have parameters which are inspired by the Commodore 128 version of the commands, but their usage is not exactly the same. VPOKE
andVPEEK
can now be used to reach add-on VERA cards. VRAM banks 2-3 point to a VERA at$9F60
and VRAM banks 4-5 point to a VERA at$9F80
.- DOS wedge emulation.
@
,/
, and friends can be used in BASIC immediate mode. - Chain-
LOAD
ing another BASIC program from within a BASIC program was problematic when the second program used variables, as the variable table pointer was not updated after the load. This was a deficiency in BASIC V2, and is now fixed for the Commander X16. - A bug has been fixed affecting
LINPUT
,LINPUT#
, andBINPUT#
. These statements would spuriously return aSTRING TOO LONG
error whenever BASIC needed to garbage-collect the string memory before allocating string space to these functions. - After a
LOAD
orBLOAD
into banked RAM, the RAM bank that the load ended at is saved as if the user called theBANK
command with this value. Prior to this release, the end bank could be immediately read withPEEK(0)
after loading, but would be clobbered later on as BASIC would reset the RAM bank to the one set byBANK
.
- new
- MONITOR
- Improvements related to unwinding the stack to make the PC and register values useful and continuation possible. Making the
BRK
instruction as a breakpoint useful in some situations. - The MONITOR now reuses BASIC's zeropage space, no longer clobbering user ZP $22-$2F
- New
J
command for JSR into memory, complementing theG
command to continue execution.
- Improvements related to unwinding the stack to make the PC and register values useful and continuation possible. Making the
- UTILITIES
- The 8-Bit Guy's hex editor has been added to the
MENU
- Stefan B. Jakobsson's X16-Edit has been added to the
MENU
, and is also callable from BASIC'sEDIT
command, or via an API call in bank 13, making it useful as an editor spawned by other applications.
- The 8-Bit Guy's hex editor has been added to the
This is the third release of x16-rom by the X16Community team
- KERNAL
- BREAKING CHANGE
- The first batch of X16 developer boards were originally shipped without VPB support. The VPB bodge will need to be done before upgrading to ROM version R44 or later. Most of the board owners have been walked through doing the bodge. If you have such an early board (DEV0004-DEV0014) and have not performed the modification, please reach out on the Commander X16 forums or on Discord.
- Implement a custom callback from the screen editor to intercept, suppress, or remap key events. This is used by the MONITOR to handle scrolling off the top and bottom of the screen when viewing disassembly or memory, but it is also available to user programs.
- Move NMI/IRQ handler entry into low RAM, which now requires hardware or emulator VPB support. Prior to this change, VPB was optional. [akumanatt]
- Add PS/2 Menu key to keycode.inc [stefan-b-jakobsson]
- Validate nvram checksum before fetching keyboard layout [stefan-b-jakobsson]
- Improve bounds checking when loading the keymap from nvram
- In the screen editor, pressing Shift+40/80 (Shift+ScrLock) to change outputs now emits a beep code to indicate which output is selected. (Low=VGA, Mid=NTSC, High=RGB)
- Depending on VERA version, kernal ISR now preserves the FX_CTRL register when doing screen updates (cursor blink, mouse sprite).
- VERA firmwares without a version number or those older than v0.1.1 will display a deprecation warning at boot.
- Change joystick scan timing to support more third party SNES controllers. [jburks]
- Prevent the scroll delay when holding Ctrl from clearing the keyboard buffer. This was resulting in dropped characters after pasting code into the emulator on PC.
- Scale mouse H/V separately based on screen mode.
- Set mouse pointer to center of display when activating.
- Preserve L+R outputs for PSG voice 0 around beep function
- BREAKING CHANGE
- CHARSET
- revert accidental deletion of the butterfly glyph from the main ISO character set.
- DOS
- Fix bug in
C
copy command [stefan-b-jakobsson] - Add
$=L
long directory output, which includes both a human readable size (e.g. "16 KB") and a machine readable exact file size (e.g.0003fa30
). The line also includes the FAT attribute byte (e.g.10
), and the modified timestamp in ISO format. - Treat
,
comma as an invalid CMDR-DOS filename character, show as?
in listings.
- Fix bug in
- BASIC
- Fix bug with overbroad REN(UMBER) line number parsing
- new
BANNER
statement - Honor new end-of-basic address after call to
MEMTOP
- Fix old BASIC garbage collect bug [XarkLabs]
- Change
OLD
so that it doesn't try to loadAUTOBOOT.X16
[stefan-b-jakobsson] - Add YM variant field in the output of the
HELP
command. - The
DOS
directory listing command will now case-fold any filename characters which appear as shifted PETSCII if the screen editor is in PETSCII mode, which should mitigate most of the problems with lowercase filenames. VAL()
can now parse hex ($xxxx
) and binary (%xxxxxxxx
) literals
- MONITOR
- When triggering entry into the monitor via BRK, the displayed PC and registers should now reflect the state upon BRK. The PC will be show as one byte after the BRK instruction.
- GRAPH
- Accelerate fb_fill_pixels [stople]
- Fix uninitialized px/py state in console_init
- AUDIO
- Fix logic bug in
psg_write_fast
routine. - Add YM chip type detection logic.
ym_init
can distinguish between a YM2151 and a YM2164.
- Fix logic bug in
- UTIL
- Always enable nvram battery backup when exiting
MENU
[stefan-b-jakobsson]
- Always enable nvram battery backup when exiting
- BUILD
- Portability enhancements [dressupgeekout]
- Drop GEOS bank
- Remove stale C64 target
This is the second release of x16-rom by the X16Community team
- KERNAL
- BREAKING CHANGE
- The keyboard protocol between the SMC and the KERNAL has changed. This release requires a firmware update to the System Management Controller on hardware, or on emulator, release R43 or later.
- This change also affects how the custom keyboard handler vector works (keyhdl). For details, see Chapter 2 of the Programmer's Reference Guide
- Your Keyboard will not work unless you are running
- R43 of both x16-rom and x16-emulator (on emulator)
- R43 of both x16-rom and x16-smc (on hardware)
- Build
- Add git signature to ROM build process
- Update source to use zp addressing mode where appropriate, which suppresses warnings about using absolute mode for zp addresses.
- Due to cc65's use of KERNAL RAM locations,
.assert
s were added to try to stablize RAM locations that are hardcoded in cc65's constants file.
- Hardware support
- Additional support for display preferences and keymap stored in nvram
- Support VPB. Hardware with this design sets the hardware ROM bank to 0 immediately before reading a ROM vector. The previous ROM bank will still be in zp
$01
upon interrupt handler entry. - Bugfix: fix joysticks always being detected
- Editor/Display
- New bordered screen modes to support CRTs
- New behavior for the END key. END will go to the end of the current line. Shift+END will go to the last line on the screen.
- PS/2 Delete key now deletes the character underneath the cursor.
- Blinking cursor should be more visible during movement.
- Support for automatically setting 240p in NTSC and RGB modes for screen modes that are scaled 2x vertically.
- New skinny PET style PETSCII and ISO charsets.
- Replace bold ISO charset [akumanatt]
- BASIC
- New logo splash logic for smaller screen modes
- Show git signature in BASIC splash screen under non-releases
REBOOT
andRESET
behaviors swapped.- Add "I" (instrument) to playstring macros for FMPLAY, PSGPLAY, and friends.
- Bugfix: If unable to read color pref from nvram, use the default white on blue.
- Show DOS status after
SAVE
andDOS
commands. - Modify the output of F-keys in the BASIC editor. Removed F9 for keymap cycling.
- Bugfix: Better support for reading CBM drives' status with the
DOS
command. - Make
FRE(n)
always return a positive value. - New BANNEX (BASIC annex) for overflow code from BASIC.
- New commands:
MENU
- load utilityREN
- renumber BASIC programLINPUT
- Read line from keyboardLINPUT#
- Read delimited data from fileBINPUT#
- Read fixed-length data from fileHELP
- Show short help blurb and hardware versions.
- New functions:
POINTER()
- return pointer to variable structureSTRPTR()
- return pointer to string variable's dataRPT$()
- return a string made up of a repeated byte
- MONITOR
- Bugfix: Better support for reading CBM drives' status with the
@
command - Bugfix: Clear bank flags at init [stefan-b-jakobsson]
- Bugfix: Better support for reading CBM drives' status with the
- API
- Allow
sprite_set_position
to retain existing priority/flip values in attribyte byte 6.
- Allow
- GRAPH
- Fully implement
fb_fill_pixels
[stople]
- Fully implement
- BREAKING CHANGE
This is the first release of x16-rom by the X16Community team
- KERNAL
- I2C
- Fixed I2C writing [mist64]
- Support battery backup [jburks]
- Moved PS/2 functions to I2C interface [jburks, stefan-b-jakobsson]
- Caps Lock LED and 40/80 key support [stefan-b-jakobsson]
- Editor
- Added WAI to busy loop [LRFLEW]
- Cosmetic fixes [jestin, stefan-b-jakobsson]
- Fix line wrap in 20 column modes [mooinglemur]
- Shift+40/80 will cycle through the three output modes: VGA, Composite, RGB
- Channel I/O
- MACPTR: support non-incrementing I/O address as destination [ZeroByteOrg]
- Fix VERIFY routine (a special case of LOAD).
- Add headerless SAVE (
BSAVE
) API at$FEBA
, which otherwise behaves identically toSAVE
at$FFD8
- Memory
- Improved RAM detection and testing, allowing for high RAM amounts other than a power of 2 [JimmyDansbo]
- Fix memory_decompress to VRAM [bsb-Rickd]
- New cartridge detection and booting in ROM bank 32
- NMI vector has been replicated in all configured banks to point to a new RAM trampoline that in turn sets the ROM bank to 0 and jumps through (nminv), which by default points to a KERNAL routine that behaves like STOP+RESTORE on the C64.
- Support RTC NVRAM settings for two profiles to control screen output mode and resolution at boot, selectable with the 40/80 key. Currently requires an external configuration program to set up the profiles.
- Allocate a page of RAM bank 0 intended for use by user programs to accept parameters set by other such programs such as, for example, file browsers or launchers.
- Gamepad
- Properly set presence for nonstandard controllers [akumanatt]
- I2C
- DOS
- Return the current working directory with
DOS"$=C"
[mooinglemur] - Prevent attempt at cross-directory renames as they're not supported.
- Allow file append syntax with secondary address 1 (write)
- Return the current working directory with
- BASIC
- Stabilize token assignments for X16 additions to BASIC keywords. BASIC programs saved in this release should be compatible with future releases. [stefan-b-jakobsson]
- New commands and functions [stefan-b-jakobsson, jestin, mooinglemur]
BANK
BSAVE
FMCHORD
FMDRUM
FMFREQ
FMINIT
FMINST
FMNOTE
FMPAN
FMPLAY
FMPOKE
FMVIB
FMVOL
I2CPEEK
I2CPOKE
POWEROFF
PSGCHORD
PSGFREQ
PSGINIT
PSGNOTE
PSGPAN
PSGPLAY
PSGVOL
PSGWAV
REBOOT
SLEEP
- Allow
ASC("")
to return 0 rather than an error - Allow
RESTORE
to take a line number argument to set the READ pointer to an arbitrary DATA constant. - Added test case test/show-gfx.bas [Jaxartes]
- GRAPH
- New bank for graphics and font routines to free up KERNAL bank space [stefan-b-jakobsson]
- Implement FB_set_palette [irmen]
- AUDIO
- New bank and new machine language API to interact with the YM2151 and VERA PSG, including a full General MIDI-inspired patch set for the YM2151 mainly for use with new BASIC statements [ZeroByteOrg, mooinglemur, jestin]
- YM2151 and VERA PSG are silenced and reinitialized at boot and in the default handlers for NMI and BRK.
- CODEX
- Fix for line delete crash [stefan-b-jakobsson]
- Fix for build under latest cc65 [mooinglemur]
- GEOS
- Fix mouse issues [stefan-b-jakobsson]
- Documentation
- Improve README.md [mobluse]
- Build
- Add ROM build to CI/CD [maxgerhardt]
- KERNAL
- keyboard
- added 16 more keyboard layouts (28 total)
- default layout ("ABC/X16") is now based on Macintosh "ABC - Extended" (full ISO-8859-15, no dead keys)
- "keymap" API to activate a built-in keyboard layout
- custom keyboard layouts can be loaded from disk (to $0:$A000)
- Caps key behaves as expected
- support for Shift+AltGr combinations
- support for dead keys (e.g. ^ + e = ê)
- PgUp/PgDown, End, Menu and Del generate PETSCII codes
- Numpad support
- Shift+Alt toggles between charsets (like C64)
- Editor: "End" will position cursor on last line
- VERA source/target support for
memory_fill
,memory_copy
,memory_crc
,memory_decompress
[with PG Lewis] - fixed headerless load for verify/VRAM cases [Mike Ketchen]
- don't reset screen colors on mode switch
- keyboard
- BASIC:
BLOAD
,BVLOAD
andBVERIFY
commands for header-less loading [ZeroByteOrg]KEYMAP
command to change keyboard layout- support
DOS8
..DOS31
(andA=9:DOSA
etc.) to switch default device MOUSE
andSCREEN
accept -1 as argument (was: $FF)- Changed auto-boot filename from
AUTOBOOT.X16*
toAUTOBOOT.X16
- Monitor:
- fixed RMB/SMB disassembly
- Charset:
- X16 logo included in ISO charset, code $AD, Shift+Alt+k in ISO mode
- KERNAL
- Features
- NMI & BRK will enter monitor
- added ':' to some F-key replacements
- allow scrolling screen DOWN:
PRINTCHR$($13)CHR$($91)
- Serial Bus works on hardware
- Bugs
- fixed SA during LOAD
- fixed joystick routine messing with PS/2 keyboard [Natt Akuma]
- API
- keyhandler vector ($032E/$032F) doesn't need to return Z
- PLOT API will clear cursor
- Features
- BASIC * on RESET, runs PRG starting with "AUTOBOOT.X16" from device 8 (N.B.: on host fs, name it "AUTOBOOT.X16*" for now!) * BOOT statement with the same function
- DOS
- better detection of volume label
- fixed
$=P
(list partitions),$*=P
/D
(dir filtering), hidden files
- MONITOR
- fixed F3/F5 and CSR UP/DOWN auto-scrolling
- fixed LOAD, SAVE, @
- CodeX
- works this time! [mjallison42]
- KERNAL
- Adaptation to match Proto 2 Hardware
- support for 4 SNES controllers
- 512 KB ROM instead of 128 KB
- new I/O layout
- PS/2 and SNES controller GPIOs layout
- banking through $00 and $01
- Proto 2 Hardware Features
- I2C bus (driver by Dieter Hauer, 2-clause BSD)
- SMC: reset and shutdown support
- RTC:
DA$
/TI$
and KERNAL APIs bridge to real-time-clock
- Screen Features
- New screen_mode API allows setting and getting current mode and resolution
- support for 320x240 framebuffer (mode $80/128) [with gaekwad]
- added 80x30,40x60,40x30,40x15,20x30,20x15 text modes (note new numbers!)
- Keyboard Features
- added KERNAL vector to allow intercepting PS/2 codes [Stefan B Jakobsson]
- added kbdbuf_peek, kbdbuf_get_modifiers, kbdbuf_put API
- Other Features
- support for LOADing files without 2-byte PRG header [Elektron72]
- support for LOAD into banked RAM (acptr and macptr)
- support BEL code (
PRINT CHR$(7)
) - keyboard joystick (joystick 0) supports all SNES buttons
- support for 4 SNES controllers (joystick 1-4) [John J Bliss]
- Bugs
- fixed crash in FB_set_pixels for count>255 [Irmen de Jong]
- fixed bank switching macros [Stephen Horn]
- fixed preserving P in JSRFAR [CasaDeRobison]
- fixed race condition in joystick_get [Elektron72]
- removed ROM banking limitations from JSRFAR and FETVEC [Elektron72, Stefan B Jakobsson]
- fixed disabling graphics layer when returning to text mode [Jaxartes]
- fixed default cursor color when switching to text mode
- reliable mouse_config support for screen sizes
- Adaptation to match Proto 2 Hardware
- Math
- renamed "fplib" to "math"
- made Math package compatible with C128/C65, but fixing FADDT, FMULTT, FDIVT, FPWRT
- BASIC
- Features
- added
BIN$
&HEX$
functions [Jimmy Dansbo] - added LOCATE statement
- added
- Bugs/Optimizations
- removed extra space from BASIC error messages [Elektron72]
- fixed
DA$
andTI$
when accessed together or withBIN$()
/HEX$()
[Jaxartes] - fixed null handling in
GET
/READ
/INPUT
[Jaxartes] - fixed bank setting in
VPOKE
andVPEEK
[Jaxartes] - fixed optional 'color' argument parsing for
LINE
,FRAME
,RECT
- Features
- DOS
- reliable memory initialization
- fixed writing LFN directory entries across sector boundary
- fixed missing partitions ($=P) if type is $0B
- fixed loading to the passed-in address when SA is 0 [gaekwad]
- fixed problem where macptr would always return C=0, masking errors
- GEOS
- text input support
- CodeX
- integrated CodeX Interactive Assembly Environment into ROM [mjallison42]
- KERNAL
- new
macptr
API to receive multiple bytes from an IEEE device load
usesmacptr
for LOAD speeds from SD card of about 140 KB/sec- hacked (non-functional) Commodore Serial to not hang
- LOAD on IEEE without fn defaults to ":*"; changed F5 key to "LOAD"
- fixed
screen_set_charset
custom charset [Rebecca G. Bettencourt] - fixed
stash
to preserve A entropy_get
: better entropy
- new
- MATH
- optimized addition, multiplication and
SQR
[Michael Jørgensen] - ported over
INT(.9+.1)
= 0 fix from C128
- optimized addition, multiplication and
- BASIC
- updated power-on logo to match the real X16 logo better
- like
LOAD
/SAVE
,OPEN
now also defaults to last IEEE device (or 8) - fixed STOP key when showing directory listing (
DOS"$"
)
- CHARSET
- changed PETSCII screen codes $65/$67 to PET 1/8th blocks
- DOS
- switched to FAT32 library by Frank van den Hoef
- rewrote most of DOS ("CMDR-DOS"), almost CMD FD/HD feature parity
- write support
- new "modify" mode ("M") that allows reading and writing
- set-position support in PRG files (like sd2iec)
- long filenames, full ISO-8859-15 translation
- wildcards
- subdirectories
- partitions
- timestamps
- overwriting ("@:")
- directory listing filter
- partition listing
- almost complete set of commands ("scratch", "rename", ...)
- formatting a new filesystem ("new")
- activity/error LED
- detection of SD card presence, fallback to Commodore Serial
- support for switching SD cards
- details in the CMDR-DOS README
- misc fixes [Mike Ketchen]
- API features
- console
- new: console_put_image (inline images)
- new: console_set_paging_message (to pause after a full screen)
- now respects window insets
- try "TEST1" and "TEST2" in BASIC!
- new entropy_get API to get randomness, used by MATH/BASIC RND function
- console
- KERNAL
- support for VERA 0.9 register layout (Frank van den Hoef)
- BASIC
TI$
andDA$
(DATE$
) are now connected to the new date/time API- TI is independent of
TI$
and can be assigned
- DOS
- enabled partition types 0x0b and 0x0c, should accept more image types
- Build
- separated KERNAL code into core code and drivers
- support for building KERNAL for C64
- ROM banks are built independently
- support to replace CBM channel and editor code with GPLed "open-roms" code by the MEGA65 project
- bug fixes
LOAD
respects target address- FAT32 code no longer overwrites RAM
- monitor is not as broken any more
-
API Features
- added console API for text-based interfaces with proportional font and styles support: console_init, console_put_char, console_get_char
- added memory API:
- memory_fill
- memory_copy
- memory_crc
- memory_decompress (LZSA2)
- added sprite API: sprite_set_image, sprite_set_position
- renamed GRAPH_LL to FB (framebuffer)
- GRAPH_init takes an FB graphics driver as an argument
-
KERNAL features
- detect SD card on TALK and LISTEN, properly fall back to serial
- joystick scanning is done automatically in VBLANK IRQ; no need to call it manually any more
- added VERA UART driver (device 2)
- bank 1 is now the default after startup; KERNAL won't touch it
- sprites and layer 0 are cleared on RESET
- changed F5 to LOAD":* (filename required for IEEE devices)
- GRAPH_move_rect supports overlapping [gaekwad]
-
BASIC
- default
LOAD
/SAVE
device is now 8 - added
RESET
statement [Ingo Hinterding] - added
CLS
statement [Ingo Hinterding]
- default
-
CHARSET
- fixed capital Ö [Ingo Hinterding]
- Changed Û, î, ã to be more consistent [Ingo Hinterding]
-
bug fixes
COLOR
statement with two argumentsPEEK
for ROM addresses- keyboard code no longer changes RAM bank
- fixed clock update
- fixed side effects of Ctrl+A and color control codes [codewar65]
-
misc
- added 3 more tests, start with "TEST1"/"TEST2"/"TEST3" in BASIC:
- TEST0: existing misc graphics test
- TEST1: console text rendering, character wrapping
- TEST2: console text rendering, word wrapping
- TEST3: console text input, echo
-
API Fetures
- new KERNAL API: low-level and high-level 320x200@256c bitmap graphics
- new KERNAL API: get mouse state
- new KERNAL API: get joystick state
- new KERNAL API: get/set date and time (old RDTIM call is now a 24 bit timer)
- new floating point API, jump table at $FC00 on ROM bank 4 (BASIC)
-
KERNAL Features
- invert fg/bg color control code (Ctrl+A) [Daniel Mecklenburg Jr]
-
BASIC
- added
COLOR <fg, bg>
statement to set text color - added
JOY(n)
function (arg 1 for joy1, arg 2 for joy2) - added
TEST
statement to start graphics API unit test CHAR
statement supports PETSCII control codes (instead of GEOS control codes), including color codes
- added
-
misc
- KERNAL variables for keyboard/mouse/clock drivers were moved from $0200-$02FF to RAM bank #0
- $8F (set PETSCII-UC even if ISO) printed first after reset [Mikael O. Bonnier]
-
bug fixes:
- got rid of $2c partial instruction skip [Joshua Scholar]
- fixed
TI
/TI$
- fixed CBDOS infinite loop
- zp address 0 is no longer overwritten by mouse code
- mouse scanning is disabled if mouse is off
- VERA state is correctly saved/restored by IRQ code
- new layout for zero page and KERNAL/BASIC variables:
- $00-$7F available to the user
- ($02-$52 are used if using BASIC graphics commands)
- $80-$A3 used by KERNAL and DOS
- $A4-$A8 reserved for KERNAL/DOS/BASIC
- $A9-$FF used by BASIC
- new BASIC statements:
SCREEN <mode>
(0: 40x30, 2: 80x60, 128: graphics)PSET <x>, <y>, <color>
LINE <x1>, <y1>, <x2>, <y2>, <color>
FRAME <x1>, <y1>, <x2>, <y2>, <color>
RECT <x1>, <y1>, <x2>, <y2>, <color>
CHAR <x>, <y>, <color>, <string>
MOUSE <n>
(0: off, 1: on)
- new BASIC functions:
MX
(mouse X coordinate)MY
(mouse Y coordinate)MB
(mouse button; 1: left, 2: right, 4: third)
- new KERNAL calls:
MOUSE
: configure mouseSCRMOD
: set screen mode
- new PS/2 mouse driver
- charsets are uploaded to VERA on demand
- GEOS font rendering uses less slant for faux italics characters
- misc GEOS KERNAL improvements and optimizations
- BASIC
- additional
LOAD
syntax to load to a specific addressLOAD [filename[,device[,bank,address]]]
LOAD
into banked RAM will auto-wrap into successive banksLOAD
allows trailing garbage; great to just typeLOAD
into a directory line [John-Paul Gignac]- new BASIC statement:
VLOAD
to load into video RAM:VLOAD [filename[,device[,bank,address]]]
[John-Paul Gignac] - complete jump table bridge
- additional
- KERNAL: memory size detection
- KERNAL: faster IRQ entry
- GEOS: converted graphics library to VERA 320x200@256c
- correct ROM banking:
- BASIC and KERNAL now live on separate 16 KB banks ($C000-$FFFF)
- BASIC
PEEK
will always access KERNAL ROM - BASIC
SYS
will have BASIC ROM enabled
- added GEOS
- added
OLD
statement to recover deleted BASIC program afterNEW
orRESET
- removed software RS-232, will be replaced by VERA UART later
- Full ISO mode support in Monitor
- switched to VERA 0.8 register layout; character ROM is uploaded on startup
- ISO mode: ISO-8859-15 character set, standard ASCII keyboard
- keyboard
- completed US and UK keymaps so all C64 characters are reachable
- support for AltGr
- support for F9-F12
- allow hex and binary numbers in
DATA
statements [Frank Buss] - switched SD card from VIA SPI to VERA SPI (works on real hardware!)
- fix:
VPEEK
overwritingPOKER
($14/$15) - fix:
STOP
sometimes not registering in BASIC programs
- support for 13 keyboard layouts; cycle through them using F9
GETJOY
call will fall back to keyboard (cursor/Ctrl/Alt/Space/Return), see Programmer's Reference Guide on how to use it- startup message now shows ROM revision
- $FF80 contains the prerelease revision (negated)
- the 60 Hz IRQ is now generated by VERA VSYNC
- fix:
VPEEK
tokenization - fix: CBDOS was not correctly preserving the RAM bank
- fix: KERNAL no longer uses zero page $FC-$FE