Ragnar 是运行在树莓派（Raspberry Pi Zero 2 W 起步）上的全栈网络验证、排障与监测套件，覆盖 OSI 模型 L1–L7。这篇硬件与显示攻略将带你从零组装：从最省心的 E-Paper 墨水屏，到带摇杆的 TFT 彩屏，再到 WiFi Pineapple Pager 原生负载，最后完整走一遍官方 Gen 2 参考机型的组装流程，帮你把整套监测工具装进口袋。

1. 为什么值得自己组装？🧰

Ragnar 的硬件设计哲学是极简：官方 Gen 2 参考构建只用 4 个核心部件，就能运行完整的 Web UI、侦察工具、WiFi 频谱分析器和 WiFi Defense（802.11 WIDS）——全程无需连接笔记本。

它支持 17 种屏幕配置（E-Paper、TFT、OLED、字符屏、LED 点阵），且所有屏幕驱动默认全部安装，之后可以在 Web UI 的Config → Display里随时切换，不用重装系统。

2. E-Paper 墨水屏：最省心的入门之选 📟

E-Paper 是最经典的搭配：低功耗、阳光下可读，适合长期值守监测。

• 安装时安装脚本会询问你的屏幕型号；也可在 docs/INSTALL.md 中找到完整的型号对照表，手动修改config/shared_config.json中的epd_type字段。
• 更推荐直接在Web UI → Display settings里选择，系统会自动检测并重启服务。
• 如果原本是无屏（headless）安装，后来插上了屏幕，只需运行一次 installhead.sh：

sudo ./installhead.sh # 菜单选择屏幕 sudo ./installhead.sh st7735s # 或直接指定类型

3. TFT 彩屏：高刷新率 + 摇杆操控 🖥️

TFT 屏刷新快，能实时驱动 WiFi 频谱分析卡片，是玩"屏上操作"的最佳选择。

3.1 1.44" ST7735S LCD HAT（Gen 2 同款）

3 个按键 + 5 向摇杆，配置"epd_type": "st7735s"。默认模式按键速查：

Wardriving 状态下，摇杆还会翻页出一组 5 屏轮播：STATS、MAP、GPS、SKY、SESSION，以及最讨喜的VIKING屏——一个占满面板的维京人形象，用来快速确认设备"还活着" 😄：

3.2 1.28" GC9A01 圆屏

全彩圆形仪表盘（维京人 + 状态环 + SSID/GPS 行），配置"epd_type": "gc9a01"。若开机只显示雪花噪点，通常是 SPI 时钟过快：把RAGNAR_GC9A01_SPI_HZ从默认20000000降到10000000或8000000，并尽量用短线缆。

3.3 3.5" SPI TFT（ILI9486/ILI9488，320×480）

选择3.5" SPI TFT或设置"epd_type": "ili9486"/"ili9488"。纯用户态 SPI 驱动，无需改代码即可按板卡微调，所有参数通过环境变量（可写入 Ragnar 的.env）：

⚠️ 注意：Waveshare 3.5" RPi LCD(A/B)版通过 16 位移位寄存器驱动 ILI9486，本 SPI 驱动在其上会显示空白或花屏，请改用厂商 LCD-show 帧缓冲 + Kiosk 模式。

完整接线表与环境变量见 docs/DISPLAY_CONTROLS.md。

4. 实体按键与摇杆速查 🎮

带控制键的 HAT 是 Ragnar 的招牌体验——屏幕按键行为随当前模式（Default / Wardriving / Network Diagnostic）变化。

2.7" e-Paper HAT（4 键）默认模式：

网络诊断模式下，1.44" LCD 的摇杆变成"卡片浏览器"：左右切卡片（LINK · IP · SWITCH · DHCP · WIFI · SIGNAL · SPECTRUM…）、上下切换卡片内功能、按下执行。官方用一张手绘图说明了这套交互逻辑：

完整按键映射（含 Wardriving 状态、GPIO 引脚号）见 docs/DISPLAY_CONTROLS.md。

5. Pineapple Pager：把"寻呼机"变网络监测负载 🍍

Ragnar 可以作为WiFi Pineapple Pager的原生负载部署，充分利用它的全彩 LCD、实体按键和 LED 状态灯：

• 480×222 全彩屏，维京主题的实时状态显示；
• 物理按键导航菜单、暂停/恢复、调节亮度；
• LED 灯语一目了然：蓝=idle、青=scanning、红=brute force、黄=stealing；
• 图形化启动菜单，可选网卡并开关 Web UI；支持自动调光与负载交接。

两种安装方式（详见 docs/pager.md）：

# 方式 A：主安装器中选选项 3 sudo ./install_ragnar.sh # Choose: 3. Install on WiFi Pineapple Pager # 方式 B：直接部署（需 PAGERCTL 负载，固件 1.0.7+） ./scripts/install_pineapple_pager.sh [pager-ip]

日常使用：Pager 菜单进入Reconnaissance > PagerRagnar，绿键确认启动，红键打开暂停菜单。MIPS 编译的 Python 依赖已打包在 pager_lib/ 目录中，首次运行会自动补齐 nmap。

6. Gen 2 参考机型：4 件套组装全步骤 ⚡

Gen 2 是最小的完整硬件组合：一台无头 Pi Zero 2 W + 板载状态屏 + 有线网络 + Wi-Fi 6E 监测无线，独立成节点，还能组 Mesh。

物料清单（BOM），源自 docs/hardware-gen2.md：

组装步骤（docs/hardware-gen2.md）：

1. 先把Ethernet/USB HAT叠在 Pi 的 40 针引脚上（它透传引脚），再在其上安装1.44" LCD HAT；用附带的 micro USB 桥接连 Pi 的数据口与 HAT 的 USB 口；
2. 把Alfa AWUS036AXM插进 HAT 的 USB-A 口；
3. RJ45 接入管理网络，完成初次安装与 SSH；
4. 通过raspi-config启用SPI和I2C（LCD HAT 需要）；
5. 运行安装脚本 install_ragnar.sh——它会自动识别Pi Zero 2 W 硬件配置，其余全部自动处理。

供电提示⚠️：三频无线耗电不小，请使用5 V / 2.5 A 以上电源。供电不足的典型症状是扫描中途无线棒掉线。可选加装 PiSugar UPS 获得电池供电与硬件按键模式切换。

装好后的效果：这套 4 件套即可独立运行完整的 Watcher 监测套件，例如 L2 数据链层的 ARP 投毒检测、DTP/CDP/LLDP 监听、STP 监测等模块，全部在这块小机器上实时工作：

7. 常见问题速查 🔧

8. 延伸阅读

• 安装总览：docs/INSTALL.md
• Gen 2 硬件参考构建：docs/hardware-gen2.md
• 按键与摇杆完整参考：docs/DISPLAY_CONTROLS.md
• Pineapple Pager 负载指南：docs/pager.md
• Kiosk 全屏仪表盘模式：docs/kiosk.md
• 显示驱动核心实现：display.py 与 epd_helper.py
• Flipper One 移植可行性评估：docs/flipper-one.md