ReLLL/brenner8-macos
GitHub: ReLLL/brenner8-macos
为 MicroPic Brenner8 系列 PIC 编程器提供原生 macOS 命令行工具和逆向工程文档,替代传统 Windows 工作流。
Stars: 0 | Forks: 0
# brenner8-macos
[](LICENSE)
[](docs/file-map.md)
MicroPic Brenner8 SE / Brenner 8p5 / Sprut Brenner8 USB PIC 编程器的原生 macOS CLI 与逆向工程笔记。
本项目改编自原始的 Brenner / USBurn 软件及协议生态系统,随后被重构为原生 macOS CLI。
## 为什么做这个
- 提供现代 macOS CLI,以取代原始仅限 Windows 的工作流
- 逆向工程并文档化的基于 DB 的支持
- 保留历史固件/应用捆绑包以供参考
- 在真实硬件和真实 PIC 目标上进行了验证
## 状态
- `fw=10` 传统 Brenner 固件:已在 macOS 上正常工作
- 通用 CLI:`build/b8`
- 已验证的真实运行目标:
- `PIC16F84(A)`
- `PIC16F877`
- `PIC12F675`
- `PIC16F628A`
- `PIC18F2550`
- 破坏性操作现在对支持的系列使用批量擦除 + 擦除 + 验证
- 已成功使用并测试于:
- `PIC16F84A`
- `PIC16F628A`
- `PIC16F877`
- `PIC18F2550`
- `PIC12F675`
- 历史供应商/应用捆绑包原样保留在 `docs/original-programmer/` 下
## 快速开始
构建:
```
brew install libusb
make
```
自动检测当前芯片:
```
./build/b8 detect
./build/b8 info
```
读取 / 写入:
```
./build/b8 read out.hex
./build/b8 write --pic PIC16F877 path/to/file.hex
./build/b8 erase --pic PIC16F877
```
## 仓库文档
- [docs/architecture.md](docs/architecture.md):代码结构、运行时层、设计选择
- [docs/file-map.md](docs/file-map.md):逐文件的项目清单
- [docs/cli.md](docs/cli.md):主 CLI 及系列工具参考
- [docs/database-format.md](docs/database-format.md):DB/数据文件结构、HEX 映射、校准 EEPROM
- [docs/hardware.md](docs/hardware.md):MicroPic Brenner8 SE / Brenner 8P5 的硬件/构建说明
## 主要二进制文件
- `build/b8`:通用主入口 CLI,具有自动检测 + 系列路由功能
- `build/b8pic14db`:经典的 14 位 DB 驱动编程器
- `build/b8pic18db`:PIC18F DB 驱动编程器
- `build/b8pic16f84`:用于原始单芯片调试工作流的兼容层
- `build/b8probe1`:用于协议/调试工作的原始 libusb 探针
## 关键约束
编程器一次只能由一个进程访问。对 Brenner 发出并行的 USB 命令会导致误报故障和误导性读取。
## 最新实机验证
最新的完整端到端验证在 `PIC16F628A` 上运行:
- 检测:通过
- 写入冒烟测试:通过
- 回读验证:通过
- 擦除:通过
- 擦除后空白验证:通过
## 许可证
本仓库中新增的代码采用 MIT 许可证。`docs/original-programmer/` 中的原始第三方材料保留其原始许可证/状态。
## OSS
- [CONTRIBUTING.md](CONTRIBUTING.md)
- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
- [SECURITY.md](SECURITY.md)
- [SUPPORT.md](SUPPORT.md)
- [CHANGELOG.md](CHANGELOG.md)
标签:DNS解析, HEX文件, libusb, Microchip, MIT许可, PIC16F, PIC18F, PIC单片机, USB设备, 云资产清单, 固件烧录, 嵌入式开发, 开源项目, 数据库驱动, 电子工程, 硬件交互, 硬件编程器, 芯片擦除, 芯片读取, 逆向工程