返回资讯中心
外部精选
软件工程
#开发者实时流

Retrocore 用单一 .NET 代码库模拟并调试 Apple II、TRS-80 等 8 位电脑

来源标题:Retrocore emulates+debugs 8-bit computers in one .NET codebase, Apple II,TRS-80

Retrocore 在同一个 .NET 代码库中实现对 8 位电脑的模拟与调试,覆盖周期精确的 CPU、外设、汇编器/反汇编器、BASIC 工具及源码级调试器,并提供 VS Code 扩展。项目将各机型 ROM 以带注释的汇编源码形式维护,可字节级重建原始芯片,无需外部 ROM 转储。目前尚未在 VS Code Marketplace、Open VSX 或 NuGet 公开发布,需从仓库自行构建安装 VSIX。

Hacker News 最新shanselman2026/11/12 · 5 天前27 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Retrocore 在一个 .NET 代码库中模拟并调试 8 位计算机:周期精确的 CPU、围绕这些 CPU 构建的机器与外设、多方言汇编器与反汇编器、BASIC 语言与程序工具、面向汇编与 BASIC 的源码级调试器,以及一个 VS Code 扩展。

每台机器的 ROM 也在这里以带文档的汇编源码形式维护,重新构建后可与原始芯片逐字节一致。运行或调试一台机器无需任何外部 ROM dump,你可以从自己的代码直接单步进入 ROM 或 DOS 源码。

Disk II 控制器的引导 ROM 与状态序列器 ROM、Apple DOS 3.3 和 3.2,以及模拟的 7 号插槽 ProDOS 块设备固件,也都是带文档的 SDK 源码。硬件细节与启动选项参见 Apple II 系列和 TRS-80 Model I 指南。

尚未发布。Retrocore 在 VS Code Marketplace、Open VSX 和 NuGet 上均无公开发布版本。要使用 VS Code 扩展,请按以下方式从本仓库构建并安装 VSIX。

.\tools\Install-Extension.ps1

该脚本会:

之后请重新加载 VS Code 窗口。每当你想更新已安装的副本时,重新运行该脚本即可。

如果只想构建 VSIX(例如,安装到另一台机器上):

.\tools\Install-Extension.ps1 -PackageOnly

把 .vsix 文件复制过去,在命令面板中用 Extensions: Install from VSIX... 安装,或运行 code --install-extension retrocore-<version>.vsix。打包后的宿主是框架依赖的,因此那台机器需要 .NET 10 运行时,但不需要 .NET SDK、Node.js、touki,也不需要任何 ROM dump。若想在开发时于独立的开发窗口中直接运行仓库内的扩展,参见 Installing and self-hosting。

;; 注释以任意方言记录例程、常量、结构和表。语言服务器在悬停提示和补全中渲染它们,并检查其中的链接和寄存器列表;调试器在 Variables 视图中显示例程参数,并在调用返回时校验 Keeps: 和 Uses: 约定;源码生成器则把摘要复制到生成的 C# XML 文档中(DocComments.md)。

在 VS Code 中,汇编文件可获得语法高亮、输入时的实时诊断、转到定义、查找所有引用、悬停提示(指令摘要、标志、寻址模式、周期数和生成的字节)、补全、文档大纲,以及跨你的代码和 SDK ROM 的工作区符号搜索(Language features)。

Retrocore 支持 AppleSoft BASIC、Integer BASIC 和 TRS-80 Level II BASIC(Level I BASIC 已列入计划):

每台机器都会出现在 VS Code 的 Run and Debug 下拉菜单中,Retrocore: Start Machine… 可以裸启动一台机器,也可以附带汇编源码、二进制、BASIC 文件、磁盘映像或磁带启动——无需 launch.json(Starting a machine)。在 launch.json 中,一个配置指定一台机器("apple2" 或 "trs80-model1"),并可自行启动该机器、汇编源码(直接写入 RAM,或写入一张全新的可引导 DOS 3.3 或 3.2 磁盘)、加载程序二进制(可选带 cc65 .dbg 或 VICE 标签)、运行 basic 文件,或挂载介质。

你的程序和 SDK 的 ROM 与 DOS 源码在同一会话中一起调试。每个源码模块都绑定到其内存 bank,并且仅当内存中仍保存着它汇编生成的字节时才处于活动状态,因此分 bank 的 RAM 或被覆盖的代码绝不会显示过期的源码行。扩展的 README 涵盖了所有启动选项;Apple II 和 Model I 指南则分别涵盖各台机器。

源码 覆盖内容 Monitor.asm Apple II Monitor,$F800–$FFFF:II 的原始 Monitor、II 和 II Plus 的 Autostart Monitor,以及两款 IIe 机型的 Monitor。 Firmware.Original.asm、Firmware.Enhanced.asm IIe 内部的 $C100–$CFFF 固件,共用 FirmwareEquates.asm。 IIeEquates.asm、MonitorEntries.asm 共享的 IIe 零页位置、软开关和键码(IIeEquates.asm,Monitor 也会包含它)以及 Monitor 入口点(MonitorEntries.asm),由固件、Disk II 引导 ROM 和 DOS 包含。 Boot16.asm、Sequencer16.asm、Boot13.asm、Sequencer13.asm Disk II 控制器的 16 扇区和 13 扇区引导 ROM 及逻辑状态序列器,共用 Boot.asm 和 Sequencer.asm;参见 DiskII.md。 applesoft.mac 用于 II Plus 和 IIe 的 AppleSoft II,作为 MACRO-10 overlay 覆盖在 Microsoft 的 m6502.asm 之上。 IntegerBasic.asm Apple II 的 Integer BASIC ROM,$E000–$F7FF,包括其浮点包、Mini-Assembler 和 SWEET16。 ProgrammersAid.asm Programmer's Aid #1,II 的 $D000–$D7FF ROM,包含 Integer BASIC 实用工具。 CharacterGenerator.asm IIe 的视频 ROM(两款机型,包括 MouseText)以及 II 和 II Plus 的字符生成器。 Dos33.asm、Dos32.asm Apple DOS 3.3(1983 和 1980)和 DOS 3.2:既包括 System Masters 的 0–2 磁道,也包括重定位到 $9D00 的 DOS;参见 Dos.md。 Slot7.rom.asm 模拟的 7 号插槽 ProDOS 块设备的 256 字节引导与驱动 ROM,$C700–$C7FF。 Level2.asm TRS-80 Model I Level II BASIC,修订版 1.2 和 1.3。 Level1.asm TRS-80 Model I Level I BASIC。 CharacterGenerator.asm Model I 原装的 MCM6670P 字符生成器。 CharacterGeneratorKit.asm Radio Shack 小写套件的字符生成器,遵循 xtrs 的重建(目前未知有任何芯片 dump)。

所有 ROM 源码均为手工维护。自动化测试用 SHA-256 固定每一次构建——因此验证它们无需 ROM dump——并且在存在 dump 时,还会与你的芯片 dump 逐字节比对。

项目 内容 Retrocore.Core 共享的指令集(Isa)、CPU、总线和机器/设备抽象。 Retrocore.Cpu.M6502 周期精确的 6502 系列:NMOS 6502、WDC 65C02 和 Rockwell 65C02,及其操作码表。 Retrocore.Cpu.Z80 T 状态精确的 Z80,支持未文档化的标志和 MEMPTR,及其指令集。 Retrocore.Assembler 多方言汇编器(native、ca65、Merlin、MACRO-10)、反汇编器、流分析和 ;; 文档解析器。 Retrocore.Basic AppleSoft、Integer BASIC 和 Level II BASIC:分词器、列表输出、基于标签的源码编译、诊断、表达式求值、重新编号、分词文件以及 Model I 磁带。 Retrocore.Media

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →