适用于 Apple II 的 ESP32 SoftCard 扩展卡
计算机家族

安装和用户手册

介绍

ESP32 SoftCard 旨在通过 ESP32 模块扩展 Apple II 系列计算机的功能。与原始 Z80 SoftCard 类似，它拥有自己的处理器，因此可以运行最初不适用于 Apple II 的软件。与原始 80 列卡类似，它也可以生成自己的复合视频。支持复合标准 NTSC、NTSC-50 和 PAL，用户可以使用命令在它们之间切换。此外，ESP32 SoftCard 还可以生成自己的 8 位声音，并通过 Apple IIspeaker 进行混合和播放。对于大多数应用程序，该卡还需要随附的 FAT32 格式的 microSD 卡。

从固件版本 3.07 开始，ESP32 SoftCard 具有以下功能：

• 运行 Doom。它是共享软件或完整 WAD。 files 和 MP3 音乐需要放在 SD 卡的文件夹中。
• 运行 Wolfenstein 3D。游戏的共享软件或完整版本需要位于 SD 卡的文件夹中。
• 模拟 Macintosh 经典版。ROM 和软盘/硬盘驱动器映像需要位于 SD 卡上。
• 模拟运行 DOS 和 Windows 3.0 的 IBM PC/XT 兼容机。软盘/硬盘驱动器映像需要位于 SD 卡上。
• 模拟世嘉 Master System、NES 和 TurboGrafx-16（日本又称为 PC Engine）。游戏 ROM 需要放在 SD 卡上。
• 播放存储在 SD 卡上的视频。PAL 或 NTSC-320 制式的最大分辨率为 240×50，常规 NTSC 制式的最大分辨率为 320×200。
• 通过 Wi-Fi 连接到互联网。
• 收听互联网音频流或播放 MP3 files 存储在 SD 卡上。
• 一个基本的 80×25 文本模式命令控制台，具有 30 多个不同的命令。
• 支持 Apple II 操纵杆。操纵杆可用于 Doom、Wolfenstein 3D、游戏机模拟器和 Macintosh 模拟器，在这些模拟器中，它既可以是普通操纵杆，也可以模拟鼠标。在 PC/XT 模拟器中，它可以控制箭头键，但不能模拟鼠标。
• 支持 Apple Mouse II。该鼠标可用于 Doom、Wolfenstein 3D、SMS、NES、TurboGrafx-16、Macintosh 模拟器和 PC/XT 模拟器。
• 支持单色显示器的 256 级灰度模式。
• 当添加新功能/错误修复时，可以从 SD 卡升级固件。
• 可以访问整个 SD 卡的 FTP 服务器。

硬件要求

该卡已在 Apple II+、Apple IIe 和 Pravetz 82 上进行了全面测试。一些早期采用者还证明它可以在 Apple IIgs、Laser 128、Pravetz 8C 和 Pravetz 8M 上正常工作。
ESP32 SoftCard 不是可启动卡，它需要 Disk II/Smartport 仿真设备，例如 FloppyEmu、CFFA3000 卡、Dan ][ 控制器、TJ Boldt ProDOS 卡等，或者带有至少一张空软盘的实际 Apple II 软盘驱动器。
该卡附带一条 20 英寸（50 厘米）视频线和一张 32 GB 的 microSD 卡。
更多信息请参见 Applefritter web网站或直接搜索“适用于 Apple II 的 ESP32 SoftCard”。

安装

ESP32 SoftCard 可安装在 Apple II/II+、IIe 或 IIgs 的任何空闲插槽中。Apple II CPU 上运行的程序会自动确定插槽。

视频循环
必须通过卡连接视频信号，以便它能够自动在 Apple II 复合视频信号和 ESP32 模块生成的复合视频之间切换。该卡配有一条 50 厘米 (20”) 视频线。它可用于将 Apple II 的复合视频输出连接到卡上标有 VIDEO IN 的下部 RCA 连接器。然后必须将显示器插入标有 VIDEO OUT 的上部 RCA 连接器。当卡未使用时，Apple II 视频信号只需通过 VIDEO IN 输入并通过 VIDEO OUT 输出即可。

音频循环
还必须通过卡连接 Apple II 扬声器才能发出声音。
随附的母对母跳线可用于将 Apple II 主板上的扬声器连接器连接到卡上标有 SPEAKER IN 的连接器。Apple II 扬声器本身必须插入卡上标有 SPEAKER OUT 的连接器。如果扬声器电缆不够长，则可以使用随附的公对母跳线作为延长线。
该卡经过专门设计，可通过反转 SPEAKER IN 连接器的正极和负极来防止任何损坏。因此，可以通过反复试验来确定正确的极性。只有极性正确时才会听到默认的 Apple II 启动蜂鸣声。

Apple II+/Apple IIe IIgs 跳线
如果 ESP32 SoftCard 安装在 Apple II/II+ 上，则必须关闭此跳线；如果安装在 Apple IIe 上，则必须打开。如果跳线设置不正确，则不会有损坏的风险，但会产生以下负面影响：对于 Apple II/II+，
Apple II 将会非常安静，而对于 Apple IIe 和 IIgs，当 Wi-Fi 运行时，扬声器可能会发出噪音。
开机蜂鸣
当 Apple II 通电时，ESP32 SoftCard 会发出自己的 2 kHz 启动蜂鸣声。
当声音连接正确时，可以在 Apple II 启动蜂鸣声后立即听到它，如本视频所示： https://www.youtube.com/watch?v=Jak6qlXeGTk

基本操作

ESP32 SoftCard 接口程序
ESP32 SoftCard 接口程序在 Apple II CPU 上运行，提供 Apple II 外围设备与 ESP32 SoftCard 之间的所有通信。它用汇编语言编写，可以在 DOS 3.3 或 ProDOS 下运行。它可以从 Apple II 软盘或任何 Disk II/SmartPort 仿真设备（如 CFFA3000 卡、Dan ][ 控制器、TJ Boldt ProDOS 卡等）加载。它还有自己的版本号，与 ESP32 SoftCard 固件的版本号无关。

接口程序有两种几乎相同的类型：ESP32NTSC 和 ESP32PAL。执行其中的哪一种将决定卡生成的复合视频信号的初始视频标准。这是必要的，因为有些 NTSC 显示器不支持 PAL，反之亦然。该卡支持这两种标准，用户可以通过在卡命令提示符中输入命令 PAL 或 NTSC 来在它们之间切换。但是，没有办法自动确定所连接的显示器支持哪种视频标准，因此如果例如amp如果卡始终以 NTSC 启动，一些 PAL 显示器将只显示空白屏幕，并且用户永远不会看到卡的命令提示符。

以下 ZIP file 包含 DOS 3.3 和 1.0 版的 ProDOS 映像：
ESP32 SoftCard 接口程序 v1.0.zip（所有 Apple ][, ][+, //e）
ESP32 SoftCard 接口程序 v1.0.C.zip（IIgs 和克隆）

一旦执行 ESP32NTSC 或 ESP32PAL，屏幕上会快速显示以下内容，然后视频信号切换到卡生成的信号：

ESP32 SoftCard 的命令提示符
一旦视频切换到 ESP32 SoftCard，所有键盘、操纵杆和鼠标事件都会由界面程序发送到卡上。用户会看到一个 80×25 的文本屏幕和一个命令提示符。有 30 多个不同的命令可用，输入 HELP 可查看列表和简短说明。上下箭头键以及Apple IIe 上的 键可用于循环显示这些命令。这些命令不区分大小写，尽管它们以大写字母列出。左箭头和Apple IIe 上的键充当退格键，而按下清除当前输入的命令。

命令列表

哔声或– 发出非常短的 2 kHz 蜂鸣声
嘟– 发出指定持续时间的 2 kHz 蜂鸣声
HOME 或 CLS – 清除屏幕并将提示放在顶行
NTSC – 将复合视频标准切换为 NTSC
NTSC-50 或 NTSC50 – 将复合视频标准切换为 NTSC-50
PAL – 将复合视频标准切换为 PAL
标准 – 显示当前复合视频标准
标准– 切换到指定的复合视频标准
扫描 – 执行 Wi-Fi 网络扫描并列出结果
连接 – 执行网络扫描后连接到 Wi-Fi 热点
CONNECT <#> – 连接到数字指定的热点
连接– 连接到指定 SSID 的热点
断开连接 – 断开与当前连接的热点的连接
FTPSERVER – 在端口 21 上启动 FTP 服务器
FTPSERVER ANONYMOUS – 启动 FTP 服务器并仅允许匿名用户
FTP服务器– 启动 FTP 服务器并禁止匿名用户
FTPSERVER STOP – 停止 FTP 服务器
IPCONFIG 或 IP – 显示 IP 信息
MEMORY 或 MEM – 显示当前内存使用情况
FONT – 显示系统字体的所有字符
操纵杆 – 测试并校准操纵杆（如果有）
鼠标 – 测试并配置 Apple Mouse II（如果存在）
屏幕 – 调整屏幕上的图像位置
SYSTEM – 显示各种系统信息
TASKS – 列出所有当前正在运行的任务
更新 – 从 SD 卡更新固件
EXIT – 退出 ESP32 SoftCard 接口程序并返回 Basic
重启 – 重启 ESP32 SoftCard，无需返回基本模式
DOOM – 启动放置在 /Doom 中的 Doom 版本
WOLF3D – 启动位于 /Wolf3D 中的 Wolfenstein 3D 版本
TG16 或 PCE – 启动 TurboGrafx-16（又名 PC Engine）模拟器
SEGA 或 SMS – 启动 Sega Master System 模拟器
NINTENDO 或 NES – 启动 Nintendo Entertainment System 模拟器
MACINTOSH 或 MAC – 启动 Macintosh Classic 模拟器
PC – 启动 IBM PC/XT 兼容模拟器
视频 – 以浏览模式启动视频播放器，播放位于 /Videos 中的视频
LISTEN – 列出 /AudioStreams.txt 中的所有互联网音频流
LISTEN <#> – 收听由数字指定的音频流
玩filename/video> – 播放指定的 MP3 file 或来自 /Videos 的视频
播放<#> – 播放 MP3 file 或 /Videos 中按数字指定的视频
暂停 – 暂停当前 MP3 或音频流播放
恢复 – 恢复暂停的 MP3 或音频流播放
STOP – 停止当前 MP3 或音频流播放
VOLUME <#> – 更改 MP3 或音频流播放的音量
CATALOG 或 CAT 或 DIR – 列出当前目录
PREFIX 或 CD – 显示当前目录的名称
PREFIX <#> 或 CD <#> – 更改当前目录（由数字指定）
字首或 CD – 更改当前目录（按名称指定）
和– 调整屏幕横屏位置
和– 调整屏幕垂直位置
– 重置屏幕水平和垂直调整
– 切换小写（仅适用于 Apple II/II+）

音频输出
一些 80 年代的显示器（如上图的飞利浦显示器）有内置扬声器和音频 amp放大器。尽管该卡没有外部音频连接器，但对于任何焊接技能不高的人来说，添加一个连接器相当容易。所需的连接器可以放置在原型区域的任何位置，需要连接到地线和 RV3 电位计的顶部引脚，如下所示：
警告 – SPEAKER OUT 连接器不能且不得用于此目的，因为它未接地。

使用 ESP32 SoftCard 接口和卡带端口创建启动盘
如前所述，可以从此链接下载包含接口程序的 DOS 3.3 或 ProDOS 映像： ESP32 SoftCard 接口程序 v1.0.zip 并且它可以在任何 Disk II/SmartPort 仿真设备中使用，例如 CFFA3000 卡、Dan ][ 控制器、TJ Boldt ProDOS 卡等。但是，如果用户只有一个软盘驱动器而没有这些现代卡，那么创建包含 ESP3.3NTSC 和 ESP32PAL 的 DOS 32 或 ProDOS 启动盘仍然很容易。

为此，可以使用普通的 3.5 毫米 AUX 音频线将 Apple II 的 Cassette In 端口与智能手机或笔记本电脑一起使用。步骤如下：

1. 将磁盘 [ 接口卡放在插槽 6 中，并将软盘连接到驱动器 1。此操作在任何其他插槽中都不起作用。
2. 使用 AUX 音频线将 Cassette In 端口连接到智能手机或笔记本电脑的耳机端口。之后确保音量调到最大。
3. 如果驱动器中没有软盘，请打开 Apple II，然后点击。这将导致驱动器停止旋转，机器将启动进入基本模式。
4. 将空软盘插入软盘驱动器并关闭软盘驱动器盖。
5. 在 Basic 提示符下输入 LOAD 并点击
6. 通过智能手机或笔记本电脑玩两个 AIF 之一 fileZIP 档案中包含的内容： ESP32 SoftCard v1.0.AIFs_.zip

然后只需等待并按照屏幕上的说明进行操作。整个过程只需不到 2 分钟，完成后机器将从新格式化的软盘重新启动。

ESP32 SoftCard 视频转换器
ESP32 SoftCard 有一个视频播放器，能够播放最大分辨率为 320×200 的 NTSC 和 320×240 的 PAL 的视频。它还能够使用箭头键以 15 倍的速度快进和快退。但是，ESP32 的功能不足以播放任何视频格式并将其缩小到 NTSC 或 PAL 图形分辨率。这就是为什么必须使用现代 PC 对视频进行预转换和重新编码的原因。有一个适用于 Windows 的小工具可以批量转换多种格式的多个视频。

ESP32 SoftCard 视频转换器 v1.0
ESP32 SoftCard 视频转换器 v1.0.zip（Windows）
ESP32_SoftCard_Video_Converter.zip（MacOs 和 Linux）
此工具使用 FFmpeg 将多种不同格式和任何分辨率的视频转换为 ESP32 SoftCard 可以播放的格式。对于每个视频，它都会创建一个单独的子目录并生成 10 个不同的 files，NTSC 为 5，PAL 为 5。
如果未提供缩略图，它还会为每个视频自动生成缩略图。当 ESP32 SoftCard 的视频播放器处于浏览模式时，屏幕上会显示此缩略图。

用法：

1. 提取 ZIP 的内容 file 放入您电脑上的一个单独目录中。
2. 将所有 4:3 视频放在子目录 InputVideos4by3 中，将所有 16:9 视频放在子目录 InputVideos16by9 中。
3. 运行 Go.bat 并等待“全部完成”消息。这可能需要一段时间，具体取决于视频数量和 PC 的速度。
4. 将 OutputVideos 子目录的全部内容复制到 SD 卡上的 /Videos。每个视频都需要位于其自己的子目录中。

重要的： SD 卡上的 /Videos 目录不应包含任何 files，只是子目录。
转换还将为每个视频生成一个缩略图，并将其放置在与输入视频相同的目录中（如果未提供）。amp 自动生成的缩略图的格式在 Go.bat 中定义，可以更改。如果提供了缩略图，则不会覆盖它。缩略图具有相同的 file将其命名为视频，但使用 .PNG 扩展名。一种策略是运行一次转换以生成所有缩略图，根据需要修改它们，然后再次运行。

以下是生成的 10 个 file观看名为 Ex 的视频ample.mp4：

1. Example.ntsc.ts – 带声音的 NTSC 主播放视频
2. Example.ntsc.fwd.ts – 15 倍速快进版无声视频
3. Example.ntsc.rwd.ts – 15 倍速倒放版无声视频
4. Example.ntsc.idx – 索引 file 用于 FF 和 Rewind 期间的同步
5. Example.ntsc.img.ts – 浏览模式下显示的视频缩略图
6. Example.pal.* – 其他 5 个 files 代表 PAL，与上面描述的相同

ESP32 SoftCard 视频转换器的内容：

• InputVideos4by3 – 一个空的子目录，所有 4:3 视频都应放在其中，以供用户进行转换
• InputVideos16by19 – 一个空的子目录，所有 16:9 视频都应放在其中，以供用户进行转换
• OutputVideos – 一个空目录，转换过程中所有转换后的视频都将放置在该目录中，每个视频都位于自己的子目录中
• Convert.bat – 批处理 file 生成 5 种不同的 file通过调用 ffmpeg.exe。此批处理 file 仅由Go.bat调用
• Go.bat – 批次 file 转换 InputVideos4by3 和 InputVideos16by9 中的所有视频
• ReadMe.txt – 如何使用该工具的说明
• ffmpeg.exe – FFmpeg 的 3 个可执行文件之一。它负责所有繁重的工作。
  下载自： https://ffmpeg.org
• VideoIndexer.exe – 用 C 编写的小型命令行实用程序，用于生成索引 file
• VideoIndexerSource.zip – VideoIndexer.exe 的 C 源代码

固件修订历史：

v1.00
– 初始全功能版本
v1.01
– 视频播放器：由于纵横比不同，为 PAL 和 NTSC 添加了单独的视频。
– 视频播放器：修复了导致图片在 NTSC 中无法水平居中的错误。
v1.02
– 毁灭战士：修复了在关卡完成屏幕之前第一关结束时发生的崩溃问题。
– Doom：当用户保存游戏和退出 Doom 时，设置将被保存。
– 音频播放器：在未连接到互联网时执行 LISTEN 命令现在将启动 Wi-Fi 连接。
– 音频播放器：增加了 LISTEN 命令的超时时间，之前只有 250 毫秒 – 当流媒体站点太远时，超时时间不够。
– 音频播放器：现在在启动 Doom、Wolfenstein 3D、视频播放器或任何模拟器之前将停止播放。
– SD 卡：列出目录将不再显示子目录和 file以点开头。
v1.03
– Wi-Fi：连接超时时间从 10 秒增加到 20 秒。
– 音频播放器：修复了 MP3 播放结束时有时发生崩溃的问题。
– 视频播放器：将 SBC 编解码器的缓冲区加倍至 8K，以避免缓冲区溢出导致音频爆音。
v1.04
– 为较旧的 NTSC 彩色 CRT 电视和显示器添加了 NTSC-50 复合视频标准 (320×240)。要切换，只需输入 NTSC-50。
– 视频播放器：修复尝试播放未转换的视频或放置在 /Videos 目录中的 MP3 时发生崩溃的问题。
– 命令提示符：命中现在循环回到第一个命令，而不是仅仅停在最后一个命令。
v1.05
– Sega/Nintendo 模拟器：修复 NTSC-50 中错误的声音频率。
v1.06
– 鼠标：增加了使用 MOUSE 命令反转鼠标 X 轴或 Y 轴的功能。
– SD 卡：SYSTEM 命令现在还显示 SD 卡的扇区数和扇区大小。
v1.07
– Mac 模拟器：将 Mac 模拟器可用的内存从 2.5 MB 增加到 3 MB。
– Mac 模拟器：从子目录执行 MAC 命令将加载在该子目录中找到的 Mac ROM 和磁盘映像。
– Sega/Nintendo 模拟器：从子目录执行 SEGA 或 NINTENDO 命令将只显示该子目录中的 ROM。
v1.08
– 修复了 ESP32 SoftCard 托管在 Apple IIgs 内部时出现的视频噪音问题。
– 任天堂：修复了首次启动游戏“Blades of Steel”时导致 NTSC 视频中断的问题。
—–
v2.00
– 添加了 TurboGrafx-16（又名 PC Engine）游戏机模拟器。
要开始，只需输入 TG16 或 PCE。
v2.01
– 命令提示符：更新帮助屏幕以包含 TG16/PCE 命令。
– TurboGrafx-16：修复了导致某些游戏在重新启动时进入 PAL 上不受支持的图形模式的错误。
v2.02
– FTP 服务器：修复了在传输大量文件时导致随机断开连接的错误 files.
– FTP 服务器：修复了导致非匿名用户无法连接的错误。
– FTP 服务器：传输速度从约 1 Mbps 提高到约 2 Mbps。
– 音频播放器：修复了导致 HTTPS 的错误 URL无法连接。现在它们可以正确地默认为 HTTP。
– 音频播放器：修复了导致某些 URL斜杠后带冒号则失败。
– 音频播放器：修复了导致流名称过长或过长的错误 URLs 来破坏 LISTEN 命令表。
—–
v3.00
– 添加了 IBM PC/XT 兼容模拟器。要启动，只需输入 PC。
– 增加了使用以下方式切换小写的功能当主机是Apple II+时。
– 音频播放器：修复了导致流速度达到 48K s 的错误amp以速率跳过。
v3.01
– Wi-Fi 无线电现在处于关闭状态，直到需要时才开启。这样可将卡的功耗降低 70 mA。
- 命令提示符：修复了使用 CONNECT 时导致 Wi-Fi 密码保持未屏蔽的错误
– 命令提示符：修复了使用 CONNECT 时导致 SSID 中的空格被删除的错误
v3.02
– PC 模拟器：使 Hercules/MDA 垂直同步要求与 Macintosh 模拟器的要求相同。
– PC 模拟器：修复了在所有没有操纵杆的 Apple II+ 上无法输入数字或按下鼠标左键的错误。
– PC 模拟器：修复了选择 TGA 或 CGA 时导致所有 Sierra On-Line AGI 游戏无法正确显示的错误。
– PC 模拟器：修复了在动态更新调色板的游戏中，256 色 MCGA 模式下颜色不正确的错误。
v3.03
– 视频播放器：修复了使用 PAL 将屏幕移动到最右侧时发生崩溃的问题
v3.04
– Mac 和 PC 模拟器：为等离子/LCD/LED 电视和显示器添加了 NTSC 中的 480i 和 PAL 中的 576i 选项。
– Mac 模拟器：添加了一个表格，显示将要安装的磁盘映像，类似于 PC 模拟器。
v3.05
– NES 模拟器：修复了导致超级马里奥兄弟 3 的声音在 NTSC 上出现故障的错误。
v3.06
– SMS 模拟器：修复了 v3.00 中出现的一个主要错误，该错误导致 NTSC 上的某些游戏出现故障。
v3.07
– PC 模拟器：修复了使用某些程序退出后导致性能下降的错误。

文件/资源

Tindie ESP32 SoftCard 扩展卡 [pdf] 用户手册 ESP32 SoftCard 扩展卡,ESP32,SoftCard 扩展卡,扩展卡,卡

参考

• 用户手册