4. L2CAP通道状态机

L2CAP通道状态机是蓝牙协议栈中连接管理的核心机制。它定义了通道从创建到销毁的完整生命周期，每个状态对应一组允许的操作和事件处理函数。理解状态机是调试L2CAP连接问题的前提——90%的L2CAP故障都可以通过状态不一致或非法状态转换来解释。

4.1 状态定义与枚举

内核在 include/net/bluetooth/l2cap.h 中定义了 l2cap_chan_state 枚举，共包含7个状态：

4.2 状态转换图

下图展示了L2CAP通道的完整状态转换路径。箭头上的标签表示触发转换的事件或操作：

4.3 内核代码中的状态枚举

在 net/bluetooth/l2cap_core.c 中，状态枚举定义如下：

/* include/net/bluetooth/l2cap.h */
enum l2cap_chan_state {
    BT_CLOSED,          /* 0: 通道关闭 */
    BT_CONNECT,         /* 1: 等待连接确认（主动方） */
    BT_CONNECT2,        /* 2: 等待用户接受（被动方） */
    BT_CONFIG,          /* 3: 配置协商中 */
    BT_OPEN,            /* 4: 通道已打开 */
    BT_DISCONN,         /* 5: 等待断开确认（主动方） */
    BT_DISCONN2,        /* 6: 等待用户确认断开（被动方） */
};

状态转换由 l2cap_chan_set_state() 函数执行，该函数会同时更新通道的 state 字段并触发状态变更通知：

/* net/bluetooth/l2cap_core.c */
static void l2cap_chan_set_state(struct l2cap_chan *chan, u32 state)
{
    u32 old_state = chan->state;

    chan->state = state;

    /* 状态变更通知回调 */
    if (chan->ops && chan->ops->state_change)
        chan->ops->state_change(chan, state, old_state);

    /* 特殊状态处理 */
    switch (state) {
    case BT_CLOSED:
        /* 清理资源，通知上层 */
        break;
    case BT_OPEN:
        /* 通知上层通道已就绪 */
        break;
    default:
        break;
    }
}

4.4 各状态的核心行为

每个状态对应一组允许的操作和超时处理。下表总结了关键行为：

4.5 状态机与通道操作的关系

L2CAP通道的每个操作函数都会检查当前状态是否合法。例如，发送数据的核心函数 l2cap_chan_send() 只在 BT_OPEN 状态下执行：

int l2cap_chan_send(struct l2cap_chan *chan, struct msghdr *msg, size_t len)
{
    /* 状态检查：只有OPEN状态才能发送数据 */
    if (chan->state != BT_OPEN)
        return -ENOTCONN;

    /* 后续处理：分段、加密、发送 */
    ...
}

4.6 状态机调试方法

实际工程中，状态机问题通常表现为“通道卡死”或“状态不一致”。以下是推荐的调试步骤：

1. 查看当前状态： 通过debugfs读取通道状态：cat /sys/kernel/debug/bluetooth/hci0/l2cap
2. 检查超时定时器： 使用 cat /proc/timer_list | grep l2cap 查看是否有挂起的L2CAP定时器
3. 抓取信令包： 使用 btmon -t -w l2cap_trace.log 捕获完整的L2CAP信令交互
4. 分析状态转换： 在 l2cap_chan_set_state() 中添加动态调试：echo 'file l2cap_core.c line +p' > /sys/kernel/debug/dynamic_debug/control
5. 检查引用计数： 使用 cat /sys/kernel/debug/bluetooth/hci0/l2cap_le 查看LE通道状态，确认是否有引用泄漏