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.
Files changed (260) hide show
  1. package/README.md +21 -2
  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
  3. package/docs/02-/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +157 -0
  4. package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +123 -0
  5. package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +51 -0
  6. package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +100 -0
  7. package/docs/06-/345/217/215/346/261/207/347/274/226.md +103 -0
  8. package/docs/07-/345/210/233/345/273/272/345/214/205/344/270/216/346/250/241/346/235/277.md +74 -0
  9. package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +72 -0
  10. package/docs/09-/345/217/221/345/270/203.md +67 -0
  11. package/docs/10-VS Code/346/211/251/345/261/225.md" +131 -0
  12. package/docs/nes/01-NES/347/233/256/346/240/207.md +52 -0
  13. package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +252 -0
  14. 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
  15. package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +27 -0
  16. package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +46 -0
  17. package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +10 -0
  18. package/package.json +4 -3
  19. package/src/api/header-parser.mjs +78 -0
  20. package/src/api/index.mjs +128 -0
  21. package/src/build/bank-link-config.mjs +74 -0
  22. package/src/build/index.mjs +1 -0
  23. package/src/build/program-builder.mjs +5 -2
  24. package/src/cli/commands/api-command.mjs +62 -0
  25. package/src/cli/commands/docs-command.mjs +58 -0
  26. package/src/cli/index.mjs +6 -0
  27. package/src/docs/doc-index.mjs +101 -0
  28. package/src/docs/doc-topics.mjs +38 -0
  29. package/src/docs/index.mjs +10 -0
  30. package/src/targets/target-registry.mjs +38 -0
  31. package/targets/nes/lib/fcnes.lib +0 -0
  32. package/targets/nes/lib/nes-font.o +0 -0
  33. package/targets/sb2000/api-reference.md +3295 -0
  34. package/targets/sb2000/api-unwrapped.json +36 -0
  35. package/targets/sb2000/asminc/sb2000.inc +203 -1
  36. package/targets/sb2000/include/sb2000-bank.h +74 -0
  37. package/targets/sb2000/include/sb2000-clock.h +68 -0
  38. package/targets/sb2000/include/sb2000-disk.h +141 -0
  39. package/targets/sb2000/include/sb2000-display.h +352 -0
  40. package/targets/sb2000/include/sb2000-file.h +273 -0
  41. package/targets/sb2000/include/sb2000-ime.h +158 -0
  42. package/targets/sb2000/include/sb2000-input.h +192 -0
  43. package/targets/sb2000/include/sb2000-math.h +228 -0
  44. package/targets/sb2000/include/sb2000-memory.h +115 -0
  45. package/targets/sb2000/include/sb2000-printer.h +116 -0
  46. package/targets/sb2000/include/sb2000-sound.h +134 -0
  47. package/targets/sb2000/include/sb2000-symbols.h +397 -1
  48. package/targets/sb2000/include/sb2000-system.h +219 -0
  49. package/targets/sb2000/include/sb2000-text.h +99 -0
  50. package/targets/sb2000/include/sb2000.h +13 -20
  51. package/targets/sb2000/lib/crt0.o +0 -0
  52. package/targets/sb2000/lib/sb2000.lib +0 -0
  53. package/targets/sb2000/lib-build.json +1 -1
  54. package/targets/sb2000/link-banked.cfg +42 -0
  55. package/targets/sb2000/src/crt0.s +89 -4
  56. package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
  57. package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
  58. package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
  59. package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
  60. package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
  61. package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
  62. package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
  63. package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
  64. package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
  65. package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
  66. package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
  67. package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
  68. package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
  69. package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
  70. package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
  71. package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
  72. package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
  73. package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
  74. package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
  75. package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
  76. package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
  77. package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
  78. package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
  79. package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
  80. package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
  81. package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
  82. package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
  83. package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
  84. package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
  85. package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
  86. package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
  87. package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
  88. package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
  89. package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
  90. package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
  91. package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
  92. package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
  93. package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
  94. package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
  95. package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
  96. package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
  97. package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
  98. package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
  99. package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
  100. package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
  101. package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
  102. package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
  103. package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
  104. package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
  105. package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
  106. package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
  107. package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
  108. package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
  109. package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
  110. package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
  111. package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
  112. package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
  113. package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
  114. package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
  115. package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
  116. package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
  117. package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
  118. package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
  119. package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
  120. package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
  121. package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
  122. package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
  123. package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
  124. package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
  125. package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
  126. package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
  127. package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
  128. package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
  129. package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
  130. package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
  131. package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
  132. package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
  133. package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
  134. package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
  135. package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
  136. package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
  137. package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
  138. package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
  139. package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
  140. package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
  141. package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
  142. package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
  143. package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
  144. package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
  145. package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
  146. package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
  147. package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
  148. package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
  149. package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
  150. package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
  151. package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
  152. package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
  153. package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
  154. package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
  155. package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
  156. package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
  157. package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
  158. package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
  159. package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
  160. package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
  161. package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
  162. package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
  163. package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
  164. package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
  165. package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
  166. package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
  167. package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
  168. package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
  169. package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
  170. package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
  171. package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
  172. package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
  173. package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
  174. package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
  175. package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
  176. package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
  177. package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
  178. package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
  179. package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
  180. package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
  181. package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
  182. package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
  183. package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
  184. package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
  185. package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
  186. package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
  187. package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
  188. package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
  189. package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
  190. package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
  191. package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
  192. package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
  193. package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
  194. package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
  195. package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
  196. package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
  197. package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
  198. package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
  199. package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
  200. package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
  201. package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
  202. package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
  203. package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
  204. package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
  205. package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
  206. package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
  207. package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
  208. package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
  209. package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
  210. package/targets/sb2000/src/lib/sb-internal.h +111 -0
  211. package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
  212. package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
  213. package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
  214. package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
  215. package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
  216. package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
  217. package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
  218. package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
  219. package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
  220. package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
  221. package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
  222. package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
  223. package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
  224. package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
  225. package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
  226. package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
  227. package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
  228. package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
  229. package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
  230. package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
  231. package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
  232. package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
  233. package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
  234. package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
  235. package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
  236. package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
  237. package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
  238. package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
  239. package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
  240. package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
  241. package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
  242. package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
  243. package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
  244. package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
  245. package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
  246. package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
  247. package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
  248. package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
  249. package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
  250. package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
  251. package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
  252. package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
  253. package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
  254. package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
  255. package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
  256. package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
  257. package/targets/sb2000/src/lib/text/sb-print.c +35 -0
  258. package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
  259. package/targets/sb2000/src/sb2000.s +0 -3
  260. package/targets/sb2000/target.json +14 -0
@@ -0,0 +1,158 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-ime.h
4
+ * 说明:SB-DOS 程序的中文输入法服务:初始化与选择输入法、状态与全半角、处理按键得到汉字、十六进制与区位码转换。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。输入法状态放在 ERAM $6900 起,状态行画在屏幕上(调用显示服务 $45)。
9
+ * 输入法序号:0 区位、1 全拼、2 双拼、3 五笔、4 表形、5 认知、6 自定义、7 扩充、8 图形、9 英文;3-6 需要外挂模块,7 不可选。
10
+ * 处理按键的结果在 sb_ime_result_t 里:flag 为 0 无输出、2 输出汉字内码(output 里每个汉字 2 个字节)、$82 按键原样传回。
11
+ * ------------------------------------------------------------------------
12
+ */
13
+ #ifndef SB2000_IME_H
14
+ #define SB2000_IME_H
15
+
16
+ /** 输入法序号:区位。 */
17
+ #define SB_IME_QUWEI 0
18
+ /** 输入法序号:全拼。 */
19
+ #define SB_IME_PINYIN 1
20
+ /** 输入法序号:双拼。 */
21
+ #define SB_IME_SHUANGPIN 2
22
+ /** 输入法序号:英文。 */
23
+ #define SB_IME_ENGLISH 9
24
+ /** sb_ime_select 的 flags:同时核对 ERAM 里的允许位。 */
25
+ #define SB_IME_CHECK_ALLOWED 0x80
26
+
27
+ /** 初始化参数。 */
28
+ typedef struct {
29
+ /** 状态行所在的行号。 */
30
+ unsigned char row;
31
+ /** 状态行的图块基数,16 位。 */
32
+ unsigned int tile;
33
+ /** 状态行显示用的子功能号(选名称表等)。 */
34
+ unsigned char subfunction;
35
+ /** 状态行颜色。 */
36
+ unsigned char color;
37
+ /** 初始输入法序号,0 到 9。 */
38
+ unsigned char method;
39
+ /** 允许位(ERAM $6901)。 */
40
+ unsigned char allow;
41
+ /** 标志位(ERAM $6902)。 */
42
+ unsigned char flags;
43
+ } sb_ime_config_t;
44
+
45
+ /** 处理一个键的结果。 */
46
+ typedef struct {
47
+ /** 结果标志:0 无输出、2 输出汉字内码、$82 按键原样传回。 */
48
+ unsigned char flag;
49
+ /** 输出的内容,每个汉字 2 个字节(GB2312)。 */
50
+ unsigned char output[16];
51
+ } sb_ime_result_t;
52
+
53
+ /**
54
+ * 初始化输入法:记下状态行的位置与颜色,选择初始输入法,登记说明文字。
55
+ *
56
+ * @syscall $6D/$00
57
+ * @param config 初始化参数。
58
+ * @return 0 成功;1 输入法序号不小于 10、没有权限或不可选,其余参数已写入。
59
+ */
60
+ unsigned char sb_ime_init(const sb_ime_config_t *config);
61
+
62
+ /**
63
+ * 选择输入法。成功时清按键队列与输入缓冲,状态行换成该输入法的名称。
64
+ *
65
+ * @syscall $6D/$01
66
+ * @param method 输入法序号 0 到 9;序号 3 到 6 要 ERAM $0392 里对应的位允许,7 不可选。
67
+ * @param flags 0,或 SB_IME_CHECK_ALLOWED 表示同时核对允许位。
68
+ * @return 0 成功;1 失败,状态不变。
69
+ */
70
+ unsigned char sb_ime_select(unsigned char method, unsigned char flags);
71
+
72
+ /**
73
+ * 设置输入法状态:允许位与标志位(只取低 7 位,位 7 保留)。
74
+ *
75
+ * @syscall $6D/$02
76
+ * @param allow 允许位。
77
+ * @param flags 标志位。
78
+ */
79
+ void sb_ime_set_state(unsigned char allow, unsigned char flags);
80
+
81
+ /**
82
+ * 取输入法状态。
83
+ *
84
+ * @syscall $6D/$08
85
+ * @param allow 返回允许位。
86
+ * @param flags 返回标志位的低 7 位。
87
+ */
88
+ void sb_ime_get_state(unsigned char *allow, unsigned char *flags);
89
+
90
+ /**
91
+ * 取当前输入法序号。
92
+ *
93
+ * @syscall $6D/$07
94
+ * @return 序号 0 到 9。
95
+ */
96
+ unsigned char sb_ime_get_method(void);
97
+
98
+ /**
99
+ * 恢复被暂停的输入法:暂停标志置位时清除它并刷新状态行,否则什么都不做。
100
+ *
101
+ * @syscall $6D/$03
102
+ */
103
+ void sb_ime_resume(void);
104
+
105
+ /**
106
+ * 暂停输入法:清候选字,状态行清为空,暂停标志置位。已经暂停时什么都不做。暂停期间按键原样传回。
107
+ *
108
+ * @syscall $6D/$04
109
+ */
110
+ void sb_ime_suspend(void);
111
+
112
+ /**
113
+ * 设置半角或全角:状态行文字换成“半角”或“全角”,标志位里的全角位相应清除或置位。全角时输出的半角符号会换成全角内码。
114
+ *
115
+ * @syscall $6D/$05、$6D/$06
116
+ * @param full 0 半角,非 0 全角。
117
+ */
118
+ void sb_ime_set_width(unsigned char full);
119
+
120
+ /**
121
+ * 处理一个按键(不等待):从键盘队列取一个键交给输入法,没有键时直接返回。
122
+ * 输入法的热键:Alt+F1 到 Alt+F10 选输入法 0 到 9,Ctrl+F1 暂停与恢复,Ctrl+F8、Ctrl+F9 切换全角半角,数字键 1 到 5 与空格选候选字。
123
+ *
124
+ * @syscall $6D/$0B
125
+ * @param result 返回处理结果。
126
+ * @return 结果标志,同 result->flag:0 无输出,2 输出汉字内码,$82 按键原样传回。
127
+ */
128
+ unsigned char sb_ime_key(sb_ime_result_t *result);
129
+
130
+ /**
131
+ * 等待并处理按键,直到输入法有结果(结果标志不为 0)才返回,没有键时一直等下去。
132
+ *
133
+ * @syscall $6D/$0A
134
+ * @param result 返回处理结果。
135
+ * @return 结果标志,同 result->flag。
136
+ */
137
+ unsigned char sb_ime_key_wait(sb_ime_result_t *result);
138
+
139
+ /**
140
+ * 把一个 16 位内码转成 4 个小写十六进制字符。
141
+ *
142
+ * @syscall $6D/$0E
143
+ * @param code 内码。
144
+ * @param text 返回 4 个字符与结尾的 0,要有 5 字节空间。
145
+ */
146
+ void sb_ime_hex(unsigned int code, char *text);
147
+
148
+ /**
149
+ * 把 4 个输入字符转成汉字内码:全是数字当区位码(4 位十进制),第一个字符是 a 到 f 当 4 位十六进制内码。
150
+ *
151
+ * @syscall $6D/$0D
152
+ * @param chars 4 个输入字符。
153
+ * @param code 返回内码。
154
+ * @return 0 成功;1 不合法。
155
+ */
156
+ unsigned char sb_ime_parse(const char *chars, unsigned int *code);
157
+
158
+ #endif
@@ -0,0 +1,192 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-input.h
4
+ * 说明:SB-DOS 程序的输入:键盘、手柄、鼠标。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。
9
+ * 键盘:系统把按键放进 5 个按键容量的队列(超过的丢弃),每个按键有 ASCII 码和扫描码(IBM 扫描码集 1),
10
+ * 功能键、方向键等没有字符的键 ASCII 码为 0;按键组合下的结果与标准 IBM 美式键盘一致。
11
+ * 手柄:由 NMI 每帧读取,所以 NMI 要开着;键码 $FF 表示没有键,1 号手柄 $0F(A)、$0E(B)、$0D(选择)、$0C(开始)、
12
+ * $0B(上)、$0A(下)、$09(左)、$08(右),2 号手柄同序为 $07-$00,同时按下多个键时取最高位的。
13
+ * 鼠标:模拟器与真机都把鼠标当成串口鼠标,数据在中断里解析,程序只读坐标与按键状态。
14
+ * ------------------------------------------------------------------------
15
+ */
16
+ #ifndef SB2000_INPUT_H
17
+ #define SB2000_INPUT_H
18
+
19
+ /** 两个鼠标键的状态,下标 0 是按键 1,下标 1 是按键 2。 */
20
+ typedef struct {
21
+ /** 状态:0 没按,1 按住,2 刚松开。 */
22
+ unsigned char state[2];
23
+ /** 双击:1 表示发生了双击,读走即清。 */
24
+ unsigned char double_click[2];
25
+ /** 单击:1 表示按下后松开过,读走即清;拖动后松开不算单击。 */
26
+ unsigned char click[2];
27
+ /** 拖动:1 表示按住并移动。 */
28
+ unsigned char drag[2];
29
+ } sb_mouse_buttons_t;
30
+
31
+ /**
32
+ * 等待按键并返回它的 ASCII 码。
33
+ *
34
+ * @return 按键的 ASCII 码;没有字符的键(如功能键)为 0。
35
+ */
36
+ unsigned char sb_getkey(void);
37
+
38
+ /**
39
+ * 等到有按键,取出它的 ASCII 码与扫描码。
40
+ *
41
+ * @syscall $6B/$04
42
+ * @return 低字节是 ASCII 码,高字节是扫描码。
43
+ */
44
+ unsigned int sb_key_wait(void);
45
+
46
+ /**
47
+ * 不等待,取出队列里的一个按键。
48
+ *
49
+ * @syscall $6B/$03
50
+ * @return 低字节是 ASCII 码,高字节是扫描码;队列为空时为 0。
51
+ */
52
+ unsigned int sb_key_poll(void);
53
+
54
+ /**
55
+ * 按键队列里的按键数。
56
+ *
57
+ * @syscall $6B/$06
58
+ * @return 按键数,0 到 5。
59
+ */
60
+ unsigned char sb_key_count(void);
61
+
62
+ /**
63
+ * 清空按键队列。
64
+ *
65
+ * @syscall $6B/$05
66
+ */
67
+ void sb_key_flush(void);
68
+
69
+ /**
70
+ * 复位键盘与鼠标,清空按键队列。约需几十帧。
71
+ *
72
+ * @syscall $6B/$00
73
+ */
74
+ void sb_key_init(void);
75
+
76
+ /**
77
+ * 打开按 ESC 中断程序:之后按 ESC,系统取出上下文栈顶的恢复点(sb_context_save 保存的)并跳转过去。
78
+ *
79
+ * @syscall $6B/$01
80
+ */
81
+ void sb_break_enable(void);
82
+
83
+ /**
84
+ * 关闭按 ESC 中断程序。
85
+ *
86
+ * @syscall $6B/$02
87
+ */
88
+ void sb_break_disable(void);
89
+
90
+ /**
91
+ * 修饰键状态:位 0 右 Shift,位 1 左 Shift,位 2 Ctrl,位 3 Alt,位 4 ScrollLock,位 5 NumLock,位 6 CapsLock,位 7 Insert。
92
+ *
93
+ * @return 修饰键状态。
94
+ */
95
+ unsigned char sb_key_modifiers(void);
96
+
97
+ /**
98
+ * 复位并识别键盘。复位后键盘不再上报按键,需要再调用 sb_key_init 才恢复,一般用 sb_key_init 即可。
99
+ *
100
+ * @syscall $17
101
+ * @return 1 通过,0 失败。
102
+ */
103
+ unsigned char sb_keyboard_reset(void);
104
+
105
+ /**
106
+ * 初始化手柄状态,并打开 NMI 里读手柄的服务。
107
+ *
108
+ * @syscall $12/$85、$6A/$00
109
+ */
110
+ void sb_pad_init(void);
111
+
112
+ /**
113
+ * 不等待,取一个按下的手柄键。
114
+ *
115
+ * @syscall $6A/$01
116
+ * @return 键码,$FF 表示没有键。
117
+ */
118
+ unsigned char sb_pad_poll(void);
119
+
120
+ /**
121
+ * 等到有手柄键按下。
122
+ *
123
+ * @syscall $6A/$02
124
+ * @return 键码。
125
+ */
126
+ unsigned char sb_pad_wait(void);
127
+
128
+ /**
129
+ * 取一个手柄的原始按键状态,由 sb_pad_poll、sb_pad_wait 更新:位 7 是 A,位 6 是 B,位 5 选择,位 4 开始,
130
+ * 位 3 上,位 2 下,位 1 左,位 0 右。
131
+ *
132
+ * @param pad 手柄号,0 是 1 号手柄,其他是 2 号手柄。
133
+ * @return 原始状态。
134
+ */
135
+ unsigned char sb_pad_state(unsigned char pad);
136
+
137
+ /**
138
+ * 复位鼠标,返回鼠标是否接入。复位要尝试多次,约需几十帧;之后要用 sb_irq_enable(SB_IRQ_SOURCE_MOUSE) 允许鼠标中断,
139
+ * 再设置坐标范围与初始坐标。
140
+ *
141
+ * @syscall $14
142
+ * @return 非 0 表示鼠标已接入,0 表示没有鼠标。
143
+ */
144
+ unsigned char sb_mouse_reset(void);
145
+
146
+ /**
147
+ * 设置鼠标光标坐标的范围,原有的双击间隔不变。
148
+ *
149
+ * @syscall $6C/$00
150
+ * @param x_min X 下限。
151
+ * @param y_min Y 下限。
152
+ * @param x_max X 上限。
153
+ * @param y_max Y 上限。
154
+ */
155
+ void sb_mouse_set_limits(unsigned char x_min, unsigned char y_min, unsigned char x_max, unsigned char y_max);
156
+
157
+ /**
158
+ * 设置鼠标光标的坐标。
159
+ *
160
+ * @syscall $6C/$04
161
+ * @param x X 坐标。
162
+ * @param y Y 坐标。
163
+ */
164
+ void sb_mouse_set_position(unsigned char x, unsigned char y);
165
+
166
+ /**
167
+ * 取鼠标光标的坐标。每收到一个数据包,坐标就加上位移,并限制在设置的范围内。
168
+ *
169
+ * @syscall $6C/$02
170
+ * @param x 返回 X 坐标。
171
+ * @param y 返回 Y 坐标。
172
+ */
173
+ void sb_mouse_position(unsigned char *x, unsigned char *y);
174
+
175
+ /**
176
+ * 取两个鼠标键的状态。单击、双击读走即清。
177
+ *
178
+ * @syscall $6C/$03
179
+ * @param buttons 返回按键状态。
180
+ */
181
+ void sb_mouse_buttons(sb_mouse_buttons_t *buttons);
182
+
183
+ /**
184
+ * 设置鼠标双击的间隔:按下后在这个间隔内再次按下算双击,间隔由定时器中断计时,默认 10。
185
+ * 间隔为 0 时不产生双击。
186
+ *
187
+ * @syscall $6C/$01
188
+ * @param interval 间隔,单位是定时器中断的次数。
189
+ */
190
+ void sb_mouse_set_double_click(unsigned char interval);
191
+
192
+ #endif
@@ -0,0 +1,228 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-math.h
4
+ * 说明:SB-DOS 程序的数学服务:伪随机数、整数除法、时间文字、十进制文字与浮点数、直线步进、3 字节整数运算。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。这些服务的参数区在 $069A-$06B3,函数帮你把数据放进去再取回来;指针参数必须在程序窗口 $8000-$BFFF 里。
9
+ * 浮点数是 7 个字节:阶码、符号($00 正、$FF 负)、5 字节尾数,值 = ±尾数 ÷ 2^40 × 2^阶码;十进制文字是 13 个字符:1 个符号字符(空格或 -)加 12 个带小数点的数字字符。
10
+ * ------------------------------------------------------------------------
11
+ */
12
+ #ifndef SB2000_MATH_H
13
+ #define SB2000_MATH_H
14
+
15
+ /** 浮点数,7 个字节。值 = ±尾数 ÷ 2^40 × 2^阶码。 */
16
+ typedef struct {
17
+ /** 阶码。 */
18
+ unsigned char exponent;
19
+ /** 符号,$00 表示正,$FF 表示负。 */
20
+ unsigned char sign;
21
+ /** 尾数,5 个字节,高字节在前。 */
22
+ unsigned char mantissa[5];
23
+ } sb_float_t;
24
+
25
+ /** 3 字节整数:1 个符号字节加 3 个数值字节。 */
26
+ typedef struct {
27
+ /** 符号,$00 表示正,$FF 表示负。 */
28
+ unsigned char sign;
29
+ /** 数值,3 个字节,高字节在前。 */
30
+ unsigned char value[3];
31
+ } sb_int24_t;
32
+
33
+ /** 直线步进的参数块,共 18 个字节。 */
34
+ typedef struct {
35
+ /** 当前点的横坐标,每走一步更新。 */
36
+ unsigned char x;
37
+ /** 当前点的纵坐标,每走一步更新。 */
38
+ unsigned char y;
39
+ /** 终点的横坐标。 */
40
+ unsigned char end_x;
41
+ /** 终点的纵坐标。 */
42
+ unsigned char end_y;
43
+ /** 本次前进的步数,0 表示 256 步。 */
44
+ unsigned char steps;
45
+ /** 系统用来存两轴长度、方向、误差与中间量的工作区,不要改。 */
46
+ unsigned char work[13];
47
+ } sb_line_t;
48
+
49
+ /**
50
+ * 设置伪随机数寄存器。寄存器的两个高字节全为 0 时,下一次步进前系统先把次高字节置成 $FF,所以种子 0 也能用。
51
+ *
52
+ * @syscall 直接写 $0696-$0699
53
+ * @param seed 32 位种子。
54
+ */
55
+ void sb_random_seed(unsigned long seed);
56
+
57
+ /**
58
+ * 把伪随机数寄存器步进一次,返回新的寄存器值。
59
+ *
60
+ * @syscall $4A/$01
61
+ * @return 步进后的 32 位寄存器值。
62
+ */
63
+ unsigned long sb_random_next(void);
64
+
65
+ /**
66
+ * 把伪随机数寄存器连续步进 100 次,用来打散刚设置的种子。
67
+ *
68
+ * @syscall $4A/$00
69
+ */
70
+ void sb_random_warm_up(void);
71
+
72
+ /**
73
+ * 16 位数除以 8 位数。
74
+ *
75
+ * @syscall $4B
76
+ * @param dividend 被除数。
77
+ * @param divisor 除数。
78
+ * @param quotient 返回商。
79
+ * @param remainder 返回余数。
80
+ * @return 0 成功;$FF 除数为 0,商与余数没有意义。
81
+ */
82
+ unsigned char sb_math_div16(unsigned int dividend, unsigned char divisor, unsigned int *quotient, unsigned char *remainder);
83
+
84
+ /**
85
+ * 把时、分、秒转成 HH:MM:SS 文字。
86
+ *
87
+ * @syscall $4C
88
+ * @param hour 时。
89
+ * @param minute 分。
90
+ * @param second 秒。
91
+ * @param text 返回 8 个字符加结尾的 0,要有 9 字节空间。
92
+ */
93
+ void sb_math_time_text(unsigned char hour, unsigned char minute, unsigned char second, char *text);
94
+
95
+ /**
96
+ * 十进制文字转浮点数。
97
+ *
98
+ * @syscall $4D/$00
99
+ * @param text 13 个字符:第 1 个是符号(空格或 -),后面 12 个是带小数点的数字。
100
+ * @param result 返回浮点数。
101
+ */
102
+ void sb_float_from_text(const char *text, sb_float_t *result);
103
+
104
+ /**
105
+ * 浮点数转十进制文字。
106
+ *
107
+ * @syscall $4E/$00
108
+ * @param value 浮点数。
109
+ * @param text 返回 13 个字符(符号加 12 位带小数点的数字)与结尾的 0,要有 14 字节空间。
110
+ */
111
+ void sb_float_to_text(const sb_float_t *value, char *text);
112
+
113
+ /**
114
+ * 浮点加法:a + b。
115
+ *
116
+ * @syscall $51
117
+ * @param a 第一个操作数。
118
+ * @param b 第二个操作数。
119
+ * @param result 返回结果,可以与 a 或 b 是同一个变量。
120
+ */
121
+ void sb_float_add(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
122
+
123
+ /**
124
+ * 浮点减法:a - b。
125
+ *
126
+ * @syscall $52
127
+ * @param a 第一个操作数。
128
+ * @param b 第二个操作数。
129
+ * @param result 返回结果,可以与 a 或 b 是同一个变量。
130
+ */
131
+ void sb_float_sub(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
132
+
133
+ /**
134
+ * 浮点乘法:a * b。
135
+ *
136
+ * @syscall $4F
137
+ * @param a 第一个操作数。
138
+ * @param b 第二个操作数。
139
+ * @param result 返回结果,可以与 a 或 b 是同一个变量。
140
+ */
141
+ void sb_float_mul(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
142
+
143
+ /**
144
+ * 浮点除法:a / b。除数的尾数为 0 时结果的第 1 个字节(阶码)为 $80。
145
+ *
146
+ * @syscall $50
147
+ * @param a 第一个操作数。
148
+ * @param b 第二个操作数。
149
+ * @param result 返回结果,可以与 a 或 b 是同一个变量。
150
+ */
151
+ void sb_float_div(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
152
+
153
+ /**
154
+ * 十进制数字文字转 40 位整数。前导空格当 0,超过 40 位时高位丢弃。
155
+ *
156
+ * @syscall $4D/$01
157
+ * @param digits 数字字符,不带符号与小数点。
158
+ * @param count 数字个数,0 到 12。
159
+ * @param value 返回 5 个字节的整数,高字节在前。
160
+ */
161
+ void sb_int40_from_text(const char *digits, unsigned char count, unsigned char *value);
162
+
163
+ /**
164
+ * 40 位整数转十进制数字文字,数字左对齐、右边补字符 0。
165
+ *
166
+ * @syscall $4E/$01
167
+ * @param value 5 个字节的整数,高字节在前。
168
+ * @param digits 返回 13 个数字字符与结尾的 0,要有 14 字节空间。
169
+ * @param length 返回去掉前导 0 后的有效位数,至少为 1。
170
+ * @return 0 成功;$FF 数值不小于 10^12,放不下。
171
+ */
172
+ unsigned char sb_int40_to_text(const unsigned char *value, char *digits, unsigned char *length);
173
+
174
+ /**
175
+ * 直线步进(布雷森汉姆算法):从当前点向终点前进指定的步数,落点写回 x、y。步数不小于主轴长度时直接落在终点。
176
+ *
177
+ * @syscall $53
178
+ * @param line 参数块,调用前填好 x、y、end_x、end_y;系统服务换页后程序窗口不可见,所以函数把它复制到 ERAM 里再调用,返回后复制回来。
179
+ * @param steps 前进的步数,0 表示 256 步。
180
+ */
181
+ void sb_line_step(sb_line_t *line, unsigned char steps);
182
+
183
+ /**
184
+ * 3 字节整数加法:a + b,带符号。
185
+ *
186
+ * @syscall $54/$00
187
+ * @param a 第一个操作数。
188
+ * @param b 第二个操作数。
189
+ * @param result 返回结果。
190
+ * @return 0 没有溢出;1 结果超过 24 位,result 里是低 24 位。
191
+ */
192
+ unsigned char sb_int24_add(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *result);
193
+
194
+ /**
195
+ * 3 字节整数减法:a - b,带符号。
196
+ *
197
+ * @syscall $54/$01
198
+ * @param a 第一个操作数。
199
+ * @param b 第二个操作数。
200
+ * @param result 返回结果。
201
+ * @return 0 没有溢出;1 结果超过 24 位,result 里是低 24 位。
202
+ */
203
+ unsigned char sb_int24_sub(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *result);
204
+
205
+ /**
206
+ * 3 字节整数乘法:a * b,乘积最多 48 位。
207
+ *
208
+ * @syscall $54/$02
209
+ * @param a 第一个操作数。
210
+ * @param b 第二个操作数。
211
+ * @param sign 返回乘积的符号,$00 正、$FF 负。
212
+ * @param product 返回 6 个字节的乘积,高字节在前。
213
+ */
214
+ void sb_int24_mul(const sb_int24_t *a, const sb_int24_t *b, unsigned char *sign, unsigned char *product);
215
+
216
+ /**
217
+ * 3 字节整数除法:a / b,得商与余数。
218
+ *
219
+ * @syscall $54/$03
220
+ * @param a 被除数。
221
+ * @param b 除数。
222
+ * @param quotient 返回商,符号是商的符号。
223
+ * @param remainder 返回余数的数值,符号字节与商相同。
224
+ * @return 0 成功;1 除数为 0,商与余数没有意义。
225
+ */
226
+ unsigned char sb_int24_div(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *quotient, sb_int24_t *remainder);
227
+
228
+ #endif
@@ -0,0 +1,115 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-memory.h
4
+ * 说明:SB-DOS 程序的内存服务:扩展 RAM 页的分配、跨页读写、窗口映射、窗口地址换算。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。
9
+ * 程序装在 $8000-$BFFF 的 4 个窗口里(每窗口 4K,对应扩展 RAM 的一页);扩展 RAM 的页号从 $80 起,
10
+ * 读文件、放图片、放大块数据都在扩展 RAM 页里,CPU 不能直接访问,用 sb_far_read、sb_far_write 读写。
11
+ * 本文件的函数都假定调用者的数据在程序窗口 $8000-$BFFF 或 $6000-$7FFF 内;
12
+ * 窗口 3($B000-$BFFF)里有程序的软件栈,不要把别的页映射给它。
13
+ * ------------------------------------------------------------------------
14
+ */
15
+ #ifndef SB2000_MEMORY_H
16
+ #define SB2000_MEMORY_H
17
+
18
+ /**
19
+ * 分配连续的扩展 RAM 页。页数为 0 时不分配,只返回第一个空闲页的页号。
20
+ *
21
+ * @syscall $7E/$00
22
+ * @param count 页数,每页 4K。
23
+ * @param first_page 返回分配到的第一个页号;失败时为 0。
24
+ * @return 0 成功;SB_ERR_NO_MEMORY 没有这么多连续的空闲页。
25
+ */
26
+ unsigned char sb_page_alloc(unsigned char count, unsigned char *first_page);
27
+
28
+ /**
29
+ * 释放连续的扩展 RAM 页。
30
+ *
31
+ * @syscall $7E/$01
32
+ * @param first_page 第一个页号,必须不小于 $80 且小于 $F0。
33
+ * @param count 页数;这个服务不检查页号加页数是否越过 $F0。
34
+ * @return 0 成功;SB_ERR_BAD_ADDRESS 起始页号不合法,没有释放任何页。
35
+ */
36
+ unsigned char sb_page_free(unsigned char first_page, unsigned char count);
37
+
38
+ /**
39
+ * 求最长的连续空闲页数。
40
+ *
41
+ * @syscall $7E/$02
42
+ * @return 页数;计数是 8 位,256 页全部空闲时回绕成 0。
43
+ */
44
+ unsigned char sb_page_largest_free(void);
45
+
46
+ /**
47
+ * 读扩展 RAM 页里的一个字节。
48
+ *
49
+ * @param page 页号。
50
+ * @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
51
+ * @return 读到的字节。
52
+ */
53
+ unsigned char sb_far_read_byte(unsigned char page, unsigned int offset);
54
+
55
+ /**
56
+ * 写扩展 RAM 页里的一个字节。
57
+ *
58
+ * @param page 页号。
59
+ * @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
60
+ * @param value 要写的字节。
61
+ */
62
+ void sb_far_write_byte(unsigned char page, unsigned int offset, unsigned char value);
63
+
64
+ /**
65
+ * 把扩展 RAM 里的一段数据读到内存,可以跨页。数据经 $0700 缓冲中转,调用期间会改写 $0700-$07FF。
66
+ *
67
+ * @param page 起始页号。
68
+ * @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
69
+ * @param dest 目的地,必须在程序窗口的前 3 个窗口($8000-$AFFF)、$6000-$7FFF 或内核 RAM 里,不能在窗口 3。
70
+ * @param length 字节数。
71
+ */
72
+ void sb_far_read(unsigned char page, unsigned int offset, void *dest, unsigned int length);
73
+
74
+ /**
75
+ * 把内存里的一段数据写到扩展 RAM,可以跨页。数据经 $0700 缓冲中转,调用期间会改写 $0700-$07FF。
76
+ *
77
+ * @param page 起始页号。
78
+ * @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
79
+ * @param src 数据来源,位置的要求同 sb_far_read 的 dest。
80
+ * @param length 字节数。
81
+ */
82
+ void sb_far_write(unsigned char page, unsigned int offset, const void *src, unsigned int length);
83
+
84
+ /**
85
+ * 把窗口地址换算成远指针:页号 = 地址高 4 位 - 8 + 页组首页号(按 8 位回绕),页内偏移是地址的低 12 位。
86
+ *
87
+ * @syscall $2C
88
+ * @param group 页组的首页号。
89
+ * @param address 窗口地址,$8000-$FFFF。
90
+ * @param page 返回页号。
91
+ * @param offset 返回页内偏移。
92
+ */
93
+ void sb_address_to_far(unsigned char group, unsigned int address, unsigned char *page, unsigned int *offset);
94
+
95
+ /**
96
+ * 把一个扩展 RAM 页映射到一个窗口。调用返回后映射保持,直到再次映射。
97
+ * 窗口 0-2 可以用来临时访问别的页;程序自己占用的窗口被换走后,里面的代码与数据在恢复前看不到。
98
+ * 窗口 3 里有程序的软件栈,不要映射。
99
+ *
100
+ * @syscall $29
101
+ * @param window 窗口号 0-3,0 是 $8000,1 是 $9000,2 是 $A000,3 是 $B000。
102
+ * @param page 页号。
103
+ */
104
+ void sb_window_map(unsigned char window, unsigned char page);
105
+
106
+ /**
107
+ * 把页组的 4 个连续页映射到 4 个窗口($8000-$BFFF),调用返回后映射保持。
108
+ * 调用者本身的代码所在的窗口也会换掉,所以新页组里同一地址要有同样的代码。
109
+ *
110
+ * @syscall $27
111
+ * @param group 页组的首页号。
112
+ */
113
+ void sb_window_map_group(unsigned char group);
114
+
115
+ #endif