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,50 +0,0 @@
|
|
|
1
|
-
# 待办备忘
|
|
2
|
-
|
|
3
|
-
已确定以后再做的事项。做完一项,就把它写进对应的文档,并从本文删掉。
|
|
4
|
-
|
|
5
|
-
## 1. 发布
|
|
6
|
-
|
|
7
|
-
| 事项 | 说明 |
|
|
8
|
-
| --- | --- |
|
|
9
|
-
| 发布四个 npm 包 | 由用户登录 npm 后按 [09-发布](09-发布.md) 的顺序执行 |
|
|
10
|
-
|
|
11
|
-
## 2. VS Code 扩展
|
|
12
|
-
|
|
13
|
-
扩展的智能感知与 ca65 语法高亮已完成,见 [10-VS Code扩展](10-VS%20Code扩展.md)。发布到 VS Code 市场需要发布者账号,由用户操作,本仓库只负责生成 `.vsix`。下面是还没做的功能:
|
|
14
|
-
|
|
15
|
-
| 功能 | 说明 |
|
|
16
|
-
| --- | --- |
|
|
17
|
-
| 任务 | 任务提供者 `fcdev`:构建、运行;问题匹配器识别 `cc65`、`ca65` 的 `文件(行): Error: 信息`,报错可跳转到源码行 |
|
|
18
|
-
| 命令 | 新建项目(调用 `create-fcdev`)、构建当前文件、构建当前目录、构建项目、运行、切换目标;状态栏显示当前目标 |
|
|
19
|
-
| 找工具 | 项目里没有安装 `fcdev` 时提示一键安装;现在只在日志里写明原因 |
|
|
20
|
-
| 调试 | 首版不做;调试适配器协议(DAP)另写设计 |
|
|
21
|
-
| 真实 VS Code 里的显示效果 | 扩展已做完,类型检查、测试与构建通过;悬停、补全、高亮在真实 VS Code 里的显示效果待用户核对 |
|
|
22
|
-
|
|
23
|
-
## 3. 模拟器
|
|
24
|
-
|
|
25
|
-
| 事项 | 说明 |
|
|
26
|
-
| --- | --- |
|
|
27
|
-
| 内核集成进 VS Code 面板 | 只要 Ember 的调试服务协议不变,`fcdev` 不用改 |
|
|
28
|
-
| 学习机 hello 的屏幕文字核对 | `fcdev run` 已能在 Ember 里运行学习机程序,运行库测试也已恢复;还没有把 C、汇编 hello 运行后的屏幕文字核对做成自动测试用例 |
|
|
29
|
-
| 已有 Ember 时 `fcdev run` 载入不进程序 | Ember 单实例,第二个进程只把已有窗口提到前面,不处理 `--cartridge`;需要 Ember 的 `second-instance` 处理它,或 `fcdev` 改用已开启的调试服务载入 |
|
|
30
|
-
| 存档(`savestate`、`loadstate`) | 旧模拟器有、Ember 没有,已登记在 Ember 的待办里,做完后通过 `fcdev debug call` 直接可用 |
|
|
31
|
-
| 外设读数与真机对齐 | `hwtest` 在真机与模拟器上仍有差异的读数(`$4015` 位 4、`$4022` 开机值、`$4026`、`$4016`、`$4017`、`$4033` 位 6、`$3FFF`),具体数值见 [03-硬件说明](sb2000/03-硬件说明.md) 的“真机与模拟器仍有差异的行为”;程序不应依赖这些值,是否对齐由用户决定。|
|
|
32
|
-
| `runnes` 与 `play` 的 DMA 写法 | 两个程序借用程序窗口 2(`$A000`)做 DMA 目的,真机上失败,模拟器对齐真机后也失败(`runnes` 现在用库函数 `sb_dma_to_cpu`,目的在窗口时函数直接返回出错、不复制);改成先 DMA 到 ERAM 缓冲再用 CPU 搬(参考 `apps/sb2000/bbk-loader`) |
|
|
33
|
-
|
|
34
|
-
## 4. 目标
|
|
35
|
-
|
|
36
|
-
| 事项 | 说明 |
|
|
37
|
-
| --- | --- |
|
|
38
|
-
| 步步高、裕兴的目标 | 缺少资料,动手前先用资料与模拟器确认程序格式、内存布局、系统调用与固件要求 |
|
|
39
|
-
| NES 的其他映射器 | 现在只支持 `nes.cfg` 的 NROM |
|
|
40
|
-
| SB2000 的退出码 | `main` 的返回值没有实现为退出码:`$6308` 是运行库显示消息用的 `LIB_GROUP`,DOS 外壳不读取程序返回时的它,系统里没有退出码这个约定;要不要提供自己的约定(如写到某个 ERAM 单元)以后再定 |
|
|
41
|
-
| SB2000 没封装的系统调用 | 见 [api-reference.md](../targets/sb2000/api-reference.md) 末尾的覆盖表与 `api-unwrapped.json`:文件系统内部步骤、`$41`-`$44`、`$31`、`$34`、`$66`、`$65` 与 `$6D` 的部分子功能、`$74`/`$75` 的 NMI 发送与播放列表等;有需要时再封装并补测试 |
|
|
42
|
-
|
|
43
|
-
## 5. 反汇编
|
|
44
|
-
|
|
45
|
-
| 事项 | 说明 |
|
|
46
|
-
| --- | --- |
|
|
47
|
-
| 其他映射器 | 现在只支持 NROM 与平铺二进制;其他映射器需要目标提供地址映射 |
|
|
48
|
-
| 跳转表识别 | 已识别 `LDA 表,X` 加间接 `JMP`、`PHA`/`RTS` 的表和 `JMP (地址)` 指向的表;例程内联的跳转表(`JSR` 之后紧跟地址表)、立即数拼出的分发指针还追不到,这部分按数据输出;补全覆盖靠运行记录:模拟器 `trace ... unique` 在步步高机型上可用,CDL 只对 SB2K 映射器有效,对步步高 RAM 里的程序没用。立即数拼出的指针可以让 `fcdev` 列出“可能的入口”供人工确认,还没做 |
|
|
49
|
-
| 地址表与字符串识别 | 现在没追到的字节都是 `ByteTable` |
|
|
50
|
-
| SB2000 固件页的 CDL 验证 | 没有做;模拟器自带 CDL 只对 SB2K 映射器有效 |
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
# 缺陷记录
|
|
2
|
-
|
|
3
|
-
发现的缺陷及修复情况。发现缺陷时先登记,修复后填写修复说明。
|
|
4
|
-
|
|
5
|
-
| 编号 | 发现日期 | 缺陷 | 影响 | 状态 | 修复说明 |
|
|
6
|
-
| --- | --- | --- | --- | --- | --- |
|
|
7
|
-
| B001 | 2026-11-10 | 根 `.gitignore` 的 `build/` 规则把 `packages/fcdev/src/build/`(构建核心的 7 个源文件)排除在版本库之外,`git ls-files` 里没有它们 | 已提交的仓库缺少构建核心,别人克隆后无法使用 `fcdev build`;发布时因为 `files` 白名单仍会打进包,所以现有包内容不受影响 | 已修复 | 把 `.gitignore` 里的 `build/` 改为只忽略仓库根的 `/build/` 与各包根目录下的 `packages/*/build/`;修改后 `git check-ignore` 不再匹配 `packages/fcdev/src/build/`,该目录显示为未跟踪,需要用户自己暂存并提交 |
|
|
8
|
-
| B002 | 2026-11-10 | `virtuanes/README.md` 的目录图根写成 `emulator/`,一处链接指向不存在的文件 | 链接失效,目录图与实际不符 | 已修复 | 目录图改为 `virtuanes/`,删掉失效链接与不属于本仓库的说明 |
|
|
9
|
-
| B003 | 2026-11-10 | `fcdev` 接受 `--verbose` 选项,但没有任何命令使用它 | 选项无效果;文档与帮助文字都没有提到它 | 待修复 | |
|
|
10
|
-
| B004 | 2026-11-12 | `npm run check` 里需要启动模拟器的 SB2000 测试(`sb2000-library.test.mjs`)偶发失败:有时报“调试命令 run 300 超过 120000 毫秒没有应答”,有时报“等待调试服务就绪超时”,失败的用例每次不同;单独重跑通过 | 全量检查偶发 1 个失败,与代码改动无关 | 待修复 | |
|