fcdev 0.1.0 → 0.3.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/README.md +21 -2
- package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +164 -0
- package/docs/02-/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +157 -0
- package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +123 -0
- package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +51 -0
- package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +100 -0
- package/docs/06-/345/217/215/346/261/207/347/274/226.md +103 -0
- package/docs/07-/345/210/233/345/273/272/345/214/205/344/270/216/346/250/241/346/235/277.md +74 -0
- package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +72 -0
- package/docs/09-/345/217/221/345/270/203.md +67 -0
- package/docs/10-VS Code/346/211/251/345/261/225.md" +131 -0
- package/docs/nes/01-NES/347/233/256/346/240/207.md +52 -0
- package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +252 -0
- package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md +797 -0
- package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +27 -0
- package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +46 -0
- package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +10 -0
- package/package.json +4 -3
- package/src/api/header-parser.mjs +78 -0
- package/src/api/index.mjs +128 -0
- package/src/build/bank-link-config.mjs +74 -0
- package/src/build/index.mjs +1 -0
- package/src/build/program-builder.mjs +5 -2
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/commands/docs-command.mjs +58 -0
- package/src/cli/index.mjs +6 -0
- package/src/docs/doc-index.mjs +101 -0
- package/src/docs/doc-topics.mjs +38 -0
- package/src/docs/index.mjs +10 -0
- package/src/targets/target-registry.mjs +38 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +203 -1
- package/targets/sb2000/include/sb2000-bank.h +74 -0
- package/targets/sb2000/include/sb2000-clock.h +68 -0
- package/targets/sb2000/include/sb2000-disk.h +141 -0
- package/targets/sb2000/include/sb2000-display.h +352 -0
- package/targets/sb2000/include/sb2000-file.h +273 -0
- package/targets/sb2000/include/sb2000-ime.h +158 -0
- package/targets/sb2000/include/sb2000-input.h +192 -0
- package/targets/sb2000/include/sb2000-math.h +228 -0
- package/targets/sb2000/include/sb2000-memory.h +115 -0
- package/targets/sb2000/include/sb2000-printer.h +116 -0
- package/targets/sb2000/include/sb2000-sound.h +134 -0
- package/targets/sb2000/include/sb2000-symbols.h +397 -1
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +13 -20
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +1 -1
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/src/crt0.s +89 -4
- package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
- package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
- package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
- package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
- package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
- package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
- package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
- package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
- package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
- package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
- package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
- package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
- package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
- package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
- package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
- package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
- package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
- package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
- package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
- package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
- package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
- package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
- package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
- package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
- package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
- package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
- package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
- package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
- package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
- package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
- package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
- package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
- package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
- package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
- package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
- package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
- package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
- package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
- package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
- package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
- package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
- package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
- package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
- package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
- package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
- package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
- package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
- package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
- package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
- package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
- package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
- package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
- package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
- package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
- package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
- package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
- package/targets/sb2000/src/lib/sb-internal.h +111 -0
- package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
- package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
- package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
- package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
- package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
- package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
- package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
- package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
- package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
- package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
- package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
- package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
- package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
- package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
- package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
- package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
- package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
- package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
- package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
- package/targets/sb2000/src/lib/text/sb-print.c +35 -0
- package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
- package/targets/sb2000/src/sb2000.s +0 -3
- package/targets/sb2000/target.json +14 -0
package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md
ADDED
|
@@ -0,0 +1,797 @@
|
|
|
1
|
+
# SB-DOS 系统调用手册
|
|
2
|
+
|
|
3
|
+
小霸王学生电脑的 SB-DOS(版本 2.00)程序接口:程序怎么放进内存、怎么调用系统服务、怎么读写文件、出错码是什么意思。内容来自对 BIOS 的代码阅读与模拟器实测;每一节标明可靠程度,没读完的地方写“待读”,不猜测。
|
|
4
|
+
|
|
5
|
+
可靠程度:**已确认**(代码阅读且实测过)、**代码阅读**(读过代码,没单独实测)、**待读**。
|
|
6
|
+
|
|
7
|
+
## 1. 程序文件与运行
|
|
8
|
+
|
|
9
|
+
| 项目 | 内容 | 可靠程度 |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| 文件头 | 前 5 个字节是 `4C lo hi AA 55`:`JMP` 到程序入口,后面两个字节是魔数 `AA 55` | 已确认 |
|
|
12
|
+
| 装入位置 | DOS 把文件读入扩展 RAM(ERAM 页,页号不小于 `$80`),并映射到 `$8000` 起的窗口;程序文件的第 1 个字节位于 `$8000` | 已确认 |
|
|
13
|
+
| 入口 | 经系统调用 `$25`(页组 `$0642`)调用 `$0C/$0D` 里的地址,即文件头的 `JMP` | 已确认 |
|
|
14
|
+
| 退出 | 程序用 `RTS` 返回,DOS 恢复窗口、寄存器后回到命令行,并清屏重画提示符,所以输出要先停留再返回 | 已确认 |
|
|
15
|
+
| 命令行参数 | 程序名之后的部分转成大写、以 0 结尾放在 ERAM `$6364`(`CMD_TAIL`)起,第 1 个字节是分隔用的空格 | 已确认 |
|
|
16
|
+
| 大程序 | 程序大于 16K 时要自己换页:用系统调用 `$29` 映射别的页;fcdev 的 `banks` 选项已封装,见 [开发指南](01-开发指南.md) 第 3.1 节 | 已确认 |
|
|
17
|
+
|
|
18
|
+
### 1.1 运行与装入的机制
|
|
19
|
+
|
|
20
|
+
- **装入位置**(已确认(ATTRIB 实测)):从 `$8000` 起装入扩展 RAM 窗口:实测 `ATTRIB.EXE` 运行时 `$4040-$4043` 为 `$80-$83`(扩展 RAM 前 4 页),`$8000` 起的内容与文件开头一致(其中偏移 5、6 的两个字节被 DOS 写成起始页号与页数,见 `$7F/$00`),大于 16K 的程序靠自己换页
|
|
21
|
+
- **调用与退出**(已确认(代码阅读与 ATTRIB 实测)):DOS 经 `JSR $FFF0`、功能 `$25`(内核 `$ED55`:`LDA $0642 / JSR $ED94 / JMP ($000C)`)把页号 `$0642` 起的 4 个连续页映射到 `$8000-$BFFF`,再跳到 `$000C/$000D` 里的地址(程序文件头的 `JMP`),程序以 `RTS` 退出,回到分发器 `$FDED`,`JMP $FEFC` 再用调用前保存在 `$0639-$063C` 的 4 个窗口页号重新映射 `$8000-$BFFF`,并从栈恢复 Y、X、P 后返回 DOS。所以程序退出就是普通的子程序返回,DOS 一直在 6576 模式下常驻;`ATTRIB.EXE` 在出错路径上把出错码写 `$6308` 后 `SEC / RTS`
|
|
22
|
+
- **从软盘装入的过程**(序列与读盘已确认):在提示符输入 `attrib` 回车后(只含 `ATTRIB.EXE` 等文件的镜像实测):软驱依次读 LBA 0-9(引导扇区与 FAT)、19(根目录)、33-41(`ATTRIB.EXE` 的 9 个数据扇区),读盘都由 `$862E` 的软驱例程完成;系统调用序列为 `$7B/$09`、`$80/$04`(读目录与 FAT),`$7C/$0D`、`$7E/$00`、`$7C/$0F`、`$80/$04`、`$7B/$0A`,再 `$80/$07`(软驱停转,每次文件操作之后都会调用,不读文件数据),同时用 `$29` 映射扩展 RAM 页 `$80`、`$81`,最后 `$29`(`$0641=$80`)、`$25`(`$0642=$80`,`$000C=$8000`)进入程序。各子功能的含义见 5 节各服务表
|
|
23
|
+
|
|
24
|
+
示例程序见 [开发指南](01-开发指南.md) 第 10 节。本手册里的变量、功能号、子功能号、出错码、运行库入口都有对应的符号名:汇编程序 `.include "sb2000.inc"`,C 程序用 `sb2000-symbols.h`(`SB_` 前缀),就能用名字代替数字。
|
|
25
|
+
|
|
26
|
+
## 2. 地址空间
|
|
27
|
+
|
|
28
|
+
6576 模式下(DOS 常驻在这个模式):
|
|
29
|
+
|
|
30
|
+
| 地址 | 内容 |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| `$0000-$1FFF` | 内部 RAM,8K,不镜像;零页 `$0000-$00FF` 供系统与程序共用,程序要避开 DOS 用到的单元 |
|
|
33
|
+
| `$2000-$3FFF` | PPU 寄存器(`$2000-$2007` 及其镜像) |
|
|
34
|
+
| `$4000-$4017` | 标准 APU 与手柄寄存器 |
|
|
35
|
+
| `$4020-$4036` | 键盘、鼠标、中断、定时器等扩展寄存器(键盘经 `$4020-$4022` 串行收发) |
|
|
36
|
+
| `$4040-$4047` | 8 个窗口的页选择:每个选一个 4K 页,对应 `$8000-$FFFF`;值小于 `$80` 是 BIOS ROM 页,不小于 `$80` 是扩展 RAM 页 |
|
|
37
|
+
| `$4048-$404F` | DMA(见 [硬件说明](03-硬件说明.md)) |
|
|
38
|
+
| `$4200-$4207` | 软驱控制器 |
|
|
39
|
+
| `$4300` | 显存 bank 选择(32K 一个 bank) |
|
|
40
|
+
| `$5000-$5FFF` | 2K 工作 RAM |
|
|
41
|
+
| `$6000-$7FFF` | 8K 扩展 RAM(ERAM),任何窗口映射下都可见;`$6200-$65FF` 一带是 DOS 的状态变量 |
|
|
42
|
+
| `$8000-$BFFF` | 程序窗口:4 个 4K 窗口,由系统调用 `$29`、`$25` 映射 |
|
|
43
|
+
| `$C000-$FFFF` | 固定内核:ROM 第 4-7 页 |
|
|
44
|
+
|
|
45
|
+
汇编程序用 `sb2000.inc` 里的符号名,C 程序用 `sb2000-symbols.h`(`SB_` 前缀)。
|
|
46
|
+
|
|
47
|
+
## 3. 系统调用约定
|
|
48
|
+
|
|
49
|
+
```asm
|
|
50
|
+
LDA #function
|
|
51
|
+
STA SYS_FUNCTION ; $063E,功能号
|
|
52
|
+
LDA #sub
|
|
53
|
+
STA SYS_SUBFUNCTION ; $063F,子功能号(有子功能的服务才需要)
|
|
54
|
+
; 参数放在各服务规定的变量里
|
|
55
|
+
JSR $FFF0 ; 系统调用入口
|
|
56
|
+
; 结果在各服务规定的变量里;文件、磁盘服务看 DOS_ERROR($6300)
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
要点(已确认,来自分发器 `SYSCALL_DISPATCH` 与 `SYSCALL_RETURN` 的代码):
|
|
60
|
+
|
|
61
|
+
- 入口 `$FFF0` 是 `JMP $FD8E`。分发器先把 P、A、X、Y 与 `$0639-$063C`(4 个窗口页号的影子)压栈,返回时全部恢复。
|
|
62
|
+
- **A、X、Y 与进位标志都不会带回调用者**:服务返回的值只能放在内存变量里,处理例程里的 `SEC`/`CLC` 在返回时会被恢复的 P 覆盖,所以必须读出错码,不能看进位。
|
|
63
|
+
- 每次调用开头把 `$0640`(`SYS_STATUS`)清 0;个别功能在子功能号超出范围时把它置为 `$FF`。
|
|
64
|
+
- 内联跳转表(已确认):`JSR $EE76` 之后紧跟 2 字节地址表,A 为下标,直接跳到表项,不回到 JSR 的下一条指令;换页页组里也各有一份同样的例程
|
|
65
|
+
- 功能号规则:小于 `$10` 查 RAM 中 `$05FA` 起的表(每项 3 字节,运行时登记);`$10-$3A`、`$65`、`$67-$6C`、`$6E-$75` 用 ROM 表 `$E082 + 2×(功能号−$10)`;`$3B-$64`、`$66`、`$6D`、`$76-$81` 按范围换入页组后进入页内入口;`$82` 以上直接返回。完整的功能号与封装情况见 [api-reference.md](../../targets/sb2000/api-reference.md) 末尾的覆盖表。
|
|
66
|
+
|
|
67
|
+
## 4. 文件与目录服务
|
|
68
|
+
|
|
69
|
+
功能号 `$7B`、`$7C`、`$7D` 在页组 `$58`,子功能号写 `$063F`。例程名以 `FS_` 开头。
|
|
70
|
+
|
|
71
|
+
### 4.1 公共变量
|
|
72
|
+
|
|
73
|
+
| 变量 | 地址 | 含义 |
|
|
74
|
+
| --- | --- | --- |
|
|
75
|
+
| `DOS_ERROR` | `$6300` | 出错码,0 表示成功,见第 6 节;每次调用开头清 0 |
|
|
76
|
+
| `PATH_BUFFER` | `$6543` | 路径,以 0 结尾的 ASCII,可带 `A:` 与 `\` |
|
|
77
|
+
| `FILE_MODE` | `$6560` | 打开方式,0-5;不小于 6 时出错码 `$28` |
|
|
78
|
+
| `FILE_HANDLE_OFFSET` | `$6561` | 当前句柄在句柄表里的偏移,`$7B/$09` 成功后由系统写入,之后的 `$7C`、`$7B/$0A` 都用它 |
|
|
79
|
+
| `FILE_SIZE_0-2` | `$6568-$656A` | 文件大小,3 字节小端 |
|
|
80
|
+
| `FILE_START_PAGE` | `$656B` | 读写整个文件时的起始页号(扩展 RAM 页号) |
|
|
81
|
+
| `FILE_DATE_LO/HI` | `$656E/$656F` | 日期,FAT 格式:位 0-4 日,位 5-8 月,位 9-15 年(自 1980) |
|
|
82
|
+
| `FILE_TIME_LO/HI` | `$6570/$6571` | 时间,FAT 格式:位 0-4 秒的一半,位 5-10 分,位 11-15 时 |
|
|
83
|
+
| `FILE_ATTR` | `$6572` | 属性:位 0 只读,位 3 卷标,位 4 目录,位 5 存档(位 1、2 按 FAT 标准是隐藏、系统) |
|
|
84
|
+
| `DIR_NAME83` | `$651D` | 当前目录的 11 字节名称(8 字符加 3 字符扩展名,空格补齐,根目录首字节 `$5C`),由 `$7B/$0B` 设置,`$7D/$01` 整理名称时也读它;与 `$6528/$6529`(当前目录第一个扇区)一起决定相对路径在哪个目录里找,不要随便改写 |
|
|
85
|
+
|
|
86
|
+
### 4.2 打开方式(`FILE_MODE`)
|
|
87
|
+
|
|
88
|
+
| 方式 | 含义(来自 `FS_OPEN` 的代码) | 可靠程度 |
|
|
89
|
+
| --- | --- | --- |
|
|
90
|
+
| 0 | 打开已有文件;`$7C/$0F` 读整个文件要求这种方式 | 已确认 |
|
|
91
|
+
| 1 | 创建文件,已存在则覆盖;`$7C/$10` 写整个文件要求这种方式;打开时就分配 1 个簇,所以不写内容就关闭得到“大小 0 但占 1 个簇”的空文件;新文件属性 `$20`,日期时间取系统日期时间 | 已验证(`copy` 实机运行) |
|
|
92
|
+
| 2 | 打开已有文件;关闭时写回目录项;`$7C/$06` 按偏移写要用这种方式(或方式 1) | 已确认(`poke`) |
|
|
93
|
+
| 3 | 把已存在的文件的目录项首字节改成 `$E5`(标为已删除),关闭时同时把簇链在 FAT 里释放(实测:删除 HELLO.TXT 后簇 727 的 FAT 项为 0、空闲簇加 1);只读文件(属性位 0)出错码 5,文件不变;目录项不存在时出错 | 已验证 |
|
|
94
|
+
| 4 | 取得目录项:只对根目录(路径 `\`、`A:\`、`.`)与已存在的子目录成功;对文件出错码 `$2D`,不存在出错码 2(`$7B/$0B`、`$7D/$03` 再把 2、`$2D` 改成 3);已被占用的句柄出错码 `$2A` | 已验证 |
|
|
95
|
+
| 5 | 创建目录项(属性 `$10`);目录已存在出错码 `$26`,已存在同名文件出错码 `$2D`;只支持一级子目录,在子目录里再建目录出错码 `$2A`(目录嵌套层数过多) | 已验证 |
|
|
96
|
+
|
|
97
|
+
关闭(`FS_CLOSE`)时,方式 1、2、5 的句柄先写回目录项,其余直接把句柄置为空闲。
|
|
98
|
+
|
|
99
|
+
### 4.3 句柄表
|
|
100
|
+
|
|
101
|
+
句柄表从 `FILE_HANDLES`(`$643B`)起共 4 项,每项 `$2C` 字节;`$FF` 表示空闲,打开后首字节是打开方式。第 0 项的字段(其他项的地址加 `$2C` 的倍数):
|
|
102
|
+
|
|
103
|
+
| 地址 | 符号 | 含义 |
|
|
104
|
+
| --- | --- | --- |
|
|
105
|
+
| `$643B` | `FILE_HANDLES` | 打开方式,`$FF` 为空闲 |
|
|
106
|
+
| `$643C` | `FH_DRIVE` | 驱动器号:打开时存入当时的 `FS_DRIVE_LETTER`,读写时取回 |
|
|
107
|
+
| `$643D-$6447` | `FH_NAME` | 11 字节名称,首字节 `$E5` 表示已删除 |
|
|
108
|
+
| `$6448` | `FH_ATTR` | 属性 |
|
|
109
|
+
| `$6449-$644B` | `FH_SIZE_0-2` | 文件大小 |
|
|
110
|
+
| `$644C/$644D` | `FH_DATE_LO/HI` | 日期(FAT 格式) |
|
|
111
|
+
| `$644E/$644F` | `FH_TIME_LO/HI` | 时间(FAT 格式) |
|
|
112
|
+
| `$6450/$6451` | `FH_CLUSTER_LO/HI` | 起始簇号 |
|
|
113
|
+
| `$6452-$6454` | `FH_POS_0-2` | 文件位置,打开时清零 |
|
|
114
|
+
| `$6455` | `FH_FLAGS` | 标志 |
|
|
115
|
+
| `$6456/$6457` | `FH_DIR_LBA_LO/HI` | 目录项所在扇区 |
|
|
116
|
+
| `$6458` | `FH_DIR_ENTRY` | 目录项在扇区里的序号 |
|
|
117
|
+
|
|
118
|
+
### 4.4 功能 `$7B`(20 个子功能)
|
|
119
|
+
|
|
120
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
121
|
+
| --- | --- | --- | --- |
|
|
122
|
+
| `$09` | `FS_OPEN` | 按 `FILE_MODE` 打开 `PATH_BUFFER` 里的路径(相对路径在当前目录里找,见 `$7B/$0B`);成功后句柄偏移在 `FILE_HANDLE_OFFSET`(依次 `$00`、`$2C`、`$58`、`$84`),`DOS_ERROR` 为 0;出错码:4 个句柄都在用 4,文件不存在 2,目录不存在(含把文件当目录)3,名称含非法字符 `$27`,打开方式不小于 6 时 `$28`;名称与卷标项同名(方式 0-3)出错码 5;方式 1、5 创建时根目录 224 项全部被占用(没有空位也没有已删除的位置)出错码 `$12`,有已删除的位置就占用它 | 已验证 |
|
|
123
|
+
| `$0A` | `FS_CLOSE` | 关闭 `FILE_HANDLE_OFFSET` 指定的句柄;关闭空闲句柄什么都不做、不出错 | 已验证 |
|
|
124
|
+
| `$0B` | `FS_FIND_ENTRY` | **设置当前目录**(DOS 的 CD 用):以方式 4 打开路径,成功时 `DIR_NAME83`(`$651D`,11 字节)是该目录的名称(根目录首字节为 `$5C`),`$6528/$6529` 是它的第一个扇区(根目录 19),之后的相对路径都在这个目录里找;路径是文件、不存在或父目录不存在时出错码 3(当前目录不变),`..` 出错码 `$27`;**调用者不要随便改写 `DIR_NAME83` 与 `$6528/$6529`**,否则后面的相对路径打开会在“当前目录”里找不到文件(`$7D/$01` 也依赖 `DIR_NAME83`) | 已验证 |
|
|
125
|
+
| `$12` | `FS_OPEN_MODE3_CLOSE_NOFLUSH` | 以方式 3 打开再关闭(标为已删除、簇链释放),不停转软驱 | 已验证 |
|
|
126
|
+
| `$13` | `FS_RESET_HANDLES` | 把 4 个句柄全部置为空闲,每条命令开头都会调用 | 已确认 |
|
|
127
|
+
| `$01` | `FS_FAT_LOAD` | 取 `FS_LBA` 号扇区放到 ERAM `$6000` 起的 512 字节缓冲:FAT 缓存还没装入(`$6585` 位 7 为 0)时,先把引导扇区与 9 个 FAT 扇区共 10 个扇区整体装入缓存(ERAM 页 `$F5` 起,成功后 `$6585` 为 `$80`);扇区号 0-9 再从缓存取出,缓存位置记在 `$6580`(扇区号)、`$6581/$6582`(页内地址,`$B000` 加余数乘 `$200`,低字节在前)、`$6583`(页号,`$F5` 加序号除以 8);扇区号 10 起不经缓存,直接读盘;缓存里的修改在没有 `$7B/$07` 重置时一直保留 | 已验证(21 个扇区号,缓冲与镜像逐字节一致,装入后 10 个缓存扇区与镜像一致) |
|
|
128
|
+
| `$02` | `FS_FAT_STORE` | 把 ERAM `$6000` 起的扇区缓冲(512 字节)写到磁盘的 `FS_LBA` 号扇区;扇区号为 0-9 时同时更新 FAT 缓存里对应的扇区,10 起(含第二份 FAT)和其他扇区只写磁盘 | 已验证(扇区 0、1、5、9、10、15、19、2000、2879,磁盘上只有该扇区被改写,缓存同步更新或不变) |
|
|
129
|
+
| `$07` | `FS_FAT_CACHE_RESET` | 把 `$6584`、`$6585` 清 0,`$657E`、`$657F` 置 `$0A`,只是把缓存标为“未装入”,缓存内容不动;下一次 `$7B/$01` 才会从磁盘重新装入整个缓存(修改过但没写回的缓存内容随之丢弃);`$7B/$05`、`$7B/$0F` 自己不检查缓存是否已装入,使用前要先调用一次 `$7B/$01`(代码阅读) | 已验证(状态单元、重置后重新装入) |
|
|
130
|
+
| `$00` | `FS_NEXT_SECTOR` | 前进到下一扇区,结果在 ERAM `$65A9/$65AA`(调用开头先置为 `FS_LBA`),`$65C5` 开头清 0。按 `FS_LBA` 所在区域:扇区 0 与 10-18(第二份 FAT)出错码 `$1F`;1-9(第一份 FAT)与 19-32(根目录)加 1,加 1 后越出区域(到 10 或 33)不算出错,`$65C5` 置 1 表示区域结束;数据区(33 起)里,同一簇还有下一个扇区就加 1(16 位回绕,扇区 65535 加 1 得 0),否则按簇链取下一簇再换算扇区;簇链到链尾(`$FF8` 以上)时 `$65C5` 置 1、`$65A9/$65AA` 保持原扇区号、出错码为 0;下一簇是空闲簇、坏簇(`$FF0-$FF7`、超过簇号上限的值)、扇区在数据区之前或簇号超出 FAT 范围(簇号不小于 3072)时出错码 `$1F`;等于簇号上限或为 1 的链项被当作有效的下一簇(C=1、A=`$FF` 等返回标志调用者看不到,只能看 `$65C5` 与出错码) | 已验证(每簇 1、2、4、8 扇区,原样镜像与特制 FAT 共 8 组,约 70 个扇区号各自与按汇编转录的模型一致) |
|
|
131
|
+
| `$03` | `FS_CLUSTER_TO_LBA` | 簇号(ERAM `$6536/$6537`)换算成该簇第一个扇区号 `FS_LBA`(`$652E/$652F`,16 位回绕):(簇号 −2)左移“每簇扇区数的位数”+数据区起始扇区;每簇扇区数取自参数块(`FS_DRIVE_LETTER` 为 `$41` 取 A 盘,否则取 B 盘,偏移 `$19`),每簇扇区数为 0 时死循环,不是 2 的幂时按最低置位的位序号移位 | 已验证(A 盘 40 例、B 盘 3 例) |
|
|
132
|
+
| `$04` | `FS_CLUSTER_INC` | 簇号加 1(16 位回绕),与本盘簇号上限(`$6502/$6503`)比较,到末尾时 C=1 | 簇号加 1 已验证;进位标志经分发器后调用者看不到,没有验证 |
|
|
133
|
+
| `$05` | `FS_FAT_GET` | 读 FAT12 项:簇号在 ERAM `$6536/$6537`,下一簇号放 ERAM `$6532/$6533`(链尾为 `$0FFF`);C=0 为空闲簇,C=1 时 A=1 为有效下一簇、A=`$FF` 为链尾(`$FF8` 以上)、A=0 为坏簇或出错(经 `$FFF0` 调用时分发器会恢复 A,调用者看不到这个标志,只能看 $6532/$6533) | 已验证(簇 0-60、各扇区边界附近、每隔 13 个簇到 3071,读到的值与镜像逐项一致;簇 0 直接返回,`$6532/$6533` 不变) |
|
|
134
|
+
| `$06` | `FS_FREE_SPACE` | 统计空闲空间:从 ERAM `$6530/$6531` 起逐簇判断,空闲簇的字节数累加到 `$069A-$069C`(3 字节) | 已验证(原样镜像与空闲簇不连续的磁盘,16 个起始簇(含空闲簇跨缓存页边界的簇 2389、簇号上限前后),每簇 1、2 扇区,字节数与镜像中空闲簇数逐项一致;簇号上限以上不计) |
|
|
135
|
+
| `$08` | `FS_SEEK_SECTOR` | 按 `FILE_OFFSET_0-2` 定位到所在扇区:偏移为 0 取句柄起始簇的第一个扇区,否则扇区序号 = 偏移除以 512(从 0 起),沿簇链(每簇按每簇扇区数展开)找第 n 个扇区;扇区号放 ERAM `$653C/$653D`,扇区内偏移(偏移与 `$1FF` 相与)放 `$653E/$653F`;簇链不够长(偏移正好等于簇链总字节数、越过簇链、簇链中间有空闲簇)时出错码 `$11`;用的句柄偏移单元是 ERAM `$6564`(`$7C/$05`、`$7C/$06` 自己会置好,直接调 `$7B/$08` 时要先写) | 已验证(FRAG.BIN 的 15 个簇不连续(含倒退),每簇 1、2、4 扇区,44 个偏移) |
|
|
136
|
+
| `$0C` | `FS_ALLOC_FOR_SIZE` | 按 `FILE_SIZE_0-2` 算出需要的簇数,为句柄补足簇链:首簇已有,只追加不足的簇;新簇从 ERAM `$6530/$6531`(空闲簇提示)起按编号递增找空闲簇,跳过非空闲的簇,末尾接链尾 `$FFF`;大小为 0 时“所需簇数减 1”回绕成 65535,会把整张盘分完报 `$2C`(代码阅读;`$7C/$10` 已先拒绝大小 0) | 已验证(空闲簇不连续的磁盘上大小 1、512、513、1024、1025、3000、4096 字节,簇链长度、簇的顺序与链尾都正确) |
|
|
137
|
+
| `$0D` | `FS_SIZE_TO_UNITS` | 把 `$069A-$069C` 的字节数换算成扇区数(`$069D/$069E`)、簇数(`$069F/$06A0`)、页数(`$06A1/$06A2`,每页 8 个扇区),都向上取整(16 位回绕,所以 `$FFFFFF` 字节的扇区数回绕成 0);簇数按参数块里“每簇扇区数的移位数”(`$64FC`)右移后,再按“每簇扇区数 − 1”与扇区数低字节相与不为 0 加 1 | 已验证(每簇 1、2、4、8 扇区各 14 种大小) |
|
|
138
|
+
| `$0E` | `FS_TRANSFER_CHAIN` | 沿簇链成批读写磁盘:从 ERAM `$6536/$6537` 的簇起共 `$6577/$6578` 个簇,把物理上连续的簇合并成一次磁盘调用;ERAM `$657B` 位 7 为 1 时写(`$80/$05`),否则读(`$80/$04`);簇链提前结束或中间遇到空闲簇时出错码 `$11`;中间遇到坏簇 `$FF7` 不会出 `$11`:它把坏簇的值当作下一簇号继续读,最后读到盘外,返回磁盘出错码(实测 `$10`) | 已验证(读整个文件、按偏移读、按偏移写,簇链不连续的文件与空闲簇不连续的写入;簇链过短、中间有空闲簇、中间有坏簇) |
|
|
139
|
+
| `$0F` | `FS_FAT_SET` | 写 FAT12 项:簇号在 ERAM `$6536/$6537`,新值(12 位)在 `$6534/$6535`,只写进 FAT 缓存(偶数簇改低字节与相邻字节的低半字节,奇数簇改高 12 位,跨扇区的项两个扇区都改),到 `$7B/$10` 才写到磁盘 | 已验证(19 个簇号 × 9 种值,缓存与按 FAT12 规范改写的 FAT 逐字节一致,`$7B/$05` 读回同值) |
|
|
140
|
+
| `$10` | `FS_FAT_WRITE_BACK` | 把 FAT 缓存(页 `$F5` 起,跳过引导扇区)整体写回磁盘,依次写两份 FAT;第二份与第一份不同时也被缓存内容覆盖成一致 | 已验证(改过 171 次的缓存写回后两份 FAT 与缓存一致、其余扇区不变;第二份 FAT 被特意弄乱时写回后与第一份一致) |
|
|
141
|
+
| `$11` | `FS_LBA_TO_CHS` | 把 `FS_LBA` 换算成磁道、磁头、扇区(每磁道 18 扇区、2 个磁头,扇区号从 1 起)放进 `DISK_TRACK`、`DISK_HEAD`、`DISK_SECTOR`,`FS_LBA` 不变;磁道按 8 位回绕(扇区号不小于 9216 时) | 已验证(16 个扇区号) |
|
|
142
|
+
|
|
143
|
+
**软驱出错时文件服务的行为**(已验证,用模拟器的 `fdc` 命令注入故障;状态码与 `DISK_STATUS` 的对应见 5.2 节):`$7B/$01` 读扇区(不经 FAT 缓存时)、`$7B/$02` 写扇区、`$7B/$10` 写回 FAT、`$7C/$0E` 读引导扇区、`$7C/$0F` 读整个文件、`$7C/$10` 写整个文件,磁盘读写失败时 `DOS_ERROR` 就是 `DISK_STATUS`(`$1A`、`$18`、`$15`、`$17`、写保护时 `$13`)。**例外**:`$7B/$01` 在 FAT 缓存还没装入时要先整体装入 10 个扇区,这一步失败时 `DOS_ERROR` 仍为 0(出错码没有传出来,只有 `DISK_STATUS` 里是状态码),而且缓存有效标志(`$6585`)已先置成 `$80`,缓存里是没读到的旧内容,之后的调用把它当有效缓存用。`$7C/$0F` 读整个文件时磁盘服务按方式 `$80` 工作,文件里排在出错扇区前面的扇区已读入目的页,出错扇区及之后的保持原样;簇链里的下一簇是坏簇 `$FF7` 时同样,链里已有的簇读入,之后保持原样。
|
|
144
|
+
|
|
145
|
+
**FAT 项读写的边界输入**(已验证,按汇编逻辑转录):FAT 缓存只有 9 个 FAT 扇区,簇号不小于 3072(FAT 项偏移 = 簇号 × 1.5 取整,所在扇区序号不小于 9)时,`$7B/$05` 读不到项,`DOS_ERROR` 为 0,`$6532/$6533` 里留的是这个偏移本身;`$7B/$0F` 写不进缓存,什么也不改,`DOS_ERROR` 为 0;偏移按 16 位算,进位丢弃(簇 43691 起会折回缓存范围,没有专门验证)。`$7B/$0F` 的新值超过 12 位时:偶数簇把新值的高字节整个或进相邻字节(污染相邻簇的低半字节),奇数簇的新值左移 4 位,最高半字节被丢弃。
|
|
146
|
+
|
|
147
|
+
**目录写满时创建文件**(已验证):子目录的目录簇写满 16 项时,创建文件先给目录再分配一个簇(新簇清 0 并写盘),再给文件分配簇;后一步因空闲簇用完失败(出错码 `$2C`)时,目录扩展不回滚:磁盘上目录多了一个空簇,文件没有创建,FAT 两份一致。只读目录(属性 `$11`)用 `$7D/$03` 删除出错码 5,磁盘不变。
|
|
148
|
+
|
|
149
|
+
磁盘按 FAT12 格式管理:簇号 ×1.5 得到 FAT 里的字节偏移,奇数簇取高 12 位。每个盘的参数块(每簇扇区数、FAT 扇区数、数据区起始扇区、簇总数等)在 ERAM `$64FB` 起,A 盘偏移 0,其他盘偏移 `$19`:`+0` 每簇扇区数,`+1` 它的移位数,`+2` 根目录项数(低字节),`+3` 每个 FAT 的扇区数,`+4` 数据区起始扇区,`+5` FAT 部分扇区数(含引导扇区,即 2 × 每个 FAT 的扇区数 + 1),`+6` 根目录扇区数,`+7/+8` 簇号上限(簇总数 + 2);卷序列号在 `$64EC` 起 4 字节、卷标在 `$64F0` 起 11 字节(由 `$7C/$0E` 填写);FAT 缓存里的第 0-9 个扇区是引导扇区与 9 个 FAT 扇区。内部还有分配簇链、找空闲簇、扇区号换算簇号等例程(`FS_ALLOC_CHAIN`、`FS_FIND_FREE_CLUSTER`、`FS_LBA_TO_CLUSTER`),程序用 4.5 节的高层服务就够了。
|
|
150
|
+
|
|
151
|
+
### 4.5 功能 `$7C`(17 个子功能,作用在已打开的句柄上)
|
|
152
|
+
|
|
153
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
154
|
+
| --- | --- | --- | --- |
|
|
155
|
+
| `$00` | `FS_OPEN_CALL` | 调用 `FS_OPEN`,方式由调用者先写 `FILE_MODE`(调用后不停转) | 已验证 |
|
|
156
|
+
| `$01` | `FS_OPEN_MODE1` | 以方式 1 打开 | 已验证 |
|
|
157
|
+
| `$02` | `FS_CLOSE_FLUSH` | 关闭句柄,再调用磁盘服务 `$80/$07`(软驱停转) | 已验证 |
|
|
158
|
+
| `$03` | `FS_OPEN_MODE3_CLOSE` | 以方式 3 打开再关闭(删除文件:目录项标为已删除、簇链释放),再调用 `$80/$07` | 已实测 |
|
|
159
|
+
| `$07` / `$08` | `FS_SET_DATE` / `FS_GET_DATE` | 设置、取得句柄的日期(`FILE_DATE_LO/HI`);设置前校验,非法时出错码 `$25`、句柄不变:年(自 1980 起)不超过 119(即 2099)、月 1-12、日从 1 到当月天数,二月按自 1980 起的年数能被 4 整除算闰年(29 天);这组子功能直接按 `FILE_HANDLE_OFFSET` 访问句柄表,不检查句柄是否已打开,设置只改句柄,方式 1、2、5 的句柄关闭时才写回目录项(方式 0 关闭不写回) | 已验证(9 个年份 × 16 个月份值 × 6 个日,四个句柄偏移轮换,取日期与 14 个文件的目录项一致;方式 2 关闭后目录项已更新) |
|
|
160
|
+
| `$09` / `$0A` | `FS_SET_TIME` / `FS_GET_TIME` | 设置、取得句柄的时间(`FILE_TIME_LO/HI`);设置前校验,非法时出错码 `$25`、句柄不变:秒的一半(位 0-4)不超过 29、分(位 5-10)不超过 59、时(位 11-15)不超过 23 | 已验证(秒、分、时各自扫描全部取值再取边界值组合;取时间与目录项一致) |
|
|
161
|
+
| `$0B` / `$0C` | `FS_SET_ATTR` / `FS_GET_ATTR` | 设置、取得句柄的属性(`FILE_ATTR`);大于 `$3F` 或带卷标位 `$08` 时出错码 `$25`、句柄不变;属性 `$01` 是只读:只读文件用 `$7C/$03` 或方式 3 删除出错码 5,方式 1 打开则不检查只读,直接覆盖并把属性恢复为 `$20` | 已验证(属性 `$00-$FF` 全部取值;写回目录项;只读文件的删除与覆盖) |
|
|
162
|
+
| `$0D` | `FS_GET_SIZE` | 取文件大小到 `FILE_SIZE_0-2` | 已确认 |
|
|
163
|
+
| `$0F` | `FS_READ_FILE` | 把整个文件读入扩展 RAM,起始页号取 `FILE_START_PAGE`,调用者要先用 `$7E/$00` 分配页;要求方式 0,否则出错码 `$28`;文件为空时直接成功;簇链比文件大小短或中间有空闲簇时出错码 `$11` | 已验证(FRAG.BIN、ALT.BIN 整个读,SHORT.BIN、MID.BIN 出错码 `$11`);`play`、`show` 实机运行 |
|
|
164
|
+
| `$10` | `FS_WRITE_FILE` | 把扩展 RAM 页里的内容整个写入文件,页号取 `FILE_START_PAGE`;要求方式 1,否则出错码 `$28`;`FILE_SIZE_0-2` 为 0 时出错码 `$25`;磁盘空间不够时出错码 `$2C`(已写入的其他文件完好、FAT 一致、没有簇泄漏) | 已验证(13 种长度 1-20000 字节、覆盖更大与更小的已有文件、子目录里创建、写满磁盘、空闲簇不连续的磁盘上写 3000、20000 字节);`copy` 实机运行 |
|
|
165
|
+
| `$05` | `FS_READ_AT` | 按偏移与长度从句柄读数据到扩展 RAM 页:偏移在 `FILE_OFFSET_0-2`(`$6565-$6567`,不需要对齐扇区),长度在 `FILE_SIZE_0-2`(不能为 0,否则出错码 `$25`),目的页在 `FILE_START_PAGE`,数据从目的页页首开始放;句柄方式要小于 3(否则出错码 `$28`);偏移不小于文件大小,或“偏移加长度”超过文件大小时出错码 `$14`(最后不足的部分不会被截短读入) | 已验证(簇链不连续的文件上 13 种偏移与长度;SHORT.BIN 簇链过短时偏移落在链外出错码 `$11`、超过文件大小 `$14`);`peek` 实机运行:偏移 0、跨扇区、不对齐、文件末尾边界、越界 |
|
|
166
|
+
| `$06` | `FS_WRITE_AT` | 按偏移与长度把扩展 RAM 页的数据写入句柄:参数同 `$7C/$05`(`FILE_OFFSET_0-2`、`FILE_SIZE_0-2`、`FILE_START_PAGE`);句柄方式为 0 或不小于 3 时出错码 `$28`;方式 1 的新文件第一次写入时分配簇 | 已验证(簇链不连续的 FRAG.BIN 上 8 段跨扇区、跨簇的写入,镜像只有这些字节变化);`poke` 实机运行:方式 2 打开 800 字节文件,偏移 5 写 5 字节、偏移 `$1FE` 写 3 字节跨扇区,取出镜像逐字节比对一致 |
|
|
167
|
+
| `$0E` | `FS_READ_BOOT_SECTOR` | 驱动器字母(ERAM `$6562`)必须是 A 或 B(大小写均可)否则出错码 `$0F`;读引导扇区,只接受 1.44MB 格式:每扇区 512 字节、每簇 1/2/4/8 扇区、保留 1 扇区、2 份 FAT、根目录项数低字节非 0 且高字节为 0、总扇区数 2880、每个 FAT 的扇区数非 0 且不超过 120(FAT 部分加根目录要在 255 扇区之内),任何一项不合格出错码 `$0E`(按检查顺序已写入的参数单元保留,例如每簇扇区数先于检查写入 `$64FB`);成功时记下参数块(见 4.4 节末尾,`$64FB-$6503`)、卷序列号(`$64EC` 起,引导扇区偏移 `$27-$2A` 反序)和卷标(`$64F0` 起 11 字节) | 已验证(38 例,含各字段不合格);读盘失败时出错码就是磁盘状态(已验证,取盘 `$1A`、没有索引脉冲 `$18`、控制器不响应 `$15`、引导扇区校验错 `$17`) |
|
|
168
|
+
| `$04` | `FS_RENAME` | 重命名:句柄要以方式 2 打开(否则出错码 `$28`,句柄空闲时 `$2E`),新名称(8+3)取自 `PATH_BUFFER`;先以方式 0 查新名,已存在出错码 `$20`,新名称含非法字符 `$27`),不存在才改写目录项并更新句柄里的名称(`MOVE` 使用,新名称的 8+3 暂存在 ERAM `$65B8` 起) | 已验证 |
|
|
169
|
+
|
|
170
|
+
### 4.6 功能 `$7D`(4 个子功能,目录与名称)
|
|
171
|
+
|
|
172
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
173
|
+
| --- | --- | --- | --- |
|
|
174
|
+
| `$00` | `FS_FIND_ENTRY_FLUSH` | 同 `$7B/$0B`(设置当前目录),再调用 `$80/$07` | 同 `$7B/$0B`(内部共用代码) |
|
|
175
|
+
| `$01` | `FS_FORMAT_NAME` | 把 `DIR_NAME83` 的 8+3 名称整理成以 0 结尾的 `\NAME.EXT`(没有扩展名时不加点),放到 `PATH_BUFFER` | 已验证(6 例) |
|
|
176
|
+
| `$02` | `FS_MAKE_DIR` | 以方式 5 创建目录,写入“.”与“..”两项,再调用 `$80/$07`;目录已存在 `$26`、同名文件 `$2D`、父目录不存在 3、名称非法 `$27`、在子目录里再建目录 `$2A`(只支持一级子目录) | 已验证(属性 `$10`、占 1 个簇、“.”指向自己、“..”指向 0、其余全 0;子目录里创建、读回文件;目录项超过 16 项时目录簇链扩到 2 个簇) |
|
|
177
|
+
| `$03` | `FS_REMOVE_DIR` | **删除目录**:以方式 4 打开,目录非空出错码 `$29`,只读目录出错码 5,否则释放簇链并把目录项首字节改成 `$E5`,再调用 `$80/$07`;对普通文件出错码 `$2D`(删文件用 `$7C/$03`),路径不存在出错码 3 | 已验证(空目录、非空目录、先删文件再删目录、文件、不存在) |
|
|
178
|
+
|
|
179
|
+
文件名里不能出现的字符:问号、星号、空格、逗号、小于、大于、冒号、分号、单引号、方括号、花括号、反斜杠、竖线、加号、等号、斜杠、双引号(表在 `FS_BAD_NAME_CHARS`)。
|
|
180
|
+
|
|
181
|
+
### 4.7 读文件的标准顺序(已确认,`play`、`show` 实机运行)
|
|
182
|
+
|
|
183
|
+
完整示例见示例程序 `show`(DOS 下输入 `show 文件名`,显示文件开头 90 个字节;含参数读取、出错时先释放再关闭、显示出错码)。
|
|
184
|
+
|
|
185
|
+
```asm
|
|
186
|
+
; 1. 路径写入 PATH_BUFFER($6543),以 0 结尾
|
|
187
|
+
LDA #0
|
|
188
|
+
STA FILE_MODE ; 方式 0
|
|
189
|
+
LDA #$7B
|
|
190
|
+
STA SYS_FUNCTION
|
|
191
|
+
LDA #$09
|
|
192
|
+
STA SYS_SUBFUNCTION
|
|
193
|
+
JSR $FFF0 ; 打开;之后检查 DOS_ERROR
|
|
194
|
+
; 2. 取文件大小
|
|
195
|
+
LDA #$7C
|
|
196
|
+
STA SYS_FUNCTION
|
|
197
|
+
LDA #$0D
|
|
198
|
+
STA SYS_SUBFUNCTION
|
|
199
|
+
JSR $FFF0 ; 大小在 FILE_SIZE_0-2
|
|
200
|
+
; 3. 按 ceil(大小 / 4096) 分配页
|
|
201
|
+
; 页数写 ALLOC_COUNT($65A6),调用 $7E/$00,起始页号在 ALLOC_START($65A7)
|
|
202
|
+
; 4. 起始页号写 FILE_START_PAGE($656B),调用 $7C/$0F 读入整个文件
|
|
203
|
+
; 5. 关闭:$7B/$0A;释放页:$7E/$01
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
每一步之后都要读 `DOS_ERROR`,0 为成功。
|
|
207
|
+
|
|
208
|
+
只需要文件中的一段时,把第 4 步换成“写 `FILE_OFFSET_0-2`、`FILE_SIZE_0-2`(长度)、`FILE_START_PAGE`,调用 `$7C/$05`”,页只需要分配能放下这段数据的个数(见 `peek`,分配 1 页读 30 个字节)。
|
|
209
|
+
|
|
210
|
+
### 4.8 写文件的标准顺序(已确认,`copy` 实机运行)
|
|
211
|
+
|
|
212
|
+
1. 路径写入 `PATH_BUFFER`,`FILE_MODE` 写 1,调用 `$7B/$09` 创建文件(已存在则覆盖),检查 `DOS_ERROR`。
|
|
213
|
+
2. 要写的内容放在已分配的扩展 RAM 页里(页的分配与读入见 4.7);把长度写入 `FILE_SIZE_0-2`、起始页号写入 `FILE_START_PAGE`,调用 `$7C/$10`。`$7B/$09` 与读文件的调用会用到这几个单元(读文件会把大小写入 `FILE_SIZE_0-2`),所以要在调用 `$7C/$10` 之前才写。
|
|
214
|
+
3. 调用 `$7B/$0A` 关闭:方式 1 的句柄关闭时才把目录项(大小、起始簇)写回磁盘(代码阅读),程序里不要省略。
|
|
215
|
+
4. 调用 `$80/$07` 让软驱停转。
|
|
216
|
+
|
|
217
|
+
不能写长度为 0 的内容(出错码 `$25`);复制空文件时只做第 1、3 步,得到一个空文件(已实测)。新建文件的日期时间取 DOS 当前日期时间;覆盖已存在的文件时也会更新目录项的日期。
|
|
218
|
+
|
|
219
|
+
只改已有文件的一段时,把第 1 步的 `FILE_MODE` 改成 2,把第 2 步换成“写 `FILE_OFFSET_0-2`、`FILE_SIZE_0-2`(长度)、`FILE_START_PAGE`,调用 `$7C/$06`”,再关闭;文件大小不变(见 `poke`,跨扇区写入已实测)。
|
|
220
|
+
|
|
221
|
+
## 5. 内存页服务(功能 `$7E`,页组 `$5C`)
|
|
222
|
+
|
|
223
|
+
扩展 RAM 页由 ERAM `$6586` 起 32 字节的位图管理(位为 1 表示空闲):
|
|
224
|
+
|
|
225
|
+
| 子功能 | 作用 | 可靠程度 |
|
|
226
|
+
| --- | --- | --- |
|
|
227
|
+
| `$7E/$00` | 按 `ALLOC_COUNT`(`$65A6`)个页数找连续空闲页(位图从页 0 找起,位 7 是最小页号),占用它们,起始页号放 `ALLOC_START`(`$65A7`),`ALLOC_COUNT` 保持原值;没有则出错码 8、起始页号清 0;`ALLOC_COUNT` 为 0 时只返回第一个空闲页号,不占用(没有空闲页同样出错码 8) | 已验证(位图、临时单元逐字节与模型一致) |
|
|
228
|
+
| `$7E/$01` | 释放 `ALLOC_START` 起 `ALLOC_COUNT` 个页(位图置 1);起始页号小于 `$80` 或不小于 `$F0` 时出错码 9、什么都不做;不检查起始页号加页数是否越过页 `$FF`(越过会写到位图后面的 `ALLOC_COUNT` 等单元);调用后 `ALLOC_COUNT` 被清成 0 | 已验证(`show` 实机运行) |
|
|
229
|
+
| `$7E/$02` | 求最长连续空闲页数,放 `ALLOC_COUNT`;计数是 8 位,256 页全部空闲时结果回绕成 0 | 已验证 |
|
|
230
|
+
|
|
231
|
+
`$7E/$00`、`$7E/$02` 会把 `$6308`(`LIB_GROUP`)与 `$6309-$630B` 当临时变量改写,之后调用运行库显示字符串前要重新写 `$6308`。
|
|
232
|
+
|
|
233
|
+
## 5.1 日期、时间与运行程序(功能 `$7F`,页组 `$5C`)
|
|
234
|
+
|
|
235
|
+
日期、时间用 FAT 格式(见第 4.1 节的 `FILE_DATE_LO/HI`、`FILE_TIME_LO/HI`)。系统时钟的原始值放在 `$068A` 秒、`$068B` 分、`$068C` 时,系统日期放在 ERAM `$6305` 日、`$6306` 月、`$6307` 年(自 1980)。
|
|
236
|
+
|
|
237
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
238
|
+
| --- | --- | --- | --- |
|
|
239
|
+
| `$7F/$00` | `EXEC_PROGRAM` | 运行程序:路径放 `PATH_BUFFER`;按文件大小(向上取整到 4096 字节)分配页并读入,检查文件偏移 3、4 的魔数 `AA 55`(不符出错码 `$3E`,页已释放、句柄已关闭、程序没有运行),把起始页号与页数写进程序的偏移 5、6,再从 `$8000` 经功能 `$25` 调用;返回后 `DOS_ERROR` 清 0、关闭文件、释放页;出错时先关闭已打开的句柄、释放已分配的页,最后出错码 `$2D` 改成 2,并调用 `$80/$07` 停转 | 已验证(7 例:1 页、恰好 4096、4097、3 页、两种魔数不符、文件不存在) |
|
|
240
|
+
| `$7F/$01` | `SET_DATE` | 用 `FILE_DATE_LO/HI` 设置系统日期(ERAM `$6305` 日、`$6306` 月、`$6307` 年)并清 `$068D`(过午夜标志);先校验:年号不大于 `$77`、月 1-12、日 1 到当月天数(二月按年号能被 4 整除算 29 天,不处理世纪年),非法时出错码 `$25`、系统日期不变 | 已验证 |
|
|
241
|
+
| `$7F/$02` | `GET_DATE` | 取系统日期到 `FILE_DATE_LO/HI`;`$068D` 非 0(过了午夜)时先把系统日期加一天(含月、年进位,年号最大 `$77`)并清 `$068D` | 已验证(含月末、闰年、年末、年号上限的进位) |
|
|
242
|
+
| `$7F/$03` | `SET_TIME` | 用 `FILE_TIME_LO/HI` 设置系统时间(`$068A` 秒 = 低 5 位 × 2、`$068B` 分、`$068C` 时);先校验:秒的一半不大于 29、分不大于 59、时不大于 23,非法时出错码 `$25`、系统时间不变 | 已验证 |
|
|
243
|
+
| `$7F/$04` | `GET_TIME` | 取系统时间到 `FILE_TIME_LO/HI`(秒取一半丢掉奇偶位) | 已验证 |
|
|
244
|
+
|
|
245
|
+
## 5.2 磁盘服务(功能 `$80`,页组 `$5C`)
|
|
246
|
+
|
|
247
|
+
软驱是 1.44MB:每道 18 扇区、2 面、80 道,扇区 512 字节。参数块在 ERAM `$6200` 起,结果状态放 `DISK_STATUS`(`$6208`,0 表示成功):
|
|
248
|
+
|
|
249
|
+
| 变量 | 地址 | 含义 |
|
|
250
|
+
| --- | --- | --- |
|
|
251
|
+
| `DISK_HEAD` | `$6200` | 面,0 或 1 |
|
|
252
|
+
| `DISK_SECTOR` | `$6201` | 起始扇区,1-18 |
|
|
253
|
+
| `DISK_TRACK` | `$6202` | 磁道,0-79 |
|
|
254
|
+
| `DISK_PAGE` | `$6203` | 缓冲所在的扩展 RAM 页号(读写时映射到 `$B000` 窗口) |
|
|
255
|
+
| `DISK_PAGE_SECTOR` | `$6204` | 缓冲从页内第几个 512 字节开始,0-7 |
|
|
256
|
+
| `DISK_COUNT_LO/HI` | `$6205/$6206` | 扇区数(16 位) |
|
|
257
|
+
| `DISK_MODE` | `$6207` | 方式:`$80` 出错时立即返回,`$01` 用于单扇区(不检查扇区数),其他值出错时跳过该扇区继续 |
|
|
258
|
+
| `DISK_STATUS` | `$6208` | 结果状态,0 成功 |
|
|
259
|
+
|
|
260
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
261
|
+
| --- | --- | --- | --- |
|
|
262
|
+
| `$80/$00` | `DISK_INIT` | 启动软驱、复位到 0 磁道,读出状态后停转;失败时 `DISK_STATUS` 为 `$15` | 已验证(成功路径;控制器不响应时状态 `$15`) |
|
|
263
|
+
| `$80/$02` | `DISK_READ_SECTOR_BUFFER` | 按面、扇区、磁道读一个扇区到 ERAM `$6000` 缓冲;先检测盘片(`$18`、`$1A`,见下) | 已验证(各种故障与坏扇区) |
|
|
264
|
+
| `$80/$03` | `DISK_WRITE_SECTOR_BUFFER` | 把 ERAM `$6000` 缓冲写入指定扇区;先检测盘片;写保护时状态 `$13` | 已验证(各种故障) |
|
|
265
|
+
| `$80/$04` | `DISK_READ_SECTORS` | 从起始扇区连续读 `DISK_COUNT` 个扇区到 `DISK_PAGE` 页内的缓冲,扇区号递增,满 18 换面,两面满换磁道;先检测盘片;方式 `$80` 时遇到出错的扇区立即返回,状态是该扇区的出错码(`$17` 等),前面读好的扇区留在缓冲里,之后的不读;方式 0 时跳过出错的扇区继续读,最后状态为 0(出错被吞掉,没读到的扇区缓冲保持原样) | 已验证(坏扇区在连读中的两种方式与各种故障) |
|
|
266
|
+
| `$80/$05` | `DISK_WRITE_SECTORS` | 连续写,参数同 `$80/$04`;先检测盘片;写保护时状态 `$13` 并立即停止(不论方式) | 已验证(各种故障) |
|
|
267
|
+
| `$80/$06` | `DISK_START` | 启动软驱,未就绪时 `DISK_STATUS=$15` | 已验证(成功路径;控制器不响应时状态 `$15`) |
|
|
268
|
+
| `$80/$07` | `DISK_STOP` | 软驱停转;每次文件、目录操作之后都会调用 | 代码阅读 |
|
|
269
|
+
| `$80/$08` | `DISK_SCAN_TRACK` | 按 `DISK_HEAD`、`DISK_TRACK` 逐个读该磁道的 18 个扇区(命令 `$66`),读不出的扇区在 `$6237-$6239` 的位图里置位(`$6237` 位 7 起对应扇区 1-8,`$6238` 对应 9-16,`$6239` 对应 17、18),位图先清 0;磁头不小于 2 或磁道不小于 80 时状态 `$10` | 已验证(完好磁道与参数越界;坏扇区位图 1 个、边缘 6 个、全部 18 个坏扇区,位图与按上述对应关系算出的一致)。扫描不先检测盘片,直接读每个扇区 |
|
|
270
|
+
| `$80/$01` | `DISK_FORMAT_TRACK` | 按 `DISK_HEAD`、`DISK_TRACK` 用软驱命令 `$4D`(格式化磁道)处理一个磁道,开头与结尾经功能 `$1E/$07`、`$1E/$08`、`$12`、`$13` 的若干子功能保存与恢复 NMI 开关(`DISK_SAVED_NMI_FLAGS`)与中断屏蔽(`DISK_SAVED_IRQ_MASK`);参数越界时状态 `$10`;先检测盘片;格式化后磁道 0 的 18 个扇区填 `$00`,其他磁道填 `$F6`;FORMAT 程序使用 | 已验证(磁道 0 面 0、磁道 20 面 1、磁道 79 面 0,整条磁道变成填充字节,其余扇区不变;写保护 `$13`、取盘 `$1A`、没有索引脉冲 `$18`、磁头卡住 `$15`) |
|
|
271
|
+
|
|
272
|
+
`DISK_STATUS` 里出现的值:`$10` 参数超出范围,`$13` 磁盘写保护,`$15` 驱动器未准备好,`$17` 循环冗余校验错,`$18` 驱动器中没有磁盘,`$1A` 未知磁盘类型。已验证(用模拟器的 `fdc` 命令让控制器出故障):`$80/$01-$05` 先用 READ ID 命令检测盘片,控制器一直没有中断(相当于盘里没有索引脉冲)时状态 `$18`,控制器报告找不到地址标志(盘型与软驱设定的数据率不符,或盘片取出)时状态 `$1A`;写保护时写和格式化状态 `$13`,读不受影响;读到校验错的扇区状态 `$17`;控制器收到命令字节后不再处理(`$80/$00`、`$06` 的启动设定发不出去)或磁头寻道不到位(目标磁道不是当前磁道时)状态 `$15`;`$80/$08` 与 `$80/$00`、`$06` 不检测盘片(代码阅读)。软驱控制器的寄存器:`$4100`(配置)、`$4101`(控制,写 0 停转、写 `$1C` 启动)、`$4204`(主状态)、`$4205`(数据);读写扇区用程序查询方式逐字节传输。
|
|
273
|
+
|
|
274
|
+
**功能 `$81` 与子功能号越界**(页组 `$5C` 与 `$58` 的分发,已验证):`$81` 只有子功能 0,什么都不做(`DOS_ERROR` 保持调用前的值);子功能号超出范围时 `DOS_ERROR` 置 1(`$7B` 超过 `$13`、`$7C` 超过 `$10`、`$7D` 超过 3、`$7E` 超过 2、`$7F` 超过 4、`$80` 超过 8、`$81` 超过 0),`$80` 越界时 `DISK_STATUS` 保持原值。`$7B-$7D` 与 `$7E`、`$7F` 在范围内的调用会先把 `DOS_ERROR` 清 0,`$80` 先把 `DISK_STATUS` 清 0。
|
|
275
|
+
|
|
276
|
+
## 5.3 键盘输入服务(功能 `$6B`,内核)
|
|
277
|
+
|
|
278
|
+
键盘经 `$4020-$4022` 串行收发,扫描码按 IBM 扫描码集 1 的按下码处理(`$E0`、`$E1` 前缀的扩展键也认)。`KBD_HANDLER` 读到扫描码后,按修饰键状态查映射表,把一个按键转成 2 个字节(ASCII,扫描码)放入按键队列。
|
|
279
|
+
|
|
280
|
+
| 变量 | 地址 | 含义 |
|
|
281
|
+
| --- | --- | --- |
|
|
282
|
+
| `KEY_QUEUE` | `$0336` | 按键队列,12 字节的环形队列,每个按键 2 字节(ASCII 在前、扫描码在后),实际只能存 5 个按键(留一个空位区分满与空,第 6 个起被丢弃,已实测) |
|
|
283
|
+
| `KEY_READ_INDEX` / `KEY_WRITE_INDEX` | `$0342` / `$0343` | 读、写指针(字节偏移,到 12 回绕);队列满时新按键被丢弃 |
|
|
284
|
+
| `KEY_ASCII` | `$034B` | 取到的按键的 ASCII 码,没有字符的键(功能键、方向键等)为 0 |
|
|
285
|
+
| `KEY_SCAN` | `$034C` | 取到的按键的扫描码;功能键与 Ctrl、Alt 组合使用 IBM 扩展码(如 F1 是 `$3B`,Ctrl+F1 是 `$5E`,Alt+F1 是 `$68`) |
|
|
286
|
+
| `KBD_FLAGS` | `$0344` | 修饰键状态:位 0 右 Shift,位 1 左 Shift,位 2 Ctrl,位 3 Alt,位 4 ScrollLock,位 5 NumLock,位 6 CapsLock,位 7 Insert |
|
|
287
|
+
| `KBD_LEDS` | `$0348` | 指示灯状态:位 0 ScrollLock,位 1 NumLock,位 2 CapsLock |
|
|
288
|
+
| `ESC_BREAK` | `$063D` | 按 ESC 中断开关,见下 |
|
|
289
|
+
|
|
290
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
291
|
+
| --- | --- | --- | --- |
|
|
292
|
+
| `$6B/$00` | `INPUT_INIT` | 复位键盘与鼠标,清空按键队列 | 代码阅读 |
|
|
293
|
+
| `$6B/$01` | — | `ESC_BREAK` 置 `$FF`:之后按 ESC 会调用功能 `$1D`,恢复功能 `$1C` 保存的上下文(类似 `longjmp`,不返回) | 代码阅读 |
|
|
294
|
+
| `$6B/$02` | — | `ESC_BREAK` 清 0 | 代码阅读 |
|
|
295
|
+
| `$6B/$03` | `KEY_GET_NOWAIT` | 非阻塞取一个按键到 `KEY_ASCII`、`KEY_SCAN`;队列空时两个字节都为 0 | 代码阅读 |
|
|
296
|
+
| `$6B/$04` | `KEY_GET_WAIT` | 一直等到有按键再取,结果同上 | 已确认(`hello` 实机运行) |
|
|
297
|
+
| `$6B/$05` | `KEY_FLUSH` | 清空按键队列 | 代码阅读 |
|
|
298
|
+
| `$6B/$06` | `KEY_COUNT` | 队列里的按键数放到 `KEY_ASCII` | 代码阅读 |
|
|
299
|
+
|
|
300
|
+
映射表(BIOS 内核里,每个扫描码 2 字节:ASCII、扫描码):`KEYMAP_NORMAL`(普通)、`KEYMAP_CAPS`(CapsLock 开)、`KEYMAP_SHIFT`(Shift)、`KEYMAP_CTRL`(Ctrl,如 Ctrl+A 为 `$01`)、`KEYMAP_ALT`(Alt)、`KEYMAP_NUMLOCK`(NumLock 开时的小键盘)。表项里 ASCII 为 `$FE` 表示按小键盘规则处理,`$FD`、`$FF` 表示不产生按键。修改键盘布局就是改这几张表。
|
|
301
|
+
|
|
302
|
+
实测(用模拟器注入按键、读 ERAM 队列):普通、Shift、右 Shift、CapsLock、Shift+CapsLock、Ctrl、Alt、NumLock 关这 8 种状态下,字母、数字行、标点、F1-F10、小键盘、方向等扩展键的翻译与标准 IBM 美式键盘一致(开机后 NumLock 是开的),只有下面几个组合与 IBM 不同:① Ctrl 加上、下、Insert、Delete 与 NumLock 关时的小键盘中间键,队列里会出现 `($FD, 0)`(表里的“不产生按键”标记被当成了按键);② Alt 加小键盘(NumLock 开)给出数字本身的 ASCII 与扫描码,IBM 是不产生按键。修饰键标志 `$0344`、指示灯 `$0348` 随按键变化。`$6B/$00` 清空队列并重新初始化键盘(约 42 帧返回);单独调 `$17`(键盘复位与识别)也能返回,但之后键盘不再上报按键,要再调 `$6B/$00` 才恢复。
|
|
303
|
+
|
|
304
|
+
## 5.4 文字显示与运行库(ROM 页组 0)
|
|
305
|
+
|
|
306
|
+
页组 0 是 DOS 的命令外壳,同时给程序提供显示文字的例程。程序经功能 `$25` 调用:`SYS_GROUP`(`$0642`)写 0,入口地址写 `PROG_ENTRY_LO/HI`(`$0C/$0D`),再 `JSR $FFF0`;例程返回后回到调用者(已确认,`hello` 实机运行)。
|
|
307
|
+
|
|
308
|
+
| 入口 | 例程 | 作用 | 可靠程度 |
|
|
309
|
+
| --- | --- | --- | --- |
|
|
310
|
+
| `$8262` | `LIB_PRINT_STRING` | 在光标处显示 `$4B/$4C` 指向的以 0 结尾的字符串,不移动光标;字符串所在的页组取 `$6308`(`LIB_GROUP`)的高 6 位(程序自己的数据写 `$80`);字符码不小于 `$A1` 的按 GB2312 两字节显示汉字 | 已确认 |
|
|
311
|
+
| `$80E2` | `LIB_NEWLINE` | 换行,行满时滚屏;调用前要把 `CURSOR_COL`(`$630C`)置 1 | 已确认 |
|
|
312
|
+
| `$80CF` | `LIB_CURSOR_RIGHT` | 光标右移一列,到第 32 列回到第 1 列并换行 | 代码阅读 |
|
|
313
|
+
| `$8081` | `LIB_CURSOR_LEFT` | 光标左移一列,到行首移到上一行末尾 | 代码阅读 |
|
|
314
|
+
| `$8047` | `LIB_PRINT_HEX` | 把 A 显示成两位十六进制文字;功能 `$25` 的分发器用页组值覆盖了 A,所以经 `$25` 调用时 A 传不进去,程序里不能用,要显示十六进制就自己转换成字符(见 `show`) | 代码阅读,经 `$25` 不可用 |
|
|
315
|
+
| `$802D` | `LIB_BEEP` | 用方波通道 2 发一声提示音 | 代码阅读 |
|
|
316
|
+
| `$81F4` | `LIB_GET_KEY` | 等待按键(即 `$6B/$04`),结果在 `KEY_ASCII`、`KEY_SCAN` | 代码阅读 |
|
|
317
|
+
| `$8202` | `LIB_PRINT_MESSAGE` | 显示消息号为 `$6308` 的字符串:把 ROM 第 3 页映射到 `$B000`,在 `$B500`(大字体)或 `$B200` 的 3 字节表(页号、地址低、地址高)里查字符串 | 代码阅读 |
|
|
318
|
+
|
|
319
|
+
光标变量在 ERAM:`CURSOR_COL`(`$630C`,列,从 1 开始,每行 32 列)、`CURSOR_ROW`(`$630D`,显示行)、`GLYPH_ROW`(`$630E`,字形缓冲行,由运行库维护,程序不要改,改了会把屏幕上已有的文字改成别的字)、`FONT_SIZE`(`$6428`,选字号)。显示一行最多 32 列(`LIB_CURSOR_RIGHT` 到第 32 列换行)。
|
|
320
|
+
|
|
321
|
+
程序也可以不经运行库,直接调用内核的显示功能 `$3B-$46`(见 5.12 节),参数写在 `$064A-$064F`,但字形与光标要自己管。
|
|
322
|
+
|
|
323
|
+
## 5.5 声音服务(功能 `$65`,内核)
|
|
324
|
+
|
|
325
|
+
功能 `$65` 按子功能号 `$063F`(0-13)查 `SOUND_SUB_TABLE`(14 项)跳转。目前只读懂了一项:
|
|
326
|
+
|
|
327
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
328
|
+
| --- | --- | --- | --- |
|
|
329
|
+
| `$65/$0C` | `SOUND_PLAY_WAV` | 播放内存里的 WAV:`SYS_GROUP`(`$0642`)与 `PROG_ENTRY`(`$0C/$0D`)指向 WAV 文件头(同功能 `$25` 的约定,页组写首页号、地址写窗口地址);从文件头偏移 `$28` 取 4 字节采样长度,按偏移 `$18` 的采样率低字节选速度(`$44` 为 44100 Hz,`$22` 为 22050 Hz,其他按 11025 Hz),跳过 44 字节文件头,把 8 位采样逐字节写到 DAC 寄存器 `$4027`,由定时器 `$4034/$4035` 控制节拍;播放期间屏蔽中断,播完才返回;总采样数按长度的各字节分别加 1 后串联递减计算(进位串到下一字节),通常是“长度 + 1”个,多播一个文件尾后的字节;每个采样先等 `$4033` 非 0,再写 `$4032` 为 `$FF`、`$7F`,然后写 DAC;开始写 `$4034=$C0`、`$4015=$00`,结束写 `$4034=$00`、`$4015=$FF`,最后 `$4034=$EF`、`$4035=$3C`(定时器取值:`$44` 取 `$28`,`$22` 取 `$51`,其他取 `$A2`) | 已验证(8 例,DAC 写入序列、定时器与 APU 状态写入) |
|
|
330
|
+
| `$65/$00`、`$01` | `SOUND_SUB_00`、`SOUND_SUB_01` | 载入并播放一段音乐数据:先关闭声音更新(`$12/$02`),经功能 `$2C` 取出 `SYS_GROUP` 与 `PROG_ENTRY` 指向的数据,复位发声状态后播放曲号 `$7F`,再重新打开声音更新(`$12/$82`);两者只差 `$03A0` 写 0 还是 `$FF` | 已验证(起播后的状态与后续 0-3 帧的模型一致;曲子限用不依赖零页垃圾的声道) |
|
|
331
|
+
| `$65/$02` | `SOUND_SUB_02` | 停止播放:先以曲号 `$FC` 复位(保留 `$03BC`,`$4015` 写 `$00`、`$0F`),再以曲号 `$FD` 起播(`$0499` 置位 6,`$03BC` 取 `$03BB`,`$4015` 写 `$00`),`$0499` 位 7 清 0,关声音更新,`$03A1` 置 `$FF`;`game/GAME.EXE`、`wps/SB-WIN.EXE` 调用过 | 已验证(`$0393-$04A3` 逐字节) |
|
|
332
|
+
| `$65/$03` | `SOUND_SUB_03` | 把 `$03A1` 取到 `$0653` 作为查询结果 | 已验证 |
|
|
333
|
+
| `$65/$04`、`$05` | `SOUND_SUB_04`、`SOUND_SUB_05` | `$04` 把 `$0653` 加到 4 个声道的 `$0447-$044A`;`$05` 把 `$0653` 加到 `$03D4`,结果同步写进 `$03D5`(`$0447-$044A` 是各声道的移调值 `SOUND_TRANSPOSE`,`$03D4/$03D5` 是拍速 `SOUND_TEMPO`,所以 `$04` 调整各声道移调、`$05` 调整拍速) | 已实测(内存语义) |
|
|
334
|
+
| `$65/$06-$08` | `SOUND_SUB_06`-`SOUND_SUB_08` | 写 `$03A4`(0、1、3)后,把 `$0653` 加到 `$03FF+X`;X 是分发时留下的子功能号乘 2,原程序可能漏写了取下标的指令,不建议使用 | 已验证(`$03A4` 与 `$040B`、`$040D`、`$040F` 加 `$0653`,加到的单元与声道号无关是实测行为) |
|
|
335
|
+
| `$65/$09` | `SOUND_SUB_09` | 同 `$00`,但最后不重新打开声音更新。起播的状态变化已逐字节验证:先按曲号 0 复位(`$039B-$049A` 清 0 等,`$4015` 写 `$00`、`$0F`),再置 `$03A6=$FF`、`$04A1`=页号,曲号 `$7F` 起播;曲数据头首字节不小于 `$80` 为音乐格式(`$03BB` 记曲号,`$03D4-$03D6` 置 `$FF`,按声道项初始化),小于 `$80` 为音效格式(首字节是优先级,声道号不小于 4 时写进 `$03BB+声道号`);声道项 3 字节,声道 0-2 的 `$045D=$1E`、`$0466=$96`,声道 0-3 的 `$043F=$F0`、`$0447=0`,音轨指针 = 曲首 + 偏移(带进位),`$03E7=1`、`$03C3=$80`、`$03CB=1`、`$039F=1`、`$0491`、`$03AB` 置 `$FF` | 起播状态已验证(14 例,`$0393-$04A3` 逐字节与 `$4015` 写入);发声部分待验证 |
|
|
336
|
+
| `$65/$0A`、`$0B` | `SOUND_SUB_0A`、`SOUND_SUB_0B` | 按曲目号 `$0653` 播放:`$FF` 时直接播放功能 `$2C` 取得的指针,否则按 3 字节一项的曲目表(页偏移、地址)取曲数据;`$0B` 先复位再播放;`wps/EDIT.EXE`、`wps/SB-WIN.EXE`、`wps/WPS.EXE` 调用过 `$0B`;这两个子功能起播用 `SOUND_START_TRACKS` 且曲号恒为 0,所以只有音效格式的曲子能起播,页放 `$04A3`(音乐声道的 `$04A1` 不设);`$0A` 在 `$0499` 位 7 为 1 时不复位,按优先级与当前声道比较 | 已验证(直接指针、曲目表、带进位偏移、优先级、音乐格式不起播) |
|
|
337
|
+
| `$65/$0D` | `SOUND_SUB_0D` | `$0652` 为重复次数,不为 0 时先调一次功能 `$1B`(X=5),再重复播放 WAV(每遍写定时器与状态寄存器同 `$0C`);播完(含次数为 0)写 `$4015=$FF` | 已验证 |
|
|
338
|
+
|
|
339
|
+
音乐驱动的内部例程:`SOUND_PLAY_SONG`(`$F43A`,按 `$049A` 播放:0 复位,`$FB-$FF` 为控制命令,其余为曲号,曲表指针在 `$D31B` 起)、`SOUND_START_TRACKS`(`$F4C9`)、`SOUND_RESET`(`$F5C4`)、`SOUND_UPDATE_ON`/`SOUND_UPDATE_OFF`(`$F5E9`、`$F5F2`);发声在 NMI 中断里更新。
|
|
340
|
+
|
|
341
|
+
曲子数据与引擎(已验证:实机逐帧与按代码写的模型比对 `$0393-$04A3` 的全部字节、`SOUND_TEMP0-03`,以及写向 APU 寄存器 `$4000-$4013`、`$4015` 的序列):
|
|
342
|
+
|
|
343
|
+
- 曲子有两种头。**音乐格式**:首字节不小于 `$80`,后面是声道项 `[声道号, 音轨偏移低, 偏移高]`(声道号小于 `$80`),以不小于 `$80` 的字节结束;首字节后紧跟一个不小于 `$80` 的字节时,声道项从第 4 字节起。**音效格式**:首字节小于 `$80`,是优先级,后面同样是声道项;第 2 字节不小于 `$80` 时还有 3 字节头(第 3 字节放 `$03BD`,曲号放 `$03BE`,`$0499` 置位 5,用于播完自动接下一首)。声道项里声道号不小于 4 的,优先级写进 `$03BB+声道号`,优先级小于当前 `$03BB+声道号` 时整首不起播;音乐格式的曲子曲号与 `$03BB` 相同时也不起播(`$65/$0A`、`$0B` 的曲号恒为 0,所以音乐格式的曲子用它们起不了播,要用 `$00`、`$01`、`$09`)。
|
|
344
|
+
- 音轨偏移相对曲首(`$039B/$039C`,音效格式是 `$039D/$039E`);声道 0-3 是音乐声道,4-7 是音效声道,音效声道与同号后四位的音乐声道共用一个硬件声道,音效声道播放时(`$03CF+声道号` 非 0)音乐声道不写 APU。音乐声道读曲子的页放 `$04A1`(`$00`、`$01`、`$09` 设置),音效声道的页放 `$04A3`(`$0A`、`$0B` 设置)。
|
|
345
|
+
- 每帧更新(NMI,要求 `$0630` 位 6 与 `$0499` 位 7 为 1):先处理音效声道 7 到 4(时长减 1,减到 0 读音轨,刷新寄存器),再(`$0499` 位 6 为 0 时)处理音乐声道 3 到 0 的颤音、寄存器刷新与包络,然后 `$03D6` 加 `$03D4`,有进位的这一帧音乐声道的时长才减 1。声道 0 的状态位 `$03C3`:位 7 静音、位 6 写寄存器 0-1、位 5 写音高、位 3 写音量、位 2 写寄存器 1、位 4 发声、位 1 音效声道写寄存器 2-3 与 0、位 0 滑音(颤音用)。
|
|
346
|
+
- 音轨字节:`$00-$3F` 时长(音乐声道乘 `$043F` 的高字节得释放计数;音效声道直接作倒计时),`$40-$BF` 音符(音乐声道加 `$0447` 与全局移调 `$0393`,音符不小于 `$80` 时后跟 1 个扩展字节:位 6 把释放计数限到 `$043B`,位 7 持续发声,位 5 置 `$03CB` 位 2),`$C0-$E4` 命令:
|
|
347
|
+
|
|
348
|
+
| 命令 | 参数个数 | 作用 |
|
|
349
|
+
| --- | --- | --- |
|
|
350
|
+
| `$C0`、`$C1` | 1 | 直接设音符值(`$C1` 在原值上加参数),不等待 |
|
|
351
|
+
| `$C2`、`$C3` | 1 | 设置、有符号累加音高微调 `$03F7`(溢出向音符 `$03EF` 进位或借位) |
|
|
352
|
+
| `$C4`、`$C5` | 1 | 设置、累加音量 `$03FF` |
|
|
353
|
+
| `$C6`、`$C8` | 1 | 写 `$0443`、`$043B` |
|
|
354
|
+
| `$C7` | 1 | 写 `$043F` 并按当前时长重算释放计数 |
|
|
355
|
+
| `$C9` | 0 | 休止:`$03A3` 置本声道位,倒计时重装,本声道静音 |
|
|
356
|
+
| `$CA`、`$CB` | 0 | `$03C3` 置位 4(发声)、位 7(静音) |
|
|
357
|
+
| `$CC` | 1 | 设拍速 `$03D4`、`$03D5` |
|
|
358
|
+
| `$CD` | 2 | 设乐器:第 1 个参数选表、第 2 个参数是项号,每项 4 个字节 [包络表地址, 寄存器 0 与 `$30` 相或, 寄存器 1],实际地址是表地址加项号 ×4 的低 8 位。第 1 个参数位 7 为 1 时换入 `$04A2` 指定的第二页,从零页 `$04/$05` 指向的指针表(窗口地址,每项 2 字节,引擎只读不写,要由调用者先设置)取低 6 位选中的表,读完换回 `$04A1` 的音乐页(音效页与它不同时,音效声道后面的字节就取自音乐页);否则位 6 为 1 时查 ROM `$CFEF` 的表,位 6 为 0 时查 ROM `$D0D3` 的表。音乐声道 0、1 与音效声道 4、5、7 有效,声道 0、1 另把第 1 个参数存入 `$03B5+声道`(位 7 为 1 时包络每帧也换入第二页处理);三角波声道(2、6)只跳过 2 个参数;噪声声道(3)不查乐器表:第 1 个参数低 6 位选 ROM `$CFEF` 的一项存为噪声表指针,噪声寄存器 0 影子置位 `$30`,然后 X 被改成(参数低 6 位 × 2),之后同一段音轨字节按这个“声道”解释,音轨位置也存到它的位置单元,噪声声道自己的位置不前进,不要用(已验证) |
|
|
359
|
+
| `$CE`、`$CF` | 3 | 计数循环:次数、跳转偏移(16 位,相对曲首),次数到了跳过偏移 |
|
|
360
|
+
| `$D0` | 0 | 停曲:`$03A0` 为 0 时写 `$4015`、`$039F` 清 0、`$03A1`=`$FF`、关声音更新;`$03A0` 非 0 时重新初始化全部声道并结束本帧;不管哪种,执行后 X 都变成不小于 4,音轨指针写到声道 4 的槽里,本帧后面的音乐声道会再处理一遍 |
|
|
361
|
+
| `$D1`、`$D2` | 4、0 | `$D1` 设循环:跳转偏移与终点偏移,音轨指针到终点时回到 `$D1` 之后;`$D2` 回到该位置 |
|
|
362
|
+
| `$D3` | 0 | 停本声道(音乐声道全停后 `$0499` 位 1 清 0;音效声道会把同号音乐声道的 4 个寄存器影子写出,并把 Y 改成寄存器下标,使音轨指针多走几字节) |
|
|
363
|
+
| `$D4` | 1 | 写本声道寄存器 1 的影子 |
|
|
364
|
+
| `$D5` | 0 | `$4015` 写 0,`$0499` 置位 6(暂停音乐声道) |
|
|
365
|
+
| `$D6`、`$D7` | 0 | `$03CB` 位 3 置位、清除,同时静音 |
|
|
366
|
+
| `$D8` | 1 | 设声道移调 `$0447` |
|
|
367
|
+
| `$D9` | 1 | 嵌套播放内置曲表里的一首(未验证) |
|
|
368
|
+
| `$DA` | 1 | 让下一个字节重复参数次 |
|
|
369
|
+
| `$DB` | 4 | 颤音参数(`$049B`、`$0460`、`$045D`、`$0466`),声道 0-2;其他声道多跳过 1 个字节 |
|
|
370
|
+
| `$DC`、`$DD` | 0 | 颤音开、关(`$03CB` 位 4) |
|
|
371
|
+
| `$DE` | 1 | 写 `$048F` 与 `$03B7` |
|
|
372
|
+
| `$DF` | 2 | 绝对跳转(16 位偏移),记下返回点 |
|
|
373
|
+
| `$E0`-`$E3` | 1 | 音效声道(4-7)写寄存器影子 1、2、3、0;音乐声道上什么都不做,也不吃参数 |
|
|
374
|
+
| `$E4` | 0 | 音效声道发声触发(`$03C3` 置位 1、清位 7) |
|
|
375
|
+
|
|
376
|
+
`$E5` 以上的命令字节越过命令表,读到表后的代码字节当地址,不能使用。包络表地址落在窗口地址(`$8000` 以上)、`$03B5` 位 7 为 1 时的乐器表、自动接下一首(`$0499` 位 5)与 `$FF` 曲号的恢复播放都没有验证。
|
|
377
|
+
|
|
378
|
+
- 页 78 里 `$8445`、`$8456` 两段 17 字节的提示音都是单声道曲子(声道 5、6):`E3`、`E0`、`E1`、`E2` 写音效声道寄存器 +0 至 +3(声道 5 即 `$4004-$4007`、声道 6 即 `$4008-$400B`),`E4` 置 `$03C3` 位 1、清位 7(下次刷新写寄存器 2、3,重新发声),再跟时长、`CB`、`D3`。已实测:用实验程序调 `$65/$00`(`$0642=$78`、`$0C/$0D` 指向 `$8445`)后,`$047D-$0480` 立即变成 `8F F9 BF 0B`(声道 5 的影子,`$0469+4×5`),约半秒后 `$047D` 衰减成 `$80`;指向 `$8456` 时 `$0481-$0484` 是 `xx 00 40 00`(声道 6),时长只有 2 拍,首字节随即被引擎改写成 `$80`(三角波静音)。
|
|
379
|
+
- 内核 `$D321`(ROM 偏移 `$5321`)还有一首两个音效声道(5、7)的曲子,用到音符、`C1`/`C4`/`C5` 数值命令和 `CE` 计数循环,全部跳转偏移都落在事件起点、两条音轨都以 `CB D3` 结尾,可作为格式正确的旁证。`SOUND_SONG_TABLE`(`$D31B`):`$65/$00`、`$01`、`$09`、`$0A`、`$0B` 都先置 `$03A6=$FF`,让 `SOUND_PLAY_SONG` 直接用 `$02/$03` 指向的曲子(曲号固定 `$7F`),不查曲表;只有 `$03A6` 为 0 且曲号在 1-`$7E` 时才查表(命令 `$D9` 嵌套播放走这条路)。表里只有 `$D31C` 起的 1 项有效,指向上面 `$D321` 的曲子;`SOUND_PLAY_SONG` 按 2 字节一项取、`$D9` 按 3 字节一项取,两种取法互相不一致,表里其余字节不是曲子指针,这条路是否会被走到没有实测(代码阅读)。
|
|
380
|
+
|
|
381
|
+
BIOS 自己带了一段 WAV:ROM 第 `$64` 页起,单声道、8 位、22050 Hz、约 3.7 秒。
|
|
382
|
+
|
|
383
|
+
## 5.6 窗口与跨页服务(内核)
|
|
384
|
+
|
|
385
|
+
`$8000-$BFFF` 是 4 个 4K 窗口,窗口 0-3 的页号寄存器是 `WIN_PAGE_0-3`(`$4040-$4043`),系统在 `WINDOW_SAVE_0-3`(`$0639-$063C`)里保存影子,每次系统调用返回时把影子写回寄存器(所以服务里对窗口的改动只在影子里记下,返回后才生效)。页组指连续的 4 页:首页号写 `SYS_GROUP`(`$0642`),其余三页依次加 1。
|
|
386
|
+
|
|
387
|
+
| 服务 | 入口 | 参数与作用 | 可靠程度 |
|
|
388
|
+
| --- | --- | --- | --- |
|
|
389
|
+
| `$25` | `API_25_CALL_BANKED` | 把页组 `$0642` 映射到 `$8000-$BFFF`,再调用 `PROG_ENTRY`(`$0C/$0D`)里的地址;入口返回后窗口恢复成调用前的样子 | 已确认 |
|
|
390
|
+
| `$26` | `API_26_JUMP_BANKED` | 同 `$25`,但丢掉返回地址与保存的寄存器,直接跳到 `$0C/$0D`,不再回来;栈指针回到调用前的值,窗口影子变成页组起的 4 个页 | 已验证 |
|
|
391
|
+
| `$29` | `API_29_MAP_WINDOW` | 把页 `SYS_PAGE`(`$0641`)映射到窗口 `$0653`(0-3),调用返回后**保持**这个映射(影子 `$0639 + 窗口号`,其余窗口不变) | 已验证 |
|
|
392
|
+
| `$27` | `API_27` | 把 4 个窗口影子设成页组 `$0642` 起的 4 个连续页,调用返回后保持 | 已验证 |
|
|
393
|
+
| `$28` | `API_28` | 页号换算:`SYS_PAGE` 变成原值右移 3 位,`FAR_OFFSET_HI` 加上 `$80`、原页号低 3 位乘 `$10`(和进位) | 已验证 |
|
|
394
|
+
| `$2C` | `API_2C_ADDR_TO_FAR` | 把 `$0C/$0D` 里的窗口地址(`$8000-$FFFF`)与页组 `$0642` 换成“远指针”:页号放 `SYS_PAGE`(页号 = 地址高 4 位 − 8 + 页组,按 8 位回绕),页内偏移(12 位)放 `FAR_OFFSET_LO/HI`(`$14/$15`) | 已验证 |
|
|
395
|
+
| `$24` | `API_24_FAR_READ_NEXT` | 按远指针(`SYS_PAGE`、`FAR_OFFSET`)读一个字节到 `$0653`,指针后移一位,越过页尾(偏移 `$FFF`)时 `SYS_PAGE` 加 1、偏移回 0 | 已验证 |
|
|
396
|
+
| `$2B` | `API_2B_FAR_WRITE_NEXT` | 把 `$0653` 写到远指针处,指针后移一位(越页尾同 `$24`) | 已验证 |
|
|
397
|
+
| `$2A` | `API_2A_SET_VRAM_BANK` | 把 `$0642` 写到 `VRAM_BANK`(`$4300`),选显存 bank | 已验证 |
|
|
398
|
+
|
|
399
|
+
不经 `$FFF0`、直接用 `JSR` 调用的内核入口(在固定内核区,程序可直接调用):
|
|
400
|
+
|
|
401
|
+
| 入口 | 例程 | 作用 |
|
|
402
|
+
| --- | --- | --- |
|
|
403
|
+
| `$FFF3` | `FAR_READ_BYTE` | 读 `SYS_PAGE` 页、偏移 `FAR_OFFSET`+Y 处的字节,结果在 A(临时借用窗口 3,调用后恢复) |
|
|
404
|
+
| `$FFF6` | `FAR_WRITE_BYTE` | 把 A 写到 `SYS_PAGE` 页、偏移 `FAR_OFFSET`+Y 处 |
|
|
405
|
+
| `$FFEA` | `FAR_COPY_IN` | 把页组 `$0642`、窗口地址 `$0C/$0D` 起的 `$064F` 个字节复制到 `COPY_BUFFER`(`$0700`)起,X 是缓冲区内的起点 |
|
|
406
|
+
| `$FFED` | `FAR_COPY_OUT` | 反方向:把 `COPY_BUFFER` 里的 `$064F` 个字节复制到页组窗口地址 |
|
|
407
|
+
|
|
408
|
+
## 5.7 画面与中断控制(内核,部分)
|
|
409
|
+
|
|
410
|
+
下面只写读过代码、确认过的用法,其余子功能见 [api-reference.md](../../targets/sb2000/api-reference.md):
|
|
411
|
+
|
|
412
|
+
- `$12`(`API_12_PPU_CONTROL`):`$12/$00` 把 PPU 控制寄存器影子(`$062A`)的位 7 清零,即关闭 NMI;`$12/$80` 把位 7 置位,重新打开 NMI。磁盘读写前后就是成对使用(已确认)。子功能低 4 位不大于 6 时还能打开、关闭 NMI 中断里的各项服务(`$0630` 的开关):`$12/$81-$86` 依次置位 `$0630` 的位 7、6、5、4、3、1,`$12/$01-$06` 清这些位(代码阅读)。其中位 3 管 NMI 里读手柄,要用 `$6A` 必须先调用 `$12/$85`(已确认,`pad`);`$12/$85` 还把 `$0634` 置 `$FF`。`NMI_FLAGS` 各位:位 7 条带动画、位 6 声音更新(`NMI_SOUND_UPDATE`)、位 5 与位 4 调用登记的钩子、位 3 读手柄、位 2 精灵 DMA、位 1 把缓冲区内容复制到 `$2040` 起的调色板区域(代码阅读 `interrupt-handlers.asm`)。
|
|
413
|
+
- `$13`(`API_13_IRQ_MASK`):中断屏蔽影子 `$062F`,写入 `$4032`,位为 1 表示屏蔽(禁止)该中断源,写 1 时硬件还会同时清除 `$4033` 里该源的待处理标志(模拟器源码确认,见[硬件说明](03-硬件说明.md))。子功能 0-6 把位 7 到位 1(依次为 `$80、$40、$20、$10、$08、$04、$02`)置 1,即屏蔽;`$80+n` 把对应位清 0,即允许。已确认(`mouse`):鼠标中断是位 6,`$13/$81` 允许鼠标中断,`$13/$01` 屏蔽;屏蔽着鼠标中断时收不到鼠标数据。`$13/$81` 执行后,如果鼠标已接入(`$0633` 非 0)就把 `$0634` 清 0,否则置 `$FF`。另外 `$13/$80` 还设置定时器 `$4034/$4035`,`$13/$02`、`$13/$82` 向 `$4022` 写 `$40`、`$80`;`$13/$88` 登记各中断源的处理例程。
|
|
414
|
+
- `$1B`(`API_1B_WAIT_FRAMES`):等待 X 个完整的垂直消隐周期(帧)(已确认,最常用的延时)。
|
|
415
|
+
- `$1C`、`$1D`:保存、恢复上下文,类似 `setjmp`/`longjmp`:`$1C` 把页组 `$0642`、地址 `$0C/$0D`、子功能 `$063F` 压入 `$0656` 起的上下文栈(最多 10 项,个数在 `$0655`);`$1D` 弹出并换页跳转,不返回;输入服务的 ESC 中断(`$6B/$01`)也经 `$1D` 实现。
|
|
416
|
+
- `$1E`(`API_1E_QUERY_STATE`):按子功能 `$063F`(0-`$0C`)查询显示与系统状态,结果放 `$0652`(`$1E/$07`:位 0 表示 NMI 是否开着,即 `$062A` 的位 7,其余位取自 `$0630`;磁盘服务用它记住显示开关,读写完再恢复)。
|
|
417
|
+
|
|
418
|
+
### 5.7.1 内核基础功能 `$10-$1F` 逐子功能结果(已验证)
|
|
419
|
+
|
|
420
|
+
下面所有“影子”指内核在 RAM 里保存的硬件寄存器副本:`$062A` 是 PPU_CTRL(`$2000`)、`$062B` 是 PPU_MASK(`$2001`)、`$062E` 是 `$2008`、`$062F` 是 `$4032`。参数放 `$0652`,记作 v;子功能超出范围时 `$0640` 置 `$FF`。
|
|
421
|
+
|
|
422
|
+
| 功能 | 子功能与结果 |
|
|
423
|
+
| --- | --- |
|
|
424
|
+
| `$10` 显示选项(子功能 0-7,8 以上 `$0640`=`$FF`) | 0:`$062E` 清位 7 后并入 v 并写 `$2008`;1:清位 0;2:清位 2、3;3:`$062A` 清低 2 位并入 v 并写 `$2000`;4:v 非 0 时 `$0630` 置位 2,为 0 时清位 2,`$062B` 清位 4 后并入 v 并写 `$2001`;5:`$062A` 清位 5 并入 v;6:`$062B` 只保留位 1-4 再并入 v;7:`$062B` 清位 3 并入 v |
|
|
425
|
+
| `$11` 显示模式 | 子功能 0-3:`$0638` 高 2 位取 `$00`、`$40`、`$80`、`$C0`,低 6 位不变;子功能 `$80` 以上且低 2 位为 0-2:把 `$0644` 右移 2 位、`$0E`、`$0F` 加上由 `$0644` 低 2 位换算的偏移,三个字节登记到 `$067E + 3×(子功能低 2 位)` 起;低 2 位为 3 什么都不做 |
|
|
426
|
+
| `$12` PPU 控制 | 0:`$062A` 清位 7(关 NMI);1-6:`$0630` 依次与 `$7F、$BF、$DF、$EF、$F7、$FD`;`$80`:`$062A` 置位 7;`$81-$86`:`$0630` 依次置位 `$80、$40、$20、$10、$08、$02`,`$85` 另把 `$0634` 置 `$FF`;`$88`:v 为 0 把 NMI 钩子 `NMI_HOOK5_VEC_LO/1F` 恢复成空钩子(`$E7A8`),否则恢复 `NMI_HOOK4_VEC_LO/21`;其余低 4 位不小于 7 的子功能 `$0640`=`$FF` |
|
|
427
|
+
| `$13` 中断屏蔽 | 0-6:`$062F` 依次置位 `$80、$40、$20、$10、$08、$04、$02` 并写 `$4032`,子功能 2 另写 `$4022`=`$40`;`$80-$86`:`$062F` 依次与 `$7F、$BF、$DF、$EF、$F7、$FD、$80` 并写 `$4032`(`$85`、`$86` 的屏蔽值来自表后相邻字节,原程序的疏漏,实测如此),`$80` 另写 `$4034`=`$EF`、`$4035`=`$3C`,`$82` 另写 `$4022`=`$80`,`$81` 在鼠标在线(`$0633` 非 0)时 `$0634` 清 0、否则置 `$FF`;`$88`:v 为 0-5 依次把 `TIMER_HOOK_VEC_LO`、`IRQ3_HOOK_VEC_LO`、`IRQ1_HOOK_VEC_LO`、`IRQ4_HOOK_VEC_LO`、`MOUSE_HOOK_VEC_LO`、`KBD_HOOK_VEC_LO` 起的钩子恢复成空钩子;低 4 位不小于 7 的子功能 `$0640`=`$FF`。中断处理程序也会写 `$4032`,所以调用本身写的是第一个值 |
|
|
428
|
+
| `$15` | `$0636` 置 1 |
|
|
429
|
+
| `$18` 系统初始化 | 把 `$062A` 设成 `$88`、`$062B` 设成 `$0E`、`$062F` 设成 `$FF`、`$062E` 设成 `$08`、`$0637` 设成 `$4F`,`$0630`、`$0638`、`$0631`、`$0635`、`$0328`、`$0329`、`$032B` 清 0,`$0655` 设成 `$FF`,`$068A-$068D` 设成 0、0、`$0C`、0,各 NMI/IRQ 钩子恢复成空钩子,键盘、鼠标、手柄状态复位,清调色板缓冲(`$2040` 起写 `$0E`)与精灵缓冲,开中断并等一帧 |
|
|
430
|
+
| `$19` | `$062A` 清位 7 并写 `$2000`,等到垂直消隐后关闭背景与精灵显示 |
|
|
431
|
+
| `$1A` | 等到垂直消隐,`$062A` 置位 7 并写 `$2000`,`$062B` 写回 `$2001` |
|
|
432
|
+
| `$1B` | 等 X 个垂直消隐周期(X 为 0 等 256 个),每次等待占 1 到 2 个模拟器帧 |
|
|
433
|
+
| `$1C` | 上下文栈未满(`$0655` 为 `$FF` 或小于 9)时 `$0655` 加 1,把 `$0642`、`$0C`、`$0D`、`$063F` 存进 `$0656 + 4×新计数`;计数在 9 到 `$FE` 之间时什么都不做(最多 10 项) |
|
|
434
|
+
| `$1D` | 计数小于 10 时:`$0630` 清 0、`$4015` 写 0、`$062F` 与 `$4032` 写 `$1F`,取出栈顶项:页组、地址、栈指针(第 4 个字节),计数减 1,栈指针设成保存值,换入页组并跳到保存的地址,不返回 |
|
|
435
|
+
| `$1E` 状态查询(0-`$0C`,结果放 `$0652`) | 0:`$062E` 位 7;1:`$062E` 位 0;2:`$062E` 位 2、3;3:`$062A` 低 2 位;4:`$062B` 位 4;5:`$062A` 位 5;6:`$0638` 位 6 为 0 时显示区域是固定的(`$0644`=`$14`、`$0E`=0、`$0F` 为 `$8E`,`$0638` 位 7 为 1 时为 `$91`),为 1 时取 `$0681-$0683`(位 7 为 1 时 `$0F` 加 8,达到 `$C0` 时 `$0644` 加 1、`$0F` 减 `$40`),模式号(`$0638` 右移 6 位)放 `$0652`;7:`$0630` 清位 0 后并入 `$062A` 位 7;8:`$062F`;9:`$0633`;10:恒为 1;11:`$0635`;12:`$062B` 位 3、4 |
|
|
436
|
+
| `$1F` | 把 `$068C`、`$068B`、`$068A` 依次复制到 `$069A`、`$069B`、`$069C` |
|
|
437
|
+
|
|
438
|
+
### 5.7.2 DMA 与显存服务 `$30-$34`(已验证)
|
|
439
|
+
|
|
440
|
+
DMA 寄存器:`$4048` 控制、`$4049` 源高、`$404A` 源低、`$404B` 源中、`$404C` 目的低、`$404D` 目的高、`$404E` 长度低、`$404F` 长度高;长度寄存器写“长度 − 1”。屏幕缓冲在扩展 RAM 页 `$FA`(名称表 4、5,偏移 `$000`、`$800`)与页 `$FB`(名称表 6、7),每张 2KB、每个单元 2 字节;区域填充的中转缓冲在页 `$F8` 起。
|
|
441
|
+
|
|
442
|
+
| 功能 | 作用 |
|
|
443
|
+
| --- | --- |
|
|
444
|
+
| `$30/$00-$03` | 名称表 DMA:把页 `$1F` 里的一张名称表经 DMA 写到显存(源中位 `$A0、$A8、$B0、$B8`,目的高位 = 子功能 × 8,`$062E` 位 0 为 1 时再加 `$20`,长度 `$07FF`,控制 `$C0`),等 1 帧 |
|
|
445
|
+
| `$30/$04-$07` | 求屏幕缓冲里单元的远地址:`$0648` 列、`$0649` 行,偏移 = 行 × 64 + 列 × 2 + 名称表基址(`$A0、$A8、$B0、$B8` 对应子功能 4-7)× 256,结果在 `SYS_PAGE`(`$0641`,高 4 位 + `$F0`)与 `FAR_OFFSET`(低 12 位) |
|
|
446
|
+
| `$30/$08` | 写单元:把页组 `$0642` 窗口地址 `PROG_ENTRY`(`$0C/$0D`,只取低 12 位)起的单元(每个 2 字节)写到远地址(`SYS_PAGE`、`FAR_OFFSET`),个数在 `$064F/$0650`,每写一个目的偏移加 `$0652` |
|
|
447
|
+
| `$30/$09` | 读单元:从远地址读 `$064F/$0650` 个单元到页组 `$0643`、`DST_ADDR_LO/DST_ADDR_HI` 指向的内存,每读一个源偏移加 `$0652` |
|
|
448
|
+
| `$30/$0A` | 清屏:`$0652` 的位 0-3 分别决定是否把屏幕缓冲里名称表 4-7 的全部单元填成 `$064C/$064D` |
|
|
449
|
+
| `$31` | 位掩码选区域,用 `$064C` 填满显存:位 0-4 依次是显存 `$0000、$0800、$1000、$1800、$2000` 起各 `$0800` 字节,位 5 是 `$2800` 起 `$5800` 字节,位 6 是 `$8000` 起 `$8000` 字节,位 7 把 `$2040` 起 64 字节调色板缓冲填成 `$064C`(显示关闭或 NMI 关闭时直接写,NMI 与显示都开时放进 `$0700` 缓冲,经 `$0630` 位 1 交给 NMI 上传)。长度不小于 `$1C00` 的区域分段 DMA(每段 `$1C00` 字节),最后一段不足 `$1C00` 时目的地址与上一段相同,可能是原程序的疏漏 |
|
|
450
|
+
| `$32` | 单段填充:显存 `$0646/$0647`(高、低)起,长度 `$0650/$064F`,用 `$064C` 填,长度为 0 时什么都不做 |
|
|
451
|
+
| `$33` | 扩展 RAM 到显存的 DMA:源 `SYS_PAGE`、`FAR_OFFSET`(经 `$28` 换算成 DMA 源地址),目的 `$0646/$0647`,长度 `$0650/$064F`,控制 `$C0`;长度为 0 时什么都不做 |
|
|
452
|
+
| `$34` | 同 `$33`,控制 `$A0`,目的取 `DST_ADDR_HI/DST_ADDR_LO` |
|
|
453
|
+
|
|
454
|
+
## 5.8 手柄与鼠标(功能 `$6A`、`$6C`,内核)
|
|
455
|
+
|
|
456
|
+
下面是读代码得到的结论,手柄、鼠标部分都已用模拟器的注入命令实测(`pad`、`mouse`)。手柄驱动在 NMI 中断里(`$0630` 位 3 置位时,用 `$12/$85` 打开)读 2 个手柄(`READ_PADS`),鼠标数据包由内核里的中断代码解析,程序并不直接读硬件。
|
|
457
|
+
|
|
458
|
+
**手柄(`$6A`)**
|
|
459
|
+
|
|
460
|
+
| 子功能 | 作用 |
|
|
461
|
+
| --- | --- |
|
|
462
|
+
| `$6A/$00` | 初始化:`PAD_KEY`、`PAD1_BITS`、`PAD2_BITS` 置 `$80`,`PAD1_RAW`、`PAD2_RAW` 清 0 |
|
|
463
|
+
| `$6A/$01` | 取按键码(不等待):从位 7 向下找 `PAD1_RAW` 里第一个按下的键,没有就找 `PAD2_RAW`(鼠标接入时不找),键码放 `PAD_KEY`(`$034D`);两个手柄的原始状态放 `PAD1_BITS`(`$034E`)、`PAD2_BITS`(`$034F`) |
|
|
464
|
+
| `$6A/$02` | 等到有按键再返回,结果同 `$6A/$01` |
|
|
465
|
+
|
|
466
|
+
键码(已确认:按 A、右、上、B 分别得到 `$0F`、`$08`、`$0B`、`$0E`,原始状态 `$80`、`$01`、`$08`、`$40`):`$FF` 表示没有键;1 号手柄 `$0F`(A)、`$0E`(B)、`$0D`(选择)、`$0C`(开始)、`$0B`(上)、`$0A`(下)、`$09`(左)、`$08`(右);2 号手柄同序,`$07-$00`。同时按下多个键时取最高位的。手柄原始状态的位顺序:位 7 为 A,位 0 为右(标准 FC 手柄的读取顺序)。
|
|
467
|
+
|
|
468
|
+
**鼠标(`$6C`)**
|
|
469
|
+
|
|
470
|
+
| 子功能 | 作用 |
|
|
471
|
+
| --- | --- |
|
|
472
|
+
| `$6C/$00` | 设置坐标范围:X 下限 `$0646`、Y 下限 `$0647`、X 上限 `$0648`、Y 上限 `$0649`,并保存 `$0652` 到 `MOUSE_PARAM`;原始 BIOS 里这一项执行完后会拿寄存器 A(`$0652` 的值)继续当子功能号比较,程序应让 `$0652` 不等于 1–4 |
|
|
473
|
+
| `$6C/$01` | 保存 `$0652` 到 `MOUSE_PARAM`(`$035E`) |
|
|
474
|
+
| `$6C/$02` | 取坐标:X 放 `$0646`、Y 放 `$0647` |
|
|
475
|
+
| `$6C/$03` | 整理按键状态到 `$0360-$0367`(按键 1:`MOUSE_BTN1_STATE`、`_RELEASE`、`_CLICK`、`_DOWN`;按键 2 同理) |
|
|
476
|
+
| `$6C/$04` | 设置坐标:X 取自 `$0652`、Y 取自 `$0653` |
|
|
477
|
+
|
|
478
|
+
光标坐标 `MOUSE_X`(`$0354`)、`MOUSE_Y`(`$0355`)每收到一个数据包就加上有符号位移,并限制在上下限之间;最后一个数据包的位移留在 `MOUSE_DX`(`$0352`)、`MOUSE_DY`(`$0353`)。`$14`(鼠标复位)得到的鼠标存在标志放 `$0633`。
|
|
479
|
+
|
|
480
|
+
**使用鼠标的顺序(已确认,`mouse`)**:`$14` 复位,检查 `$0633` 非 0(没有鼠标则为 0);`$13/$81` 允许鼠标中断;`$6C/$00` 设置范围(`$0652` 不要是 1-4);`$6C/$04` 设置初始坐标;之后随时用 `$6C/$02` 取坐标。实测坐标初值 `$80`、`$64`,依次移动 (10,5)、(10,5)、(-4,-3) 后得到 `$90`、`$6B`,即位移按 1:1 累加;范围上下限实测按 X 下限 `$0646`、Y 下限 `$0647`、X 上限 `$0648`、Y 上限 `$0649` 存入 `$035A-$035D`。模拟器把鼠标当成 1200bps 的微软串口鼠标(3 字节数据包,首字节位 6 为同步位)。
|
|
481
|
+
|
|
482
|
+
按键状态(`$6C/$03`,已确认,`mouse`):`$6C/$03` 把驱动里的按键标志整理到 `$0360-$0367`。按键 1(数据包位 5)用 `$0360`、`$0362`、`$0364`、`$0366`,按键 2(数据包位 4)用 `$0361`、`$0363`、`$0365`、`$0367`。实测(模拟器里 `mouse btn 4` 对应按键 1、`mouse btn 1` 对应按键 2、`mouse btn 2` 没有反应):
|
|
483
|
+
|
|
484
|
+
| 操作 | 状态字节(`$0360`/`$0361`) | 点击字节(`$0364`/`$0365`) | 松开、拖动字节 |
|
|
485
|
+
| --- | --- | --- | --- |
|
|
486
|
+
| 按住不放 | 1 | 0 | 0 |
|
|
487
|
+
| 按下并松开(查询时已松开) | 2(按键 2 实测) | 1(按键 2 实测) | 0 |
|
|
488
|
+
| 按下并松开,再按下(双击的第二次按下) | 1 | 0 | 双击字节(`$0362`/`$0363`)为 1,读走即清 |
|
|
489
|
+
| 双击的第二次松开 | 2 | 0(不再产生点击) | 0 |
|
|
490
|
+
| 按住并移动 | 1 | 0 | 拖动字节(`$0366`/`$0367`)为 1 |
|
|
491
|
+
| 拖动后松开 | 2 | 0(拖动不产生点击) | 0 |
|
|
492
|
+
|
|
493
|
+
“点击”字节读走一次就被清除。以上都在模拟器里用实验程序调用 `$6C/$03` 实测(`mouse btn 4`、`mouse move`),按键 1。驱动里的状态机(代码阅读,内部标志 `$0369`、`$036A`、`$036D`):按下后若没移动,记下“可能双击”并让计时器 `$035F`(按键 2 是 `$0368`)清 0;松开时产生点击;在计时器小于 `MOUSE_PARAM`(`$6C/$01` 设置,取自 `$0652`)时又按下且没移动,才算双击;计时器由 IRQ 里 `$4033` 位 7 的定时器中断递增(`TIMER_IRQ_HANDLER`),实测在只允许了鼠标中断的程序里计时器不走(`$035F` 一直是 0),第二次按下不管间隔多久都被当作双击,要靠计时淘汰就得打开定时器中断(打开方法没有核实)。在 DOS 环境里(定时器中断已开)再测:双击间隔参数(`$6C/$00`、`$6C/$01` 的 `$0652`)为 `$FF` 时,按键 1 按下、松开、查询一次点击、再按下,第二次按下的双击字节为 1;参数为 0 时不产生双击(计时器不可能小于 0),第二次松开又产生一次点击;按键 2 的双击字节没有观察到产生。读走一次点击后,“松开”状态字节也会被清为 0。
|
|
494
|
+
|
|
495
|
+
## 5.9 DOS 命令外壳(页组 0)
|
|
496
|
+
|
|
497
|
+
外壳把输入的命令行拆开(`DOS_PARSE_COMMAND`:第 2 个字符是“:”时先取驱动器字母,命令名转大写,命令名最长 24 个字符,超长出错码 `$81`,遇到空格或“/”结束),再在 `DOS_CMD_NAMES`(`$8891`)里查找命令名的序号(`DOS_FIND_COMMAND`):查到就按序号从 `DOS_CMD_TABLE`(`$8741`)取处理例程执行(`DOS_RUN_COMMAND`);查不到(`DOS_CMD_INDEX` 为 `$FD`)就按程序文件执行,空命令为 `$FE`。内部命令(代码阅读,序号从 0 起):
|
|
498
|
+
|
|
499
|
+
| 序号 | 命令 | 处理例程 |
|
|
500
|
+
| --- | --- | --- |
|
|
501
|
+
| 0 | `CLJS` | `$AAD5` |
|
|
502
|
+
| 1 | `EXIT` | `$AA9F` |
|
|
503
|
+
| 2 | `DIR` | `$9BCA` |
|
|
504
|
+
| 3、4 | `REN`、`RENAME` | `$AA29` |
|
|
505
|
+
| 5 | `COPY` | `$AA64` |
|
|
506
|
+
| 6 | `SB-WIN` | `$A833` |
|
|
507
|
+
| 7 | `TYPE` | `$AA0E` |
|
|
508
|
+
| 8、9 | `DEL`、`ERASE` | `$AA44` |
|
|
509
|
+
| 10 | `CLS` | `$AA84` |
|
|
510
|
+
| 11 | `DATE` | `$AB26` |
|
|
511
|
+
| 12 | `TIME` | `$AB41` |
|
|
512
|
+
| 13、14 | `CD`、`CHDIR` | `$98BE` |
|
|
513
|
+
| 15、16 | `MD`、`MKDIR` | `$A4FE` |
|
|
514
|
+
| 17、18 | `RD`、`RMDIR` | `$A6C9` |
|
|
515
|
+
| 19 | `DISKCOPY` | `$AABA` |
|
|
516
|
+
| 20 | `REM` | `$9B42` |
|
|
517
|
+
| 21 | `VER` | `$AAF0` |
|
|
518
|
+
| 22 | `HELP` | `$AB0B` |
|
|
519
|
+
|
|
520
|
+
`CLJS` 的实现先打开 `MENU.BIN`(代码阅读),失败时显示出错信息,成功则显示“正在装入大型游戏软件”后装入运行;页 63 里有它的帮助文字“GAME 装载运行大型游戏软件 / Load and Run a large game”。实测在没有 `MENU.BIN` 的软盘上输入 `cljs` 显示“文件未找到”。它和 `VER`、`HELP`、`DATE` 一样,先把序号写入 `$65E7`,再调用页组 `$5E`。增加新命令要修改 BIOS 源码,不在本手册范围内。
|
|
521
|
+
|
|
522
|
+
内部命令的用法,取自 BIOS 自带的帮助文字(英文在页 `$5B`、`$63`,中文在页 `$5F`、`$63`;`HELP` 命令会逐条翻页显示,实测显示 `DEL` 的帮助):
|
|
523
|
+
|
|
524
|
+
| 命令 | 用法与说明 |
|
|
525
|
+
| --- | --- |
|
|
526
|
+
| `CLS` | 清屏 |
|
|
527
|
+
| `VER` | 显示版本:`SB-DOS Version 2.00` |
|
|
528
|
+
| `DATE [日期]` | 显示或设置日期,格式 `mm-dd-yy`;非法时提示 `Invalid date` |
|
|
529
|
+
| `TIME [时间]` | 显示或设置时间,格式 `hh:mm:ss`;非法时提示 `Invalid time` |
|
|
530
|
+
| `CD`、`CHDIR [盘:][路径]` / `[..]` | 显示或改变当前目录,`..` 回到上一级;目录不存在提示 `Invalid directory` |
|
|
531
|
+
| `MD`、`MKDIR [盘:]路径` | 建目录;已存在提示 `Directory name already exists`,不能建时提示 `Unable to create directory` |
|
|
532
|
+
| `RD`、`RMDIR [盘:]路径` | 删目录;路径无效、不是目录或目录非空时提示 `Invalid path, not directory, or directory not empty` |
|
|
533
|
+
| `REN`、`RENAME [盘:][路径]文件名1 文件名2` | 重命名文件,新名字不能带盘符与路径,不能改目录名(`Cannot rename a directory`) |
|
|
534
|
+
| `DEL`、`ERASE [盘:][路径]文件名 [/P]` | 删除文件,`/P` 逐个确认;没有写文件名时询问“All files in this directory will be deleted, sure(Y/N)?”;结束时显示“N files have been deleted” |
|
|
535
|
+
| `COPY [/A] 源 [目标 [/A]] [/V] [/Y]` | 复制文件,`/A` 按文本,`/V` 校验,`/Y` 覆盖时不提问;不能一次复制多个文件(`Multi file cannot been copied`),文件复制到自己时提示 `File can't be copied to itself` |
|
|
536
|
+
| `DIR [盘:][路径][文件名] [/P] [/A] [/B] [/W]` | 列目录:`/P` 满屏暂停、`/A` 显示所有文件、`/W` 宽格式、`/B` 只列名字;末尾显示文件数、目录数、字节数与剩余字节数 |
|
|
537
|
+
| `TYPE [盘:][路径]文件名 [\|MORE]` | 显示文本文件,`\|MORE` 满屏暂停 |
|
|
538
|
+
| `REM [注释]` | 在批处理里写注释 |
|
|
539
|
+
| `HELP` | 显示帮助:`Ctrl+P` 暂停、`Ctrl+C` 中断,`F3` 复制上一条命令,`Ctrl+F7` 中英文切换 |
|
|
540
|
+
| `DISKCOPY 驱动器1: 驱动器2:` | 复制整张软盘,两张盘类型要相同;按提示换盘(`Insert SOURCE diskette in`、`Insert TARGET diskette in`) |
|
|
541
|
+
| `SB-WIN` | 运行 SB-WIN;已在运行时提示“你已经运行 SBWIN”,没有系统盘时提示“请插入 SB-WIN 系统盘” |
|
|
542
|
+
| `CLJS` | 装载运行大型游戏软件(见上) |
|
|
543
|
+
|
|
544
|
+
实机屏幕上显示的是中文版提示,下面这些都已用模拟器实测,磁盘上的结果同时用独立的 FAT12 读取器核对过:
|
|
545
|
+
|
|
546
|
+
| 命令与情形 | 屏幕显示 | 其他结果 |
|
|
547
|
+
| --- | --- | --- |
|
|
548
|
+
| `VER` | `小霸王中文DOS操作系统 版本2.00` | — |
|
|
549
|
+
| `DIR` | 先显示卷标行(该镜像上显示“卷标为 空”,根目录里有卷标项 `SB2KDISK`、引导扇区里是 `NO NAME`,显示来源还没查清)、序列号行(引导扇区偏移 39 的 4 字节小端值,高 16 位在前,如 `2026-1109`)、“目录 A:\”;每个文件一行:名称 8 列、空格、扩展名 3 列、大小右对齐 10 列(千分位逗号)、空格、日期 `mm-dd-yy`;末尾是文件数、目录数、文件字节数、“个可用字节”(空闲簇数 × 512) | 通配符 `*` 可用(键盘输入要用小键盘乘号),只统计匹配的文件 |
|
|
550
|
+
| `DIR /A` | 与 `DIR` 相同(该镜像没有隐藏文件) | — |
|
|
551
|
+
| `DIR /B` | 每个文件一行 `名称.扩展名`,末尾统计行仍显示 | — |
|
|
552
|
+
| `DIR /W` | 每行两个 `名称.扩展名`,名称各占 18 列 | — |
|
|
553
|
+
| `DIR` 没有匹配的文件 | `没有找到文件`,仍显示空闲字节数 | — |
|
|
554
|
+
| `TYPE 文件` | 文件内容 | — |
|
|
555
|
+
| 命令名不存在 | `命令输入错` | — |
|
|
556
|
+
| `COPY 源 目标` | 先显示源文件路径(如 `A:\HELLO.TXT`),成功时显示“ 1 个文件被复制” | 新文件内容与源一致 |
|
|
557
|
+
| `COPY` 目标已存在 | `文件存在,是否覆盖(Y/N)?`;答 `n` 显示“没有复制文件或文件不存在”,答 `y` 覆盖(沿用原起始簇、释放多余的簇);`/Y` 不再询问 | 答 `n` 磁盘不变 |
|
|
558
|
+
| `COPY` 源与目标相同 | `文件不能复制到自身` | 磁盘不变 |
|
|
559
|
+
| `COPY` 源不存在 | `没有复制文件或文件不存在` | 磁盘不变 |
|
|
560
|
+
| `DEL 文件` | “ N 个文件被删除”;通配符 `*.bin` 一次删掉所有匹配的文件,簇全部释放 | — |
|
|
561
|
+
| `DEL 文件 /P` | 逐个询问 `删除(Y/N)?`;答 `n` 显示“没有删除任何文件” | 答 `n` 磁盘不变 |
|
|
562
|
+
| `DEL` 没有匹配的文件 | `没有找到文件` | 磁盘不变 |
|
|
563
|
+
| `REN` 旧名不存在、新名已存在 | `文件未找到`、`文件已经存在` | 磁盘不变 |
|
|
564
|
+
| `MD` 与现有文件同名 | `目录名已存在` | 磁盘不变 |
|
|
565
|
+
| `RD`、`CD` 的路径不存在 | `路径未找到` | 磁盘不变 |
|
|
566
|
+
| `DATE` | `当前日期:`、下一行 `mm-dd-四位年`、`请输入新日期(mm-dd-yy):`;带参数 `DATE 12-25-98` 直接设置(实测 98 显示为 1998,四位年 2005 也行);月份超范围提示 `非法日期`,月份只写一位提示 `参数无效`,失败时日期不变 | 日期变量 ERAM `$6305` 日、`$6306` 月、`$6307` 年(相对 1980) |
|
|
567
|
+
| `TIME` | `当前时间:`、下一行 `时:分:秒`、`请输入新时间(hh:mm:ss):`;带参数 `TIME 10:20:30` 直接设置;小时超范围提示 `非法时间`,失败时时间不变 | 时间变量 ERAM `$068A` 秒、`$068B` 分、`$068C` 时,由内核每秒递增 |
|
|
568
|
+
| `DIR /P` | 每列出 8 个文件显示“按任意键继续...”,按键后接着列 | — |
|
|
569
|
+
| `DIR` 在子目录里 | 标题行显示路径(如 `\T`);先列 `.`、`..`(`<DIR>` 占大小的位置),目录项里 `<DIR>` 后接日期;统计行里 `.`、`..` 也算目录 | 提示符显示当前路径(`A:` 之后一行 `\T`) |
|
|
570
|
+
| `DIR B:` | 与 `DIR A:` 列出同样的文件(只有一个软驱,B: 是同一张盘),标题行显示 `B:`;不存在的盘符提示“参数无效” | — |
|
|
571
|
+
| `MD 目录` | 在根目录建目录(属性 `$10`、1 个簇、“.”指向自己、“..”指向 0,日期为当前系统日期);已有同名项提示“目录名已存在”;缺参数提示“参数错” | 在子目录里建目录会失败,提示“不能创建目录”(实测,只能在根目录建) |
|
|
572
|
+
| `RD`、`CD`、`REN` 的出错 | `RD` 对文件、缺参数提示“非法路径,目录或目录不空”,对非空目录提示“企图删去非空目录”;`CD` 在根目录用 `..` 提示“非法目录”;`REN` 改目录名提示“不可改变目录名”;`REN`、`DEL`、`COPY` 缺参数提示“参数无效” | 磁盘不变 |
|
|
573
|
+
| `COPY` 的变体 | 目标写成已有目录名时复制进该目录(名称不变),带路径 `t\x.txt`、带盘符 `a:b.txt`、开关 `/a`、`/v` 都支持;目标名不是已有目录时新建同名文件;`COPY *.txt b.txt` 提示“多文件不能复制到单文件”;只给源文件(目标取当前目录同名文件)提示“文件不能复制到自身” | 多个 64 簇的文件连续复制,内容一致、簇不重叠;删除中间的文件后写更大的文件,簇链会碎片化,读写都正确 |
|
|
574
|
+
| `DEL *.*` | 先询问“删除目录中所有文件,确认(Y/N)?”,答 `y` 提示“N 个文件被删除”并释放全部簇,答 `n` 什么都不删;`DEL *.exe` 这样带扩展名的通配符不询问 | 卷标保留 |
|
|
575
|
+
| 磁盘空间不够 | `COPY` 时提示“磁盘空间不够”、“放弃A,重试R,失败F ?”;按 `a`、`f` 回到提示符,按 `r` 重试(再次提示同样的内容);失败后磁盘上没有新文件、空闲簇不变、没有簇泄漏 | 根目录写满时提示“无可用文件”,同样给出放弃、重试、失败 |
|
|
576
|
+
| `DISKCOPY 源: 目标:` | 分 4 轮:“将源盘插入 A:、按任意键继续...”→“正在读源盘...”→“将目标盘插入 B:、按任意键继续...”→“正在写目标盘...”,每轮最多复制 `$75000` 字节,读缓冲在扩展 RAM 偏移 0 起;只有一个软驱,所以源盘与目标盘是同一张盘;缺参数显示帮助文字,参数不对提示“参数无效” | 读缓冲与镜像逐字节一致,写入的内容出现在镜像里 |
|
|
577
|
+
| `CLJS` | 软盘上没有 `MENU.BIN` 时提示“文件未找到” | 有 `MENU.BIN` 时会重新配置映射器并启动游戏,不在验证范围 |
|
|
578
|
+
|
|
579
|
+
`ATTRIB`、`MOVE`、`FORMAT` 不是内部命令,是软盘上的程序(`ATTRIB.EXE`、`MOVE.EXE`、`FORMAT.EXE`),它们的帮助文字也存放在 BIOS 里(页 `$63`、`$5B`):`ATTRIB [+R|-R][+A|-A][+S|-S][+H|-H][[盘:][路径]文件名][/S]`,`MOVE [/Y][盘:][路径]文件名 目标`,`FORMAT 盘: [/V[:卷标]] [/Q]`(`/Q` 快速格式化)。
|
|
580
|
+
|
|
581
|
+
## 5.10 中文输入法(功能 `$6D`,页组 `$0C`)
|
|
582
|
+
|
|
583
|
+
功能 `$6D` 换入页组 `$0C` 后按子功能号查 `IME_SUB_TABLE`(`$8012`,37 项,子功能 `$00-$24`)跳转;状态变量在 ERAM `$6900` 起,参数在 `$0652`、`$0653`、`$069A` 起。子功能 `$00-$0B`、`$0D`、`$0E`、`$13-$24` 已用模拟器实测:状态类子功能(`$00-$09`、`$13-$24`)、按键处理(`$0A`、`$0B`)与 `$0D`、`$0E` 都按字节级模型逐字节核对 ERAM `$6900-$69FF` 与相关 RAM。状态行显示(`IME_DRAW_STATUS_LINE`)是调用功能 `$45` 画到屏幕,只核对它清 ERAM `$6951` 的副作用,不核对屏幕内容。拼音类输入法(序号 1、2)的按键处理与词库子功能 `$0C`、`$0F-$12` 也已实测;外挂输入法(序号 3-6)、联想方式下的按键处理依赖外挂模块或联想词库,没有验证。
|
|
584
|
+
|
|
585
|
+
输入法序号(`$0652` 低 4 位,状态行文字取自 ROM `$9CF9`,每项 4 个 GB2312 字符):0 区位、1 全拼、2 双拼、3 五笔、4 表形、5 认知、6 自定义(页组在 ERAM `$697C`,名称取自 ERAM `$697D`,由 `$09` 登记)、7 扩充、8 图形、9 英文;按键处理里临时用到的 10 国标(十六进制内码输入)、11 联想只在显示状态行文字时出现,不能选择。序号 7、9 不处理按键,原样传回;序号 0 是区位码与十六进制内码输入;序号 8 按输入长度 1-9(区号 `$A1-$A9`,低字节从 `$A1` 起)翻页浏览 GB2312 图形符号。
|
|
586
|
+
|
|
587
|
+
序号 1、2(全拼、双拼)的按键处理:小写字母追加到输入串(ERAM `$6905` 起),在音节表里查(全拼 408 项、每项 6 字节,输入串最长 6 个字符;双拼 465 项、每项 2 个字符,键位里含 `;`)。没有音节以输入串开头时:输入的是小写字母且已有候选字,先把第 1 个候选字作为输出(`$6922` 为 2),清空输入后以这个字母重新开始;输入的是小写字母但没有候选字,只丢掉这个字母;输入的不是小写字母(大写字母、数字、符号等),原样传回并丢掉这个键。输入串只是某个音节的前缀时只显示输入串;与某个音节完全相同时从词库取候选字(每页 5 个,页序号 ERAM `$690B` 清 0,后面还有候选字时 ERAM `$6903` 位 7、6 置位,没有候选字时显示提示)。没有输入时第一个键不是小写字母,原样传回。已有候选字时 `=`、`.` 翻到下一页(要 `$6903` 位 7 置位),`-`、`,` 翻到上一页;数字键 1-5、空格、Alt+1-5 的选字由通用处理完成(见 `$0B`),空格不会走到输入法自己的处理;退格删一个字符并重新查表。已验证(408 个全拼音节与 465 个双拼键位逐个输入并选字,另有翻页、自动输出候选字、非字母键、退格等输入)。
|
|
588
|
+
|
|
589
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
590
|
+
| --- | --- | --- | --- |
|
|
591
|
+
| `$00` | `IME_SUB_00` | 初始化:先把 `$069A-$069E` 存入 ERAM `$6912`、`$690E`、`$690F`、`$6911`、`$6910`(状态行的行、两字节瓦片起点、子功能、颜色),再看输入法序号 `$069F`:不小于 10 时 `$0640` 置 1 并返回(前面的参数已经写入,不撤销);否则 `$069F`、`$06A0`、`$06A1` 存入 ERAM `$6900`、`$6901`、`$6902`,把 ROM `$80B7` 的 24 字节说明文字“SUBOR 中文输入法 3.00 版”复制到 ERAM `$6961`,ERAM `$690D` 清 0,再按 `$6900` 的值选择输入法(等于调用 `$01`,所以序号 3-6 缺权限、序号 7 时 `$0640` 为 1,但状态已写入) | 已验证 |
|
|
592
|
+
| `$01` | `IME_SUB_01` | 选择输入法:`$0652` 低 4 位是序号 0-9(不小于 10 失败;序号 3-6 要 `$0392` 位 0-3 允许,7 不可选,失败时 `$0640` 为 1,状态不变);`$0652` 位 7 置位时再核对 ERAM `$6901` 的允许位(序号 0-5、8、9 对应 `$02 $04 $08 $10 $20 $40 · · $80 $01`,序号 6、7 看 ERAM `$6902` 位 4),不允许也失败;成功时清按键队列,ERAM `$6904`(输入长度)、`$6922`、`$6903`、`$690B`、`$690C`、`$6913`、`$6952` 清 0,`$6900` 低 4 位改成序号,状态行文字换成该输入法的名称(ERAM `$6902` 位 2 置位时不改显示),ERAM `$6902` 位 7 清 0;`$6900` 恰好等于 8(图形)时输入长度置 1、生成候选并显示 | 已验证 |
|
|
593
|
+
| `$02` | `IME_SUB_02` | 设置状态:`$0652` → ERAM `$6901`,`$0653` 低 7 位 → ERAM `$6902` 低 7 位(位 7 保留) | 已验证 |
|
|
594
|
+
| `$03` | `IME_SUB_03` | ERAM `$6902` 位 2(暂停)置位时清除它并刷新状态行;否则不做事 | 已验证 |
|
|
595
|
+
| `$04` | `IME_SUB_04` | 清候选数 ERAM `$6913`;ERAM `$6902` 位 2 为 0 时用颜色 0 画一次状态行(`$6910` 临时清 0,画完恢复)并置位 2,已置位时直接返回(暂停输入法,状态行清为空) | 已验证 |
|
|
596
|
+
| `$05`、`$06` | `IME_SUB_05`、`IME_SUB_06` | 状态行文字设为“半角”(B0EB BDC7)、“全角”(C8AB BDC7)并刷新,清、置 ERAM `$6902` 位 1 | 已验证 |
|
|
597
|
+
| `$07` | `IME_SUB_07` | 取当前输入法序号(ERAM `$6900` 低 4 位)到 `$0652` | 已验证 |
|
|
598
|
+
| `$08` | `IME_SUB_08` | 取状态:ERAM `$6901` → `$0652`,ERAM `$6902` 低 7 位 → `$0653` | 已验证 |
|
|
599
|
+
| `$09` | `IME_SUB_09` | 登记自定义输入法 6:`$069A` 起 5 个字节存入 ERAM `$697C-$6980`(`$697C` 是该输入法模块的页组,`$697D-$6980` 是状态行上显示的 4 字节名称),`$0392` 位 3 置位(允许选择序号 6),ERAM `$6902` 位 4 置位,并把 ROM `$828A` 的 32 字节“ 扩充输入法安装成功”复制到状态行显示 | 已验证 |
|
|
600
|
+
| `$0A` | `IME_SUB_10` | 等待并处理一个按键:反复调用 `$0B` 直到 ERAM `$6922` 不为 0;队列空而 `$6922` 仍为 0 时一直等下去 | 已验证(4 例) |
|
|
601
|
+
| `$0B` | `IME_SUB_11` | 处理一个按键(不等待):`$6922` 清 0,从队列取一个键(`$6B/$03`);没有键直接返回。结果标志在 ERAM `$6922`(0 无输出、2 输出汉字内码、`$82` 把按键原样传回,另有候选整体复制时为长度),输出在 ERAM `$6923` 起。处理顺序:Ctrl+F1(扫描码 `$5E` 无字符)暂停或恢复;ERAM `$6902` 位 2(暂停)置位时原样传回;Alt+F1-F10(扫描码 `$68-$71`,无字符)选序号 0-9(`$0652` 位 7 置位,要核对允许位),其中 Alt+F9(`$70`)在输入法 8 时是“输入长度加 1(到 10 回 1)并重建候选”,在其他输入法时切到 8,ERAM `$6901` 位 7 清 0 时不处理;Ctrl+F8、Ctrl+F9(`$65`、`$66`,ERAM `$6902` 位 5 置位时有效)切换半角与全角;Ctrl+F3(`$60`,位 6)切换联想方式,要等待按键;数字键 1-5 与空格在“输入长度不为 0 或 ERAM `$6902` 位 7(候选有效)置位”时选第 1-5 个候选(空格当 1;序号大于候选数时,空格显示提示并清输入,数字键交给输入法),Alt+1-5(`$78-$7C`,无字符,位 7 清 0 时)同样选候选;回车清输入或原样传回,退格在没有输入时原样传回;其余按输入法序号交给各输入法的处理。最后 ERAM `$6902` 位 1(全角)置位且 `$6923` 小于 `$80` 时按 ROM 里的符号表(`$9954` 起)把半角符号换成全角内码。成对符号 `[` `]` `{` `}` `"` `'` 由 ERAM `$690D` 记录奇偶,依次取左、右符号;英文输入法 9 直接查全角表 `$9983` | 已验证(序号 0、7、8、9 与全部全角符号,序号 1、2);序号 3-6、联想方式、Ctrl+F3 未验证 |
|
|
602
|
+
| `$0E` | `IME_SUB_14_HEX` | 把 `$064A`、`$064B` 的两个字节转成 4 个十六进制字符(小写)放到 ERAM `$6923-$6926` | 已验证 |
|
|
603
|
+
| `$13-$18` | `IME_EXT1_SUB_1-6` | 以子功能 1-6 调用外挂输入法模块 1:页组取 ERAM `$6979`(`IME_EXT1_GROUP`),经功能 `$25` 进入它的 `$8000` | 转发已验证(页组设成 `$0C`,进入的就是本模块的子功能 1-6,效果与 `$01-$06` 相同);真正的外挂模块(`WBX.BIN` 等)没有验证 |
|
|
604
|
+
| `$19-$1E` | `IME_EXT2_SUB_1-6` | 同上,调用外挂输入法模块 2(页组在 ERAM `$697A`) | 同上 |
|
|
605
|
+
| `$1F-$24` | `IME_EXT3_SUB_1-6` | 同上,调用外挂输入法模块 3(页组在 ERAM `$697B`) | 同上 |
|
|
606
|
+
| `$0D` | `IME_SUB_13_PARSE` | 把输入缓冲(ERAM `$6905` 起,最多 6 个字符,`$6904` 是已输入个数)里的 4 个字符转成汉字内码放到 `$064A`、`$064B`:全是数字当区位码(4 位十进制),第一个字符是 a-f 当 4 位十六进制内码;不合法时 `$064A` 清 0 | 已验证(序号 0 的按键输入也走同一段代码) |
|
|
607
|
+
| `$0C` | `IME_SUB_12` | 把当前页号存入 `IME_FAR_PAGE`,`IME_RESET_SEARCH` 后经功能 `$2B`(按远指针写 `$0653` 并后移)写一个 0 | 已验证 |
|
|
608
|
+
| `$0F`、`$11` | `IME_SUB_15`、`IME_SUB_17` | 全拼、双拼的词库查询:`IME_METHOD` 暂置 1(`$0F`)或 2(`$11`),把页号存入 `IME_FAR_PAGE`,用 `IME_TABLE_LOOKUP` 在拼音音节表(408 项,每项 6 字节)或双拼键位表(465 项,每项 2 字节)里查输入缓冲,命中(结果 1,完全匹配)时把命中项序号乘 2 存入 `IME_TABLE_OFFSET`,从词库(ROM 第 10-19 页,页组 `$10` 起映射到 `$B000` 窗口;开头是每项 2 字节的索引表,第 i 项指向第 i 个音节的候选字表)取出该音节的候选字表(连续的 2 字节内码,以 `$FF` 结束,各表首尾相接),经功能 `$2B` 写到页 `SYS_PAGE`(`$0641`)、偏移 `$14/$15` 起的调用者缓冲区并以 0 结束;没有完全匹配(前缀或不存在)时什么都不写,返回前还原 `IME_METHOD` 与输入长度 | 已验证(全拼 6 个音节、双拼 6 个键位逐字节核对候选字表,前缀与不存在的音节不写) |
|
|
609
|
+
| `$10`、`$12` | `IME_SUB_16`、`IME_SUB_18` | 汉字反查读音:按 `$064A/$064B` 的字在词库里查(`IME_FIND_CHAR_IN_DICT`),把命中候选的序号换算成全拼音节(`$10`,取音节表 `$88DD` 起每项 6 字节)或双拼键位(`$12`,取键位表 `$926D` 起每项 2 字节),经功能 `$2B` 逐项写到调用者缓冲区并以 0 结束(序号不小于 `$194`(全拼)或 `$1B1`(双拼)的候选及其后面的不写);没有候选时什么都不写 | 已验证(汉 `$BABA`、中 `$D6D0`、长 `$B3A4`(chang 与 zhang 两个读音)与不在词库里的 `$A1A1`) |
|
|
610
|
+
|
|
611
|
+
输入法的数据表(页组 `$0C` 里的窗口地址):下面两张表把内容解析出来核对过(观察,没有在模拟器里验证它们怎么被代码引用)。
|
|
612
|
+
|
|
613
|
+
- **拼音音节表**(`$88DD-$926C`):每条 6 字节,小写拼音用空格补齐,共 408 条,按字母顺序从 `a`、`ai`、`an`、`ang`、`ao`、`ba` 到 `zuo`(402 条),后面还有 6 条用字母 `v` 代表 ü 的音节 `nv`、`lv`、`jv`、`qv`、`xv`、`yv`。
|
|
614
|
+
- **两字母组合表**(`$926D-$9953`,约 1.7K):两个字母一组(如 `oa`、`os`、`bo`、`bu`…)的序列,像是双拼的键位组合表,含义没有确认。
|
|
615
|
+
- **标点与全角转换表**(`$9954-$9AA2`):“ASCII 字符 + 1 或 2 个 GB2312 字符”的串,`$FF` 分组。第 1 组是中文标点:`/`→、、`.`→。、`*`→×、`\`→…、`|`→々、`[`→【】、`]`→〖〗、`{`→《》、`}`→〈〉、`"`→“”、`'`→‘’(成对的符号有两个字符,像是左右引号依次输出);后面几组是全角字符转换:空格→全角空格、标点、数字和英文字母按 ASCII 顺序对应 GB2312 第 3 区的全角字符。
|
|
616
|
+
|
|
617
|
+
页 `$0E` 后面那一段和 `IME_SUB_12` 等子功能用到的其他表(候选字表)没有解读。
|
|
618
|
+
|
|
619
|
+
## 5.11 打印机服务(功能 `$76-$7A`,页组 `$0E`)
|
|
620
|
+
|
|
621
|
+
功能 `$76-$7A` 是同一个入口:分发器对这五个功能号做完全相同的事,只看子功能号(`SYS_SUBFUNCTION`,0-15),功能号之间没有区别。`$0391` 为 0 时换入页组 `$0E`(ROM 第 0E 页映射到 `$8000`)并从 `$8300` 进入(`PRN_ENTRY`);`$0391` 不为 0 时改换入页组 `$0390` 并从 `$8000` 进入,这是留给外挂打印驱动的位置(实测把 `$0390` 设成输入法的页组 `$0C`,进入的就是输入法的子功能,证实了这条路径)。页组 `$0E` 里的代码是 24 针点阵打印机的驱动:发送字节经并口数据寄存器 `$4025`,握手用 `$4026`、`$4017`(位定义见[硬件说明](03-硬件说明.md)),发送的命令是 Epson ESC/P:`ESC @`(复位)、`ESC <`(打印头回左端)、`ESC J n`(进纸 n/216 英寸)、`ESC $`、`ESC \`(横向定位)、`ESC * 39 nL nH`(24 针三倍密度位图,`nL nH` = `$0478` = 1144 列)。模拟器实现了 ESC/P 虚拟打印机,输出到系统打印机或 PDF、PNG 文件。入口先调用 `PRN_SUB_14`(`$038F` 为 0 时初始化并口,之后置 1),再把 `$064E` 存入 `$0544`(发送变换模式)、`$0648` 存入 `$0546`(每个字符后附加的空白列数)、`$0649` 存入 `$0547`(换行后的进纸量),`$0640` 清 0,然后按子功能号跳转。
|
|
622
|
+
|
|
623
|
+
**公共参数**:`$0646` 字宽倍率(0-5,每一列重复 1-6 次);`$0647` 点数模式(0 每个点上下各重复 2 次,1 每个点重复 3 次,2 是位图模式:把 32 字节字模展开缩放后合并,只打一遍);`$0648` 附加空白列数;`$0649` 行距(`ESC J` 的 n);`$064A` 不为 0 表示字模是 32 字节(汉字),为 0 是 16 字节(西文 8×16);`$064E` 发送变换模式。每个字符的列数据按每列 3 个字节(24 针)发送;发送时对每个字节做的变换由 `$0544` 决定(`$04B1` 是本遍已发送的字节数,每遍开头清 0):0 不变;1 只在 `$04B0` 为 1 的遍或位图模式里,每列第 3 个字节(`$04B1` 为 2,随后 `$04B1` 减 3 重新数起)的低 2 位置 1;2 取反;3 在 `$04B1` 的位 2、3 都为 0 的字节(每 16 个字节中的前 4 个)上或 `$44`;4 在 `$04B1` 的位 3、4 都为 0 的字节(每 32 个字节中的前 8 个)上或 `$AA`,其余字节或 `$80`;5、6、7 每 4 个字节(`$04B1` 低 2 位为 0)把 `$04B2` 左移、`$04B5` 右移一位(移出位 1 时多移一位并补进位,不是严格循环),再把 `$04B2`、`$04B5`、两者或到字节上;8 以上不变。数据结束标志 `$04BA` 为 1 时(打印空白)以上变换不做。`$0647` 为 0 且变换模式不是 1 时,另按 `$04BB` 计数,每 3 个字节里把一个换成 0(`$04B0` 为 0 的遍换第 1 个,为 1 的遍换第 3 个),这样两遍合起来每个点都能用到 24 针里的不同针位。
|
|
624
|
+
|
|
625
|
+
| 子功能 | 例程 | 作用 | 可靠程度 |
|
|
626
|
+
| --- | --- | --- | --- |
|
|
627
|
+
| `$00`、`$0D` | `PRN_SUB_00` | 打印一段文字(两个子功能完全一样)。文字起点是页 `$0641`、偏移(零页 `$14/$15`),`$064F` 为 0 或 `$FF` 时是结束符(读到该字节为止),否则是字节数(按字节数时回车换行只算 1 个字节、控制码的参数字节不计入,每换一行计数重新从原值数起)。逐行打印:每行先发 `ESC @` 与 `ESC * 39 1144`,然后逐字符取字模、转置、展开、发送,字符之后补空白列直到满 1144 列(行满时放不下的字符移到下一行);非位图模式每行打两遍(中间发 `ESC J $18` 进纸),第二遍重新取同一行文字,位图模式只打一遍;行末按 `$0647` 非 0 发 `ESC J $17` 与 `ESC J $0547`,为 0 发 `ESC J $08` 与 `ESC J $0547`,再发 `ESC <`。进纸量从页长计数 `$04BC/$04BD` 里扣除,剩余不足 `$58` 时发 `ESC J` 收尾进纸并按 `$0652` 重新装入页长(同 `$0F`)。文字里的字节:`$20-$7E` 西文(`$7F` 当空格,字模取 ROM `$51100` 起的 8×16 西文字库,宽 8 列),`$A0` 以上与后一个字节组成 GB2312 汉字(`$A1-$A9` 区符号、`$B0-$F7` 区汉字,宽 16 列);`$0D $0A`、`$0C $0A`、`$8D $8A` 换行(回车、换页或 `$8D` 后面不是换行时,后一个字节被吃掉,当作下一个字符);`$1A` 跳过;控制码 `$92 n`(n 为 `$80-$97`,查表设置 `$0646` 与 `$0647`)、`$95 n`(n 为 `$80-$87`,查表 `03 04 05 06 07 01 02 00` 设置 `$0544`,只在本遍有效)、`$99 n`(`$0546` = n − `$80`)、`$9B n`(`$0547` = n − `$80`),`$94 n`、`$9A n` 吃掉参数但什么都不做,其余 `$80-$9F` 不带参数、什么都不做 | 西文、汉字、控制码与各种参数已验证(72 例,逐字节核对发送序列);`$00-$1F` 与 `$F8` 区以上走用户字库、打印机未就绪的出错分支未验证 |
|
|
628
|
+
| `$01` | `PRN_SUB_01` | 发送 `$1B $40`(`ESC @`) | 已验证 |
|
|
629
|
+
| `$02` | `PRN_SUB_02` | 发送 `$1B $3C`(`ESC <`) | 已验证 |
|
|
630
|
+
| `$03` | `PRN_SUB_03` | 先做子功能 1,再发送回车 `$0D` | 已验证 |
|
|
631
|
+
| `$04` | `PRN_SUB_04` | 发送 `$1B $4A n`(n 取自 `$0649`) | 已验证 |
|
|
632
|
+
| `$05`、`$06` | `PRN_SUB_05`、`PRN_SUB_06` | 发送 `$1B $24`、`$1B $5C` 加两个字节(`$04B3`、`$04B4`) | 已验证 |
|
|
633
|
+
| `$07` | `PRN_SUB_07` | 把 `$04A4` 里的一个字节发送给打印机(不做变换),其他固定命令都经它发送;`$0640` 为 `$FF` 时什么都不发 | 已验证(发送;`$0640` 为 `$FF` 的分支未验证) |
|
|
634
|
+
| `$08` | `PRN_SUB_08` | 发送 `$1B $2A $27 $78 $04`(`ESC * 39 1144`) | 已验证 |
|
|
635
|
+
| `$09` | `PRN_SUB_09` | 把 `$0524` 起的字模(`$064A` 非 0 时 32 字节,否则 16 字节)复制到 `$04C4`,再按位转置成列数据放回 `$0524` 起的 32 个字节:输出字节 2c、2c+1(c 为 0-7)分别是字模前 8 行与后 8 行第 c 列(最高位为第 0 列)的位拼成的字节(第 0 行在最高位);字模是 32 字节时,后 16 个输出字节同样取自右半边字模;16 字节字模时后 16 个输出字节取自 `$04D4` 起的旧数据(不是字模),之后不会被发送;结束时 `$04A6`=1、`$04A7`=`$20`、`$04AA/$04AB`=`$04D4` | 已验证(逐字节与模型比对) |
|
|
636
|
+
| `$0A` | `PRN_SUB_10` | `$0647` 为 0:`$04B0` 为 0 时取 `$0524` 起的偶数下标字节(为 1 取奇数下标),每位重复 2 次展开成 16 位放进 3 字节槽的后两字节(`$04B0` 为 0)或前两字节(为 1);`$0647` 为 1:每位重复 3 次展开成 24 位;两种都生成 16 组、共 48 字节放 `$04C4` 起;`$0647` 为 2:位图模式,32 个字节各展开成 24 位,再把每 16 位缩成 8 位,最后把相邻两列(各 3 字节)A、B 扩成 A、A|B、B 三列,合成 8 组 9 字节放 `$04C4` 起 | 已验证 |
|
|
637
|
+
| `$0B` | `PRN_SUB_11` | 逐列发送 `$04C4` 起的 3 字节一列的数据,每列重复次数由 `$0646` 决定(非位图模式重复 `$0646` + 1 次,上限 6;位图模式重复 max(`$0646`, 1) 次,上限 5),共发 8 组(`$064A` 为 0)或 16 组(非 0);位图模式共 12 组或 24 组;每发一组列计数 `$04A8/$04A9` 加 1,到 `$0478` 时本行结束并转入换行流程 | 已验证 |
|
|
638
|
+
| `$0C` | `PRN_SUB_12` | 发送 `$0648` 组空列,每组 3 个字节(值为 0,再经变换模式处理);`$0648` 为 0 时循环计数从 1 数到 255 再回到 0,发送 256 组;作为 `$00` 流程的一部分时按 `$0546` 发送附加列(为 0 不发) | 已验证 |
|
|
639
|
+
| `$0E` | `PRN_SUB_14` | `$038F` 为 0 时初始化并口(`$4026` 置位 `$38`,`JOY2_FRAME`、`JOY1` 的控制位)、调用功能 `$1B` 等待,并把 `$038F` 置 1;之后不再初始化。入口每次都先调用它 | 已验证(`$038F` 的变化;并口位未逐位核对) |
|
|
640
|
+
| `$0F` | `PRN_SUB_15` | 按 `$0652` 选页长计数初值写入 `$04BC/$04BD`(`$04BC` 是高字节、`$04BD` 是低字节,进纸时从低字节扣除):0 → `$076C`(1900),1 → `$09DB`(2523),2 → `$083A`(2106),3 → `$05D0`(1488),4 → `$081D`(2077),5 → `$071D`(1821),单位是 1/216 英寸(`ESC J` 的单位),1 号为 11.68 英寸,与 A4 纸长 11.69 英寸相符;`$0652` 不小于 6 时只把 `$0652` 存入 `$04BC`,`$04BD` 不变 | 已验证 |
|
|
641
|
+
|
|
642
|
+
注意同一页 ROM 还有另一用途:页 `$0E` 的前 `$023C` 字节是输入法服务(页组 `$0C`,映射到 `$A000`,见 5.10 节)的后半。
|
|
643
|
+
|
|
644
|
+
## 5.12 显示与窗口服务(功能 `$3B-$61`,页组 `$08`、`$09`、`$0A`、`$0B`、`$0F`)
|
|
645
|
+
|
|
646
|
+
这些功能先由分发器换入页组,再由页组入口处的“内联跳转表”按功能号选处理例程(页组 `$08` 的入口在 `$8000`,表在 `$8009`,`$3B-$46` 共 12 项;页组 `$09` 入口 `$8500`,`$4A-$54` 共 11 项;页组 `$0A` 只有 `$59` 一个入口 `$8160`;页组 `$0B` 的 `$5A-$61` 共 8 项;页组 `$0F` 的 `$47-$48` 两项,`$66` 由分发器直接进入页组 `$0F` 的 `$8700`,不经入口表)。参数在 `$0646-$0654` 的显示参数区:`$0646/$0647` 是位置,`$0648/$0649` 是宽与高(屏幕按 32×30 个图块计),`$064A/$064B` 是字符码,`$064C/$064D` 是显示地址,`$064F` 是结束符或宽度,`$063F` 是子功能。以下都是读代码得到的(代码阅读,除标明外没有实机验证):
|
|
647
|
+
|
|
648
|
+
| 功能号 | 例程 | 作用 | 可靠程度 |
|
|
649
|
+
| --- | --- | --- | --- |
|
|
650
|
+
| `$3B` | `API_3B_GLYPH_ADDR` | 按字符码(`$064A` 高、`$064B` 低)查出字模所在的页与地址,不绘制,结果放 `$0644`(页)、`$0E/$0F`(页内偏移,`$0F` 或上窗口位)与 `$0638` 低 3 位(字模形式);字符串显示例程内部也调用它。字符码高字节为 0 时:`$20-$7F` 取公共 ASCII 字模(`$0638` 位 7 为 0 取 8×8,在 ROM `$50E00 + (码−$20)×8`;为 1 取 8×16,在 `$51100 + (码−$20)×16`),其余(`$00-$1F`、`$80-$A0` 等)与 `$0638` 位 6 为 1 时取用户字库表 `$067E-$0686`;高字节不小于 `$A1` 时按 GB2312 区位处理:`$A1-$A9` 区是符号(ROM `$51700 + ((区−1)×94 + (位−1))×32`),`$B0-$F7` 区是汉字(ROM `$1C000 + ((区−16)×94 + (位−1))×32`),`$F8` 区以上取用户字库表,其他码不合法,`$0640` 置 `$FF`。汉字字模 32 字节:前 16 字节是每行左半边,后 16 字节是每行右半边。`wps/WPS.EXE` 等调用过 | 已验证(各条路径的输出,字模位置另与 ROM 里的真实字形核对) |
|
|
651
|
+
| `$3C`、`$3D` | `API_3C_3D_PUT_STRING` | 显示以 `$064F` 为结束符的字符串(指针 `$0C/$0D`,页组 `$0642`),先画到屏外缓冲(扩展 RAM 页 `$F8` 起,窗口地址 `$A000`)再 DMA 到显存瓦片 `$064C/$064D`(目的地址 = 瓦片号 ×16,超出显存末尾时截断)。`$3C` 画二平面瓦片(每个 8×8 点阵 16 字节),平面的内容由 `$064E` 的位 0、1、4、5 查表决定(子功能最高位为 1 时改查另一张表);`$3D` 画四平面瓦片(32 字节),平面由 `$064E` 的位对(b0b4、b1b5、b2b6、b3b7)各折成 0-3 决定:常量取 `$00,$00,$FF,$FF`,是否取字模取 `$00,$FF,$FF,$00`,常量非 0 时字模取反。`$0638` 位 7 为 0 时单字节字符前补一个空白瓦片(用常量填充)。`$3D` 在 `wps/EDIT.EXE`、`wps/WPS.EXE` 里被大量调用 | 已验证(缓冲内容逐字节与 DMA 寄存器) |
|
|
652
|
+
| `$3E`、`$3F` | `API_3E_3F_PUT_STRING_ASCII` | 同 `$3C`、`$3D`,只处理单字节字符,且不补空白瓦片 | 已验证(同上) |
|
|
653
|
+
| `$40-$44` | `API_40` 至 `API_44` | 同一族的屏幕单元写入服务:把单元(每格 2 字节,低字节在前)写进名称表缓冲(扩展 RAM 页 `$FA` 起,子功能低 2 位选哪一张名称表,每张 2KB、每行 64 字节),写完用功能 `$30` 把整张名称表 DMA 到显存。起点是 `$0648` 列、`$0649` 行,`$064C/$064D` 是单元的起始值(高字节低 4 位保留,高 4 位由调色板号 `$0654` 合成,`$0652` 为 1 左移 4 位,否则 6 位),单元总数 `$064F/$0650`。**`$41`**:每次写上下两格(偏移 +0 与 +`$40`)值依次为 v、v+步长,v 再加步长,左移到下一列;一行写 `$064B` 个(受 `32 − 列` 限制)后换行,行距 `$064A + 2`,行号不小于 30 停止;步长由 `$0652` 决定(先经内部规整:0 取 `$062E` 位 7,规整后 0 和 4 成 1,其余成 2)。**`$43`**:同 `$41`,每次只写一格,行距 `$064A + 1`。**`$42`**:按列写,每次连写左右两格(v、v+2×步长,再按奇偶调整 v)后下移一行,列高 `$064A`(受 `30 − 行` 限制),列距 `$064B + 2`,列号不小于 31 停止。**`$44`**:按列写单格,下移一行,列距 `$064B + 1`,列号不小于 32 停止。`$0651` 控制刷新:最高位为 1 时每写一格刷新一次(低 7 位为 1 则不等待,大于 1 每次再等一帧);为 1-127 时每写 `$0651` 格刷新一次,写完再刷新一次(`$42`、`$44` 计数不清零,数到之后每格都刷新,是原实现的特点);为 0 时写完刷新一次;单元总数为 0 时什么都不做。**`$40`**:子功能位 2、3 为 0 时从起点线性写 `$064C/$064D` 常量单元(总数不超过名称表剩余单元数;`$0651` 同上,但为正数时只在 `$0651` 为 1 时每格刷新,原实现的特点;总数为 0 时不检查,会当作 65536 处理,未实测);位 2、3 为 `01` 时从 `$0C/$0D`(页组 `$0642`)指向的内存按行复制单元(行宽 `$064B`,行距 `$064A + 1`);其余按列复制(高度 `$064A + 1`,列距 `$064B`)。`$41` 在 `wps/EDIT.EXE`、`wps/WPS.EXE` 里整块清出编辑区 | 已验证(整张名称表缓冲逐字节与 `$30` DMA 次数) |
|
|
654
|
+
| `$45` | `API_45_PUT_TEXT_FIELD` | 在 `$0648` 列、`$0649` 行起显示 `$0C/$0D`(页组 `$0642`)指向的以 0 结尾的字符串(字符码不小于 `$A1` 按两字节汉字,汉字占 2 列):先按 `$3C`/`$3D` 的规则把字符串画到屏外缓冲(调用内部先调用 `$1E/0`,`$062E` 位 7 为 0 画二平面、为 1 画四平面,`$064E` 与 `$0638` 位 7 同 `$3C`),DMA 到显存瓦片 `(($064D & $0F) × 256 + $064C) × 16`,再把上下两行单元写进名称表缓冲并 `$30` 刷新:上行第 k 列值为 `$064D:$064C` + 2×步长×k,下行同列值再加步长(二平面步长 1,四平面 2)。宽度限制在 `32 − $0648` 列;汉字起点离右边界不足 2 列时不画并结束,汉字后边界检查被跳过,所以汉字正好排满后还会再画一个单字节字符。没有画出字符时不做任何 DMA。子功能同 `$30`(选名称表)。DOS 画底部状态栏用 `$6F80`(行 28) | 已验证(瓦片缓冲、名称表缓冲与两次 DMA;另用实验程序重放过 DOS 的调用) |
|
|
655
|
+
| `$46` | `API_46` | 与 `$45` 相同,但只处理单字节字符,不补空白瓦片,只写一行单元:第 i 列值为 `$064D:$064C` + 步长×i | 已验证(同 `$45`) |
|
|
656
|
+
| `$47`、`$48` | `API_47`、`API_48` | 把字符串画成点阵瓦片写进调用者指定的扩展 RAM 地址(不经显存),画字规则同 `$3C/$3D`(`$47`:汉字与单字节字符,8×8 的单字节字符前补一个空白瓦片)与 `$3E/$3F`(`$48`:只处理单字节字符,不补空白瓦片)。输入:字符串 `$0C/$0D` 与页组 `$0642`;目的地址 `$12/$13`(窗口地址,高 4 位选页)与页组 `$0643`,页号 = (`$13` 的高 4 位) − 8 + `$0643`(同 `$61`);`$064E` 与 `$0638` 位 7 同 `$3C`;`$0653` 是结束符(与字符串里的字节比较,汉字比较第一个字节);`$0650:$064F` 调用时是目的区还能容纳的字节数,返回时是实际写入的字节数(不够容纳下一个字符时在该字符之前停止)。平面数由 `$0652` 决定:4 画二平面,0 先调用 `$1E/0` 查 `$062E` 位 7(0 二平面、其他四平面),其他值画四平面。每个瓦片二平面 16 字节、四平面 32 字节,按平面顺序各 8 字节,所以 `$47` 二平面汉字 64、单字节 32 字节(四平面 128、64),`$48` 二平面单字节 16 字节(四平面 32),`$0638` 位 7 为 1 时 `$48` 每个字符乘 2。目的区跨 4KB 页时窗口 2、3 的映射随之后移,输出线性连续;字符串超过 256 字节时分段取入,汉字的第一个字节恰在段末时重新取入。子功能最高位(换另一张设置表)对输出没有影响(两张表给出的画面完全相同)。官方软件没有调用过 | 已验证(100 例,目的区逐字节、返回的字节数;二、四平面各种 $064E、平面选择、结束符、容量不足、跨页、长字符串) |
|
|
657
|
+
| `$4A` | `API_4A` | 伪随机数:32 位移位寄存器 `$0696-$0699`,子功能不为 0 步进一次,为 0 连续步进 100 次;寄存器两个高字节全 0 时先把 `$0697` 置 `$FF` | 已验证 |
|
|
658
|
+
| `$4B` | `API_4B` | 16 位除以 8 位:`$069A/$069B` 除以 `$069C`,商回写 `$069A/$069B`,余数写 `$069C` | 已验证(同上) |
|
|
659
|
+
| `$4C` | `API_4C` | 把 `$069A`、`$069B`、`$069C`(时、分、秒)转成 `HH:MM:SS` 放 `$06AA-$06B1` | 已验证(同上) |
|
|
660
|
+
| `$4D` | `API_4D` | 十进制串转数值,串在 `$069A` 起。子功能 0:首字符为符号(空格或 `-`),后面是带小数点的数字,结果是 7 字节浮点数放 `$06A8` 起;子功能 1:`$069A` 低 4 位是位数 n,`$069B` 起的 n 位数字(前导空格当 0)转成 40 位整数放 `$06AA-$06AE`(高字节在前,超过 40 位时高位丢弃);子功能 2:`$069A` 低 4 位是小数位数 n,`$069B` 起是 `.` 与 n 位小数,转成 40 位小数(值 = 数 ÷ 2^40,取整)放 `$06AF-$06B3`,`$06AA-$06AE` 保持原值,调用后 `$069A` 为 `$0C`、`$069B-$06A7` 清 0。官方 BASIC 调用 | 已验证(子功能 2 逐位与独立的整数算术比对) |
|
|
661
|
+
| `$4E` | `API_4E` | 数值转十进制串。子功能 0:`$06A8` 起的浮点数转成 13 个字符(符号加 12 位带小数点的数字)放 `$069A` 起;子功能 1:`$06AF-$06B3` 的 40 位整数转成 13 位数字放 `$069B-$06A7`,`$069A` 是去掉前导 0 后的有效位数(至少 1),数字左对齐、右边补字符 0,不小于 10^12 时 `$0640` 置 `$FF`,调用前若 `$06A8` 为负,先把 `$06AA-$06AE` 右移相应位数;子功能 2:`$06AF-$06B3` 的 40 位小数从 `$069A+X`(X 为 `$069A` 低 4 位,不小于 14 时不转换)起转成十进制小数位,每位取整后余数乘 10 继续。子功能 1 在 `FORMAT.EXE`、`EDIT.EXE` 等官方软件里调用 245 次 | 已验证 |
|
|
662
|
+
| `$4F`、`$50` | `API_4F`、`API_50` | 浮点乘、除:两个操作数在 `$069A`、`$06A1` 起,每个 7 字节(阶码、符号 `$00`/`$FF`、5 字节尾数),值 = ±尾数 ÷ 2^40 × 2^阶码,结果在 `$06A8` 起(除数尾数为 0 时 `$06A8` 置 `$80`)。子功能不为 0 时先把两个操作数的阶码都置为子功能的高 4 位右移一位、符号置正,运算后再把结果右移成 40.40 定点数放 `$06AA-$06B3`(整数部分在前 5 字节,小数部分在后 5 字节;结果为 0 时 `$0640` 置 `$80`) | 已验证(子功能非 0 时允许最低几位的截断误差) |
|
|
663
|
+
| `$51`、`$52` | `API_51`、`API_52` | 浮点加、减(格式同上;减法先把第二个数的符号取反再加) | 已验证 |
|
|
664
|
+
| `$53` | `API_53` | 直线步进(布雷森汉姆算法):`LINE_BLOCK_PTR_LO` 指向 18 字节参数块,偏移 0-3 是起点与终点(x0、y0、x1、y1),偏移 4 是前进步数(0 按 256 步)。从 (x0, y0) 向终点前进该步数,落点写回偏移 0、1;步数不小于主轴长度时直接落在终点。偏移 5-8 存两轴长度与方向,9-`$11` 是误差与中间量。PAINT 调用过 | 已验证(30 组起点、终点、步数,逐字节核对整个参数块) |
|
|
665
|
+
| `$54` | `API_54` | 3 字节整数运算:两个数各为 1 个符号字节(`$00` 正、`$FF` 负)加 3 个数值字节(高字节在前),放 `$069A` 起与 `$069E` 起。子功能 0 加、1 减(先把 `$069E` 符号取反)、2 乘、3 除,其余子功能不做事。加减:符号相同相加(进位放 `$06A3`),不同则大数减小数(相等时结果全 0),符号在 `$06A2`,结果在 `$06A4-$06A6`;乘:符号在 `$06A2`,48 位乘积在 `$06A3-$06A8`,乘数 `$069F-$06A1` 被清 0;除:商在 `$06A4-$06A6`、余数在 `$06A7-$06A9`、符号在 `$06A3`,除数为 0 时 `$06A2` 置 `$FF`,除法经浮点运算实现,实测商与余数与整数除法完全一致 | 已验证(以独立的整数算术核对 198 个例子,官方软件没有调用) |
|
|
666
|
+
| `$59` | `API_59` | 窗口管理(页组 `$0A` 入口,子功能 `$063F`):把屏幕矩形存进扩展 RAM 页 `$FC-$FF`(窗口地址 `$8000-$BFFF`,共 16KB),以后原样写回。布局:`$8000-$8059` 是窗口表,30 项 × 3 字节(窗口号、保存数据地址低字节与高字节,窗口号 `$FF` 空闲);`$805A/$805B` 是保存区末尾(初始 `$8060`);`$805C-$805F` 是窗口号占用位图(第 1 号对应 `$805C` 的位 7,第 9 号对应 `$805D` 的位 7,依次类推);`$8060` 起是保存区。每个窗口的保存数据:2 字节总长度 T,每行一段「字节数(宽 × 2)、名称表缓冲地址低字节与高字节、内容」,最后一个 `$00`,T = 行数 × (字节数 + 3) + 3;名称表缓冲地址 = `$8000` + 名称表号 × `$800` + 行 × `$40` + 列 × 2。**子功能 0-3 新建**:子功能号即名称表号,`$0646/$0647` 是左上角列与行,`$0648/$0649` 是**右下角**列与行(含),列须小于 32、行小于 30,右下不小于左上;返回 `$0652`:成功为窗口号(取最小的空闲号,1-30);超界或右下小于左上 `$FD`;30 个窗口用完 `$FE`;保存区装不下(新末尾地址高字节大于 `$BF`)`$FF`,出错时窗口表和保存区都不变。**子功能 4 还原**:按 `$0652` 的窗口号把保存的内容写回名称表缓冲(原来的地址),删掉表项(后面的表项前移)、清位图;只有删掉的是表里最后一项时才把保存区末尾减去它的 T,否则保存区留下空洞(不回收);返回时 `$0652` 变成 ((窗口号 − 1) mod 8) + 1;窗口号不小于 `$1F` 或表里没有时什么都不做,`$0652` 不变。**子功能 5 整理保存区**:没有窗口时末尾回到 `$8060`;否则把后面的数据前移填掉空洞。第一个窗口之前的空洞按真实大小修正全部表项;之后窗口之间的空洞,表项里的保存地址却减去前一个窗口的长度 T,不是空洞的大小,所以只有空洞大小恰等于前一个窗口长度时才正确,否则表项指向乱数据,再还原会读到垃圾而不返回。**子功能 6 初始化**:30 个窗口号写 `$FF`,末尾写 `$8060`,位图清 0,`wps/EDIT.EXE` 启动时调用一次。其他子功能什么都不做。新建只保存名称表缓冲,还原也只写回名称表缓冲,代码里没有调用 `$30` 刷新显存,所以屏幕要由调用者自己刷新(早先“用 `$41` 填充后还原,屏幕没有恢复”的实测即由此而来:`$41` 写缓冲后会 DMA,还原不会) | 已验证(36 例,页 `$FC-$FF` 与名称表缓冲逐字节,含 30 个窗口、保存区装满、出错分支、整理的各种空洞) |
|
|
667
|
+
| `$5A` | `API_5A` | 把 `$0C/$0D`(页组 `$0642`)指向的 `$0650:$064F` 个字节不解压、直接 DMA 写进显存瓦片 `$064C/$064D` 处(目的地址 = 瓦片号 ×16,取低 16 位,超出的高位丢弃;DMA 长度寄存器写长度减 1,长度为 `$0100` 时低字节借位);`$0650:$064F` 为 0 时直接返回。DMA 后等垂直消隐:`$062B` 位 3、4 都为 0(显示关闭)等 1 次,否则等 1 + `$0650 ÷ $1C` 次(`$0650` 每 `$1C` 多等 1 次)。 | 已验证(13 例,DMA 的 8 个寄存器、等待帧数) |
|
|
668
|
+
| `$5B` | `API_5B_UNPACK_TILES` | 解压图案流并 DMA 写进 `$064C/$064D`×16 起的显存:`$0C/$0D` 指向 16 字节字典加指令流(`$00` 结束);指令字节高 4 位 H、低 4 位 L:H=1-12 把字典第 L 项重复 H 次,H=`$D` 后跟 L 个原样字节,H=`$E` 后跟 1 个字节重复 L 次,H=`$F` 后跟起始字节输出 L 个递增字节;输出先放在扩展 RAM 页 `$F8` 起的缓冲,每条指令后缓冲不少于 `$1C00` 字节就 DMA 并前移显存地址,结束时缓冲非空再 DMA 一次。L 为 0 时 H=`$E`、`$F` 写 256 个字节但输出指针不前进(什么都不输出),H=`$D` 为 256 个原样字节;H=`$F` 的递增带进位,回绕后每次加 2 | 已验证(13 例,缓冲与 DMA 寄存器逐项) |
|
|
669
|
+
| `$5C` | `API_5C_UNPACK_MAP` | 解压映射流并按效果写进屏幕:流里的 16 位单元先加上 `$064C/$064D` 的基础值与调色板位(`$0654` 左移 4 位或 6 位并入高字节:`$0653` 为 4 取 4 位,为 `$10` 取 6 位,其他值时 `$0652`(效果号)为 0 取 4 位、非 0 取 6 位),再按 `$0652`(效果号 0-8,不小于 9 取 0)把宽 `$064B`、高 `$064A`、原点 `$0648/$0649` 的矩形逐行或逐列写进名称表缓冲(子功能低 2 位选名称表),并用 `$30` 把名称表 DMA 到显存。指令字节高 3 位 T、低 5 位 N:`$00` 结束;T=0 取一个 16 位值填 N 个;T=1 取一个值,N 个单元依次加 1(只加低字节);T=2 取 N 个 16 位值;T=3 先取一个高字节再取 N 个低字节;T 不小于 4 取一个值,N 个单元依次加 2;每个单元加基础值,加法的进位串到下一个单元。效果 0 逐行向下、1 逐列向右、2 逐列向左、3 逐行向下(带等待)、4 逐行向上、5 边框收缩后向外扩展、6 边框向内、7 从中线向两边、8 从两边向中线;`$0651` 不小于 5 时每步 DMA 并等 `$0651 − 5` 帧,小于 5 时每 `6 − $0651` 步 DMA 一次。矩形限制在 32×32 内,起点列或行不小于 32 或宽高为 0 时什么都不写 | 已验证(效果、速度、调色板位、越界共 31 例,名称表缓冲逐字节) |
|
|
670
|
+
| `$5D` | `API_5D_WRITE_PALETTE` | 把 `$0C/$0D`(页组 `$0642`)指向的 `$064F` 字节写进调色板寄存器 `$2040 + $0647` 起(`$064F` 为 0 直接返回)。先取 `$062B` 位 3、4(结果放 `$0652`,调用时 `$0652` 的值无意义):为 0 直接写;不为 0 再看 NMI 是否打开:没开等一次垂直消隐后直接写,开了让 NMI 处理程序写(`$0630` 位 1 置位,等一帧后清除,每个字节写 1 或 2 次,次数是这一帧里的 NMI 次数)。调色板寄存器读不回,验证按写入记录。 | 已验证(9 例,三条路径与偏移、长度边界) |
|
|
671
|
+
| `$5E` | `API_5E` | 显示整屏图片:10 字节头 [宽、高、图案数(16 位)、调色板组数、每组色数、映射流偏移(16 位)、调色板偏移(16 位)](偏移相对头的起点),`$0C/$0D` 指向头;头里的宽高与组数不用。图案流(头后)同 `$5B`,起始瓦片 `$064C/$064D`;映射流直接按顺序解到名称表缓冲(子功能低 2 位选名称表)的开头,单元基础值是 `$064C/$064D`,不加调色板位,解完用 `$30` 整张 DMA 到显存,一次;调色板固定写 `$40` 字节到偏移 0(同 `$5D`)。偏移加到指针上时,进位后指针高字节加 `$80`、页号加 8,高字节不小于 `$C0` 时再减 `$40`、页号加 4(跨 16KB 窗口)。 | 已验证(7 例,含跨 16KB 窗口) |
|
|
672
|
+
| `$5F` | `API_5F_SHOW_IMAGE` | 显示图片:10 字节头同 `$5E`;先用 `$5B` 显示图案流(瓦片 `$064C/$064D`),再按 `$5D` 写调色板(偏移 = `$0653`(调色板组号)左移 2 位(头里每组色数为 4)或 4 位(其他),长度 = 头里组数同样左移;组数为 0 不写),最后用 `$5C` 把映射流按宽高、原点 `$0648/$0649`、效果 `$0652`、速度 `$0651`、子功能显示(单元基础值 `$064C/$064D`,调色板位用 `$0653` 的组号,位移取头里的每组色数)。页 78 的开机程序用图片参数表(源地址 `$0C/$0D`、页组 `$78` 写 `$0642`,再填 `$064C/$064D`、子功能、`$0652`、`$0653`、`$0648`、`$0649`、`$0651`)调用它。ROM 页 79-7F 里的 10 张图都能解出。 | 已验证(17 例,调色板偏移与长度、每组色数、效果、越界、跨 16KB 窗口) |
|
|
673
|
+
| `$60` | `API_60` | 用与 `$5C` 相同的效果把一个单元值(`$064C/$064D`,不加调色板位)铺满矩形(原点 `$0648/$0649`,宽 `$064B`、高 `$064A`),速度、越界规则同 `$5C` | 已验证(23 例) |
|
|
674
|
+
| `$61` | `API_61` | 解压到内存:`$0C/$0D`(页组 `$0642`)指向 16 字节字典加指令流(格式同 `$5B`),解到目的地址 `$12/$13`(窗口地址 `$8000-$FFFF`,高 4 位选页,低 12 位是页内偏移)、页组 `$0643`;页号 = (`$13` 的高 4 位) − 8 + `$0643`。解压前把目的页与下一页映射到窗口 2、3,每条指令后目的指针高字节不小于 `$B0` 时 `$0643` 加 1、重新映射,所以目的地址线性连续。指令同 `$5B`;H=0(指令字节 `$01-$0F`)只在目的指针后 `$FF` 处写字典第 L 项一个字节,指针不前进;H=`$E`、`$F` 的 L 为 0 写 256 个字节但指针不前进。返回:`$064F/$0650` 是解出的字节数,`$0643` 是目的指针最后所在的页,`$0642` 变成调用时 `$0643` 的值,`$12/$13` 是目的指针的最终位置。官方软件 `DEMO.EXE`、`TANG.EXE` 调用 | 已验证(19 例,目的区逐字节) |
|
|
675
|
+
| `$66` | `API_66` | 卡拉 OK 歌词滚动显示(页组 `$0F` 的 `$8700`,分发器直接进入,不经入口表;各盘 `WIN98` 目录的 `KARAOK.EXE` 调用):`TEXT_SETUP_DRAW` 设置条带绘制参数,`$65/$02` 停止声音、`$65/$09` 载入曲子并起播,`TEXT_INIT_STATE` 初始化文字排版状态,循环 `TEXT_BUILD_NEXT_LINE` 逐行建下一行(排入 NMI 条带动画队列),直到 `$65/$03` 查到曲子播完,再 `$65/$02` 停止并把 `$0630` 的高 2 位清 0 | 已验证(实机:在模拟器里运行官方软盘的 `KARAOK.EXE`,调用日志里有 `$66` 一次;歌曲播放期间 `NMI_FLAGS` 位 7 打开、条带队列里是 4 字节一项的命令、两行歌词的显示地址相差 `$38`,歌曲结束后位 7 清除;歌词排版的三个例程用特制歌词文字流逐步核对 16 例(英文与汉字、各种时长与附加时长、空格与空白、`^`、`$8E` 子段嵌套、擦除模式、随机歌词),逐字节比对 `$04A4-$05FF` 与零页 `$32-$34`;文字流格式见本手册第 10 节;官方 `KARAOK.EXE` 自带的整首歌词也已逐步对照通过) |
|
|
676
|
+
|
|
677
|
+
$5A-$61 的共同特点:这些功能返回后 `$0640` 恒为 0(代码里置的 `$FF` 被调度桩随后调用的 `$13/$80` 清掉),出错与否看效果。
|
|
678
|
+
|
|
679
|
+
显示单元与缓冲模型(已验证,逐项规则见上表):屏幕是 32×30 个单元,每个单元 2 字节(`$064C` 低字节、`$064D` 高字节,高 4 位是调色板),一行 64 字节(`$40`);名称表缓冲在扩展 RAM 页 `$FA` 起(子功能低 2 位选哪一张,每张 2KB),`$40-$46` 写完缓冲后用功能 `$30` DMA 到显存,所以屏幕要等写回才变;`$0648`、`$0649` 是起点的列与行,`$064B`、`$064A` 与行、列步长的关系见上表,`$064F`、`$0650` 是要写的单元个数,`$0651` 决定刷新方式,不为 0 时按帧等待(做动画)。子功能 `$063F` 的位 2、3 为 0 时 `$40` 写入重复的单元,否则把 `$0C/$0D`(页组在 `$0642`)指向的缓冲逐单元复制到屏幕。实测(用实验程序经调试器发起调用,请求块里的多字节要写成连续的十六进制串,如 `write cpu 7E0B 0505`):功能 `$40` 子功能 0、起点 (0,0)、个数 `$0400`、单元 `$00FF` 调用后整屏变黑(DOS 的屏幕本来就是黑底,所以用 `$FF` 填小块看不出来),说明子功能 0 对应的名称表就是当前显示的那张,填充和个数、`$064C/$064D` 的用法与上面一致;同样的整屏填充用子功能 1 时画面变成蓝色横条纹:第 1 张名称表(CRAM `$0800-$0FFF`)也参与当前画面的显示,DOS 画面上它的单元大多是 `$0F50`、文字所在位置是 `$0Fxx`,整张填成 `$00FF` 后文字行出现蓝色横条纹;用子功能 2、3 填充写入的是 CRAM `$1000-$17FF`、`$1800-$1FFF`,这两张表 DOS 画面不显示,画面不变(`$062E` 位 0 为 1 时目标地址再加 `$2000`,子功能 0 写入 `$2000-$27FF`,子功能 2 的目标 `$3000` 超出 CRAM 的 `$2800` 字节,调用后 CRAM 与 VRAM 都没有变化)。用 `$3C` 显示字符串(`$0642` 写 `$80`,`$0C/$0D` 指向程序里的字符串)时,`$064C/$064D` 是图块号:调用后它被换算成字节地址(图块号 ×16,实测 `$000A` 变成 `$00A0`),字符串被渲染成点阵写进图案区的这个图块起的位置(每个图块 16 字节),DOS 屏幕上的文字也是这样画的,所以图块号 0 起改写的是屏幕最上面几行文字的图案,图块号 10 起改写的是它后面一行,画面上能看到被改写的文字(实测)。`$3C` 不直接按行列定位,要让字符串出现在指定位置,得知道 DOS 文字区的图块排布,这一点没有核实。`$47`、`$48` 见上表(画到调用者指定的内存里,不写显存)。
|
|
680
|
+
|
|
681
|
+
同一页 ROM 在不同页组里会出现在不同的窗口位置:页 09 是页组 `$08` 的第 2 个窗口(`$9000`),也是页组 `$09` 的第 1 个窗口(`$8000`)。页 09 前 `$500` 字节是页组 `$08` 的代码(`$42-$44` 及它们的辅助例程,汇编地址 `$9000` 起),`$500` 起是页组 `$09` 的代码,汇编源码里用 `.rorg` 区分。从别的页指向这些例程的地址写成“标签+偏移”,偏移 4096 表示同一字节在另一个窗口里的位置差。
|
|
682
|
+
|
|
683
|
+
## 5.13 语音端口服务(功能 `$74`、`$75`,内核)
|
|
684
|
+
|
|
685
|
+
语音端口 `$4302` 的读写规则与 `$4026` 位 6 见[硬件说明](03-硬件说明.md)。语音数据是 LPC 码流:第 1 个字节 `$0A` 是开头标志,之后每帧先读 4 位能量(`0` 是静音帧,`15` 是结束帧),字节按位反序使用(见模拟器 `LPC_D6_SYNTH.C`)。`$032B` 是语音控制标志(位 0 为 0 同步发送,为 1 交给 NMI 逐字节发送;位 1 为 1 时已有传输就不等待;位 2 为 1 时发送后等传输结束;位 3 选命令字节 `$0A` 或 `$0B`;位 6 为 1 表示语音芯片已使用,调用时要先复位),`$0328` 是待发的命令字节,`$0329` 非 0 表示 NMI 正在发送(`$FF` 为请求发送,发出命令字节后放命令字节本身)。
|
|
686
|
+
|
|
687
|
+
| 子功能 | 作用 | 状态 |
|
|
688
|
+
| --- | --- | --- |
|
|
689
|
+
| `$74/$00` | 关闭:清 `$0332` 位 6 并写入 `$4026`,清 `$032B` 位 6 | 已验证 |
|
|
690
|
+
| `$74/$01-$09` | 置位或清除 `$032B` 的标志位:1 开位 6、2 开位 1、3 关位 1、4 开位 2、5 关位 2、6 开位 0、7 关位 0、8 开位 3、9 关位 3 | 已验证 |
|
|
691
|
+
| `$74/$0A-$0D` | `$032B` 位 6 为 1 时:`$4026` 位 6 置位,`$0328` = `$76` + 子功能(`$80-$83`),`$0329` 置 `$FF`;NMI 里先把 `$0328` 写进 `$4302`,再从 `$0035`(页)、`$0036/$0037`(页内偏移,到 `$1000` 进下一页)指向的扩展 RAM 逐字节读出写进 `$4302`,指针随之推进;`$4302` 低 4 位为 `$F`(播完)时写 `$0F`、清 `$0328/$0329`。位 6 为 0 时不发送 | 发送序列、指针推进、`$4026`、播完后写 `$0F` 并清 `$0328/$0329` 已验证 |
|
|
692
|
+
| `$75/$00` | 同步发送(`$032B` 位 0 为 0):先复位(`$4026` 位 6),再写命令字节 `$0A`,然后把 `$0642` 页组、`$0C/$0D` 窗口地址指向的数据逐字节写进 `$4302`,播完时写 `$0F`、清 `$0328/$0329` 并返回;`$032B` 位 0 为 1 时只登记数据位置(`$0329` 置 `$FF`)就返回,由 NMI 逐字节送出,位 2 为 1 时再等到送完才返回;`$032B` 位 3 为 1 时命令字节改用 `$0B` | 发送序列(`$0A` 加数据)、播完后写 `$0F` 并清 `$0328/$0329`、位 0、2、3 的各种组合已验证(命令 `$0B` 也是播完后写 `$0F`、清 `$0328/$0329` 并返回;旧版模拟器的语音合成器对 `$0B` 不给播完状态,现用的上游较新版会给) |
|
|
693
|
+
| `$75/$01` | `PORT4302_PREPARE_SEND` | 按序号发送词条:`$0642`、`$0C/$0D` 指向词条表,表头 2 字节是词条个数(低字节在前),之后每项 3 字节 [页号增量、相对表起点的偏移低字节、偏移高字节];序号(`$064A` 高、`$064B` 低)不小于个数时什么都不发送就返回,否则按该项算出词条位置,写命令 `$0A` 后发送词条数据,播完写 `$0F`、清 `$0328/$0329` | 已验证(序号 0、1 与越界) |
|
|
694
|
+
| `$75/$02` 及以上 | `API_75_PORT4302_SEND` | 播放列表:从保存的 `$032A`(页组)与 `$0A/$0B`(窗口地址)处取列表,表头 2 字节是“项数减 1”,每项 3 字节 [序号低字节、序号高字节、等待帧数 `$0651`];每项按子功能 1 的规则在调用者给的词条表里选段发送(序号越界时什么都不发),再在 `DELAY_FRAMES_0651` 里等 `$0651` 次垂直消隐标志(为 0 不等),然后取下一项;NMI 处理程序也读状态寄存器清标志,所以每次等待占 1 到 3 个模拟器帧,等待 d 次实际是 d 到 3d+6 帧 | 已验证(一项、3 项(含序号越界的一项)、2 项列表;模拟器里后面几项可能一发完命令字节就结束,只要求每段是预期数据的前缀;等待帧数用调用日志的帧号核对) |
|
|
695
|
+
|
|
696
|
+
实测用最小的合法语音流(`$0A`、静音帧 `$00`、结束帧 `$0F`)实测:写入 `$4302` 的字节进语音合成器,读到结束帧后 `$4302` 低 4 位变 `$F`,BIOS 写 `$0F` 、清 `$0328/$0329` 并返回。模拟器曾因缺 `case 0x4302:` 而不处理写 `$4302`(已修复);用未修复的模拟器会看到调用永远不返回。
|
|
697
|
+
|
|
698
|
+
## 6. 出错码(`DOS_ERROR`)
|
|
699
|
+
|
|
700
|
+
出错信息存放在 BIOS ROM 第 `$5B` 页(英文)与第 `$5F` 页(中文),按出错码顺序排列,下表来自这两页。内部使用的码 `$F3`、`$F4` 不会出现在返回值里。
|
|
701
|
+
|
|
702
|
+
| 码 | 中文 | English |
|
|
703
|
+
| --- | --- | --- |
|
|
704
|
+
| `$00` | 无错 | No error |
|
|
705
|
+
| `$01` | 无效的功能调用号 | Invalid funtion no. |
|
|
706
|
+
| `$02` | 文件未找到 | File not found |
|
|
707
|
+
| `$03` | 路径未找到 | Directory not found |
|
|
708
|
+
| `$04` | 无可用的描述字(打开的文件过多) | No usable descriptive word (Too many files opened) |
|
|
709
|
+
| `$05` | 访问被拒绝(如企图写只读文件) | Access denied |
|
|
710
|
+
| `$06` | 无效描述字 | Invalid desciptive word |
|
|
711
|
+
| `$07` | 内存控制块被破坏 | Memory control block had been corrupt |
|
|
712
|
+
| `$08` | 无足够内存 | No enough memory |
|
|
713
|
+
| `$09` | 无效的内存地址 | Invalid memory address |
|
|
714
|
+
| `$0A` | 无效环境 | Invalid environment |
|
|
715
|
+
| `$0B` | 无效格式 | Invalid form |
|
|
716
|
+
| `$0C` | 无效存取代码 | Invalid access code |
|
|
717
|
+
| `$0D` | 无效数据 | Invalid data |
|
|
718
|
+
| `$0E` | 磁盘参数错 | Invalid diskette parameter |
|
|
719
|
+
| `$0F` | 无效驱动器标识 | Invalid diskette identification |
|
|
720
|
+
| `$10` | 磁盘操作参数错 | Invalid diskette operate parameter |
|
|
721
|
+
| `$11` | 文件分配表错误 | Invalid FAT table |
|
|
722
|
+
| `$12` | 无可用文件 | No usable file |
|
|
723
|
+
| `$13` | 磁盘写保护,写操作失败 | Diskette write protect, write attempt failed |
|
|
724
|
+
| `$14` | 文件读写位置错误 | Invalid file read or write position |
|
|
725
|
+
| `$15` | 驱动器未准备好 | Diskette not ready |
|
|
726
|
+
| `$16` | 命令未定义 | Command not defined |
|
|
727
|
+
| `$17` | 循环冗余校验错 | Bad CRC |
|
|
728
|
+
| `$18` | 驱动器中没有磁盘 | No diskette in drive |
|
|
729
|
+
| `$19` | 搜索错误 | Search error |
|
|
730
|
+
| `$1A` | 未知磁盘类型 | Invalid diskette type |
|
|
731
|
+
| `$1B` | 指定扇区未找到 | Sector not found |
|
|
732
|
+
| `$1C` | 无效目录项参数 | Invalid dirctory parameter |
|
|
733
|
+
| `$1D` | 写磁盘错误 | Diskette write error |
|
|
734
|
+
| `$1E` | 读磁盘错误 | Diskette read error |
|
|
735
|
+
| `$1F` | 一般错误 | General error |
|
|
736
|
+
| `$20` | 文件已经存在 | File already exist |
|
|
737
|
+
| `$21` | 不能创建目录项 | Cannot create directory |
|
|
738
|
+
| `$22` | 磁盘更换错误 | Invalid diskette change |
|
|
739
|
+
| `$23` | 文件控制块无效 | Invalid FCB (File control block) |
|
|
740
|
+
| `$24` | 共享缓冲区溢出 | Shared buffer overflow |
|
|
741
|
+
| `$25` | 参数无效 | Invalid parameter |
|
|
742
|
+
| `$26` | 目录已经存在 | Directory already exist |
|
|
743
|
+
| `$27` | 文件名或目录名错误 | File or Directory name error |
|
|
744
|
+
| `$28` | 文件打开方式错误 | File open method error |
|
|
745
|
+
| `$29` | 企图删去非空目录 | Attempt to delete directory which is not empty |
|
|
746
|
+
| `$2A` | 目录嵌套层数过多 | Too much directory level |
|
|
747
|
+
| `$2B` | 磁盘操作错 | Dikette operate error |
|
|
748
|
+
| `$2C` | 磁盘空间不够 | No enough diskette space |
|
|
749
|
+
| `$2D` | 文件名重复 | Duplicate file name |
|
|
750
|
+
| `$2E` | 文件未打开 | File not open |
|
|
751
|
+
|
|
752
|
+
出错码 `$2F` 起的字符串是 DOS 命令的提示文字(欢迎信息、命令帮助等),不是出错信息。
|
|
753
|
+
|
|
754
|
+
## 7. 其他服务
|
|
755
|
+
|
|
756
|
+
下列功能已读过但还没整理出参数,作用见 [api-reference.md](../../targets/sb2000/api-reference.md) 末尾的覆盖表:
|
|
757
|
+
|
|
758
|
+
- 显示:`$10`(显示选项)、`$11`(显示模式)、`$14`(鼠标复位)、`$19`、`$1A`(关闭、重开显示)、`$30`(DMA 到显存);文字显示与窗口功能 `$3B-$61` 见 5.12 节。
|
|
759
|
+
- 其余未命名的内核功能:`$15`、`$17`、`$18`、`$1F`、`$27`、`$28`、`$31-$34`。(`$6A`、`$6C` 见 5.8 节。)
|
|
760
|
+
|
|
761
|
+
## 8. 还没读完的部分
|
|
762
|
+
|
|
763
|
+
- 文件服务里扇区号、簇号换算以外的目录项内部操作(建立、查找目录项的底层例程),只读过入口。
|
|
764
|
+
- 磁盘服务 `$80/$01` 与 `$80/$08` 的细节。
|
|
765
|
+
- 显示与窗口服务 `$5A-$61` 的确切用途与参数(5.12 节只给出了结构与已读出的部分),显示服务 `$10`、`$11`,声音服务 `$65` 的音乐命令含义与声道寄存器去向(曲子格式见 5.5 节);`$6A`、`$6C`(5.8 节)已实机验证,鼠标的点击、双击、拖动状态也已实测(双击计时要靠定时器中断,没有核实打开方法)。
|
|
766
|
+
- 页组 `$0C`(输入法,5.10 节)的子功能 `$0C-$24` 、码表格式,BASIC 等覆盖模块,各内部命令处理例程的内部逻辑(5.9 节理清了命令查找与分发,并按帮助文字整理了用法)。
|
|
767
|
+
|
|
768
|
+
## 9. 程序运行环境验证(V01~V10)
|
|
769
|
+
|
|
770
|
+
实施时对程序运行环境做过验证(2026-11-10,模拟器实测,固件为 `SB2K_BIOS.NES`),结论已写入 `link.cfg` 与 `crt0.s`:
|
|
771
|
+
|
|
772
|
+
| 编号 | 问题 | 结果 |
|
|
773
|
+
| --- | --- | --- |
|
|
774
|
+
| V01 | 程序运行时哪些零页单元空闲 | BIOS 符号表里的零页符号只到 `$50`;开机后 1800 帧内对 `$51` 到 `$FF` 设写断点,命中 0 次;C 运行库的零页定在 `$0060` 到 `$007F` |
|
|
775
|
+
| V02 | 返回 DOS 前需要恢复哪些被改写的零页单元 | 不需要;C 与汇编的 hello 各连续返回 DOS 两次都正常,DOS 清屏并重画提示符 |
|
|
776
|
+
| V03 | 窗口内数据、BSS 与软件栈的位置,硬件栈深度 | `main` 入口时 `S=$EA`,硬件栈约 235 字节;8000 字节的 `BSS`(超出文件)与 60 层递归通过 |
|
|
777
|
+
| V04 | 超出 16K 的程序是否需要换页 | 可行(2026-11-11 实验):DOS 按文件大小一次装入整个文件(实测 12、64、116 页都能装入运行,160 页因内存不足不能启动),文件偏移 6 的页数字节是 12 等真实页数;程序自己用功能 `$29`(`sb_window_map`)把后面的页换进窗口 2 即可。实验程序:窗口 0、1 常驻代码与数据(链接配置里 `MAIN` 8K),文件第 2 页是窗口 2 的初始页,第 3 页是窗口 3(C 栈所在,必须留一个空页),第 4 页起是库页,每页 `$A000` 起 4K,C 里用 `#pragma code-name` 与 `rodata-name` 放进库页;常驻的 `bank_call` 先换页再调用、返回后换回,嵌套换页靠它保存当前页。`fcdev` 已按这个方案实现,见 [开发指南](01-开发指南.md) 第 3.1 节。9 个库页各取 3500 字节数据校验和、库页里调用常驻的运行库函数、库页间嵌套调用、系统调用(等帧、写文件)与 30 帧 NMI 等待之后,窗口 2 仍是换入的页,全部正确。DOS 运行时最大连续空闲页约 117 页(12 页程序运行时是 105 页),所以程序最大约 468K |
|
|
778
|
+
| V05 | 文件头 3 个自由字节的含义 | 偏移 5、6 由 DOS 改写;文件头用 `00 00 00` 可正常运行 |
|
|
779
|
+
| V06 | 程序窗口里文件之外的页归谁 | 无人占用:DOS 只按文件大小分页,页分配服务会把它们分给别人(程序的 `BSS` 与栈被占)。`crt0.s` 启动时紧接着程序页申请下来,返回前释放(2026-11-11,2 页与 4 页的程序都通过) |
|
|
780
|
+
| V07 | `sb_exec`(`$7F/$00`)运行子程序后调用者的状态 | 子程序的启动代码重设软件栈指针、改写零页 `$60` 到 `$7F`,返回后调用者的栈乱了;`sbi_exec_run` 在运行前后保存、恢复这 32 字节(只用绝对地址,不依赖软件栈)。子程序用新分配的页,调用者的页不受影响 |
|
|
781
|
+
| V08 | 系统服务换页后,程序窗口里的参数块是否可见 | 不可见:换入页组的服务(如 `$53` 直线步进用零页指针指向参数块)读到的是别的页。参数块要放在任何映射下都可见的 ERAM(`$7EE0` 起的 18 字节)。带“页组 + 窗口地址”的服务,页组取程序起始页(程序窗口占 4 页连续)即可读到程序窗口里的数据 |
|
|
782
|
+
| V09 | 文件读写的分块规则 | `$7C/$05` 读按 `4096 − (偏移 & 511)` 为一块;`$7C/$06` 写不能扩大文件,超出大小出错码 `$14`;创建新文件并写入用整页写(`sb_file_write_all`);`$7B/$01` 装入 FAT 缓存失败时 `DOS_ERROR` 仍为 0,要看 `DISK_STATUS` |
|
|
783
|
+
| V10 | 声音引擎 | 在 NMI 里更新,起播后要等 1 到 2 帧才有寄存器影子;曲子放在程序窗口里起播后,引擎在 NMI 里读乱,曲子要放在 ROM 页或自己申请的扩展 RAM 页(BIOS 页 `$78` 的 `$8445` 提示音可作测试曲) |
|
|
784
|
+
|
|
785
|
+
## 10. 附录:卡拉 OK 歌词文字流格式(功能 `$66`)
|
|
786
|
+
|
|
787
|
+
功能 `$66` 读的歌词文字流,由调用者准备(各盘 `WIN98` 目录的 `KARAOK.EXE` 是例子):
|
|
788
|
+
|
|
789
|
+
- ASCII 字符:`[字符, 时长]`;汉字:`[GB2312 高字节, 低字节, 时长]`;时长后可跟若干 `[$80, 附加时长]`,时长相加,可超过 255。
|
|
790
|
+
- `$00` 空白:`[$00, 时长]`。
|
|
791
|
+
- `$20` 空格:`[$20, 时长]`;时长为 0 的空格只把位置推进 2。
|
|
792
|
+
- `$5E`(`^`):在子段外显示成 `$A1F1` 并按汉字算,在子段里按空白算。
|
|
793
|
+
- `$9D` 换行:一行最多 28 个字节,不足补空格。
|
|
794
|
+
- `$8E` 调用子段:`[$8E, 起点偏移 2 字节, 终点偏移 2 字节]`,偏移相对歌词数据起点,读到终点后回到调用之后继续,最多两层。
|
|
795
|
+
- `$FF` 结束。
|
|
796
|
+
|
|
797
|
+
注意(实机核对):一行超过 28 个字节时,补空格的循环越界,把后面的内存(含位置栈和窗口保存单元)全写成 `$20`,随后的显示调用的页组变成 `$20`,不会再回到歌词例程;`$81-$9C` 里不认识的控制码在逐行解析里当 1 字节字符、往前解析里只跳过 1 字节,两个解析会不同步。所以歌词文字流里不要出现超长行和这些控制码。
|