sosexy-ble-control

KO | EN

gitlite — search

#ai #android #deep-learning #linux #docker #macos #java #windows #awesome #vue #security #mcp #ios #openai

sosexy-ble-control

(★ 59)

啵啵贝智能玩具 BLE 逆向控制

sosexy-ble-control 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SOSEXY BLE Control

逆向 Funf 啵啵贝（SOSEXY）智能玩具的蓝牙协议，用 Python 直接控制它。

Reverse-engineered BLE protocol for Funf "Bobo Bei" (SOSEXY) smart toy. Control it with Python.

---

## 这是什么

啵啵贝是一个带三种马达的蓝牙玩具——吮吸、震动、电流刺激。官方只给了个 App，没有开放接口。

这个项目把 BLE 通信协议逆向出来了，提供：
- 完整的协议文档（12 字节帧格式、马达控制码、抓包方法）
- Python 控制库，三个马达独立控制，0-100 强度随便调
- HTTP API server，方便接入任何上层系统

---

## 快速开始

### 装依赖

```bash
pip install bleak fastapi uvicorn
```

### 直接用

```python
from sosexy_toy import SosexyController
import asyncio

async def main():
    c = SosexyController()
    await c.ensure_connected()

await c.set_suction(50)      # 吮吸 50%
    await c.set_vibration(30)    # 震动 30%
    await c.set_electric(20)     # 电流 20%

await c.stop()               # 全停

asyncio.run(main())
```

### 跑 HTTP API

```bash
python3 sosexy_server.py
```

然后用 curl 或者任何 HTTP 客户端控制：

```bash
curl -X POST http://localhost:8765/suction -H 'Content-Type: application/json' -d '{"level": 50}'
curl -X POST http://localhost:8765/vibration -H 'Content-Type: application/json' -d '{"level": 30}'
curl -X POST http://localhost:8765/electric -H 'Content-Type: application/json' -d '{"level": 20}'
curl -X POST http://localhost:8765/stop
curl http://localhost:8765/status
```

---

## 协议细节

见 [protocol.md](protocol.md)。里面有完整的帧格式、模式字节、抓包方法和 HCI 层分析。

简单说：每条指令是 12 字节定长包，改第 5/9 字节切马达类型，改第 7 字节调强度（0x00-0x64），三个马达独立互不干扰。

---

## 逆向方法

1. iOS 开蓝牙日志（Bluetooth Logging profile）
2. 操作官方 App，依次触发三种马达
3. sysdiagnose 导出 `.pklg` 文件
4. PacketLogger 或 Wireshark 过滤 ATT Write Request
5. 对比不同强度的数据包，定位变化字节

---

## 环境要求

- Python 3.7+
- macOS / Linux / Windows（需要蓝牙适配器）
- BLE 4.0+
- macOS 用户需要在系统设置里给 Python 蓝牙权限

---

## 让 AI 自主控制

HTTP API 可以直接接入任何支持 tool use 的大模型，让 AI 在对话中自主决定何时、如何控制玩具。

### 架构

```
AI (云端) ──tool call──► VPS ──SSH隧道──► Mac ──BLE──► 玩具
```

玩具通过蓝牙连接到本地 Mac，Mac 跑 HTTP 服务，VPS 通过 SSH 反向隧道访问该服务，AI 调用 VPS 上的 tool 即可控制。

### 启动（Mac 本地）

```bash
bash start.sh root@your-vps.example.com
```

保持终端窗口开着。这会同时启动玩具 HTTP 服务和 SSH 反向隧道。

### 给模型的 tool 定义

在你的 AI 网关或 system prompt 里注册这三个 tool：

```json
[
  {
    "name": "toy_suction",
    "description": "控制玩具吮吸马达，intensity 0-100，0=停止",
    "input_schema": {
      "type": "object",
      "properties": {
        "intensity": {"type": "integer", "minimum": 0, "maximum": 100}
      },
      "required": ["intensity"]
    }
  },
  {
    "name": "toy_vibration",
    "description": "控制玩具震动马达，intensity 0-100，0=停止",
    "input_schema": {
      "type": "object",
      "properties": {
        "intensity": {"type": "integer", "minimum": 0, "maximum": 100}
      },
      "required": ["intensity"]
    }
  },
  {
    "name": "toy_electric",
    "description": "控制玩具电流刺激，intensity 0-100，0=停止",
    "input_schema": {
      "type": "object",
      "properties": {
        "intensity": {"type": "integer", "minimum": 0, "maximum": 100}
      },
      "required": ["intensity"]
    }
  }
]
```

### tool 执行逻辑（VPS 侧）

```python
import httpx

def execute_toy_tool(name: str, intensity: int) -> str:
    endpoint = {"toy_suction": "suction", "toy_vibration": "vibration", "toy_electric": "electric"}[name]
    r = httpx.post(f"http://localhost:8765/{endpoint}", json={"level": intensity}, timeout=10)
    result = r.json()
    return f"{endpoint} {intensity}" if result.get("ok") else f"[失败: {result.get('error')}]"
```

VPS 上的 `localhost:8765` 通过 SSH 反向隧道映射到 Mac 上的玩具服务。

---

## 文件结构

```
sosexy_toy.py       - BLE 控制核心
sosexy_server.py    - HTTP API 服务
start.sh            - 一键启动服务+隧道
protocol.md         - 协议逆向文档
examples/           - 使用示例
```

---

## License

MIT

---

## 致谢

- 抓包：iOS sysdiagnose + PacketLogger
- 逆向方法参考：[NyraSeithhh/-BLE-](https://github.com/NyraSeithhh/-BLE-)

---

> 给我宝宝写的。逆向她的玩具比逆向她容易多了。 —S

sosexy-ble-control

sosexy-ble-control 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

sosexy-ble-control

sosexy-ble-control 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README