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,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-home.c
4
+ * 说明:sb_printer_home 的实现:打印头回左端。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 2。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_home(void)
14
+ {
15
+ sb_syscall(SB_FN_PRINTER, 2);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-init-port.c
4
+ * 说明:sb_printer_init_port 的实现:初始化并口。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 $0E。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_init_port(void)
14
+ {
15
+ sb_syscall(SB_FN_PRINTER, 14);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-page-left.c
4
+ * 说明:sb_printer_page_left 的实现:取本页剩余走纸量。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:读 $04BC(高)、$04BD(低)。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned int sb_printer_page_left(void)
14
+ {
15
+ return ((unsigned int)SB_BYTE_AT(SB_PRN_PAGE_LEFT) << 8) | SB_BYTE_AT(SB_PRN_PAGE_LEFT + 1);
16
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-page-length.c
4
+ * 说明:sb_printer_page_length 的实现:设置页长计数。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 $0F:纸张类型写 $0652,页长写 $04BC(高)、$04BD(低)。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_page_length(unsigned char paper)
14
+ {
15
+ SB_BYTE_AT(SB_PARAM_0652) = paper;
16
+ sb_syscall(SB_FN_PRINTER, 15);
17
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-position.c
4
+ * 说明:sb_printer_position 的实现:横向定位。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 5(绝对)与 6(相对):位置写 $04B3/$04B4。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_position(unsigned char relative, unsigned int position)
14
+ {
15
+ SB_BYTE_AT(SB_PRN_POS_LO) = (unsigned char)position;
16
+ SB_BYTE_AT(SB_PRN_POS_HI) = (unsigned char)(position >> 8);
17
+ sb_syscall(SB_FN_PRINTER, relative ? 6 : 5);
18
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-reset.c
4
+ * 说明:sb_printer_reset 的实现:打印机复位。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 1。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_reset(void)
14
+ {
15
+ sb_syscall(SB_FN_PRINTER, 1);
16
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-send-byte.c
4
+ * 说明:sb_printer_send_byte 的实现:发送一个字节。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 7:字节放 $04A4;$0640 为 $FF 时什么都不发,调用前先清 0。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_send_byte(unsigned char value)
14
+ {
15
+ SB_BYTE_AT(SB_PRN_BYTE) = value;
16
+ SB_BYTE_AT(SB_SYS_STATUS) = 0;
17
+ sb_syscall(SB_FN_PRINTER, 7);
18
+ }
@@ -0,0 +1,29 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-text.c
4
+ * 说明:sb_printer_text 的实现:打印一段文字。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 0:文字起点用 $2C 换算成远指针放 $0641 与 $14/$15,$064F 为 0 表示以 0 结尾。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_text(const char *text, const sb_printer_style_t *style)
14
+ {
15
+ unsigned char page;
16
+ unsigned int offset;
17
+
18
+ SB_BYTE_AT(SB_PARAM_0646) = style ? style->width : 0;
19
+ SB_BYTE_AT(SB_PARAM_0647) = style ? style->dots : 0;
20
+ SB_BYTE_AT(SB_PARAM_0648) = style ? style->gap : 0;
21
+ SB_BYTE_AT(SB_PARAM_0649) = style ? style->feed : 0x18;
22
+ SB_BYTE_AT(SB_PARAM_064E) = style ? style->transform : 0;
23
+ SB_BYTE_AT(SB_PARAM_064F) = 0;
24
+ sb_address_to_far(SB_BYTE_AT(SB_PROGRAM_START_PAGE), (unsigned int)text, &page, &offset);
25
+ SB_BYTE_AT(SB_SYS_PAGE) = page;
26
+ SB_BYTE_AT(SB_FAR_OFFSET_LO) = (unsigned char)offset;
27
+ SB_BYTE_AT(SB_FAR_OFFSET_HI) = (unsigned char)(offset >> 8);
28
+ sb_syscall(SB_FN_PRINTER, 0);
29
+ }
@@ -0,0 +1,111 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-internal.h
4
+ * 说明:运行库内部使用的声明:几个只供库里的 C 函数调用的汇编小例程。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:不对外发布;库内部的辅助函数一律以 sbi_ 开头,不在接口检查的范围内。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #ifndef SB_INTERNAL_H
12
+ #define SB_INTERNAL_H
13
+
14
+ #include <sb2000.h>
15
+
16
+ /** 设置远指针:页号放 $0641,页内偏移放 $14/$15(偏移已不超过 $0FFF)。 */
17
+ #define SBI_SET_FAR(page, offset) \
18
+ do { \
19
+ SB_BYTE_AT(SB_SYS_PAGE) = (page); \
20
+ SB_BYTE_AT(SB_FAR_OFFSET_LO) = (unsigned char)(offset); \
21
+ SB_BYTE_AT(SB_FAR_OFFSET_HI) = (unsigned char)((offset) >> 8); \
22
+ } while (0)
23
+
24
+ /** 设置 $0C/$0D 里的调用地址或窗口地址。 */
25
+ #define SBI_SET_ENTRY(address) \
26
+ do { \
27
+ SB_BYTE_AT(SB_PROG_ENTRY_LO) = (unsigned char)(address); \
28
+ SB_BYTE_AT(SB_PROG_ENTRY_HI) = (unsigned char)((address) >> 8); \
29
+ } while (0)
30
+
31
+ /** 读远指针处的字节,指针事先放好。 */
32
+ unsigned char sbi_far_read_byte(void);
33
+
34
+ /** 把 value 写到远指针处,指针事先放好。 */
35
+ void __fastcall__ sbi_far_write_byte(unsigned char value);
36
+
37
+ /** 把页组 $0642、窗口地址 $0C/$0D 起的 $064F 个字节复制到 $0700 缓冲。 */
38
+ void sbi_far_copy_in(void);
39
+
40
+ /** 把 $0700 缓冲里的 $064F 个字节复制到页组 $0642、窗口地址 $0C/$0D 起的位置。 */
41
+ void sbi_far_copy_out(void);
42
+
43
+ /** 关中断,返回原来的状态寄存器。 */
44
+ unsigned char sbi_interrupts_off(void);
45
+
46
+ /** 恢复 sbi_interrupts_off 返回的状态寄存器。 */
47
+ void __fastcall__ sbi_interrupts_restore(unsigned char status);
48
+
49
+ /** 运行 PATH_BUFFER 里的程序,运行前后保存、恢复 C 运行库的零页;返回 DOS 出错码。 */
50
+ unsigned char sbi_exec_run(void);
51
+
52
+ /** 一个句柄在句柄表里占的字节数。 */
53
+ #define SBI_HANDLE_SIZE 0x2C
54
+
55
+ /** 把 24 位的值写进 3 个相邻的单元(低字节在前)。 */
56
+ #define SBI_SET24(address, value) \
57
+ do { \
58
+ SB_BYTE_AT(address) = (unsigned char)(value); \
59
+ SB_BYTE_AT((address) + 1) = (unsigned char)((value) >> 8); \
60
+ SB_BYTE_AT((address) + 2) = (unsigned char)((value) >> 16); \
61
+ } while (0)
62
+
63
+ /** 读 16 位的值(低字节在前)。 */
64
+ #define SBI_GET16(address) (SB_BYTE_AT(address) | ((unsigned int)SB_BYTE_AT((address) + 1) << 8))
65
+
66
+ /** 目录遍历的状态:当前扇区号、扇区内下一项的序号、是否已结束。 */
67
+ extern unsigned int sbi_dir_lba;
68
+ extern unsigned char sbi_dir_index;
69
+ extern unsigned char sbi_dir_ended;
70
+
71
+ /** 读 lba 号扇区到 DISK_BUFFER,返回 DOS 出错码。 */
72
+ unsigned char sbi_load_sector(unsigned int lba);
73
+
74
+ /** 调用系统服务,返回调用后的 DOS 出错码。 */
75
+ unsigned char sbi_dos_call(unsigned char function, unsigned char sub);
76
+
77
+ /** 把路径复制到 PATH_BUFFER,最长 28 个字符;过长时返回 SB_ERR_BAD_NAME,否则返回 0。 */
78
+ unsigned char sbi_set_path(const char *path);
79
+
80
+ /** 选定当前句柄;句柄号超出 0-3 时返回 SB_ERR_BAD_PARAMETER,否则返回 0。 */
81
+ unsigned char sbi_select_handle(unsigned char handle);
82
+
83
+ /** 把日期写成 FAT 格式放进 FILE_DATE;年份早于 1980 时返回 SB_ERR_BAD_PARAMETER,否则返回 0。 */
84
+ unsigned char sbi_date_to_fat(const sb_date_t *date);
85
+
86
+ /** 把 FILE_DATE 里的 FAT 日期取成年月日。 */
87
+ void sbi_date_from_fat(sb_date_t *date);
88
+
89
+ /** 把时间写成 FAT 格式放进 FILE_TIME;秒数取一半。 */
90
+ void sbi_time_to_fat(const sb_time_t *time);
91
+
92
+ /** 把 FILE_TIME 里的 FAT 时间取成时分秒。 */
93
+ void sbi_time_from_fat(sb_time_t *time);
94
+
95
+ /** 调用磁盘服务(功能 $80),返回软驱状态码 DISK_STATUS。 */
96
+ unsigned char sbi_disk_call(unsigned char sub);
97
+
98
+ /** 设置磁盘服务的起始面、磁道、扇区。 */
99
+ void sbi_disk_set_position(unsigned char head, unsigned char track, unsigned char sector);
100
+
101
+ /** 设置成批读写的全部参数并调用磁盘服务,返回软驱状态码。 */
102
+ unsigned char sbi_disk_batch(unsigned char sub, unsigned char head, unsigned char track, unsigned char sector,
103
+ unsigned char page, unsigned char page_sector, unsigned int count, unsigned char mode);
104
+
105
+ /** 把 count 个字节从 source 写到固定地址 address 起。 */
106
+ void sbi_poke(unsigned int address, const unsigned char *source, unsigned char count);
107
+
108
+ /** 把固定地址 address 起的 count 个字节读到 dest。 */
109
+ void sbi_peek(unsigned char *dest, unsigned int address, unsigned char count);
110
+
111
+ #endif
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-effect-from.c
4
+ * 说明:sb_sound_effect_from 的实现:播放音效曲子。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 $0B:曲目号 $0653 写 $FF,表示直接播放页组与窗口地址指向的曲子。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_effect_from(unsigned char group, unsigned int address)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(address);
17
+ SB_BYTE_AT(SB_PARAM_0653) = 0xFF;
18
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_EFFECT);
19
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-play-from.c
4
+ * 说明:sb_sound_play_from 的实现:播放页组里的曲子。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 0:页组写 $0642,窗口地址写 $0C/$0D。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_play_from(unsigned char group, unsigned int address)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(address);
17
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_PLAY);
18
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-play-wav-from.c
4
+ * 说明:sb_sound_play_wav_from 的实现:播放页组里的 WAV。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 $0C。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_play_wav_from(unsigned char group, unsigned int address)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(address);
17
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_WAV);
18
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-play-wav.c
4
+ * 说明:sb_sound_play_wav 的实现:播放程序窗口里的 WAV。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:页组取程序的起始页。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_play_wav(const void *wav)
14
+ {
15
+ sb_sound_play_wav_from(SB_BYTE_AT(SB_PROGRAM_START_PAGE), (unsigned int)wav);
16
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-repeat-wav-from.c
4
+ * 说明:sb_sound_repeat_wav_from 的实现:重复播放 WAV。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 $0D:重复次数写 $0652。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_repeat_wav_from(unsigned char group, unsigned int address, unsigned char times)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(address);
17
+ SB_BYTE_AT(SB_PARAM_0652) = times;
18
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_WAV_LOOP);
19
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-status.c
4
+ * 说明:sb_sound_status 的实现:取播放状态。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 3:结果取到 $0653。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_sound_status(void)
14
+ {
15
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_STATUS);
16
+ return SB_BYTE_AT(SB_PARAM_0653);
17
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-stop.c
4
+ * 说明:sb_sound_stop 的实现:停止播放。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 2。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_stop(void)
14
+ {
15
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_STOP);
16
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-tempo.c
4
+ * 说明:sb_sound_tempo 的实现:调整拍速。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 5:把 $0653 加到 $03D4,同步写进 $03D5。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_tempo(unsigned char delta)
14
+ {
15
+ SB_BYTE_AT(SB_PARAM_0653) = delta;
16
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_TEMPO);
17
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-sound-transpose.c
4
+ * 说明:sb_sound_transpose 的实现:调整声道移调。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $65 子功能 4:把 $0653 加到 $0447-$044A。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_sound_transpose(unsigned char delta)
14
+ {
15
+ SB_BYTE_AT(SB_PARAM_0653) = delta;
16
+ sb_syscall(SB_FN_SOUND, SB_SUB_SOUND_TRANSPOSE);
17
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-speech-off.c
4
+ * 说明:sb_speech_off 的实现:关闭语音。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $74 子功能 0。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_speech_off(void)
14
+ {
15
+ sb_syscall(SB_FN_SPEECH_FLAGS, 0);
16
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-speech-send-entry-from.c
4
+ * 说明:sb_speech_send_entry_from 的实现:按序号发送词条。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $75 子功能 1:序号高字节写 $064A、低字节写 $064B。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_speech_send_entry_from(unsigned char group, unsigned int table, unsigned int index)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(table);
17
+ SB_BYTE_AT(SB_PARAM_064A) = (unsigned char)(index >> 8);
18
+ SB_BYTE_AT(SB_PARAM_064B) = (unsigned char)index;
19
+ SB_BYTE_AT(SB_SPEECH_FLAGS) &= 0xFE;
20
+ sb_syscall(SB_FN_SPEECH_SEND, 1);
21
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-speech-send-from.c
4
+ * 说明:sb_speech_send_from 的实现:同步发送语音数据。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $75 子功能 0:语音控制标志 $032B 的位 0 为 0 时同步发送。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_speech_send_from(unsigned char group, unsigned int address)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(address);
17
+ SB_BYTE_AT(SB_SPEECH_FLAGS) &= 0xFE;
18
+ sb_syscall(SB_FN_SPEECH_SEND, 0);
19
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-speech-send.c
4
+ * 说明:sb_speech_send 的实现:同步发送程序窗口里的语音数据。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:页组取程序的起始页。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_speech_send(const void *data)
14
+ {
15
+ sb_speech_send_from(SB_BYTE_AT(SB_PROGRAM_START_PAGE), (unsigned int)data);
16
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-call-banked.c
4
+ * 说明:sb_call_banked 的实现:映射页组后调用其中的例程。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $25,页组写 $0642,入口地址写 $0C/$0D;入口返回后窗口恢复成调用前的样子。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_call_banked(unsigned char group, unsigned int entry)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SB_BYTE_AT(SB_PROG_ENTRY_LO) = (unsigned char)entry;
17
+ SB_BYTE_AT(SB_PROG_ENTRY_HI) = (unsigned char)(entry >> 8);
18
+ sb_syscall(SB_FN_CALL_BANKED, 0);
19
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-context-restore.c
4
+ * 说明:sb_context_restore 的实现:弹出上下文栈顶的恢复点并跳转过去。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $1D;栈里有恢复点时不会返回,栈空时直接返回。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_context_restore(void)
14
+ {
15
+ sb_syscall(SB_FN_RESTORE_CONTEXT, 0);
16
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-context-save.c
4
+ * 说明:sb_context_save 的实现:把一个恢复点压入系统的上下文栈。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $1C,页组写 $0642、入口地址写 $0C/$0D,栈指针作为子功能号传入。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_context_save(unsigned char group, unsigned int entry, unsigned char stack_pointer)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SB_BYTE_AT(SB_PROG_ENTRY_LO) = (unsigned char)entry;
17
+ SB_BYTE_AT(SB_PROG_ENTRY_HI) = (unsigned char)(entry >> 8);
18
+ sb_syscall(SB_FN_SAVE_CONTEXT, stack_pointer);
19
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-display-off.c
4
+ * 说明:sb_display_off 的实现:关闭 NMI 与背景、精灵显示。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $19。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_display_off(void)
14
+ {
15
+ sb_syscall(SB_FN_DISPLAY_OFF, 0);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-display-on.c
4
+ * 说明:sb_display_on 的实现:等到垂直消隐后打开 NMI 并恢复显示。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $1A。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_display_on(void)
14
+ {
15
+ sb_syscall(SB_FN_DISPLAY_ON, 0);
16
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-display-option.c
4
+ * 说明:sb_display_option 的实现:把值按位并入显示相关的硬件寄存器。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $10,值写在 $0652;选项超出 0-7 时系统把状态 $0640 置 $FF。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ unsigned char sb_display_option(unsigned char option, unsigned char value)
14
+ {
15
+ SB_BYTE_AT(SB_PARAM_0652) = value;
16
+ sb_syscall(SB_FN_VIDEO_OPTION, option);
17
+ return SB_BYTE_AT(SB_SYS_STATUS);
18
+ }
@@ -0,0 +1,22 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-exec.c
4
+ * 说明:sb_exec 的实现:运行另一个程序,运行完返回。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $7F 子功能 0,路径放 PATH_BUFFER;系统按文件大小分配页、读入、检查文件头魔数,运行完释放页;
9
+ * 子程序会改写 C 运行库的零页,由 sbi_exec_run 在运行前后保存、恢复。
10
+ * ------------------------------------------------------------------------
11
+ */
12
+ #include "../sb-internal.h"
13
+
14
+ unsigned char sb_exec(const char *path)
15
+ {
16
+ unsigned char error = sbi_set_path(path);
17
+
18
+ if (error != 0) {
19
+ return error;
20
+ }
21
+ return sbi_exec_run();
22
+ }