apple1-videocard-lib/demos/sdcard/README.md
2022-06-03 09:29:54 +02:00

4.0 KiB

SD CARD

  • all numbers must be provided in hexadecimal format unless specified
  • arguments in [] brackets means they are optional
  • nested paths are allowed with the / character, e.g. /, /foder1/foo
  • no path given implies current working directory

TAGGED FILE NAMES

File names containing a tag # character have a special meaning: the part after the # indicates the file type (two characters) and the hex loading address (4 characters).

#06 for plain binary files #F1 for BASIC programs #F8 for Applesoft BASIC lite programs

E.g.: BASIC#06E000 is binary file named BASIC that loads at address $E000. STARTREK#F10300 is a BASIC program named STARTREK that loads at address $0300. LEMO#F80801 is a AppleSoft BASIC program named LEMO that loads at address $0801.

Tagged file names are used by the LOAD, RUN, SAVE, ASAVE and DIR commands to simplify working with files. For example to execute the above files, it's enough to type:

LOAD BASIC
RUN STARTREK

COMMANDS

READ filename startaddress

Reads a binary file from the SD card and loads it in memory at the specified address.

WRITE filename startaddress endaddress

Writes the memory range from startaddress to endaddress (inclusive) in a file on the SD card.

TYPE filename

Reads the specified ASCII file from the SD card and prints it on the screen. Press any key to stop the printing and return to the command prompt.

DUMP filename [start] [end]

Reads the specified binary file from the SD card and prints it on the screen in hexadecimal format. start and end are optional and are used to print a smaller portion of the file. Press any key to stop the printing and return to the command prompt.

LOAD filename

Loads a file from the SD card. filename refers to a "tagged file name" described above. For convenience, filename can be partially given, the first matching file will be loaded.

SAVE filename [start] [end]

Saves a file to the SD card. If start and end are specified, a binary file with tag #06 will be created with the memory content from the address range start-end (included). If start and end are not specified, the BASIC program currently loaded in memory will be created with the corresponding #F1 tag.

ASAVE filename

Saves a AppleSoft BASIC lite file to the SD card. The program currently loaded in memory will be created with the corresponding #F8 tag.

RUN filename

Same as LOAD but runs the file after loading it. Binary files are exectuted at the starting address specified in the file name tag; BASIC files are RUN from the BASIC interpreter.

DEL filename RM filename

Deletes a file from the SD card.

DIR [path] LS [path]

Lists the files from the specified directory, or from the current directory if no path is given. LS has a shorter but quicker output format. Press any key to stop the file listing and return to the command prompt.

CD path

Changes the current working directory to the specified path. The current directory is also shown in the command prompt.

MD path MKDIR path

Creates the specified directory.

RD path RMDIR path

Removes the specified directory. The directory to remove must be empty (no files or directories within).

PWD

Prints on the screen the current working directory.

BAS

Prints LOMEM and HIMEM pointers from the BASIC program currently loaded in memory.

address R

Runs the program loaded at the specified memory address. Useful addresses: 6000R AppleSoft BASIC cold start (needed at least once) 6003R AppleSoft BASIC warm start (do not destroy the BASIC program in RAM) E000R Integer BASIC cold start E2B3R Integer BASIC warm start EFECR Integer BASIC "RUN" command (can be used as a warm entry point) 8000R SD card OS command prompt

TIME value

Set the internal timeout value used in the I/O operations with the SD cards.

TEST

Internal test.

EXIT

Exits to the WOZ monitor