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.
- package/LICENSE +201 -0
- package/README.md +82 -2
- package/bin/fcdev.mjs +17 -0
- package/package.json +38 -4
- package/src/api/header-parser.mjs +78 -0
- package/src/api/index.mjs +128 -0
- package/src/build/bank-link-config.mjs +74 -0
- package/src/build/build-plan.mjs +92 -0
- package/src/build/dependency-file.mjs +24 -0
- package/src/build/disk-builder.mjs +36 -0
- package/src/build/index.mjs +32 -0
- package/src/build/program-builder.mjs +212 -0
- package/src/build/source-collector.mjs +54 -0
- package/src/build/tool-arguments.mjs +83 -0
- package/src/cli/args-parser.mjs +84 -0
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/commands/build-command.mjs +34 -0
- package/src/cli/commands/debug-command.mjs +70 -0
- package/src/cli/commands/disasm-command.mjs +65 -0
- package/src/cli/commands/disk-command.mjs +34 -0
- package/src/cli/commands/info-command.mjs +33 -0
- package/src/cli/commands/project-info.mjs +57 -0
- package/src/cli/commands/run-command.mjs +68 -0
- package/src/cli/commands/sync-command.mjs +85 -0
- package/src/cli/index.mjs +103 -0
- package/src/config/config-loader.mjs +132 -0
- package/src/config/index.mjs +9 -0
- package/src/disasm/analysis.mjs +97 -0
- package/src/disasm/cdl.mjs +35 -0
- package/src/disasm/disassembler.mjs +114 -0
- package/src/disasm/index.mjs +16 -0
- package/src/disasm/info-writer.mjs +72 -0
- package/src/disasm/loaders.mjs +69 -0
- package/src/disasm/opcode-table.mjs +268 -0
- package/src/disasm/roundtrip.mjs +69 -0
- package/src/disasm/symbols.mjs +30 -0
- package/src/disasm/trace.mjs +25 -0
- package/src/emulator/debug-client.mjs +125 -0
- package/src/emulator/emulator-launcher.mjs +80 -0
- package/src/emulator/emulator-locator.mjs +62 -0
- package/src/emulator/index.mjs +11 -0
- package/src/packagers/fat-floppy.mjs +22 -0
- package/src/packagers/fat12-image.mjs +245 -0
- package/src/packagers/flat-binary.mjs +53 -0
- package/src/packagers/index.mjs +54 -0
- package/src/packagers/ines.mjs +38 -0
- package/src/shared/errors.mjs +25 -0
- package/src/shared/fs-utils.mjs +66 -0
- package/src/shared/index.mjs +11 -0
- package/src/shared/process.mjs +50 -0
- package/src/targets/index.mjs +17 -0
- package/src/targets/name-rules.mjs +33 -0
- package/src/targets/target-registry.mjs +225 -0
- package/src/toolchain/index.mjs +16 -0
- package/src/toolchain/toolchain-locator.mjs +104 -0
- package/targets/nes/asminc/fcnes.inc +16 -0
- package/targets/nes/chr/ascii-8x8.chr +0 -0
- package/targets/nes/chr/font8x8_basic.h +152 -0
- package/targets/nes/include/fcnes.h +45 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/nes/lib-build.json +9 -0
- package/targets/nes/src/fcnes.s +91 -0
- package/targets/nes/src/nes-font.s +12 -0
- package/targets/nes/target.json +27 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +418 -0
- package/targets/sb2000/include/sb2000-bank.h +74 -0
- package/targets/sb2000/include/sb2000-clock.h +68 -0
- package/targets/sb2000/include/sb2000-disk.h +141 -0
- package/targets/sb2000/include/sb2000-display.h +352 -0
- package/targets/sb2000/include/sb2000-file.h +273 -0
- package/targets/sb2000/include/sb2000-ime.h +158 -0
- package/targets/sb2000/include/sb2000-input.h +192 -0
- package/targets/sb2000/include/sb2000-math.h +228 -0
- package/targets/sb2000/include/sb2000-memory.h +115 -0
- package/targets/sb2000/include/sb2000-printer.h +116 -0
- package/targets/sb2000/include/sb2000-sound.h +134 -0
- package/targets/sb2000/include/sb2000-symbols.h +776 -0
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +45 -0
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +8 -0
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/link.cfg +35 -0
- package/targets/sb2000/src/crt0.s +122 -0
- package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
- package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
- package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
- package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
- package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
- package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
- package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
- package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
- package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
- package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
- package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
- package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
- package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
- package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
- package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
- package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
- package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
- package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
- package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
- package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
- package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
- package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
- package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
- package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
- package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
- package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
- package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
- package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
- package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
- package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
- package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
- package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
- package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
- package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
- package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
- package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
- package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
- package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
- package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
- package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
- package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
- package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
- package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
- package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
- package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
- package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
- package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
- package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
- package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
- package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
- package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
- package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
- package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
- package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
- package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
- package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
- package/targets/sb2000/src/lib/sb-internal.h +111 -0
- package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
- package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
- package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
- package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
- package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
- package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
- package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
- package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
- package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
- package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
- package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
- package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
- package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
- package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
- package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
- package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
- package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
- package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
- package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
- package/targets/sb2000/src/lib/text/sb-print.c +35 -0
- package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
- package/targets/sb2000/src/sb2000.s +64 -0
- package/targets/sb2000/target.json +42 -0
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:config-loader.mjs
|
|
3
|
+
// 说明:查找并读取项目配置 fcdev.json:校验键与类型,补默认值,把相对路径换成绝对路径。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:未知的键直接报错,避免拼写错误被忽略;配置项含义见 docs/02-命令行与构建.md 第 3 节。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { existsSync } from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { FcdevError, readJsonFile } from '../shared/index.mjs';
|
|
12
|
+
|
|
13
|
+
/** 配置文件名 */
|
|
14
|
+
export const CONFIG_FILE_NAME = 'fcdev.json';
|
|
15
|
+
|
|
16
|
+
/** 配置项的类型描述 */
|
|
17
|
+
const KEY_TYPES = {
|
|
18
|
+
target: 'string',
|
|
19
|
+
name: 'string',
|
|
20
|
+
out: 'string',
|
|
21
|
+
optimize: 'boolean',
|
|
22
|
+
define: 'object',
|
|
23
|
+
include: 'string-array',
|
|
24
|
+
toolchain: 'string',
|
|
25
|
+
firmware: 'string',
|
|
26
|
+
emulator: 'string',
|
|
27
|
+
targetOptions: 'object',
|
|
28
|
+
};
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* @typedef {object} ProjectConfig
|
|
32
|
+
* @property {string|null} file 配置文件路径;没有配置文件时为 null
|
|
33
|
+
* @property {string} root 项目根目录(配置文件所在目录,没有配置时为起始目录)
|
|
34
|
+
* @property {string|undefined} target 目标名
|
|
35
|
+
* @property {string|undefined} name 目录构建时的程序名
|
|
36
|
+
* @property {string} outDir 输出目录的绝对路径
|
|
37
|
+
* @property {boolean} optimize 是否优化
|
|
38
|
+
* @property {Record<string, string|number>} define 预定义宏
|
|
39
|
+
* @property {string[]} include 额外头文件目录的绝对路径
|
|
40
|
+
* @property {string|undefined} toolchain 自备 cc65 根目录的绝对路径
|
|
41
|
+
* @property {string|undefined} firmware 固件文件的绝对路径
|
|
42
|
+
* @property {string|undefined} emulator 自备模拟器路径
|
|
43
|
+
* @property {Record<string, unknown>} targetOptions 目标专用选项
|
|
44
|
+
*/
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* 从起始目录向上查找最近的 fcdev.json。
|
|
48
|
+
* @param {string} startDir 起始目录
|
|
49
|
+
* @returns {string|null} 配置文件的绝对路径;找不到时为 null
|
|
50
|
+
*/
|
|
51
|
+
export function findConfigFile(startDir) {
|
|
52
|
+
let current = path.resolve(startDir);
|
|
53
|
+
for (;;) {
|
|
54
|
+
const candidate = path.join(current, CONFIG_FILE_NAME);
|
|
55
|
+
if (existsSync(candidate)) return candidate;
|
|
56
|
+
const parent = path.dirname(current);
|
|
57
|
+
if (parent === current) return null;
|
|
58
|
+
current = parent;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* 检查一个配置值是否符合类型描述。
|
|
64
|
+
* @param {unknown} value 配置值
|
|
65
|
+
* @param {string} type 类型描述
|
|
66
|
+
* @returns {boolean} 符合时为 true
|
|
67
|
+
*/
|
|
68
|
+
function matchesType(value, type) {
|
|
69
|
+
if (type === 'string-array') return Array.isArray(value) && value.every((item) => typeof item === 'string');
|
|
70
|
+
if (type === 'object') return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
71
|
+
return typeof value === type;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* 校验并规范化配置内容。
|
|
76
|
+
* @param {unknown} raw 解析后的 JSON
|
|
77
|
+
* @param {string|null} file 配置文件路径,用于出错提示与解析相对路径
|
|
78
|
+
* @param {string} fallbackRoot 没有配置文件时的项目根目录
|
|
79
|
+
* @returns {ProjectConfig} 规范化后的配置
|
|
80
|
+
* @throws {FcdevError} 出现未知的键或类型不对
|
|
81
|
+
*/
|
|
82
|
+
export function normalizeConfig(raw, file, fallbackRoot) {
|
|
83
|
+
const where = file ?? CONFIG_FILE_NAME;
|
|
84
|
+
if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
|
|
85
|
+
throw new FcdevError(`${where} 的内容必须是对象`, { code: 'CONFIG_INVALID' });
|
|
86
|
+
}
|
|
87
|
+
for (const [key, value] of Object.entries(raw)) {
|
|
88
|
+
const type = KEY_TYPES[key];
|
|
89
|
+
if (!type) {
|
|
90
|
+
throw new FcdevError(`${where} 中有未知的配置项:${key}`, {
|
|
91
|
+
code: 'CONFIG_UNKNOWN_KEY',
|
|
92
|
+
hint: `可用的配置项:${Object.keys(KEY_TYPES).join('、')}`,
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
if (!matchesType(value, type)) {
|
|
96
|
+
throw new FcdevError(`${where} 中的 ${key} 类型不对,应为 ${type}`, { code: 'CONFIG_INVALID_TYPE' });
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
const root = file ? path.dirname(file) : path.resolve(fallbackRoot);
|
|
100
|
+
const resolveFromRoot = (value) => (value === undefined ? undefined : path.resolve(root, value));
|
|
101
|
+
for (const [key, value] of Object.entries(raw.define ?? {})) {
|
|
102
|
+
if (typeof value !== 'string' && typeof value !== 'number') {
|
|
103
|
+
throw new FcdevError(`${where} 的 define.${key} 必须是字符串或数字`, { code: 'CONFIG_INVALID_TYPE' });
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return {
|
|
107
|
+
file,
|
|
108
|
+
root,
|
|
109
|
+
target: raw.target,
|
|
110
|
+
name: raw.name,
|
|
111
|
+
outDir: path.resolve(root, raw.out ?? 'build'),
|
|
112
|
+
optimize: raw.optimize ?? true,
|
|
113
|
+
define: raw.define ?? {},
|
|
114
|
+
include: (raw.include ?? []).map((item) => path.resolve(root, item)),
|
|
115
|
+
toolchain: resolveFromRoot(raw.toolchain),
|
|
116
|
+
firmware: resolveFromRoot(raw.firmware),
|
|
117
|
+
emulator: resolveFromRoot(raw.emulator),
|
|
118
|
+
targetOptions: raw.targetOptions ?? {},
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* 读取构建路径对应的项目配置。
|
|
124
|
+
* @param {string} startPath 构建路径(文件或目录)所在的起始目录
|
|
125
|
+
* @param {string} fallbackRoot 找不到配置文件时用作项目根的目录(终端当前目录)
|
|
126
|
+
* @returns {ProjectConfig} 项目配置
|
|
127
|
+
*/
|
|
128
|
+
export function loadProjectConfig(startPath, fallbackRoot) {
|
|
129
|
+
const file = findConfigFile(startPath);
|
|
130
|
+
if (!file) return normalizeConfig({}, null, fallbackRoot);
|
|
131
|
+
return normalizeConfig(readJsonFile(file), file, fallbackRoot);
|
|
132
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:index.mjs
|
|
3
|
+
// 说明:config 目录的对外入口。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:无
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
export { CONFIG_FILE_NAME, findConfigFile, loadProjectConfig, normalizeConfig } from './config-loader.mjs';
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:analysis.mjs
|
|
3
|
+
// 说明:静态追踪:从入口出发沿控制流标出哪些字节是指令的操作码、哪些是操作数;CDL 里的代码段起点也当作入口。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:处理规则:顺序执行继续,条件分支两路都追,JMP 只追目标,JSR 追目标并假定会返回,RTS、RTI、BRK、间接 JMP 结束这一路;
|
|
8
|
+
// 遇到非法操作码、越界或与已识别指令重叠时放弃这一路并记入警告。没被追到的字节都算数据,这不影响回读校验(da65 对非法操作码输出 .byte)。
|
|
9
|
+
// ------------------------------------------------------------------------
|
|
10
|
+
import { CDL_CODE } from './cdl.mjs';
|
|
11
|
+
import { OPCODES } from './opcode-table.mjs';
|
|
12
|
+
|
|
13
|
+
/** 字节分类:没有被标成指令 */
|
|
14
|
+
export const KIND_UNKNOWN = 0;
|
|
15
|
+
|
|
16
|
+
/** 字节分类:指令的第一个字节 */
|
|
17
|
+
export const KIND_OPCODE = 1;
|
|
18
|
+
|
|
19
|
+
/** 字节分类:指令的操作数 */
|
|
20
|
+
export const KIND_OPERAND = 2;
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* @typedef {object} Analysis
|
|
24
|
+
* @property {Uint8Array} kinds 每个字节的分类
|
|
25
|
+
* @property {number} instructions 识别出的指令条数
|
|
26
|
+
* @property {string[]} warnings 追踪中放弃某一路的原因
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 格式化地址,写进警告。
|
|
31
|
+
* @param {number} address 地址
|
|
32
|
+
* @returns {string} 如 $C000
|
|
33
|
+
*/
|
|
34
|
+
function hex(address) {
|
|
35
|
+
return `$${address.toString(16).toUpperCase().padStart(4, '0')}`;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* 从入口出发追踪代码。
|
|
40
|
+
* @param {{bytes: Buffer, base: number, entries: number[], cdl?: Uint8Array|null}} input 映像字节、第一个字节的地址、入口地址与可选的 CDL 标志
|
|
41
|
+
* @returns {Analysis} 分析结果
|
|
42
|
+
*/
|
|
43
|
+
export function analyzeCode({ bytes, base, entries, cdl = null }) {
|
|
44
|
+
const kinds = new Uint8Array(bytes.length);
|
|
45
|
+
const warnings = [];
|
|
46
|
+
const pending = [...entries];
|
|
47
|
+
let instructions = 0;
|
|
48
|
+
|
|
49
|
+
if (cdl) {
|
|
50
|
+
// CDL 里每段连续的代码字节,起点一定是被执行过的指令的开头
|
|
51
|
+
for (let offset = 0; offset < cdl.length; offset += 1) {
|
|
52
|
+
if ((cdl[offset] & CDL_CODE) !== 0 && (offset === 0 || (cdl[offset - 1] & CDL_CODE) === 0)) pending.push(base + offset);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
while (pending.length > 0) {
|
|
57
|
+
let address = pending.pop();
|
|
58
|
+
// 沿着顺序执行一路走下去,遇到分支目标或调用目标就放进待办
|
|
59
|
+
for (;;) {
|
|
60
|
+
const offset = address - base;
|
|
61
|
+
if (offset < 0 || offset >= bytes.length) break;
|
|
62
|
+
if (kinds[offset] === KIND_OPCODE) break;
|
|
63
|
+
const entry = OPCODES[bytes[offset]];
|
|
64
|
+
if (entry === null) {
|
|
65
|
+
warnings.push(`${hex(address)}:操作码 $${bytes[offset].toString(16).toUpperCase().padStart(2, '0')} 不是官方 6502 指令,放弃这一路`);
|
|
66
|
+
break;
|
|
67
|
+
}
|
|
68
|
+
const [, size, flow] = entry;
|
|
69
|
+
if (offset + size > bytes.length) {
|
|
70
|
+
warnings.push(`${hex(address)}:指令超出映像末尾,放弃这一路`);
|
|
71
|
+
break;
|
|
72
|
+
}
|
|
73
|
+
let overlaps = false;
|
|
74
|
+
for (let index = 0; index < size; index += 1) {
|
|
75
|
+
// 操作码位置必须是未知,操作数位置不能是别的指令的开头,也不能是别的指令的操作数
|
|
76
|
+
if (kinds[offset + index] !== KIND_UNKNOWN) overlaps = true;
|
|
77
|
+
}
|
|
78
|
+
if (overlaps) {
|
|
79
|
+
warnings.push(`${hex(address)}:与已识别的指令重叠,放弃这一路`);
|
|
80
|
+
break;
|
|
81
|
+
}
|
|
82
|
+
kinds[offset] = KIND_OPCODE;
|
|
83
|
+
for (let index = 1; index < size; index += 1) kinds[offset + index] = KIND_OPERAND;
|
|
84
|
+
instructions += 1;
|
|
85
|
+
|
|
86
|
+
if (flow === 'branch') {
|
|
87
|
+
const displacement = bytes.readInt8(offset + 1);
|
|
88
|
+
pending.push((address + 2 + displacement) & 0xffff);
|
|
89
|
+
} else if (flow === 'jump' || flow === 'call') {
|
|
90
|
+
pending.push(bytes.readUInt16LE(offset + 1));
|
|
91
|
+
}
|
|
92
|
+
if (flow === 'jump' || flow === 'jump-indirect' || flow === 'return' || flow === 'stop') break;
|
|
93
|
+
address += size;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
return { kinds, instructions, warnings };
|
|
97
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:cdl.mjs
|
|
3
|
+
// 说明:读取 CDL(代码数据日志):每个字节一个标志,位 0 表示被当作代码执行过,位 1 表示被当作数据读取过。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:这是 FCEUX 与 Mesen 的通用格式;Mesen 的新格式在开头多 9 个字节(CDLv2 加校验值),会自动跳过;只取与 PRG 对应的前 PRG 大小个字节。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
10
|
+
|
|
11
|
+
/** CDL 标志:被当作代码执行过 */
|
|
12
|
+
export const CDL_CODE = 0x01;
|
|
13
|
+
|
|
14
|
+
/** CDL 标志:被当作数据读取过 */
|
|
15
|
+
export const CDL_DATA = 0x02;
|
|
16
|
+
|
|
17
|
+
/** Mesen CDLv2 的头:魔数 5 字节加 CRC32 4 字节 */
|
|
18
|
+
const MESEN_HEADER = { magic: 'CDLv2', size: 9 };
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* 解析 CDL 文件。
|
|
22
|
+
* @param {Buffer} buffer 文件内容
|
|
23
|
+
* @param {number} prgSize PRG 大小
|
|
24
|
+
* @returns {Uint8Array} 长度为 prgSize 的标志数组,只保留代码与数据两位
|
|
25
|
+
* @throws {FcdevError} 文件比 PRG 短
|
|
26
|
+
*/
|
|
27
|
+
export function parseCdl(buffer, prgSize) {
|
|
28
|
+
const start = buffer.subarray(0, MESEN_HEADER.magic.length).toString('latin1') === MESEN_HEADER.magic ? MESEN_HEADER.size : 0;
|
|
29
|
+
if (buffer.length - start < prgSize) {
|
|
30
|
+
throw new FcdevError(`CDL 只有 ${buffer.length - start} 字节,少于 PRG 的 ${prgSize} 字节`, { code: 'DISASM_CDL_INVALID', hint: '确认 CDL 是用同一个 ROM 记录的' });
|
|
31
|
+
}
|
|
32
|
+
const flags = new Uint8Array(prgSize);
|
|
33
|
+
for (let index = 0; index < prgSize; index += 1) flags[index] = buffer[start + index] & (CDL_CODE | CDL_DATA);
|
|
34
|
+
return flags;
|
|
35
|
+
}
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:disassembler.mjs
|
|
3
|
+
// 说明:反汇编主流程:读取映像、追踪代码、生成 da65 信息文件、运行 da65、回读校验。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:产物放在输出目录:<名>.bin(映像)、<名>.info(信息文件)、<名>.s(ca65 源码);回读不一致时仍保留这些文件,并报错说明第一个差异的位置。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
12
|
+
import { runTool } from '../toolchain/index.mjs';
|
|
13
|
+
import { KIND_UNKNOWN, analyzeCode } from './analysis.mjs';
|
|
14
|
+
import { parseCdl } from './cdl.mjs';
|
|
15
|
+
import { buildRanges, renderInfo } from './info-writer.mjs';
|
|
16
|
+
import { loadBinary, loadInes } from './loaders.mjs';
|
|
17
|
+
import { verifyRoundtrip } from './roundtrip.mjs';
|
|
18
|
+
import { parseSymbols } from './symbols.mjs';
|
|
19
|
+
import { parseTrace } from './trace.mjs';
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* @typedef {object} DisassemblyReport
|
|
23
|
+
* @property {string} sourceFile 生成的 ca65 源码
|
|
24
|
+
* @property {string} infoFile 生成的 da65 信息文件
|
|
25
|
+
* @property {string} imageFile 反汇编的映像
|
|
26
|
+
* @property {string} description 输入的来源说明
|
|
27
|
+
* @property {number} size 映像字节数
|
|
28
|
+
* @property {number} codeBytes 属于指令的字节数
|
|
29
|
+
* @property {number} instructions 指令条数
|
|
30
|
+
* @property {string[]} warnings 追踪中放弃某一路的原因
|
|
31
|
+
* @property {boolean} verified 回读与原映像逐字节一致
|
|
32
|
+
*/
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* 判断输入格式。
|
|
36
|
+
* @param {Buffer} buffer 文件内容
|
|
37
|
+
* @param {string|undefined} format 用户指定的格式
|
|
38
|
+
* @returns {'ines'|'binary'} 格式
|
|
39
|
+
* @throws {FcdevError} 指定了不认识的格式
|
|
40
|
+
*/
|
|
41
|
+
function detectFormat(buffer, format) {
|
|
42
|
+
if (format === 'ines' || format === 'binary') return format;
|
|
43
|
+
if (format !== undefined) throw new FcdevError(`不认识的输入格式:${format}`, { code: 'ARGUMENT_INVALID', hint: '可用的格式:ines、binary' });
|
|
44
|
+
return buffer.subarray(0, 4).toString('latin1') === 'NES\x1a' ? 'ines' : 'binary';
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* 反汇编一个文件,并回读校验。
|
|
49
|
+
* @param {{inputFile: string, format?: string, base?: number, entries?: number[], cdlFile?: string, traceFile?: string, symbolsFile?: string, outDir: string, toolchain: import('../toolchain/index.mjs').Toolchain, includes?: string[]}} input 输入文件、格式、加载地址、入口、CDL、模拟器轨迹、符号文件、输出目录、工具链与 da65 要读的符号定义文件
|
|
50
|
+
* @returns {Promise<DisassemblyReport>} 报告
|
|
51
|
+
* @throws {FcdevError} 输入不合法、da65 失败,或回读校验不一致
|
|
52
|
+
*/
|
|
53
|
+
export async function disassemble({ inputFile, format, base, entries = [], cdlFile, traceFile, symbolsFile, outDir, toolchain, includes = [] }) {
|
|
54
|
+
const buffer = readFileSync(inputFile);
|
|
55
|
+
const kind = detectFormat(buffer, format);
|
|
56
|
+
if (kind === 'binary' && base === undefined) {
|
|
57
|
+
throw new FcdevError('平铺二进制需要指定加载地址', { code: 'ARGUMENT_MISSING', hint: '用 --base <十六进制地址> 指定,如 --base 8000' });
|
|
58
|
+
}
|
|
59
|
+
const image = kind === 'ines' ? loadInes(buffer) : loadBinary(buffer, { base });
|
|
60
|
+
|
|
61
|
+
const vectorEntries = image.vectors ? [image.vectors.reset, image.vectors.nmi, image.vectors.irq] : [];
|
|
62
|
+
const cdl = cdlFile ? parseCdl(readFileSync(cdlFile), image.bytes.length) : null;
|
|
63
|
+
const traced = traceFile ? parseTrace(readFileSync(traceFile, 'utf8')) : [];
|
|
64
|
+
const allEntries = [...new Set([...vectorEntries, ...entries, ...traced])];
|
|
65
|
+
if (allEntries.length === 0 && cdl === null) {
|
|
66
|
+
throw new FcdevError('没有入口可供追踪代码', { code: 'ARGUMENT_MISSING', hint: '用 --entry <十六进制地址> 指定入口,或用 --cdl、--trace 提供运行记录' });
|
|
67
|
+
}
|
|
68
|
+
const analysis = analyzeCode({ bytes: image.bytes, base: image.base, entries: allEntries, cdl });
|
|
69
|
+
|
|
70
|
+
const symbols = symbolsFile ? parseSymbols(readFileSync(symbolsFile, 'utf8')) : [];
|
|
71
|
+
const vectorLabels = image.vectors
|
|
72
|
+
? [{ name: 'reset', address: image.vectors.reset }, { name: 'nmi', address: image.vectors.nmi }, { name: 'irq', address: image.vectors.irq }]
|
|
73
|
+
: [];
|
|
74
|
+
const name = path.basename(inputFile, path.extname(inputFile)).replace(/[^A-Za-z0-9_-]/g, '_') || 'image';
|
|
75
|
+
|
|
76
|
+
mkdirSync(outDir, { recursive: true });
|
|
77
|
+
const imageFile = path.join(outDir, `${name}.bin`);
|
|
78
|
+
const infoFile = path.join(outDir, `${name}.info`);
|
|
79
|
+
const sourceFile = path.join(outDir, `${name}.s`);
|
|
80
|
+
writeFileSync(imageFile, image.bytes);
|
|
81
|
+
writeFileSync(infoFile, renderInfo({
|
|
82
|
+
inputName: path.basename(imageFile),
|
|
83
|
+
outputName: path.basename(sourceFile),
|
|
84
|
+
base: image.base,
|
|
85
|
+
ranges: buildRanges({ kinds: analysis.kinds, base: image.base, hasVectors: image.vectors !== null }),
|
|
86
|
+
labels: [...symbols, ...vectorLabels],
|
|
87
|
+
includes,
|
|
88
|
+
}));
|
|
89
|
+
|
|
90
|
+
const da65 = await runTool(toolchain, 'da65', ['-i', path.basename(infoFile), '--multi-pass'], { cwd: outDir });
|
|
91
|
+
if (da65.code !== 0) throw new FcdevError('da65 反汇编失败', { code: 'DISASM_DA65_FAILED', hint: `${da65.stdout}${da65.stderr}`.trim() });
|
|
92
|
+
|
|
93
|
+
const roundtrip = await verifyRoundtrip({ toolchain, sourceFile, expected: image.bytes, base: image.base, workDir: outDir, name });
|
|
94
|
+
if (!roundtrip.ok) {
|
|
95
|
+
const address = image.base + roundtrip.firstDifference;
|
|
96
|
+
throw new FcdevError(`回读校验不一致:偏移 ${roundtrip.firstDifference}(地址 $${address.toString(16).toUpperCase()})起与原映像不同`, {
|
|
97
|
+
code: 'DISASM_ROUNDTRIP_MISMATCH',
|
|
98
|
+
hint: `源码保留在 ${sourceFile},可对照 ${imageFile} 检查`,
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
const codeBytes = analysis.kinds.reduce((count, value) => count + (value === KIND_UNKNOWN ? 0 : 1), 0);
|
|
103
|
+
return {
|
|
104
|
+
sourceFile,
|
|
105
|
+
infoFile,
|
|
106
|
+
imageFile,
|
|
107
|
+
description: image.description,
|
|
108
|
+
size: image.bytes.length,
|
|
109
|
+
codeBytes,
|
|
110
|
+
instructions: analysis.instructions,
|
|
111
|
+
warnings: analysis.warnings,
|
|
112
|
+
verified: true,
|
|
113
|
+
};
|
|
114
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:index.mjs
|
|
3
|
+
// 说明:disasm 目录的对外入口:反汇编并回读校验,以及解析符号文件、CDL 等辅助函数。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:无
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
export { analyzeCode } from './analysis.mjs';
|
|
10
|
+
export { parseCdl } from './cdl.mjs';
|
|
11
|
+
export { disassemble } from './disassembler.mjs';
|
|
12
|
+
export { buildRanges, renderInfo } from './info-writer.mjs';
|
|
13
|
+
export { loadBinary, loadInes } from './loaders.mjs';
|
|
14
|
+
export { findFirstDifference, renderRoundtripConfig } from './roundtrip.mjs';
|
|
15
|
+
export { parseSymbols } from './symbols.mjs';
|
|
16
|
+
export { parseTrace } from './trace.mjs';
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:info-writer.mjs
|
|
3
|
+
// 说明:把分析结果写成 da65 的信息文件:把整个映像划分成代码、数据与向量表几段,并给入口与用户符号起名字。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:信息文件语法见 da65 的文档;RANGE 的结束地址包含在内;各段首尾相接、互不重叠,没有遗漏,da65 才不会把没说明的字节按默认当成代码。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
10
|
+
import { KIND_UNKNOWN } from './analysis.mjs';
|
|
11
|
+
|
|
12
|
+
/** ca65 标识符 */
|
|
13
|
+
const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
14
|
+
|
|
15
|
+
/** 中断向量表的字节数:NMI、复位、IRQ 各一个字 */
|
|
16
|
+
export const VECTOR_TABLE_SIZE = 6;
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* @typedef {object} Range
|
|
20
|
+
* @property {number} start 起始地址
|
|
21
|
+
* @property {number} end 结束地址(包含)
|
|
22
|
+
* @property {'Code'|'ByteTable'|'AddrTable'} type 类型
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* 把映像划分成连续的段。
|
|
27
|
+
* @param {{kinds: Uint8Array, base: number, hasVectors: boolean}} input 每个字节的分类、起始地址与是否有向量表(占最后 6 字节)
|
|
28
|
+
* @returns {Range[]} 覆盖整个映像的段,按地址排序
|
|
29
|
+
*/
|
|
30
|
+
export function buildRanges({ kinds, base, hasVectors }) {
|
|
31
|
+
const body = hasVectors ? kinds.length - VECTOR_TABLE_SIZE : kinds.length;
|
|
32
|
+
const ranges = [];
|
|
33
|
+
for (let offset = 0; offset < body; offset += 1) {
|
|
34
|
+
const type = kinds[offset] === KIND_UNKNOWN ? 'ByteTable' : 'Code';
|
|
35
|
+
const last = ranges.at(-1);
|
|
36
|
+
if (last && last.type === type) last.end = base + offset;
|
|
37
|
+
else ranges.push({ start: base + offset, end: base + offset, type });
|
|
38
|
+
}
|
|
39
|
+
if (hasVectors) ranges.push({ start: base + body, end: base + kinds.length - 1, type: 'AddrTable' });
|
|
40
|
+
return ranges;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* 格式化十六进制地址。
|
|
45
|
+
* @param {number} address 地址
|
|
46
|
+
* @returns {string} 如 $C000
|
|
47
|
+
*/
|
|
48
|
+
function hex(address) {
|
|
49
|
+
return `$${address.toString(16).toUpperCase().padStart(4, '0')}`;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* 生成信息文件的内容。
|
|
54
|
+
* @param {{inputName: string, outputName: string, base: number, cpu?: string, ranges: Range[], labels: {name: string, address: number}[], includes?: string[]}} input 输入输出文件名、起始地址、CPU、各段、命名的地址与符号定义文件
|
|
55
|
+
* @returns {string} 信息文件内容
|
|
56
|
+
* @throws {FcdevError} 符号名不是合法的标识符
|
|
57
|
+
*/
|
|
58
|
+
export function renderInfo({ inputName, outputName, base, cpu = '6502', ranges, labels, includes = [] }) {
|
|
59
|
+
const lines = [
|
|
60
|
+
`GLOBAL { INPUTNAME "${inputName}"; OUTPUTNAME "${outputName}"; STARTADDR ${hex(base)}; CPU "${cpu}"; PAGELENGTH 0; };`,
|
|
61
|
+
...includes.map((file) => `ASMINC { FILE "${file.replaceAll('\\', '/')}"; };`),
|
|
62
|
+
];
|
|
63
|
+
const seen = new Set();
|
|
64
|
+
for (const { name, address } of labels) {
|
|
65
|
+
if (!IDENTIFIER.test(name)) throw new FcdevError(`符号名“${name}”不是合法的标识符`, { code: 'DISASM_SYMBOL_INVALID' });
|
|
66
|
+
if (seen.has(address)) continue;
|
|
67
|
+
seen.add(address);
|
|
68
|
+
lines.push(`LABEL { NAME "${name}"; ADDR ${hex(address)}; };`);
|
|
69
|
+
}
|
|
70
|
+
for (const range of ranges) lines.push(`RANGE { START ${hex(range.start)}; END ${hex(range.end)}; TYPE ${range.type}; };`);
|
|
71
|
+
return `${lines.join('\n')}\n`;
|
|
72
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:loaders.mjs
|
|
3
|
+
// 说明:读取待反汇编的文件:iNES(NROM)取出 PRG 与中断向量,平铺二进制按指定的加载地址处理。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:iNES 目前只支持映射器 0(NROM,16K 或 32K 的 PRG);其他映射器要先确定地址映射,不在首批范围。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
10
|
+
|
|
11
|
+
/** iNES 文件头长度 */
|
|
12
|
+
const INES_HEADER_SIZE = 16;
|
|
13
|
+
|
|
14
|
+
/** iNES 的 trainer 块长度 */
|
|
15
|
+
const INES_TRAINER_SIZE = 512;
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* @typedef {object} Image
|
|
19
|
+
* @property {Buffer} bytes 要反汇编的字节
|
|
20
|
+
* @property {number} base 第一个字节的 CPU 地址
|
|
21
|
+
* @property {{nmi: number, reset: number, irq: number}|null} vectors 中断向量;没有时为 null
|
|
22
|
+
* @property {string} description 来源说明,写进报告
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* 读取 iNES 文件的 PRG 部分。
|
|
27
|
+
* @param {Buffer} buffer 文件内容
|
|
28
|
+
* @returns {Image} PRG 映像:16K 映在 $C000,32K 映在 $8000
|
|
29
|
+
* @throws {FcdevError} 不是 iNES 文件、映射器不是 0,或 PRG 大小不是 16K 与 32K
|
|
30
|
+
*/
|
|
31
|
+
export function loadInes(buffer) {
|
|
32
|
+
if (buffer.length < INES_HEADER_SIZE || buffer.subarray(0, 4).toString('latin1') !== 'NES\x1a') {
|
|
33
|
+
throw new FcdevError('不是 iNES 文件(缺少 NES 文件头)', { code: 'DISASM_INPUT_INVALID' });
|
|
34
|
+
}
|
|
35
|
+
const mapper = (buffer[7] & 0xf0) | (buffer[6] >> 4);
|
|
36
|
+
if (mapper !== 0) {
|
|
37
|
+
throw new FcdevError(`暂不支持映射器 ${mapper}`, { code: 'DISASM_MAPPER_UNSUPPORTED', hint: '目前只支持 NROM(映射器 0);其他映射器可先导出某个 bank,用 --format binary 并指定加载地址' });
|
|
38
|
+
}
|
|
39
|
+
const prgSize = buffer[4] * 0x4000;
|
|
40
|
+
if (prgSize !== 0x4000 && prgSize !== 0x8000) {
|
|
41
|
+
throw new FcdevError(`NROM 的 PRG 应为 16K 或 32K,实际 ${prgSize} 字节`, { code: 'DISASM_INPUT_INVALID' });
|
|
42
|
+
}
|
|
43
|
+
const start = INES_HEADER_SIZE + (buffer[6] & 0x04 ? INES_TRAINER_SIZE : 0);
|
|
44
|
+
if (buffer.length < start + prgSize) {
|
|
45
|
+
throw new FcdevError('文件比 iNES 文件头声明的短', { code: 'DISASM_INPUT_INVALID' });
|
|
46
|
+
}
|
|
47
|
+
const bytes = buffer.subarray(start, start + prgSize);
|
|
48
|
+
return {
|
|
49
|
+
bytes,
|
|
50
|
+
base: 0x10000 - prgSize,
|
|
51
|
+
vectors: { nmi: bytes.readUInt16LE(prgSize - 6), reset: bytes.readUInt16LE(prgSize - 4), irq: bytes.readUInt16LE(prgSize - 2) },
|
|
52
|
+
description: `iNES NROM,PRG ${prgSize / 1024}K`,
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* 把平铺二进制当作映像。
|
|
58
|
+
* @param {Buffer} buffer 文件内容
|
|
59
|
+
* @param {{base: number}} options 第一个字节的 CPU 地址
|
|
60
|
+
* @returns {Image} 映像
|
|
61
|
+
* @throws {FcdevError} 文件为空,或超出 64K 地址空间
|
|
62
|
+
*/
|
|
63
|
+
export function loadBinary(buffer, { base }) {
|
|
64
|
+
if (buffer.length === 0) throw new FcdevError('输入文件是空的', { code: 'DISASM_INPUT_INVALID' });
|
|
65
|
+
if (base + buffer.length > 0x10000) {
|
|
66
|
+
throw new FcdevError(`从 $${base.toString(16).toUpperCase()} 起放不下 ${buffer.length} 字节(超出 $FFFF)`, { code: 'DISASM_INPUT_INVALID' });
|
|
67
|
+
}
|
|
68
|
+
return { bytes: buffer, base, vectors: null, description: `平铺二进制,加载地址 $${base.toString(16).toUpperCase()}` };
|
|
69
|
+
}
|