IBMulator 开源项目安装与使用教程

IBMulator 开源项目安装与使用教程

IBMulator The IBM PS/1 emulator. 项目地址: https://gitcode.com/gh_mirrors/ib/IBMulator

1. 项目目录结构及介绍

IBMulator 是一个开源的 IBM PS/1 模拟器，其项目目录结构如下：

IBMulator/
├── AUTHORS
├── BUILD_LINUX.md
├── BUILD_WINDOWS.md
├── COPYING
├── ChangeLog
├── INSTALL
├── KEYMAPS.md
├── Makefile.am
├── NEWS
├── README
├── README.md
├── SHADERS.md
├── configure.ac
├── renderdoc.cap
├── src/
│   ├── 其他源代码文件
│   └── ...
├── extra/
│   ├── 其他辅助文件
│   └── ...
└── ibmulator.ini

目录结构说明：

• AUTHORS: 项目作者列表。
• BUILD_LINUX.md 和 BUILD_WINDOWS.md: 分别针对 Linux 和 Windows 系统的构建指南。
• COPYING: 项目许可证文件，遵循 GPL-3.0 许可证。
• ChangeLog: 项目更新日志。
• INSTALL: 项目安装指南。
• KEYMAPS.md: 键盘映射配置说明。
• Makefile.am: 自动生成 Makefile 的配置文件。
• NEWS: 项目新闻和更新信息。
• README 和 README.md: 项目介绍和使用说明。
• SHADERS.md: 着色器配置说明。
• configure.ac: 自动配置脚本。
• renderdoc.cap: 用于调试的文件。
• src/: 包含项目的源代码文件。
• extra/: 包含一些辅助文件和工具。
• ibmulator.ini: 项目的配置文件。

2. 项目启动文件介绍

IBMulator 的启动文件主要是 src/ 目录下的源代码文件。要启动 IBMulator，首先需要编译源代码。编译步骤如下：

在 Linux 系统上：

1. 打开终端并导航到项目根目录。
2. 运行 ./configure 脚本进行配置。
3. 运行 make 命令进行编译。
4. 编译完成后，运行 ./src/ibmulator 启动模拟器。

在 Windows 系统上：

1. 打开命令提示符并导航到项目根目录。
2. 按照 BUILD_WINDOWS.md 中的指南进行编译。
3. 编译完成后，运行生成的可执行文件 ibmulator.exe 启动模拟器。

3. 项目的配置文件介绍

IBMulator 的配置文件是 ibmulator.ini，该文件包含了模拟器的各种配置选项。以下是一些关键配置项的介绍：

[system]
romset=path/to/romset.bin

[drives]
fdc_type=raw

[audio]
sound_card=sb16

[video]
shader=retro

配置项说明：

• [system]: 系统配置部分，主要配置 ROM 文件路径。
  • romset: 指定 ROM 文件的路径。
• [drives]: 驱动器配置部分，主要配置软盘驱动器的类型。
  • fdc_type: 指定软盘驱动器的类型，可以是 raw 或 flux。
• [audio]: 音频配置部分，主要配置声卡类型。
  • sound_card: 指定声卡类型，如 sb16。
• [video]: 视频配置部分，主要配置着色器类型。
  • shader: 指定使用的着色器类型，如 retro。

通过修改 ibmulator.ini 文件中的配置项，可以自定义 IBMulator 的运行环境。

IBMulator The IBM PS/1 emulator. 项目地址: https://gitcode.com/gh_mirrors/ib/IBMulator