【android bluetooth 协议分析 06】【l2cap详解 6】【L2CA_Register函数解析】

L2CA_Register() 函数的实现，它的作用是：
注册一个 L2CAP 服务（基于 PSM）并设置回调函数、MTU、安全等级、传输模式等信息，供 L2CAP 层用于处理连接、配置、数据、断开等事件。

1. L2CA_Register2/L2CA_Register

参数	说明
psm	Protocol/Service Multiplexer，协议服务标识符（A2DP 信令用 0x0019）
p_cb_info	包含各种回调函数的结构体（连接、配置、数据、断开等）
enable_snoop	是否开启抓包（snoop log）
p_ertm_info	指定可靠传输模式（如 ERTM/FCR）相关配置
my_mtu	本地最大传输单元
required_remote_mtu	期望远端 MTU
sec_level	安全等级（认证、加密等）

// system/stack/l2cap/l2c_api.cc
uint16_t L2CA_Register2(uint16_t psm, const tL2CAP_APPL_INFO& p_cb_info,bool enable_snoop, tL2CAP_ERTM_INFO* p_ertm_info,uint16_t my_mtu, uint16_t required_remote_mtu,uint16_t sec_level) {auto ret = L2CA_Register(psm, p_cb_info, enable_snoop, p_ertm_info, my_mtu,required_remote_mtu, sec_level);BTM_SetSecurityLevel(false, "", 0, sec_level, psm, 0, 0);return ret;
}uint16_t L2CA_Register(uint16_t psm, const tL2CAP_APPL_INFO& p_cb_info,bool enable_snoop, tL2CAP_ERTM_INFO* p_ertm_info,uint16_t my_mtu, uint16_t required_remote_mtu,uint16_t sec_level) {// 1. 优先判断是否启用新版 GD L2CAP, 我们暂时没有开启 GD L2cap, 暂时不分析if (bluetooth::shim::is_gd_l2cap_enabled()) {// 判断是否启用了新版 GD L2CAP（Google's new architecture）。// 如果启用：调用新的实现，退出旧逻辑return bluetooth::shim::L2CA_Register(psm, p_cb_info, enable_snoop,p_ertm_info, my_mtu,required_remote_mtu, sec_level);}/* 2. 检查必要的回调函数是否提供必须提供以下回调，否则无法注册服务： 就像你开店前必须配好收银台、接待员、保安，否则不让开业。1. pL2CA_ConfigCfm_Cb2. pL2CA_DataInd_Cb3. pL2CA_DisconnectInd_Cb*/const bool config_cfm_cb = (p_cb_info.pL2CA_ConfigCfm_Cb != nullptr);const bool config_ind_cb = (p_cb_info.pL2CA_ConfigInd_Cb != nullptr);const bool data_ind_cb = (p_cb_info.pL2CA_DataInd_Cb != nullptr);const bool disconnect_ind_cb = (p_cb_info.pL2CA_DisconnectInd_Cb != nullptr);tL2C_RCB* p_rcb;uint16_t vpsm = psm;/* Verify that the required callback info has been filled in**      Note:  Connection callbacks are required but not checked**             for here because it is possible to be only a client**             or only a server.*/if (!config_cfm_cb || !data_ind_cb || !disconnect_ind_cb) {LOG_ERROR("L2CAP - no cb registering PSM: 0x%04x cfg_cfm:%u cfg_ind:%u"" data_ind:%u discon_int:%u",psm, config_cfm_cb, config_ind_cb, data_ind_cb, disconnect_ind_cb);return (0);}// 3. 验证 PSM 是否有效, 确保 PSM 合法（不能是保留字段、非法值）。/* Verify PSM is valid */if (L2C_INVALID_PSM(psm)) {LOG_ERROR("L2CAP - invalid PSM value, PSM: 0x%04x", psm);return (0);}// 4. 为客户端注册分配虚拟 PSM（vPSM）/* Check if this is a registration for an outgoing-only connection to *//* a dynamic PSM. If so, allocate a "virtual" PSM for the app to use. */// 如果没有设置 pL2CA_ConnectInd_Cb（表示不监听入站连接），L2CAP 会分配一个虚拟 PSM。// 原因是：服务端监听必须是静态 PSM，但客户端可以使用动态编号。if ((psm >= 0x1001) && (p_cb_info.pL2CA_ConnectInd_Cb == NULL)) {//  // 说明仅用于客户端，不处理 远端主动连接for (vpsm = 0x1002; vpsm < 0x8000; vpsm += 2) {p_rcb = l2cu_find_rcb_by_psm(vpsm);if (p_rcb == NULL) break;}LOG_DEBUG("L2CAP - Real PSM: 0x%04x  Virtual PSM: 0x%04x", psm, vpsm);}// 5. 查找或创建 RCB（Registration Control Block）/* If registration block already there, just overwrite it */p_rcb = l2cu_find_rcb_by_psm(vpsm); // 若已存在注册，则复用;否则分配一个新的注册块。if (p_rcb == NULL) {p_rcb = l2cu_allocate_rcb(vpsm);if (p_rcb == NULL) {LOG_WARN("L2CAP - no RCB available, PSM: 0x%04x  vPSM: 0x%04x", psm,vpsm);return (0);}}// 6. 填充 RCB 参数, 存储服务所需的参数。LOG_INFO("L2CAP Registered service classic PSM: 0x%04x", psm);p_rcb->log_packets = enable_snoop;p_rcb->api = p_cb_info;p_rcb->real_psm = psm;p_rcb->ertm_info = p_ertm_info == nullptr? tL2CAP_ERTM_INFO{L2CAP_FCR_BASIC_MODE}: *p_ertm_info; // 如果没有提供 p_ertm_info，默认使用 Basic Mode（非可靠传输）。p_rcb->my_mtu = my_mtu;p_rcb->required_remote_mtu =std::max<uint16_t>(required_remote_mtu, L2CAP_MIN_MTU);// 7. 返回注册成功的（虚拟）PSM, 返回注册成功后使用的 PSM，可能是原始的，也可能是自动分配的虚拟 PSM。return (vpsm);
}

tL2CAP_APPL_INFO

// system/stack/include/l2c_api.h
typedef struct {tL2CA_CONNECT_IND_CB* pL2CA_ConnectInd_Cb;tL2CA_CONNECT_CFM_CB* pL2CA_ConnectCfm_Cb;tL2CA_CONFIG_IND_CB* pL2CA_ConfigInd_Cb;tL2CA_CONFIG_CFM_CB* pL2CA_ConfigCfm_Cb;tL2CA_DISCONNECT_IND_CB* pL2CA_DisconnectInd_Cb;tL2CA_DISCONNECT_CFM_CB* pL2CA_DisconnectCfm_Cb;tL2CA_DATA_IND_CB* pL2CA_DataInd_Cb;tL2CA_CONGESTION_STATUS_CB* pL2CA_CongestionStatus_Cb;tL2CA_TX_COMPLETE_CB* pL2CA_TxComplete_Cb;tL2CA_ERROR_CB* pL2CA_Error_Cb;tL2CA_CREDIT_BASED_CONNECT_IND_CB* pL2CA_CreditBasedConnectInd_Cb;tL2CA_CREDIT_BASED_CONNECT_CFM_CB* pL2CA_CreditBasedConnectCfm_Cb;tL2CA_CREDIT_BASED_RECONFIG_COMPLETED_CB*pL2CA_CreditBasedReconfigCompleted_Cb;tL2CA_CREDIT_BASED_COLLISION_IND_CB* pL2CA_CreditBasedCollisionInd_Cb;
} tL2CAP_APPL_INFO;

回调函数指针	回调触发时机	说明
pL2CA_ConnectInd_Cb	当远端设备尝试发起 L2CAP 连接请求时	被动连接接收回调（如手机发起连接到车机时）
pL2CA_ConnectCfm_Cb	本地设备主动发起连接后，远端确认连接完成时	主动连接的确认回调
pL2CA_ConfigInd_Cb	收到远端的配置请求（如 MTU、流控参数）时	对方提出配置要求，等待本地回应
pL2CA_ConfigCfm_Cb	本地发送配置请求后，收到远端的配置确认时	对方接受了本地配置
pL2CA_DisconnectInd_Cb	对端发起断开连接时	被动断开通知
pL2CA_DisconnectCfm_Cb	本地请求断开连接后，对端确认断开完成时	主动断开完成确认
pL2CA_DataInd_Cb	收到对端通过 L2CAP 发送的数据时	接收数据，例如 AVDTP 信令或媒体数据
pL2CA_CongestionStatus_Cb	L2CAP 发送队列从阻塞变为可用或反之时	通知应用当前通道是否阻塞（拥塞控制）
pL2CA_TxComplete_Cb	某个数据包成功发送完毕后	数据发送完成（带缓冲机制时常用）
pL2CA_Error_Cb	L2CAP 层出现错误（如参数非法、状态错误）时	用于调试和异常处理
pL2CA_CreditBasedConnectInd_Cb	收到基于 Credit 的连接请求时	用于 LE 信道（如 LE CoC 模式）
pL2CA_CreditBasedConnectCfm_Cb	本地发起 Credit Based 连接后，收到对端确认	与 LE CoC 建立流程对应
pL2CA_CreditBasedReconfigCompleted_Cb	Credit Based 信道重新配置完成时	支持 MTU 或 MPS 改变
pL2CA_CreditBasedCollisionInd_Cb	发现本地和远端同时发起 LE CoC 信道连接时	用于处理冲突连接的场景

• 把 L2CAP 通道看作打电话，来理解这些回调调用时机：

  • pL2CA_ConnectInd_Cb 就像别人打电话过来（你接电话）。

  • pL2CA_ConnectCfm_Cb 是你打电话给别人，对方接通了。

  • pL2CA_ConfigInd/Cfm_Cb 是双方通话前确认通话方式（语音、视频、网络质量等）。

  • pL2CA_DataInd_Cb 是你在通话中听到的内容。

  • pL2CA_DisconnectInd/Cfm_Cb 是挂电话的通知。

  • pL2CA_CreditBased... 是另一种“对讲机”式的沟通方式（BLE CoC），双方轮流说话，且有限次数（credit）。