Update README.md

This commit is contained in:
nino-porcino 2021-12-16 11:05:26 +01:00
parent e9129069ad
commit 2b0de4c0b1
1 changed files with 13 additions and 14 deletions

View File

@ -3,22 +3,21 @@
Library and demos for the Apple-1 TMS9918 video card by P-LAB.
# Building for the "Juke Box" EPROM expansion
# Building for the CodeTank/Juke-Box Expansion Cards
The demo contained in the repo are meant to be launched from the Apple-1 "Juke Box"
EPROM expansion at address $4000. The executables are built according to the
The demo contained in the repo are meant to be launched from the Apple-1
"CodeTank" EEPROM daughterboard of the "Apple-1 Graphic Card" or "Juke-Box
Card" FLASH at address $4000. The executables are built according to the
following memory map:
$0000-$00FF zero page: holds most of C program variables
$0280-$0FFF low RAM space: C program "Data" segment
$4000-$7581 EPROM (Juke Box): C program "Code" segment
$7582-$7FFF EPROM (Juke Box): C program "Data" segment (startup values)
The build script "mkeprom.js" creates a 16K binary file to be placed on the
EPROM where the "Data" segment startup values are put at the end of the file itself.
The user program need to manually copy such data from EPROM to low RAM once after
the `main()` is launched. That can be easily done by simply calling the library
function `apple1_eprom_init()`.
$0000-$00FF zero page: holds most of C program variables
$0280-$0FFF low RAM space: C program "Data" segment
$4000-$7581 EEPROM/FLASH (CodeTank/Juke-Box): C program "Code" segment
$7582-$7FFF EEPROM/FLASH (CodeTank/Juke-Box): C program "Data" segment (startup values)
The build script `mkeprom.js` creates a 16K binary file to be placed on the
EEPROM/FLASH where the "Data" segment startup values are put at the end of the
file itself. The user program need to manually copy such data from EEPROM/FLASH
to low RAM once after the `main()` is launched. This can be easily done by simply
calling the library function `apple1_eprom_init()`.