fcdev 0.0.0-stage → 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 (294) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +82 -2
  3. package/bin/fcdev.mjs +17 -0
  4. package/package.json +38 -4
  5. package/src/api/header-parser.mjs +78 -0
  6. package/src/api/index.mjs +128 -0
  7. package/src/build/bank-link-config.mjs +74 -0
  8. package/src/build/build-plan.mjs +92 -0
  9. package/src/build/dependency-file.mjs +24 -0
  10. package/src/build/disk-builder.mjs +36 -0
  11. package/src/build/index.mjs +32 -0
  12. package/src/build/program-builder.mjs +212 -0
  13. package/src/build/source-collector.mjs +54 -0
  14. package/src/build/tool-arguments.mjs +83 -0
  15. package/src/cli/args-parser.mjs +84 -0
  16. package/src/cli/commands/api-command.mjs +62 -0
  17. package/src/cli/commands/build-command.mjs +34 -0
  18. package/src/cli/commands/debug-command.mjs +70 -0
  19. package/src/cli/commands/disasm-command.mjs +65 -0
  20. package/src/cli/commands/disk-command.mjs +34 -0
  21. package/src/cli/commands/info-command.mjs +33 -0
  22. package/src/cli/commands/project-info.mjs +57 -0
  23. package/src/cli/commands/run-command.mjs +68 -0
  24. package/src/cli/commands/sync-command.mjs +85 -0
  25. package/src/cli/index.mjs +103 -0
  26. package/src/config/config-loader.mjs +132 -0
  27. package/src/config/index.mjs +9 -0
  28. package/src/disasm/analysis.mjs +97 -0
  29. package/src/disasm/cdl.mjs +35 -0
  30. package/src/disasm/disassembler.mjs +114 -0
  31. package/src/disasm/index.mjs +16 -0
  32. package/src/disasm/info-writer.mjs +72 -0
  33. package/src/disasm/loaders.mjs +69 -0
  34. package/src/disasm/opcode-table.mjs +268 -0
  35. package/src/disasm/roundtrip.mjs +69 -0
  36. package/src/disasm/symbols.mjs +30 -0
  37. package/src/disasm/trace.mjs +25 -0
  38. package/src/emulator/debug-client.mjs +125 -0
  39. package/src/emulator/emulator-launcher.mjs +80 -0
  40. package/src/emulator/emulator-locator.mjs +62 -0
  41. package/src/emulator/index.mjs +11 -0
  42. package/src/packagers/fat-floppy.mjs +22 -0
  43. package/src/packagers/fat12-image.mjs +245 -0
  44. package/src/packagers/flat-binary.mjs +53 -0
  45. package/src/packagers/index.mjs +54 -0
  46. package/src/packagers/ines.mjs +38 -0
  47. package/src/shared/errors.mjs +25 -0
  48. package/src/shared/fs-utils.mjs +66 -0
  49. package/src/shared/index.mjs +11 -0
  50. package/src/shared/process.mjs +50 -0
  51. package/src/targets/index.mjs +17 -0
  52. package/src/targets/name-rules.mjs +33 -0
  53. package/src/targets/target-registry.mjs +225 -0
  54. package/src/toolchain/index.mjs +16 -0
  55. package/src/toolchain/toolchain-locator.mjs +104 -0
  56. package/targets/nes/asminc/fcnes.inc +16 -0
  57. package/targets/nes/chr/ascii-8x8.chr +0 -0
  58. package/targets/nes/chr/font8x8_basic.h +152 -0
  59. package/targets/nes/include/fcnes.h +45 -0
  60. package/targets/nes/lib/fcnes.lib +0 -0
  61. package/targets/nes/lib/nes-font.o +0 -0
  62. package/targets/nes/lib-build.json +9 -0
  63. package/targets/nes/src/fcnes.s +91 -0
  64. package/targets/nes/src/nes-font.s +12 -0
  65. package/targets/nes/target.json +27 -0
  66. package/targets/sb2000/api-reference.md +3295 -0
  67. package/targets/sb2000/api-unwrapped.json +36 -0
  68. package/targets/sb2000/asminc/sb2000.inc +418 -0
  69. package/targets/sb2000/include/sb2000-bank.h +74 -0
  70. package/targets/sb2000/include/sb2000-clock.h +68 -0
  71. package/targets/sb2000/include/sb2000-disk.h +141 -0
  72. package/targets/sb2000/include/sb2000-display.h +352 -0
  73. package/targets/sb2000/include/sb2000-file.h +273 -0
  74. package/targets/sb2000/include/sb2000-ime.h +158 -0
  75. package/targets/sb2000/include/sb2000-input.h +192 -0
  76. package/targets/sb2000/include/sb2000-math.h +228 -0
  77. package/targets/sb2000/include/sb2000-memory.h +115 -0
  78. package/targets/sb2000/include/sb2000-printer.h +116 -0
  79. package/targets/sb2000/include/sb2000-sound.h +134 -0
  80. package/targets/sb2000/include/sb2000-symbols.h +776 -0
  81. package/targets/sb2000/include/sb2000-system.h +219 -0
  82. package/targets/sb2000/include/sb2000-text.h +99 -0
  83. package/targets/sb2000/include/sb2000.h +45 -0
  84. package/targets/sb2000/lib/crt0.o +0 -0
  85. package/targets/sb2000/lib/sb2000.lib +0 -0
  86. package/targets/sb2000/lib-build.json +8 -0
  87. package/targets/sb2000/link-banked.cfg +42 -0
  88. package/targets/sb2000/link.cfg +35 -0
  89. package/targets/sb2000/src/crt0.s +122 -0
  90. package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
  91. package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
  92. package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
  93. package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
  94. package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
  95. package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
  96. package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
  97. package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
  98. package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
  99. package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
  100. package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
  101. package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
  102. package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
  103. package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
  104. package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
  105. package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
  106. package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
  107. package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
  108. package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
  109. package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
  110. package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
  111. package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
  112. package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
  113. package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
  114. package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
  115. package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
  116. package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
  117. package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
  118. package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
  119. package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
  120. package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
  121. package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
  122. package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
  123. package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
  124. package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
  125. package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
  126. package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
  127. package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
  128. package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
  129. package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
  130. package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
  131. package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
  132. package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
  133. package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
  134. package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
  135. package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
  136. package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
  137. package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
  138. package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
  139. package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
  140. package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
  141. package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
  142. package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
  143. package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
  144. package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
  145. package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
  146. package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
  147. package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
  148. package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
  149. package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
  150. package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
  151. package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
  152. package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
  153. package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
  154. package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
  155. package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
  156. package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
  157. package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
  158. package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
  159. package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
  160. package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
  161. package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
  162. package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
  163. package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
  164. package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
  165. package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
  166. package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
  167. package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
  168. package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
  169. package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
  170. package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
  171. package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
  172. package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
  173. package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
  174. package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
  175. package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
  176. package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
  177. package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
  178. package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
  179. package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
  180. package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
  181. package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
  182. package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
  183. package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
  184. package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
  185. package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
  186. package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
  187. package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
  188. package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
  189. package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
  190. package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
  191. package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
  192. package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
  193. package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
  194. package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
  195. package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
  196. package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
  197. package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
  198. package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
  199. package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
  200. package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
  201. package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
  202. package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
  203. package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
  204. package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
  205. package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
  206. package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
  207. package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
  208. package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
  209. package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
  210. package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
  211. package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
  212. package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
  213. package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
  214. package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
  215. package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
  216. package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
  217. package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
  218. package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
  219. package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
  220. package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
  221. package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
  222. package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
  223. package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
  224. package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
  225. package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
  226. package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
  227. package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
  228. package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
  229. package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
  230. package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
  231. package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
  232. package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
  233. package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
  234. package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
  235. package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
  236. package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
  237. package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
  238. package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
  239. package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
  240. package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
  241. package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
  242. package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
  243. package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
  244. package/targets/sb2000/src/lib/sb-internal.h +111 -0
  245. package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
  246. package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
  247. package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
  248. package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
  249. package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
  250. package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
  251. package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
  252. package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
  253. package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
  254. package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
  255. package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
  256. package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
  257. package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
  258. package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
  259. package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
  260. package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
  261. package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
  262. package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
  263. package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
  264. package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
  265. package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
  266. package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
  267. package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
  268. package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
  269. package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
  270. package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
  271. package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
  272. package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
  273. package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
  274. package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
  275. package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
  276. package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
  277. package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
  278. package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
  279. package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
  280. package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
  281. package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
  282. package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
  283. package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
  284. package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
  285. package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
  286. package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
  287. package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
  288. package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
  289. package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
  290. package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
  291. package/targets/sb2000/src/lib/text/sb-print.c +35 -0
  292. package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
  293. package/targets/sb2000/src/sb2000.s +64 -0
  294. package/targets/sb2000/target.json +42 -0
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-float-to-text.c
4
+ * 说明:sb_float_to_text 的实现:浮点数转十进制文字。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4E 子功能 0:浮点数放 $06A8 起,文字 13 个字符在 $069A 起。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_float_to_text(const sb_float_t *value, char *text)
14
+ {
15
+ sbi_poke(SB_ARG_06A8, (const unsigned char *)value, 7);
16
+ sb_syscall(SB_FN_DECIMAL_FORMAT, 0);
17
+ sbi_peek((unsigned char *)text, SB_ARG_069A, 13);
18
+ text[13] = 0;
19
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-int24-add.c
4
+ * 说明:sb_int24_add 的实现:3 字节整数加法。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $54 子功能 0:操作数放 $069A 起与 $069E 起(符号字节加 3 个数值字节),符号在 $06A2,结果在 $06A4-$06A6,进位在 $06A3。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_int24_add(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *result)
14
+ {
15
+ sbi_poke(SB_ARG_069A, (const unsigned char *)a, 4);
16
+ sbi_poke(SB_ARG_069E, (const unsigned char *)b, 4);
17
+ sb_syscall(SB_FN_INT24, 0);
18
+ result->sign = SB_BYTE_AT(SB_ARG_069A + 8);
19
+ sbi_peek(result->value, SB_ARG_069A + 10, 3);
20
+ return SB_BYTE_AT(SB_ARG_069A + 9) != 0;
21
+ }
@@ -0,0 +1,26 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-int24-div.c
4
+ * 说明:sb_int24_div 的实现:3 字节整数除法。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $54 子功能 3:商符号在 $06A3、商在 $06A4-$06A6、余数在 $06A7-$06A9;除数为 0 时 $06A2 为 $FF。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_int24_div(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *quotient, sb_int24_t *remainder)
14
+ {
15
+ sbi_poke(SB_ARG_069A, (const unsigned char *)a, 4);
16
+ sbi_poke(SB_ARG_069E, (const unsigned char *)b, 4);
17
+ sb_syscall(SB_FN_INT24, 3);
18
+ if (SB_BYTE_AT(SB_ARG_069A + 8) == 0xFF) {
19
+ return 1;
20
+ }
21
+ quotient->sign = SB_BYTE_AT(SB_ARG_069A + 9);
22
+ sbi_peek(quotient->value, SB_ARG_069A + 10, 3);
23
+ remainder->sign = SB_BYTE_AT(SB_ARG_069A + 9);
24
+ sbi_peek(remainder->value, SB_ARG_069A + 13, 3);
25
+ return 0;
26
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-int24-mul.c
4
+ * 说明:sb_int24_mul 的实现:3 字节整数乘法。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $54 子功能 2:符号在 $06A2,48 位乘积在 $06A3-$06A8。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_int24_mul(const sb_int24_t *a, const sb_int24_t *b, unsigned char *sign, unsigned char *product)
14
+ {
15
+ sbi_poke(SB_ARG_069A, (const unsigned char *)a, 4);
16
+ sbi_poke(SB_ARG_069E, (const unsigned char *)b, 4);
17
+ sb_syscall(SB_FN_INT24, 2);
18
+ *sign = SB_BYTE_AT(SB_ARG_069A + 8);
19
+ sbi_peek(product, SB_ARG_069A + 9, 6);
20
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-int24-sub.c
4
+ * 说明:sb_int24_sub 的实现:3 字节整数减法。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $54 子功能 1:操作数放 $069A 起与 $069E 起(符号字节加 3 个数值字节),符号在 $06A2,结果在 $06A4-$06A6,进位在 $06A3。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_int24_sub(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *result)
14
+ {
15
+ sbi_poke(SB_ARG_069A, (const unsigned char *)a, 4);
16
+ sbi_poke(SB_ARG_069E, (const unsigned char *)b, 4);
17
+ sb_syscall(SB_FN_INT24, 1);
18
+ result->sign = SB_BYTE_AT(SB_ARG_069A + 8);
19
+ sbi_peek(result->value, SB_ARG_069A + 10, 3);
20
+ return SB_BYTE_AT(SB_ARG_069A + 9) != 0;
21
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-int40-from-text.c
4
+ * 说明:sb_int40_from_text 的实现:数字文字转 40 位整数。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4D 子功能 1:$069A 低 4 位是位数,$069B 起是数字,结果 5 个字节在 $06AA-$06AE。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_int40_from_text(const char *digits, unsigned char count, unsigned char *value)
14
+ {
15
+ SB_BYTE_AT(SB_ARG_069A) = count & 0x0F;
16
+ sbi_poke(SB_ARG_069A + 1, (const unsigned char *)digits, count);
17
+ sb_syscall(SB_FN_DECIMAL_PARSE, 1);
18
+ sbi_peek(value, SB_ARG_06AA, 5);
19
+ }
@@ -0,0 +1,27 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-int40-to-text.c
4
+ * 说明:sb_int40_to_text 的实现:40 位整数转数字文字。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4E 子功能 1:整数放 $06AF-$06B3,$069A 是有效位数,$069B-$06A7 是 13 个数字;调用前把 $06A8 清 0,使数按非负处理。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_int40_to_text(const unsigned char *value, char *digits, unsigned char *length)
14
+ {
15
+ unsigned char status;
16
+
17
+ SB_BYTE_AT(SB_ARG_06A8) = 0;
18
+ sbi_poke(SB_ARG_06AF, value, 5);
19
+ sb_syscall(SB_FN_DECIMAL_FORMAT, 1);
20
+ status = SB_BYTE_AT(SB_SYS_STATUS);
21
+ if (status == 0) {
22
+ *length = SB_BYTE_AT(SB_ARG_069A);
23
+ sbi_peek((unsigned char *)digits, SB_ARG_069A + 1, 13);
24
+ digits[13] = 0;
25
+ }
26
+ return status;
27
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-line-step.c
4
+ * 说明:sb_line_step 的实现:直线步进。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $53:零页 $08/$09 指向 18 字节参数块,偏移 4 是步数,落点写回偏移 0、1。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_line_step(sb_line_t *line, unsigned char steps)
14
+ {
15
+ line->steps = steps;
16
+ sbi_poke(SB_LINE_BLOCK_BUFFER, (const unsigned char *)line, sizeof(sb_line_t));
17
+ SB_BYTE_AT(SB_LINE_BLOCK_PTR) = (unsigned char)SB_LINE_BLOCK_BUFFER;
18
+ SB_BYTE_AT(SB_LINE_BLOCK_PTR + 1) = (unsigned char)(SB_LINE_BLOCK_BUFFER >> 8);
19
+ sb_syscall(SB_FN_LINE_STEP, 0);
20
+ sbi_peek((unsigned char *)line, SB_LINE_BLOCK_BUFFER, sizeof(sb_line_t));
21
+ }
@@ -0,0 +1,27 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-math-div16.c
4
+ * 说明:sb_math_div16 的实现:16 位除以 8 位。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4B:$069A/$069B 除以 $069C,商回写 $069A/$069B,余数写 $069C;除数为 0 时 $0640 为 $FF。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_math_div16(unsigned int dividend, unsigned char divisor, unsigned int *quotient, unsigned char *remainder)
14
+ {
15
+ unsigned char status;
16
+
17
+ SB_BYTE_AT(SB_ARG_069A) = (unsigned char)dividend;
18
+ SB_BYTE_AT(SB_ARG_069A + 1) = (unsigned char)(dividend >> 8);
19
+ SB_BYTE_AT(SB_ARG_069A + 2) = divisor;
20
+ sb_syscall(SB_FN_DIV16, 0);
21
+ status = SB_BYTE_AT(SB_SYS_STATUS);
22
+ if (status == 0) {
23
+ *quotient = SBI_GET16(SB_ARG_069A);
24
+ *remainder = SB_BYTE_AT(SB_ARG_069A + 2);
25
+ }
26
+ return status;
27
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-math-time-text.c
4
+ * 说明:sb_math_time_text 的实现:时分秒转文字。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4C:参数放 $069A-$069C,结果 8 个字符在 $06AA-$06B1。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_math_time_text(unsigned char hour, unsigned char minute, unsigned char second, char *text)
14
+ {
15
+ SB_BYTE_AT(SB_ARG_069A) = hour;
16
+ SB_BYTE_AT(SB_ARG_069A + 1) = minute;
17
+ SB_BYTE_AT(SB_ARG_069A + 2) = second;
18
+ sb_syscall(SB_FN_TIME_TEXT, 0);
19
+ sbi_peek((unsigned char *)text, SB_ARG_06AA, 8);
20
+ text[8] = 0;
21
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-random-next.c
4
+ * 说明:sb_random_next 的实现:伪随机数步进一次。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4A 子功能不为 0 步进一次。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned long sb_random_next(void)
14
+ {
15
+ sb_syscall(SB_FN_RANDOM, 1);
16
+ return (unsigned long)SB_BYTE_AT(SB_RANDOM_STATE)
17
+ | ((unsigned long)SB_BYTE_AT(SB_RANDOM_STATE + 1) << 8)
18
+ | ((unsigned long)SB_BYTE_AT(SB_RANDOM_STATE + 2) << 16)
19
+ | ((unsigned long)SB_BYTE_AT(SB_RANDOM_STATE + 3) << 24);
20
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-random-seed.c
4
+ * 说明:sb_random_seed 的实现:设置伪随机数寄存器。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:寄存器在 $0696-$0699,低字节在前。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_random_seed(unsigned long seed)
14
+ {
15
+ SB_BYTE_AT(SB_RANDOM_STATE) = (unsigned char)seed;
16
+ SB_BYTE_AT(SB_RANDOM_STATE + 1) = (unsigned char)(seed >> 8);
17
+ SB_BYTE_AT(SB_RANDOM_STATE + 2) = (unsigned char)(seed >> 16);
18
+ SB_BYTE_AT(SB_RANDOM_STATE + 3) = (unsigned char)(seed >> 24);
19
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-random-warm-up.c
4
+ * 说明:sb_random_warm_up 的实现:伪随机数连续步进 100 次。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $4A 子功能 0。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_random_warm_up(void)
14
+ {
15
+ sb_syscall(SB_FN_RANDOM, 0);
16
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sbi-peek.c
4
+ * 说明:库内部函数:把固定地址的一段字节读给调用者。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:用来从系统服务的参数区取结果。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sbi_peek(unsigned char *dest, unsigned int address, unsigned char count)
14
+ {
15
+ unsigned char index;
16
+
17
+ for (index = 0; index < count; ++index) {
18
+ dest[index] = SB_BYTE_AT(address + index);
19
+ }
20
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sbi-poke.c
4
+ * 说明:库内部函数:把调用者的一段字节写到固定地址。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:用来把参数放进系统服务的参数区。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sbi_poke(unsigned int address, const unsigned char *source, unsigned char count)
14
+ {
15
+ unsigned char index;
16
+
17
+ for (index = 0; index < count; ++index) {
18
+ SB_BYTE_AT(address + index) = source[index];
19
+ }
20
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-address-to-far.c
4
+ * 说明:sb_address_to_far 的实现:把窗口地址换算成远指针(页号与页内偏移)。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $2C,页号 = 地址高 4 位 - 8 + 页组首页号(按 8 位回绕)。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_address_to_far(unsigned char group, unsigned int address, unsigned char *page, unsigned int *offset)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ SBI_SET_ENTRY(address);
17
+ sb_syscall(SB_FN_ADDR_TO_FAR, 0);
18
+ *page = SB_BYTE_AT(SB_SYS_PAGE);
19
+ *offset = SB_BYTE_AT(SB_FAR_OFFSET_LO) | ((unsigned int)SB_BYTE_AT(SB_FAR_OFFSET_HI) << 8);
20
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-far-read-byte.c
4
+ * 说明:sb_far_read_byte 的实现:读扩展 RAM 页里的一个字节。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:偏移超过一页($0FFF)时折算到后面的页。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_far_read_byte(unsigned char page, unsigned int offset)
14
+ {
15
+ SBI_SET_FAR(page + (unsigned char)(offset >> 12), offset & 0x0FFF);
16
+ return sbi_far_read_byte();
17
+ }
@@ -0,0 +1,36 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-far-read.c
4
+ * 说明:sb_far_read 的实现:把扩展 RAM 里的一段数据读到内存。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:每次经内核的跨页复制入口读最多 255 字节到 $0700 缓冲,再复制到目的地;页组映射 4 页,所以一次读不会越出页组。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <string.h>
12
+ #include "../sb-internal.h"
13
+
14
+ void sb_far_read(unsigned char page, unsigned int offset, void *dest, unsigned int length)
15
+ {
16
+ unsigned char *out = (unsigned char *)dest;
17
+ unsigned char count;
18
+ unsigned int address;
19
+
20
+ page += (unsigned char)(offset >> 12);
21
+ offset &= 0x0FFF;
22
+ while (length != 0) {
23
+ count = length > 255 ? 255 : (unsigned char)length;
24
+ address = 0x8000 + offset;
25
+ SB_BYTE_AT(SB_SYS_GROUP) = page;
26
+ SBI_SET_ENTRY(address);
27
+ SB_BYTE_AT(SB_PARAM_064F) = count;
28
+ sbi_far_copy_in();
29
+ memcpy(out, (const void *)SB_COPY_BUFFER, count);
30
+ out += count;
31
+ length -= count;
32
+ offset += count;
33
+ page += (unsigned char)(offset >> 12);
34
+ offset &= 0x0FFF;
35
+ }
36
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-far-write-byte.c
4
+ * 说明:sb_far_write_byte 的实现:写扩展 RAM 页里的一个字节。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:偏移超过一页($0FFF)时折算到后面的页。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_far_write_byte(unsigned char page, unsigned int offset, unsigned char value)
14
+ {
15
+ SBI_SET_FAR(page + (unsigned char)(offset >> 12), offset & 0x0FFF);
16
+ sbi_far_write_byte(value);
17
+ }
@@ -0,0 +1,36 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-far-write.c
4
+ * 说明:sb_far_write 的实现:把内存里的一段数据写到扩展 RAM。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:每次先复制最多 255 字节到 $0700 缓冲,再经内核的跨页复制入口写出。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include <string.h>
12
+ #include "../sb-internal.h"
13
+
14
+ void sb_far_write(unsigned char page, unsigned int offset, const void *src, unsigned int length)
15
+ {
16
+ const unsigned char *in = (const unsigned char *)src;
17
+ unsigned char count;
18
+ unsigned int address;
19
+
20
+ page += (unsigned char)(offset >> 12);
21
+ offset &= 0x0FFF;
22
+ while (length != 0) {
23
+ count = length > 255 ? 255 : (unsigned char)length;
24
+ address = 0x8000 + offset;
25
+ memcpy((void *)SB_COPY_BUFFER, in, count);
26
+ SB_BYTE_AT(SB_SYS_GROUP) = page;
27
+ SBI_SET_ENTRY(address);
28
+ SB_BYTE_AT(SB_PARAM_064F) = count;
29
+ sbi_far_copy_out();
30
+ in += count;
31
+ length -= count;
32
+ offset += count;
33
+ page += (unsigned char)(offset >> 12);
34
+ offset &= 0x0FFF;
35
+ }
36
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-page-alloc.c
4
+ * 说明:sb_page_alloc 的实现:分配连续的扩展 RAM 页。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $7E 子功能 0,页数写 $65A6,结果在 $65A7;出错码在 $6300。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_page_alloc(unsigned char count, unsigned char *first_page)
14
+ {
15
+ SB_BYTE_AT(SB_ALLOC_COUNT) = count;
16
+ sb_syscall(SB_FN_PAGE, SB_SUB_PAGE_ALLOC);
17
+ *first_page = SB_BYTE_AT(SB_ALLOC_START);
18
+ return SB_BYTE_AT(SB_DOS_ERROR);
19
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-page-free.c
4
+ * 说明:sb_page_free 的实现:释放连续的扩展 RAM 页。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $7E 子功能 1,起始页号写 $65A7,页数写 $65A6;出错码在 $6300。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_page_free(unsigned char first_page, unsigned char count)
14
+ {
15
+ SB_BYTE_AT(SB_ALLOC_START) = first_page;
16
+ SB_BYTE_AT(SB_ALLOC_COUNT) = count;
17
+ sb_syscall(SB_FN_PAGE, SB_SUB_PAGE_FREE);
18
+ return SB_BYTE_AT(SB_DOS_ERROR);
19
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-page-largest-free.c
4
+ * 说明:sb_page_largest_free 的实现:求最长的连续空闲页数。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $7E 子功能 2,结果在 $65A6。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_page_largest_free(void)
14
+ {
15
+ sb_syscall(SB_FN_PAGE, SB_SUB_PAGE_LARGEST);
16
+ return SB_BYTE_AT(SB_ALLOC_COUNT);
17
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-window-map-group.c
4
+ * 说明:sb_window_map_group 的实现:把页组的 4 个连续页映射到 4 个窗口。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $27,页组写 $0642;调用返回后映射保持。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_window_map_group(unsigned char group)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_GROUP) = group;
16
+ sb_syscall(SB_FN_MAP_GROUP, 0);
17
+ }
@@ -0,0 +1,18 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-window-map.c
4
+ * 说明:sb_window_map 的实现:把一个扩展 RAM 页映射到一个窗口。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $29,页号写 $0641,窗口号写 $0653;调用返回后映射保持。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_window_map(unsigned char window, unsigned char page)
14
+ {
15
+ SB_BYTE_AT(SB_SYS_PAGE) = page;
16
+ SB_BYTE_AT(SB_SYS_WINDOW) = window;
17
+ sb_syscall(SB_FN_MAP_WINDOW, 0);
18
+ }
@@ -0,0 +1,17 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-far-copy-in.s
3
+ ; 说明:库内部的汇编小例程:把扩展 RAM 页里的一段数据复制到 $0700 缓冲。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:调用者先放好页组 SYS_GROUP、窗口地址 PROG_ENTRY 与字节数 $064F;缓冲从 $0700 起,X 为 0。
8
+ ; ------------------------------------------------------------------------
9
+ .include "sb2000.inc"
10
+ .export _sbi_far_copy_in
11
+
12
+ .code
13
+
14
+ ; void sbi_far_copy_in(void)
15
+ _sbi_far_copy_in:
16
+ ldx #$00
17
+ jmp FAR_COPY_IN
@@ -0,0 +1,17 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-far-copy-out.s
3
+ ; 说明:库内部的汇编小例程:把 $0700 缓冲里的数据复制到扩展 RAM 页。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:调用者先放好页组 SYS_GROUP、窗口地址 PROG_ENTRY 与字节数 $064F;缓冲从 $0700 起,X 为 0。
8
+ ; ------------------------------------------------------------------------
9
+ .include "sb2000.inc"
10
+ .export _sbi_far_copy_out
11
+
12
+ .code
13
+
14
+ ; void sbi_far_copy_out(void)
15
+ _sbi_far_copy_out:
16
+ ldx #$00
17
+ jmp FAR_COPY_OUT
@@ -0,0 +1,19 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-far-read-byte.s
3
+ ; 说明:库内部的汇编小例程:读远指针处的字节。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:调用者先把页号放进 SYS_PAGE,页内偏移放进 FAR_OFFSET;内核入口 FAR_READ_BYTE 把页临时映射到窗口 3 读取,读完恢复。
8
+ ; ------------------------------------------------------------------------
9
+ .include "sb2000.inc"
10
+ .export _sbi_far_read_byte
11
+
12
+ .code
13
+
14
+ ; unsigned char sbi_far_read_byte(void)
15
+ _sbi_far_read_byte:
16
+ ldy #$00
17
+ jsr FAR_READ_BYTE
18
+ ldx #$00
19
+ rts
@@ -0,0 +1,17 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sbi-far-write-byte.s
3
+ ; 说明:库内部的汇编小例程:把字节写到远指针处。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-11
7
+ ; 备注:调用者先把页号放进 SYS_PAGE,页内偏移放进 FAR_OFFSET;要写的字节由 C 调用约定放在 A。
8
+ ; ------------------------------------------------------------------------
9
+ .include "sb2000.inc"
10
+ .export _sbi_far_write_byte
11
+
12
+ .code
13
+
14
+ ; void __fastcall__ sbi_far_write_byte(unsigned char value)
15
+ _sbi_far_write_byte:
16
+ ldy #$00
17
+ jmp FAR_WRITE_BYTE
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-printer-carriage-return.c
4
+ * 说明:sb_printer_carriage_return 的实现:复位并回车。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-11
8
+ * 备注:功能 $76 子功能 3。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_printer_carriage_return(void)
14
+ {
15
+ sb_syscall(SB_FN_PRINTER, 3);
16
+ }