The-POOM/the_poom

# POOM POOM 是一个开源多功能工具平台，专为 **Pentest. Play. Create.** 而构建。 它专为创客、安全学习者、游戏玩家和工程师设计，提供了一种能够跨无线安全、数据捕获、自动化和交互领域执行真实嵌入式工作流的紧凑设备。 ## 产品概述 POOM 以 ESP-IDF 固件项目的形式提供，采用模块化架构，并包含多个操作域： - Maker 模式 - ZEN 模式 - 嗅探器与分析器 - 无线工具包（Wi-Fi, Bluetooth, Aerial） ## 核心能力 ### Maker 模式 - 用于快速 Qwiic 风格外围设备发现的 I2C 扫描器 - 流向自动化平台（n8n, Node-RED, Home Assistant）的传感器数据流 - 面向 Edge Impulse 和外部绘图工具的数据捕获与可视化流水线 - 用于数据集收集和功能测试的嵌入式 API ### ZEN 模式 - NFC 读取与实验工作流 - BLE MIDI 运动控制 - 面向应用、媒体和演示的控制器模式 - 紧凑型游戏集成（例如 Snake 和掌机流程） ### Beast 模式 - Wi-Fi 扫描、解除认证测试（需授权）、karma、钓鱼/evil twin、SSID 垃圾信息、DIAL、ARP 欺骗。 - BLE 垃圾信息与 BLE 近距离/标签追踪。 - Wi-Fi, BLE, Zigbee 以及 802.15.4/Thread 捕获路径。 - 用于离线分析的 ART 和主机导出流水线。 - 无人机 ID 与无人机研究功能。 ### Gamer 模式 - BLE 游戏手柄与 IMU 运动控制。 - Snake 和掌机流程。 - 专为手持设备打造的紧凑型游戏集成 - Arduboy 库支持 ## 平台与目标 - 框架：ESP-IDF `v6.1.0` - 主要目标平台：`esp32c5`, `esp32c6` - 当前工作空间的默认目标：`esp32c6` ## 仓库结构 ``` . ├── applications/ # Product applications and end-user features ├── modules/ # Reusable POOM modules ├── drivers/ # Hardware-facing drivers ├── third-party/ # Integrated external components ├── kernel/ # Internal runtime and system utilities ├── main/ # Firmware entry point └── CMakeLists.txt # Root build orchestration ``` ## 构建与烧录 ``` . "$HOME/esp/esp-idf/export.sh" # 构建 ESP32-C6 idf.py set-target esp32c6 idf.py build # 构建 ESP32-C5 idf.py set-target esp32c5 idf.py build # Flash 和 monitor idf.py flash monitor ``` ## 安全与法律 POOM 包含攻击性安全功能，仅限用于以下用途： - 授权的渗透测试 - 受控的实验室环境 - 教育与防御性研究 请仅在获得明确许可并遵守当地法律法规的情况下使用。 ## 贡献 欢迎贡献代码。为保持一致性： - 遵循 `poom_*` 命名规范 - 保持代码和文档为英文 - 当行为发生变化时，更新组件/应用的 README - 优先采用生产级 C 风格、清晰的 API 和可维护的接口

标签：ESP32, ESP-IDF, Motion控制, NFC工具, Wi-Fi攻击, Zigbee安全, 中间人攻击, 信号拦截, 客户端加密, 密码管理, 嵌入式开发, 嵌入式系统, 开源硬件, 恶意热点, 攻击路径可视化, 数据捕获, 无人机安全, 智能家居, 游戏开发, 物联网安全, 系统分析, 网络分析, 网络嗅探, 网络安全工具包, 网络调试, 自动化, 蓝牙攻击, 足迹分析, 黑客工具