fcdev 0.7.0 → 0.8.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.
- package/CHANGELOG.md +15 -0
- package/README.md +9 -8
- package/docs/{02- → 01-}/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +10 -8
- package/docs/{05- → 02-}/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +12 -22
- package/docs/{06- → 03-}/345/217/215/346/261/207/347/274/226.md +12 -46
- package/docs/{07- → 04-}/345/210/233/345/273/272/345/214/205/344/270/216/346/250/241/346/235/277.md +1 -15
- package/docs/nes/{01-NES/347/233/256/346/240/207.md → 01-/345/274/200/345/217/221/346/214/207/345/215/227.md} +4 -9
- package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +21 -26
- package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md +4 -4
- package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +5 -5
- package/package.json +3 -3
- package/src/build/bank-link-config.mjs +1 -1
- package/src/build/build-plan.mjs +1 -1
- package/src/build/program-builder.mjs +10 -5
- package/src/build/source-charset.mjs +111 -0
- package/src/cli/commands/docs-command.mjs +2 -2
- package/src/cli/index.mjs +1 -1
- package/src/config/config-loader.mjs +1 -1
- package/src/docs/doc-index.mjs +1 -1
- package/src/docs/doc-topics.mjs +9 -15
- package/src/docs/index.mjs +1 -1
- package/src/emulator/sb2000-session.mjs +15 -12
- package/src/targets/target-registry.mjs +9 -1
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/sb2000/api-reference.md +2 -1
- package/targets/sb2000/examples-source.md +1330 -0
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/symbols-reference.md +670 -0
- package/targets/sb2000/target.json +1 -0
- package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -164
- package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +0 -123
- package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +0 -50
- package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +0 -75
- package/docs/09-/345/217/221/345/270/203.md +0 -75
- package/docs/10-VS Code/346/211/251/345/261/225.md" +0 -131
- package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +0 -50
- package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +0 -10
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# SB2000 硬件说明
|
|
2
2
|
|
|
3
|
-
本文是 SB2000(小霸王学生电脑)硬件行为的结论,来源有三类:芯片手册(SH6578
|
|
3
|
+
本文是 SB2000(小霸王学生电脑)硬件行为的结论,来源有三类:芯片手册(SH6578 官方手册,下称“芯片手册”)、模拟器源码与实际运行观察、真机实测(内存测试程序 `memtest`,2026-11-12;硬件测试程序 `hwtest`,2026-11-13,真机为 PAL 制式)。SB2000 的真机芯片是 UM6576,芯片手册是 SH6578,两颗芯片有差别,两者不一致时以真机实测为准。“已确认”指来自模拟器源码或实际运行;没有写“真机”的结论都没有在真机上测过。模拟器已按真机实测修改内部 RAM、`$4400-$5FFF`、DMA、定时器与图形端口(见对应行),memtest、hwtest 在模拟器里的结果与真机一致(仍有差异的项见“真机与模拟器仍有差异的行为”一行);模拟器与芯片手册不一致、也没有真机数据的地方,在对应行里写明。程序接口见 [系统调用手册](02-系统调用手册.md)。
|
|
4
4
|
|
|
5
5
|
| 项目 | 结论 | 状态 |
|
|
6
6
|
| --- | --- | --- |
|
|
7
7
|
| CPU | 标准 6502(含非官方指令),不是新指令集;“6576”是向 `$4031` 依次写入 `$65`、`$76`(芯片手册称这一步为初始设置)之后的工作模式 | 已确认 |
|
|
8
8
|
| 进入 6576 模式 | 依次向 `$4031` 写入 `$65`、`$76`;BIOS 启动后自行完成。芯片手册要求两次写入在两个指令周期内连续完成(`LDA #$65 / LDX #$76 / STA $4031 / STX $4031`),模拟器只按顺序识别,不检查间隔 | 已确认(芯片手册、模拟器源码) |
|
|
9
|
-
| 返回 FC 兼容模式 | 向 `$4301` 写 `$55`:复位 6576、`RAM 启动`,`$8000` 以上改走 MMC3
|
|
9
|
+
| 返回 FC 兼容模式 | 向 `$4301` 写 `$55`:复位 6576、`RAM 启动`,`$8000` 以上改走 MMC3 仿真;Ember 已实现,并能用“游戏集锦”软盘进入游戏 | 已确认 |
|
|
10
10
|
| 程序窗口 | `$4040-$4047` 各选一个 4K 页,对应 `$8000-$FFFF` 的 8 个窗口;值小于 `$80` 是 BIOS ROM 页(512KB,共 128 页),不小于 `$80` 是扩展 RAM 页(512KB) | 已确认 |
|
|
11
11
|
| 启动后的窗口 | `$C000-$FFFF` 固定为 ROM 第 4-7 页,`$8000-$BFFF` 由 BIOS 换页 | 已确认 |
|
|
12
12
|
| 向量 | NMI `$C084`,RESET `$C000`,IRQ `$C12B`(ROM 偏移 `$7FFA` 起) | 已确认 |
|
|
@@ -16,17 +16,17 @@
|
|
|
16
16
|
| 键盘 | 经 `$4020-$4022` 串行收发。芯片手册:键盘口收发 AT 键盘的 11 位串行帧(起始位、8 位扫描码、奇偶位、停止位),收完整帧后产生键盘中断,要在下一位到来前读走 `$4020` 里的扫描码;`$4022` 位 7 是键盘时钟 CLK(接收时必须保持 1,BIOS 处理完一个码后写 `$80`),位 2 允许“发送命令完成”中断,位 0 是方向(0 为键盘到系统,1 为系统到键盘);发送时先把数据写入 `$4021`,再置位 0 为 1、CLK 拉低大于 60ms 后拉高,硬件自动发出。模拟器直接给出与 DirectInput 的 DIK 值一致的扫描码(即 IBM 码集 1 的按下码),在 CLK 上升沿且位 0 为 1 时把 `$4021` 发给键盘;真机键盘实际是否按此工作没有测过;BIOS 初始化键盘时(功能 `$17`)会发 `$F0`、`$01` 选择扫描码集 1 | 已确认(芯片手册、模拟器源码) |
|
|
17
17
|
| 显存 | 512KB,经 `$4300` 选 32KB 的 bank | 已确认 |
|
|
18
18
|
| 中断屏蔽与状态 | `$4032` 读写屏蔽寄存器:写入值中为 1 的位屏蔽(禁止)该中断源,同时把 `$4033` 里对应的待处理标志清除(`$4033 &= ~写入值`),为 0 的位允许该中断源。位 7 定时器、位 6 鼠标、位 5 键盘、位 4 INT4(芯片手册:实时时钟)、位 3 软驱、位 2 INT2(芯片手册:打印机的 IRQ2)、位 1 INT1(芯片手册:φ 使能的 IRQ1),位 0 未用,复位时为 `$FF`(全部屏蔽);`$4033` 只读,位含义相同,为 1 表示该源有待处理中断。BIOS 为位 4、2、1 各留了钩子,模拟器里没有设备置位它们 | 已确认(芯片手册、模拟器源码) |
|
|
19
|
-
| 鼠标 | `$4023` 位 0 选手柄 2 或鼠标(1 为鼠标);真机实测(`hwprobe`):读回是 `$80
|
|
19
|
+
| 鼠标 | `$4023` 位 0 选手柄 2 或鼠标(1 为鼠标);真机实测(`hwprobe`):读回是 `$80 \| 位 0`,位 7 是输入线(闲置为 1),位 6-1 读 0;鼠标数据经 `$4024` 读,是微软串口鼠标的 3 字节包。复位信号:BIOS(功能 `$14`)与模拟器都用 `$4026` 的位 1(EIO1),拉低再拉高,模拟器在上升沿发 RTS。芯片手册在鼠标一节把复位信号写作 `$4026` 的 D2,在扩展 I/O 一节又写 EIO1 产生鼠标复位,两处说法不一致,这里按 BIOS 与模拟器的用法,真机没有核实;手册要求复位时间大于 30ms,并可写 `$4024` 设置波特率(NTSC 为 `$A3`、PAL/B 为 `$A9`),BIOS 没有写它 | 已确认(芯片手册、模拟器源码、BIOS 代码);复位位的说法见左 |
|
|
20
20
|
| 定时器 | `$4034` 控制:位 7 允许,位 6 连续重载(0 只计一次),位 5 基准时钟(0 为 CPU 时钟,1 为行消隐时钟 15625Hz),位 3-0 为预分频 PS;`$4035` 写预置值 TP,同时装入当前值;`$4036` 读当前值(递减)。周期 = 基准周期 × (PS + 1) × (TP + 1),下溢时置 `$4033` 位 7(`$4032` 位 7 为 0 才产生中断)。真机实测:`$4035` 可读(读回写入的预置值);一次计时(位 6 为 0)下溢一次后,当前值保持预置值,不再计时,也不再置中断标志,模拟器已对齐(旧版把当前值置 0);真机一帧是 PAL 的 50Hz,120 帧内的下溢次数:BIOS 的设置与行消隐时钟两组模拟器与真机相同(38、147),CPU 时钟那组真机 1040 次、模拟器 1038 次。BIOS 开机设 `$4034=$EF`、`$4035=$3C`(连续、行消隐时钟、PS=15、TP=60,周期 64µs × 16 × 61 约 62.5ms,即约 16Hz),用作软件时钟的节拍;播放 WAV 时用 `$4034=$C0`(CPU 时钟、PS=0),`$4035` 取 `$28`、`$51`、`$A2` 作采样节拍 | 已确认(芯片手册、模拟器源码;开机后的寄存器值已在模拟器里读出);`$4035` 可读与一次计时的行为为真机实测 |
|
|
21
21
|
| 声音 | 芯片手册:4 通道 PSG,通道 1、2 方波,通道 3 三角波,通道 4 噪声,寄存器为 `$4000-$4003`、`$4004-$4007`、`$4008`、`$400A`、`$400B`、`$400C`、`$400E`、`$400F`,`$4015` 低 4 位依次使能通道 1-4;没有定义 NES 的 DMC 寄存器 `$4010-$4013`,语音改用 `$4027` 的 DAC 输出。BIOS 的声音引擎在 RAM 里维护这些寄存器的影子,再写到芯片(见 [系统调用手册](02-系统调用手册.md) 5.5 节) | 芯片手册 |
|
|
22
22
|
| DAC | `$4027` 是 8 位 DAC,输出语音(PCM)。芯片手册:实际输出发生在定时器溢出时,所以使用 DAC 必须同时设置定时器;输出带约 1/2 Vcc 的直流偏置,输出语音前要把电平从 0 缓慢升到偏置值,否则开始时有“噗”声。BIOS 播放 WAV 时写它(`$65/$0C`) | 芯片手册;BIOS 的用法已验证 |
|
|
23
23
|
| 实时时钟 | 芯片手册:`$4080` 写 RTC 地址,`$4081` 读写 RTC 数据,使用前先设地址。SB2000 的 BIOS 不访问它们,系统时钟由定时器中断软件计时;模拟器的 `$4026` 位 0(EIO0)没有接 RTC | 芯片手册;BIOS 没有使用 |
|
|
24
|
-
| 图形端口 | 寄存器 `$2000-$2008` 与调色板 `$2040-$207F`。`$2000`:位 7 允许 NMI,位 5 精灵 8×16,位 2 地址增量(0 加 1,1 加 32),位 1-0 背景页;`$2001`:位 0 黑白,位 1、2 屏蔽背景、精灵最左 8 个像素,位 3、4 背景、精灵显示,位 7-5 红绿蓝增强;`$2002` 读:位 7 垂直消隐,位 6 精灵与背景碰撞,位 5 一行超过 8 个精灵;`$2008`:位 7 背景 4 色(0)或 16 色(1),位 3-2 精灵图案表起始,位 0 名称表起始(为 1 时名称表在显存 `$2000-$27FF`,只能显示一页)。名称表项 2 字节,高 4 位是调色板组,低 12 位是图案号;调色板 64 项,每项低 4 位颜色、位 5-4 亮度。显存、调色板、精灵 RAM 只能在垂直消隐期间或显示关闭时更新,精灵用 `$4014` 的 DMA 更新。BIOS 功能 `$10` 修改的就是这些位(见 [系统调用手册](02-系统调用手册.md) 5.7 节)。真机实测(`hwtest`,与芯片手册不一致的地方以真机为准):① `$2001` 位 1、2 的极性与 NES 相同,为 1 表示显示最左 8 个像素,为 0 表示屏蔽(芯片手册写反,BIOS 影子初值 `$0E` 即两位都显示);位 0 为 1 时黑白,背景底色也变灰;位 5 增强绿、位 6 增强红、位 7 增强蓝(PAL 顺序,芯片手册写位 5 蓝、位 6 绿、位 7 红)。② 精灵属性位 6 为水平镜像,位 7 为垂直翻转,位 5 为 1 表示在背景之后(只被不透明的背景像素盖住);读回 OAM 时属性字节的位 4-2 恒为 1(写 `FF` 读 `FF`,写 `00` 读 `1C`),不跟地址、也不跟最后写的 PPU 端口走;早先的两次 `hwtest` 曾读到 `E3`、`F3`,用现在的程序复现不了,原因不明。③ `$2000` 位 1-0 选 4 个互相独立的名称表;`$2008` 位 0 为 1 时名称表从 `$2000` 起;8×16 精灵的图案号最低位被忽略(相邻的偶数号、奇数号显示同一对图块),上半取偶数号。④ 调色板每项低 4 位是色相、位 5-4 是亮度,与芯片手册相同,16 色模式可用;读调色板得到 `(值 & $3F)
|
|
24
|
+
| 图形端口 | 寄存器 `$2000-$2008` 与调色板 `$2040-$207F`。`$2000`:位 7 允许 NMI,位 5 精灵 8×16,位 2 地址增量(0 加 1,1 加 32),位 1-0 背景页;`$2001`:位 0 黑白,位 1、2 屏蔽背景、精灵最左 8 个像素,位 3、4 背景、精灵显示,位 7-5 红绿蓝增强;`$2002` 读:位 7 垂直消隐,位 6 精灵与背景碰撞,位 5 一行超过 8 个精灵;`$2008`:位 7 背景 4 色(0)或 16 色(1),位 3-2 精灵图案表起始,位 0 名称表起始(为 1 时名称表在显存 `$2000-$27FF`,只能显示一页)。名称表项 2 字节,高 4 位是调色板组,低 12 位是图案号;调色板 64 项,每项低 4 位颜色、位 5-4 亮度。显存、调色板、精灵 RAM 只能在垂直消隐期间或显示关闭时更新,精灵用 `$4014` 的 DMA 更新。BIOS 功能 `$10` 修改的就是这些位(见 [系统调用手册](02-系统调用手册.md) 5.7 节)。真机实测(`hwtest`,与芯片手册不一致的地方以真机为准):① `$2001` 位 1、2 的极性与 NES 相同,为 1 表示显示最左 8 个像素,为 0 表示屏蔽(芯片手册写反,BIOS 影子初值 `$0E` 即两位都显示);位 0 为 1 时黑白,背景底色也变灰;位 5 增强绿、位 6 增强红、位 7 增强蓝(PAL 顺序,芯片手册写位 5 蓝、位 6 绿、位 7 红)。② 精灵属性位 6 为水平镜像,位 7 为垂直翻转,位 5 为 1 表示在背景之后(只被不透明的背景像素盖住);读回 OAM 时属性字节的位 4-2 恒为 1(写 `FF` 读 `FF`,写 `00` 读 `1C`),不跟地址、也不跟最后写的 PPU 端口走;早先的两次 `hwtest` 曾读到 `E3`、`F3`,用现在的程序复现不了,原因不明。③ `$2000` 位 1-0 选 4 个互相独立的名称表;`$2008` 位 0 为 1 时名称表从 `$2000` 起;8×16 精灵的图案号最低位被忽略(相邻的偶数号、奇数号显示同一对图块),上半取偶数号。④ 调色板每项低 4 位是色相、位 5-4 是亮度,与芯片手册相同,16 色模式可用;读调色板得到 `(值 & $3F) \| $40`。⑤ `$2002` 位 6(精灵 0 碰撞)、位 5(一行超过 8 个精灵)有效,低 5 位是最后一次写 PPU 总线的值。模拟器的 UM6576 PPU(`PPU_UM6576.cpp`)已按以上实测实现;颜色的亮度与饱和度渲染与真机电视的差别没有对齐,不影响程序行为 | 芯片手册;位的作用为真机实测(`hwtest`),模拟器已对齐 |
|
|
25
25
|
| 空读(没有器件驱动的位) | 真机实测:读到 CPU 数据总线上最近的一个值,读指令里的地址高字节就是总线最近的值,所以 `$203F`、`$2080` 读 `$20`,`$4018`、`$4019`、`$401F` 读 `$40`;`$4016`、`$4017` 的位 6 也是这个原因;`$2009` 读 `$00`。模拟器(UM6576 模式)记录总线最近的值,空读时返回它,零页间接寻址(`(zp),Y`)读到的是指针高字节,堆栈不记录;`$200A-$203F`、`$2080-$3FFE`、`$4018-$401F` 按这个规则处理,其中只有 `$203F`、`$2080`、`$4018`、`$4019`、`$401F` 在真机上测过 | 真机实测(`hwtest`);模拟器已对齐 |
|
|
26
26
|
| 实时时钟 | 真机实测:`$4081` 不论有没有设地址,读出的都是 `$60`;模拟器读出 `$60` | 真机实测(`hwtest`);模拟器已对齐 |
|
|
27
27
|
| 真机与模拟器仍有差异的行为 | `hwtest` 在真机上测到、模拟器没有对齐的项目(程序不应依赖这些值)。真机读数:`$3FFF` 为 `$68`(模拟器读 `$00`,原因不明),`$4037` 两次实测分别为 `$A0`、`$E0`(不固定);`$4015` 写 `$FF` 后读出位 4 为 1、写 `$1F` 后读出位 4 为 0(模拟器反过来);`$4022` 开机值 `$C0`(模拟器为 `$80`;写入后的读回还没有真机数据);`$4026` 读出 `$3F`(位 4 为 1,模拟器按虚拟打印机固定为 `$2F`);`$4016` 读出 `$44`、`$4017` 读出 `$40`(模拟器为 `$40`、`$48`);`$4033` 位 6 在清除后仍为 1(鼠标待处理,没接鼠标时的真机状态,模拟器为 0)。`$4036` 运行中的当前值取决于读取时刻,通用 DMA 在 `$8010` 起的采样取决于源 RAM 里原来的内容,`$4015` 位 4 取决于读取时刻(同一个写入值两遍读回不同,像 DMC 的活动状态位),模拟器用的是同类逻辑,无法逐值比对;`$4023` 位 7 在 `hwprobe` 里一直为 1(`hwtest` 报告里“写 1、写 0 后读到 `01`、`00`”是编译器省掉了写后的回读,不是真机值,`$4022` 写后的“读回”也一样,只有测前的值是真读),模拟器按 1 处理 | 真机实测(`hwtest`);模拟器没有对齐 |
|
|
28
28
|
| 并口打印机 | 模拟器实现了 Epson ESC/P 虚拟打印机(`LPT.cpp`)。数据写 `$4025`;写 `$4016` 的位 0 为 #选中打印机、位 1 为 #换行、位 2 为复位;写 `$4026` 的位 2 为 #选通(strobe);读 `$4017` 位 2 为出错、位 3 为 #忙;读 `$4026` 位 3、4、5 依次是应答、缺纸、已选中(模拟器里状态固定为“不忙、已应答、有纸、已选中、无错”)。芯片手册只定义了 `$4016` 的位 1、0(OUT1、OUT0)、`$4017` 的位 0、`$4025`(数据寄存器,写入时产生选通)与 `$4026`(EIO7-EIO0);这里 `$4016` 位 2、`$4017` 位 2、3 的用法来自模拟器源码的注释,芯片手册没有定义,真机没有核实。收到 `ESC @`(`$1B $40`)开始一页,弹出“Print to...”对话框,可选系统打印机或输出 PDF、PNG 文件;收到换页 `$0C`、复位或约 6 秒没有数据就结束这一页 | 已确认(模拟器源码) |
|
|
29
|
-
| 语音端口 `$4302` | 读:位 7 为 1 表示可以接收下一个字节(缓冲未满),语音播完时低 4 位为 `$F`。写:把一个语音数据字节送进环形缓冲,由模拟器的 LPC
|
|
29
|
+
| 语音端口 `$4302` | 读:位 7 为 1 表示可以接收下一个字节(缓冲未满),语音播完时低 4 位为 `$F`。写:把一个语音数据字节送进环形缓冲,由模拟器的 LPC 语音合成器解码播放(Ember 里是 `speech-lpc` 模块,缓冲 15 字节)。`$4026` 位 6 的上升沿复位语音(清缓冲)。BIOS 的 `$74`、`$75`(`API_74_PORT4302_CONTROL`、`API_75_PORT4302_SEND`)就是操作它 | 已确认(模拟器源码);`$74`、`$75` 的发送序列与“播完”结束都已实测(见 [系统调用手册](02-系统调用手册.md) 5.13 节);模拟器曾缺 `case 0x4302:`,已修复 |
|
|
30
30
|
|
|
31
31
|
## 软件环境
|
|
32
32
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fcdev",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "6502 兼容机(NES、学习机等)的开发工具:用 cc65 构建 C 与汇编程序",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "sungbin <sungbin@3578.cn>",
|
|
@@ -31,9 +31,9 @@
|
|
|
31
31
|
"targets"
|
|
32
32
|
],
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"ember-debug-sdk": "0.
|
|
34
|
+
"ember-debug-sdk": "0.8.0"
|
|
35
35
|
},
|
|
36
36
|
"optionalDependencies": {
|
|
37
|
-
"fcdev-cc65": "0.
|
|
37
|
+
"fcdev-cc65": "0.8.0"
|
|
38
38
|
}
|
|
39
39
|
}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// 邮箱:sungbin@3578.cn
|
|
6
6
|
// 日期:2026-11-11
|
|
7
7
|
// 备注:模板里写固定的部分与库页 generatedFrom 之前的库页,%BANK_MEMORY% 与 %BANK_SEGMENTS% 两行分别展开成
|
|
8
|
-
// 库页 generatedFrom 到 N
|
|
8
|
+
// 库页 generatedFrom 到 N 的内存区与段;定义见仓库根目录 docs/02-目标规范.md 第 2 节的 banked。
|
|
9
9
|
// ------------------------------------------------------------------------
|
|
10
10
|
import { readFileSync, writeFileSync } from 'node:fs';
|
|
11
11
|
import path from 'node:path';
|
package/src/build/build-plan.mjs
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
// 作者:sungbin
|
|
5
5
|
// 邮箱:sungbin@3578.cn
|
|
6
6
|
// 日期:2026-11-10
|
|
7
|
-
// 备注:规则见 docs/
|
|
7
|
+
// 备注:规则见 packages/fcdev/docs/01-命令行与构建.md 第 2 节:无参数为当前目录;目录整体构成一个程序;文件单独构成一个程序。
|
|
8
8
|
// ------------------------------------------------------------------------
|
|
9
9
|
import { statSync } from 'node:fs';
|
|
10
10
|
import path from 'node:path';
|
|
@@ -16,6 +16,7 @@ import { resolveTargetPath } from '../targets/index.mjs';
|
|
|
16
16
|
import { getToolchainVersion, runTool } from '../toolchain/index.mjs';
|
|
17
17
|
import { resolveLinkSetup } from './bank-link-config.mjs';
|
|
18
18
|
import { parseDependencyFile } from './dependency-file.mjs';
|
|
19
|
+
import { prepareGb2312Source } from './source-charset.mjs';
|
|
19
20
|
import { getSourceLanguage } from './source-collector.mjs';
|
|
20
21
|
import { buildAssemblerArguments, buildCompilerArguments, buildLinkerArguments } from './tool-arguments.mjs';
|
|
21
22
|
|
|
@@ -130,14 +131,18 @@ function describeToolFailure(output) {
|
|
|
130
131
|
* @returns {Promise<void>}
|
|
131
132
|
*/
|
|
132
133
|
async function compileSource(context, source, objectFile) {
|
|
133
|
-
const { toolchain, settings,
|
|
134
|
+
const { toolchain, settings, sourceCharset } = context;
|
|
134
135
|
const base = objectFile.slice(0, -'.o'.length);
|
|
135
|
-
|
|
136
|
+
const language = getSourceLanguage(source);
|
|
137
|
+
// 目标声明了源文件编码时,编译的是转码后的副本,工具输出里的副本路径要换回原文件
|
|
138
|
+
const prepared = sourceCharset ? prepareGb2312Source({ source, base, language }) : { file: source, restoreText: (text) => text };
|
|
139
|
+
const reporter = { ...context.reporter, write: (text) => context.reporter.write(prepared.restoreText(text)) };
|
|
140
|
+
if (language === 'c') {
|
|
136
141
|
const asmFile = `${base}.s`;
|
|
137
|
-
await runChecked(toolchain, 'cc65', buildCompilerArguments(settings, { source, output: asmFile, dependencyFile: `${base}.d` }), reporter, `编译失败:${source}`);
|
|
142
|
+
await runChecked(toolchain, 'cc65', buildCompilerArguments(settings, { source: prepared.file, output: asmFile, dependencyFile: `${base}.d` }), reporter, `编译失败:${source}`);
|
|
138
143
|
await runChecked(toolchain, 'ca65', buildAssemblerArguments(settings, { source: asmFile, output: objectFile, dependencyFile: `${base}.asm.d` }), reporter, `汇编失败:${asmFile}`);
|
|
139
144
|
} else {
|
|
140
|
-
await runChecked(toolchain, 'ca65', buildAssemblerArguments(settings, { source, output: objectFile, dependencyFile: `${base}.d` }), reporter, `汇编失败:${source}`);
|
|
145
|
+
await runChecked(toolchain, 'ca65', buildAssemblerArguments(settings, { source: prepared.file, output: objectFile, dependencyFile: `${base}.d` }), reporter, `汇编失败:${source}`);
|
|
141
146
|
}
|
|
142
147
|
}
|
|
143
148
|
|
|
@@ -172,7 +177,7 @@ export async function buildProgram(plan, toolchain, reporter = SILENT_REPORTER)
|
|
|
172
177
|
ensureDirectory(plan.objectDir);
|
|
173
178
|
}
|
|
174
179
|
|
|
175
|
-
const context = { toolchain, settings, reporter };
|
|
180
|
+
const context = { toolchain, settings, reporter, sourceCharset: target.sourceCharset };
|
|
176
181
|
const objects = [];
|
|
177
182
|
let compiled = 0;
|
|
178
183
|
let reused = 0;
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:source-charset.mjs
|
|
3
|
+
// 说明:源文件转码:目标声明了 sourceCharset 时,编译前把 UTF-8 的 C 与汇编源文件转成目标机器用的编码,写成副本交给编译器。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-18
|
|
7
|
+
// 备注:目前只有 GB2312(学习机的字库按它取字模)。GB2312 的第二个字节不小于 0xA1,不会和 ASCII 的反斜杠、引号冲突,所以注释与字符串里的汉字都能整体转换;
|
|
8
|
+
// 文件不是合法的 UTF-8 时视为已经是目标编码,原样使用;机器字库没有的字符(GB2312 之外)报错,指出文件、行、列;
|
|
9
|
+
// 编码表用 Node 自带的 gb18030 解码器反推,不引入依赖;C 副本开头加 #line 指令,让错误信息与调试信息仍指向原文件,汇编靠替换工具输出里的文件名。
|
|
10
|
+
// ------------------------------------------------------------------------
|
|
11
|
+
import { readFileSync, writeFileSync } from 'node:fs';
|
|
12
|
+
import path from 'node:path';
|
|
13
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
14
|
+
|
|
15
|
+
/** GB2312 的区:1-9 区是符号,16-87 区是汉字,对应第一个字节 */
|
|
16
|
+
const GB2312_LEAD_BYTES = [[0xa1, 0xa9], [0xb0, 0xf7]];
|
|
17
|
+
|
|
18
|
+
/** 反推出的编码表:Unicode 码点到两个字节(高字节在前);第一次用到时才建立 */
|
|
19
|
+
let gb2312Table = null;
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* 取得 GB2312 编码表。
|
|
23
|
+
* @returns {Map<number, number>} 码点到内码(高 8 位是第一个字节)
|
|
24
|
+
* @throws {FcdevError} 当前的 Node 没有 GB 系列解码器
|
|
25
|
+
*/
|
|
26
|
+
function getGb2312Table() {
|
|
27
|
+
if (gb2312Table !== null) return gb2312Table;
|
|
28
|
+
let decoder;
|
|
29
|
+
try {
|
|
30
|
+
decoder = new TextDecoder('gb18030');
|
|
31
|
+
} catch {
|
|
32
|
+
throw new FcdevError('当前的 Node 不支持 GB2312 解码,无法转换源文件编码', { code: 'CHARSET_UNSUPPORTED', hint: '使用带完整国际化数据的 Node 22 或更高版本,或把源文件另存为 GB2312' });
|
|
33
|
+
}
|
|
34
|
+
const table = new Map();
|
|
35
|
+
for (const [first, last] of GB2312_LEAD_BYTES) {
|
|
36
|
+
for (let lead = first; lead <= last; lead += 1) {
|
|
37
|
+
for (let trail = 0xa1; trail <= 0xfe; trail += 1) {
|
|
38
|
+
if (lead === 0xd7 && trail >= 0xfa) continue; // 87 区只到 0xD7F9,后面是 GBK 扩展
|
|
39
|
+
const text = decoder.decode(Uint8Array.of(lead, trail));
|
|
40
|
+
const [char, ...rest] = text;
|
|
41
|
+
if (char !== undefined && rest.length === 0 && char !== '\uFFFD') table.set(char.codePointAt(0), (lead << 8) | trail);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
gb2312Table = table;
|
|
46
|
+
return table;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* 把 UTF-8 文本转成 GB2312 字节;不是合法 UTF-8 的内容原样返回。
|
|
51
|
+
* @param {Buffer} buffer 源文件内容
|
|
52
|
+
* @param {string} label 出错提示里用的文件名
|
|
53
|
+
* @returns {Buffer} 转换后的内容
|
|
54
|
+
* @throws {FcdevError} 有字符不在 GB2312 里
|
|
55
|
+
*/
|
|
56
|
+
export function convertToGb2312(buffer, label) {
|
|
57
|
+
let text;
|
|
58
|
+
try {
|
|
59
|
+
text = new TextDecoder('utf-8', { fatal: true }).decode(buffer);
|
|
60
|
+
} catch {
|
|
61
|
+
return buffer;
|
|
62
|
+
}
|
|
63
|
+
const bytes = [];
|
|
64
|
+
let table = null;
|
|
65
|
+
let line = 1;
|
|
66
|
+
let column = 0;
|
|
67
|
+
for (const char of text) {
|
|
68
|
+
column += char.length;
|
|
69
|
+
const code = char.codePointAt(0);
|
|
70
|
+
if (code < 0x80) {
|
|
71
|
+
bytes.push(code);
|
|
72
|
+
if (code === 0x0a) {
|
|
73
|
+
line += 1;
|
|
74
|
+
column = 0;
|
|
75
|
+
}
|
|
76
|
+
continue;
|
|
77
|
+
}
|
|
78
|
+
table ??= getGb2312Table();
|
|
79
|
+
const mapped = table.get(code);
|
|
80
|
+
if (mapped === undefined) {
|
|
81
|
+
const unicode = `U+${code.toString(16).toUpperCase().padStart(4, '0')}`;
|
|
82
|
+
throw new FcdevError(`${label}:${line}:${column - char.length + 1}:字符“${char}”(${unicode})不在 GB2312 里,学习机的字库显示不了`, {
|
|
83
|
+
code: 'SOURCE_CHAR_UNSUPPORTED',
|
|
84
|
+
hint: '改用 GB2312 里有的字,或用 \\x 转义写字节',
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
bytes.push(mapped >> 8, mapped & 0xff);
|
|
88
|
+
}
|
|
89
|
+
return Buffer.from(bytes);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* 为一个源文件准备转码后的副本。
|
|
94
|
+
* @param {object} input 参数
|
|
95
|
+
* @param {string} input.source 源文件绝对路径
|
|
96
|
+
* @param {string} input.base 中间文件的公共前缀(不含扩展名)
|
|
97
|
+
* @param {'c'|'asm'} input.language 源文件语言
|
|
98
|
+
* @returns {{file: string, restoreText: (text: string) => string}} 副本路径,以及把工具输出里的副本路径换回原文件的函数
|
|
99
|
+
* @throws {FcdevError} 有字符不在 GB2312 里
|
|
100
|
+
*/
|
|
101
|
+
export function prepareGb2312Source({ source, base, language }) {
|
|
102
|
+
const file = `${base}.gb2312${path.extname(source)}`;
|
|
103
|
+
const converted = convertToGb2312(readFileSync(source), source);
|
|
104
|
+
if (language === 'c') {
|
|
105
|
+
const original = source.replaceAll('\\', '\\\\').replaceAll('"', '\\"');
|
|
106
|
+
writeFileSync(file, Buffer.concat([Buffer.from(`#line 1 "${original}"\n`, 'utf8'), converted]));
|
|
107
|
+
return { file, restoreText: (text) => text };
|
|
108
|
+
}
|
|
109
|
+
writeFileSync(file, converted);
|
|
110
|
+
return { file, restoreText: (text) => text.replaceAll(file, source) };
|
|
111
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// ------------------------------------------------------------------------
|
|
2
2
|
// 名称:docs-command.mjs
|
|
3
|
-
// 说明:docs
|
|
3
|
+
// 说明:docs 命令:列出使用文档的主题,查询某份文档的本机路径。
|
|
4
4
|
// 作者:sungbin
|
|
5
5
|
// 邮箱:sungbin@3578.cn
|
|
6
6
|
// 日期:2026-11-11
|
|
@@ -29,7 +29,7 @@ export async function runDocsCommand({ positionals, options, context }) {
|
|
|
29
29
|
return 0;
|
|
30
30
|
}
|
|
31
31
|
const width = Math.max(...docs.map((doc) => doc.topic.length));
|
|
32
|
-
const lines = [`fcdev
|
|
32
|
+
const lines = [`fcdev 使用文档:${docs.length} 份`, `本机目录:${directory}`, ''];
|
|
33
33
|
for (const doc of docs) lines.push(` ${doc.topic.padEnd(width)} ${doc.title}:${doc.summary}`);
|
|
34
34
|
lines.push('', '查询:npx fcdev docs <主题>(本机路径)、npx fcdev docs <词>(按主题、文件名、标题与说明搜索)');
|
|
35
35
|
context.stdout.write(`${lines.join('\n')}\n`);
|
package/src/cli/index.mjs
CHANGED
|
@@ -54,7 +54,7 @@ const HELP_TEXT = `fcdev:6502 兼容机的开发工具
|
|
|
54
54
|
sync 生成 IDE 的 C/C++ 配置
|
|
55
55
|
info [--json] 显示目标、工具链与头文件目录
|
|
56
56
|
api [词] [--json] 查询目标的 C 接口文档:函数名、模块名、$功能号或关键词;不带词列出全部模块
|
|
57
|
-
docs [词] [--json]
|
|
57
|
+
docs [词] [--json] 查询使用文档:主题名或关键词,给出本机路径;不带词列出全部主题
|
|
58
58
|
|
|
59
59
|
选项:
|
|
60
60
|
--target <名> 指定目标,覆盖 fcdev.json
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
// 作者:sungbin
|
|
5
5
|
// 邮箱:sungbin@3578.cn
|
|
6
6
|
// 日期:2026-11-10
|
|
7
|
-
// 备注:未知的键直接报错,避免拼写错误被忽略;配置项含义见 docs/
|
|
7
|
+
// 备注:未知的键直接报错,避免拼写错误被忽略;配置项含义见 packages/fcdev/docs/01-命令行与构建.md 第 3 节。
|
|
8
8
|
// ------------------------------------------------------------------------
|
|
9
9
|
import { existsSync } from 'node:fs';
|
|
10
10
|
import path from 'node:path';
|
package/src/docs/doc-index.mjs
CHANGED
package/src/docs/doc-topics.mjs
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
// ------------------------------------------------------------------------
|
|
2
2
|
// 名称:doc-topics.mjs
|
|
3
|
-
//
|
|
3
|
+
// 说明:使用文档的主题登记表:每份文档的主题名、相对 docs 目录的文件、标题和一句话说明。
|
|
4
4
|
// 作者:sungbin
|
|
5
5
|
// 邮箱:sungbin@3578.cn
|
|
6
6
|
// 日期:2026-11-11
|
|
7
|
-
//
|
|
7
|
+
// 备注:新增、改名或删除使用文档时同步改这里与仓库根目录 docs/01-软件架构设计.md 第 9 节;主题名只用小写字母、数字与连字符,便于在任何终端里输入。
|
|
8
8
|
// ------------------------------------------------------------------------
|
|
9
9
|
|
|
10
10
|
/**
|
|
@@ -18,21 +18,15 @@
|
|
|
18
18
|
|
|
19
19
|
/** @type {DocTopic[]} */
|
|
20
20
|
export const DOC_TOPICS = [
|
|
21
|
-
{ topic: '
|
|
22
|
-
{ topic: '
|
|
23
|
-
{ topic: '
|
|
24
|
-
{ topic: '
|
|
25
|
-
{ topic: '
|
|
26
|
-
{ topic: 'disasm', file: '06-反汇编.md', title: '反汇编', summary: '反汇编前端的流程、输入与限制' },
|
|
27
|
-
{ topic: 'create', file: '07-创建包与模板.md', title: '创建包与模板', summary: 'npm create fcdev 的命令、模板与生成内容' },
|
|
28
|
-
{ topic: 'testing', file: '08-测试与验证.md', title: '测试与验证', summary: '测试分层、环境变量与运行方法' },
|
|
29
|
-
{ topic: 'release', file: '09-发布.md', title: '发布', summary: '发布顺序、前提与检查' },
|
|
30
|
-
{ topic: 'vscode', file: '10-VS Code扩展.md', title: 'VS Code 扩展', summary: '智能感知、语法高亮、项目信息来源、目录分层与打包' },
|
|
31
|
-
{ topic: 'nes', file: 'nes/01-NES目标.md', title: 'NES 目标', summary: 'NES 目标的内存与映射器、fcnes 函数、字库、运行' },
|
|
21
|
+
{ topic: 'build', file: '01-命令行与构建.md', title: '命令行与构建', summary: '命令、构建规则、配置文件 fcdev.json、构建流程' },
|
|
22
|
+
{ topic: 'emulator', file: '02-模拟器与调试.md', title: '模拟器与调试', summary: '运行方案、Ember 定位、调试服务与 debug 命令' },
|
|
23
|
+
{ topic: 'disasm', file: '03-反汇编.md', title: '反汇编', summary: '反汇编的命令、输入、追踪规则与限制' },
|
|
24
|
+
{ topic: 'create', file: '04-创建包与模板.md', title: '创建包与模板', summary: 'npm create fcdev 的命令、模板与生成内容' },
|
|
25
|
+
{ topic: 'nes', file: 'nes/01-开发指南.md', title: 'NES 开发指南', summary: 'NES 目标的内存与映射器、fcnes 函数、字库、运行' },
|
|
32
26
|
{ topic: 'sb2000', file: 'sb2000/01-开发指南.md', title: 'SB2000 开发指南', summary: '程序格式、内存布局、运行库、大程序换页、常用做法、易错点与示例' },
|
|
27
|
+
{ topic: 'examples', file: 'targets/sb2000/examples-source.md', inPackage: true, title: 'SB2000 示例程序源码', summary: '手册里提到的示例程序(hello、show、copy、pad、mouse、play 等)的完整源码,由示例项目生成' },
|
|
33
28
|
{ topic: 'syscall', file: 'sb2000/02-系统调用手册.md', title: 'SB-DOS 系统调用手册', summary: '系统调用的参数、结果、出错码与可靠程度' },
|
|
34
29
|
{ topic: 'hardware', file: 'sb2000/03-硬件说明.md', title: 'SB2000 硬件说明', summary: 'SB2000 的硬件行为与寄存器' },
|
|
35
30
|
{ topic: 'api', file: 'targets/sb2000/api-reference.md', inPackage: true, title: 'SB2000 C 接口参考', summary: '运行库全部函数的签名、参数、返回值与系统调用,由头文件文档注释生成,查询用 npx fcdev api' },
|
|
36
|
-
{ topic: '
|
|
37
|
-
{ topic: 'bugs', file: '缺陷记录.md', title: '缺陷记录', summary: '发现的缺陷及修复情况' },
|
|
31
|
+
{ topic: 'symbols', file: 'targets/sb2000/symbols-reference.md', inPackage: true, title: 'SB2000 符号参考', summary: '功能号、子功能号、系统变量地址、出错码、硬件寄存器与位、运行库入口的汇编名与 C 名,由 sb2000.inc 生成' },
|
|
38
32
|
];
|
package/src/docs/index.mjs
CHANGED
|
@@ -13,13 +13,16 @@ import { FcdevError } from '../shared/index.mjs';
|
|
|
13
13
|
/** 整机机型的标识 */
|
|
14
14
|
export const SB2000_MACHINE = 'sb2000';
|
|
15
15
|
|
|
16
|
-
/** 开机到 SB-DOS
|
|
17
|
-
export const DOS_PROMPT_FRAMES =
|
|
16
|
+
/** 开机到 SB-DOS 开始读键盘所需的帧数;日期提示约 850 帧才读键盘,更早按的回车会丢 */
|
|
17
|
+
export const DOS_PROMPT_FRAMES = 900;
|
|
18
18
|
|
|
19
19
|
/** 按键按下与松开之后各运行的帧数,让 BIOS 读到 */
|
|
20
20
|
const KEY_DOWN_FRAMES = 5;
|
|
21
21
|
const KEY_UP_FRAMES = 4;
|
|
22
22
|
|
|
23
|
+
/** 在 SB-DOS 命令行里输入时,按下与松开之后各运行的帧数,更短会丢键 */
|
|
24
|
+
const DOS_KEY_FRAMES = 8;
|
|
25
|
+
|
|
23
26
|
/** 一次运行请求等待的上限,单位毫秒 */
|
|
24
27
|
const RUN_TIMEOUT_MS = 120_000;
|
|
25
28
|
|
|
@@ -49,13 +52,15 @@ export function runFrames(client, frames) {
|
|
|
49
52
|
* 按下并松开一个键,期间运行若干帧。
|
|
50
53
|
* @param {import('ember-debug-sdk').EmberDebugClient} client 已连接的调试客户端
|
|
51
54
|
* @param {string} code 物理键位(KeyboardEvent.code),如 KeyA、Enter、F1
|
|
55
|
+
* @param {number} [downFrames] 按下后运行的帧数
|
|
56
|
+
* @param {number} [upFrames] 松开后运行的帧数
|
|
52
57
|
* @returns {Promise<void>}
|
|
53
58
|
*/
|
|
54
|
-
export async function tapKey(client, code) {
|
|
59
|
+
export async function tapKey(client, code, downFrames = KEY_DOWN_FRAMES, upFrames = KEY_UP_FRAMES) {
|
|
55
60
|
await client.request('input.key', { code, down: true });
|
|
56
|
-
await runFrames(client,
|
|
61
|
+
await runFrames(client, downFrames);
|
|
57
62
|
await client.request('input.key', { code, down: false });
|
|
58
|
-
await runFrames(client,
|
|
63
|
+
await runFrames(client, upFrames);
|
|
59
64
|
}
|
|
60
65
|
|
|
61
66
|
/**
|
|
@@ -83,7 +88,7 @@ export async function bootSb2000(client, { firmware, diskImage }) {
|
|
|
83
88
|
}
|
|
84
89
|
|
|
85
90
|
/**
|
|
86
|
-
* 在 SB-DOS
|
|
91
|
+
* 在 SB-DOS 里运行程序:开机运行 900 帧,直接按两次回车跳过日期与时间,输入程序名回车。返回时程序刚被启动,机器仍是暂停的。
|
|
87
92
|
* @param {import('ember-debug-sdk').EmberDebugClient} client 已连接的调试客户端
|
|
88
93
|
* @param {string} programName 程序名(不含扩展名)
|
|
89
94
|
* @returns {Promise<void>}
|
|
@@ -92,10 +97,8 @@ export async function bootSb2000(client, { firmware, diskImage }) {
|
|
|
92
97
|
export async function enterProgram(client, programName) {
|
|
93
98
|
const codes = [...programName].map(keyCodeOf);
|
|
94
99
|
await runFrames(client, DOS_PROMPT_FRAMES);
|
|
95
|
-
await tapKey(client, 'Enter');
|
|
96
|
-
await
|
|
97
|
-
await tapKey(client,
|
|
98
|
-
await
|
|
99
|
-
for (const code of codes) await tapKey(client, code);
|
|
100
|
-
await tapKey(client, 'Enter');
|
|
100
|
+
await tapKey(client, 'Enter', DOS_KEY_FRAMES, DOS_KEY_FRAMES);
|
|
101
|
+
await tapKey(client, 'Enter', DOS_KEY_FRAMES, DOS_KEY_FRAMES);
|
|
102
|
+
for (const code of codes) await tapKey(client, code, DOS_KEY_FRAMES, DOS_KEY_FRAMES);
|
|
103
|
+
await tapKey(client, 'Enter', DOS_KEY_FRAMES, DOS_KEY_FRAMES);
|
|
101
104
|
}
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
// 作者:sungbin
|
|
5
5
|
// 邮箱:sungbin@3578.cn
|
|
6
6
|
// 日期:2026-11-10
|
|
7
|
-
//
|
|
7
|
+
// 备注:目标定义的字段含义见仓库根目录 docs/02-目标规范.md 第 2 节;新增机型只需新增目标目录,不改这里。
|
|
8
8
|
// ------------------------------------------------------------------------
|
|
9
9
|
import { readdirSync } from 'node:fs';
|
|
10
10
|
import path from 'node:path';
|
|
@@ -23,6 +23,9 @@ const RUN_MODES = new Set(['rom', 'firmware-disk']);
|
|
|
23
23
|
/** 目标专用选项允许的类型 */
|
|
24
24
|
const OPTION_TYPES = new Set(['boolean', 'string', 'number']);
|
|
25
25
|
|
|
26
|
+
/** 源文件转码支持的目标编码 */
|
|
27
|
+
const SOURCE_CHARSETS = new Set(['gb2312']);
|
|
28
|
+
|
|
26
29
|
/**
|
|
27
30
|
* @typedef {object} BankedSpec 多页(换页)程序的定义
|
|
28
31
|
* @property {string} option 目标专用选项名,值为库页个数
|
|
@@ -55,6 +58,7 @@ const OPTION_TYPES = new Set(['boolean', 'string', 'number']);
|
|
|
55
58
|
* @property {object|null} run 运行方案
|
|
56
59
|
* @property {Record<string, {type: string, default: unknown, links: string[]}>} options 目标专用选项;布尔选项为 true 时额外链接 links 里的文件(路径值)
|
|
57
60
|
* @property {BankedSpec|null} banked 多页(换页)程序的定义;不支持时为 null
|
|
61
|
+
* @property {string|null} sourceCharset 机器用的文字编码;不为 null 时,构建前把 UTF-8 的源文件转成这个编码(目前只有 gb2312)
|
|
58
62
|
*/
|
|
59
63
|
|
|
60
64
|
/**
|
|
@@ -129,6 +133,9 @@ export function parseTarget(raw, dir) {
|
|
|
129
133
|
options[key] = { type: spec.type, default: spec.default, links: spec.links ?? [] };
|
|
130
134
|
}
|
|
131
135
|
const banked = parseBanked(raw.banked, raw.name, options);
|
|
136
|
+
if (raw.sourceCharset !== undefined && !SOURCE_CHARSETS.has(raw.sourceCharset)) {
|
|
137
|
+
throw new FcdevError(`目标 ${raw.name} 的 sourceCharset 只能是 ${[...SOURCE_CHARSETS].join(' 或 ')}`, { code: 'TARGET_INVALID' });
|
|
138
|
+
}
|
|
132
139
|
return {
|
|
133
140
|
name: raw.name,
|
|
134
141
|
title: raw.title,
|
|
@@ -150,6 +157,7 @@ export function parseTarget(raw, dir) {
|
|
|
150
157
|
run: raw.run ?? null,
|
|
151
158
|
options,
|
|
152
159
|
banked,
|
|
160
|
+
sourceCharset: raw.sourceCharset ?? null,
|
|
153
161
|
};
|
|
154
162
|
}
|
|
155
163
|
|
|
Binary file
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SB2000 C 接口参考
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
本文由运行库头文件 `sb2000-*.h` 的文档注释生成。
|
|
4
4
|
共 204 个函数,17 个模块。随时查询用 `npx fcdev api`:`npx fcdev api <函数名>` 看完整文档,`npx fcdev api <模块名>` 看模块的函数列表,`npx fcdev api '$7B'` 看用到某个系统调用的函数,`npx fcdev api <词>` 按名称与说明搜索。
|
|
5
5
|
|
|
6
6
|
约定:
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
- 所有函数用 `#include <sb2000.h>` 引入;返回 DOS 出错码或软驱状态码的函数,0 表示成功,结果经指针参数带回。
|
|
9
9
|
- 字符串、缓冲区、结构体指针必须在程序窗口 `$8000-$BFFF` 里(系统服务换页后程序窗口不可见的,函数内部已经处理好,调用者不用管)。
|
|
10
10
|
- 程序最大 16K(窗口 `$8000-$BFFF`,C 软件栈占顶端 1K)。
|
|
11
|
+
- 汇编程序调用这些函数时,函数名前加下划线(如 `_sb_puts`),参数按 cc65 的 fastcall 约定传递;系统调用号、地址与寄存器的符号见 [SB2000 符号参考](symbols-reference.md)。
|
|
11
12
|
|
|
12
13
|
## 目录
|
|
13
14
|
|