fcdev 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -0
- package/README.md +9 -8
- package/docs/{02- → 01-}/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +10 -8
- package/docs/{05- → 02-}/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +12 -22
- package/docs/{06- → 03-}/345/217/215/346/261/207/347/274/226.md +12 -46
- package/docs/{07- → 04-}/345/210/233/345/273/272/345/214/205/344/270/216/346/250/241/346/235/277.md +1 -15
- package/docs/nes/{01-NES/347/233/256/346/240/207.md → 01-/345/274/200/345/217/221/346/214/207/345/215/227.md} +4 -9
- package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +21 -26
- package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md +4 -4
- package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +5 -5
- package/package.json +3 -3
- package/src/build/bank-link-config.mjs +1 -1
- package/src/build/build-plan.mjs +1 -1
- package/src/build/program-builder.mjs +10 -5
- package/src/build/source-charset.mjs +111 -0
- package/src/cli/commands/docs-command.mjs +2 -2
- package/src/cli/index.mjs +1 -1
- package/src/config/config-loader.mjs +1 -1
- package/src/docs/doc-index.mjs +1 -1
- package/src/docs/doc-topics.mjs +9 -15
- package/src/docs/index.mjs +1 -1
- package/src/emulator/sb2000-session.mjs +15 -12
- package/src/targets/target-registry.mjs +9 -1
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/sb2000/api-reference.md +2 -1
- package/targets/sb2000/examples-source.md +1330 -0
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/symbols-reference.md +670 -0
- package/targets/sb2000/target.json +1 -0
- package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -164
- package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +0 -123
- package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +0 -50
- package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +0 -75
- package/docs/09-/345/217/221/345/270/203.md +0 -75
- package/docs/10-VS Code/346/211/251/345/261/225.md" +0 -131
- package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +0 -50
- package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +0 -10
|
@@ -0,0 +1,1330 @@
|
|
|
1
|
+
# SB2000 示例程序源码
|
|
2
|
+
|
|
3
|
+
本文由示例项目的源码生成。
|
|
4
|
+
共 11 个示例,每个是一个 fcdev 项目:目录里有 `fcdev.json`(`target` 是 `sb2000`,`name` 是 DOS 里的程序名)和 `src/` 下的一个源文件,下面给出完整源码。每个示例做什么、怎么用见 [SB2000 开发指南](../../docs/sb2000/01-开发指南.md) 第 10 节,源码开头的注释也有说明。
|
|
5
|
+
|
|
6
|
+
把源码放进新建的项目后,`npx fcdev build` 构建,`npx fcdev disk` 另外生成放有程序的软盘镜像,`npx fcdev run` 在 Ember 里运行,见 [命令行与构建](../../docs/01-命令行与构建.md) 与 [模拟器与调试](../../docs/02-模拟器与调试.md)。
|
|
7
|
+
|
|
8
|
+
## 目录
|
|
9
|
+
|
|
10
|
+
- [hello](#hello)
|
|
11
|
+
- [say](#say)
|
|
12
|
+
- [show](#show)
|
|
13
|
+
- [copy](#copy)
|
|
14
|
+
- [peek](#peek)
|
|
15
|
+
- [poke](#poke)
|
|
16
|
+
- [pad](#pad)
|
|
17
|
+
- [mouse](#mouse)
|
|
18
|
+
- [play](#play)
|
|
19
|
+
- [newcall](#newcall)
|
|
20
|
+
- [syscall](#syscall)
|
|
21
|
+
|
|
22
|
+
## hello
|
|
23
|
+
|
|
24
|
+
程序名 `HELLO`。
|
|
25
|
+
|
|
26
|
+
`src/hello.c`:
|
|
27
|
+
|
|
28
|
+
```c
|
|
29
|
+
/*
|
|
30
|
+
* ------------------------------------------------------------------------
|
|
31
|
+
* 名称:hello.c
|
|
32
|
+
* 说明:最小的 SB-DOS 程序:显示英文与中文各一行,等待按键后返回 DOS。
|
|
33
|
+
* 作者:sungbin
|
|
34
|
+
* 邮箱:sungbin@3578.cn
|
|
35
|
+
* 日期:2026-11-11
|
|
36
|
+
* 备注:源文件用 UTF-8 保存,字符串里的汉字构建时自动转成学习机用的 GB2312;
|
|
37
|
+
* 返回 DOS 后 DOS 会清屏,所以显示后先等待按键。
|
|
38
|
+
* ------------------------------------------------------------------------
|
|
39
|
+
*/
|
|
40
|
+
#include <sb2000.h>
|
|
41
|
+
|
|
42
|
+
int main(void)
|
|
43
|
+
{
|
|
44
|
+
sb_puts("Hello, SB2000!");
|
|
45
|
+
|
|
46
|
+
sb_puts("你好,小霸王!");
|
|
47
|
+
|
|
48
|
+
sb_getkey();
|
|
49
|
+
return 0;
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## say
|
|
54
|
+
|
|
55
|
+
程序名 `SAY`。
|
|
56
|
+
|
|
57
|
+
`src/say.c`:
|
|
58
|
+
|
|
59
|
+
```c
|
|
60
|
+
/*
|
|
61
|
+
* ------------------------------------------------------------------------
|
|
62
|
+
* 名称:say.c
|
|
63
|
+
* 说明:显示命令行参数的 SB-DOS 程序:在 DOS 下输入“say hello world”,屏幕上显示 HELLO WORLD。
|
|
64
|
+
* 作者:sungbin
|
|
65
|
+
* 邮箱:sungbin@3578.cn
|
|
66
|
+
* 日期:2026-11-11
|
|
67
|
+
* 备注:DOS 把程序名之后的部分转成大写,以零结尾放在扩展 RAM 的 SB_CMD_TAIL 起,第一个字节是分隔用的空格;
|
|
68
|
+
* 没有参数时第一个字节为 0,之后的内容是上一条命令的残留,不能显示。
|
|
69
|
+
* 字符串要在程序窗口里才能交给 sb_puts,所以先复制进程序自己的缓冲。
|
|
70
|
+
* ------------------------------------------------------------------------
|
|
71
|
+
*/
|
|
72
|
+
#include <sb2000.h>
|
|
73
|
+
|
|
74
|
+
/** 参数缓冲,最多显示 39 个字符 */
|
|
75
|
+
static char text[40];
|
|
76
|
+
|
|
77
|
+
int main(void)
|
|
78
|
+
{
|
|
79
|
+
const char *tail = (const char *)SB_CMD_TAIL;
|
|
80
|
+
unsigned char count = 0;
|
|
81
|
+
|
|
82
|
+
if (tail[0] != 0) {
|
|
83
|
+
while (count < sizeof(text) - 1 && tail[count + 1] != 0) {
|
|
84
|
+
text[count] = tail[count + 1];
|
|
85
|
+
++count;
|
|
86
|
+
}
|
|
87
|
+
text[count] = 0;
|
|
88
|
+
sb_puts(text);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
sb_getkey();
|
|
92
|
+
return 0;
|
|
93
|
+
}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## show
|
|
97
|
+
|
|
98
|
+
程序名 `SHOW`。
|
|
99
|
+
|
|
100
|
+
`src/show.c`:
|
|
101
|
+
|
|
102
|
+
```c
|
|
103
|
+
/*
|
|
104
|
+
* ------------------------------------------------------------------------
|
|
105
|
+
* 名称:show.c
|
|
106
|
+
* 说明:显示文件开头内容的 SB-DOS 程序:在 DOS 下输入“show hello.txt”,显示文件的前 90 个字节(每行 30 个字符,共 3 行)。
|
|
107
|
+
* 作者:sungbin
|
|
108
|
+
* 邮箱:sungbin@3578.cn
|
|
109
|
+
* 日期:2026-11-11
|
|
110
|
+
* 备注:演示文件接口的标准顺序:取命令行参数 → 打开 → 取大小 → 读入 → 关闭;每个调用都检查出错码,出错时先关闭文件再显示“ERROR 码”。
|
|
111
|
+
* 控制字符显示成“.”。
|
|
112
|
+
* ------------------------------------------------------------------------
|
|
113
|
+
*/
|
|
114
|
+
#include <sb2000.h>
|
|
115
|
+
|
|
116
|
+
/** 一次最多显示的字节数 */
|
|
117
|
+
#define SHOW_BYTES 90
|
|
118
|
+
/** 每行显示的字符数 */
|
|
119
|
+
#define LINE_CHARS 30
|
|
120
|
+
|
|
121
|
+
static char path[29];
|
|
122
|
+
static unsigned char data[SHOW_BYTES];
|
|
123
|
+
static char line[LINE_CHARS + 1];
|
|
124
|
+
|
|
125
|
+
/** 从命令行取下一个以空格分隔的词放进 out,没有词时返回 0 */
|
|
126
|
+
static unsigned char next_word(const char **cursor, char *out, unsigned char size)
|
|
127
|
+
{
|
|
128
|
+
const char *p = *cursor;
|
|
129
|
+
unsigned char count = 0;
|
|
130
|
+
|
|
131
|
+
while (*p == ' ') {
|
|
132
|
+
++p;
|
|
133
|
+
}
|
|
134
|
+
*cursor = p;
|
|
135
|
+
if (*p == 0) {
|
|
136
|
+
return 0;
|
|
137
|
+
}
|
|
138
|
+
while (*p != 0 && *p != ' ') {
|
|
139
|
+
if (count < size - 1) {
|
|
140
|
+
out[count++] = *p;
|
|
141
|
+
}
|
|
142
|
+
++p;
|
|
143
|
+
}
|
|
144
|
+
out[count] = 0;
|
|
145
|
+
*cursor = p;
|
|
146
|
+
return 1;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
/** 显示“ERROR 码”并等待按键 */
|
|
150
|
+
static void report_error(unsigned char code)
|
|
151
|
+
{
|
|
152
|
+
sb_cursor_set_column(1);
|
|
153
|
+
sb_print("ERROR ");
|
|
154
|
+
sb_print_hex(code);
|
|
155
|
+
sb_newline();
|
|
156
|
+
sb_getkey();
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
int main(void)
|
|
160
|
+
{
|
|
161
|
+
const char *tail = (const char *)SB_CMD_TAIL;
|
|
162
|
+
unsigned char handle;
|
|
163
|
+
unsigned char error;
|
|
164
|
+
unsigned long size;
|
|
165
|
+
unsigned int count = 0;
|
|
166
|
+
unsigned int start;
|
|
167
|
+
unsigned int n;
|
|
168
|
+
|
|
169
|
+
if (!next_word(&tail, path, sizeof(path))) {
|
|
170
|
+
sb_puts("USAGE: SHOW FILENAME");
|
|
171
|
+
sb_getkey();
|
|
172
|
+
return 0;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
error = sb_file_open(path, SB_MODE_OPEN, &handle);
|
|
176
|
+
if (error != 0) {
|
|
177
|
+
report_error(error);
|
|
178
|
+
return 0;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
error = sb_file_size(handle, &size);
|
|
182
|
+
if (error == 0 && size > 0) {
|
|
183
|
+
count = size > SHOW_BYTES ? SHOW_BYTES : (unsigned int)size;
|
|
184
|
+
error = sb_file_read(handle, 0, data, count);
|
|
185
|
+
}
|
|
186
|
+
sb_file_close(handle);
|
|
187
|
+
if (error != 0) {
|
|
188
|
+
report_error(error);
|
|
189
|
+
return 0;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
if (count == 0) {
|
|
193
|
+
sb_puts("(EMPTY FILE)");
|
|
194
|
+
}
|
|
195
|
+
for (start = 0; start < count; start += LINE_CHARS) {
|
|
196
|
+
n = count - start < LINE_CHARS ? count - start : LINE_CHARS;
|
|
197
|
+
for (error = 0; error < n; ++error) {
|
|
198
|
+
line[error] = data[start + error] < 0x20 ? '.' : data[start + error];
|
|
199
|
+
}
|
|
200
|
+
line[n] = 0;
|
|
201
|
+
sb_puts(line);
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
sb_getkey();
|
|
205
|
+
return 0;
|
|
206
|
+
}
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
## copy
|
|
210
|
+
|
|
211
|
+
程序名 `CP`。
|
|
212
|
+
|
|
213
|
+
`src/copy.c`:
|
|
214
|
+
|
|
215
|
+
```c
|
|
216
|
+
/*
|
|
217
|
+
* ------------------------------------------------------------------------
|
|
218
|
+
* 名称:copy.c
|
|
219
|
+
* 说明:复制文件的 SB-DOS 程序:在 DOS 下输入“cp 源文件 目标文件”,把源文件整个复制成目标文件。
|
|
220
|
+
* 作者:sungbin
|
|
221
|
+
* 邮箱:sungbin@3578.cn
|
|
222
|
+
* 日期:2026-11-11
|
|
223
|
+
* 备注:程序名取 CP,避开 DOS 内部的 COPY 命令。
|
|
224
|
+
* 演示整个文件的加载与保存:sb_file_load 把源文件读入新分配的扩展 RAM 页,sb_file_save 把这些页写成目标文件(已存在则覆盖),
|
|
225
|
+
* 最后释放页。出错时也要释放页,再显示“ERROR 码”。
|
|
226
|
+
* ------------------------------------------------------------------------
|
|
227
|
+
*/
|
|
228
|
+
#include <sb2000.h>
|
|
229
|
+
|
|
230
|
+
static char source[29];
|
|
231
|
+
static char target[29];
|
|
232
|
+
|
|
233
|
+
/** 从命令行取下一个以空格分隔的词放进 out,没有词时返回 0 */
|
|
234
|
+
static unsigned char next_word(const char **cursor, char *out, unsigned char size)
|
|
235
|
+
{
|
|
236
|
+
const char *p = *cursor;
|
|
237
|
+
unsigned char count = 0;
|
|
238
|
+
|
|
239
|
+
while (*p == ' ') {
|
|
240
|
+
++p;
|
|
241
|
+
}
|
|
242
|
+
*cursor = p;
|
|
243
|
+
if (*p == 0) {
|
|
244
|
+
return 0;
|
|
245
|
+
}
|
|
246
|
+
while (*p != 0 && *p != ' ') {
|
|
247
|
+
if (count < size - 1) {
|
|
248
|
+
out[count++] = *p;
|
|
249
|
+
}
|
|
250
|
+
++p;
|
|
251
|
+
}
|
|
252
|
+
out[count] = 0;
|
|
253
|
+
*cursor = p;
|
|
254
|
+
return 1;
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
int main(void)
|
|
258
|
+
{
|
|
259
|
+
const char *tail = (const char *)SB_CMD_TAIL;
|
|
260
|
+
unsigned char page = 0;
|
|
261
|
+
unsigned char pages;
|
|
262
|
+
unsigned char error;
|
|
263
|
+
unsigned long size = 0;
|
|
264
|
+
|
|
265
|
+
if (!next_word(&tail, source, sizeof(source)) || !next_word(&tail, target, sizeof(target))) {
|
|
266
|
+
sb_puts("USAGE: CP SRC DST");
|
|
267
|
+
sb_getkey();
|
|
268
|
+
return 0;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
error = sb_file_load(source, &page, &size);
|
|
272
|
+
if (error == 0) {
|
|
273
|
+
error = sb_file_save(target, page, size);
|
|
274
|
+
}
|
|
275
|
+
/* 空文件没有分配页,页号为 0 */
|
|
276
|
+
pages = (unsigned char)((size + 4095UL) / 4096UL);
|
|
277
|
+
if (page != 0 && pages != 0) {
|
|
278
|
+
sb_page_free(page, pages);
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
if (error == 0) {
|
|
282
|
+
sb_puts("COPY OK");
|
|
283
|
+
} else {
|
|
284
|
+
sb_cursor_set_column(1);
|
|
285
|
+
sb_print("ERROR ");
|
|
286
|
+
sb_print_hex(error);
|
|
287
|
+
sb_newline();
|
|
288
|
+
}
|
|
289
|
+
sb_getkey();
|
|
290
|
+
return 0;
|
|
291
|
+
}
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
## peek
|
|
295
|
+
|
|
296
|
+
程序名 `PEEK`。
|
|
297
|
+
|
|
298
|
+
`src/peek.c`:
|
|
299
|
+
|
|
300
|
+
```c
|
|
301
|
+
/*
|
|
302
|
+
* ------------------------------------------------------------------------
|
|
303
|
+
* 名称:peek.c
|
|
304
|
+
* 说明:按偏移读文件的 SB-DOS 程序:在 DOS 下输入“peek 文件名 十六进制偏移”,显示文件里从该偏移起的 30 个字节。
|
|
305
|
+
* 作者:sungbin
|
|
306
|
+
* 邮箱:sungbin@3578.cn
|
|
307
|
+
* 日期:2026-11-11
|
|
308
|
+
* 备注:演示按偏移读取 sb_file_read:偏移不小于文件大小、或偏移加长度超过文件大小时出错码为 SB_ERR_BAD_POSITION(0x14)。
|
|
309
|
+
* 省略偏移时从 0 开始;控制字符显示成“.”;出错时先关闭文件再显示“ERROR 码”。
|
|
310
|
+
* ------------------------------------------------------------------------
|
|
311
|
+
*/
|
|
312
|
+
#include <sb2000.h>
|
|
313
|
+
|
|
314
|
+
/** 显示的字节数 */
|
|
315
|
+
#define SHOW_BYTES 30
|
|
316
|
+
|
|
317
|
+
static char path[29];
|
|
318
|
+
static char offset_text[9];
|
|
319
|
+
static unsigned char data[SHOW_BYTES];
|
|
320
|
+
static char line[SHOW_BYTES + 1];
|
|
321
|
+
|
|
322
|
+
/** 从命令行取下一个以空格分隔的词放进 out,没有词时返回 0 */
|
|
323
|
+
static unsigned char next_word(const char **cursor, char *out, unsigned char size)
|
|
324
|
+
{
|
|
325
|
+
const char *p = *cursor;
|
|
326
|
+
unsigned char count = 0;
|
|
327
|
+
|
|
328
|
+
while (*p == ' ') {
|
|
329
|
+
++p;
|
|
330
|
+
}
|
|
331
|
+
*cursor = p;
|
|
332
|
+
if (*p == 0) {
|
|
333
|
+
return 0;
|
|
334
|
+
}
|
|
335
|
+
while (*p != 0 && *p != ' ') {
|
|
336
|
+
if (count < size - 1) {
|
|
337
|
+
out[count++] = *p;
|
|
338
|
+
}
|
|
339
|
+
++p;
|
|
340
|
+
}
|
|
341
|
+
out[count] = 0;
|
|
342
|
+
*cursor = p;
|
|
343
|
+
return 1;
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
/** 解析大写十六进制数,遇到非十六进制字符停止 */
|
|
347
|
+
static unsigned long parse_hex(const char *text)
|
|
348
|
+
{
|
|
349
|
+
unsigned long value = 0;
|
|
350
|
+
unsigned char digit;
|
|
351
|
+
|
|
352
|
+
for (; *text != 0; ++text) {
|
|
353
|
+
if (*text >= '0' && *text <= '9') {
|
|
354
|
+
digit = *text - '0';
|
|
355
|
+
} else if (*text >= 'A' && *text <= 'F') {
|
|
356
|
+
digit = *text - 'A' + 10;
|
|
357
|
+
} else {
|
|
358
|
+
break;
|
|
359
|
+
}
|
|
360
|
+
value = (value << 4) | digit;
|
|
361
|
+
}
|
|
362
|
+
return value;
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
int main(void)
|
|
366
|
+
{
|
|
367
|
+
const char *tail = (const char *)SB_CMD_TAIL;
|
|
368
|
+
unsigned char handle;
|
|
369
|
+
unsigned char error;
|
|
370
|
+
unsigned char i;
|
|
371
|
+
unsigned long offset = 0;
|
|
372
|
+
|
|
373
|
+
if (!next_word(&tail, path, sizeof(path))) {
|
|
374
|
+
sb_puts("USAGE: PEEK FILE HEXOFFSET");
|
|
375
|
+
sb_getkey();
|
|
376
|
+
return 0;
|
|
377
|
+
}
|
|
378
|
+
if (next_word(&tail, offset_text, sizeof(offset_text))) {
|
|
379
|
+
offset = parse_hex(offset_text);
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
error = sb_file_open(path, SB_MODE_OPEN, &handle);
|
|
383
|
+
if (error != 0) {
|
|
384
|
+
sb_cursor_set_column(1);
|
|
385
|
+
sb_print("ERROR ");
|
|
386
|
+
sb_print_hex(error);
|
|
387
|
+
sb_newline();
|
|
388
|
+
sb_getkey();
|
|
389
|
+
return 0;
|
|
390
|
+
}
|
|
391
|
+
error = sb_file_read(handle, offset, data, SHOW_BYTES);
|
|
392
|
+
sb_file_close(handle);
|
|
393
|
+
|
|
394
|
+
if (error != 0) {
|
|
395
|
+
sb_cursor_set_column(1);
|
|
396
|
+
sb_print("ERROR ");
|
|
397
|
+
sb_print_hex(error);
|
|
398
|
+
sb_newline();
|
|
399
|
+
} else {
|
|
400
|
+
for (i = 0; i < SHOW_BYTES; ++i) {
|
|
401
|
+
line[i] = data[i] < 0x20 ? '.' : data[i];
|
|
402
|
+
}
|
|
403
|
+
line[SHOW_BYTES] = 0;
|
|
404
|
+
sb_puts(line);
|
|
405
|
+
}
|
|
406
|
+
sb_getkey();
|
|
407
|
+
return 0;
|
|
408
|
+
}
|
|
409
|
+
```
|
|
410
|
+
|
|
411
|
+
## poke
|
|
412
|
+
|
|
413
|
+
程序名 `POKE`。
|
|
414
|
+
|
|
415
|
+
`src/poke.c`:
|
|
416
|
+
|
|
417
|
+
```c
|
|
418
|
+
/*
|
|
419
|
+
* ------------------------------------------------------------------------
|
|
420
|
+
* 名称:poke.c
|
|
421
|
+
* 说明:按偏移写文件的 SB-DOS 程序:在 DOS 下输入“poke 文件名 十六进制偏移 文字”,把文字(大写)写进已有文件的该偏移处。
|
|
422
|
+
* 作者:sungbin
|
|
423
|
+
* 邮箱:sungbin@3578.cn
|
|
424
|
+
* 日期:2026-11-11
|
|
425
|
+
* 备注:演示按偏移写入 sb_file_write:以 SB_MODE_UPDATE 打开已有文件,写入范围不能超出文件当前大小(否则出错码 0x14),
|
|
426
|
+
* 关闭时才把改动写回目录项。文字最长 60 个字符;出错时先关闭文件再显示“ERROR 码”。
|
|
427
|
+
* ------------------------------------------------------------------------
|
|
428
|
+
*/
|
|
429
|
+
#include <sb2000.h>
|
|
430
|
+
|
|
431
|
+
/** 文字的最大长度 */
|
|
432
|
+
#define TEXT_MAX 60
|
|
433
|
+
|
|
434
|
+
static char path[29];
|
|
435
|
+
static char offset_text[9];
|
|
436
|
+
static char text[TEXT_MAX + 1];
|
|
437
|
+
|
|
438
|
+
/** 从命令行取下一个以空格分隔的词放进 out,没有词时返回 0 */
|
|
439
|
+
static unsigned char next_word(const char **cursor, char *out, unsigned char size)
|
|
440
|
+
{
|
|
441
|
+
const char *p = *cursor;
|
|
442
|
+
unsigned char count = 0;
|
|
443
|
+
|
|
444
|
+
while (*p == ' ') {
|
|
445
|
+
++p;
|
|
446
|
+
}
|
|
447
|
+
*cursor = p;
|
|
448
|
+
if (*p == 0) {
|
|
449
|
+
return 0;
|
|
450
|
+
}
|
|
451
|
+
while (*p != 0 && *p != ' ') {
|
|
452
|
+
if (count < size - 1) {
|
|
453
|
+
out[count++] = *p;
|
|
454
|
+
}
|
|
455
|
+
++p;
|
|
456
|
+
}
|
|
457
|
+
out[count] = 0;
|
|
458
|
+
*cursor = p;
|
|
459
|
+
return 1;
|
|
460
|
+
}
|
|
461
|
+
|
|
462
|
+
/** 解析大写十六进制数,遇到非十六进制字符停止 */
|
|
463
|
+
static unsigned long parse_hex(const char *digits)
|
|
464
|
+
{
|
|
465
|
+
unsigned long value = 0;
|
|
466
|
+
unsigned char digit;
|
|
467
|
+
|
|
468
|
+
for (; *digits != 0; ++digits) {
|
|
469
|
+
if (*digits >= '0' && *digits <= '9') {
|
|
470
|
+
digit = *digits - '0';
|
|
471
|
+
} else if (*digits >= 'A' && *digits <= 'F') {
|
|
472
|
+
digit = *digits - 'A' + 10;
|
|
473
|
+
} else {
|
|
474
|
+
break;
|
|
475
|
+
}
|
|
476
|
+
value = (value << 4) | digit;
|
|
477
|
+
}
|
|
478
|
+
return value;
|
|
479
|
+
}
|
|
480
|
+
|
|
481
|
+
int main(void)
|
|
482
|
+
{
|
|
483
|
+
const char *tail = (const char *)SB_CMD_TAIL;
|
|
484
|
+
unsigned char handle;
|
|
485
|
+
unsigned char error;
|
|
486
|
+
unsigned char length = 0;
|
|
487
|
+
|
|
488
|
+
if (!next_word(&tail, path, sizeof(path)) || !next_word(&tail, offset_text, sizeof(offset_text))) {
|
|
489
|
+
sb_puts("USAGE: POKE FILE HEXOFF TEXT");
|
|
490
|
+
sb_getkey();
|
|
491
|
+
return 0;
|
|
492
|
+
}
|
|
493
|
+
while (*tail == ' ') {
|
|
494
|
+
++tail;
|
|
495
|
+
}
|
|
496
|
+
while (*tail != 0 && length < TEXT_MAX) {
|
|
497
|
+
text[length++] = *tail++;
|
|
498
|
+
}
|
|
499
|
+
text[length] = 0;
|
|
500
|
+
if (length == 0) {
|
|
501
|
+
sb_puts("USAGE: POKE FILE HEXOFF TEXT");
|
|
502
|
+
sb_getkey();
|
|
503
|
+
return 0;
|
|
504
|
+
}
|
|
505
|
+
|
|
506
|
+
error = sb_file_open(path, SB_MODE_UPDATE, &handle);
|
|
507
|
+
if (error == 0) {
|
|
508
|
+
error = sb_file_write(handle, parse_hex(offset_text), text, length);
|
|
509
|
+
sb_file_close(handle);
|
|
510
|
+
}
|
|
511
|
+
|
|
512
|
+
if (error == 0) {
|
|
513
|
+
sb_puts("POKE OK");
|
|
514
|
+
} else {
|
|
515
|
+
sb_cursor_set_column(1);
|
|
516
|
+
sb_print("ERROR ");
|
|
517
|
+
sb_print_hex(error);
|
|
518
|
+
sb_newline();
|
|
519
|
+
}
|
|
520
|
+
sb_getkey();
|
|
521
|
+
return 0;
|
|
522
|
+
}
|
|
523
|
+
```
|
|
524
|
+
|
|
525
|
+
## pad
|
|
526
|
+
|
|
527
|
+
程序名 `PAD`。
|
|
528
|
+
|
|
529
|
+
`src/pad.c`:
|
|
530
|
+
|
|
531
|
+
```c
|
|
532
|
+
/*
|
|
533
|
+
* ------------------------------------------------------------------------
|
|
534
|
+
* 名称:pad.c
|
|
535
|
+
* 说明:测试手柄服务的 SB-DOS 程序:初始化后等待手柄按键,显示键码与两个手柄的状态,再等键盘按键后返回。
|
|
536
|
+
* 作者:sungbin
|
|
537
|
+
* 邮箱:sungbin@3578.cn
|
|
538
|
+
* 日期:2026-11-11
|
|
539
|
+
* 备注:显示格式:KEY xx P1 xx P2 xx,三个值依次是键码、1 号手柄与 2 号手柄的原始状态(位 7 为 A,位 0 为右)。
|
|
540
|
+
* 在模拟器里用调试命令“pad 0 01”按下 1 号手柄 A,松开用“pad 0 clear”。
|
|
541
|
+
* 从键盘启动程序时,回车键在启动后的一小段时间里还按着,模拟器把它当成手柄的开始键,所以先等 120 帧再初始化。
|
|
542
|
+
* ------------------------------------------------------------------------
|
|
543
|
+
*/
|
|
544
|
+
#include <sb2000.h>
|
|
545
|
+
|
|
546
|
+
int main(void)
|
|
547
|
+
{
|
|
548
|
+
unsigned char key;
|
|
549
|
+
|
|
550
|
+
sb_wait_frames(120);
|
|
551
|
+
sb_pad_init();
|
|
552
|
+
sb_puts("PRESS A PAD BUTTON");
|
|
553
|
+
|
|
554
|
+
key = sb_pad_wait();
|
|
555
|
+
sb_print("KEY ");
|
|
556
|
+
sb_print_hex(key);
|
|
557
|
+
sb_print(" P1 ");
|
|
558
|
+
sb_print_hex(sb_pad_state(0));
|
|
559
|
+
sb_print(" P2 ");
|
|
560
|
+
sb_print_hex(sb_pad_state(1));
|
|
561
|
+
sb_newline();
|
|
562
|
+
|
|
563
|
+
sb_getkey();
|
|
564
|
+
return 0;
|
|
565
|
+
}
|
|
566
|
+
```
|
|
567
|
+
|
|
568
|
+
## mouse
|
|
569
|
+
|
|
570
|
+
程序名 `MOUSE`。
|
|
571
|
+
|
|
572
|
+
`src/mouse.c`:
|
|
573
|
+
|
|
574
|
+
```c
|
|
575
|
+
/*
|
|
576
|
+
* ------------------------------------------------------------------------
|
|
577
|
+
* 名称:mouse.c
|
|
578
|
+
* 说明:测试鼠标服务的 SB-DOS 程序:复位鼠标、设置坐标范围与初始坐标,等 250 帧后取坐标并显示。
|
|
579
|
+
* 作者:sungbin
|
|
580
|
+
* 邮箱:sungbin@3578.cn
|
|
581
|
+
* 日期:2026-11-11
|
|
582
|
+
* 备注:在模拟器里等程序显示“MOVE THE MOUSE”后,用调试命令“mouse move dx dy”移动鼠标,“mouse btn 掩码”注入按键。
|
|
583
|
+
* 显示格式:X xx Y xx(十六进制),初始坐标是 X=80、Y=40;没有检测到鼠标时显示 NO MOUSE。
|
|
584
|
+
* 第二行 B 后面依次是两个键的状态、双击、单击、拖动共 8 个字节。
|
|
585
|
+
* ------------------------------------------------------------------------
|
|
586
|
+
*/
|
|
587
|
+
#include <sb2000.h>
|
|
588
|
+
|
|
589
|
+
int main(void)
|
|
590
|
+
{
|
|
591
|
+
unsigned char x;
|
|
592
|
+
unsigned char y;
|
|
593
|
+
unsigned char i;
|
|
594
|
+
sb_mouse_buttons_t buttons;
|
|
595
|
+
|
|
596
|
+
if (!sb_mouse_reset()) {
|
|
597
|
+
sb_puts("NO MOUSE");
|
|
598
|
+
sb_getkey();
|
|
599
|
+
return 0;
|
|
600
|
+
}
|
|
601
|
+
/* 鼠标中断要先允许,再设范围与初始坐标 */
|
|
602
|
+
sb_irq_enable(SB_IRQ_SOURCE_MOUSE);
|
|
603
|
+
sb_mouse_set_limits(0, 0, 0xFF, 0xFF);
|
|
604
|
+
sb_mouse_set_position(0x80, 0x40);
|
|
605
|
+
|
|
606
|
+
sb_puts("MOVE THE MOUSE");
|
|
607
|
+
sb_wait_frames(250);
|
|
608
|
+
|
|
609
|
+
sb_mouse_position(&x, &y);
|
|
610
|
+
sb_mouse_buttons(&buttons);
|
|
611
|
+
sb_print("X ");
|
|
612
|
+
sb_print_hex(x);
|
|
613
|
+
sb_print(" Y ");
|
|
614
|
+
sb_print_hex(y);
|
|
615
|
+
sb_newline();
|
|
616
|
+
|
|
617
|
+
sb_print("B");
|
|
618
|
+
for (i = 0; i < 2; ++i) {
|
|
619
|
+
sb_print(" ");
|
|
620
|
+
sb_print_hex(buttons.state[i]);
|
|
621
|
+
}
|
|
622
|
+
for (i = 0; i < 2; ++i) {
|
|
623
|
+
sb_print(" ");
|
|
624
|
+
sb_print_hex(buttons.double_click[i]);
|
|
625
|
+
}
|
|
626
|
+
for (i = 0; i < 2; ++i) {
|
|
627
|
+
sb_print(" ");
|
|
628
|
+
sb_print_hex(buttons.click[i]);
|
|
629
|
+
}
|
|
630
|
+
for (i = 0; i < 2; ++i) {
|
|
631
|
+
sb_print(" ");
|
|
632
|
+
sb_print_hex(buttons.drag[i]);
|
|
633
|
+
}
|
|
634
|
+
sb_newline();
|
|
635
|
+
|
|
636
|
+
sb_getkey();
|
|
637
|
+
return 0;
|
|
638
|
+
}
|
|
639
|
+
```
|
|
640
|
+
|
|
641
|
+
## play
|
|
642
|
+
|
|
643
|
+
程序名 `PLAY`。
|
|
644
|
+
|
|
645
|
+
`src/play.s`:
|
|
646
|
+
|
|
647
|
+
```text
|
|
648
|
+
; ------------------------------------------------------------------------
|
|
649
|
+
; 名称:play.s
|
|
650
|
+
; 说明:在 DOS 下运行 .nes 游戏:play 文件名.nes,支持 mapper 0 与 mapper 4(MMC3),PRG、CHR 各不超过 128K。
|
|
651
|
+
; 作者:sungbin
|
|
652
|
+
; 邮箱:sungbin@3578.cn
|
|
653
|
+
; 日期:2026-11-11
|
|
654
|
+
; 备注:构建 fcdev build apps/sb2000/examples/play(程序入口是导出的 _main,由启动代码调用);游戏文件名放在命令行,如 play mario.nes
|
|
655
|
+
; 流程:取参数里的文件名 -> 打开 -> 取大小(超过 256K+16 就按 256K+16 读,文件末尾可能带说明文字)-> 分配页 -> 读入 -> 关闭
|
|
656
|
+
; -> 检查 iNES 头 -> 关 NMI -> PRG 先用 DMA 复制到 ERAM 缓冲 $6800-$77FF,再把目的页映射到 $B000 后用 CPU 复制过去,CHR 用 DMA 复制到扩展 RAM、扩展显存的第 3 个 128K 窗口($5006=$FF)
|
|
657
|
+
; -> 把 PRG 里的 RESET 向量改为 ERAM $6100 的启动桩 -> 在 ERAM $6000 写 $5006、$4301 进入 FC 兼容模式。
|
|
658
|
+
; 放置方式:MMC3 仿真下 $C000-$FFFF 固定为窗口末尾 16K,$8000-$BFFF 由 R6/R7 选 8K 页(R6/R7 只取低 4 位)。
|
|
659
|
+
; mapper 0:PRG 放在窗口末尾,启动桩把 R6/R7 设为末尾前的两个 8K(32K 为 12、13,16K 为 14、15);
|
|
660
|
+
; mapper 4:PRG 放在窗口开头(银行号直接对应),PRG 不足 128K 时再把最后 16K 复制到窗口末尾,R6/R7 设为 0、1,之后游戏自己设置。
|
|
661
|
+
; CHR 放在扩展显存同一窗口开头,R0-R5 设为 0、2、4、5、6、7(与 CHR 顺序一致)。
|
|
662
|
+
; DMA 寄存器($4048-$404F):$4049 低 4 位与 bit4 为源(bit4=1 表示扩展 RAM),$404A/$404B 为源偏移($404B 位 7 必须为 1,否则 DMA 不传输),
|
|
663
|
+
; $404C/$404D 为目的,$404E/$404F 为长度(字节数减 1);$4048 写 $E0 为复制到 CPU 地址(目的在 $8000 以上写不进去,所以只用来写 ERAM 缓冲),$C0 为复制到显存(目的 bit15 置位表示扩展显存,再加 $4300 选的 32K bank)。
|
|
664
|
+
; 运行变量(ERAM):$6700 文件页数、$6701 文件首页、$6702 PRG 个数(16K)、$6703 CHR 个数(8K)、$6704 iNES 标志 6、
|
|
665
|
+
; $6705 标志 7 高 4 位、$6706 PRG 页数(4K)、$6707 复制序号、$6709/$670A DMA 目的、$670B/$670C DMA 长度、
|
|
666
|
+
; $670F 当前目的页、$6710/$6711 游戏原 RESET 入口、$6712 mapper、$6713 CHR 4K 块数、$6714 PRG 首个目的页、$6715-$6717 DMA 源偏移。
|
|
667
|
+
; ------------------------------------------------------------------------
|
|
668
|
+
.export _main
|
|
669
|
+
.segment "ZEROPAGE"
|
|
670
|
+
copy_src:
|
|
671
|
+
.res 2
|
|
672
|
+
copy_dst:
|
|
673
|
+
.res 2
|
|
674
|
+
.segment "CODE"
|
|
675
|
+
|
|
676
|
+
_main:
|
|
677
|
+
start:
|
|
678
|
+
LDA #$01
|
|
679
|
+
STA $630C
|
|
680
|
+
JSR copy_name
|
|
681
|
+
LDA $6543
|
|
682
|
+
BNE name_ok
|
|
683
|
+
LDX #<msg_usage
|
|
684
|
+
LDY #>msg_usage
|
|
685
|
+
JMP fail
|
|
686
|
+
name_ok:
|
|
687
|
+
LDA #$00
|
|
688
|
+
STA $6560
|
|
689
|
+
LDA #$7B
|
|
690
|
+
LDX #$09
|
|
691
|
+
JSR sys
|
|
692
|
+
LDA $6300
|
|
693
|
+
BEQ opened
|
|
694
|
+
LDX #<msg_open
|
|
695
|
+
LDY #>msg_open
|
|
696
|
+
JMP fail
|
|
697
|
+
opened:
|
|
698
|
+
LDA #$7C
|
|
699
|
+
LDX #$0D
|
|
700
|
+
JSR sys
|
|
701
|
+
JSR clamp_size
|
|
702
|
+
; 页数 = (大小 + 4095) / 4096,大小在 $6568-$656A(小端)
|
|
703
|
+
LDA $656A
|
|
704
|
+
ASL A
|
|
705
|
+
ASL A
|
|
706
|
+
ASL A
|
|
707
|
+
ASL A
|
|
708
|
+
STA $6700
|
|
709
|
+
LDA $6569
|
|
710
|
+
LSR A
|
|
711
|
+
LSR A
|
|
712
|
+
LSR A
|
|
713
|
+
LSR A
|
|
714
|
+
ORA $6700
|
|
715
|
+
STA $6700
|
|
716
|
+
LDA $6569
|
|
717
|
+
AND #$0F
|
|
718
|
+
ORA $6568
|
|
719
|
+
BEQ whole_pages
|
|
720
|
+
INC $6700
|
|
721
|
+
whole_pages:
|
|
722
|
+
LDA $6700
|
|
723
|
+
STA $65A6
|
|
724
|
+
LDA #$7E
|
|
725
|
+
LDX #$00
|
|
726
|
+
JSR sys
|
|
727
|
+
LDA $6300
|
|
728
|
+
BEQ allocated
|
|
729
|
+
no_memory:
|
|
730
|
+
LDX #<msg_mem
|
|
731
|
+
LDY #>msg_mem
|
|
732
|
+
JMP fail
|
|
733
|
+
allocated:
|
|
734
|
+
LDA $65A7
|
|
735
|
+
STA $656B
|
|
736
|
+
STA $6701
|
|
737
|
+
; 文件所在页必须全部低于目的窗口(页 $E0 起)
|
|
738
|
+
CLC
|
|
739
|
+
ADC $6700
|
|
740
|
+
CMP #$E1
|
|
741
|
+
BCS no_memory
|
|
742
|
+
LDA #$7C
|
|
743
|
+
LDX #$0F
|
|
744
|
+
JSR sys
|
|
745
|
+
LDA $6300
|
|
746
|
+
PHA
|
|
747
|
+
LDA #$7B
|
|
748
|
+
LDX #$0A
|
|
749
|
+
JSR sys
|
|
750
|
+
PLA
|
|
751
|
+
BEQ loaded
|
|
752
|
+
LDX #<msg_read
|
|
753
|
+
LDY #>msg_read
|
|
754
|
+
JMP fail
|
|
755
|
+
loaded:
|
|
756
|
+
; 把文件第一页映射到 $B000,检查 iNES 头
|
|
757
|
+
LDA $6701
|
|
758
|
+
JSR map_b000
|
|
759
|
+
LDA $B000
|
|
760
|
+
CMP #$4E
|
|
761
|
+
BNE bad_header
|
|
762
|
+
LDA $B001
|
|
763
|
+
CMP #$45
|
|
764
|
+
BNE bad_header
|
|
765
|
+
LDA $B002
|
|
766
|
+
CMP #$53
|
|
767
|
+
BNE bad_header
|
|
768
|
+
LDA $B003
|
|
769
|
+
CMP #$1A
|
|
770
|
+
BEQ header_ok
|
|
771
|
+
bad_header:
|
|
772
|
+
LDX #<msg_header
|
|
773
|
+
LDY #>msg_header
|
|
774
|
+
JMP fail
|
|
775
|
+
header_ok:
|
|
776
|
+
LDA $B004
|
|
777
|
+
STA $6702
|
|
778
|
+
LDA $B005
|
|
779
|
+
STA $6703
|
|
780
|
+
LDA $B006
|
|
781
|
+
STA $6704
|
|
782
|
+
LDA $B007
|
|
783
|
+
AND #$F0
|
|
784
|
+
STA $6705
|
|
785
|
+
LDA $6704
|
|
786
|
+
LSR A
|
|
787
|
+
LSR A
|
|
788
|
+
LSR A
|
|
789
|
+
LSR A
|
|
790
|
+
ORA $6705
|
|
791
|
+
STA $6712
|
|
792
|
+
JSR check_header
|
|
793
|
+
BCC size_ok
|
|
794
|
+
LDX $6720
|
|
795
|
+
LDY $6721
|
|
796
|
+
JMP fail
|
|
797
|
+
size_ok:
|
|
798
|
+
; PRG 页数(每 16K 为 4 页)与首个目的页:mapper 0 放窗口末尾,mapper 4 放窗口开头
|
|
799
|
+
LDA $6702
|
|
800
|
+
ASL A
|
|
801
|
+
ASL A
|
|
802
|
+
STA $6706
|
|
803
|
+
LDA #$E0
|
|
804
|
+
LDX $6712
|
|
805
|
+
BNE prg_start_set
|
|
806
|
+
LDA #$00
|
|
807
|
+
SEC
|
|
808
|
+
SBC $6706
|
|
809
|
+
prg_start_set:
|
|
810
|
+
STA $6714
|
|
811
|
+
; 关 NMI 并禁止中断:此后不再返回 DOS,DOS 的显示与键盘不应再运行
|
|
812
|
+
SEI
|
|
813
|
+
LDA #$00
|
|
814
|
+
STA $2000
|
|
815
|
+
STA $6707
|
|
816
|
+
prg_loop:
|
|
817
|
+
LDA $6701
|
|
818
|
+
SEC
|
|
819
|
+
SBC #$80
|
|
820
|
+
CLC
|
|
821
|
+
ADC $6707
|
|
822
|
+
LDY $6714
|
|
823
|
+
JSR copy_page_k
|
|
824
|
+
INC $6707
|
|
825
|
+
LDA $6707
|
|
826
|
+
CMP $6706
|
|
827
|
+
BNE prg_loop
|
|
828
|
+
; mapper 4 的 PRG 不足 128K 时,把最后 16K 再复制到窗口末尾(页 $FC-$FF)
|
|
829
|
+
LDA $6712
|
|
830
|
+
BEQ prg_done
|
|
831
|
+
LDA $6706
|
|
832
|
+
CMP #$20
|
|
833
|
+
BEQ prg_done
|
|
834
|
+
LDA #$00
|
|
835
|
+
STA $6707
|
|
836
|
+
tail_loop:
|
|
837
|
+
LDA $6701
|
|
838
|
+
SEC
|
|
839
|
+
SBC #$80
|
|
840
|
+
CLC
|
|
841
|
+
ADC $6706
|
|
842
|
+
SEC
|
|
843
|
+
SBC #$04
|
|
844
|
+
CLC
|
|
845
|
+
ADC $6707
|
|
846
|
+
LDY #$FC
|
|
847
|
+
JSR copy_page_k
|
|
848
|
+
INC $6707
|
|
849
|
+
LDA $6707
|
|
850
|
+
CMP #$04
|
|
851
|
+
BNE tail_loop
|
|
852
|
+
prg_done:
|
|
853
|
+
; 窗口最后一页($FF)里有向量:保存原 RESET 入口,再改为 $6100
|
|
854
|
+
LDA #$FF
|
|
855
|
+
JSR map_b000
|
|
856
|
+
LDA $BFFC
|
|
857
|
+
STA $6710
|
|
858
|
+
LDA $BFFD
|
|
859
|
+
STA $6711
|
|
860
|
+
LDA #$00
|
|
861
|
+
STA $BFFC
|
|
862
|
+
LDA #$61
|
|
863
|
+
STA $BFFD
|
|
864
|
+
; CHR 紧接在 PRG 之后:每 4K 一块,源页序号 = 起始页 - $80 + PRG 页数 + 块号
|
|
865
|
+
LDA $6703
|
|
866
|
+
ASL A
|
|
867
|
+
STA $6713
|
|
868
|
+
LDA #$00
|
|
869
|
+
STA $6707
|
|
870
|
+
chr_loop:
|
|
871
|
+
LDA $6701
|
|
872
|
+
SEC
|
|
873
|
+
SBC #$80
|
|
874
|
+
CLC
|
|
875
|
+
ADC $6706
|
|
876
|
+
CLC
|
|
877
|
+
ADC $6707
|
|
878
|
+
JSR set_source
|
|
879
|
+
; 目的 = $8000 + (块号 mod 8) * $1000,显存 bank = 12 + 块号 / 8(第 3 个窗口从 32K 单位 12 开始)
|
|
880
|
+
LDA $6707
|
|
881
|
+
LSR A
|
|
882
|
+
LSR A
|
|
883
|
+
LSR A
|
|
884
|
+
CLC
|
|
885
|
+
ADC #$0C
|
|
886
|
+
STA $4300
|
|
887
|
+
LDA $6707
|
|
888
|
+
AND #$07
|
|
889
|
+
ASL A
|
|
890
|
+
ASL A
|
|
891
|
+
ASL A
|
|
892
|
+
ASL A
|
|
893
|
+
ORA #$80
|
|
894
|
+
STA $670A
|
|
895
|
+
LDA #$00
|
|
896
|
+
STA $6709
|
|
897
|
+
LDA #$FF
|
|
898
|
+
STA $670B
|
|
899
|
+
LDA #$0F
|
|
900
|
+
STA $670C
|
|
901
|
+
LDA #$C0
|
|
902
|
+
JSR dma
|
|
903
|
+
INC $6707
|
|
904
|
+
LDA $6707
|
|
905
|
+
CMP $6713
|
|
906
|
+
BNE chr_loop
|
|
907
|
+
; 把启动桩复制到 ERAM
|
|
908
|
+
LDX #$00
|
|
909
|
+
copy_trampoline:
|
|
910
|
+
LDA trampoline_image,X
|
|
911
|
+
STA $6000,X
|
|
912
|
+
INX
|
|
913
|
+
CPX #$0C
|
|
914
|
+
BNE copy_trampoline
|
|
915
|
+
LDX #$00
|
|
916
|
+
copy_stub:
|
|
917
|
+
LDA stub_image,X
|
|
918
|
+
STA $6100,X
|
|
919
|
+
INX
|
|
920
|
+
CPX #$30
|
|
921
|
+
BNE copy_stub
|
|
922
|
+
; 启动桩的参数:原 RESET 入口、镜像(iNES 标志位 0 为 1 表示垂直,MMC3 的 $A000 写 0 为垂直)与 PRG 银行
|
|
923
|
+
LDA $6710
|
|
924
|
+
STA $611B
|
|
925
|
+
LDA $6711
|
|
926
|
+
STA $611C
|
|
927
|
+
LDA $6704
|
|
928
|
+
AND #$01
|
|
929
|
+
EOR #$01
|
|
930
|
+
STA $6116
|
|
931
|
+
LDA $6712
|
|
932
|
+
BNE regs_mapper4
|
|
933
|
+
LDA #$0C
|
|
934
|
+
LDX $6702
|
|
935
|
+
CPX #$01
|
|
936
|
+
BNE prg_regs
|
|
937
|
+
LDA #$0E
|
|
938
|
+
JMP prg_regs
|
|
939
|
+
regs_mapper4:
|
|
940
|
+
LDA #$00
|
|
941
|
+
prg_regs:
|
|
942
|
+
STA $612A
|
|
943
|
+
CLC
|
|
944
|
+
ADC #$01
|
|
945
|
+
STA $612C
|
|
946
|
+
JMP $6000
|
|
947
|
+
|
|
948
|
+
; 文件大小超过 $040010 时按 $040010 读取(128K PRG + 128K CHR + 头)
|
|
949
|
+
clamp_size:
|
|
950
|
+
LDA $656A
|
|
951
|
+
CMP #$04
|
|
952
|
+
BCC clamp_done
|
|
953
|
+
BNE clamp_set
|
|
954
|
+
LDA $6569
|
|
955
|
+
BNE clamp_set
|
|
956
|
+
LDA $6568
|
|
957
|
+
CMP #$11
|
|
958
|
+
BCC clamp_done
|
|
959
|
+
clamp_set:
|
|
960
|
+
LDA #$10
|
|
961
|
+
STA $6568
|
|
962
|
+
LDA #$00
|
|
963
|
+
STA $6569
|
|
964
|
+
LDA #$04
|
|
965
|
+
STA $656A
|
|
966
|
+
clamp_done:
|
|
967
|
+
RTS
|
|
968
|
+
|
|
969
|
+
; 检查 iNES 头:可运行则清进位返回;否则置进位,信息指针放在 $6720/$6721
|
|
970
|
+
check_header:
|
|
971
|
+
LDA $6704
|
|
972
|
+
AND #$04
|
|
973
|
+
BNE check_size_bad
|
|
974
|
+
LDA $6703
|
|
975
|
+
BEQ check_size_bad
|
|
976
|
+
CMP #$11
|
|
977
|
+
BCS check_size_bad
|
|
978
|
+
LDA $6702
|
|
979
|
+
BEQ check_size_bad
|
|
980
|
+
CMP #$09
|
|
981
|
+
BCS check_size_bad
|
|
982
|
+
LDA $6712
|
|
983
|
+
BEQ check_mapper0
|
|
984
|
+
CMP #$04
|
|
985
|
+
BEQ check_ok
|
|
986
|
+
LDA #<msg_mapper
|
|
987
|
+
STA $6720
|
|
988
|
+
LDA #>msg_mapper
|
|
989
|
+
STA $6721
|
|
990
|
+
SEC
|
|
991
|
+
RTS
|
|
992
|
+
check_mapper0:
|
|
993
|
+
LDA $6703
|
|
994
|
+
CMP #$01
|
|
995
|
+
BNE check_size_bad
|
|
996
|
+
LDA $6702
|
|
997
|
+
CMP #$03
|
|
998
|
+
BCS check_size_bad
|
|
999
|
+
check_ok:
|
|
1000
|
+
CLC
|
|
1001
|
+
RTS
|
|
1002
|
+
check_size_bad:
|
|
1003
|
+
LDA #<msg_size
|
|
1004
|
+
STA $6720
|
|
1005
|
+
LDA #>msg_size
|
|
1006
|
+
STA $6721
|
|
1007
|
+
SEC
|
|
1008
|
+
RTS
|
|
1009
|
+
|
|
1010
|
+
; 复制一个 4K 页:A 为源页序号(相对 $80),Y 为目的起始页,$6707 为序号(目的页 = Y + 序号)
|
|
1011
|
+
copy_page_k:
|
|
1012
|
+
PHA
|
|
1013
|
+
TYA
|
|
1014
|
+
CLC
|
|
1015
|
+
ADC $6707
|
|
1016
|
+
STA $670F
|
|
1017
|
+
PLA
|
|
1018
|
+
copy_page_do:
|
|
1019
|
+
JSR set_source
|
|
1020
|
+
; 先 DMA 到 ERAM $6800 的缓冲:目的在 $8000 以上(程序窗口)时 DMA 写不进去
|
|
1021
|
+
LDA #$00
|
|
1022
|
+
STA $6709
|
|
1023
|
+
LDA #$68
|
|
1024
|
+
STA $670A
|
|
1025
|
+
LDA #$FF
|
|
1026
|
+
STA $670B
|
|
1027
|
+
LDA #$0F
|
|
1028
|
+
STA $670C
|
|
1029
|
+
LDA #$E0
|
|
1030
|
+
JSR dma
|
|
1031
|
+
; 再把目的页映射到 $B000,用 CPU 从缓冲复制 16 个 256 字节
|
|
1032
|
+
LDA $670F
|
|
1033
|
+
JSR map_b000
|
|
1034
|
+
LDA #$00
|
|
1035
|
+
STA copy_src
|
|
1036
|
+
STA copy_dst
|
|
1037
|
+
LDA #$68
|
|
1038
|
+
STA copy_src+1
|
|
1039
|
+
LDA #$B0
|
|
1040
|
+
STA copy_dst+1
|
|
1041
|
+
LDX #$10
|
|
1042
|
+
LDY #$00
|
|
1043
|
+
copy_loop:
|
|
1044
|
+
LDA (copy_src),Y
|
|
1045
|
+
STA (copy_dst),Y
|
|
1046
|
+
INY
|
|
1047
|
+
BNE copy_loop
|
|
1048
|
+
INC copy_src+1
|
|
1049
|
+
INC copy_dst+1
|
|
1050
|
+
DEX
|
|
1051
|
+
BNE copy_loop
|
|
1052
|
+
RTS
|
|
1053
|
+
|
|
1054
|
+
; 取参数里的第一个词作为文件路径,放到 $6543;$6364 为 0 表示没有参数($6365 起可能有上一条命令的残留)
|
|
1055
|
+
copy_name:
|
|
1056
|
+
LDX #$00
|
|
1057
|
+
skip_blank:
|
|
1058
|
+
LDA $6364,X
|
|
1059
|
+
BEQ copy_name_none
|
|
1060
|
+
CMP #$20
|
|
1061
|
+
BNE copy_name_start
|
|
1062
|
+
INX
|
|
1063
|
+
BNE skip_blank
|
|
1064
|
+
copy_name_none:
|
|
1065
|
+
LDA #$00
|
|
1066
|
+
STA $6543
|
|
1067
|
+
RTS
|
|
1068
|
+
copy_name_start:
|
|
1069
|
+
LDY #$00
|
|
1070
|
+
copy_name_loop:
|
|
1071
|
+
LDA $6364,X
|
|
1072
|
+
BEQ copy_name_end
|
|
1073
|
+
CMP #$20
|
|
1074
|
+
BEQ copy_name_end
|
|
1075
|
+
STA $6543,Y
|
|
1076
|
+
INX
|
|
1077
|
+
INY
|
|
1078
|
+
CPY #$30
|
|
1079
|
+
BNE copy_name_loop
|
|
1080
|
+
copy_name_end:
|
|
1081
|
+
LDA #$00
|
|
1082
|
+
STA $6543,Y
|
|
1083
|
+
RTS
|
|
1084
|
+
|
|
1085
|
+
; 把页 A 映射到窗口 3($B000)
|
|
1086
|
+
map_b000:
|
|
1087
|
+
STA $0641
|
|
1088
|
+
LDA #$03
|
|
1089
|
+
STA $0653
|
|
1090
|
+
LDA #$29
|
|
1091
|
+
LDX #$00
|
|
1092
|
+
JMP sys
|
|
1093
|
+
|
|
1094
|
+
; 设置 DMA 源偏移 = A * $1000 + 16(A 是以 4K 为单位的页序号)
|
|
1095
|
+
set_source:
|
|
1096
|
+
PHA
|
|
1097
|
+
ASL A
|
|
1098
|
+
ASL A
|
|
1099
|
+
ASL A
|
|
1100
|
+
ASL A
|
|
1101
|
+
STA $6716
|
|
1102
|
+
PLA
|
|
1103
|
+
LSR A
|
|
1104
|
+
LSR A
|
|
1105
|
+
LSR A
|
|
1106
|
+
LSR A
|
|
1107
|
+
STA $6717
|
|
1108
|
+
LDA #$10
|
|
1109
|
+
STA $6715
|
|
1110
|
+
RTS
|
|
1111
|
+
|
|
1112
|
+
; 启动 DMA:A 为 $4048 的值,源偏移在 $6715-$6717,目的在 $6709/$670A,长度在 $670B/$670C
|
|
1113
|
+
dma:
|
|
1114
|
+
PHA
|
|
1115
|
+
LDA $6716
|
|
1116
|
+
ASL A
|
|
1117
|
+
LDA $6717
|
|
1118
|
+
ROL A
|
|
1119
|
+
AND #$0F
|
|
1120
|
+
ORA #$10
|
|
1121
|
+
STA $4049
|
|
1122
|
+
LDA $6715
|
|
1123
|
+
STA $404A
|
|
1124
|
+
LDA $6716
|
|
1125
|
+
AND #$7F
|
|
1126
|
+
ORA #$80
|
|
1127
|
+
STA $404B
|
|
1128
|
+
LDA $6709
|
|
1129
|
+
STA $404C
|
|
1130
|
+
LDA $670A
|
|
1131
|
+
STA $404D
|
|
1132
|
+
LDA $670B
|
|
1133
|
+
STA $404E
|
|
1134
|
+
LDA $670C
|
|
1135
|
+
STA $404F
|
|
1136
|
+
PLA
|
|
1137
|
+
STA $4048
|
|
1138
|
+
RTS
|
|
1139
|
+
|
|
1140
|
+
; 失败:显示 Y:X 指向的信息,等待按键后返回 DOS
|
|
1141
|
+
fail:
|
|
1142
|
+
STX $4B
|
|
1143
|
+
STY $4C
|
|
1144
|
+
LDA #$80
|
|
1145
|
+
STA $6308
|
|
1146
|
+
LDA #$62
|
|
1147
|
+
LDX #$82
|
|
1148
|
+
JSR rom_call
|
|
1149
|
+
LDA #$01
|
|
1150
|
+
STA $630C
|
|
1151
|
+
LDA #$E2
|
|
1152
|
+
LDX #$80
|
|
1153
|
+
JSR rom_call
|
|
1154
|
+
LDA #$6B
|
|
1155
|
+
LDX #$04
|
|
1156
|
+
JSR sys
|
|
1157
|
+
CLC
|
|
1158
|
+
RTS
|
|
1159
|
+
|
|
1160
|
+
; 经功能 $25 调用 ROM 页组 0 的 X:A(返回后回到调用者)
|
|
1161
|
+
rom_call:
|
|
1162
|
+
STA $0C
|
|
1163
|
+
STX $0D
|
|
1164
|
+
LDA #$25
|
|
1165
|
+
STA $063E
|
|
1166
|
+
LDA #$00
|
|
1167
|
+
STA $0642
|
|
1168
|
+
JMP $FFF0
|
|
1169
|
+
|
|
1170
|
+
; 调用系统功能:A 为功能号,X 为子功能号
|
|
1171
|
+
sys:
|
|
1172
|
+
STA $063E
|
|
1173
|
+
STX $063F
|
|
1174
|
+
JMP $FFF0
|
|
1175
|
+
|
|
1176
|
+
; Usage: PLAY FILE.NES
|
|
1177
|
+
msg_usage:
|
|
1178
|
+
.byte $55,$73,$61,$67,$65,$3A,$20,$50,$4C,$41,$59,$20,$46,$49,$4C,$45,$2E,$4E,$45,$53,$00
|
|
1179
|
+
; Can't open file
|
|
1180
|
+
msg_open:
|
|
1181
|
+
.byte $43,$61,$6E,$27,$74,$20,$6F,$70,$65,$6E,$20,$66,$69,$6C,$65,$00
|
|
1182
|
+
; No memory
|
|
1183
|
+
msg_mem:
|
|
1184
|
+
.byte $4E,$6F,$20,$6D,$65,$6D,$6F,$72,$79,$00
|
|
1185
|
+
; Read error
|
|
1186
|
+
msg_read:
|
|
1187
|
+
.byte $52,$65,$61,$64,$20,$65,$72,$72,$6F,$72,$00
|
|
1188
|
+
; Not an iNES file
|
|
1189
|
+
msg_header:
|
|
1190
|
+
.byte $4E,$6F,$74,$20,$61,$6E,$20,$69,$4E,$45,$53,$20,$66,$69,$6C,$65,$00
|
|
1191
|
+
; Mapper not supported
|
|
1192
|
+
msg_mapper:
|
|
1193
|
+
.byte $4D,$61,$70,$70,$65,$72,$20,$6E,$6F,$74,$20,$73,$75,$70,$70,$6F,$72,$74,$65,$64,$00
|
|
1194
|
+
; Size not supported
|
|
1195
|
+
msg_size:
|
|
1196
|
+
.byte $53,$69,$7A,$65,$20,$6E,$6F,$74,$20,$73,$75,$70,$70,$6F,$72,$74,$65,$64,$00
|
|
1197
|
+
|
|
1198
|
+
; 以下两段在运行时复制到 ERAM($6000 的跳板、$6100 的启动桩);它们按 ERAM 地址取值,ca65 没有 .rorg,所以写成字节并在注释里给出汇编
|
|
1199
|
+
trampoline_image:
|
|
1200
|
+
.byte $A9,$FF ; LDA #$FF
|
|
1201
|
+
.byte $8D,$06,$50 ; STA $5006
|
|
1202
|
+
.byte $A9,$55 ; LDA #$55
|
|
1203
|
+
.byte $8D,$01,$43 ; STA $4301
|
|
1204
|
+
.byte $EA ; NOP
|
|
1205
|
+
stub_image: ; 汇编地址 $6100
|
|
1206
|
+
.byte $78 ; $6100 SEI
|
|
1207
|
+
.byte $A2,$00 ; $6101 LDX #$00
|
|
1208
|
+
.byte $BD,$1D,$61 ; $6103 stub_loop: LDA stable,X(stable 在 $611D)
|
|
1209
|
+
.byte $8D,$00,$80 ; $6106 STA $8000
|
|
1210
|
+
.byte $BD,$1E,$61 ; $6109 LDA stable+1,X
|
|
1211
|
+
.byte $8D,$01,$80 ; $610C STA $8001
|
|
1212
|
+
.byte $E8,$E8 ; $610F INX、INX
|
|
1213
|
+
.byte $E0,$10 ; $6111 CPX #$10
|
|
1214
|
+
.byte $D0,$EE ; $6113 BNE stub_loop
|
|
1215
|
+
.byte $A9,$00 ; $6115 stub_mirror: LDA #$00(运行时改写第 2 字节)
|
|
1216
|
+
.byte $8D,$00,$A0 ; $6117 STA $A000
|
|
1217
|
+
.byte $4C,$00,$00 ; $611A stub_jmp: JMP $0000(运行时改写后两个字节)
|
|
1218
|
+
.byte $00,$00,$01,$02,$02,$04,$03,$05,$04,$06,$05,$07,$06,$0C,$07,$0D ; $611D stable:MMC3 寄存器序号与初值
|
|
1219
|
+
```
|
|
1220
|
+
|
|
1221
|
+
## newcall
|
|
1222
|
+
|
|
1223
|
+
程序名 `NEWCALL`。
|
|
1224
|
+
|
|
1225
|
+
`src/newcall.c`:
|
|
1226
|
+
|
|
1227
|
+
```c
|
|
1228
|
+
/*
|
|
1229
|
+
* ------------------------------------------------------------------------
|
|
1230
|
+
* 名称:newcall.c
|
|
1231
|
+
* 说明:调用 BIOS 新增的系统调用 $35,显示它返回的扩展版本号;BIOS 不支持时显示 NOT SUPPORTED。
|
|
1232
|
+
* 作者:sungbin
|
|
1233
|
+
* 邮箱:sungbin@3578.cn
|
|
1234
|
+
* 日期:2026-11-11
|
|
1235
|
+
* 备注:给自己修改过的 BIOS 做功能检测的写法:新系统调用只能经内存返回结果,约定它把主版本写入 SYS_PAGE、次版本写入 SYS_GROUP。
|
|
1236
|
+
* 调用前先把这两个单元置 0xFF;原始 BIOS 里功能 $35 是空桩,不会改写它们,据此判断是否支持。
|
|
1237
|
+
* ------------------------------------------------------------------------
|
|
1238
|
+
*/
|
|
1239
|
+
#include <sb2000.h>
|
|
1240
|
+
|
|
1241
|
+
/** 新增的系统调用号 */
|
|
1242
|
+
#define FN_BIOS_VERSION 0x35
|
|
1243
|
+
|
|
1244
|
+
#define SYS_PAGE (*(volatile unsigned char *)SB_SYS_PAGE)
|
|
1245
|
+
#define SYS_GROUP (*(volatile unsigned char *)SB_SYS_GROUP)
|
|
1246
|
+
|
|
1247
|
+
static char text[] = "BIOS EXT VER 0.0";
|
|
1248
|
+
|
|
1249
|
+
/** 低 4 位转成十六进制字符 */
|
|
1250
|
+
static char hex_digit(unsigned char value)
|
|
1251
|
+
{
|
|
1252
|
+
value &= 0x0F;
|
|
1253
|
+
return value < 10 ? '0' + value : 'A' + value - 10;
|
|
1254
|
+
}
|
|
1255
|
+
|
|
1256
|
+
int main(void)
|
|
1257
|
+
{
|
|
1258
|
+
unsigned char major;
|
|
1259
|
+
unsigned char minor;
|
|
1260
|
+
|
|
1261
|
+
SYS_PAGE = 0xFF;
|
|
1262
|
+
SYS_GROUP = 0xFF;
|
|
1263
|
+
sb_syscall(FN_BIOS_VERSION, 0);
|
|
1264
|
+
major = SYS_PAGE;
|
|
1265
|
+
minor = SYS_GROUP;
|
|
1266
|
+
|
|
1267
|
+
if (major == 0xFF) {
|
|
1268
|
+
sb_puts("NOT SUPPORTED");
|
|
1269
|
+
} else {
|
|
1270
|
+
text[14] = hex_digit(major);
|
|
1271
|
+
text[16] = hex_digit(minor);
|
|
1272
|
+
sb_puts(text);
|
|
1273
|
+
}
|
|
1274
|
+
sb_getkey();
|
|
1275
|
+
return 0;
|
|
1276
|
+
}
|
|
1277
|
+
```
|
|
1278
|
+
|
|
1279
|
+
## syscall
|
|
1280
|
+
|
|
1281
|
+
程序名 `SYSCALL`。
|
|
1282
|
+
|
|
1283
|
+
`src/syscall.c`:
|
|
1284
|
+
|
|
1285
|
+
```c
|
|
1286
|
+
/*
|
|
1287
|
+
* ------------------------------------------------------------------------
|
|
1288
|
+
* 名称:syscall.c
|
|
1289
|
+
* 说明:系统调用实验程序:由调试器把功能号与参数写进 ERAM 的请求块,程序代为调用,用来在模拟器里逐个核对没有示例的系统服务。
|
|
1290
|
+
* 作者:sungbin
|
|
1291
|
+
* 邮箱:sungbin@3578.cn
|
|
1292
|
+
* 日期:2026-11-11
|
|
1293
|
+
* 备注:DOS 下输入 syscall 运行,之后一直等待请求,不会退出。
|
|
1294
|
+
* 请求块在 $7E00:+0 请求标志(调试器写 1,程序执行完清 0)、+1 功能号、+2 子功能、
|
|
1295
|
+
* +3 起 20 字节写入 $0640-$0653、+$1F 与 +$20 写入 $0C、$0D;调用后 $0640-$0653 复制回 +$30 起,+$44 放 DOS_ERROR。
|
|
1296
|
+
* ------------------------------------------------------------------------
|
|
1297
|
+
*/
|
|
1298
|
+
#include <sb2000.h>
|
|
1299
|
+
|
|
1300
|
+
/** 请求块的起始地址 */
|
|
1301
|
+
#define BLOCK ((volatile unsigned char *)0x7E00)
|
|
1302
|
+
|
|
1303
|
+
/** 参数区 $0640-$0653 的字节数 */
|
|
1304
|
+
#define PARAM_BYTES 20
|
|
1305
|
+
|
|
1306
|
+
#define PARAM_AREA ((volatile unsigned char *)0x0640)
|
|
1307
|
+
#define PROG_ENTRY ((volatile unsigned char *)0x000C)
|
|
1308
|
+
|
|
1309
|
+
int main(void)
|
|
1310
|
+
{
|
|
1311
|
+
unsigned char i;
|
|
1312
|
+
|
|
1313
|
+
BLOCK[0] = 0;
|
|
1314
|
+
for (;;) {
|
|
1315
|
+
while (BLOCK[0] == 0) {
|
|
1316
|
+
}
|
|
1317
|
+
for (i = 0; i < PARAM_BYTES; ++i) {
|
|
1318
|
+
PARAM_AREA[i] = BLOCK[3 + i];
|
|
1319
|
+
}
|
|
1320
|
+
PROG_ENTRY[0] = BLOCK[0x1F];
|
|
1321
|
+
PROG_ENTRY[1] = BLOCK[0x20];
|
|
1322
|
+
sb_syscall(BLOCK[1], BLOCK[2]);
|
|
1323
|
+
for (i = 0; i < PARAM_BYTES; ++i) {
|
|
1324
|
+
BLOCK[0x30 + i] = PARAM_AREA[i];
|
|
1325
|
+
}
|
|
1326
|
+
BLOCK[0x44] = *(volatile unsigned char *)SB_DOS_ERROR;
|
|
1327
|
+
BLOCK[0] = 0;
|
|
1328
|
+
}
|
|
1329
|
+
}
|
|
1330
|
+
```
|