TadejPolajnar/sp656e-cli
GitHub: TadejPolajnar/sp656e-cli
这是一个基于逆向工程的 Python CLI 工具，用于通过蓝牙低功耗 (BLE) 协议控制 SP656E (SP638E) BanlanX LED 控制器。
Stars: 0 | Forks: 0
# SP656E CLI
用于通过 Bluetooth Low Energy 控制 SP656E (SP638E) LED 控制器的 CLI 工具。
基于 [BanlanX iOS/Android app](https://banlanx.net/) 使用的 BanlanX 协议进行逆向工程。
## 系统要求
- Python 3.9+
- 已启用蓝牙的 macOS
- [bleak](https://github.com/hbldh/bleak) BLE 库
```
pip3 install bleak
```
## 使用方法
### 全局标志
| 标志 | 描述 |
|------|-------------|
| `-a`, `--address` | BLE 设备地址（跳过扫描，连接更快） |
| `--scan-timeout` | 扫描超时时间，单位秒（默认：10） |
### 命令
```
# 设备发现
python3 sp656e.py scan # Find device and show BLE services
python3 sp656e.py status # Read current device state
# 电源
python3 sp656e.py on
python3 sp656e.py off
# 颜色 (static)
python3 sp656e.py color ff0000 # Hex format
python3 sp656e.py color 0,255,0 # RGB format
python3 sp656e.py color 0000ff --level 128 # With brightness (0-255)
# 亮度
python3 sp656e.py brightness 200 # 0-255
# 特效
python3 sp656e.py effect 3 1 # Dynamic Color: Rainbow
python3 sp656e.py effect 3 9 # Dynamic Color: Red/Yellow Fire
python3 sp656e.py effect 5 18 # Sound: Party
python3 sp656e.py effects # List all available effects (no BLE needed)
# 特效参数
python3 sp656e.py speed 7 # 1-10
python3 sp656e.py length 50 # 1-150
python3 sp656e.py direction --reverse # Reverse direction
python3 sp656e.py loop --enable # Loop effect
# 跳过 BLE 扫描 (faster)
python3 sp656e.py -a DEVICE_ADDRESS on
# 原始命令 (for experimentation)
python3 sp656e.py raw "53 50 00 01 00 01 01"
```
## 效果模式
| 模式 | ID | 描述 |
|------|----|-------------|
| Static Color | 1 | 单一纯色（通过 `color` 命令设置） |
| Dynamic Color | 3 | 动态色彩效果（彩虹、火焰、彗星、流星等） |
| Dynamic White | 4 | 动态白色效果（呼吸、星空、波浪等） |
| Sound Color | 5 | 音乐响应色彩效果 |
| Sound White | 6 | 音乐响应白色效果 |
运行 `python3 sp656e.py effects` 查看所有效果 ID。
## 协议
在 BLE 特征值 `0000ffe1-0000-1000-8000-00805f9b34fb` 上使用 BanlanX 0x53 协议。
消息格式：`0x53 0x01 0x00 `
基于对 [monty68/uniled](https://github.com/monty68/uniled) 和 [phhusson/ha-banlanx](https://github.com/phhusson/ha-banlanx) 的逆向工程。
标签：BanlanX, BLE, DNS解析, IoT, LED控制器, Python, RGB灯, SP638E, SP656E, 云资产清单, 协议分析, 命令行界面, 开源项目, 无后门, 智能家居, 权限提升, 灯光控制, 蓝牙低功耗, 蓝牙控制, 逆向工具, 逆向工程