aztechell/hackylens
GitHub: aztechell/hackylens
HackyLens 是一款为 DFRobot HUSKYLENS 摄像头设计的 Kendryte K210 开源模块化固件，提供摄像头预览、二维码扫描、人脸检测等设备端视觉功能与配套调试工具。
Stars: 1 | Forks: 0
# HackyLens
HackyLens 是一款开源的、模块化的 DFRobot HUSKYLENS 摄像头固件。它专为 Kendryte K210 设计，并提供了一个紧凑的设备端环境，用于进行摄像头实验、二维码扫描、人脸检测、文件浏览、诊断以及小型交互式应用。
## 功能
- 实时 OV2640 摄像头预览，支持可配置的捕获和显示设置
- 由 [quirc](https://github.com/dlbeer/quirc) 提供支持的二维码扫描
- 基于 KPU 的人脸检测
- 支持 FAT32 SD 卡、照片捕获、屏幕截图以及图像查看器
- 具有有限历史记录和滚动功能的设备端终端
- 内置文件浏览器、按键测试器、Pong 游戏、设置和睡眠模式
- 编译时应用注册表：可在自定义构建中省略单个应用
- 用于刷写、日志、命令、LCD 截图和原始摄像头帧的 UART 工具
- 分层的 C 代码库，带有自动化的架构边界检查
## 截图
| 主菜单 | 实时摄像头 |
| --- | --- |
|  |  |
这些 320 x 240 的图像是通过固件的 UART 截图协议，直接从运行中的 HUSKYLENS 捕获的。
## 内置应用
`TERMINAL`、`CAMERA`、`QR-CAMERA`、`FACE DETECT`、`FILES`、`BUTTONS`、`PONG`、`SETTINGS` 和 `SLEEP`
## 构建
bootstrap 脚本目前配置的是 Windows Kendryte 工具链。请在 PowerShell 中从仓库根目录运行以下命令。
### 前置条件
- Git
- Python 3
- CMake
- Ninja
- 兼容 MinGW 的构建环境
安装 Python serial 依赖：
```
python -m pip install pyserial
```
下载 Kendryte SDK、工具链和刷写支持文件，然后加载生成的环境：
```
python tools\bootstrap_deps.py
. .\env.ps1
python tools\check_env.py
```
运行架构检查并构建完整的固件：
```
python tools\check_arch.py
python tools\build_firmware.py full
```
固件镜像将被写入 `build\hackylens.bin`。打包的镜像元数据将被写入 `dist\`。
可以通过重复使用 `--disable-app` 来排除应用：
```
python tools\build_firmware.py full --disable-app pong --disable-app terminal
```
## 刷写与调试
列出检测到的串口适配器：
```
python tools\hkflash.py list
```
刷写镜像并监控启动日志：
```
python tools\hkflash.py flash-monitor build\hackylens.bin --port COM10
```
无需摄像头或屏幕抓取工具即可捕获当前的 LCD 内容：
```
python tools\hkflash.py screenshot --port COM10 --output screen.bmp
```
运行 `python tools\hkflash.py --help` 或各个子命令的帮助，以查看重置、波特率、验证、监控、命令和帧捕获选项。
## 项目结构
| 路径 | 用途 |
| --- | --- |
| `firmware/src/apps` | 应用入口点和独立的功能模块 |
| `firmware/src/controllers` | 用户流程和屏幕协调 |
| `firmware/src/services` | 摄像头、二维码、设置、调试和截图服务 |
| `firmware/src/storage` | FAT32、文件、图像、照片和持久化数据 |
| `firmware/src/ui` | 屏幕渲染 |
| `firmware/src/drivers`, `board`, `hal` | 面向硬件的代码 |
| `firmware/src/runtime` | 启动和主循环 |
| `tools` | 依赖引导、构建、检查、刷写和诊断 |
更多详细信息请参阅[架构](docs/ARCHITECTURE.md)、[模块](docs/MODULES.md)、[应用生命周期](docs/APP_LIFECYCLE.md)和 [RAM/flash 预算](docs/RAM_BUDGET.md)。
## 许可证
HackyLens 基于 [MIT 许可证](LICENSE) 发布。
标签：Bash脚本, K210, 人脸检测, 客户端加密, 嵌入式开发, 开源固件, 摄像头, 机器视觉, 逆向工具