硬核改造：用示波器XY模式运行《雷神之锤》的嵌入式图形实践

1. 项目概述：当示波器遇上《雷神之锤》

如果你觉得用游戏手柄、键盘鼠标玩《雷神之锤》已经没什么新意，那么试试用一台示波器来通关，是不是听起来就像科幻电影里的情节？这可不是天方夜谭，而是一群硬核技术爱好者们捣鼓出来的真实项目。本质上，这是将一台本用于观测电信号波形、调试电路的专业仪器——示波器，改造成了一台能运行经典第一人称射击游戏《雷神之锤》的“游戏机”。

这个项目的魅力，远不止于“炫技”。它深刻地体现了硬件黑客文化的精髓：打破工具的固有边界，探索其底层原理的极限。示波器自带的显示系统（通常是矢量扫描或光栅扫描）和基本的输入控制（如旋钮、按钮），在工程师手中被重新定义。他们不是简单地“移植”一个游戏，而是深入理解了《雷神之锤》的渲染管线、游戏逻辑，并巧妙地利用示波器的硬件特性，将数字世界的图像和交互，“翻译”成示波器能够理解和显示的模拟信号。这个过程，涉及到从软件逆向、图形渲染原理，到硬件信号生成、实时系统编程等一系列跨领域的硬核技术。

对于硬件爱好者、嵌入式开发者，以及任何对计算机图形学底层实现感兴趣的人来说，这个项目都是一个绝佳的学习范本。它让你跳出高级API和现成引擎的舒适区，直面最原始的像素和信号。通过复现它，你不仅能重温《雷神之锤》这部图形史上的里程碑之作，更能亲手触摸到计算机图像从数字到模拟、从数据到光点的完整诞生过程。接下来，我们就来彻底拆解这个疯狂想法背后的每一个技术环节。

2. 核心思路与架构设计

2.1 为什么是示波器？—— XY模式与矢量显示原理

要理解这个项目的可行性，首先要明白示波器一种特殊的工作模式：XY模式。在普通模式下，示波器的X轴（水平）代表时间，Y轴（垂直）代表电压，从而显示信号随时间的变化。而在XY模式下，X轴和Y轴都代表电压，分别由两个独立的输入通道（CH1和CH2）控制。此时，屏幕上的光点位置（X, Y）直接由（CH1电压， CH2电压）的瞬时值决定。

如果我们能控制一个电路，让它按照特定的时序和规律，高速地输出两路模拟电压信号，分别接入示波器的CH1和CH2，并设置为XY模式，那么理论上，我们就能让光点在屏幕上“画”出任何我们想要的图形。这就是矢量图形显示的基本原理。早期的街机游戏如《Asteroids》（爆破彗星）和某些飞行模拟器，采用的就是这种矢量显示器。

《雷神之锤》虽然是光栅化3D游戏，但其每一帧的输出，本质上依然是屏幕上一系列需要被点亮的位置坐标（对于线框模式或简单渲染而言，可以抽象为一系列线段和点）。我们的目标，就是生成两路信号，让它们精确地对应游戏世界中每一帧需要显示的所有像素点的X和Y坐标，并高速、连续地刷新。

2.2 系统架构总览：从游戏到光点

整个系统的架构可以分解为一个清晰的信号链：

1. 游戏逻辑与精简渲染引擎：我们需要一个能在资源受限环境下运行的《雷神之锤》游戏逻辑核心。这通常意味着对原版游戏代码进行大幅裁剪，剥离复杂的纹理映射、光照模型，保留最基本的几何变换、碰撞检测和游戏状态机。输出的是每一帧需要显示的“图元”列表，比如线段（用于绘制墙壁边框）、点（用于绘制敌人或物品）的屏幕空间坐标。
2. 坐标到电压的转换与DAC（数模转换）：游戏引擎输出的坐标是数字值（例如，X坐标0-639，Y坐标0-479）。我们需要一个微控制器（如STM32、ESP32或更古老的AVR）来读取这些坐标数据，并通过其内置的DAC模块或外接DAC芯片，将它们实时转换为两路模拟电压信号。这里有一个关键的映射关系：数字坐标范围必须线性映射到DAC的输出电压范围（例如0-3.3V），而这个电压范围又对应示波器屏幕的满量程显示范围。
3. 同步与消隐信号（Z轴调制）：仅仅有XY信号是不够的。示波器的电子枪在移动光点时，如果不需要显示，应该关闭（消隐），否则屏幕上会拖出长长的亮线，破坏图像。这就需要第三路信号：Z轴输入（或称为亮度调制输入）。当需要“画”线或点时，Z轴给一个高电平（或特定电压）让电子枪发射；在光点从一个位置快速移动到另一个位置的过程中（回扫期），Z轴给低电平关闭电子枪。微控制器需要精确控制这第三路信号，与XY信号完美同步。
4. 示波器作为显示终端：最终，这三路信号（X电压， Y电压， Z开关）接入示波器。示波器设置为XY模式，并将Z轴输入功能打开（如果有的话；如果没有，可能需要改造或使用亮度调制技巧）。调整示波器的电压/格档位，使图像居中并充满屏幕。

2.3 硬件平台选型考量

选择什么样的硬件来驱动这个系统，是第一个关键决策。

• 方案A：现代高性能微控制器（如STM32H7系列、ESP32-S3）：

  • 优势：主频高（数百MHz），有足够的计算能力运行精简后的游戏逻辑；通常集成高速DAC（12位）和DMA（直接存储器访问），可以极大地减轻CPU负担，实现稳定、高速的信号输出；开发环境（如STM32CubeIDE、PlatformIO）成熟，调试方便。
  • 挑战：需要仔细处理实时性，确保游戏逻辑计算、坐标转换和信号输出流水线不被中断。DAC的刷新率（Update Rate）需要足够高，才能描绘出流畅、复杂的图形。
  • 这是目前最可行、效果最好的方案。STM32H750配合其480MHz主频和高速DAC，足以应付《雷神之锤》简化版的渲染需求。

• 方案B：FPGA（现场可编程门阵列）：

  • 优势：真正的并行处理和硬件级实时性，可以构建一个专用的“显示列表”处理器，性能极高且确定性强；可以灵活实现高精度、多通道DAC接口。
  • 挑战：开发门槛极高，需要硬件描述语言（如Verilog/VHDL）知识；将《雷神之锤》的游戏逻辑移植到FPGA上是一项庞大的工程，通常的做法是让FPGA仅负责显示输出，游戏逻辑仍由软核处理器（如NIOS II）或外接MCU负责。
  • 这是追求极致性能和硬核学习的路线，适合有数字电路设计经验的玩家。

• 方案C：老旧计算机或单片机（如Arduino Due）：

  • 优势：复古情怀，更贴近早期黑客项目的风格；Arduino Due有双通道12位DAC，是一个不错的起点。
  • 挑战：性能严重受限。Due的84MHz主频和相对简单的架构，可能只能运行极度简化的场景（比如一个房间的线框图），且帧率会很低。难以实现完整的游戏体验。
  • 适合作为原理验证和入门学习，可以先用它来驱动示波器画一些简单的几何图形，理解整个流程。

实操心得：硬件选型起点对于绝大多数想要复现的爱好者，我强烈推荐从STM32F4或H7系列开发板开始。它们性能足够，生态完善，成本适中。ESP32也是一个好选择，但其DAC精度（8位）通常低于STM32（12位），在图像细腻度上会稍有折扣。首要任务是让系统能“动”起来，画出稳定的图形，再考虑优化和增加复杂度。

3. 核心环节一：游戏引擎的“瘦身”与适配

3.1 理解《雷神之锤》的原始数据

原版《雷神之锤》使用BSP树进行空间分割，拥有完整的纹理、光照、动画系统。我们不可能，也不需要全盘照搬。我们的目标是提取其核心几何数据和游戏逻辑。

1. 地图数据（.BSP文件）：这是关卡的所有几何信息。我们需要编写一个解析工具（可以在PC上用Python或C++完成），将BSP文件中的面（face）、顶点（vertex）数据提取出来，并大幅简化。例如，忽略所有纹理坐标、光照信息，只保留构成房间、走廊的凸多面体的顶点位置。最终输出一个高度简化的、只包含必要顶点和面索引的定制格式文件。
2. 游戏逻辑：这包括玩家移动、物理碰撞、敌人AI、武器系统等。原版代码是C语言，但结构复杂。开源项目如vkQuake或QuakeSpasm提供了现代、可读性较好的移植版本。我们的工作是从中剥离出最核心的状态更新函数，移除所有与OpenGL/Vulkan等图形API相关的渲染调用，替换为我们自己的“图元生成”函数。

3.2 构建一个“示波器渲染器”

这是整个项目的软件核心。这个渲染器不生成像素，而是生成显示列表。

1. 坐标变换流水线：对于提取的每一个顶点，仍然需要经过完整的3D图形流水线：
   • 模型变换 & 视图变换：根据玩家位置和朝向，将世界坐标转换到相机空间。
   • 投影变换：使用一个简单的透视投影矩阵，将3D坐标投影到2D的标准化设备坐标（NDC）。
   • 视口变换：将NDC坐标映射到我们目标的分辨率坐标，比如640x480。这个分辨率是逻辑上的，最终会映射到DAC的输出范围。
2. 图元生成与排序：经过变换后，我们得到的是2D屏幕空间坐标。
   • 线框模式：对于每个多边形的边，生成一条线段（两个端点坐标）。这是最简单的模式，但视觉效果也最原始。
   • 矢量扫描模式（进阶）：我们可以尝试模拟早期矢量游戏，只绘制物体的轮廓线。这需要对模型有更好的理解，提取出关键的轮廓边。
   • 关键点：为了正确显示深度，需要对多边形或线段进行粗略的深度排序（画家算法），先画远的，后画近的，避免视觉错误。在示波器上，后画的线会覆盖先画的线。
3. 显示列表优化：生成的线段和点列表，就是我们的“一帧图像”。我们需要对这个列表进行优化：
   • 排序：按端点位置进行排序，尽量减少示波器电子枪在屏幕上的跳跃距离，减少回扫时间，提高有效绘图时间和帧率。
   • 压缩：合并共线的短线段，减少需要传输和绘制的图元数量。
   • 优化后的显示列表将被存入一个缓冲区，供DAC输出模块使用。

3.3 移植到嵌入式环境

将上述精简后的游戏逻辑和渲染器移植到STM32等MCU上。

1. 固定点数运算：嵌入式系统通常没有硬件浮点单元（FPU），或者为了速度和确定性，我们需要使用定点数（Fixed-point）算术来代替浮点数进行所有矩阵和向量运算。这需要仔细处理精度和溢出问题。
2. 内存管理：MCU的RAM非常有限（可能只有几百KB）。必须精细管理内存：使用静态数组而非动态分配；将常量数据（如简化后的地图数据）放在Flash中；显示列表缓冲区大小需要仔细权衡，太大占内存，太小可能导致帧不完整。
3. 实时操作系统（RTOS）的使用：强烈建议使用FreeRTOS或类似的RTOS。可以创建几个关键任务：
   • GameTask：低优先级，负责游戏逻辑计算、玩家输入处理、生成下一帧的显示列表。
   • RenderTask：高优先级，负责从GameTask获取当前帧的显示列表，并通过DMA驱动DAC和GPIO（用于Z轴）进行输出。
   • 这样设计可以实现逻辑与渲染的解耦，即使游戏逻辑计算偶尔超时，也不会导致显示输出卡顿，保证了画面的流畅性。

避坑指南：定点数精度灾难在将浮点矩阵运算转为定点数时，我踩过一个大坑：直接简单地将浮点数乘以一个缩放因子（如2^16）取整。这在进行连续的矩阵乘法时，精度损失会急剧放大，导致物体扭曲、抖动。正确的做法是：为不同的运算阶段选择合适的定点数格式（Q格式）。例如，世界坐标可以用Q16.16（32位整数，高16位是整数部分，低16位是小数部分），经过投影变换后，屏幕坐标可能用Q10.6就够了。同时，在每次乘法后，要进行四舍五入而不是截断，并密切关注溢出，必要时进行饱和处理。

4. 核心环节二：硬件信号生成与输出

4.1 DAC配置与DMA驱动

这是将数字世界与模拟示波器连接起来的关键桥梁。

1. DAC配置（以STM32为例）：

   • 初始化两个DAC通道，分别对应X信号和Y信号。
   • 将DAC设置为“软件触发”或“定时器触发”模式。我们通常使用定时器触发，以实现精确、稳定的采样率。
   • 将DAC输出缓冲区设置为“无缓冲”模式，以减少输出延迟。
   • 输出电压范围通常与MCU的模拟电压（VDDA）一致，例如3.3V。这意味着DAC输出的0-3.3V电压，经过示波器标定后，对应屏幕的从左到右、从上到下。

2. DMA（直接存储器访问）配置：

   • DMA是解放CPU、实现高速连续输出的核心。我们配置两个DMA流（分别对应DAC通道1和2），工作在“内存到外设”模式。
   • 数据源：DMA的数据源就是我们渲染任务准备好的“显示列表”缓冲区。这个缓冲区里交替存储着X坐标值和Y坐标值（例如[X0, Y0, X1, Y1, X2, Y2, ...]）。
   • 传输过程：DMA会自动从内存中读取一个X值送到DAC1，读取一个Y值送到DAC2，然后等待下一个触发信号（来自定时器），如此循环。CPU只需要在渲染完一帧后，更新DMA源地址和传输数据量，即可实现画面的无缝切换。

3. 定时器作为“心跳”：

   • 配置一个基本定时器（如TIM6）产生更新事件（UE），作为DAC的触发源。
   • 刷新率计算：这是关键参数。假设我们的显示列表一帧有2000个点，目标帧率为30fps。那么每秒需要输出的点数为 2000 * 30 = 60,000 点。因此，定时器的触发频率需要设置为至少60kHz。定时器的时钟源和分频器需要据此计算。
   • 更高的点频可以描绘更平滑的线条，但受限于DAC的建立时间、DMA速度和MCU性能。

4.2 Z轴（亮度调制）信号的实现

Z轴信号控制电子枪的开关，通常是一个数字开关信号（高电平开，低电平关）。

1. GPIO控制：使用一个普通的GPIO引脚来产生Z轴信号。在DMA传输的同时，我们需要同步控制这个GPIO。
2. 同步策略：最精确的方法是使用定时器的另一个通道（如PWM输出模式）来产生与DAC触发同步的脉冲信号，或者利用DMA传输完成一半（HT）和全部完成（TC）中断来翻转GPIO。更简单但稍欠精确的方法是：在准备显示列表数据时，在每个坐标对之后，插入一个对应的Z轴控制位（0或1），然后使用第三个DMA流将这个控制位数据流输出到GPIO的位设置/清除寄存器（BSRR）。这需要精心设计数据结构和DMA配置，确保XY和Z的严格同步。

4.3 示波器设置与校准

硬件信号生成后，接入示波器：

1. 连接：将MCU的DAC1输出（X）接示波器CH1，DAC2输出（Y）接CH2，Z轴GPIO接示波器的Z轴输入（或EXT TRIG等可作为亮度调制的端口）。
2. 示波器设置：
   • 显示模式：设置为XY模式。
   • 通道耦合：设置为直流（DC）。
   • 电压刻度（Volts/Div）：调整CH1和CH2的刻度，使图像大致居中且大小合适。例如，如果DAC输出0-3.3V对应全屏，屏幕水平10格，垂直8格，那么合适的刻度可能是 X: 200mV/div, Y: 200mV/div（需要微调）。
   • 触发：通常设置为自动（Auto）即可。如果使用Z轴输入，可能需要设置触发源为Z轴，并选择合适的触发电平。
   • 关键一步：带宽限制。如果图像有毛刺或抖动，可以尝试打开通道的带宽限制（如20MHz），以滤除高频噪声，使线条更清晰。

实操心得：消除“鬼影”与闪烁初期调试时，屏幕上经常出现不该有的短线（鬼影）或图像闪烁。这多半是Z轴信号不同步或消隐时间不足导致的。我的解决方法是：在显示列表中，在每个图元（线段）的结束点和下一个图元的开始点之间，插入一个“回扫点”。这个点的坐标可以设在屏幕外（比如对应负电压），并且将Z轴信号拉低。确保电子枪有足够的时间从上一个位置移动到下一个起始位置而不发光。同时，用逻辑分析仪同时抓取X, Y, Z三路信号，确保它们的时序关系完全符合预期。

5. 核心环节三：输入控制与交互

让角色在示波器世界里移动和射击，需要将示波器或外接设备的控制转化为游戏输入。

5.1 利用示波器原生控件

这是最具“黑客”美感的方式，但实现难度也高。

1. 旋钮作为模拟输入：许多示波器的垂直和水平位置旋钮（POSITION）实际上是可编码的模拟电位器或数字编码器。理论上，可以拆开示波器，找到这些旋钮的电路节点，将信号引出并接入MCU的ADC（模数转换器）引脚，来读取旋钮的位置变化。这需要一定的电路知识和动手能力，并且有损坏仪器的风险。
2. 更可行的方案——外接编码器：放弃改造示波器本身，使用外接的旋转编码器模块来模拟视角的左右旋转（一个编码器）和前后移动（另一个编码器）。按键则可以用外接的按钮来实现开火、跳跃等动作。这样更安全、更灵活。

5.2 设计外接控制盒

一个实用的方案是制作一个独立的小控制盒，通过UART、I2C或USB（如果MCU支持）与主游戏MCU通信。

• 组件：
  • 2个高精度旋转编码器（用于视角和移动）。
  • 4-6个轻触开关按钮（用于开火、跳跃、切换武器等）。
  • 一个OLED小屏幕（可选，用于显示血量、弹药等信息）。
  • 一块Arduino Pro Micro或类似的MCU作为控制盒主板。
• 通信：控制盒MCU读取编码器和按钮状态，通过串口实时发送给主游戏MCU。协议可以很简单，例如定长数据包：[头字节] [编码器1差值] [编码器2差值] [按钮状态位图] [校验和]。
• 优势：分离了输入和显示，降低了系统耦合度，便于调试和升级，也保留了“用特殊设备玩游戏”的仪式感。

5.3 输入处理与游戏响应

在主游戏MCU端，需要实时解析控制盒发来的数据。

1. 去抖动处理：无论是编码器还是按钮，都需要进行软件去抖动，防止误触发。
2. 输入映射：将编码器的脉冲计数差值，映射为游戏角色每帧的旋转角度和移动速度。这需要一个平滑的加速/减速曲线，避免操作生硬。
3. 实时性：输入处理必须在游戏逻辑任务（GameTask）的每个循环中被及时读取和处理，确保操作的跟手性。在RTOS中，可以使用队列（Queue）或信号量（Semaphore）来高效地在控制盒接收中断和游戏任务间传递输入数据。

6. 系统集成、调试与优化实录

6.1 分阶段集成与测试

不要试图一次性完成所有功能。建议按以下顺序集成和测试：

1. 阶段一：静态图形测试。让MCU输出一个固定的显示列表（比如一个正方形、一个三角形），在示波器上显示出来。调整DAC输出和示波器设置，直到图形稳定、清晰。验证Z轴消隐是否有效。
2. 阶段二：动态图形测试。让图形动起来，比如让一个点沿正弦波移动，或者让一个矩形旋转。测试DMA和定时器的配置，确保刷新率稳定，图形运动平滑。
3. 阶段三：集成简化游戏引擎。移植一个最简单的、只有几个立方体的“世界”，并实现基本的坐标变换和显示列表生成。在示波器上验证3D透视是否正确。
4. 阶段四：集成完整游戏逻辑与输入。将《雷神之锤》的简化地图和逻辑加入，连接输入设备。此时，你应该能在示波器上看到熟悉的走廊和房间，并能控制角色移动。

6.2 性能瓶颈分析与优化

当系统运行起来后，你可能会遇到帧率低、图形复杂时闪烁等问题。需要系统性地排查瓶颈。

6.3 视觉效果的进阶调优

基础线框图运行稳定后，可以尝试一些增强效果：

1. 模拟“辉光”效果：早期矢量显示器由于磷光粉余辉，线条会有拖尾辉光。我们可以通过有意降低Z轴信号的关闭速度，或者在显示列表中让重要线段（如靠近玩家的墙）重复绘制多次，来模拟这种复古效果。
2. 简单的明暗区分：虽然无法实现真实 shading，但可以通过控制Z轴信号的占空比（PWM）或电压幅度（如果示波器Z轴支持模拟输入）来改变线条亮度。距离远的物体用更暗的线绘制，增加立体感。
3. 帧间插值与抗抖动：在帧率较低时，物体移动会显得跳跃。可以在显示列表生成时，根据上一帧和当前帧的物体位置进行插值，生成中间过渡的显示列表，使运动看起来更平滑。

完成所有这些步骤后，你得到的将不仅仅是一个能在示波器上运行的游戏，而是一个深度融汇了嵌入式系统、实时编程、计算机图形学、模拟电路和硬件交互的完整知识体系。每一次调试，每一次优化，都是对底层原理的一次亲密接触。当你在那个闪烁着绿色轨迹的圆形屏幕上，看到自己操控的角色奔跑、跳跃、开火时，那种突破常规、亲手创造规则的成就感，正是技术宅们乐此不疲的终极浪漫。这个项目没有标准答案，每一个实现细节都充满了权衡与选择，而这正是其魅力所在——它是一张通往硬件与软件交汇深处的、独一无二的邀请函。