{
  "added_at": "2026-11-09",
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "The KuKirin G4 BLE Mode Monitor parses observed FFF2 notifications from a scooter and prints changes between ECO, SPORT, and RACE modes. Its Python client validates frame length and a gate byte before decoding the mode field; the documented mapping comes from one scooter and firmware combination.",
  "description_zh": "KuKirin G4 BLE Mode Monitor 解析滑板车 FFF2 特征值的通知，在 ECO、SPORT 和 RACE 模式变化时输出结果。Python 客户端先检查帧长度和标志字节，再解析模式字段；映射依据一台滑板车及其固件的观察结果。",
  "entry_url": "https://awesomerea.org/resources/kukirin-g4-ble-mode-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/kukirin-g4-ble-mode-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/maksdoner/Kukirin-G4-Bluetooth-Control/blob/9927f41b0224e147a759da1c86d9bd7b4bb80e4a/README.md",
  "group": "cases",
  "id": "kukirin-g4-ble-mode-case",
  "json_url": "https://awesomerea.org/resources/kukirin-g4-ble-mode-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/kukirin-g4-ble-mode-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/kukirin-g4-ble-mode-case/index.md",
  "name": "KuKirin G4: decoding BLE ride-mode notifications",
  "name_zh": "KuKirin G4：解析 BLE 骑行模式通知",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3.10+, Bluetooth access, and a KuKirin G4 for the hardware path; that path is documented for macOS.",
    "The mapping comes from one scooter and firmware combination; no raw captures or formal protocol specification are included.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Python 3.10+、蓝牙访问权限和一台 KuKirin G4；硬件使用路径按 macOS 编写。",
    "模式映射来自一台滑板车及其固件；仓库未收录原始抓包或正式协议规范。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/maksdoner/Kukirin-G4-Bluetooth-Control",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}