本文分析了蓝牙bluez协议栈中HID协议的实现。1. 基本概念HID协议用于人机输入设备。Bluez中关于HID的实现代码在其根目录下的input目录。蓝牙规范中包含关于HID的profile，里面重用了USB中关于HID的一些协议规范。Bluez协议栈与上层应用之间使用dbus接口。Bluez与kernel之间使用AF_BLUETOOTH协议族的socket通信，并使用了gtk+中的glib库。2. 初始化HID的初始化在input目录的main.c中，input_manager_init函数。该函数会调用input_manager_init。在input_manager_init中，主要是做了三个操作： btd_register_adapter_driver(&input_server_driver); btd_register_device_driver(&input_hid_driver); btd_register_device_driver(&input_headset_driver);下面分别讨论。2.1 btd_register_adapter_driverbtd_register_adapter_driver(&input_server_driver);static struct btd_adapter_driver input_server_driver = { .name = "input-server", .probe = hid_server_probe, .remove = hid_server_remove,};这个调用的作用是注册一个adapter driver。系统启动后对每一个本地蓝牙的硬件实例，即每一个HCI设备，都会调用里面的probe函数hid_server_probe。static int hid_server_probe(struct btd_adapter *adapter) // 得到hci设备的本地蓝牙地址adapter_get_address(adapter, &src);// 启动hid服务server_start(&src);。。。 int server_start(const bdaddr_t *src) struct input_server *server = g_new0(struct input_server, 1); // 在ctrl通道（L2CAP_PSM_HIDP_CTRL）上listen，回调函数connect_event_cb server->ctrl = bt_io_listen(BT_IO_L2CAP, connect_event_cb, NULL, server, NULL, &err, BT_IO_OPT_SOURCE_BDADDR, src, BT_IO_OPT_PSM, L2CAP_PSM_HIDP_CTRL, BT_IO_OPT_SEC_LEVEL, BT_IO_SEC_LOW, BT_IO_OPT_INVALID); // 在intr通道（L2CAP_PSM_HIDP_INTR）listen，回调函数confirm_event_cbserver->intr = bt_io_listen(BT_IO_L2CAP, NULL, confirm_event_cb, server, NULL, &err, BT_IO_OPT_SOURCE_BDADDR, src, BT_IO_OPT_PSM, L2CAP_PSM_HIDP_INTR, BT_IO_OPT_SEC_LEVEL, BT_IO_SEC_LOW, BT_IO_OPT_INVALID);上面的ctrl通道和intr通道都是由蓝牙的HID spec规定。对于control通道，当设备端有主动连接本机时，会由glib调用回调函数connect_event_cb：static void connect_event_cb(GIOChannel *chan, GError *err, gpointer data) // 得到该设备的源地址和目的地址，psm等 bt_io_get(chan, BT_IO_L2CAP, &gerr, BT_IO_OPT_SOURCE_BDADDR, &src, BT_IO_OPT_DEST_BDADDR, &dst, BT_IO_OPT_PSM, &psm, BT_IO_OPT_INVALID); // 设置input_device input_device_set_channel(&src, &dst, psm, chan); // 如果是非法设备，并且当前是控制通道，那么根据HID协议，需要向对方发送“unplug virtual cable”消息 if (ret == -ENOENT && psm == L2CAP_PSM_HIDP_CTRL) { unsigned char unplug = 0x15; int err, sk = g_io_channel_unix_get_fd(chan); err = write(sk, &unplug, sizeof(unplug)); }下面继续研究input_device_set_channel函数。int input_device_set_channel(const bdaddr_t *src, const bdaddr_t *dst, int psm, GIOChannel *io) // 根据对方设备的地址，从HID设备链表中找到对应的input_dev设备。这里有一个问题，就是对应的input_dev设备是什么时候登记到链表中的，这一点稍后再讨论 struct input_device *idev = find_device(src, dst); // 在该设备中，查找名为”hid”的连接 struct input_conn * iconn = find_connection(idev->connections, "hid"); switch (psm) { case L2CAP_PSM_HIDP_CTRL: if (iconn->ctrl_io) return -EALREADY; iconn->ctrl_io = g_io_channel_ref(io); break; case L2CAP_PSM_HIDP_INTR: if (iconn->intr_io) return -EALREADY; iconn->intr_io = g_io_channel_ref(io); break; } // 当ctrl通道和intr通道都被设置后，才会进入input_device_connadd。目前我们是沿着L2CAP_PSM_HIDP_CTRL的回调函数connect_event_cb看到这里的，所以暂时先不深入研究 if (iconn->intr_io && iconn->ctrl_io) input_device_connadd(idev, iconn); 。。。下面再看一下server_start函数中对L2CAP_PSM_HIDP_INTR的情况，此时会调用到confirm_event_cb函数。关于bt_io_listen中关于connect和confirm这两个函数的区别，可以自行查看glib的文档或者bluez的源代码。static void confirm_event_cb(GIOChannel *chan, gpointer user_data) bt_io_get(chan, BT_IO_L2CAP, &err, BT_IO_OPT_SOURCE_BDADDR, &src, BT_IO_OPT_DEST_BDADDR, &dst, BT_IO_OPT_INVALID); server->confirm = g_io_channel_ref(chan); // 请求authorization操作，并指定完成后的回调函数为auth_callback btd_request_authorization(&src, &dst, HID_UUID, auth_callback, server);static void auth_callback(DBusError *derr, void *user_data) bt_io_get(server->confirm, BT_IO_L2CAP, &err, BT_IO_OPT_SOURCE_BDADDR, &src, BT_IO_OPT_DEST_BDADDR, &dst, BT_IO_OPT_INVALID); bt_io_accept(server->confirm, connect_event_cb, server, NULL, &err)由此可见，authorization结束后，会调用bt_io_accept，并同样指定回调函数为connect_event_cb。此时connect_event_cb会设置intr通道，并最终调用input_device_connadd函数。static int input_device_connadd(struct input_device *idev, struct input_conn *iconn) input_device_connected(idev, iconn) 。。。static int input_device_connected(struct input_device *idev, struct input_conn *iconn) hidp_add_connection(idev, iconn) 。。。connected = TRUE; // 通过dbus发送已连接的信号emit_property_changed(idev->conn, idev->path, INPUT_DEVICE_INTERFACE, "Connected", DBUS_TYPE_BOOLEAN, &connected); 。。。static int hidp_add_connection(const struct input_device *idev, const struct input_conn *iconn) struct hidp_connadd_req *req； sdp_record_t *rec; req = g_new0(struct hidp_connadd_req, 1); req->ctrl_sock = g_io_channel_unix_get_fd(iconn->ctrl_io); req->intr_sock = g_io_channel_unix_get_fd(iconn->intr_io); req->flags = 0; req->idle_to = iconn->timeout; ba2str(&idev->src, src_addr); ba2str(&idev->dst, dst_addr); // 查找该设备对应的SDPrec = fetch_record(src_addr, dst_addr, idev->handle);// 从SDP record中得到一些属性从而设置req中某些域，具体可看代码，包括HID的设备描述符等都在这里设置extract_hid_record(rec, req);sdp_record_free(rec);// 根据SDP得到设备的vendor、product等信息read_device_id(src_addr, dst_addr, NULL, &req->vendor, &req->product, &req->version);// 下面是支持fakehid的代码，目前仅有PS3的设备支持，所以这里不分析struct fake_hid *fake_hid = get_fake_hid(req->vendor, req->product);。。。if (req->subclass & 0x40) // 如果是键盘，则启动加密 bt_acl_encrypt(&idev->src, &idev->dst, encrypt_completed, req); 。。。// ioctl_connadd中会建立一个BTPROTO_HIDP的socket，并调用HIDPCONNADD新建一个连接。到这里，与远端设备的连接就建立了。建立之后，kernel会建立一个HID设备，此HID设备与bluez之间通过ctrl sock和intr sock进行数据交互ioctl_connadd(req); 2.2 btd_register_device_driverbtd_register_device_driver用于注册设备驱动，在bluez中使用这个函数注册的设备有两个，分别是input_headset_driver和input_hid_driver。其中input-headset与蓝牙耳机有关；input-hid则用于普通的HID设备。下面先看一下input_hid_driver设备。input_hid_driverstatic struct btd_device_driver input_hid_driver = { .name = "input-hid", .uuids = BTD_UUIDS(HID_UUID), .probe = hid_device_probe, .remove = hid_device_remove,};当bluez检测到有一个hid设备，即uuid中包含HID_UUID的设备连接上时，就会调用其中的probe函数。static int hid_device_probe(struct btd_device *device, GSList *uuids) 。。。 input_device_register(connection, device, path, &src, &dst, HID_UUID, rec->handle, idle_timeout * 60); int input_device_register(DBusConnection *conn, struct btd_device *device, const char *path, const bdaddr_t *src, const bdaddr_t *dst, const char *uuid, uint32_t handle, int timeout) 。。。 // 分配一个新的input_device结构体，并添加到全局链表devices中 // 前文分析input_device_set_channel函数时，提到的添加idev的地方，就在这里idev = input_device_new(conn, device, path, src, dst, handle); devices = g_slist_append(devices, idev); 。。。 // 添加一个名为”hid”的连接 iconn = input_conn_new(idev, uuid, "hid", timeout); idev->connections = g_slist_append(idev->connections, iconn);在函数input_device_new中，除了新建设备之外，还添加了一个dbus接口：g_dbus_register_interface(conn, idev->path, INPUT_DEVICE_INTERFACE, device_methods, device_signals, NULL, idev, device_unregister)static GDBusMethodTable device_methods[] = { { "Connect", "", "", input_device_connect, G_DBUS_METHOD_FLAG_ASYNC }, { "Disconnect", "", "", input_device_disconnect }, { "VirtualUnplug", "", "", input_device_unplug }, { "GetProperties", "", "a{sv}",input_device_get_properties }, { }};前文分析HID连接的建立时，都是本机作为服务器，等待远端设备连接。有了这个dbus接口之后，本地应用程序就可以主动连接远端设备，只要调用”Connect”方法即可，此方法会被链接到input_device_connect函数。Input_device_connect中的流程与前文中本机作为服务器的流程基本相同。在此函数中，会先建立ctrl通道的连接，然后再建立intr通道的连接。最终通过调用函数hidp_add_connection通知内核建立一个HID设备或者input设备(HID boot protocol设备)。input-headsetstatic struct btd_device_driver input_headset_driver = { .name = "input-headset", .uuids = BTD_UUIDS(HSP_HS_UUID), .probe = headset_probe, .remove = headset_remove,};Input-headset的流程比较特殊，与input-hid的区别至少有以下几点：1. HID设备的连接建立在l2cap上，headset的连接建立在rfcomm上。2. HID设备会通知内核建立一个HID设备或input设备，headset则只是实例化一个uinput设备。3. 前文提到的ctrl通道、intr通道都不能适用于headset，因为他们都是在l2cap上的连接。如果是本地主动连接远端的headset设备，同样是由应用程序调用”connect”方法启动连接过程，具体实现可查看代 
