fcdev 0.4.0 → 0.6.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 (66) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +26 -24
  3. package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +14 -17
  4. package/docs/02-/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +4 -2
  5. package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +1 -1
  6. package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +2 -2
  7. package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +12 -20
  8. package/docs/06-/345/217/215/346/261/207/347/274/226.md +9 -4
  9. package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +3 -3
  10. package/docs/09-/345/217/221/345/270/203.md +20 -25
  11. package/docs/nes/01-NES/347/233/256/346/240/207.md +1 -1
  12. package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +15 -8
  13. package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md +7 -7
  14. package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +17 -8
  15. package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +3 -1
  16. package/package.json +3 -3
  17. package/src/cli/commands/api-command.mjs +2 -2
  18. package/src/cli/commands/build-command.mjs +1 -1
  19. package/src/cli/commands/debug-command.mjs +5 -2
  20. package/src/cli/commands/disasm-command.mjs +1 -1
  21. package/src/cli/commands/disk-command.mjs +1 -1
  22. package/src/cli/commands/docs-command.mjs +3 -3
  23. package/src/cli/commands/run-command.mjs +2 -2
  24. package/src/disasm/address-tables.mjs +161 -0
  25. package/src/disasm/analysis.mjs +17 -11
  26. package/src/disasm/byte-kinds.mjs +20 -0
  27. package/src/disasm/disassembler.mjs +3 -2
  28. package/src/disasm/info-writer.mjs +3 -3
  29. package/src/docs/doc-topics.mjs +2 -2
  30. package/src/emulator/debug-client.mjs +1 -1
  31. package/src/emulator/emulator-locator.mjs +4 -18
  32. package/src/emulator/index.mjs +1 -1
  33. package/src/toolchain/toolchain-locator.mjs +2 -2
  34. package/targets/nes/lib/fcnes.lib +0 -0
  35. package/targets/nes/lib/nes-font.o +0 -0
  36. package/targets/sb2000/api-reference.md +310 -1
  37. package/targets/sb2000/asminc/sb2000.inc +90 -1
  38. package/targets/sb2000/include/sb2000-dma.h +46 -0
  39. package/targets/sb2000/include/sb2000-ppu.h +106 -0
  40. package/targets/sb2000/include/sb2000-symbols.h +170 -0
  41. package/targets/sb2000/include/sb2000-timer.h +54 -0
  42. package/targets/sb2000/include/sb2000.h +3 -0
  43. package/targets/sb2000/lib/crt0.o +0 -0
  44. package/targets/sb2000/lib/sb2000.lib +0 -0
  45. package/targets/sb2000/src/lib/dma/sb-dma-page-address.c +16 -0
  46. package/targets/sb2000/src/lib/dma/sb-dma-to-cpu.c +19 -0
  47. package/targets/sb2000/src/lib/dma/sb-dma-to-vram.c +16 -0
  48. package/targets/sb2000/src/lib/dma/sbi-dma-run.c +34 -0
  49. package/targets/sb2000/src/lib/ppu/sb-ppu-address.c +20 -0
  50. package/targets/sb2000/src/lib/ppu/sb-ppu-fill.c +19 -0
  51. package/targets/sb2000/src/lib/ppu/sb-ppu-oam-clear.c +21 -0
  52. package/targets/sb2000/src/lib/ppu/sb-ppu-oam-put.c +20 -0
  53. package/targets/sb2000/src/lib/ppu/sb-ppu-palette-get.c +16 -0
  54. package/targets/sb2000/src/lib/ppu/sb-ppu-palette-set.c +16 -0
  55. package/targets/sb2000/src/lib/ppu/sb-ppu-peek.c +22 -0
  56. package/targets/sb2000/src/lib/ppu/sb-ppu-read.c +20 -0
  57. package/targets/sb2000/src/lib/ppu/sb-ppu-render.c +20 -0
  58. package/targets/sb2000/src/lib/ppu/sb-ppu-wait-vblank.c +25 -0
  59. package/targets/sb2000/src/lib/ppu/sb-ppu-write.c +21 -0
  60. package/targets/sb2000/src/lib/sb-internal.h +3 -0
  61. package/targets/sb2000/src/lib/timer/sb-timer-current.c +16 -0
  62. package/targets/sb2000/src/lib/timer/sb-timer-mask.c +16 -0
  63. package/targets/sb2000/src/lib/timer/sb-timer-pending.c +16 -0
  64. package/targets/sb2000/src/lib/timer/sb-timer-start.c +17 -0
  65. package/targets/sb2000/src/lib/timer/sb-timer-stop.c +16 -0
  66. package/targets/sb2000/src/lib/timer/sb-timer-unmask.c +16 -0
@@ -108,4 +108,7 @@ void sbi_poke(unsigned int address, const unsigned char *source, unsigned char c
108
108
  /** 把固定地址 address 起的 count 个字节读到 dest。 */
109
109
  void sbi_peek(unsigned char *dest, unsigned int address, unsigned char count);
110
110
 
111
+ /** 启动一次通用 DMA 并等它完成;length 为 0 或超过 $8000 时返回 SB_ERR_BAD_PARAMETER,否则返回 0。 */
112
+ unsigned char sbi_dma_run(unsigned char mode, unsigned long source, unsigned int dest, unsigned int length);
113
+
111
114
  #endif
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-timer-current.c
4
+ * 说明:sb_timer_current 的实现:读定时器当前值。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:$4036 递减计数。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_timer_current(void)
14
+ {
15
+ return SB_BYTE_AT(SB_HW_TIMER_CURRENT);
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-timer-mask.c
4
+ * 说明:sb_timer_mask 的实现:屏蔽定时器中断并清除下溢标志。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:其余位取 DOS 在影子 $062F 里的值,不能写 1 去清键盘等中断。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_timer_mask(void)
14
+ {
15
+ SB_BYTE_AT(SB_HW_IRQ_MASK) = SB_BYTE_AT(SB_IRQ_MASK_SHADOW) | SB_HW_IRQ_TIMER;
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-timer-pending.c
4
+ * 说明:sb_timer_pending 的实现:读定时器下溢标志。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:$4033 的位 7。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_timer_pending(void)
14
+ {
15
+ return (SB_BYTE_AT(SB_HW_IRQ_PENDING) & SB_HW_IRQ_TIMER) != 0;
16
+ }
@@ -0,0 +1,17 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-timer-start.c
4
+ * 说明:sb_timer_start 的实现:设置并启动定时器。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:顺序与 BIOS 一致:先控制字节,再预置值。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_timer_start(unsigned char control, unsigned char preset)
14
+ {
15
+ SB_BYTE_AT(SB_HW_TIMER_CONTROL) = control;
16
+ SB_BYTE_AT(SB_HW_TIMER_PRESET) = preset;
17
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-timer-stop.c
4
+ * 说明:sb_timer_stop 的实现:停止定时器。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:控制字节写 0,位 7(允许)清除。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_timer_stop(void)
14
+ {
15
+ SB_BYTE_AT(SB_HW_TIMER_CONTROL) = 0;
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-timer-unmask.c
4
+ * 说明:sb_timer_unmask 的实现:允许定时器中断。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:其余位取 DOS 在影子 $062F 里的值。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_timer_unmask(void)
14
+ {
15
+ SB_BYTE_AT(SB_HW_IRQ_MASK) = SB_BYTE_AT(SB_IRQ_MASK_SHADOW) & (unsigned char)~SB_HW_IRQ_TIMER;
16
+ }