Android遥控器对频详解

一、模块总览

对频（Pairing / 绑定）是遥控器与天空端设备之间的射频链路建立过程。本工程主要包含以下对频相关子模块：

功能	主 Fragment / Activity	核心 Key	入口
开始对频	D2dFragment / D2dActivity	KeyRequestPairing	点击"对频"按钮
停止对频	D2dFragment / D2dActivity	KeyRequestStopPair	点击"停止对频"按钮
新增接收机（绑定）	D2dFragment / D2dActivity	KeyRequestPairingAtSetMac	点击"新增接收机"按钮
解绑/断开	D2dActivity	KeyRequestStopPair	停止对频时自动触发
连接状态	D2dFragment / D2dActivity	KeyRawSignalQuality	实时监听 JSON
信号质量	NewuiG12SignalFragment	KeyG12RCScanChanInfo / KeyG12SkyScanChanInfo / KeyRawSignalQuality	1秒定时器轮询
MAC 地址读取	NewuiG12MacPairFragment	KeyMAC	读取/设置接收机 MAC

---

二、核心数据模型

2.1 PairParam（对频参数）

// com/skydroid/rcsdk/common/airlink/PairParam.java
public final class PairParam {
    private String mac;   // 目标接收机 MAC 地址（8位字符串）
    private int timeout;  // 对频超时时间（秒），默认 1 秒
}

构造方式：new PairParam(mac, 0, 2, null) → 实际等价于 (mac, timeout=1)

2.2 ChanInfo（信道扫描信息）

// com/skydroid/rcsdk/common/airlink/ChanInfo.java
public final class ChanInfo {
    private boolean autoMode;   // 是否自动跳频模式
    private int chanNum;        // 信道数量
    private long[] freq;        // 各信道频率数组
    private int[] power;        // 各信道信号强度数组（dBm）
}

2.3 GLinkThroughput（链路吞吐量）

// com/skydroid/rcsdk/common/airlink/GLinkThroughput.java
public final class GLinkThroughput {
    private long txPhy;   // 物理层发送速率（kbps）
    private long txReal;  // 实际发送速率（kbps）
    private long rxPhy;   // 物理层接收速率（kbps）
    private long rxReal;  // 实际接收速率（kbps）
}

2.4 GLinkSkyDevice（天空端设备枚举）

// com/skydroid/rcsdk/common/airlink/GLinkSkyDevice.java
public enum GLinkSkyDevice {
    UNKNOWN(0),  // 未识别
    GR01(1),     // GR01 接收机
    GR03(2),     // GR03 接收机
    TR01(3),     // TR01 中继器
    GR02(4),     // GR02 接收机
    YL20(5),     // YL20 设备
}

2.5 BandValue（频段枚举）

// com/skydroid/rcsdk/common/airlink/BandValue.java
public enum BandValue {
    UNKNOWN,
    Band_1G,
    Band_2G,
    Band_5G
}

---

三、开始对频（Pairing）

3.1 触发入口

D2dFragment.sendReset() 或 D2dActivity.sendReset()，用户点击"对频"按钮触发。

3.2 流程

用户点击"对频"按钮
    ↓
sendReset()
    ↓
Toast 提示 "对频中…"（R.string.frequency_ing）
    ↓
判断设备类型（isG_RC_App() / isG_RC()）：
    ├── G 系列遥控器（G12/G20/G30/TC3 等）：
    │       KeyManager.action(KeyRequestPairing, callback)
    │           → 下发对频请求到遥控器
    │           → onSuccess → 启动配对状态检查线程
    │   └── 非 G 系列：
    │           通过 UDP 发送 AT 命令："AT+WPS\r\n"
    │           设置 isStartPair = true
    │           设置 isCanShowPairEnd = true
    ↓
启动 pairCheckStatusThread（后台线程，每 500ms 检查一次）
    ↓
检查 InternalKey.isAr8030Pairing()：
    ├── true  → tvPairing 显示可见（对频进行中）
    └── false → isStartPair = false，隐藏 tvPairing（对频结束/超时）
    ↓
1 秒后设置 isCanShowPairEnd = true（允许显示配对成功/失败提示）

3.3 SDK Key

Key	方向	数据类型	说明
RemoteControllerKey.KeyRequestPairing	写（action）	EmptyMsg	请求开始对频
InternalKey.KeyRequestPairingAtSetMac	写（set）	PairParam	指定 MAC 进行绑定

---

四、停止对频（Stop Pairing）

4.1 触发入口

D2dFragment.m401initData$lambda11() 或 D2dActivity.m948onCreate$lambda8()，用户点击"停止对频"按钮触发。

4.2 流程

用户点击"停止对频"按钮
    ↓
KeyManager.action(KeyRequestStopPair, callback)
    ↓
onResult(null) → Toast "停止对频中…"（R.string.msg_stoping_pair）
onResult(exception) → 不提示
    ↓
pairCheckStatusThread.interrupt()（中断检查线程）
isStartPair = false

4.3 SDK Key

Key	方向	数据类型	说明
RemoteControllerKey.KeyRequestStopPair	写（action）	EmptyMsg	请求停止对频

---

五、新增接收机（绑定 / Add Receiver）

5.1 触发入口

D2dFragment.m403initData$lambda12() 或 D2dActivity.m950onCreate$lambda9()，用户点击"新增接收机"按钮触发。

5.2 流程

用户点击"新增接收机"按钮
    ↓
getMac()
    → KeyManager.get(KeyMAC, callback)
    → onSuccess(mac) → getMacStr = mac
    → showReceiverDialog2()（弹出确认对话框，显示接收机 MAC）
    ↓
用户确认 → setMac(getMacStr)
    ↓
校验 MAC：
    ├── 为空  → Toast "设置失败"
    ├── 长度≠8 → Toast "设置失败"
    └── 合法 → 继续
    ↓
构建 PairParam(mac, 0, 2, null)，从 edittextTimeOut 读取超时值（默认 5 秒）
    ↓
KeyManager.set(KeyRequestPairingAtSetMac, pairParam, callback)
    ↓
onResult(null) → 绑定成功
onResult(exception) → 绑定失败

5.3 SDK Key

Key	方向	数据类型	说明
AirLinkKey.KeyMAC	读（get）	String	读取本地设备 MAC
AirLinkKey.KeyRequestPairingAtSetMac	写（set）	PairParam	指定 MAC 绑定接收机

---

六、解绑（Unbind / Disconnected）

解绑逻辑与停止对频合并处理：

KeyManager.action(KeyRequestStopPair)
    ↓
遥控器断开与天空端的链路
    ↓
KeyRawSignalQuality 回调 dev_connect = false
    ↓
d2dConnection 显示"未连接"

无独立解绑 Key，通过 KeyRequestStopPair 完成。

---

七、连接状态

7.1 信号质量监听（G 系列）

onResume()
    ↓
KeyManager.listen(KeyRawSignalQuality, keyRawSignalQualityListener)
    ↓
回调 KeyListener.onValueChange(key, rawJson)
    ↓
解析 JSON，提取以下字段：
    ├── "dev_connect"  → Boolean：是否已连接
    ├── "signal"       → Integer：信号强度值
    ├── "ap_tx_chan"   → Integer：地面端当前发射信道
    ├── "dev_tx_chan"  → Integer：天空端当前发射信道
    └── 其他调试字段（ap_*/dev_* 前缀）
    ↓
runOnUiThread → 更新 UI
    ├── d2dConnection.setText(getConnectedStr(context, dev_connect))
    ├── tvCHANNEL 显示详细状态信息
    └── 若 dev_connect=true 且 isCanShowPairEnd=true：
            → Toast "对频成功"（R.string.contraband_successful）

7.2 连接超时检测

每次收到有效信号数据时：
    → handler.removeCallbacks(checkTimeoutRunnable)
    → checkTimeoutRunning = false
    → handler.postDelayed(checkTimeoutRunnable, 5000ms)
    ↓
5 秒内未收到新数据：
    → checkTimeoutRunnable 触发
    → d2dConnection 显示"未连接"
    → 左侧/中间/右侧 TextView 清空

7.3 连接状态工具函数

// com/skydroid/business/util/StringUtils.java
getConnectedStr(Context, boolean isConnected)   → "已连接" / "未连接"
getNewuiConnectedStr(Context, boolean isConnected) → 新版 UI 连接字符串

7.4 设备类型分支（GLinkSkyDevice）

NewuiWirelessSettingsFragment 监听 KeyGLinkSkyDevice 回调，动态显示/隐藏功能项：

isGR02()  → gLinkSkyDevices 包含 GR02 → 显示类型 2 UI
isTR01()  → gLinkSkyDevices 包含 TR01 → 显示类型 1 UI
else      → 显示类型 0 UI（基础模式）

所有情况下 mLyBackupStartRealy（中继启动）默认隐藏。

---

八、信号质量与信道扫描

8.1 实时信号质量（Signal Fragment）

NewuiG12SignalFragment 实现信道扫描图显示：

onResume() → timerTask.start()（1秒周期）
    ↓
定时器触发：
    KeyManager.get(KeyG12RCScanChanInfo)   → 地面端信道功率
    KeyManager.get(KeyG12SkyScanChanInfo)  → 天空端信道功率
    ↓
onSuccess(ChanInfo) → setLineChartDatas(power[], isSky, currChan)
    → 更新 BarChart（Y 轴：-110 ~ -50 dBm）
    → 绿色柱：噪声最小，蓝色柱：当前信道
    ↓
KeyManager.listen(KeyRawSignalQuality)  → 实时更新当前信道
    → skyChan = dev_tx_chan（天空端当前信道）
    → rcChan  = ap_tx_chan（地面端当前信道）

8.2 频段配置

// AirLinkKey 相关 Key
KeyRCGetBandInfo     → 获取遥控器频段信息（GetBandInfo）
KeySkyGetBandInfo    → 获取天空端频段信息
KeyRCSetBand         → 设置遥控器频段（BandValue）
KeySkySetBand        → 设置天空端频段
KeyRCSetBandAutoMode → 设置自动跳频模式
KeySkySetBandAutoMode
KeyRCSetBandSave     → 保存频段设置
KeySkySetBandSave

8.3 带宽与跳频

Key	类型	说明
KeyRCSetEqualBandwidthMode	Boolean	地面端等带宽模式
KeySkySetEqualBandwidthMode	Boolean	天空端等带宽模式
KeySetFrameChangeDuration	SetFrameChangeDuration	跳频帧间隔
KeySetAutoMCS	Boolean	自动 MCS 模式
KeySkySetAutoMCSDuration	SetAutoAndDuration	自动 MCS 时长
KeySetBandwidthDuration	Long	带宽持续时间
KeyRCSetReTxCount	Integer	地面端重传次数
KeySkySetReTxCount	Integer	天空端重传次数
KeyRCFreqList	long[]	地面端可用频率列表
KeyGLinkSpeedMode	GLinkSpeedMode	链路速度模式

8.4 信号质量 Key（各设备）

Key	类型	设备
KeySignalQuality	Integer	通用
KeyRawSignalQuality	String(JSON)	G 系列
KeyRawSignalQuality2	String(JSON)	G 系列（备用）
KeyH12SignalQuality	Integer	H12
KeyH16SignalQuality	Integer	H16（已废弃）
KeyH16RawSignalQuality	String	H16（已废弃）
KeyH30SignalQuality	Integer	H30（已废弃）

---

九、MAC 地址管理

9.1 读取 MAC

NewuiG12MacPairFragment.onResume()
    → KeyManager.get(KeyMAC, callback)
    → onSuccess(mac) → etMac.setText(mac)

9.2 设置 MAC（仅写入本地值）

buttonTvSaveOnClick()
    → 校验 MAC 长度 = 8
    → KeyManager.set(KeyMAC, mac, callback)

9.3 对频时绑定 MAC

setMac(mac, usePair=true)
    → PairParam(mac, timeout=1)
    → KeyManager.set(KeyRequestPairingAtSetMac, pairParam, callback)

---

十、D2D（Device-to-Device）链路

D2dController 通过 Android 系统 D2D Service 实现设备间直连：

// com/fishsemi/sdk/d2dcontrol/D2dController.java
start()           → bindToD2DService()（绑定 D2DService）
stop()            → unbindToD2DService()（解绑）
requestPairAir()  → requestD2dFreqNegotiation()（请求对频）

监听回调：

• onD2DServiceStatusChanged → 连接状态变化
• onD2DSignalStrengthChanged → 信号强度变化（LTE RSRQ/RSRP）
• onRequestFreqNegotiationDone → 对频结果（成功/失败）

---

十一、完整流程图

┌─────────────────────────────────────────────────────────────────────────┐
│                           开始对频流程                                   │
│                                                                         │
│  用户点击"对频" ──→ sendReset()                                         │
│                      │                                                    │
│                      ▼                                                    │
│              KeyManager.action(KeyRequestPairing)                        │
│                      │                                                    │
│                      ▼                                                    │
│              后台线程轮询 isAr8030Pairing()                               │
│                  ├── true  → tvPairing 可见（对频中）                     │
│                  └── false → 隐藏 tvPairing                              │
│                      │                                                    │
│                      ▼                                                    │
│              1秒后 isCanShowPairEnd = true                                │
│                      │                                                    │
│                      ▼                                                    │
│              KeyRawSignalQuality 回调 dev_connect=true                    │
│                      │                                                    │
│                      ▼                                                    │
│              Toast "对频成功" ✓                                           │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│                          新增接收机流程                                   │
│                                                                         │
│  用户点击"新增接收机" → getMac()                                        │
│                        │                                                  │
│                        ▼                                                  │
│              KeyManager.get(KeyMAC)                                      │
│                        │                                                  │
│                        ▼                                                  │
│              showReceiverDialog2()（弹窗确认 MAC）                        │
│                        │                                                  │
│                        ▼                                                  │
│              setMac(mac)                                                 │
│                ├── 校验 MAC 长度 = 8                                     │
│                └── PairParam(mac, timeout)                               │
│                        │                                                  │
│                        ▼                                                  │
│              KeyManager.set(KeyRequestPairingAtSetMac, pairParam)        │
│                        │                                                  │
│                        ▼                                                  │
│              绑定结果提示                                                  │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

---

十二、关键类速查

类	路径	作用
D2dFragment	h12ptool/newuifragment/D2dFragment.java	对频主页面（新 UI）
D2dActivity	h12ptool/p006ui/activity/D2dActivity.java	对频页面（旧 UI）
NewuiG12MacPairFragment	h12ptool/newuifragment/NewuiG12MacPairFragment.java	MAC 读取/设置页面
NewuiG12SignalFragment	h12ptool/newuifragment/NewuiG12SignalFragment.java	信号质量图表
NewuiWirelessSettingsFragment	h12ptool/newuifragment/NewuiWirelessSettingsFragment.java	无线设置入口
D2dController	fishsemi/sdk/d2dcontrol/D2dController.java	D2D 系统级控制器
AirLinkKey	rcsdk/key/AirLinkKey.java	对频/信号质量相关所有 Key 定义
RemoteControllerKey	rcsdk/key/RemoteControllerKey.java	对频动作 Key（Start/Stop）
InternalKey	rcsdk/internal/InternalKey.java	内部状态 Key（Ar8030Pairing）
PairParam	rcsdk/common/airlink/PairParam.java	对频参数（MAC + 超时）
ChanInfo	rcsdk/common/airlink/ChanInfo.java	信道扫描数据
GLinkThroughput	rcsdk/common/airlink/GLinkThroughput.java	链路吞吐量
GLinkSkyDevice	rcsdk/common/airlink/GLinkSkyDevice.java	天空端设备类型
StringUtils	business/util/StringUtils.java	连接状态字符串工具

---

十三、SDK Key 汇总（对频相关）

对频动作 Key

Key	方法	参数类型	说明
KeyRequestPairing	action	EmptyMsg	开始对频
KeyRequestStopPair	action	EmptyMsg	停止对频
KeyRequestPairingAtSetMac	set	PairParam	指定 MAC 绑定

状态监听 Key

Key	读取方法	返回值类型	说明
KeyRawSignalQuality	listen	String (JSON)	原始信号质量（含 dev_connect）
KeyRawSignalQuality2	listen	String (JSON)	备用信号质量
KeySignalQuality	listen	Integer	通用信号强度
KeyGLinkSkyDevice	listen	GLinkSkyDevice[]	已连接的天空端设备列表
KeyGLinkThroughput	get	GLinkThroughput	链路吞吐量（RX/TX kbps）
KeyMAC	get	String	设备 MAC 地址

信道/频段 Key

Key	说明
KeyG12RCScanChanInfo	G12 地面端信道扫描信息
KeyG12SkyScanChanInfo	G12 天空端信道扫描信息
KeyRCGetBandInfo	获取遥控器频段信息
KeySkyGetBandInfo	获取天空端频段信息
KeyRCSetBand	设置遥控器频段
KeySkySetBand	设置天空端频段
KeyRCSetBandSave	保存遥控器频段
KeySkySetBandSave	保存天空端频段
KeyRCSetBandAutoMode	遥控器自动跳频模式
KeySkySetBandAutoMode	天空端自动跳频模式
KeyRCFreqList	遥控器可用频率列表

---

文档生成完毕。