安装

1. 确保您已安装C编译器和CMake以构建捆绑的 sdl2
2. (Linux特定) 安装所需的开发包：libasound2-dev
3. 使用cargo安装它

cargo install rustzx

如何使用

rustzx --help # Show help
rustzx test.tap # Autodetect file type and run in 48K mode
rustzx --ay test.tap # Run in 48K mode with AY sound chip
rustzx -m128 --tape test128.tap # Run in 128K mode with tape
rustzx --rom tester.rom -s3 # Run with custom rom and 3x screen scaling
rustzx --nofastload test.tap # Run without fast tape loading
rustzx --mouse test.tap # Run with Kempston mouse support

要在48K模式下加载磁带，请按 j 然后按 Ctrl+p 两次，就像在真实的Spectrum上一样。您应该在模拟器的屏幕上看到 LOAD ""，然后按 Enter（在128K模式下只需按回车键）。在 --nofastload 模式下，按 Insert 播放磁带，按 Delete 停止

如果您有断断续续的音频，请尝试使用更大的值 --sound-latency 选项。

默认按键绑定

• F1 - 快速保存
• F2 - 快速加载
• F3 - 设置正常模拟速度
• F4 - 设置2倍模拟速度
• F5 - 可能的最大模拟速度
• F6 - 启用帧跟踪信息
• F9 - 启用kempston/sinclair joy键盘层
• Insert - 开始磁带
• Delete- 停止磁带
• End - 中断命令
• Caps Lock - 大写锁定命令
• Backspace - 删除
• <Arrows> - 128K箭头键
• Esc - 解锁鼠标（如果使用 --mouse）

在joy键盘层模式（F9）下

• <Arrows> - Kempston joy 箭头
• Alt - Kempston 射击
• WASD- Sinclair Joy 1 箭头
• Caps Lock - Sinclair Joy 1 射击
• IJKL- Sinclair Joy 2 箭头
• Enter - Sinclair Joy 2 射击

屏幕截图

参考资料

为了找到如何构建这个模拟器，使用了许多资源。向以下帮助了解ZX Spectrum许多细节的资源表示衷心的感谢：

• 当然 z80.info
  • 解码Z80操作码
  • 操作码列表
  • CPU用户手册
  • CPU架构
  • 中断行为
  • Z80未记录的记录
• 来自 ClrHome 的指令表
• 由 Ramsoft 的“Floating bus explained!”
• 16K / 48K ZX Spectrum 参考
• 128K ZX Spectrum 参考
• Z80硬件组织
• disassembler.io 在线反汇编器
• Cool z80汇编器 zasm
• 由 Phill 的诊断ROM
• zx-modules.de - 优秀资源，去看看！
• speccy.info
• Harlequin
• 以及许多其他优秀材料，这些材料帮助我制作了rustzx！
• FUSE 模拟器源代码，用于找到正确的定时
• YAZE测试套件
• z80test测试套件
• ROM 程序

ROM

模拟器包含 ROM，由 Sinclair Research Ltd（现由 Amstrad plc 拥有）创建。Amstrad 已经授权与模拟器一起分发其 ROM。在 RustZX 中，这些 ROM 包含在核心模拟器库的源代码中 mod rustzx_core::zx::roms。可以通过禁用功能 embedded-roms 从核心库中排除嵌入的 ROM。