jsbeeb - JavaScript BBC Micro Emulator 技术文档

1. 安装指南

前提条件

• 安装 Node.js (https://nodejs.org/)
• npm（Node.js 自带）

安装步骤

1. 克隆仓库：

   git clone https://github.com/mattgodbolt/jsbeeb.git
   cd jsbeeb
   

2. 安装依赖：

   npm install
   

3. 启动本地服务器：

   npm start
   

4. 在浏览器中访问 http://localhost:8080/。

2. 项目使用说明

键盘映射

BBC Micro 的键盘与现代 PC 键盘有所不同，以下是一些常见的映射：

• BBC F0 对应 F10
• BBC Break 键对应 F12
• BBC * 键在 " 键上（如果不起作用，尝试按 shift-2）

要立即开始使用，请访问 https://bbc.xania.org/。要加载默认的磁盘映像（例如 Elite），请按 shift-F12（即 BBC 上的 shift-Break）。

URL 参数

• autoboot - 模拟 shift break
• disc1=XXX - 将磁盘 XXX（来自 discs/ 目录）加载到驱动器 1
• disc2=XXX - 同上
• disc1=local:YYY - 创建一个本地磁盘 YYY，该磁盘将保存在浏览器本地存储中
• disc1=sth:ZZZ - 从 Stairway to Hell 档案加载磁盘 ZZZ
• tape=XXX - 加载磁带 XXX（来自 tapes/ 目录）
• tape=sth:ZZZ - 从 Stairway to Hell 档案加载磁带 ZZZ
• patch=P - 应用内存补丁 P。详见下文。
• loadBasic=X - 将 'X'（服务器上的资源）作为文本加载，将其标记化并放入 PAGE，就像在模拟器中输入一样
• embedBasic=X - 将 'X'（URI 编码字符串）作为文本加载，将其标记化并放入 PAGE，就像在模拟器中输入一样
• autorun - 输入 *TAPE 然后 */ 从磁带运行。与 loadBasic 结合使用时，输入 RUN。
• autochain - 输入 *TAPE 然后 CH."" 从磁带运行。
• autotype - 输入你指定的内容。例如 &autotype=PRINT"Matt is cool"%0a（回车符 URI 编码为 %0a）
• embed - 移除屏幕周围的边距，隐藏大多数导航条目，并使页面背景透明（用于在第三方网站的 iframe 中运行时）。
• cpuMultiplier=X - 将 CPU 速度提高 X 倍。可以是分数或小于 1 以减慢 CPU 速度。注意，磁盘加载在 CPU 过慢时会变得不可靠，运行过快可能会导致浏览器挂起。
• sbLeft / sbRight / sbBottom - 在显示器左侧、右侧或下方放置的 URL。左侧和右侧应约为 648 像素高，底部图像应约为 896 像素宽。左侧和右侧宽度超过 300 可能会在较小屏幕上出现问题；底部高度超过 100 像素同样如此。
• videoCyclesBatch - 批量处理视频周期的数量。默认为零：任何更高的值都会导致模拟不准确。用于展示为什么即使效率较低，准确性也很重要。
• rom - 加载给定的 URL 或路径作为额外 ROM。如果提供 URL，则该 URL 必须允许跨站点请求。不支持 sth: 伪 URL，但如果是 ZIP 文件，将尝试使用其中的 .rom 文件。
• logFdcCommands, logFdcStateChanges - 打开磁盘控制器的日志记录。

3. 项目API使用文档

补丁

补丁可以通过 patch=P URL 参数应用。P 是一个分号分隔的补丁序列，格式为 @XXXX,YYYY:ZZZZZ,...，其中 @XXXX 指定断点 PC 地址，YYYY 是要修补的地址，ZZZZ 是要写入地址 YYYY 的数据。@ 部分是可选的，但有助于确保要修补的代码已加载。例如：patch=@31a6,0769:6e4c4d48465a，这是一个默认 Elite 映像的补丁。一旦 PC 达到 $31a6，0769 处的字节将被替换为 6e4c4d48465a。

从 GitHub Gists 加载 BASIC 文件

1. 创建一个包含你的代码的 gist。https://gist.github.com/ - 这里有一个 示例
2. 通过点击 "raw" 并复制 URL 获取 "Raw" 链接。在上面的例子中，URL 是：https://gist.githubusercontent.com/mattgodbolt/fc8d6f3d6e5e015dce399013719c8341/raw/bd5cb4314bfc3ee4330783ecf82cb329a36b915c/foo.bas
3. 将其添加到 "https://bbc.xania.org/?autorun&loadBasic=" 或类似内容之后，例如，此链接

注意，每次更新代码都需要生成一个新的 raw 链接。

4. 项目安装方式

本地运行

1. 克隆仓库：

   git clone https://github.com/mattgodbolt/jsbeeb.git
   cd jsbeeb
   

2. 安装依赖：

   npm install
   

3. 启动本地服务器：

   npm start
   

4. 在浏览器中访问 http://localhost:8080/。

在线使用

直接访问 https://bbc.xania.org/ 即可在线使用。