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,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-irq-enable.c
4
+ * 说明:sb_irq_enable 的实现:允许一个中断源。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $13 子功能 $80-$86;中断源超出 0-6 时不调用。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_irq_enable(unsigned char source)
14
+ {
15
+ if (source > 6) {
16
+ return;
17
+ }
18
+ sb_syscall(SB_FN_IRQ_MASK, (unsigned char)(0x80 | source));
19
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-irq-hook-reset.c
4
+ * 说明:sb_irq_hook_reset 的实现:把一个中断钩子恢复成空钩子。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $13 子功能 $88,钩子号写在 $0652;钩子号超出 0-5 时不调用。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_irq_hook_reset(unsigned char hook)
14
+ {
15
+ if (hook > 5) {
16
+ return;
17
+ }
18
+ SB_BYTE_AT(SB_PARAM_0652) = hook;
19
+ sb_syscall(SB_FN_IRQ_MASK, 0x88);
20
+ }
@@ -0,0 +1,39 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-irq-hook-set.c
4
+ * 说明:sb_irq_hook_set 的实现:登记一个中断钩子的页组与入口。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:钩子号 0 定时器、1 中断 3、2 中断 1、3 中断 4、4 鼠标、5 键盘(与 sb_irq_hook_reset 一致),6 中断 2;写入时关中断。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ /** 各钩子的地址(零页,低字节在前) */
14
+ static const unsigned char vectors[7] = {
15
+ SB_TIMER_HOOK_VEC_LO, SB_IRQ3_HOOK_VEC_LO, SB_IRQ1_HOOK_VEC_LO, SB_IRQ4_HOOK_VEC_LO,
16
+ SB_MOUSE_HOOK_VEC_LO, SB_KBD_HOOK_VEC_LO, SB_IRQ2_HOOK_VEC_LO
17
+ };
18
+
19
+ /** 各钩子的页组单元 */
20
+ static const unsigned int pages[7] = {
21
+ SB_TIMER_HOOK_PAGE, SB_IRQ3_HOOK_PAGE, SB_IRQ1_HOOK_PAGE, SB_IRQ4_HOOK_PAGE,
22
+ SB_MOUSE_HOOK_PAGE, SB_KBD_HOOK_PAGE, SB_IRQ2_HOOK_PAGE
23
+ };
24
+
25
+ void sb_irq_hook_set(unsigned char hook, unsigned char group, unsigned int entry)
26
+ {
27
+ unsigned char vector;
28
+ unsigned char saved;
29
+
30
+ if (hook > 6) {
31
+ return;
32
+ }
33
+ vector = vectors[hook];
34
+ saved = sbi_interrupts_off();
35
+ SB_BYTE_AT(pages[hook]) = group;
36
+ SB_BYTE_AT(vector) = (unsigned char)entry;
37
+ SB_BYTE_AT(vector + 1) = (unsigned char)(entry >> 8);
38
+ sbi_interrupts_restore(saved);
39
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-irq-mask.c
4
+ * 说明:sb_irq_mask 的实现:屏蔽一个中断源。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $13 子功能 $00-$06;中断源超出 0-6 时不调用。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_irq_mask(unsigned char source)
14
+ {
15
+ if (source > 6) {
16
+ return;
17
+ }
18
+ sb_syscall(SB_FN_IRQ_MASK, source);
19
+ }
@@ -0,0 +1,25 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sb-jump-banked.s
3
+ ; 说明:sb_jump_banked 的实现:映射页组后跳转到其中的例程。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:功能 $26 会丢弃系统调用的返回地址与保存的寄存器,所以不会回到本例程;入口例程的 RTS 直接返回到本函数调用者的位置。
8
+ ; C 的参数由被调用者弹出,所以先在这里弹出页组,再发起系统调用,否则软件栈会少弹 3 个字节。
9
+ ; ------------------------------------------------------------------------
10
+ .include "sb2000.inc"
11
+ .export _sb_jump_banked
12
+ .import popa
13
+
14
+ .code
15
+
16
+ ; void __fastcall__ sb_jump_banked(unsigned char group, unsigned int entry)
17
+ _sb_jump_banked:
18
+ sta PROG_ENTRY_LO
19
+ stx PROG_ENTRY_HI
20
+ jsr popa
21
+ sta SYS_GROUP
22
+ lda #FN_JUMP_BANKED
23
+ sta SYS_FUNCTION
24
+ jsr SYSCALL
25
+ rts
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-nmi-disable.c
4
+ * 说明:sb_nmi_disable 的实现:关闭 NMI。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $12 子功能 $00。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_nmi_disable(void)
14
+ {
15
+ sb_syscall(SB_FN_PPU_CONTROL, 0x00);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-nmi-enable.c
4
+ * 说明:sb_nmi_enable 的实现:打开 NMI。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $12 子功能 $80。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_nmi_enable(void)
14
+ {
15
+ sb_syscall(SB_FN_PPU_CONTROL, 0x80);
16
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-nmi-hook-reset.c
4
+ * 说明:sb_nmi_hook_reset 的实现:把一个 NMI 钩子恢复成空钩子。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $12 子功能 $88,$0652 为 0 复位钩子 5,非 0 复位钩子 4;钩子号不是 4、5 时不调用。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_nmi_hook_reset(unsigned char hook)
14
+ {
15
+ if (hook != 4 && hook != 5) {
16
+ return;
17
+ }
18
+ SB_BYTE_AT(SB_PARAM_0652) = (hook == 4);
19
+ sb_syscall(SB_FN_PPU_CONTROL, 0x88);
20
+ }
@@ -0,0 +1,33 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-nmi-hook-set.c
4
+ * 说明:sb_nmi_hook_set 的实现:登记一个 NMI 钩子的页组与入口。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:钩子的地址在零页,页组在内核 RAM;写入时关中断,避免被钩子调用打断而读到只写了一半的地址。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_nmi_hook_set(unsigned char hook, unsigned char group, unsigned int entry)
14
+ {
15
+ unsigned char vector;
16
+ unsigned int page;
17
+ unsigned char saved;
18
+
19
+ if (hook == 5) {
20
+ vector = SB_NMI_HOOK5_VEC_LO;
21
+ page = SB_NMI_HOOK5_PAGE;
22
+ } else if (hook == 4) {
23
+ vector = SB_NMI_HOOK4_VEC_LO;
24
+ page = SB_NMI_HOOK4_PAGE;
25
+ } else {
26
+ return;
27
+ }
28
+ saved = sbi_interrupts_off();
29
+ SB_BYTE_AT(page) = group;
30
+ SB_BYTE_AT(vector) = (unsigned char)entry;
31
+ SB_BYTE_AT(vector + 1) = (unsigned char)(entry >> 8);
32
+ sbi_interrupts_restore(saved);
33
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-nmi-service.c
4
+ * 说明:sb_nmi_service 的实现:打开或关闭 NMI 里的一项服务。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $12 子功能 $81-$86(打开)与 $01-$06(关闭);服务号超出 1-6 时不调用。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_nmi_service(unsigned char service, unsigned char enable)
14
+ {
15
+ if (service < 1 || service > 6) {
16
+ return;
17
+ }
18
+ sb_syscall(SB_FN_PPU_CONTROL, enable ? (unsigned char)(0x80 | service) : service);
19
+ }
@@ -0,0 +1,18 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sb-stack-pointer.s
3
+ ; 说明:sb_stack_pointer 的实现:取硬件栈指针。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:返回的是本函数被调用之后的栈指针,即调用者的栈指针减 2(JSR 压入的返回地址)。
8
+ ; ------------------------------------------------------------------------
9
+ .export _sb_stack_pointer
10
+
11
+ .code
12
+
13
+ ; unsigned char sb_stack_pointer(void)
14
+ _sb_stack_pointer:
15
+ tsx
16
+ txa
17
+ ldx #$00
18
+ rts
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-system-init.c
4
+ * 说明:sb_system_init 的实现:系统硬件与状态初始化。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $18。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ void sb_system_init(void)
14
+ {
15
+ sb_syscall(SB_FN_SYSTEM_INIT, 0);
16
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-system-state.c
4
+ * 说明:sb_system_state 的实现:查询显示与系统状态。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $1E,结果在 $0652;查询号超出 0-12 时不调用,返回 0。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <sb2000.h>
12
+
13
+ unsigned char sb_system_state(unsigned char query)
14
+ {
15
+ if (query > 12) {
16
+ return 0;
17
+ }
18
+ sb_syscall(SB_FN_QUERY_STATE, query);
19
+ return SB_BYTE_AT(SB_PARAM_0652);
20
+ }
@@ -0,0 +1,19 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sb-wait-frames.s
3
+ ; 说明:sb_wait_frames 的实现:等待指定数量的垂直消隐周期(帧)。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:功能 $1B 的帧数在 X 寄存器里,C 调用约定的参数在 A,所以用汇编转一下。帧数 0 按 256 计。
8
+ ; ------------------------------------------------------------------------
9
+ .include "sb2000.inc"
10
+ .export _sb_wait_frames
11
+
12
+ .code
13
+
14
+ ; void sb_wait_frames(unsigned char frames)
15
+ _sb_wait_frames:
16
+ tax
17
+ lda #FN_WAIT_FRAMES
18
+ sta SYS_FUNCTION
19
+ jmp SYSCALL
@@ -0,0 +1,43 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-exec-run.s
3
+ ; 说明:库内部的汇编小例程:运行 PATH_BUFFER 里的程序,运行前后保存、恢复 C 运行库的零页。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:子程序的启动代码会重新设置 C 软件栈指针,并改写 C 运行库的零页($0060-$007F,见 link.cfg 的 ZP),
8
+ ; 不保存的话返回后调用者的软件栈就乱了;恢复只用绝对地址与 A、Y,不依赖软件栈。
9
+ ; 保存区放在调用者自己的 BSS 里,子程序装在别的页,不会改到它。
10
+ ; ------------------------------------------------------------------------
11
+ .export _sbi_exec_run
12
+
13
+ .include "sb2000.inc"
14
+
15
+ ZP_BASE = $60 ; 零页起点,与 link.cfg 的 __ZPSTART__ 一致
16
+ ZP_LAST = $1F ; 零页大小 $20 的最后一个偏移
17
+
18
+ .code
19
+
20
+ ; unsigned char sbi_exec_run(void):返回 DOS 出错码
21
+ _sbi_exec_run:
22
+ ldy #ZP_LAST
23
+ @save: lda ZP_BASE,y
24
+ sta zpsave,y
25
+ dey
26
+ bpl @save
27
+ lda #FN_CLOCK
28
+ sta SYS_FUNCTION
29
+ lda #SUB_CLOCK_EXEC
30
+ sta SYS_SUBFUNCTION
31
+ jsr SYSCALL
32
+ ldy #ZP_LAST
33
+ @back: lda zpsave,y
34
+ sta ZP_BASE,y
35
+ dey
36
+ bpl @back
37
+ lda DOS_ERROR
38
+ ldx #$00
39
+ rts
40
+
41
+ .bss
42
+
43
+ zpsave: .res ZP_LAST + 1
@@ -0,0 +1,19 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-interrupts-off.s
3
+ ; 说明:库内部的汇编小例程:关中断并返回原来的状态寄存器。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:与 sbi_interrupts_restore 成对使用,保护不能被中断打断的多字节写入。
8
+ ; ------------------------------------------------------------------------
9
+ .export _sbi_interrupts_off
10
+
11
+ .code
12
+
13
+ ; unsigned char sbi_interrupts_off(void)
14
+ _sbi_interrupts_off:
15
+ php
16
+ sei
17
+ pla
18
+ ldx #$00
19
+ rts
@@ -0,0 +1,17 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-interrupts-restore.s
3
+ ; 说明:库内部的汇编小例程:恢复 sbi_interrupts_off 返回的状态寄存器。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:状态寄存器的值由 C 调用约定放在 A。
8
+ ; ------------------------------------------------------------------------
9
+ .export _sbi_interrupts_restore
10
+
11
+ .code
12
+
13
+ ; void __fastcall__ sbi_interrupts_restore(unsigned char status)
14
+ _sbi_interrupts_restore:
15
+ pha
16
+ plp
17
+ rts
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-beep.c
4
+ * 说明:sb_beep 的实现:发一声提示音。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:调用运行库的 LIB_BEEP,用方波通道 2。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_beep(void)
14
+ {
15
+ sb_call_banked(0, SB_LIB_BEEP);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-cursor-column.c
4
+ * 说明:sb_cursor_column 的实现:取光标所在的列。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:读 CURSOR_COL。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_cursor_column(void)
14
+ {
15
+ return SB_BYTE_AT(SB_CURSOR_COL);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-cursor-left.c
4
+ * 说明:sb_cursor_left 的实现:光标左移一列。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:调用运行库的 LIB_CURSOR_LEFT。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_cursor_left(void)
14
+ {
15
+ sb_call_banked(0, SB_LIB_CURSOR_LEFT);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-cursor-right.c
4
+ * 说明:sb_cursor_right 的实现:光标右移一列。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:调用运行库的 LIB_CURSOR_RIGHT。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_cursor_right(void)
14
+ {
15
+ sb_call_banked(0, SB_LIB_CURSOR_RIGHT);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-cursor-row.c
4
+ * 说明:sb_cursor_row 的实现:取光标所在的显示行。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:读 CURSOR_ROW。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_cursor_row(void)
14
+ {
15
+ return SB_BYTE_AT(SB_CURSOR_ROW);
16
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-cursor-set-column.c
4
+ * 说明:sb_cursor_set_column 的实现:设置光标所在的列。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:列号超出 1-31 时不改。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_cursor_set_column(unsigned char column)
14
+ {
15
+ if (column >= 1 && column <= 31) {
16
+ SB_BYTE_AT(SB_CURSOR_COL) = column;
17
+ }
18
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-cursor-up.c
4
+ * 说明:sb_cursor_up 的实现:光标移到上一行的末尾。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:调用运行库的 LIB_CURSOR_UP。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_cursor_up(void)
14
+ {
15
+ sb_call_banked(0, SB_LIB_CURSOR_UP);
16
+ }
@@ -0,0 +1,22 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-print-hex.c
4
+ * 说明:sb_print_hex 的实现:在光标处显示一个字节的两位十六进制数。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:运行库自带的 LIB_PRINT_HEX 经系统调用传不进 A,所以自己转换成字符再显示。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_print_hex(unsigned char value)
14
+ {
15
+ static const char digits[] = "0123456789ABCDEF";
16
+ char text[3];
17
+
18
+ text[0] = digits[value >> 4];
19
+ text[1] = digits[value & 0x0F];
20
+ text[2] = 0;
21
+ sb_print(text);
22
+ }
@@ -0,0 +1,25 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-print-uint.c
4
+ * 说明:sb_print_uint 的实现:在光标处显示一个无符号十进制数。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:逐位取出再显示,不使用库里的格式化函数。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_print_uint(unsigned int value)
14
+ {
15
+ char text[6];
16
+ unsigned char index = 5;
17
+
18
+ text[5] = 0;
19
+ do {
20
+ --index;
21
+ text[index] = (char)('0' + value % 10);
22
+ value /= 10;
23
+ } while (value != 0);
24
+ sb_print(&text[index]);
25
+ }
@@ -0,0 +1,35 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-print.c
4
+ * 说明:sb_print 的实现:在光标处显示字符串并把光标移到字符串之后。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:运行库的 LIB_PRINT_STRING 不移动光标,这里按显示宽度(西文 1 格、GB2312 汉字 2 格)逐格右移光标,行满时由运行库换行。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_print(const char *s)
14
+ {
15
+ const unsigned char *p = (const unsigned char *)s;
16
+ unsigned char width = 0;
17
+
18
+ while (*p != 0) {
19
+ if (*p >= 0xA1 && p[1] != 0) {
20
+ width += 2;
21
+ p += 2;
22
+ } else {
23
+ width += 1;
24
+ p += 1;
25
+ }
26
+ }
27
+ SB_BYTE_AT(SB_STR_PTR_LO) = (unsigned char)(unsigned int)s;
28
+ SB_BYTE_AT(SB_STR_PTR_HI) = (unsigned char)((unsigned int)s >> 8);
29
+ SB_BYTE_AT(SB_LIB_GROUP) = SB_BYTE_AT(SB_PROGRAM_START_PAGE);
30
+ sb_call_banked(0, SB_LIB_PRINT_STRING);
31
+ while (width != 0) {
32
+ sb_call_banked(0, SB_LIB_CURSOR_RIGHT);
33
+ --width;
34
+ }
35
+ }
@@ -0,0 +1,26 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-putc.c
4
+ * 说明:sb_putc 的实现:在光标处显示一个字符并把光标右移一格。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:换行符 \n 换行,回车符 \r 回到行首;其他字符原样显示。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_putc(char c)
14
+ {
15
+ char text[2];
16
+
17
+ if (c == '\n') {
18
+ sb_newline();
19
+ } else if (c == '\r') {
20
+ SB_BYTE_AT(SB_CURSOR_COL) = 1;
21
+ } else {
22
+ text[0] = c;
23
+ text[1] = 0;
24
+ sb_print(text);
25
+ }
26
+ }
@@ -12,9 +12,6 @@
12
12
  .export _sb_puts, _sb_newline, _sb_getkey, _sb_syscall
13
13
  .import popa
14
14
 
15
- ; 程序文件头偏移 5:DOS 写入的起始页号
16
- PROGRAM_START_PAGE = $8005
17
-
18
15
  .code
19
16
 
20
17
  ; void sb_puts(const char *s):从行首显示字符串并换行
@@ -16,6 +16,20 @@
16
16
  "header": "4C????AA55",
17
17
  "maxSize": 16384
18
18
  },
19
+ "options": {
20
+ "banks": {
21
+ "type": "number",
22
+ "default": 0
23
+ }
24
+ },
25
+ "banked": {
26
+ "option": "banks",
27
+ "linkConfig": "link-banked.cfg",
28
+ "generatedFrom": 2,
29
+ "maxBanks": 113,
30
+ "memory": "BANK{n}: file = %O, start = $A000, size = $1000, fill = yes;",
31
+ "segment": "BANK{n}: load = BANK{n}, type = ro, optional = yes;"
32
+ },
19
33
  "extension": ".EXE",
20
34
  "nameRule": "dos-8.3",
21
35
  "disk": {