fcdev 0.6.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.
Files changed (51) hide show
  1. package/CHANGELOG.md +61 -32
  2. package/README.md +17 -16
  3. package/docs/{02- → 01-}/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +14 -12
  4. package/docs/02-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +89 -0
  5. package/docs/{06- → 03-}/345/217/215/346/261/207/347/274/226.md +13 -47
  6. 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
  7. 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
  8. package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +25 -30
  9. 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
  10. package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +5 -5
  11. package/package.json +5 -2
  12. package/src/build/bank-link-config.mjs +1 -1
  13. package/src/build/build-plan.mjs +1 -1
  14. package/src/build/program-builder.mjs +10 -5
  15. package/src/build/source-charset.mjs +111 -0
  16. package/src/cli/args-parser.mjs +1 -1
  17. package/src/cli/commands/debug-command.mjs +20 -58
  18. package/src/cli/commands/docs-command.mjs +2 -2
  19. package/src/cli/commands/run-command.mjs +36 -39
  20. package/src/cli/index.mjs +5 -5
  21. package/src/config/config-loader.mjs +2 -2
  22. package/src/disasm/disassembler.mjs +1 -1
  23. package/src/disasm/trace.mjs +4 -3
  24. package/src/docs/doc-index.mjs +1 -1
  25. package/src/docs/doc-topics.mjs +32 -38
  26. package/src/docs/index.mjs +1 -1
  27. package/src/emulator/debug-cli.mjs +48 -0
  28. package/src/emulator/emulator-launcher.mjs +107 -29
  29. package/src/emulator/emulator-locator.mjs +7 -7
  30. package/src/emulator/index.mjs +4 -3
  31. package/src/emulator/sb2000-session.mjs +104 -0
  32. package/src/targets/target-registry.mjs +9 -1
  33. package/targets/nes/lib/fcnes.lib +0 -0
  34. package/targets/nes/lib/nes-font.o +0 -0
  35. package/targets/nes/target.json +1 -1
  36. package/targets/sb2000/api-reference.md +2 -1
  37. package/targets/sb2000/examples-source.md +1330 -0
  38. package/targets/sb2000/lib/crt0.o +0 -0
  39. package/targets/sb2000/lib/sb2000.lib +0 -0
  40. package/targets/sb2000/symbols-reference.md +670 -0
  41. package/targets/sb2000/target.json +2 -1
  42. package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -163
  43. package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +0 -123
  44. package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +0 -50
  45. package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +0 -92
  46. package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +0 -72
  47. package/docs/09-/345/217/221/345/270/203.md +0 -70
  48. package/docs/10-VS Code/346/211/251/345/261/225.md" +0 -131
  49. package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +0 -47
  50. package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +0 -10
  51. package/src/emulator/debug-client.mjs +0 -125
@@ -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
+ ```