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,225 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:target-registry.mjs
3
+ // 说明:目标注册表:读取 targets/<名>/target.json,校验字段,解析目标专用选项与路径。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:目标定义的字段含义见 docs/03-目标规范.md 第 2 节;新增机型只需新增目标目录,不改这里。
8
+ // ------------------------------------------------------------------------
9
+ import { readdirSync } from 'node:fs';
10
+ import path from 'node:path';
11
+ import { fileURLToPath } from 'node:url';
12
+ import { FcdevError, isDirectory, readJsonFile } from '../shared/index.mjs';
13
+
14
+ /** 内置目标所在的目录 */
15
+ export const BUILTIN_TARGETS_DIR = fileURLToPath(new URL('../../targets/', import.meta.url));
16
+
17
+ /** 路径值里表示“相对于工具链根目录”的前缀 */
18
+ const TOOLCHAIN_PREFIX = 'toolchain:';
19
+
20
+ /** 运行方案的模式:rom 直接加载产物;firmware-disk 加载固件并挂载磁盘镜像 */
21
+ const RUN_MODES = new Set(['rom', 'firmware-disk']);
22
+
23
+ /** 目标专用选项允许的类型 */
24
+ const OPTION_TYPES = new Set(['boolean', 'string', 'number']);
25
+
26
+ /**
27
+ * @typedef {object} BankedSpec 多页(换页)程序的定义
28
+ * @property {string} option 目标专用选项名,值为库页个数
29
+ * @property {string} linkConfig 链接配置模板(路径值),含 %BANK_MEMORY% 与 %BANK_SEGMENTS% 两行
30
+ * @property {number} generatedFrom 模板里已写出前面的库页,从这一页起由 fcdev 按个数生成
31
+ * @property {number} maxBanks 库页个数的上限
32
+ * @property {string} memory 一个库页的内存区行,{n} 换成库页号
33
+ * @property {string} segment 一个库页的段行,{n} 换成库页号
34
+ */
35
+
36
+ /**
37
+ * @typedef {object} Target
38
+ * @property {string} name 标识
39
+ * @property {string} title 显示名
40
+ * @property {string} dir 目标目录的绝对路径
41
+ * @property {string} cpu CPU 型号
42
+ * @property {string} cc65Target 传给 cc65 工具的目标名
43
+ * @property {string} linkConfig 链接配置(路径值)
44
+ * @property {string[]} startup 启动代码(路径值)
45
+ * @property {string[]} forceImports 链接时强制引入的符号(让库里的启动代码一定被链接)
46
+ * @property {string[]} libraries 链接的库(路径值)
47
+ * @property {string[]} include 头文件目录(路径值)
48
+ * @property {string[]} asminclude 汇编引入目录(路径值)
49
+ * @property {Record<string, string|number>} defines 预定义宏
50
+ * @property {string} packager 打包器名
51
+ * @property {Record<string, unknown>} packagerOptions 打包器选项
52
+ * @property {string} extension 产物扩展名
53
+ * @property {string|null} nameRule 程序名规则
54
+ * @property {object|null} disk 磁盘镜像能力
55
+ * @property {object|null} run 运行方案
56
+ * @property {Record<string, {type: string, default: unknown, links: string[]}>} options 目标专用选项;布尔选项为 true 时额外链接 links 里的文件(路径值)
57
+ * @property {BankedSpec|null} banked 多页(换页)程序的定义;不支持时为 null
58
+ */
59
+
60
+ /**
61
+ * 校验一个字段是字符串数组。
62
+ * @param {unknown} value 字段值
63
+ * @param {string} field 字段名,用于出错提示
64
+ * @param {string} name 目标名
65
+ * @returns {string[]} 字段值
66
+ */
67
+ function requireStringArray(value, field, name) {
68
+ if (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) {
69
+ throw new FcdevError(`目标 ${name} 的 ${field} 必须是字符串数组`, { code: 'TARGET_INVALID' });
70
+ }
71
+ return value;
72
+ }
73
+
74
+ /**
75
+ * 校验并规范化多页程序的定义。
76
+ * @param {unknown} raw target.json 里的 banked;没有时为 undefined
77
+ * @param {string} name 目标名
78
+ * @param {Record<string, {type: string}>} options 已解析的目标专用选项
79
+ * @returns {BankedSpec|null} 多页定义;没有时为 null
80
+ * @throws {FcdevError} 字段缺失、类型不对,或对应的选项不是数字选项
81
+ */
82
+ function parseBanked(raw, name, options) {
83
+ if (raw === undefined) return null;
84
+ const invalid = (reason) => new FcdevError(`目标 ${name} 的 banked ${reason}`, { code: 'TARGET_INVALID' });
85
+ if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) throw invalid('必须是对象');
86
+ for (const field of ['option', 'linkConfig', 'memory', 'segment']) {
87
+ if (typeof raw[field] !== 'string' || raw[field] === '') throw invalid(`缺少字符串字段 ${field}`);
88
+ }
89
+ for (const field of ['generatedFrom', 'maxBanks']) {
90
+ if (!Number.isInteger(raw[field]) || raw[field] < 1) throw invalid(`的 ${field} 必须是不小于 1 的整数`);
91
+ }
92
+ if (options[raw.option]?.type !== 'number') throw invalid(`的 option(${raw.option})必须是 options 里的数字选项`);
93
+ return { option: raw.option, linkConfig: raw.linkConfig, generatedFrom: raw.generatedFrom, maxBanks: raw.maxBanks, memory: raw.memory, segment: raw.segment };
94
+ }
95
+
96
+ /**
97
+ * 校验并规范化目标定义。
98
+ * @param {unknown} raw target.json 的内容
99
+ * @param {string} dir 目标目录
100
+ * @returns {Target} 目标
101
+ * @throws {FcdevError} 缺字段或类型不对
102
+ */
103
+ export function parseTarget(raw, dir) {
104
+ const fallbackName = path.basename(dir);
105
+ if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
106
+ throw new FcdevError(`目标 ${fallbackName} 的 target.json 必须是对象`, { code: 'TARGET_INVALID' });
107
+ }
108
+ for (const field of ['name', 'title', 'cpu', 'cc65Target', 'linkConfig', 'packager', 'extension']) {
109
+ if (typeof raw[field] !== 'string' || raw[field] === '') {
110
+ throw new FcdevError(`目标 ${fallbackName} 缺少字符串字段 ${field}`, { code: 'TARGET_INVALID' });
111
+ }
112
+ }
113
+ if (raw.name !== fallbackName) {
114
+ throw new FcdevError(`目标目录 ${fallbackName} 与 target.json 中的 name(${raw.name})不一致`, { code: 'TARGET_INVALID' });
115
+ }
116
+ const options = {};
117
+ if (raw.run !== undefined && raw.run !== null) {
118
+ if (typeof raw.run.emulator !== 'string' || !RUN_MODES.has(raw.run.mode)) {
119
+ throw new FcdevError(`目标 ${raw.name} 的 run 必须包含 emulator,且 mode 为 ${[...RUN_MODES].join(' 或 ')}`, { code: 'TARGET_INVALID' });
120
+ }
121
+ }
122
+ for (const [key, spec] of Object.entries(raw.options ?? {})) {
123
+ if (!spec || !OPTION_TYPES.has(spec.type) || typeof spec.default !== spec.type) {
124
+ throw new FcdevError(`目标 ${raw.name} 的选项 ${key} 定义不合法`, { code: 'TARGET_INVALID' });
125
+ }
126
+ if (spec.links !== undefined && (spec.type !== 'boolean' || !Array.isArray(spec.links) || !spec.links.every((item) => typeof item === 'string'))) {
127
+ throw new FcdevError(`目标 ${raw.name} 的选项 ${key} 的 links 只能用于布尔选项,且必须是字符串数组`, { code: 'TARGET_INVALID' });
128
+ }
129
+ options[key] = { type: spec.type, default: spec.default, links: spec.links ?? [] };
130
+ }
131
+ const banked = parseBanked(raw.banked, raw.name, options);
132
+ return {
133
+ name: raw.name,
134
+ title: raw.title,
135
+ dir,
136
+ cpu: raw.cpu,
137
+ cc65Target: raw.cc65Target,
138
+ linkConfig: raw.linkConfig,
139
+ startup: requireStringArray(raw.startup ?? [], 'startup', raw.name),
140
+ forceImports: requireStringArray(raw.forceImports ?? [], 'forceImports', raw.name),
141
+ libraries: requireStringArray(raw.libraries ?? [], 'libraries', raw.name),
142
+ include: requireStringArray(raw.include ?? [], 'include', raw.name),
143
+ asminclude: requireStringArray(raw.asminclude ?? [], 'asminclude', raw.name),
144
+ defines: raw.defines ?? {},
145
+ packager: raw.packager,
146
+ packagerOptions: raw.packagerOptions ?? {},
147
+ extension: raw.extension,
148
+ nameRule: raw.nameRule ?? null,
149
+ disk: raw.disk ?? null,
150
+ run: raw.run ?? null,
151
+ options,
152
+ banked,
153
+ };
154
+ }
155
+
156
+ /**
157
+ * 列出目标目录下全部目标的名称。
158
+ * @param {string} [targetsDir] 目标所在目录
159
+ * @returns {string[]} 目标名,按字母排序
160
+ */
161
+ export function listTargetNames(targetsDir = BUILTIN_TARGETS_DIR) {
162
+ return readdirSync(targetsDir, { withFileTypes: true })
163
+ .filter((entry) => entry.isDirectory())
164
+ .map((entry) => entry.name)
165
+ .sort();
166
+ }
167
+
168
+ /**
169
+ * 读取一个目标。
170
+ * @param {string} name 目标名
171
+ * @param {string} [targetsDir] 目标所在目录
172
+ * @returns {Target} 目标
173
+ * @throws {FcdevError} 目标不存在或定义不合法
174
+ */
175
+ export function loadTarget(name, targetsDir = BUILTIN_TARGETS_DIR) {
176
+ const dir = path.join(targetsDir, name);
177
+ if (!/^[a-z0-9-]+$/.test(name) || !isDirectory(dir)) {
178
+ throw new FcdevError(`不支持的目标:${name}`, {
179
+ code: 'TARGET_UNKNOWN',
180
+ hint: `可用的目标:${listTargetNames(targetsDir).join('、')}`,
181
+ });
182
+ }
183
+ return parseTarget(readJsonFile(path.join(dir, 'target.json')), dir);
184
+ }
185
+
186
+ /**
187
+ * 把目标定义里的路径值换成绝对路径。
188
+ * @param {Target} target 目标
189
+ * @param {string} value 路径值:相对目标目录,或以 toolchain: 开头表示相对工具链根目录
190
+ * @param {string} toolchainHome 工具链根目录
191
+ * @returns {string} 绝对路径
192
+ */
193
+ export function resolveTargetPath(target, value, toolchainHome) {
194
+ if (value.startsWith(TOOLCHAIN_PREFIX)) return path.join(toolchainHome, value.slice(TOOLCHAIN_PREFIX.length));
195
+ return path.join(target.dir, value);
196
+ }
197
+
198
+ /**
199
+ * 合并用户给的目标专用选项与默认值,并校验。
200
+ * @param {Target} target 目标
201
+ * @param {Record<string, unknown>} given 配置里的 targetOptions
202
+ * @returns {Record<string, unknown>} 完整的选项
203
+ * @throws {FcdevError} 出现目标没有定义的选项,或类型不对
204
+ */
205
+ export function resolveTargetOptions(target, given) {
206
+ const result = {};
207
+ for (const [key, spec] of Object.entries(target.options)) result[key] = spec.default;
208
+ for (const [key, value] of Object.entries(given)) {
209
+ const spec = target.options[key];
210
+ if (!spec) {
211
+ throw new FcdevError(`目标 ${target.name} 没有选项 ${key}`, {
212
+ code: 'TARGET_OPTION_UNKNOWN',
213
+ hint: Object.keys(target.options).length > 0 ? `可用的选项:${Object.keys(target.options).join('、')}` : '该目标没有可配置的选项',
214
+ });
215
+ }
216
+ if (typeof value !== spec.type) {
217
+ throw new FcdevError(`目标 ${target.name} 的选项 ${key} 类型应为 ${spec.type}`, { code: 'TARGET_OPTION_INVALID' });
218
+ }
219
+ if (target.banked?.option === key && (!Number.isInteger(value) || value < 0 || value > target.banked.maxBanks)) {
220
+ throw new FcdevError(`目标 ${target.name} 的选项 ${key} 必须是 0 到 ${target.banked.maxBanks} 的整数`, { code: 'TARGET_OPTION_INVALID' });
221
+ }
222
+ result[key] = value;
223
+ }
224
+ return result;
225
+ }
@@ -0,0 +1,16 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:index.mjs
3
+ // 说明:toolchain 目录的对外入口。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:无
8
+ // ------------------------------------------------------------------------
9
+ export {
10
+ TOOLCHAIN_ENV_NAME,
11
+ getToolPath,
12
+ getToolchainPackageName,
13
+ getToolchainVersion,
14
+ locateToolchain,
15
+ runTool,
16
+ } from './toolchain-locator.mjs';
@@ -0,0 +1,104 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:toolchain-locator.mjs
3
+ // 说明:定位 cc65 工具链并启动其中的工具:配置项、环境变量、平台包,按顺序查找。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:不使用 PATH 里的 cc65,避免版本不一致;调用工具时设置 CC65_HOME。
8
+ // ------------------------------------------------------------------------
9
+ import { existsSync } from 'node:fs';
10
+ import { createRequire } from 'node:module';
11
+ import path from 'node:path';
12
+ import { FcdevError, runProcess } from '../shared/index.mjs';
13
+
14
+ /** 环境变量:自备 cc65 的根目录 */
15
+ export const TOOLCHAIN_ENV_NAME = 'FCDEV_CC65_HOME';
16
+
17
+ /** 工具链里必须存在的程序 */
18
+ const REQUIRED_TOOLS = ['cc65', 'ca65', 'ld65'];
19
+
20
+ /**
21
+ * @typedef {object} Toolchain
22
+ * @property {string} home 工具链根目录
23
+ * @property {string} source 来源:config、env 或 package
24
+ */
25
+
26
+ /**
27
+ * 工具链平台包的名称,放在 @rujianjs 作用域下。
28
+ * @param {string} [platform] 系统,默认当前系统
29
+ * @param {string} [arch] 架构,默认当前架构
30
+ * @returns {string} 包名
31
+ */
32
+ export function getToolchainPackageName(platform = process.platform, arch = process.arch) {
33
+ return `@rujianjs/fcdev-cc65-${platform}-${arch}`;
34
+ }
35
+
36
+ /**
37
+ * 工具程序的完整路径。
38
+ * @param {Toolchain} toolchain 工具链
39
+ * @param {string} tool 工具名,如 cc65
40
+ * @returns {string} 可执行文件路径
41
+ */
42
+ export function getToolPath(toolchain, tool) {
43
+ const fileName = process.platform === 'win32' ? `${tool}.exe` : tool;
44
+ return path.join(toolchain.home, 'bin', fileName);
45
+ }
46
+
47
+ /**
48
+ * 检查目录是否是完整的工具链根目录。
49
+ * @param {string} home 候选目录
50
+ * @returns {boolean} 含全部必需程序时为 true
51
+ */
52
+ function isToolchainHome(home) {
53
+ return REQUIRED_TOOLS.every((tool) => existsSync(getToolPath({ home, source: '' }, tool)));
54
+ }
55
+
56
+ /**
57
+ * 按顺序定位工具链:配置项 toolchain、环境变量、平台包。
58
+ * @param {{configured?: string, env?: NodeJS.ProcessEnv}} [options] configured 为配置里的 toolchain 绝对路径
59
+ * @returns {Toolchain} 工具链
60
+ * @throws {FcdevError} 都找不到,或指定的目录不完整
61
+ */
62
+ export function locateToolchain({ configured, env = process.env } = {}) {
63
+ const explicit = configured ? { home: configured, source: 'config' } : env[TOOLCHAIN_ENV_NAME] ? { home: path.resolve(env[TOOLCHAIN_ENV_NAME]), source: 'env' } : null;
64
+ if (explicit) {
65
+ if (!isToolchainHome(explicit.home)) {
66
+ throw new FcdevError(`${explicit.home} 不是完整的 cc65 目录(缺少 bin 下的 ${REQUIRED_TOOLS.join('、')})`, { code: 'TOOLCHAIN_INCOMPLETE' });
67
+ }
68
+ return explicit;
69
+ }
70
+ const packageName = getToolchainPackageName();
71
+ try {
72
+ const packageJson = createRequire(import.meta.url).resolve(`${packageName}/package.json`);
73
+ const home = path.dirname(packageJson);
74
+ if (isToolchainHome(home)) return { home, source: 'package' };
75
+ } catch {
76
+ // 平台包没有安装,落到下面统一的报错
77
+ }
78
+ throw new FcdevError('找不到 cc65 工具链', {
79
+ code: 'TOOLCHAIN_NOT_FOUND',
80
+ hint: `任选一种:安装平台包 ${packageName};设置环境变量 ${TOOLCHAIN_ENV_NAME} 指向自备的 cc65 目录;在 fcdev.json 里用 toolchain 指定目录`,
81
+ });
82
+ }
83
+
84
+ /**
85
+ * 运行工具链里的一个工具。
86
+ * @param {Toolchain} toolchain 工具链
87
+ * @param {string} tool 工具名
88
+ * @param {string[]} args 参数
89
+ * @param {{cwd?: string, timeoutMs?: number}} [options] 工作目录与超时
90
+ * @returns {Promise<import('../shared/index.mjs').ProcessResult>} 运行结果
91
+ */
92
+ export function runTool(toolchain, tool, args, options = {}) {
93
+ return runProcess(getToolPath(toolchain, tool), args, { ...options, env: { ...process.env, CC65_HOME: toolchain.home } });
94
+ }
95
+
96
+ /**
97
+ * 读取工具链版本,用于增量构建的指纹。
98
+ * @param {Toolchain} toolchain 工具链
99
+ * @returns {Promise<string>} cc65 的版本输出,如 “cc65 V2.19 - Git 357f64e”
100
+ */
101
+ export async function getToolchainVersion(toolchain) {
102
+ const result = await runTool(toolchain, 'cc65', ['--version']);
103
+ return (result.stderr || result.stdout).trim();
104
+ }
@@ -0,0 +1,16 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:fcnes.inc
3
+ ; 说明:NES 的 PPU 寄存器地址,汇编程序与 fcnes 库共用。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-10
7
+ ; 备注:只含符号定义,不占空间。
8
+ ; ------------------------------------------------------------------------
9
+ PPUCTRL = $2000 ; 控制寄存器:名称表、图案表、NMI
10
+ PPUMASK = $2001 ; 显示开关:背景、精灵
11
+ PPUSTATUS = $2002 ; 状态:位 7 为垂直消隐;读取会复位 PPUADDR 与 PPUSCROLL 的写入顺序
12
+ OAMADDR = $2003 ; 精灵内存地址
13
+ OAMDATA = $2004 ; 精灵内存数据
14
+ PPUSCROLL = $2005 ; 滚动,连续写两次:水平、垂直
15
+ PPUADDR = $2006 ; 显存地址,连续写两次:高字节、低字节
16
+ PPUDATA = $2007 ; 显存数据,写入后地址自动递增
Binary file
@@ -0,0 +1,152 @@
1
+ /**
2
+ * 8x8 monochrome bitmap fonts for rendering
3
+ * Author: Daniel Hepper <daniel@hepper.net>
4
+ *
5
+ * License: Public Domain
6
+ *
7
+ * Based on:
8
+ * // Summary: font8x8.h
9
+ * // 8x8 monochrome bitmap fonts for rendering
10
+ * //
11
+ * // Author:
12
+ * // Marcel Sondaar
13
+ * // International Business Machines (public domain VGA fonts)
14
+ * //
15
+ * // License:
16
+ * // Public Domain
17
+ *
18
+ * Fetched from: http://dimensionalrift.homelinux.net/combuster/mos3/?p=viewsource&file=/modules/gfx/font8_8.asm
19
+ **/
20
+
21
+ // Constant: font8x8_basic
22
+ // Contains an 8x8 font map for unicode points U+0000 - U+007F (basic latin)
23
+ char font8x8_basic[128][8] = {
24
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0000 (nul)
25
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0001
26
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0002
27
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0003
28
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0004
29
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0005
30
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0006
31
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0007
32
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0008
33
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0009
34
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000A
35
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000B
36
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000C
37
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000D
38
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000E
39
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000F
40
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0010
41
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0011
42
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0012
43
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0013
44
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0014
45
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0015
46
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0016
47
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0017
48
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0018
49
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0019
50
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001A
51
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001B
52
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001C
53
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001D
54
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001E
55
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001F
56
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0020 (space)
57
+ { 0x18, 0x3C, 0x3C, 0x18, 0x18, 0x00, 0x18, 0x00}, // U+0021 (!)
58
+ { 0x36, 0x36, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0022 (")
59
+ { 0x36, 0x36, 0x7F, 0x36, 0x7F, 0x36, 0x36, 0x00}, // U+0023 (#)
60
+ { 0x0C, 0x3E, 0x03, 0x1E, 0x30, 0x1F, 0x0C, 0x00}, // U+0024 ($)
61
+ { 0x00, 0x63, 0x33, 0x18, 0x0C, 0x66, 0x63, 0x00}, // U+0025 (%)
62
+ { 0x1C, 0x36, 0x1C, 0x6E, 0x3B, 0x33, 0x6E, 0x00}, // U+0026 (&)
63
+ { 0x06, 0x06, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0027 (')
64
+ { 0x18, 0x0C, 0x06, 0x06, 0x06, 0x0C, 0x18, 0x00}, // U+0028 (()
65
+ { 0x06, 0x0C, 0x18, 0x18, 0x18, 0x0C, 0x06, 0x00}, // U+0029 ())
66
+ { 0x00, 0x66, 0x3C, 0xFF, 0x3C, 0x66, 0x00, 0x00}, // U+002A (*)
67
+ { 0x00, 0x0C, 0x0C, 0x3F, 0x0C, 0x0C, 0x00, 0x00}, // U+002B (+)
68
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x0C, 0x0C, 0x06}, // U+002C (,)
69
+ { 0x00, 0x00, 0x00, 0x3F, 0x00, 0x00, 0x00, 0x00}, // U+002D (-)
70
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x0C, 0x0C, 0x00}, // U+002E (.)
71
+ { 0x60, 0x30, 0x18, 0x0C, 0x06, 0x03, 0x01, 0x00}, // U+002F (/)
72
+ { 0x3E, 0x63, 0x73, 0x7B, 0x6F, 0x67, 0x3E, 0x00}, // U+0030 (0)
73
+ { 0x0C, 0x0E, 0x0C, 0x0C, 0x0C, 0x0C, 0x3F, 0x00}, // U+0031 (1)
74
+ { 0x1E, 0x33, 0x30, 0x1C, 0x06, 0x33, 0x3F, 0x00}, // U+0032 (2)
75
+ { 0x1E, 0x33, 0x30, 0x1C, 0x30, 0x33, 0x1E, 0x00}, // U+0033 (3)
76
+ { 0x38, 0x3C, 0x36, 0x33, 0x7F, 0x30, 0x78, 0x00}, // U+0034 (4)
77
+ { 0x3F, 0x03, 0x1F, 0x30, 0x30, 0x33, 0x1E, 0x00}, // U+0035 (5)
78
+ { 0x1C, 0x06, 0x03, 0x1F, 0x33, 0x33, 0x1E, 0x00}, // U+0036 (6)
79
+ { 0x3F, 0x33, 0x30, 0x18, 0x0C, 0x0C, 0x0C, 0x00}, // U+0037 (7)
80
+ { 0x1E, 0x33, 0x33, 0x1E, 0x33, 0x33, 0x1E, 0x00}, // U+0038 (8)
81
+ { 0x1E, 0x33, 0x33, 0x3E, 0x30, 0x18, 0x0E, 0x00}, // U+0039 (9)
82
+ { 0x00, 0x0C, 0x0C, 0x00, 0x00, 0x0C, 0x0C, 0x00}, // U+003A (:)
83
+ { 0x00, 0x0C, 0x0C, 0x00, 0x00, 0x0C, 0x0C, 0x06}, // U+003B (;)
84
+ { 0x18, 0x0C, 0x06, 0x03, 0x06, 0x0C, 0x18, 0x00}, // U+003C (<)
85
+ { 0x00, 0x00, 0x3F, 0x00, 0x00, 0x3F, 0x00, 0x00}, // U+003D (=)
86
+ { 0x06, 0x0C, 0x18, 0x30, 0x18, 0x0C, 0x06, 0x00}, // U+003E (>)
87
+ { 0x1E, 0x33, 0x30, 0x18, 0x0C, 0x00, 0x0C, 0x00}, // U+003F (?)
88
+ { 0x3E, 0x63, 0x7B, 0x7B, 0x7B, 0x03, 0x1E, 0x00}, // U+0040 (@)
89
+ { 0x0C, 0x1E, 0x33, 0x33, 0x3F, 0x33, 0x33, 0x00}, // U+0041 (A)
90
+ { 0x3F, 0x66, 0x66, 0x3E, 0x66, 0x66, 0x3F, 0x00}, // U+0042 (B)
91
+ { 0x3C, 0x66, 0x03, 0x03, 0x03, 0x66, 0x3C, 0x00}, // U+0043 (C)
92
+ { 0x1F, 0x36, 0x66, 0x66, 0x66, 0x36, 0x1F, 0x00}, // U+0044 (D)
93
+ { 0x7F, 0x46, 0x16, 0x1E, 0x16, 0x46, 0x7F, 0x00}, // U+0045 (E)
94
+ { 0x7F, 0x46, 0x16, 0x1E, 0x16, 0x06, 0x0F, 0x00}, // U+0046 (F)
95
+ { 0x3C, 0x66, 0x03, 0x03, 0x73, 0x66, 0x7C, 0x00}, // U+0047 (G)
96
+ { 0x33, 0x33, 0x33, 0x3F, 0x33, 0x33, 0x33, 0x00}, // U+0048 (H)
97
+ { 0x1E, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+0049 (I)
98
+ { 0x78, 0x30, 0x30, 0x30, 0x33, 0x33, 0x1E, 0x00}, // U+004A (J)
99
+ { 0x67, 0x66, 0x36, 0x1E, 0x36, 0x66, 0x67, 0x00}, // U+004B (K)
100
+ { 0x0F, 0x06, 0x06, 0x06, 0x46, 0x66, 0x7F, 0x00}, // U+004C (L)
101
+ { 0x63, 0x77, 0x7F, 0x7F, 0x6B, 0x63, 0x63, 0x00}, // U+004D (M)
102
+ { 0x63, 0x67, 0x6F, 0x7B, 0x73, 0x63, 0x63, 0x00}, // U+004E (N)
103
+ { 0x1C, 0x36, 0x63, 0x63, 0x63, 0x36, 0x1C, 0x00}, // U+004F (O)
104
+ { 0x3F, 0x66, 0x66, 0x3E, 0x06, 0x06, 0x0F, 0x00}, // U+0050 (P)
105
+ { 0x1E, 0x33, 0x33, 0x33, 0x3B, 0x1E, 0x38, 0x00}, // U+0051 (Q)
106
+ { 0x3F, 0x66, 0x66, 0x3E, 0x36, 0x66, 0x67, 0x00}, // U+0052 (R)
107
+ { 0x1E, 0x33, 0x07, 0x0E, 0x38, 0x33, 0x1E, 0x00}, // U+0053 (S)
108
+ { 0x3F, 0x2D, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+0054 (T)
109
+ { 0x33, 0x33, 0x33, 0x33, 0x33, 0x33, 0x3F, 0x00}, // U+0055 (U)
110
+ { 0x33, 0x33, 0x33, 0x33, 0x33, 0x1E, 0x0C, 0x00}, // U+0056 (V)
111
+ { 0x63, 0x63, 0x63, 0x6B, 0x7F, 0x77, 0x63, 0x00}, // U+0057 (W)
112
+ { 0x63, 0x63, 0x36, 0x1C, 0x1C, 0x36, 0x63, 0x00}, // U+0058 (X)
113
+ { 0x33, 0x33, 0x33, 0x1E, 0x0C, 0x0C, 0x1E, 0x00}, // U+0059 (Y)
114
+ { 0x7F, 0x63, 0x31, 0x18, 0x4C, 0x66, 0x7F, 0x00}, // U+005A (Z)
115
+ { 0x1E, 0x06, 0x06, 0x06, 0x06, 0x06, 0x1E, 0x00}, // U+005B ([)
116
+ { 0x03, 0x06, 0x0C, 0x18, 0x30, 0x60, 0x40, 0x00}, // U+005C (\)
117
+ { 0x1E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x1E, 0x00}, // U+005D (])
118
+ { 0x08, 0x1C, 0x36, 0x63, 0x00, 0x00, 0x00, 0x00}, // U+005E (^)
119
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF}, // U+005F (_)
120
+ { 0x0C, 0x0C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0060 (`)
121
+ { 0x00, 0x00, 0x1E, 0x30, 0x3E, 0x33, 0x6E, 0x00}, // U+0061 (a)
122
+ { 0x07, 0x06, 0x06, 0x3E, 0x66, 0x66, 0x3B, 0x00}, // U+0062 (b)
123
+ { 0x00, 0x00, 0x1E, 0x33, 0x03, 0x33, 0x1E, 0x00}, // U+0063 (c)
124
+ { 0x38, 0x30, 0x30, 0x3e, 0x33, 0x33, 0x6E, 0x00}, // U+0064 (d)
125
+ { 0x00, 0x00, 0x1E, 0x33, 0x3f, 0x03, 0x1E, 0x00}, // U+0065 (e)
126
+ { 0x1C, 0x36, 0x06, 0x0f, 0x06, 0x06, 0x0F, 0x00}, // U+0066 (f)
127
+ { 0x00, 0x00, 0x6E, 0x33, 0x33, 0x3E, 0x30, 0x1F}, // U+0067 (g)
128
+ { 0x07, 0x06, 0x36, 0x6E, 0x66, 0x66, 0x67, 0x00}, // U+0068 (h)
129
+ { 0x0C, 0x00, 0x0E, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+0069 (i)
130
+ { 0x30, 0x00, 0x30, 0x30, 0x30, 0x33, 0x33, 0x1E}, // U+006A (j)
131
+ { 0x07, 0x06, 0x66, 0x36, 0x1E, 0x36, 0x67, 0x00}, // U+006B (k)
132
+ { 0x0E, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+006C (l)
133
+ { 0x00, 0x00, 0x33, 0x7F, 0x7F, 0x6B, 0x63, 0x00}, // U+006D (m)
134
+ { 0x00, 0x00, 0x1F, 0x33, 0x33, 0x33, 0x33, 0x00}, // U+006E (n)
135
+ { 0x00, 0x00, 0x1E, 0x33, 0x33, 0x33, 0x1E, 0x00}, // U+006F (o)
136
+ { 0x00, 0x00, 0x3B, 0x66, 0x66, 0x3E, 0x06, 0x0F}, // U+0070 (p)
137
+ { 0x00, 0x00, 0x6E, 0x33, 0x33, 0x3E, 0x30, 0x78}, // U+0071 (q)
138
+ { 0x00, 0x00, 0x3B, 0x6E, 0x66, 0x06, 0x0F, 0x00}, // U+0072 (r)
139
+ { 0x00, 0x00, 0x3E, 0x03, 0x1E, 0x30, 0x1F, 0x00}, // U+0073 (s)
140
+ { 0x08, 0x0C, 0x3E, 0x0C, 0x0C, 0x2C, 0x18, 0x00}, // U+0074 (t)
141
+ { 0x00, 0x00, 0x33, 0x33, 0x33, 0x33, 0x6E, 0x00}, // U+0075 (u)
142
+ { 0x00, 0x00, 0x33, 0x33, 0x33, 0x1E, 0x0C, 0x00}, // U+0076 (v)
143
+ { 0x00, 0x00, 0x63, 0x6B, 0x7F, 0x7F, 0x36, 0x00}, // U+0077 (w)
144
+ { 0x00, 0x00, 0x63, 0x36, 0x1C, 0x36, 0x63, 0x00}, // U+0078 (x)
145
+ { 0x00, 0x00, 0x33, 0x33, 0x33, 0x3E, 0x30, 0x1F}, // U+0079 (y)
146
+ { 0x00, 0x00, 0x3F, 0x19, 0x0C, 0x26, 0x3F, 0x00}, // U+007A (z)
147
+ { 0x38, 0x0C, 0x0C, 0x07, 0x0C, 0x0C, 0x38, 0x00}, // U+007B ({)
148
+ { 0x18, 0x18, 0x18, 0x00, 0x18, 0x18, 0x18, 0x00}, // U+007C (|)
149
+ { 0x07, 0x0C, 0x0C, 0x38, 0x0C, 0x0C, 0x07, 0x00}, // U+007D (})
150
+ { 0x6E, 0x3B, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+007E (~)
151
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00} // U+007F
152
+ };
@@ -0,0 +1,45 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:fcnes.h
4
+ * 说明:fcdev 的 NES 辅助函数:画面开关、调色板、文字显示、等待垂直消隐。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-10
8
+ * 备注:文字用 ASCII 字库(图块号等于字符码),背景图案表为 $0000;画面关闭时才能写显存。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #ifndef FCNES_H
12
+ #define FCNES_H
13
+
14
+ /**
15
+ * 关闭画面,之后可以写显存。
16
+ */
17
+ void nes_screen_off(void);
18
+
19
+ /**
20
+ * 打开背景显示,并把滚动位置复位到 (0, 0)。
21
+ */
22
+ void nes_screen_on(void);
23
+
24
+ /**
25
+ * 写入 32 字节调色板:前 16 字节为背景,后 16 字节为精灵。
26
+ *
27
+ * @param colors 32 字节的颜色表。
28
+ */
29
+ void __fastcall__ nes_set_palette(const unsigned char *colors);
30
+
31
+ /**
32
+ * 在名称表的指定位置写零结尾字符串,要先关闭画面。
33
+ *
34
+ * @param x 列,0 到 31。
35
+ * @param y 行,0 到 29。
36
+ * @param s 零结尾的字符串。
37
+ */
38
+ void __fastcall__ nes_print(unsigned char x, unsigned char y, const char *s);
39
+
40
+ /**
41
+ * 等待下一次垂直消隐开始。
42
+ */
43
+ void nes_wait_vblank(void);
44
+
45
+ #endif
Binary file
Binary file
@@ -0,0 +1,9 @@
1
+ {
2
+ "libraries": {
3
+ "lib/fcnes.lib": ["src/fcnes.s"]
4
+ },
5
+ "objects": {
6
+ "lib/nes-font.o": "src/nes-font.s"
7
+ },
8
+ "binIncludeDirs": ["chr"]
9
+ }
@@ -0,0 +1,91 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:fcnes.s
3
+ ; 说明:fcnes.h 里各函数的实现:画面开关、调色板、文字显示、等待垂直消隐。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-10
7
+ ; 备注:C 调用约定为 cc65 的 fastcall:最后一个参数在 A(低字节)与 X(高字节),其余参数在 C 栈上,由被调用者弹出。
8
+ ; ------------------------------------------------------------------------
9
+ .include "fcnes.inc"
10
+ .export _nes_screen_off, _nes_screen_on, _nes_set_palette, _nes_print, _nes_wait_vblank
11
+ .import popa
12
+ .importzp ptr1, tmp1, tmp2
13
+
14
+ ; 背景与精灵都显示,包括最左 8 列
15
+ SHOW_ALL = $1E
16
+
17
+ .code
18
+
19
+ ; void nes_screen_off(void)
20
+ _nes_screen_off:
21
+ lda #0
22
+ sta PPUMASK
23
+ rts
24
+
25
+ ; void nes_screen_on(void):先复位滚动,再打开显示
26
+ _nes_screen_on:
27
+ lda PPUSTATUS
28
+ lda #0
29
+ sta PPUSCROLL
30
+ sta PPUSCROLL
31
+ sta PPUCTRL
32
+ lda #SHOW_ALL
33
+ sta PPUMASK
34
+ rts
35
+
36
+ ; void nes_set_palette(const unsigned char *colors):把 32 字节写到 $3F00
37
+ _nes_set_palette:
38
+ sta ptr1
39
+ stx ptr1+1
40
+ lda PPUSTATUS
41
+ lda #$3F
42
+ sta PPUADDR
43
+ lda #$00
44
+ sta PPUADDR
45
+ ldy #0
46
+ @loop: lda (ptr1),y
47
+ sta PPUDATA
48
+ iny
49
+ cpy #32
50
+ bne @loop
51
+ rts
52
+
53
+ ; void nes_print(unsigned char x, unsigned char y, const char *s)
54
+ ; 名称表地址 = $2000 + y*32 + x
55
+ _nes_print:
56
+ sta ptr1
57
+ stx ptr1+1
58
+ jsr popa
59
+ sta tmp1 ; y
60
+ jsr popa
61
+ sta tmp2 ; x
62
+ lda PPUSTATUS
63
+ lda tmp1
64
+ lsr a
65
+ lsr a
66
+ lsr a
67
+ clc
68
+ adc #$20
69
+ sta PPUADDR ; 高字节:$20 加上 y 除以 8
70
+ lda tmp1
71
+ and #$07
72
+ asl a
73
+ asl a
74
+ asl a
75
+ asl a
76
+ asl a
77
+ ora tmp2
78
+ sta PPUADDR ; 低字节:y 的低 3 位乘 32 再加 x
79
+ ldy #0
80
+ @next: lda (ptr1),y
81
+ beq @done
82
+ sta PPUDATA
83
+ iny
84
+ bne @next
85
+ @done: rts
86
+
87
+ ; void nes_wait_vblank(void)
88
+ _nes_wait_vblank:
89
+ @wait: bit PPUSTATUS
90
+ bpl @wait
91
+ rts