fcdev 0.3.1 → 0.5.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 (70) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +35 -33
  3. package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +27 -25
  4. package/docs/02-/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +8 -7
  5. package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +9 -10
  6. package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +13 -11
  7. package/docs/06-/345/217/215/346/261/207/347/274/226.md +9 -4
  8. package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +6 -6
  9. package/docs/09-/345/217/221/345/270/203.md +31 -22
  10. package/docs/10-VS Code/346/211/251/345/261/225.md" +1 -1
  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 +16 -9
  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 -2
  16. package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +1 -1
  17. package/package.json +4 -8
  18. package/src/cli/commands/api-command.mjs +2 -2
  19. package/src/cli/commands/build-command.mjs +1 -1
  20. package/src/cli/commands/debug-command.mjs +5 -2
  21. package/src/cli/commands/disasm-command.mjs +1 -1
  22. package/src/cli/commands/disk-command.mjs +1 -1
  23. package/src/cli/commands/docs-command.mjs +6 -6
  24. package/src/cli/commands/run-command.mjs +2 -2
  25. package/src/cli/index.mjs +1 -1
  26. package/src/disasm/address-tables.mjs +161 -0
  27. package/src/disasm/analysis.mjs +17 -11
  28. package/src/disasm/byte-kinds.mjs +20 -0
  29. package/src/disasm/disassembler.mjs +3 -2
  30. package/src/disasm/info-writer.mjs +3 -3
  31. package/src/docs/doc-index.mjs +5 -28
  32. package/src/docs/doc-topics.mjs +2 -2
  33. package/src/emulator/debug-client.mjs +1 -1
  34. package/src/emulator/emulator-locator.mjs +13 -27
  35. package/src/emulator/index.mjs +1 -1
  36. package/src/toolchain/index.mjs +1 -1
  37. package/src/toolchain/toolchain-locator.mjs +8 -17
  38. package/targets/nes/lib/fcnes.lib +0 -0
  39. package/targets/nes/lib/nes-font.o +0 -0
  40. package/targets/sb2000/api-reference.md +310 -1
  41. package/targets/sb2000/asminc/sb2000.inc +90 -1
  42. package/targets/sb2000/include/sb2000-dma.h +46 -0
  43. package/targets/sb2000/include/sb2000-ppu.h +106 -0
  44. package/targets/sb2000/include/sb2000-symbols.h +170 -0
  45. package/targets/sb2000/include/sb2000-timer.h +54 -0
  46. package/targets/sb2000/include/sb2000.h +3 -0
  47. package/targets/sb2000/lib/crt0.o +0 -0
  48. package/targets/sb2000/lib/sb2000.lib +0 -0
  49. package/targets/sb2000/src/lib/dma/sb-dma-page-address.c +16 -0
  50. package/targets/sb2000/src/lib/dma/sb-dma-to-cpu.c +19 -0
  51. package/targets/sb2000/src/lib/dma/sb-dma-to-vram.c +16 -0
  52. package/targets/sb2000/src/lib/dma/sbi-dma-run.c +34 -0
  53. package/targets/sb2000/src/lib/ppu/sb-ppu-address.c +20 -0
  54. package/targets/sb2000/src/lib/ppu/sb-ppu-fill.c +19 -0
  55. package/targets/sb2000/src/lib/ppu/sb-ppu-oam-clear.c +21 -0
  56. package/targets/sb2000/src/lib/ppu/sb-ppu-oam-put.c +20 -0
  57. package/targets/sb2000/src/lib/ppu/sb-ppu-palette-get.c +16 -0
  58. package/targets/sb2000/src/lib/ppu/sb-ppu-palette-set.c +16 -0
  59. package/targets/sb2000/src/lib/ppu/sb-ppu-peek.c +22 -0
  60. package/targets/sb2000/src/lib/ppu/sb-ppu-read.c +20 -0
  61. package/targets/sb2000/src/lib/ppu/sb-ppu-render.c +20 -0
  62. package/targets/sb2000/src/lib/ppu/sb-ppu-wait-vblank.c +25 -0
  63. package/targets/sb2000/src/lib/ppu/sb-ppu-write.c +21 -0
  64. package/targets/sb2000/src/lib/sb-internal.h +3 -0
  65. package/targets/sb2000/src/lib/timer/sb-timer-current.c +16 -0
  66. package/targets/sb2000/src/lib/timer/sb-timer-mask.c +16 -0
  67. package/targets/sb2000/src/lib/timer/sb-timer-pending.c +16 -0
  68. package/targets/sb2000/src/lib/timer/sb-timer-start.c +17 -0
  69. package/targets/sb2000/src/lib/timer/sb-timer-stop.c +16 -0
  70. package/targets/sb2000/src/lib/timer/sb-timer-unmask.c +16 -0
@@ -521,6 +521,176 @@
521
521
  /** 通用参数或返回值,如读到的字节 */
522
522
  #define SB_PARAM_0653 0x0653
523
523
 
524
+ /* 硬件寄存器:图形(真机为 UM6576,行为以真机实测为准,见 docs/sb2000/03-硬件说明.md) */
525
+ /** 控制:位 7 允许 NMI,位 5 精灵 8x16,位 2 地址增量,位 1-0 背景页 */
526
+ #define SB_HW_PPU_CTRL 0x2000
527
+ /** 显示:灰度、最左 8 像素、背景与精灵显示、颜色增强 */
528
+ #define SB_HW_PPU_MASK 0x2001
529
+ /** 状态(读):位 7 垂直消隐,位 6 精灵 0 碰撞,位 5 一行超过 8 个精灵 */
530
+ #define SB_HW_PPU_STATUS 0x2002
531
+ /** 精灵 RAM 地址 */
532
+ #define SB_HW_OAM_ADDRESS 0x2003
533
+ /** 精灵 RAM 数据 */
534
+ #define SB_HW_OAM_DATA 0x2004
535
+ /** 滚动,连续写两次(X、Y) */
536
+ #define SB_HW_PPU_SCROLL 0x2005
537
+ /** 显存地址,连续写两次(高、低) */
538
+ #define SB_HW_PPU_ADDRESS 0x2006
539
+ /** 显存数据,读要先读一次刷新缓冲 */
540
+ #define SB_HW_PPU_DATA 0x2007
541
+ /** 扩展控制:位 7 背景 16 色,位 3-2 精灵图案表,位 0 名称表起始 */
542
+ #define SB_HW_PPU_EXT 0x2008
543
+ /** 调色板,64 项($2040-$207F) */
544
+ #define SB_HW_PALETTE 0x2040
545
+ /** 精灵 DMA:写页号,把 $xx00 起的 256 字节送进精灵 RAM */
546
+ #define SB_HW_OAM_DMA 0x4014
547
+
548
+ /* 硬件寄存器:外设与中断 */
549
+ /** 声音通道使能 */
550
+ #define SB_HW_SOUND_ENABLE 0x4015
551
+ /** 手柄 1 */
552
+ #define SB_HW_PAD_1 0x4016
553
+ /** 手柄 2 */
554
+ #define SB_HW_PAD_2 0x4017
555
+ /** 读:键盘扫描码;写:位 7 为 1 时 DMA 控制的位 6、5 才起作用 */
556
+ #define SB_HW_KEY_DATA 0x4020
557
+ /** 发给键盘的数据 */
558
+ #define SB_HW_KEY_SEND 0x4021
559
+ /** 键盘控制:位 7 键盘时钟,位 2 允许发送完成中断,位 0 方向 */
560
+ #define SB_HW_KEY_CONTROL 0x4022
561
+ /** 位 0 选手柄 2 或鼠标 */
562
+ #define SB_HW_MOUSE_SELECT 0x4023
563
+ /** 鼠标数据 */
564
+ #define SB_HW_MOUSE_DATA 0x4024
565
+ /** 打印机数据 */
566
+ #define SB_HW_PRINTER_DATA 0x4025
567
+ /** 扩展 I/O */
568
+ #define SB_HW_EXT_IO 0x4026
569
+ /** 8 位 DAC */
570
+ #define SB_HW_DAC 0x4027
571
+ /** 初始设置:依次写 $65、$76 进入 6576 模式 */
572
+ #define SB_HW_INIT 0x4031
573
+ /** 中断屏蔽:写 1 的位被屏蔽,同时清除 HW_IRQ_PENDING 里对应的位 */
574
+ #define SB_HW_IRQ_MASK 0x4032
575
+ /** 待处理的中断(只读) */
576
+ #define SB_HW_IRQ_PENDING 0x4033
577
+ /** 定时器控制:位 7 允许,位 6 连续重载,位 5 行消隐时钟,位 3-0 预分频 */
578
+ #define SB_HW_TIMER_CONTROL 0x4034
579
+ /** 定时器预置值,写入时同时装入当前值 */
580
+ #define SB_HW_TIMER_PRESET 0x4035
581
+ /** 定时器当前值(递减) */
582
+ #define SB_HW_TIMER_CURRENT 0x4036
583
+ /** 实时时钟地址 */
584
+ #define SB_HW_RTC_ADDRESS 0x4080
585
+ /** 实时时钟数据 */
586
+ #define SB_HW_RTC_DATA 0x4081
587
+
588
+ /* 硬件寄存器:程序窗口、DMA 与显存 bank */
589
+ /** 窗口 0($8000)的页号,4K 一页 */
590
+ #define SB_HW_WINDOW_0 0x4040
591
+ /** 窗口 1($9000)的页号 */
592
+ #define SB_HW_WINDOW_1 0x4041
593
+ /** 窗口 2($A000)的页号 */
594
+ #define SB_HW_WINDOW_2 0x4042
595
+ /** 窗口 3($B000)的页号 */
596
+ #define SB_HW_WINDOW_3 0x4043
597
+ /** 窗口 4($C000)的页号 */
598
+ #define SB_HW_WINDOW_4 0x4044
599
+ /** 窗口 5($D000)的页号 */
600
+ #define SB_HW_WINDOW_5 0x4045
601
+ /** 窗口 6($E000)的页号 */
602
+ #define SB_HW_WINDOW_6 0x4046
603
+ /** 窗口 7($F000)的页号 */
604
+ #define SB_HW_WINDOW_7 0x4047
605
+ /** DMA 模式:位 7 启动,位 6 高速,位 5 目的是 CPU 地址 */
606
+ #define SB_HW_DMA_MODE 0x4048
607
+ /** DMA 源 bank:位 4 为 1 取扩展 RAM,低 4 位是源地址的第 18-15 位 */
608
+ #define SB_HW_DMA_SOURCE_BANK 0x4049
609
+ /** DMA 源地址的第 7-0 位 */
610
+ #define SB_HW_DMA_SOURCE_LOW 0x404A
611
+ /** DMA 源地址:位 6-0 是第 14-8 位,位 7 要为 1 */
612
+ #define SB_HW_DMA_SOURCE_HIGH 0x404B
613
+ /** DMA 目的地址低字节 */
614
+ #define SB_HW_DMA_DEST_LOW 0x404C
615
+ /** DMA 目的地址高字节,目的是显存时位 7 为 1 表示扩展显存 */
616
+ #define SB_HW_DMA_DEST_HIGH 0x404D
617
+ /** DMA 长度低字节,写“字节数 - 1” */
618
+ #define SB_HW_DMA_LENGTH_LOW 0x404E
619
+ /** DMA 长度高字节 */
620
+ #define SB_HW_DMA_LENGTH_HIGH 0x404F
621
+ /** 扩展显存的 32K bank */
622
+ #define SB_HW_VRAM_BANK 0x4300
623
+ /** 写 $55 回到 FC 兼容模式 */
624
+ #define SB_HW_RESET_6576 0x4301
625
+ /** 语音端口 */
626
+ #define SB_HW_VOICE_PORT 0x4302
627
+
628
+ /* 硬件寄存器的位 */
629
+ /** HW_PPU_CTRL:允许 NMI */
630
+ #define SB_HW_CTRL_NMI 0x80
631
+ /** HW_PPU_CTRL:精灵 8x16 */
632
+ #define SB_HW_CTRL_SPRITE_8X16 0x20
633
+ /** HW_PPU_CTRL:显存地址每次加 32 */
634
+ #define SB_HW_CTRL_STEP_32 0x04
635
+ /** HW_PPU_MASK:灰度 */
636
+ #define SB_HW_MASK_GRAY 0x01
637
+ /** HW_PPU_MASK:显示背景最左 8 像素 */
638
+ #define SB_HW_MASK_BG_LEFT 0x02
639
+ /** HW_PPU_MASK:显示精灵最左 8 像素 */
640
+ #define SB_HW_MASK_SPRITE_LEFT 0x04
641
+ /** HW_PPU_MASK:显示背景 */
642
+ #define SB_HW_MASK_BG 0x08
643
+ /** HW_PPU_MASK:显示精灵 */
644
+ #define SB_HW_MASK_SPRITE 0x10
645
+ /** HW_PPU_MASK:增强绿(PAL 顺序) */
646
+ #define SB_HW_MASK_TINT_GREEN 0x20
647
+ /** HW_PPU_MASK:增强红 */
648
+ #define SB_HW_MASK_TINT_RED 0x40
649
+ /** HW_PPU_MASK:增强蓝 */
650
+ #define SB_HW_MASK_TINT_BLUE 0x80
651
+ /** HW_PPU_STATUS:垂直消隐 */
652
+ #define SB_HW_STATUS_VBLANK 0x80
653
+ /** HW_PPU_STATUS:精灵 0 碰撞 */
654
+ #define SB_HW_STATUS_SPRITE0 0x40
655
+ /** HW_PPU_STATUS:一行超过 8 个精灵 */
656
+ #define SB_HW_STATUS_OVERFLOW 0x20
657
+ /** HW_PPU_EXT:背景 16 色 */
658
+ #define SB_HW_EXT_16_COLOR 0x80
659
+ /** HW_PPU_EXT:名称表从显存 $2000 起 */
660
+ #define SB_HW_EXT_NAMES_2000 0x01
661
+ /** HW_KEY_DATA(写):使能 DMA 模式的位 6、5 */
662
+ #define SB_HW_KEY_DMA_ENABLE 0x80
663
+ /** HW_DMA_MODE:启动 */
664
+ #define SB_HW_DMA_START 0x80
665
+ /** HW_DMA_MODE:高速(1.78MB/s) */
666
+ #define SB_HW_DMA_FAST 0x40
667
+ /** HW_DMA_MODE:目的是 CPU 地址(工作 RAM) */
668
+ #define SB_HW_DMA_TO_CPU 0x20
669
+ /** HW_DMA_SOURCE_BANK:源是扩展 RAM */
670
+ #define SB_HW_DMA_SOURCE_RAM 0x10
671
+ /** HW_DMA_SOURCE_HIGH:源地址的第 15 位,真机要求为 1 */
672
+ #define SB_HW_DMA_SOURCE_A15 0x80
673
+ /** HW_TIMER_CONTROL:允许 */
674
+ #define SB_HW_TIMER_ENABLE 0x80
675
+ /** HW_TIMER_CONTROL:连续重载 */
676
+ #define SB_HW_TIMER_RELOAD 0x40
677
+ /** HW_TIMER_CONTROL:基准时钟用行消隐时钟 */
678
+ #define SB_HW_TIMER_LINE_CLOCK 0x20
679
+ /** HW_IRQ_MASK、HW_IRQ_PENDING:定时器 */
680
+ #define SB_HW_IRQ_TIMER 0x80
681
+ /** 鼠标 */
682
+ #define SB_HW_IRQ_MOUSE 0x40
683
+ /** 键盘 */
684
+ #define SB_HW_IRQ_KEYBOARD 0x20
685
+ /** 中断 4 */
686
+ #define SB_HW_IRQ_4 0x10
687
+ /** 软驱 */
688
+ #define SB_HW_IRQ_FLOPPY 0x08
689
+ /** 中断 2 */
690
+ #define SB_HW_IRQ_2 0x04
691
+ /** 中断 1 */
692
+ #define SB_HW_IRQ_1 0x02
693
+
524
694
  /* 文件打开方式(FILE_MODE) */
525
695
  /** 打开已有文件 */
526
696
  #define SB_MODE_OPEN 0x00
@@ -0,0 +1,54 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb2000-timer.h
4
+ * 说明:硬件定时器($4034-$4036)与它的中断标志($4032、$4033 的位 7)。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:由 sb2000.h 引入,程序不必单独包含。DOS 用这个定时器做系统时钟(开机时控制 $EF、预置值 $3C),改动它会影响 DOS 的计时,用完要用同样的值恢复。
9
+ * 周期 = 基准周期 x (预分频 + 1) x (预置值 + 1);基准是 CPU 时钟或行消隐时钟(15625Hz)。控制字节的位见 sb2000-symbols.h 里的 SB_HW_TIMER_ 常量。
10
+ * 屏蔽与允许只改 $4032 的位 7,其余位保持 DOS 在影子里的值(写 1 的位会屏蔽该中断源并清除它的待处理标志,所以不能随便写 1,否则会丢掉已收到的键盘数据)。
11
+ * 不重载的定时器下溢一次后当前值保持预置值,不再计时,也不再置标志。行为见 docs/sb2000/03-硬件说明.md。
12
+ * ------------------------------------------------------------------------
13
+ */
14
+ #ifndef SB2000_TIMER_H
15
+ #define SB2000_TIMER_H
16
+
17
+ /**
18
+ * 设置并启动定时器:先写控制字节,再写预置值(预置值同时装入当前值)。
19
+ *
20
+ * @param control 控制字节:位 7 允许,位 6 连续重载(0 只计一次),位 5 行消隐时钟(0 是 CPU 时钟),位 3-0 预分频。
21
+ * @param preset 预置值。
22
+ */
23
+ void sb_timer_start(unsigned char control, unsigned char preset);
24
+
25
+ /**
26
+ * 停止定时器:控制字节写 0。
27
+ */
28
+ void sb_timer_stop(void);
29
+
30
+ /**
31
+ * 读定时器当前值(递减)。
32
+ *
33
+ * @return 当前值。
34
+ */
35
+ unsigned char sb_timer_current(void);
36
+
37
+ /**
38
+ * 读定时器下溢标志($4033 的位 7)。
39
+ *
40
+ * @return 1 已下溢;0 没有。
41
+ */
42
+ unsigned char sb_timer_pending(void);
43
+
44
+ /**
45
+ * 屏蔽定时器中断并清除下溢标志。
46
+ */
47
+ void sb_timer_mask(void);
48
+
49
+ /**
50
+ * 允许定时器中断:之后下溢时置标志,并产生中断(中断没有被关掉时)。
51
+ */
52
+ void sb_timer_unmask(void);
53
+
54
+ #endif
@@ -26,6 +26,9 @@
26
26
  #include "sb2000-printer.h"
27
27
  #include "sb2000-sound.h"
28
28
  #include "sb2000-math.h"
29
+ #include "sb2000-dma.h"
30
+ #include "sb2000-ppu.h"
31
+ #include "sb2000-timer.h"
29
32
 
30
33
  /**
31
34
  * 读写一个固定地址的字节,如 SB_BYTE_AT(SB_KEY_ASCII)。
Binary file
Binary file
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-dma-page-address.c
4
+ * 说明:sb_dma_page_address 的实现:扩展 RAM 的页号与偏移换算成 DMA 源地址。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:扩展 RAM 页号从 $80 起,每页 4K。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned long sb_dma_page_address(unsigned char page, unsigned int offset)
14
+ {
15
+ return ((unsigned long)(unsigned char)(page - 0x80) << 12) + offset;
16
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-dma-to-cpu.c
4
+ * 说明:sb_dma_to_cpu 的实现:用 DMA 把扩展 RAM 里的数据复制到 CPU 地址。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:真机实测目的在程序窗口($8000 以上)时写不进去,所以拒绝越过 $8000 的目的范围。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_dma_to_cpu(unsigned long source, unsigned int dest, unsigned int length)
14
+ {
15
+ if ((unsigned long)dest + length > 0x8000UL) {
16
+ return SB_ERR_BAD_PARAMETER;
17
+ }
18
+ return sbi_dma_run(SB_HW_DMA_START | SB_HW_DMA_FAST | SB_HW_DMA_TO_CPU, source, dest, length);
19
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-dma-to-vram.c
4
+ * 说明:sb_dma_to_vram 的实现:用 DMA 把扩展 RAM 里的数据复制到显存。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:模式 $C0(启动、高速、目的是显存)。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_dma_to_vram(unsigned long source, unsigned int dest, unsigned int length)
14
+ {
15
+ return sbi_dma_run(SB_HW_DMA_START | SB_HW_DMA_FAST, source, dest, length);
16
+ }
@@ -0,0 +1,34 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sbi-dma-run.c
4
+ * 说明:sbi_dma_run 的实现:启动一次通用 DMA 并等它完成。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:库内部使用;等待按 890KB/s 的速率估算,每个字节循环一次,足够 DMA 完成。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sbi_dma_run(unsigned char mode, unsigned long source, unsigned int dest, unsigned int length)
14
+ {
15
+ unsigned int last;
16
+ unsigned int wait;
17
+
18
+ if (length == 0 || length > 0x8000u) {
19
+ return SB_ERR_BAD_PARAMETER;
20
+ }
21
+ last = length - 1;
22
+ SB_BYTE_AT(SB_HW_DMA_SOURCE_BANK) = SB_HW_DMA_SOURCE_RAM | (unsigned char)((source >> 15) & 0x0F);
23
+ SB_BYTE_AT(SB_HW_DMA_SOURCE_LOW) = (unsigned char)source;
24
+ SB_BYTE_AT(SB_HW_DMA_SOURCE_HIGH) = ((unsigned char)(source >> 8) & 0x7F) | SB_HW_DMA_SOURCE_A15;
25
+ SB_BYTE_AT(SB_HW_DMA_DEST_LOW) = (unsigned char)dest;
26
+ SB_BYTE_AT(SB_HW_DMA_DEST_HIGH) = (unsigned char)(dest >> 8);
27
+ SB_BYTE_AT(SB_HW_DMA_LENGTH_LOW) = (unsigned char)last;
28
+ SB_BYTE_AT(SB_HW_DMA_LENGTH_HIGH) = (unsigned char)(last >> 8);
29
+ SB_BYTE_AT(SB_HW_DMA_MODE) = mode;
30
+ for (wait = length; wait != 0; --wait) {
31
+ __asm__("nop");
32
+ }
33
+ return 0;
34
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-address.c
4
+ * 说明:sb_ppu_address 的实现:设置显存地址。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:先读一次 $2002 复位地址锁存,再依次写高、低字节。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_address(unsigned int address)
14
+ {
15
+ unsigned char sink = SB_BYTE_AT(SB_HW_PPU_STATUS);
16
+
17
+ (void)sink;
18
+ SB_BYTE_AT(SB_HW_PPU_ADDRESS) = (unsigned char)(address >> 8);
19
+ SB_BYTE_AT(SB_HW_PPU_ADDRESS) = (unsigned char)address;
20
+ }
@@ -0,0 +1,19 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-fill.c
4
+ * 说明:sb_ppu_fill 的实现:把显存的一段填成同一个值。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:要求显示已关。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_fill(unsigned int address, unsigned char value, unsigned int count)
14
+ {
15
+ sb_ppu_address(address);
16
+ while (count-- != 0) {
17
+ SB_BYTE_AT(SB_HW_PPU_DATA) = value;
18
+ }
19
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-oam-clear.c
4
+ * 说明:sb_ppu_oam_clear 的实现:把精灵 RAM 填成 $F0。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:Y 为 $F0 的精灵在屏幕之外。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_oam_clear(void)
14
+ {
15
+ unsigned int i;
16
+
17
+ SB_BYTE_AT(SB_HW_OAM_ADDRESS) = 0;
18
+ for (i = 0; i < 256; ++i) {
19
+ SB_BYTE_AT(SB_HW_OAM_DATA) = 0xF0;
20
+ }
21
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-oam-put.c
4
+ * 说明:sb_ppu_oam_put 的实现:写一个精灵。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:一个精灵 4 字节:Y、图块号、属性、X。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_oam_put(unsigned char index, unsigned char y, unsigned char tile, unsigned char attr, unsigned char x)
14
+ {
15
+ SB_BYTE_AT(SB_HW_OAM_ADDRESS) = (unsigned char)(index << 2);
16
+ SB_BYTE_AT(SB_HW_OAM_DATA) = y;
17
+ SB_BYTE_AT(SB_HW_OAM_DATA) = tile;
18
+ SB_BYTE_AT(SB_HW_OAM_DATA) = attr;
19
+ SB_BYTE_AT(SB_HW_OAM_DATA) = x;
20
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-palette-get.c
4
+ * 说明:sb_ppu_palette_get 的实现:读调色板的一项。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:真机读调色板得到“值 & $3F | $40”,所以去掉位 6。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_ppu_palette_get(unsigned char index)
14
+ {
15
+ return SB_BYTE_AT(SB_HW_PALETTE + index) & 0x3F;
16
+ }
@@ -0,0 +1,16 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-palette-set.c
4
+ * 说明:sb_ppu_palette_set 的实现:写调色板的一项。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:调色板在 $2040 起,共 64 项。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_palette_set(unsigned char index, unsigned char color)
14
+ {
15
+ SB_BYTE_AT(SB_HW_PALETTE + index) = color;
16
+ }
@@ -0,0 +1,22 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-peek.c
4
+ * 说明:sb_ppu_peek 的实现:读显存的一个字节。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:真机与模拟器上都是:设地址后第一次读只刷新缓冲,重设地址后第二次读才是内容。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_ppu_peek(unsigned int address)
14
+ {
15
+ unsigned char sink;
16
+
17
+ sb_ppu_address(address);
18
+ sink = SB_BYTE_AT(SB_HW_PPU_DATA);
19
+ (void)sink;
20
+ sb_ppu_address(address);
21
+ return SB_BYTE_AT(SB_HW_PPU_DATA);
22
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-read.c
4
+ * 说明:sb_ppu_read 的实现:读一段显存。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:逐字节用 sb_ppu_peek 读。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_read(unsigned int address, unsigned char *dest, unsigned int count)
14
+ {
15
+ unsigned int i;
16
+
17
+ for (i = 0; i < count; ++i) {
18
+ dest[i] = sb_ppu_peek(address + i);
19
+ }
20
+ }
@@ -0,0 +1,20 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-render.c
4
+ * 说明:sb_ppu_render 的实现:设置控制寄存器并打开显示。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:最后才写 $2001,显示从这里开始。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_render(unsigned char mask, unsigned char control, unsigned char ext)
14
+ {
15
+ SB_BYTE_AT(SB_HW_PPU_CTRL) = control;
16
+ SB_BYTE_AT(SB_HW_PPU_EXT) = ext;
17
+ SB_BYTE_AT(SB_HW_PPU_SCROLL) = 0;
18
+ SB_BYTE_AT(SB_HW_PPU_SCROLL) = 0;
19
+ SB_BYTE_AT(SB_HW_PPU_MASK) = mask;
20
+ }
@@ -0,0 +1,25 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-wait-vblank.c
4
+ * 说明:sb_ppu_wait_vblank 的实现:等垂直消隐。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:轮询 $2002,读一次就会清掉垂直消隐位;最多读 65535 次,避免显示关闭时一直等。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ unsigned char sb_ppu_wait_vblank(void)
14
+ {
15
+ unsigned int n;
16
+ unsigned char status;
17
+
18
+ for (n = 0; n != 0xFFFFu; ++n) {
19
+ status = SB_BYTE_AT(SB_HW_PPU_STATUS);
20
+ if (status & SB_HW_STATUS_VBLANK) {
21
+ return status;
22
+ }
23
+ }
24
+ return 0;
25
+ }
@@ -0,0 +1,21 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:sb-ppu-write.c
4
+ * 说明:sb_ppu_write 的实现:把一段数据写进显存。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-13
8
+ * 备注:要求显示已关;地址设一次,之后靠 $2007 的自动加 1。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #include "../sb-internal.h"
12
+
13
+ void sb_ppu_write(unsigned int address, const unsigned char *data, unsigned int count)
14
+ {
15
+ unsigned int i;
16
+
17
+ sb_ppu_address(address);
18
+ for (i = 0; i < count; ++i) {
19
+ SB_BYTE_AT(SB_HW_PPU_DATA) = data[i];
20
+ }
21
+ }
@@ -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
+ }