企业官网建设流程全解析

HaleHound-CYD 是一款运行在 ESP32 Cheap Yellow Display（CYD）开发板上的多协议攻击性安全工具固件，覆盖 WiFi、蓝牙、SubGHz、2.4GHz 与 NFC 五大频段。本文手把手带你从源码构建 HaleHound-CYD：完成 PlatformIO 多环境编译、SD 卡 OTA 升级，并避开 Python 3.14 的版本陷阱。

⚠️ 本文仅面向合法授权下的学习与实践。所有模块在设备上均受 VALHALLA 免责声明与 Blue Team 模式管控，请遵守当地法律法规。

一、准备工作：克隆仓库与安装 PlatformIO

从源码构建只需两步：拿到代码，装好 PlatformIO。

1. 克隆源码仓库

git clone https://gitcode.com/gh_mirrors/ha/HaleHound-CYD cd HaleHound-CYD

2. 安装 PlatformIO

任选其一：

• VS Code 插件：在扩展市场安装 PlatformIO IDE，开箱即用；
• 命令行核心：在已装好 Python 的终端执行pip install platformio，之后用pio命令操作。

💡 注意：这里的 Python 是运行 PlatformIO 的宿主解释器，不是烧进 ESP32 的代码，版本选择有讲究，详见第四节。

完整的构建命令官方说明见 README.md 的 Build from Source 一节。

二、PlatformIO 多环境编译：一张命令表搞定 4 种开发板

HaleHound-CYD 的编译配置按**环境（environment）**划分，一套源码适配 4 款屏幕不同的 CYD 系开发板，UI 会在 240x320 与 320x480 之间自动缩放（对照表见 README.md）。

编译 + 一键刷写（插上 USB 数据线后执行对应命令）：

pio run -e esp32-cyd --target upload # 2.8" CYD pio run -e esp32-e32r35t --target upload # E32R35T 3.5" pio run -e esp32-e32r28t --target upload # E32R28T 2.8" pio run -e esp32-cyd-hat --target upload # NM-RF-Hat

只编译不烧录，去掉--target upload即可；只刷已编译产物则加--target upload前先跑一遍完整构建。

打开串口监视器，固件日志波特率为 115200：

pio device monitor -b 115200

🎯小贴士：选错环境不会报错，但屏幕会黑屏或触摸错位——按你手里板子的型号严格对应-e参数。

三、OTA 升级：SD 卡固件更新，免接线刷机

刷好一次后，后续更新可以完全不碰数据线。HaleHound-CYD 内置OTA 升级通道：把新的固件文件放进 SD 卡，在设备菜单里一键更新。

SD 卡要求与目录结构（FAT32 格式的 MicroSD，目录说明见 README.md）：

/sd/ ├── firmware/ ← OTA 升级用的 .bin 固件文件 ├── subghz/ .sub 信号文件 ├── eapol/ EAPOL/PMKID 抓包 └── ...（其他模块目录，缺失均不影响运行）

升级步骤：

1. 在电脑上完成编译，得到对应环境的.bin固件文件；
2. 将其复制到 SD 卡的firmware/目录；
3. 插入设备，进入菜单Tools → Update Firmware；
4. 点击目标固件，设备自动烧写并重启。

这套流程特别适合外场使用：没有电脑和 USB 线时，只要带一张 SD 卡即可完成固件迭代。

四、Python 版本陷阱：为什么 3.14 会编译失败？

这是新手踩坑率最高的一环。HaleHound-CYD 的构建环境要求 Python 3.10 – 3.13；如果你系统默认是 Python 3.14，PlatformIO 会直接构建失败，除非对platform.py打补丁（要求见 README.md）。

先检查你的版本：

python3 --version

输出在3.10–3.13之间 ✅ 直接用；是3.14❌ 按下表处理：

📌 该问题也被列入官方已知问题清单（README.md Known Issues 表格）："Python 3.14 breaks PlatformIO — Use 3.10-3.13 or patch platform.py"。

💡 判断方法：如果报错里出现platform.py、unsupported或版本相关的SyntaxError，十有八九就是 Python 3.14 惹的祸，换 3.12 基本秒解。

五、编译与刷机常见问题排查清单

更多细节与接线说明（CC1101、NRF24、PN532、GPS）均可在 README.md 中查到，项目授权见 LICENSE。

六、写在最后：三步回顾

✅回顾整个构建流程，只要三步：

1. git clone仓库 + 安装 PlatformIO（宿主 Python 用 3.10–3.13）；
2. pio run -e <你的板子环境> --target upload，选对环境名；
3. 以后更新走 SD 卡firmware/目录 + Tools → Update Firmware，OTA 搞定。

避开 Python 3.14 的坑、认准自己的 Build Target，从源码到上手的整条链路就通了——剩下的，就是这块 7 美元小屏幕能带给你的 40+ 个安全模块了。