fcdev 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/README.md +3 -2
  2. package/package.json +3 -3
  3. package/src/api/header-parser.mjs +78 -0
  4. package/src/api/index.mjs +128 -0
  5. package/src/build/bank-link-config.mjs +74 -0
  6. package/src/build/index.mjs +1 -0
  7. package/src/build/program-builder.mjs +5 -2
  8. package/src/cli/commands/api-command.mjs +62 -0
  9. package/src/cli/index.mjs +3 -0
  10. package/src/targets/target-registry.mjs +38 -0
  11. package/targets/nes/lib/fcnes.lib +0 -0
  12. package/targets/nes/lib/nes-font.o +0 -0
  13. package/targets/sb2000/api-reference.md +3295 -0
  14. package/targets/sb2000/api-unwrapped.json +36 -0
  15. package/targets/sb2000/asminc/sb2000.inc +203 -1
  16. package/targets/sb2000/include/sb2000-bank.h +74 -0
  17. package/targets/sb2000/include/sb2000-clock.h +68 -0
  18. package/targets/sb2000/include/sb2000-disk.h +141 -0
  19. package/targets/sb2000/include/sb2000-display.h +352 -0
  20. package/targets/sb2000/include/sb2000-file.h +273 -0
  21. package/targets/sb2000/include/sb2000-ime.h +158 -0
  22. package/targets/sb2000/include/sb2000-input.h +192 -0
  23. package/targets/sb2000/include/sb2000-math.h +228 -0
  24. package/targets/sb2000/include/sb2000-memory.h +115 -0
  25. package/targets/sb2000/include/sb2000-printer.h +116 -0
  26. package/targets/sb2000/include/sb2000-sound.h +134 -0
  27. package/targets/sb2000/include/sb2000-symbols.h +397 -1
  28. package/targets/sb2000/include/sb2000-system.h +219 -0
  29. package/targets/sb2000/include/sb2000-text.h +99 -0
  30. package/targets/sb2000/include/sb2000.h +13 -20
  31. package/targets/sb2000/lib/crt0.o +0 -0
  32. package/targets/sb2000/lib/sb2000.lib +0 -0
  33. package/targets/sb2000/lib-build.json +1 -1
  34. package/targets/sb2000/link-banked.cfg +42 -0
  35. package/targets/sb2000/src/crt0.s +89 -4
  36. package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
  37. package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
  38. package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
  39. package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
  40. package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
  41. package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
  42. package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
  43. package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
  44. package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
  45. package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
  46. package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
  47. package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
  48. package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
  49. package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
  50. package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
  51. package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
  52. package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
  53. package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
  54. package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
  55. package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
  56. package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
  57. package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
  58. package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
  59. package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
  60. package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
  61. package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
  62. package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
  63. package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
  64. package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
  65. package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
  66. package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
  67. package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
  68. package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
  69. package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
  70. package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
  71. package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
  72. package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
  73. package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
  74. package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
  75. package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
  76. package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
  77. package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
  78. package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
  79. package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
  80. package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
  81. package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
  82. package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
  83. package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
  84. package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
  85. package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
  86. package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
  87. package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
  88. package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
  89. package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
  90. package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
  91. package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
  92. package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
  93. package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
  94. package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
  95. package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
  96. package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
  97. package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
  98. package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
  99. package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
  100. package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
  101. package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
  102. package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
  103. package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
  104. package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
  105. package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
  106. package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
  107. package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
  108. package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
  109. package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
  110. package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
  111. package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
  112. package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
  113. package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
  114. package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
  115. package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
  116. package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
  117. package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
  118. package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
  119. package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
  120. package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
  121. package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
  122. package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
  123. package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
  124. package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
  125. package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
  126. package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
  127. package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
  128. package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
  129. package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
  130. package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
  131. package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
  132. package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
  133. package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
  134. package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
  135. package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
  136. package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
  137. package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
  138. package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
  139. package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
  140. package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
  141. package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
  142. package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
  143. package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
  144. package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
  145. package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
  146. package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
  147. package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
  148. package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
  149. package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
  150. package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
  151. package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
  152. package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
  153. package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
  154. package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
  155. package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
  156. package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
  157. package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
  158. package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
  159. package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
  160. package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
  161. package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
  162. package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
  163. package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
  164. package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
  165. package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
  166. package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
  167. package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
  168. package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
  169. package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
  170. package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
  171. package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
  172. package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
  173. package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
  174. package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
  175. package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
  176. package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
  177. package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
  178. package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
  179. package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
  180. package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
  181. package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
  182. package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
  183. package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
  184. package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
  185. package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
  186. package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
  187. package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
  188. package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
  189. package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
  190. package/targets/sb2000/src/lib/sb-internal.h +111 -0
  191. package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
  192. package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
  193. package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
  194. package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
  195. package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
  196. package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
  197. package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
  198. package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
  199. package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
  200. package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
  201. package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
  202. package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
  203. package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
  204. package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
  205. package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
  206. package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
  207. package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
  208. package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
  209. package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
  210. package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
  211. package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
  212. package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
  213. package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
  214. package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
  215. package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
  216. package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
  217. package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
  218. package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
  219. package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
  220. package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
  221. package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
  222. package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
  223. package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
  224. package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
  225. package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
  226. package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
  227. package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
  228. package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
  229. package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
  230. package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
  231. package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
  232. package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
  233. package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
  234. package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
  235. package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
  236. package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
  237. package/targets/sb2000/src/lib/text/sb-print.c +35 -0
  238. package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
  239. package/targets/sb2000/src/sb2000.s +0 -3
  240. package/targets/sb2000/target.json +14 -0
@@ -0,0 +1,36 @@
1
+ {
2
+ "functions": {
3
+ "$15": "只把 $0636 置 1,BIOS 里没有读取这个单元的指令,用途没有查清。需要时用 sb_syscall。",
4
+ "$1F": "把系统时钟的时、分、秒(原始计数)复制到 $069A 起,与 sb_clock_get_time($7F/$04)取到的是同一个时钟,只是没有换算成 FAT 的 2 秒精度,没有单独封装的必要。",
5
+ "$24": "按远指针读一个字节并后移指针。sb_far_read、sb_far_read_byte 已经覆盖,它们直接调用内核的远读入口($FFF3),比逐字节调用 $24 快。",
6
+ "$28": "把页号换算成 DMA 源地址的高字节,是 DMA 服务(sb_vram_load、sb_text_to_memory 等)的内部步骤,程序自己用不到。",
7
+ "$2B": "按远指针写一个字节并后移指针。sb_far_write、sb_far_write_byte 已经覆盖,它们直接调用内核的远写入口($FFF6)。",
8
+ "$31": "按位掩码一次填多块显存,内含分段 DMA 与调色板缓冲上传,分段细节没有实测。用 sb_vram_fill 分段填充可以得到同样的效果。需要时用 sb_syscall,参数见系统调用手册 5.7.2 节。",
9
+ "$34": "同 $33(扩展 RAM 到显存的 DMA,已由 sb_vram_load 封装),区别是控制字不同、目的地址取自两个没有命名的单元,参数没有查清。",
10
+ "$41": "屏幕单元写入服务:每格的值依次加步长(用来排布成对的字模图块),一次写上下两格。常量填充用 sb_cells_fill、sb_cells_rect。主要给文字编辑软件整块排版用,语义复杂,需要时用 sb_syscall,参数见系统调用手册 5.12 节。",
11
+ "$42": "屏幕单元写入服务:按列写,每次连写左右两格后下移一行。理由同 $41。",
12
+ "$43": "屏幕单元写入服务:同 $41,每次只写一格。理由同 $41。",
13
+ "$44": "屏幕单元写入服务:按列写单格,下移一行。理由同 $41。",
14
+ "$66": "卡拉 OK 歌词滚动:要特定格式的歌词文字流,整个流程(停声、起播、逐行排版、条带动画)只有 KARAOK.EXE 这类程序用,没有通用用途。需要时用 sb_syscall,文字流格式见 docs/sb2000/02-系统调用手册.md 第 10 节。",
15
+ "$77": "与 $76 是同一个入口(分发器对 $76 到 $7A 做完全相同的事,只看子功能),统一用 sb_printer_* 系列。",
16
+ "$78": "与 $77 一样,是 $76 的同一个入口。",
17
+ "$79": "与 $77 一样,是 $76 的同一个入口。",
18
+ "$7A": "与 $77 一样,是 $76 的同一个入口。",
19
+ "$81": "只有子功能 0,什么都不做。"
20
+ },
21
+ "partial": {
22
+ "$30": "子功能 $08(写单元)、$09(读单元)没有封装:屏幕缓冲在扩展 RAM 页里,用 sb_cell_address 取得地址后直接用 sb_far_read、sb_far_write 读写即可。",
23
+ "$4D": "子功能 2(40 位小数与十进制小数位互转)没有封装,转换规则只有部分文字说明。",
24
+ "$4E": "子功能 2(同上)没有封装。",
25
+ "$4F": "子功能非 0 时把结果换算成 40.40 定点数放 $06AA-$06B3,没有封装,需要时用 sb_syscall。",
26
+ "$50": "子功能非 0 的定点数结果没有封装,理由同 $4F。",
27
+ "$65": "子功能 1(与 0 只差一个单元的值)、9(起播后不重新打开声音更新,卡拉 OK 用)、$0A(不复位的音效起播)、6 到 8(原程序疑似漏写取下标的指令,不建议使用)没有封装。",
28
+ "$6D": "子功能 $09(登记自定义输入法 6)、$0C 与 $0F 到 $12(词库查询、汉字反查读音)、$13 到 $24(转发给外挂输入法模块)没有封装;外挂模块与联想方式没有验证。",
29
+ "$74": "子功能 1 到 9(语音控制标志位的开关)、$0A 到 $0D(交给 NMI 逐字节发送语音数据)没有封装,需要时直接读写 $032B 与用 sb_syscall。",
30
+ "$75": "子功能 2 及以上(按播放列表连续发送)没有封装。",
31
+ "$76": "子功能 9 到 $0C(字模转置、展开、逐列发送、发送空列)是 sb_printer_text 的内部步骤,没有封装。",
32
+ "$7B": "子功能 $00、$02、$04、$05、$07、$08、$0C 到 $12 是文件系统内部步骤(扇区定位、FAT 读写与缓存、簇链、分配与传输),由 sb_file_*、sb_dir_*、sb_disk_* 覆盖,没有单独封装;$13(复位全部句柄)每条命令开头由系统调用,程序一般不必调用。",
33
+ "$7C": "子功能 $00、$01 与 $0E(读引导扇区取磁盘参数)没有封装:磁盘参数在启动时已由 DOS 读好,更换磁盘后的重新读取没有验证。",
34
+ "$7D": "子功能 $00 没有封装(作用没有查清)。"
35
+ }
36
+ }
@@ -32,16 +32,29 @@ FAR_READ_BYTE = $FFF3 ; 读远指针加 Y 处的一个字节
32
32
  FAR_WRITE_BYTE = $FFF6 ; 把 A 写到远指针加 Y 处
33
33
 
34
34
  ; ---- 功能号(写入 SYS_FUNCTION)----
35
+ FN_VIDEO_OPTION = $10 ; 显示选项:把值按位并入显示相关的硬件寄存器
36
+ FN_DISPLAY_MODE = $11 ; 显示模式与字库区域登记
35
37
  FN_PPU_CONTROL = $12 ; 画面控制:开关 NMI 及其中的各项服务
36
38
  FN_IRQ_MASK = $13 ; 中断屏蔽:允许或屏蔽各中断源
37
39
  FN_MOUSE_RESET = $14 ; 鼠标复位,是否接入放在 $0633
40
+ FN_USER_FLAG = $15 ; 把 $0636 置 1,用途未确认
41
+ FN_KEYBOARD_INIT = $17 ; 键盘复位与识别
42
+ FN_SYSTEM_INIT = $18 ; 系统硬件与状态初始化
43
+ FN_DISPLAY_OFF = $19 ; 关闭 NMI,等到垂直消隐后关闭背景与精灵显示
44
+ FN_DISPLAY_ON = $1A ; 等到垂直消隐,开启 NMI 并恢复显示
38
45
  FN_WAIT_FRAMES = $1B ; 等待 X 个垂直消隐周期(帧)
39
46
  FN_SAVE_CONTEXT = $1C ; 保存上下文,类似 setjmp
40
47
  FN_RESTORE_CONTEXT = $1D ; 恢复上下文并跳转,不返回,类似 longjmp
48
+ FN_QUERY_STATE = $1E ; 查询显示与系统状态,结果放在 $0652
49
+ FN_CLOCK_COPY = $1F ; 把系统时钟的时、分、秒复制到 $069A 起
41
50
  FN_FAR_READ_NEXT = $24 ; 按远指针读一个字节到 $0653,指针后移
42
51
  FN_CALL_BANKED = $25 ; 映射页组并调用 PROG_ENTRY 处的例程
43
52
  FN_JUMP_BANKED = $26 ; 同上,但直接跳转,不再返回
53
+ FN_MAP_GROUP = $27 ; 把页组的 4 页映射到 $8000-$BFFF,调用返回后保持
54
+ FN_PAGE_CONVERT = $28 ; 页号换算成 DMA 源地址的高字节
44
55
  FN_MAP_WINDOW = $29 ; 把页 SYS_PAGE 映射到窗口 SYS_WINDOW
56
+ FN_VRAM_BANK = $2A ; 把 SYS_GROUP 写到显存 bank 寄存器
57
+ FN_FAR_WRITE_NEXT = $2B ; 把 $0653 写到远指针处,指针后移
45
58
  FN_ADDR_TO_FAR = $2C ; 把窗口地址换算成远指针
46
59
  FN_SOUND = $65 ; 声音服务
47
60
  FN_INPUT = $6B ; 键盘输入服务
@@ -85,6 +98,10 @@ SUB_FS_OPEN = $09 ; 按 FILE_MODE 打开 PATH_BUFFER 里
85
98
  SUB_FS_CLOSE = $0A ; 关闭 FILE_HANDLE_OFFSET 指定的句柄
86
99
  SUB_FS_FIND_ENTRY = $0B ; 设置当前目录,相当于 CD
87
100
  SUB_FS_RESET = $13 ; 把 4 个句柄全部置为空闲
101
+ SUB_FS_NEXT_SECTOR = $00 ; 前进到下一扇区,结果在 FS_NEXT_LBA,区域结束时 FS_REGION_END 为 1
102
+ SUB_FS_FAT_LOAD = $01 ; 读 FS_LBA 号扇区到 DISK_BUFFER,必要时先把 FAT 装入缓存
103
+ SUB_FS_CLUSTER_LBA = $03 ; 把 FS_CLUSTER 的简号换算成该簇第一个扇区 FS_LBA
104
+ SUB_FS_FREE_SPACE = $06 ; 从 FS_FREE_START 起统计空闲空间,字节数累加到 ARG_069A
88
105
 
89
106
  ; ---- 子功能:句柄服务(FN_FILE_HANDLE)----
90
107
  SUB_FH_CLOSE_FLUSH = $02 ; 关闭句柄,并让软驱停转
@@ -93,6 +110,14 @@ SUB_FH_WRITE_AT = $06 ; 按偏移与长度从扩展 RAM 页写
93
110
  SUB_FH_GET_SIZE = $0D ; 取文件大小到 FILE_SIZE
94
111
  SUB_FH_READ_FILE = $0F ; 把整个文件读入扩展 RAM 页
95
112
  SUB_FH_WRITE_FILE = $10 ; 把扩展 RAM 页的内容整个写入文件
113
+ SUB_FH_DELETE = $03 ; 删除 PATH_BUFFER 里的文件
114
+ SUB_FH_RENAME = $04 ; 把句柄的文件改名为 PATH_BUFFER 里的新名称
115
+ SUB_FH_SET_DATE = $07 ; 设置句柄的日期(FILE_DATE)
116
+ SUB_FH_GET_DATE = $08 ; 取得句柄的日期到 FILE_DATE
117
+ SUB_FH_SET_TIME = $09 ; 设置句柄的时间(FILE_TIME)
118
+ SUB_FH_GET_TIME = $0A ; 取得句柄的时间到 FILE_TIME
119
+ SUB_FH_SET_ATTR = $0B ; 设置句柄的属性(FILE_ATTR)
120
+ SUB_FH_GET_ATTR = $0C ; 取得句柄的属性到 FILE_ATTR
96
121
 
97
122
  ; ---- 子功能:目录服务(FN_DIR)----
98
123
  SUB_DIR_FORMAT_NAME = $01 ; 把当前目录名整理成 \NAME.EXT 放入 PATH_BUFFER
@@ -115,6 +140,12 @@ SUB_CLOCK_GET_TIME = $04 ; 取系统时间到 FILE_TIME
115
140
  SUB_DISK_READ = $04 ; 按 DISK_ 参数连续读扇区
116
141
  SUB_DISK_WRITE = $05 ; 按 DISK_ 参数连续写扇区
117
142
  SUB_DISK_STOP = $07 ; 软驱停转,每次文件操作之后都要调用
143
+ SUB_DISK_INIT = $00 ; 启动软驱、复位到 0 磁道,读出状态后停转
144
+ SUB_DISK_FORMAT = $01 ; 格式化一个磁道
145
+ SUB_DISK_READ_ONE = $02 ; 读一个扇区到 DISK_BUFFER
146
+ SUB_DISK_WRITE_ONE = $03 ; 把 DISK_BUFFER 写到一个扇区
147
+ SUB_DISK_START = $06 ; 启动软驱
148
+ SUB_DISK_SCAN = $08 ; 逐个读一条磁道的 18 个扇区,读不出的在位图里置位
118
149
 
119
150
  ; ---- 子功能:声音服务(FN_SOUND)----
120
151
  SUB_SOUND_PLAY_WAV = $0C ; 播放内存里的 WAV,播完才返回
@@ -146,6 +177,19 @@ FILE_TIME_LO = $6570 ; 时间低字节,FAT 格式:时、
146
177
  FILE_TIME_HI = $6571 ; 时间高字节
147
178
  FILE_ATTR = $6572 ; 属性:位 0 只读,位 3 卷标,位 4 目录,位 5 存档
148
179
 
180
+ ; ---- 变量:文件系统内部(扩展 RAM)----
181
+ DISK_BUFFER = $6000 ; 扇区缓冲,512 字节
182
+ FS_CURRENT_DIR_LBA = $6528 ; 当前目录的第一个扇区号,16 位,根目录为 19
183
+ FS_LBA = $652E ; 要读写的扇区号,16 位,低字节在前
184
+ FS_FREE_START = $6530 ; 统计空闲空间的起始簇号,16 位
185
+ FS_CLUSTER = $6536 ; 簇号,16 位
186
+ FILE_HANDLES = $643B ; 句柄表起点,共 4 项,每项 $2C 字节
187
+ FH_CLUSTER_OFFSET = $15 ; 句柄表项里起始簇号的偏移,16 位
188
+ FH_SIZE_OFFSET = $0E ; 句柄表项里文件大小的偏移,3 字节,低字节在前
189
+ FS_NEXT_LBA = $65A9 ; 前进到下一扇区的结果,16 位
190
+ FS_REGION_END = $65C5 ; 下一扇区越出区域或簇链到尾时为 1
191
+ ARG_069A = $069A ; 数学与空闲空间统计的参数区起点
192
+
149
193
  ; ---- 变量:内存页分配(扩展 RAM)----
150
194
  ALLOC_COUNT = $65A6 ; 要分配或释放的页数
151
195
  ALLOC_START = $65A7 ; 分配得到的起始页号,或要释放的起始页号
@@ -160,6 +204,7 @@ DISK_COUNT_LO = $6205 ; 扇区数低字节
160
204
  DISK_COUNT_HI = $6206 ; 扇区数高字节
161
205
  DISK_MODE = $6207 ; 方式:$80 出错时立即返回
162
206
  DISK_STATUS = $6208 ; 结果状态,0 为成功
207
+ DISK_BAD_MAP = $6237 ; 扫描磁道的坏扇区位图,3 字节,位 7 起对应扇区 1-8、9-16、17-18
163
208
 
164
209
  ; ---- 变量:键盘、手柄、鼠标(内核 RAM)----
165
210
  KEY_ASCII = $034B ; 取到的按键的 ASCII 码,没有字符的键为 0
@@ -169,14 +214,77 @@ PAD1_BITS = $034E ; 1 号手柄的原始状态,位 7 是
169
214
  PAD2_BITS = $034F ; 2 号手柄的原始状态
170
215
  MOUSE_X = $0354 ; 鼠标光标的 X 坐标
171
216
  MOUSE_Y = $0355 ; 鼠标光标的 Y 坐标
217
+ MOUSE_PARAM = $035E ; 鼠标双击的间隔参数,默认 $0A
218
+ KBD_FLAGS = $0344 ; 键盘修饰键状态:位 0 右 Shift,1 左 Shift,2 Ctrl,3 Alt,4 ScrollLock,5 NumLock,6 CapsLock,7 Insert
219
+ KBD_LEDS = $0348 ; 键盘指示灯状态:位 0 ScrollLock,1 NumLock,2 CapsLock
220
+ KBD_SELF_TEST_RESULT = $0635 ; 键盘复位与识别(FN_KEYBOARD_INIT)的结果,1 为通过
172
221
  MOUSE_BTN_BASE = $0360 ; 鼠标按键状态的起点,共 8 个字节
173
- MOUSE_PRESENT = $0633 ; 鼠标是否接入,0 为没有
222
+ MOUSE_PRESENT = $0633 ; 鼠标复位后非 0 表示检测到鼠标,0 为没有(BIOS 里它是鼠标数据包的字节序号)
223
+
224
+ ; ---- 常量:NMI 服务号、中断源号(传给 FN_PPU_CONTROL、FN_IRQ_MASK 的子功能)----
225
+ NMI_SERVICE_BAR_ANIM = $01 ; NMI 服务:条带动画(卡拉 OK 歌词滚动)
226
+ NMI_SERVICE_SOUND = $02 ; NMI 服务:声音引擎每帧更新
227
+ NMI_SERVICE_HOOK5 = $03 ; NMI 服务:调用登记的钩子 5
228
+ NMI_SERVICE_HOOK4 = $04 ; NMI 服务:调用登记的钩子 4
229
+ NMI_SERVICE_PAD = $05 ; NMI 服务:读手柄
230
+ NMI_SERVICE_PALETTE = $06 ; NMI 服务:把 $0700 缓冲上传到调色板
231
+ IRQ_SOURCE_TIMER = $00 ; 中断源:定时器
232
+ IRQ_SOURCE_MOUSE = $01 ; 中断源:鼠标
233
+ IRQ_SOURCE_KEYBOARD = $02 ; 中断源:键盘
234
+ IRQ_SOURCE_IRQ4 = $03 ; 中断源:中断 4(只有钩子)
235
+ IRQ_SOURCE_FLOPPY = $04 ; 中断源:软驱
236
+ IRQ_SOURCE_IRQ2 = $05 ; 中断源:中断 2(只有钩子)
237
+ IRQ_SOURCE_IRQ1 = $06 ; 中断源:中断 1(只有钩子)
238
+
239
+ ; ---- 程序文件头里由 DOS 写入的单元 ----
240
+ PROGRAM_START_PAGE = $8005 ; 程序装入的起始扩展 RAM 页号,也就是程序所在页组的首页
241
+ PROGRAM_PAGE_COUNT = $8006 ; 程序占用的页数
242
+
243
+ ; ---- 变量:显示、中断与窗口的影子(内核 RAM)----
244
+ PPU_CTRL_SHADOW = $062A ; PPU 控制寄存器($2000)的影子,位 7 是 NMI 开关
245
+ PPU_MASK_SHADOW = $062B ; PPU 显示寄存器($2001)的影子,位 3 背景,位 4 精灵
246
+ PPU_EXT_CTRL_SHADOW = $062E ; 扩展控制寄存器($2008)的影子
247
+ IRQ_MASK_SHADOW = $062F ; 中断屏蔽($4032)的影子,位为 1 表示屏蔽
248
+ NMI_FLAGS = $0630 ; NMI 里各项服务的开关
249
+ GLYPH_MODE = $0638 ; 字形模式,高 2 位是显示模式
250
+ WINDOW_SAVE_0 = $0639 ; 窗口 0($8000)页号的影子
251
+ WINDOW_SAVE_1 = $063A ; 窗口 1($9000)页号的影子
252
+ WINDOW_SAVE_2 = $063B ; 窗口 2($A000)页号的影子
253
+ WINDOW_SAVE_3 = $063C ; 窗口 3($B000)页号的影子
254
+ COPY_BUFFER = $0700 ; 跨页复制用的中转缓冲
255
+ NMI_HOOK5_VEC_LO = $1E ; NMI 钩子 5 的地址(低),地址在零页,钩子由 NMI_FLAGS 位 5 打开
256
+ NMI_HOOK4_VEC_LO = $20 ; NMI 钩子 4 的地址(低),钩子由 NMI_FLAGS 位 4 打开
257
+ TIMER_HOOK_VEC_LO = $24 ; 定时器钩子的地址(低)
258
+ IRQ3_HOOK_VEC_LO = $26 ; 中断 3 钩子的地址(低),系统不会调用它
259
+ IRQ1_HOOK_VEC_LO = $28 ; 中断 1 钩子的地址(低)
260
+ IRQ2_HOOK_VEC_LO = $2A ; 中断 2 钩子的地址(低)
261
+ IRQ4_HOOK_VEC_LO = $2C ; 中断 4 钩子的地址(低)
262
+ KBD_HOOK_VEC_LO = $2E ; 键盘钩子的地址(低)
263
+ MOUSE_HOOK_VEC_LO = $30 ; 鼠标钩子的地址(低)
264
+ NMI_HOOK5_PAGE = $0306 ; NMI 钩子 5 所在页组的首页号
265
+ NMI_HOOK4_PAGE = $0307 ; NMI 钩子 4 所在页组的首页号
266
+ KBD_HOOK_PAGE = $068E ; 键盘钩子所在页组的首页号
267
+ MOUSE_HOOK_PAGE = $068F ; 鼠标钩子所在页组的首页号
268
+ TIMER_HOOK_PAGE = $0690 ; 定时器钩子所在页组的首页号
269
+ IRQ3_HOOK_PAGE = $0691 ; 中断 3 钩子所在页组的首页号
270
+ IRQ1_HOOK_PAGE = $0692 ; 中断 1 钩子所在页组的首页号
271
+ IRQ2_HOOK_PAGE = $0693 ; 中断 2 钩子所在页组的首页号
272
+ IRQ4_HOOK_PAGE = $0694 ; 中断 4 钩子所在页组的首页号
273
+ NMI_COUNTER_UP = $0304 ; 每次 NMI 加 1 的计数
274
+ MOUSE_ABSENT = $0634 ; 鼠标不可用标志:允许鼠标中断后,在线清 0,否则 $FF
275
+ ESC_BREAK = $063D ; 按 ESC 中断开关:非 0 时按 ESC 会恢复上下文栈顶的恢复点
276
+ CONTEXT_COUNT = $0655 ; 上下文栈里的恢复点个数减 1,空栈为 $FF
277
+ CLOCK_SECONDS = $068A ; 软件时钟:秒
278
+ CLOCK_MINUTES = $068B ; 软件时钟:分
279
+ CLOCK_HOURS = $068C ; 软件时钟:时
280
+ CLOCK_MIDNIGHT_FLAG = $068D ; 软件时钟过午夜标志:设置日期时清 0,非 0 时取日期要先加 1 天
174
281
 
175
282
  ; ---- 变量:系统调用的参数单元,含义随服务而定(内核 RAM)----
176
283
  PARAM_0646 = $0646 ; 鼠标 X 下限,或显存地址高字节
177
284
  PARAM_0647 = $0647 ; 鼠标 Y 下限,或显存地址低字节
178
285
  PARAM_0648 = $0648 ; 鼠标 X 上限,或屏幕缓冲的列
179
286
  PARAM_0649 = $0649 ; 鼠标 Y 上限,或屏幕缓冲的行
287
+ PARAM_064F = $064F ; 个数、长度或字节数,含义随服务而定
180
288
  PARAM_0652 = $0652 ; 通用参数,多数服务从这里取输入
181
289
  PARAM_0653 = $0653 ; 通用参数或返回值,如读到的字节
182
290
 
@@ -198,19 +306,113 @@ ERR_ACCESS_DENIED = $05 ; 访问被拒绝,如写只读文件
198
306
  ERR_NO_MEMORY = $08 ; 无足够内存,没有足够的连续空闲页
199
307
  ERR_BAD_ADDRESS = $09 ; 无效的内存地址,页号不合法
200
308
  ERR_NOT_READY = $15 ; 驱动器未准备好
309
+ ERR_BAD_DISK_PARAM = $10 ; 磁盘操作参数错,面、磁道超出范围
310
+ ERR_WRITE_PROTECT = $13 ; 磁盘写保护,写操作失败
311
+ ERR_BAD_POSITION = $14 ; 文件读写位置错误
312
+ ERR_CRC = $17 ; 循环冗余校验错
313
+ ERR_NO_DISK = $18 ; 驱动器中没有磁盘
314
+ ERR_UNKNOWN_DISK = $1A ; 未知磁盘类型
201
315
  ERR_FILE_EXISTS = $20 ; 文件已经存在
202
316
  ERR_BAD_PARAMETER = $25 ; 参数无效
317
+ ERR_DIR_EXISTS = $26 ; 目录已经存在
203
318
  ERR_BAD_NAME = $27 ; 文件名或目录名错误
204
319
  ERR_BAD_OPEN_MODE = $28 ; 文件打开方式错误
320
+ ERR_DIR_NOT_EMPTY = $29 ; 企图删除非空目录
321
+ ERR_DIR_TOO_DEEP = $2A ; 目录嵌套层数过多
205
322
  ERR_NO_SPACE = $2C ; 磁盘空间不够
323
+ ERR_DUPLICATE_NAME = $2D ; 文件名重复,如要建的目录与文件同名
206
324
  ERR_NOT_OPEN = $2E ; 文件未打开
207
325
 
208
326
  ; ---- 运行库入口(ROM 页组 0,经 FN_CALL_BANKED 且 SYS_GROUP=0 调用)----
209
327
  LIB_PRINT_HEX = $8047 ; 显示 A 的十六进制,经功能 $25 调用时 A 传不进去,不能用
210
328
  LIB_BEEP = $802D ; 发一声提示音
211
329
  LIB_CURSOR_LEFT = $8081 ; 光标左移一列,到行首移到上一行末尾
330
+ LIB_CURSOR_UP = $808F ; 光标移到上一行末尾,已在第一行时不动
212
331
  LIB_CURSOR_RIGHT = $80CF ; 光标右移一列,到第 32 列换行
213
332
  LIB_NEWLINE = $80E2 ; 换行,行满滚屏;调用前 CURSOR_COL 要置 1
214
333
  LIB_GET_KEY = $81F4 ; 等待按键,结果在 KEY_ASCII、KEY_SCAN
215
334
  LIB_PRINT_MESSAGE = $8202 ; 显示消息号为 LIB_GROUP 值的内置消息
216
335
  LIB_PRINT_STRING = $8262 ; 在光标处显示 STR_PTR 指向的字符串,不移动光标
336
+ FN_RANDOM = $4A ; 伪随机数:32 位移位寄存器 RANDOM_STATE
337
+ FN_DIV16 = $4B ; 16 位除以 8 位
338
+ FN_TIME_TEXT = $4C ; 时、分、秒转成 HH:MM:SS 文字
339
+ FN_DECIMAL_PARSE = $4D ; 十进制文字转数值
340
+ FN_DECIMAL_FORMAT = $4E ; 数值转十进制文字
341
+ FN_FLOAT_MUL = $4F ; 浮点乘
342
+ FN_FLOAT_DIV = $50 ; 浮点除
343
+ FN_FLOAT_ADD = $51 ; 浮点加
344
+ FN_FLOAT_SUB = $52 ; 浮点减
345
+ FN_LINE_STEP = $53 ; 直线步进(布雷森汉姆算法)
346
+ FN_INT24 = $54 ; 3 字节整数的加、减、乘、除
347
+ RANDOM_STATE = $0696 ; 伪随机数的 32 位寄存器,低字节在前
348
+ ARG_069E = $069E ; 第二个 3 字节整数的起点
349
+ ARG_06A1 = $06A1 ; 第二个浮点数的起点
350
+ ARG_06A8 = $06A8 ; 浮点运算结果的起点
351
+ ARG_06AA = $06AA ; 40 位整数结果与时间文字的起点
352
+ ARG_06AF = $06AF ; 40 位整数转文字的输入起点
353
+ LINE_BLOCK_PTR = $0008 ; 零页:直线步进参数块的指针,低字节在前
354
+ LINE_BLOCK_BUFFER = $7EE0 ; 扩展 RAM 高端的 18 字节,放直线步进的参数块:功能 $53 换页后程序窗口里的内容不可见,参数块必须放在任何映射下都可见的地方
355
+ SUB_SOUND_PLAY = $00 ; 载入并播放曲子,先关声音更新,播完前再打开
356
+ SUB_SOUND_STOP = $02 ; 停止播放
357
+ SUB_SOUND_STATUS = $03 ; 把 SOUND_STATUS 取到 PARAM_0653
358
+ SUB_SOUND_TRANSPOSE = $04 ; 把 PARAM_0653 加到 4 个声道的移调值
359
+ SUB_SOUND_TEMPO = $05 ; 把 PARAM_0653 加到拍速
360
+ SUB_SOUND_WAV = $0C ; 播放内存里的 WAV
361
+ SUB_SOUND_WAV_LOOP = $0D ; 重复播放 WAV,次数在 PARAM_0652
362
+ SUB_SOUND_EFFECT = $0B ; 先复位再按曲目号播放音效曲子
363
+ SOUND_STATUS = $03A1 ; 播放状态:停止后为 $FF
364
+ SOUND_TRANSPOSE = $0447 ; 4 个声道的移调值,连续 4 个字节
365
+ SOUND_TEMPO = $03D4 ; 拍速
366
+ FN_SPEECH_FLAGS = $74 ; 语音控制标志的开关
367
+ FN_SPEECH_SEND = $75 ; 发送语音数据
368
+ SPEECH_FLAGS = $032B ; 语音控制标志,位 0 为 0 同步发送、为 1 交给 NMI 发送
369
+ PARAM_064A = $064A ; 显示与语音服务的参数:字符码高字节、行距、词条序号高字节等
370
+ PARAM_064B = $064B ; 显示与语音服务的参数:字符码低字节、宽、词条序号低字节等
371
+ PARAM_064E = $064E ; 打印机发送变换模式等参数
372
+ FN_PRINTER = $76 ; 打印机服务,$76-$7A 是同一个入口,只看子功能
373
+ FN_IME = $6D ; 中文输入法服务
374
+ PRN_PAGE_LEFT = $04BC ; 本页剩余走纸量,16 位,高字节在前(单位 1/216 英寸)
375
+ PRN_BYTE = $04A4 ; 子功能 7 要发送的字节
376
+ PRN_POS_LO = $04B3 ; 子功能 5、6 的位置参数低字节
377
+ PRN_POS_HI = $04B4 ; 子功能 5、6 的位置参数高字节
378
+ IME_STATE = $6900 ; 输入法状态区起点:低 4 位是输入法序号
379
+ IME_ALLOW = $6901 ; 输入法允许位
380
+ IME_FLAGS = $6902 ; 输入法标志位:位 1 全角、位 2 暂停、位 4 自定义输入法可选
381
+ IME_KEY_RESULT = $6922 ; 处理一个键的结果:0 无输出、2 输出汉字内码、$82 按键原样传回
382
+ IME_KEY_OUT = $6923 ; 输入得到的字符或汉字,从这里起
383
+ IME_INPUT_COUNT = $6904 ; 已输入的字符个数
384
+ IME_INPUT_BUFFER = $6905 ; 输入缓冲,最多 6 个字符
385
+ PARAM_064C = $064C ; 显示参数:单元值或显示地址低字节
386
+ PARAM_064D = $064D ; 显示参数:单元值或显示地址高字节
387
+ PARAM_0650 = $0650 ; 单元个数或长度的高字节
388
+ PARAM_0651 = $0651 ; 刷新方式或等待帧数
389
+ PARAM_0654 = $0654 ; 调色板号
390
+ SYS_GROUP_2 = $0643 ; 第二个页组:解压到内存的目的页组、文字缓冲的目的页组
391
+ DEST_ADDR_LO = $0012 ; 零页:目的窗口地址低字节
392
+ DEST_ADDR_HI = $0013 ; 零页:目的窗口地址高字节
393
+ GLYPH_PAGE = $0644 ; 字模所在的页,功能 $3B 的结果
394
+ GLYPH_OFFSET_LO = $000E ; 零页:字模页内偏移低字节,功能 $3B 的结果
395
+ GLYPH_OFFSET_HI = $000F ; 零页:字模页内偏移高字节(高 4 位是窗口位),功能 $3B 的结果
396
+ DISPLAY_MODE = $0638 ; 显示模式影子:低 3 位是字模形式,位 7 为 1 取 8×16 字模
397
+ FN_DMA_NAMETABLE = $30 ; 名称表 DMA 与屏幕缓冲服务
398
+ FN_VRAM_FILL = $32 ; 用一个字节填充显存的一段
399
+ FN_VRAM_LOAD = $33 ; 把扩展 RAM 的一段 DMA 到显存
400
+ FN_GLYPH_ADDR = $3B ; 查字模的页与地址
401
+ FN_PUT_STRING_C = $3C ; 画二平面字符串到显存瓦片(汉字与西文)
402
+ FN_PUT_STRING_D = $3D ; 画四平面字符串到显存瓦片(汉字与西文)
403
+ FN_PUT_ASCII_C = $3E ; 画二平面字符串到显存瓦片(只处理单字节字符)
404
+ FN_PUT_ASCII_D = $3F ; 画四平面字符串到显存瓦片(只处理单字节字符)
405
+ FN_CELLS = $40 ; 把单元写进名称表缓冲并刷新
406
+ FN_TEXT_FIELD = $45 ; 在屏幕上显示一行文字(汉字与西文)
407
+ FN_TEXT_FIELD_ASCII = $46 ; 在屏幕上显示一行文字(只处理单字节字符)
408
+ FN_TEXT_BUFFER = $47 ; 把字符串画成点阵瓦片写进内存(汉字与西文)
409
+ FN_TEXT_BUFFER_ASCII = $48 ; 把字符串画成点阵瓦片写进内存(只处理单字节字符)
410
+ FN_WINDOW = $59 ; 窗口管理:保存与还原屏幕矩形
411
+ FN_IMAGE_RAW = $5A ; 不解压直接把一段图案 DMA 进显存
412
+ FN_UNPACK_TILES = $5B ; 解压图案流进显存
413
+ FN_UNPACK_MAP = $5C ; 解压映射流并写到屏幕
414
+ FN_PALETTE = $5D ; 写调色板
415
+ FN_IMAGE_FULL = $5E ; 显示整屏图片
416
+ FN_IMAGE_SHOW = $5F ; 显示压缩图片
417
+ FN_FILL_RECT = $60 ; 用一个单元值按效果铺满矩形
418
+ FN_UNPACK_MEMORY = $61 ; 解压到内存
@@ -0,0 +1,74 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-bank.h
4
+ * 说明:大程序(超过 16K)的换页支持:把代码与只读数据放进库页,调用时自动换入窗口 2。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含;只有在 fcdev.json 的 targetOptions 里写了 "banks": N(N 个库页)时才有库页可用。
9
+ * 程序文件的布局:第 0、1 页是常驻部分(窗口 0、1,放 main、运行库、没放进库页的全部代码与数据,共 8K),
10
+ * 第 2 页是库页 1(程序启动时就在窗口 2 里),第 3 页是栈页(窗口 3,放 C 软件栈,不能当库页),第 4 页起是库页 2、3、……。
11
+ * 库页 4K,起始地址 $A000;库页里放代码与只读数据(const),可写的变量放在常驻部分。
12
+ * 用法:库页里的函数在 .c 文件里用 SB_BANK_BEGIN(n) 与 SB_BANK_END() 包起来,声明在头文件里用 SB_BANK_CALLS_BEGIN(n) 与
13
+ * SB_BANK_CALLS_END() 包起来;之后从任何地方直接调用这些函数,编译器会经蹦床换入库页、调用、再换回来,库页函数之间可以嵌套调用。
14
+ * 限制:只有直接按函数名的调用经过蹦床,用函数指针调用库页函数、变参函数都不行;
15
+ * 库页里函数返回指向库页数据的指针,调用者拿到时窗口 2 已换回原来的库页,指针指向的内容可能已被换走;
16
+ * 库页里的代码调用运行库函数时,传给系统服务的地址如果在窗口 2 里,指的是当时换入的库页。
17
+ * 一个库页 4K,多个文件的库页段会按库页号合并到同一页,页放不下时链接失败。
18
+ * 程序最大约 468K(113 个库页):DOS 一次把整个文件装入内存,空闲的连续页不够时程序不能启动。
19
+ * ------------------------------------------------------------------------
20
+ */
21
+ #ifndef SB2000_BANK_H
22
+ #define SB2000_BANK_H
23
+
24
+ /** 蹦床:库页函数的调用都经它换页,库内部使用,程序不要直接调用。 */
25
+ void sbi_bank_trampoline(void);
26
+
27
+ /** 把字面量转成字符串,库内部使用。 */
28
+ #define SBI_BANK_STR(x) #x
29
+ #define SBI_BANK_STRING(x) SBI_BANK_STR(x)
30
+
31
+ /** 生成一条 #pragma,库内部使用。 */
32
+ #define SBI_BANK_PRAGMA_(x) _Pragma(#x)
33
+ #define SBI_BANK_PRAGMA(x) SBI_BANK_PRAGMA_(x)
34
+
35
+ /**
36
+ * 在 .c 文件里标出库页 n 的开始:之后定义的函数与只读数据放进库页 n(段 BANKn),直到 SB_BANK_END()。
37
+ * n 是 1 到 fcdev.json 里 banks 之间的整数字面量。
38
+ */
39
+ #define SB_BANK_BEGIN(n) \
40
+ SBI_BANK_PRAGMA(code-name (push, SBI_BANK_STRING(BANK##n))) \
41
+ SBI_BANK_PRAGMA(rodata-name (push, SBI_BANK_STRING(BANK##n)))
42
+
43
+ /** 结束 SB_BANK_BEGIN 标出的库页。 */
44
+ #define SB_BANK_END() \
45
+ SBI_BANK_PRAGMA(rodata-name (pop)) \
46
+ SBI_BANK_PRAGMA(code-name (pop))
47
+
48
+ /**
49
+ * 在声明库页 n 里的函数之前使用:之后声明的函数,调用时经蹦床换入库页 n,直到 SB_BANK_CALLS_END()。
50
+ * 要放在函数所在 .c 文件与调用者都包含的头文件里。
51
+ */
52
+ #define SB_BANK_CALLS_BEGIN(n) \
53
+ SBI_BANK_PRAGMA(wrapped-call (push, sbi_bank_trampoline, n))
54
+
55
+ /** 结束 SB_BANK_CALLS_BEGIN 标出的声明。 */
56
+ #define SB_BANK_CALLS_END() \
57
+ SBI_BANK_PRAGMA(wrapped-call (pop))
58
+
59
+ /**
60
+ * 把一个库页换进窗口 2,窗口 2 里原来的库页看不到了。调用蹦床时会自动换页,只有需要直接读库页里的数据时才自己调用。
61
+ *
62
+ * @syscall $29
63
+ * @param bank 库页号,1 到 fcdev.json 里 banks 的值。
64
+ */
65
+ void sb_bank_select(unsigned char bank);
66
+
67
+ /**
68
+ * 取窗口 2 当前的库页号。
69
+ *
70
+ * @return 库页号;程序刚启动时是 1。
71
+ */
72
+ unsigned char sb_bank_current(void);
73
+
74
+ #endif
@@ -0,0 +1,68 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-clock.h
4
+ * 说明:SB-DOS 程序的系统日期与时间。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。日期的年份范围是 1980 到 2099,时间的秒精度是 2 秒(设置时秒数取一半,读出时再乘 2)。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #ifndef SB2000_CLOCK_H
12
+ #define SB2000_CLOCK_H
13
+
14
+ /** 日期。 */
15
+ typedef struct {
16
+ /** 年,1980 到 2099。 */
17
+ unsigned int year;
18
+ /** 月,1 到 12。 */
19
+ unsigned char month;
20
+ /** 日,1 到当月天数。 */
21
+ unsigned char day;
22
+ } sb_date_t;
23
+
24
+ /** 时间。 */
25
+ typedef struct {
26
+ /** 时,0 到 23。 */
27
+ unsigned char hour;
28
+ /** 分,0 到 59。 */
29
+ unsigned char minute;
30
+ /** 秒,0 到 59,实际精度 2 秒。 */
31
+ unsigned char second;
32
+ } sb_time_t;
33
+
34
+ /**
35
+ * 设置系统日期。系统按年份能否被 4 整除判断闰年(不处理世纪年)。
36
+ *
37
+ * @syscall $7F/$01
38
+ * @param date 新日期。
39
+ * @return 0 成功;SB_ERR_BAD_PARAMETER 日期不合法,系统日期不变。
40
+ */
41
+ unsigned char sb_clock_set_date(const sb_date_t *date);
42
+
43
+ /**
44
+ * 取系统日期。过了午夜后第一次取时,系统先把日期加一天。
45
+ *
46
+ * @syscall $7F/$02
47
+ * @param date 返回当前日期。
48
+ */
49
+ void sb_clock_get_date(sb_date_t *date);
50
+
51
+ /**
52
+ * 设置系统时间。
53
+ *
54
+ * @syscall $7F/$03
55
+ * @param time 新时间。
56
+ * @return 0 成功;SB_ERR_BAD_PARAMETER 时间不合法,系统时间不变。
57
+ */
58
+ unsigned char sb_clock_set_time(const sb_time_t *time);
59
+
60
+ /**
61
+ * 取系统时间。
62
+ *
63
+ * @syscall $7F/$04
64
+ * @param time 返回当前时间。
65
+ */
66
+ void sb_clock_get_time(sb_time_t *time);
67
+
68
+ #endif
@@ -0,0 +1,141 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-disk.h
4
+ * 说明:SB-DOS 程序的软驱底层服务:按面、磁道、扇区读写,成批读写,扫描坏扇区,格式化磁道,空闲空间。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。软驱是 1.44MB:2 个面、80 个磁道、每道 18 个扇区,扇区 512 字节;
9
+ * 面从 0 起,磁道从 0 起,扇区号从 1 起。直接读写扇区会绕过文件系统,写错位置会破坏磁盘上的文件,
10
+ * 要读写文件请用 sb2000-file.h。所有函数返回软驱状态码,0 表示成功(常见的有 SB_ERR_BAD_DISK_PARAM 参数超出范围、
11
+ * SB_ERR_WRITE_PROTECT 写保护、SB_ERR_NOT_READY 驱动器未准备好、SB_ERR_CRC 校验错、SB_ERR_NO_DISK 没有磁盘、SB_ERR_UNKNOWN_DISK 未知磁盘类型)。
12
+ * 缓冲区指针必须在程序窗口 $8000-$BFFF 里;成批读写的数据放在扩展 RAM 页里(页用 sb_page_alloc 申请,用 sb_far_read、sb_far_write 存取)。
13
+ * ------------------------------------------------------------------------
14
+ */
15
+ #ifndef SB2000_DISK_H
16
+ #define SB2000_DISK_H
17
+
18
+ /** 一个扇区的字节数。 */
19
+ #define SB_DISK_SECTOR_SIZE 512
20
+ /** 每道的扇区数。 */
21
+ #define SB_DISK_SECTORS_PER_TRACK 18
22
+ /** 磁头(面)数。 */
23
+ #define SB_DISK_HEADS 2
24
+ /** 磁道数。 */
25
+ #define SB_DISK_TRACKS 80
26
+
27
+ /** 成批读写时遇到出错的扇区立即返回,状态码是该扇区的出错码。 */
28
+ #define SB_DISK_STOP_ON_ERROR 0x80
29
+ /** 成批读写时跳过出错的扇区继续,最后状态码为 0,没读到的扇区缓冲保持原样(出错被吞掉)。 */
30
+ #define SB_DISK_SKIP_ERRORS 0x00
31
+
32
+ /**
33
+ * 启动软驱并复位到 0 磁道,读出状态后停转。可用来检查驱动器是否就绪。
34
+ *
35
+ * @syscall $80/$00
36
+ * @return 0 成功;SB_ERR_NOT_READY 驱动器没有响应。
37
+ */
38
+ unsigned char sb_disk_init(void);
39
+
40
+ /**
41
+ * 启动软驱。文件服务会自己启动与停转软驱,只有直接读写扇区时才需要。
42
+ *
43
+ * @syscall $80/$06
44
+ * @return 0 成功;SB_ERR_NOT_READY 驱动器未准备好。
45
+ */
46
+ unsigned char sb_disk_start(void);
47
+
48
+ /**
49
+ * 让软驱停转。直接读写扇区之后调用,文件服务每次操作之后都会自己调用。
50
+ *
51
+ * @syscall $80/$07
52
+ */
53
+ void sb_disk_stop(void);
54
+
55
+ /**
56
+ * 读一个扇区,先检测盘片。
57
+ *
58
+ * @syscall $80/$02
59
+ * @param head 面,0 或 1。
60
+ * @param track 磁道,0 到 79。
61
+ * @param sector 扇区号,1 到 18。
62
+ * @param dest 接收 512 字节的缓冲区,在程序窗口里。
63
+ * @return 0 成功;SB_ERR_NO_DISK 驱动器中没有磁盘;SB_ERR_UNKNOWN_DISK 未知磁盘类型;SB_ERR_CRC 扇区校验错。
64
+ */
65
+ unsigned char sb_disk_read_sector(unsigned char head, unsigned char track, unsigned char sector, void *dest);
66
+
67
+ /**
68
+ * 写一个扇区,先检测盘片。
69
+ *
70
+ * @syscall $80/$03
71
+ * @param head 面,0 或 1。
72
+ * @param track 磁道,0 到 79。
73
+ * @param sector 扇区号,1 到 18。
74
+ * @param src 要写入的 512 字节,在程序窗口里。
75
+ * @return 0 成功;SB_ERR_WRITE_PROTECT 磁盘写保护;SB_ERR_NO_DISK 驱动器中没有磁盘;SB_ERR_UNKNOWN_DISK 未知磁盘类型。
76
+ */
77
+ unsigned char sb_disk_write_sector(unsigned char head, unsigned char track, unsigned char sector, const void *src);
78
+
79
+ /**
80
+ * 从起始扇区连续读若干扇区到扩展 RAM 页里,扇区号递增,满 18 换面,两面满换磁道。先检测盘片。
81
+ *
82
+ * @syscall $80/$04
83
+ * @param head 起始面,0 或 1。
84
+ * @param track 起始磁道,0 到 79。
85
+ * @param sector 起始扇区号,1 到 18。
86
+ * @param page 接收数据的扩展 RAM 页号。
87
+ * @param page_sector 数据从页内第几个 512 字节开始放,0 到 7;每页放 8 个扇区,页要有足够的连续页。
88
+ * @param count 扇区数。
89
+ * @param mode SB_DISK_STOP_ON_ERROR 或 SB_DISK_SKIP_ERRORS,见这两个常量的说明。
90
+ * @return 0 成功;SB_ERR_NO_DISK 驱动器中没有磁盘;SB_ERR_CRC 等扇区出错码(mode 为 SB_DISK_STOP_ON_ERROR 时)。
91
+ */
92
+ unsigned char sb_disk_read_sectors(unsigned char head, unsigned char track, unsigned char sector,
93
+ unsigned char page, unsigned char page_sector, unsigned int count, unsigned char mode);
94
+
95
+ /**
96
+ * 把扩展 RAM 页里的数据连续写到若干扇区,扇区号递增的规则同 sb_disk_read_sectors。先检测盘片,写保护时立即停止。
97
+ *
98
+ * @syscall $80/$05
99
+ * @param head 起始面,0 或 1。
100
+ * @param track 起始磁道,0 到 79。
101
+ * @param sector 起始扇区号,1 到 18。
102
+ * @param page 数据所在的扩展 RAM 页号。
103
+ * @param page_sector 数据从页内第几个 512 字节开始,0 到 7。
104
+ * @param count 扇区数。
105
+ * @param mode SB_DISK_STOP_ON_ERROR 或 SB_DISK_SKIP_ERRORS。
106
+ * @return 0 成功;SB_ERR_WRITE_PROTECT 磁盘写保护;SB_ERR_NO_DISK 驱动器中没有磁盘。
107
+ */
108
+ unsigned char sb_disk_write_sectors(unsigned char head, unsigned char track, unsigned char sector,
109
+ unsigned char page, unsigned char page_sector, unsigned int count, unsigned char mode);
110
+
111
+ /**
112
+ * 逐个读一个磁道的 18 个扇区,读不出的在位图里置位。不检测盘片,直接读每个扇区。
113
+ *
114
+ * @syscall $80/$08
115
+ * @param head 面,0 或 1。
116
+ * @param track 磁道,0 到 79。
117
+ * @param bad_map 返回 3 字节位图:第 0 字节的位 7 到位 0 依次对应扇区 1 到 8,第 1 字节对应扇区 9 到 16,第 2 字节的位 7、位 6 对应扇区 17、18;置位表示读不出。
118
+ * @return 0 成功;SB_ERR_BAD_DISK_PARAM 面或磁道超出范围。
119
+ */
120
+ unsigned char sb_disk_scan_track(unsigned char head, unsigned char track, unsigned char *bad_map);
121
+
122
+ /**
123
+ * 格式化一个磁道:磁道 0 的 18 个扇区填 $00,其他磁道填 $F6。先检测盘片。会清掉这个磁道上的全部数据。
124
+ *
125
+ * @syscall $80/$01
126
+ * @param head 面,0 或 1。
127
+ * @param track 磁道,0 到 79。
128
+ * @return 0 成功;SB_ERR_BAD_DISK_PARAM 面或磁道超出范围;SB_ERR_WRITE_PROTECT 磁盘写保护;SB_ERR_NO_DISK 驱动器中没有磁盘。
129
+ */
130
+ unsigned char sb_disk_format_track(unsigned char head, unsigned char track);
131
+
132
+ /**
133
+ * 取磁盘上的空闲字节数(空闲簇数乘每簇字节数)。
134
+ *
135
+ * @syscall $7B/$01、$7B/$06
136
+ * @param bytes 返回空闲字节数。
137
+ * @return 0 成功;其他是读 FAT 时的磁盘出错码。
138
+ */
139
+ unsigned char sb_disk_free_bytes(unsigned long *bytes);
140
+
141
+ #endif