2018-09-28 17:05:11 +00:00
|
|
|
# Runtime Data #
|
|
|
|
|
|
|
|
|
|
Symbol files and analyzer scripts are split into directories by
|
|
|
|
|
platform manufacturer.
|
|
|
|
|
|
|
|
|
|
The Visual Studio project (RuntimeData.csproj) exists so you can edit
|
|
|
|
|
scripts with IntelliSense and error highlighting. Everything here is
|
|
|
|
|
distributed as source, not in compiled form; all compilation occurs at
|
|
|
|
|
run time.
|
|
|
|
|
|
|
|
|
|
## SystemDefs.json ##
|
|
|
|
|
|
|
|
|
|
This file defines the systems available in the "new project" screen.
|
|
|
|
|
The following fields are mandatory:
|
|
|
|
|
|
|
|
|
|
* Name - Short name that identifies the system.
|
|
|
|
|
* GroupName - Short string used to group common items together in the UI.
|
|
|
|
|
* CPU - Type of CPU used. The string must be part of the known set
|
|
|
|
|
(see CpuDef.cs)
|
|
|
|
|
* Speed - Clock rate, in MHz, of the CPU on the system. When multiple
|
|
|
|
|
speeds are possible, use the most common, favoring NTSC over PAL.
|
|
|
|
|
* SymbolFiles - List of platform symbol file identifiers (see below).
|
|
|
|
|
* ExtensionScripts - List of extension script file identifiers (see below).
|
|
|
|
|
* Parameters - List of optional parameters (see below).
|
|
|
|
|
|
|
|
|
|
The currently-supported parameters are:
|
|
|
|
|
|
2018-10-09 00:11:03 +00:00
|
|
|
* load-address=<addr> - Specify the initial load address. The default
|
2018-09-28 17:05:11 +00:00
|
|
|
is 0x1000.
|
2018-10-09 00:11:03 +00:00
|
|
|
* entry-flags=<flag-set> - Specify the processor status flag values to
|
2018-09-28 17:05:11 +00:00
|
|
|
use at entry points. This is intended for use on the 65802/65816, and
|
|
|
|
|
may be one of "emulation", "native-short", and "native-long". The
|
|
|
|
|
default is "emulation".
|
|
|
|
|
* undocumented-opcodes={true|false} - Enable or disable undocumented
|
|
|
|
|
opcodes. They are disabled by default.
|
2018-10-08 19:49:26 +00:00
|
|
|
* first-word-is-load-addr={true|false} - If true, the first two bytes of
|
|
|
|
|
the file contain the load address.
|
2018-09-28 17:05:11 +00:00
|
|
|
|
|
|
|
|
All of these things can be changed after the project has begun, but it's
|
|
|
|
|
nice to have them configured in advance.
|
|
|
|
|
|
|
|
|
|
SymbolFiles and ExtensionScripts use file identifiers, which look like
|
|
|
|
|
"RT:Apple/ProDOS8.sym65". The "RT:" means that the file lives in the
|
|
|
|
|
RuntimeData directory, and the rest is a partial pathname. Files that
|
|
|
|
|
live in the same directory as the project file are prefixed with "PROJ:".
|
|
|
|
|
All symbol files and extension scripts must live in the RuntimeData
|
|
|
|
|
directory or project file directory, or they will not be loaded.
|
|
|
|
|
|
|
|
|
|
All "RT:" identifier paths are relative to the RuntimeData directory. The
|
|
|
|
|
Group Name is not automatically added.
|
|
|
|
|
|
|
|
|
|
|
2018-10-08 22:30:43 +00:00
|
|
|
## Platform Symbol Files and Extension Scripts ##
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-08 22:30:43 +00:00
|
|
|
These are described in the "Advanced Topics" section of the manual
|
|
|
|
|
([here](Help/advanced.html)).
|
2018-09-28 17:05:11 +00:00
|
|
|
|
|
|
|
|
|
2018-10-08 22:30:43 +00:00
|
|
|
## Misc Files ##
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-08 22:30:43 +00:00
|
|
|
LegalStuff.txt, Logo.png, and AboutImage.png are displayed by SourceGen,
|
|
|
|
|
on the start screen and the About box.
|
