# LingDong2

**Repository Path**: DMXZ_ZWT/LingDong2

## Basic Information

- **Project Name**: LingDong2
- **Description**: 灵动贴2，使用Kotlin，BLE，CardService
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 1. 项目概述

### 1.1 基本信息
- **系统名称**：灵动贴
- **包名称**：com.zkjd.lingdong
- **目标平台**：原生安卓App，支持安卓版本12+
- **显示支持**：支持横屏和竖屏显示和切换
- **设备规格**：主要面向大屏幕设备（10寸-16寸）

### 1.2 项目目标
开发一款用于控制"灵动贴"蓝牙设备的安卓应用，实现设备配对、按键功能配置、LED灯颜色设置以及常驻后台服务等功能，为用户提供便捷的车载控制体验。

## 2. 硬件设备说明

"灵动贴"是一种专用的蓝牙控制设备，具有以下物理特性：
- **输入控件**：一个物理按钮（支持短按、长按、双击）和一个旋钮（支持左旋、右旋）
- **指示灯**：一个可变色LED灯，可显示连接状态
- **特殊功能**：支持防误触模式（长按3秒后才能正常工作）

## 3. 蓝牙通信协议

### 3.1 通信架构
- 灵动贴作为GATT Service，上位机（安卓设备）作为GATT Client
- **配对方式**：Just work
- **Service UUID**: 0xffd0
- **Characteristic #1**: 0xffd1（用于反控命令，支持write操作）
- **Characteristic #2**: 0xffd2（用于控制命令，支持notify和read操作）

### 3.2 数据格式
数据包由报文头(Header)和Payload组成：
- **Header**：固定1字节
- **Payload**：固定6字节

### 3.3 反控命令（安卓设备发送给灵动贴）
| 字段 | 长度(字节) | 说明 |
|------|------------|------|
| HEADER | 1 | 反控指令HEADER值为0x1 |
| INSTRUCTION | 1 | 指令定义 |
| VALUE | 3 | 指令数据 |
| RESERVE | 1 | 保留字段 |

**指令定义(INSTRUCTION)：**
| 指令 | 值(十六进制) | 说明 |
|------|--------------|------|
| BACKLIGHT_IN_WORKING | 0x01 | 调整工作模式下背光效果 |
| BACKLIGHT_IN_WAITTING_RECONNECTION | 0x02 | 调整待命回连模式下背光效果 |
| KNOB_ANTI_MISOPERATION | 0x03 | 旋钮防误触，VALUE:关闭=0x00，打开=0x01 |

### 3.4 控制命令（灵动贴发送给安卓设备）
| 字段 | 长度(字节) | 说明 |
|------|------------|------|
| HEADER | 1 | 控制指令HEADER值为0x2 |
| KEY_CODE | 1 | 按键定义 |
| RESERVE | 4 | 保留字段 |

**KEY_CODE定义：**
| 按键代码 | 值(十六进制) | 说明 |
|----------|--------------|------|
| KEY_SHORT_PRESS | 0x01 | 短按按钮键 |
| KEY_LONG_PRESS | 0x41 | 长按按钮键 |
| KEY_DOUBLE_CLICK | 0x81 | 双击按钮键 |
| KNOB_CLOCKWISE | 0x02 | 旋钮正旋(右旋) |
| KNOB_ANTICLOCKWISE | 0x03 | 旋钮反旋(左旋) |
| REVERSE_CONTROL_ENTER | 0xF1 | 进入反向控制 |
| REVERSE_CONTROL_EXIT | 0xF2 | 退出反向控制 |
| KEY_NONE | 0x00 | 无效值，代表按键未使能 |

### 3.5 低电量告警
通过BLE battery service 0x180F上报

## 4. 软件功能需求

### 4.1 核心功能
1. **蓝牙设备配对**：搜索并配对灵动贴设备
2. **按键功能配置**：为每个配对设备配置短按、长按、双击、左旋、右旋功能
3. **LED灯颜色设置**：设置设备在连接状态和断开重连状态下的LED灯颜色
4. **数据持久化**：保存配对设备地址和按键设置信息
5. **后台服务**：维持设备连接，接收并执行按键操作
6. **开机自启动**：支持车载设备开机自动启动后台服务
7. **多设备支持**：支持配对和管理多个灵动贴设备（1-3个）

### 4.2 扩展功能
1. **设备命名**：支持为配对设备自定义名称
2. **防误触设置**：支持开启/关闭设备防误触功能
3. **电量显示**：显示设备电量状态
4. **功能定制**：根据不同车机厂家支持的功能进行差异化配置