Apple II Code to Disk
Go to file
Egan Ford 9af2b2d8fd new bins from tests, hack to dwine to sleep 1 sec before test 2023-10-26 14:57:08 -06:00
asm included cc65 build, macos universal builds, refactored 2023-05-09 12:04:21 -06:00
bin new bins from tests, hack to dwine to sleep 1 sec before test 2023-10-26 14:57:08 -06:00
Dockerfile.wine32 docker wine32 support added 2023-05-09 14:02:04 -06:00
Makefile Allow Makefile compiler to be set with CC variable 2023-10-25 23:03:40 -05:00
README.md updated README.md 2023-05-10 17:37:01 -06:00
bargrloader.textpage completely removed all hacks for scratchpad ram, loader and bar asm only write to text RAM, no scratchpad ram. 2017-05-03 11:37:16 -06:00
barloader.text minor non-code changes 2017-04-22 20:45:43 -06:00
barloader.textpage completely removed all hacks for scratchpad ram, loader and bar asm only write to text RAM, no scratchpad ram. 2017-05-03 10:38:56 -06:00
c2d.c Fix issues found with -Wstrict-prototypes 2023-10-25 22:43:55 -05:00
c2d.h.0 completely removed all hacks for scratchpad ram, loader and bar asm only write to text RAM, no scratchpad ram. 2017-05-03 11:37:16 -06:00
dwine new bins from tests, hack to dwine to sleep 1 sec before test 2023-10-26 14:57:08 -06:00
gameserverclient updated gameserverclient example binary 2017-05-31 20:15:19 -06:00
gameserverclient.mon updated gameserverclient example binary 2017-05-31 20:15:19 -06:00
gameserverclient.text changed test splash page, no code changes 2017-04-22 12:08:02 -06:00
gameserverclient.textpage completely removed all hacks for scratchpad ram, loader and bar asm only write to text RAM, no scratchpad ram. 2017-05-03 10:38:56 -06:00
gameserverclient.tiff fixed virtual ii 11.1 testing 2023-05-09 13:37:58 -06:00
gameserverclientsplash.tiff fixed virtual ii 11.1 testing 2023-05-09 13:37:58 -06:00
makeheader included cc65 build, macos universal builds, refactored 2023-05-09 12:04:21 -06:00
mandelbrotgr.c completely removed all hacks for scratchpad ram, loader and bar asm only write to text RAM, no scratchpad ram. 2017-05-03 11:37:16 -06:00
page2text.c Fix issues found with -Wstrict-prototypes 2023-10-25 22:43:55 -05:00
test.scrp fixed virtual ii 11.1 testing 2023-05-09 13:37:58 -06:00
test.sh fixed windows testing, docker required now 2023-05-09 12:32:10 -06:00
text2page.c Fix issues found with -Wstrict-prototypes 2023-10-25 22:43:55 -05:00

README.md

Description

c2d is a small utility that will read Apple II binary and monitor text files and output a DOS ordered diskette image that will boot your code quickly.

Based on work by:

Weishaar, Tom. Running without filenames. Open-Apple Jan. 1985 Vol. 1, No. 0: p. 7 (https://web.archive.org/web/20150325102420/http://apple2online.com/web_documents/Open%20Apple%20Vol1No00.pdf)

c2d early history: http://macgui.com/usenet/?group=1&id=254902#msg

Features

  • $800-$B6FF available for binary code.
    • $B700-$BFFF free after load.
  • Platforms tested:
    • 32-bit/64-bit x86 MacOS|OS/X.
    • 32-bit x86 Windows/MinGW.

Download

git clone https://github.com/datajerk/c2d.git

or

Download https://github.com/datajerk/c2d/archive/master.zip and extract.

No Build Notes

Just get the files from bin. 32-bit Windows and MacOS (universal x86_64/arm64) included.

Build Notes

Unix/Linux:

make

or

MacOS|OS/X, Linux, Cygwin:

gcc -Wall -Wno-missing-braces -I. -O3 -o c2d c2d.c -lm
gcc -Wall -O3 -o bin/text2page text2page.c -lm
gcc -Wall -O3 -o bin/page2text page2text.c -lm

Windows/MinGW:

PATH=C:\MinGW\bin;%PATH%
gcc -Wall -Wno-missing-braces -static -I. -O3 -o c2d c2d.c -lm
gcc -Wall -O3 --static -o bin/text2page text2page.c -lm
gcc -Wall -O3 --static -o bin/page2text page2text.c -lm

c2d Usage/Examples

usage:  c2d [-vh?]
        c2d [-bgm] [-r row] [-t filename] [-s start address override] input[.mon],[load_address] output.dsk

        -h|? this help
        -m jump to monitor after booting
        -s XXXX jump to XXXX after booting
        -t filename, where filename is a 1K $400-$7FF text page splash screen
           The splash screen will display while the binary is loading
        -b animated loading bar
        -g splash page is mixed mode GR
        -r override row default of 19 with 'row'
        -v print version number and exit

Input without a .mon extension is assumed to be a binary with a 4 byte header.
If the header is missing then you must append ,load_address to the binary input
filename, e.g. filename,800.  The load address will be read as hex.

input with a .mon extension expected input format:

        0800: A2 FF 9A 20 8C 02 20 4F
        0808: 03 4C 00 FF 20 9E 02 A9

Examples:

        c2d hello hello.dsk
        c2d hello.mon hello.dsk 
        c2d hello,800 hello.dsk 
        c2d -m test,300 test.dsk
        c2d -s 7300 alpha4,400 alpha4.dsk
        c2d -t gameserverclient.textpage gameserverclient,800 gameserverclient.dsk

Splash Page Examples

Click on image to see video.

Splash pages are the exact bytes the Apple II expects in memory range $400-$7FF. Your splash screen should be exactly 1024 bytes (do not worry, the c2d loader will not overwrite the Peripheral Slot Scratchpad RAM).

c2d -t gameserverclient.textpage gameserverclient,800 gameserverclient.dsk

-t gameserverclient.textpage instructs c2d to put up a text splash page while the binary is loading.

splash


c2d -b -t barloader.textpage gameserverclient,800 gameserverclientbar.dsk

-b adds an animated bar on line 19.

splash


c2d -b -g -r 23 -t bargrloader.textpage gameserverclient,800 gameserverclientbargr.dsk

-r 23 moves the animated bar to line 23, and -g indicates the splash page is mixed mode text/gr.

splashbargr

text2page Example

Input is expected to be ASCII text (LF or CRLF line terminated). Only the first 40 characters/line and the first 24 lines are read. See gameserverclient.text and barloader.text examples.

text2page <gameserverclient.text >gameserverclient.textpage

page2text Example

Input is expected to be an Apple II binary from $400-$7FF. Exactly 1024 bytes. See gameserverclient.textpage example.

Text output lines are newline (LF) terminated. Windows users may need to convert LF to CRLF (editor dependent).

page2text <gameserverclient.textpage >gameserverclient.text

Testing

Automated testing is only supported on MacOS|OS/X and requires the following:

NOTE: Windows binary testing only supported on MacOS x86_64 machines.

To test, type:

make test     # MacOS|OS/X only
make disttest # MacOS|OS/X and Windows
make fulltest # MacOS|OS/X, Windows, and Virtual ][

Bugs

Yes. No input checking. Big Endian untested.

The Ugly Stuff

c2d, Code to Disk, Version 0.57

(c) 2012,2017 All Rights Reserved, Egan Ford (egan@sense.net)

THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.

License: Do what you like, remember to credit all sources when using.