-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathOptions.txt
184 lines (124 loc) · 6.71 KB
/
Options.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
Options.txt
BASICloader (in development, don't use it yet) options summary
(c) 2017 Richard Cavell
Here is a brief rundown of all of the command line options. You can bring
up this list by running BASICloader with the -h option:
(c) 2017 Richard Cavell
https://github.com/richardcavell/BASICloader
Usage: BASICloader [options] [filename]
-o --output Output filename
-m --machine Target machine (coco/dragon/c64)
-f --format Input file format (binary/rsdos/dragon/prg)
-c --case Output case (upper/lower)
-t --typable Unpack the BASIC program and use spaces
-r --remarks Add remarks and date
--extbas Assume Extended Color BASIC (coco only)
--verify Verify the success of each POKE
--checksum Calculate checksums
-s --start Start memory location
-e --exec Exec memory location
-p --print Print the BASIC program to standard output
-n --nowarn Turn warnings off
-l --license Your license to use this program
-i --info What this program does
-h --help This help information
-v --version Version number
You can specify the options and filename in any order. If an option takes
another parameter, use a space.
You can see the defaults for -o, -m, -f and -c by using the -d option. All
on/off switches are off by default.
-o --output Output file
The generated BASIC program will be placed under this filename.
A filename of - is equivalent to --print
-m --machine Target machine (coco/dragon/c64)
Currently, there are three target architectures:
coco : TRS-80 Color Computer 1, 2 or 3
dragon : Dragon 32 or 64
c64 : Commodore 64
-f --format Input file format (binary/rsdos/dragon/prg)
Currently, there are four supported input file formats:
binary : Raw stream of unsigned 8-bit bytes
rsdos : Radio Shack DOS, for the Color Computer
dragon : Dragon DOS
prg : The Commodore 64's usual file format for programs
-c --case Output case (upper/lower)
If you specify lower, the output program will be entirely in lowercase.
This is what you want if you intend to run the program using VICE, or
if you want to run it through petcat.
-t --typable Unpacked, one instruction per line
By default, the program produced by BASICloader is tightly coded, with
no spaces, long lines, and line numbers that start at 0 and increase
in steps of 1.
Turning this option on makes the output much more readable and typable.
-r --remarks Add remarks to the program
The BASIC program will have REM statements that include a mention of
BASICloader and the date that the program was generated.
--extbas Assume Extended Color BASIC
Only to be used with --machine coco. Assume that the target machine
has Extended Color BASIC. The emitted program will include a CLEAR
command that is unknown to Color Computers without Extended Color BASIC.
--verify Verify the success of each POKE
The BASIC program will PEEK() each memory location after POKEing it,
to verify that the write was successful.
This will detect when a machine does not have enough installed RAM
(which is only relevant to Coco and Dragon targets). There might also
be other reasons to verify that the writes were successful.
However, it should be used with caution. If the machine language blob
overlaps with any address that is subject to memory mapping, then the
verification might fail even when the write was successful and the
machine language program can be reliably executed.
--checksum Include checksums in the DATA
Each line of the output program that contains a DATA statement will
include a checksum, which is helpful to ensure that the program has
been typed in correctly. It significantly increases the size of the
generated program - both the part that constructs the machine
language blob, and the DATA lines themselves.
Using this option will turn on --typable automatically.
-s --start Start location
This is where the binary blob will be poked into memory when the
BASIC program is run on the target machine. Some machine language
programs must be constructed at a particular start address, while
others are relocatable. Each architecture has a default start
location. The Coco default is suitable for 16K, 32K and 64K machines.
The Dragon default is suitable for machines with 32K as well as 64K.
BASICloader will accept addresses in the usual forms (a leading 0x
or 0X for hexadecimal, a leading 0 for octal, no leading 0 for decimal).
As an extension, it will also accept hexadecimal addresses with a
leading $ sign. (So $1234 is an alternative to 0x1234).
-e --exec Exec location
This is where the execution of the binary blob begins. If you do not
specify a location, it will begin from the start location.
-p --print Print the BASIC program to standard output
The program will be printed to the standard output (which is probably
your terminal window). This automatically suppresses all other output
to the screen such as warnings and diagnostic info. However, fatal
errors will still print an error message.
-n --nowarn Don't warn about RAM requirements
By default, BASICloader warns you if your program requires a minimum
amount of RAM that is greater than what some versions of your target
machine have.
You can switch this warning off using this option.
-l --license Your license to use this program
Prints the license under which you may use this program.
-i --info Info about what this program does
Gives a short explanation of what this program is for.
-h --help This help information
Lists all available command line options.
-v --version Version of this software
Prints the version number.
== Advanced options ==
These advanced options do not appear in the output of --help:
--line Starting line number
--step Gap between line numbers
-d --defaults Print option defaults
--diag Print diagnostic information
--line Starting line number
The BASIC program will start with this line number.
--step The amount added to line numbers
The BASIC line numbers will increase by this amount.
-d --defaults Print option defaults
Lists the defaults for those command line options that have defaults.
--diag Print diagnostic info
Prints some helpful information to the standard output, after the
program has been generated.
Richard Cavell