关键词:蓝牙blueZ UART HCI_UART H4 HCI L2CAP RFCOMM
版本号:基于android4.2先前版本 bluez
内核:linux/linux3.08
系统:android/android4.1.3.4
作者:xubin341719(欢迎转载,请注明作者。请尊重版权谢谢)
欢迎指正错误,共同学习、共同进步!!
Android bluetooth介绍(一):基本概念及硬件接口
Android bluetooth介绍(二): android 蓝牙代码架构及其uart 到rfcomm流程
Android bluetooth介绍(三): 蓝牙扫描(scan)设备分析
Android bluetooth介绍(四): a2dp connect流程分析
一、Android Bluetooth Architecture蓝牙代码架构部分(google 官方蓝牙框架)
Android的蓝牙系统。自下而上包含以下一些内容如上图所看到的:
1、串口驱动
Linux的内核的蓝牙驱动程、Linux的内核的蓝牙协议的层
2、BlueZ的适配器
BlueZ的(蓝牙在用户空间的函式库)
bluez代码结构
Bluetooth协议栈BlueZ分为两部分:内核代码和用户态程序及工具集。
(1)、内核代码:由BlueZ核心协议和驱动程序组成
Bluetooth协议实如今内核源码 kernel/net/bluetooth中。
包含hci,l2cap,hid,rfcomm,sco,SDP,BNEP等协议的实现。
(2)、驱动程序:kernel/driver/bluetooth中,包含Linuxkernel对各种接口的
Bluetooth device的驱动,如:USB接口,串口等。
(3)、用户态程序及工具集:
包含应用程序接口和BlueZ工具集。BlueZ提供函数库以及应用程序接口,便于程序猿开发bluetooth应用程序。BlueZ utils是主要工具集,实现对bluetooth设备的初始化和控制。
3、蓝牙相关的应用程序接口
Android.buletooth包中的各个Class(蓝牙在框架层的内容-----java)
类名 | 作用 |
BluetoothAdapter | 本地蓝牙设备的适配类,全部的蓝牙操作都要通过该类完毕 |
BluetoothClass | 用于描写叙述远端设备的类型。特点等信息 |
BluetoothDevice | 蓝牙设备类,代表了蓝牙通讯过程中的远端设备 |
BluetoothServerSocket | 蓝牙设备服务端,相似ServerSocket |
BluetoothSocket | 蓝牙设备client。相似Socket |
BluetoothClass.Device | 蓝牙关于设备信息 |
BluetoothClass.Device.Major | 蓝牙设备管理 |
BluetoothClass.Service | 蓝牙相关服务 |
相同下图也是一张比較经典的蓝牙代码架构图(google官方提供)
二、蓝牙通过Hciattach启动串口流程:
1、hciattach整体流程
2、展讯hciattach代码实现流程:
三、详细代码分析
1、initrc中定义
idh.codedevicesprdsp8830ec_nwcninit.sc8830.rc
service hciattach /system/bin/hciattach -n /dev/sttybt0 sprd_shark socket bluetooth stream 660 bluetooth bluetooth user bluetooth group wifi bluetooth net_bt_admin net_bt inet net_raw net_admin system disabled oneshot
adb 下/dev/ttybt0(不同平台有所不同)
PS 进程中:hicattch
2、/system/bin/hciattach 执行的Main函数
idh.codeexternalluetoothluez oolshciattach.c
service hciattach /system/bin/hciattach -n /dev/sttybt0 sprd_shark
传进两个參数,/dev/sttybt0 和 sprd_shark
nt main(int argc, char *argv[]) { ……………… for (n = 0; optind < argc; n++, optind++) { char *opt; opt = argv[optind]; switch(n) { case 0://(1)、解析驱动的位置; dev[0] = 0; if (!strchr(opt, '/')) strcpy(dev, "/dev/"); strcat(dev, opt); break; case 1://(2)、解析串口的配置相关參数。 if (strchr(argv[optind], ',')) { int m_id, p_id; sscanf(argv[optind], "%x,%x", &m_id, &p_id); u = get_by_id(m_id, p_id); } else { u = get_by_type(opt); } if (!u) { fprintf(stderr, "Unknown device type or id "); exit(1); } break; case 2://(3)、通过对前面參数的解析,把uart[i]中的数值初始化; u->speed = atoi(argv[optind]); break; case 3: if (!strcmp("flow", argv[optind])) u->flags |= FLOW_CTL; else u->flags &= ~FLOW_CTL; break; case 4: if (!strcmp("sleep", argv[optind])) u->pm = ENABLE_PM; else u->pm = DISABLE_PM; break; case 5: u->bdaddr = argv[optind]; break; } } ……………… if (init_speed)//初始化串口速率; u->init_speed = init_speed; ……………… n = init_uart(dev, u, send_break, raw);//(4)、初始化串口; ……………… return 0; }
(1)、解析驱动的位置。
if (!strchr(opt, '/')) strcpy(dev, "/dev/"); service hciattach /system/bin/hciattach -n /dev/sttybt0 sprd_shark dev = /dev/ttyb0
(2)、解析串口的配置相关參数;获取參数相应的结构体。
u = get_by_id(m_id, p_id); static struct uart_t * get_by_id(int m_id, int p_id) { int i; for (i = 0; uart[i].type; i++) { if (uart[i].m_id == m_id && uart[i].p_id == p_id) return &uart[i]; } return NULL; }
这个函数比較简单,通过循环对照。如传进了的參数sprd_shark和uart结构体中的对照,找到相应的数组。假设是其它蓝牙芯片,如博通、RDA、BEKN等着到其相相应的初始化配置函数。
struct uart_t uart[] = { { "any", 0x0000, 0x0000, HCI_UART_H4, 115200, 115200, FLOW_CTL, DISABLE_PM, NULL, NULL }, { "sprd_shark", 0x0000, 0x0000, HCI_UART_H4, 115200, 115200, FLOW_CTL, DISABLE_PM, NULL, init_sprd_config }, { "ericsson", 0x0000, 0x0000, HCI_UART_H4, 57600, 115200, FLOW_CTL, DISABLE_PM, NULL, ericsson }, ……………… { "bk3211", 0x0000, 0x0000, HCI_UART_BCSP, 115200, 921600, 0, DISABLE_PM, NULL, beken_init, NULL}, { NULL, 0 } };
注意:init_sprd_config这个函数在uart_init中用到,这个函数事实上对我们详细芯片的初始化配置。
凝视:HCI_UART_H4和HCI_UART_BCSP的差别例如以下图。
(3)、通过对前面參数的解析,把uart[i]中的数值初始化;
u->speed = atoi(argv[optind]); break;
(4)、初始化串口;
n = init_uart(dev, u, send_break, raw); idh.codeexternalluetoothluez oolshciattach.c /* Initialize UART driver */ int init_uart(char *dev, struct uart_t *u, int send_break) { struct termios ti; int fd, i; fd = open(dev, O_RDWR | O_NOCTTY);//打开串口设备,当中标志 //O_RDWR,能够对此设备进行读写操作。 //O_NOCTTY:告诉Unix这个程序不想成为“控制终端”控制的程序,不说明这个标志的话,不论什么输入都会影响你的程序。//O_NDELAY:告诉Unix这个程序不关心DCD信号线状态。即其它端口是否执行。不说明这个标志的话,该程序就会在DCD信号线为低电平时停止。 //可是不要以控制 tty 的模式,由于我们并不希望在发送 Ctrl-C 后结束此进程 if (fd < 0) { perror(“Can’t open serial port”); return -1; } //drop fd’s data; tcflush(fd, TCIOFLUSH);//清空数据线 if (tcgetattr(fd, &ti) < 0) { perror(“Can’t get port settings”); return -1; } cfmakeraw(&ti); cfmakeraw sets the terminal attributes as follows://此函数设置串口终端的以下这些属性, termios_p->c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP |INLCR|IGNCR|ICRNL|IXON); termios_p->c_oflag &= ~OPOST; termios_p->c_lflag &= ~(ECHO|ECHONL|ICANON|ISIG|IEXTEN); termios_p->c_cflag &= ~(CSIZE|PARENB) ; termios_p->c_cflag |=CS8; ti.c_cflag |= CLOCAL;//本地连接,无调制解调器控制 if (u->flags & FLOW_CTL) ti.c_cflag |= CRTSCTS;//输出硬件流控 else ti.c_cflag &= ~CRTSCTS; if (tcsetattr(fd, TCSANOW, &ti) < 0) {//启动新的串口设置 perror(“Can’t set port settings”); return -1; } /* Set initial baudrate */ if (set_speed(fd, &ti, u->init_speed) < 0) {//设置串口的传输速率bps, 也能够使 //用 cfsetispeed 和 cfsetospeed 来设置 perror(“Can’t set initial baud rate”); return -1; } tcflush(fd, TCIOFLUSH);//清空数据线 if (send_break) tcsendbreak(fd, 0); //int tcsendbreak ( int fd, int duration );Sends a break for //the given time.在串口线上发送0值,至少维持0.25秒。 //If duration is 0, it transmits zero-valued bits for at least 0.25 seconds, and //not more than 0.5seconds. //where place register u’s init function; if (u->init && u->init(fd, u, &ti) < 0) //全部bluez支持的蓝牙串口设备类型构成了一个uart结构数组,通过 //查找相应的uart类型。这个uart的init成员显示了它的init调用方法; struct uart_t uart[] = { { "any", 0x0000, 0x0000, HCI_UART_H4, 115200, 115200,FLOW_CTL, DISABLE_PM, NULL, NULL }, { "sprd_shark", 0x0000, 0x0000, HCI_UART_H4, 115200, 115200,FLOW_CTL, DISABLE_PM, NULL, init_sprd_config }, { "ericsson", 0x0000, 0x0000, HCI_UART_H4, 57600, 115200,FLOW_CTL, DISABLE_PM, NULL, ericsson }, ……………… { "bk3211", 0x0000, 0x0000, HCI_UART_BCSP, 115200, 921600, 0, DISABLE_PM, NULL, beken_init, NULL}, { NULL, 0的init函数名为bcsp,定义在本文件里**; return -1; tcflush(fd, TCIOFLUSH);//清空数据线 /* Set actual baudrate */ if (set_speed(fd, &ti, u->speed) < 0) { perror(“Can’t set baud rate”); return -1; } /* Set TTY to N_HCI line discipline */ i = N_HCI; if (ioctl(fd, TIOCSETD, &i) < 0) {// TIOCSETD int *ldisc//改变到 i 行规。即hci行规 Change to the new line discipline pointed to by ldisc. The available line disciplines are listed in /* ioctl (fd, TIOCSERGETLSR, &result) where result may be as below */ /* line disciplines */ #define N_TTY 0 …… #define N_HCI 15 /* Bluetooth HCI UART */ perror(“Can’t set line discipline”); return -1; } if (ioctl(fd, HCIUARTSETPROTO, u->proto) < 0) { //设置hci设备的proto操作函数集为hci_uart操作集; perror(“Can’t set device”); return -1; } return fd; }
这里一个重要的部分是:u->init指向init_sprd_config
4、uart详细到芯片的初始化init_sprd_config(这部分依据不同的芯片,相应进入其相应初始化部分)
idh.codeexternalluetoothluez oolshciattach_sprd.c
int sprd_config_init(int fd, char *bdaddr, struct termios *ti) { int i,psk_fd,fd_btaddr,ret = 0,r,size=0,read_btmac=0; unsigned char resp[30]; BT_PSKEY_CONFIG_T bt_para_tmp; char bt_mac[30] = {0}; char bt_mac_tmp[20] = {0}; uint8 bt_mac_bin[32] = {0}; fprintf(stderr,"init_sprd_config in "); //(1)、这部分检查bt_mac,假设存在,从文件里读取,假设不存在,随机生成。并写入相应文件; if(access(BT_MAC_FILE, F_OK) == 0) {//这部分检查bt_mac LOGD("%s: %s exists",__FUNCTION__, BT_MAC_FILE); fd_btaddr = open(BT_MAC_FILE, O_RDWR);// #define BT_MAC_FILE "/productinfo/btmac.txt" if(fd_btaddr>=0) { size = read(fd_btaddr, bt_mac, sizeof(bt_mac));//读取BT_MAC_FILE中的地址。 LOGD("%s: read %s %s, size=%d",__FUNCTION__, BT_MAC_FILE, bt_mac, size); if(size == BT_RAND_MAC_LENGTH){ LOGD("bt mac already exists, no need to random it"); fprintf(stderr, "read btmac ok "); read_btmac=1; } ………… }else{//假设不存在,就随机生成一个bt_mac地址。写入/productinfo/btmac.txt fprintf(stderr, "btmac.txt not exsit! "); read_btmac=0; mac_rand(bt_mac); LOGD("bt random mac=%s",bt_mac); printf("bt_mac=%s ",bt_mac); write_btmac2file(bt_mac); fd_btaddr = open(BT_MAC_FILE, O_RDWR); if(fd_btaddr>=0) { size = read(fd_btaddr, bt_mac, sizeof(bt_mac)); LOGD("%s: read %s %s, size=%d",__FUNCTION__, BT_MAC_FILE, bt_mac, size); if(size == BT_RAND_MAC_LENGTH){ LOGD("bt mac already exists, no need to random it"); fprintf(stderr, "read btmac ok "); read_btmac=1; } close(fd_btaddr); ………… } /* Reset the BT Chip */ memset(resp, 0, sizeof(resp)); memset(&bt_para_tmp, 0, sizeof(BT_PSKEY_CONFIG_T) ); ret = getPskeyFromFile( (void *)(&bt_para_tmp) );//ret = get_pskey_from_file(&bt_para_tmp);//(2)、PSKey參数、射频參数的设定。 if(ret != 0){//參数失败处理 fprintf(stderr, "get_pskey_from_file faill "); /* Send command from hciattach*/ if(read_btmac == 1){ memcpy(bt_para_setting.device_addr, bt_mac_bin, sizeof(bt_para_setting.device_addr));// (3)、读取失败,把bt_para_setting中defaut參数写入; } if (write(fd, (char *)&bt_para_setting, sizeof(BT_PSKEY_CONFIG_T)) != sizeof(BT_PSKEY_CONFIG_T)) { fprintf(stderr, "Failed to write reset command "); return -1; } }else{//getpskey成功处理 /* Send command from pskey_bt.txt*/ if(read_btmac == 1){ memcpy(bt_para_tmp.device_addr, bt_mac_bin, sizeof(bt_para_tmp.device_addr)); } ………… return 0; }
(1)、这部分检查bt_mac,假设存在,从文件里读取,假设不存在。随机生成。并写入相应文件/productinfo/btmac.txt。
(2)、PSKey參数、射频參数的设定;
get_pskey_from_file(&bt_para_tmp);这个函数后面分析;
(3)、读取失败,把bt_para_setting中defaut參数写入;频率、主从设备设定等……
// pskey file structure default value BT_PSKEY_CONFIG_T bt_para_setting={ 5, 0, 0, 0, 0, 0x18cba80, 0x001f00, 0x1e, {0x7a00,0x7600,0x7200,0x5200,0x2300,0x0300}, ………… };
5、get_pskey_from_file 解析相关射频參数
idh.codeexternalluetoothluez oolspskey_get.c
int getPskeyFromFile(void *pData) { ………… char *BOARD_TYPE_PATH = "/dev/board_type";//(1)、推断PCB的版本号; int fd_board_type; char board_type_str[MAX_BOARD_TYPE_LEN] = {0}; int board_type; char *CFG_2351_PATH_2 = "/productinfo/2351_connectivity_configure.ini";//(2)、终于生成ini文件存储的位置; char *CFG_2351_PATH[MAX_BOARD_TYPE]; (3)、针对不同PCB版本号。不同的ini配置文件。 CFG_2351_PATH[0] = "/system/etc/wifi/2351_connectivity_configure_hw100.ini"; CFG_2351_PATH[1] = "/system/etc/wifi/2351_connectivity_configure_hw102.ini"; CFG_2351_PATH[2] = "/system/etc/wifi/2351_connectivity_configure_hw104.ini";
(4)、以下函数就不做详细分析。大致意识是。依据/dev/board_type中,读取的PCB类型,设置不同的ini文件。
……………… ret = chmod(CFG_2351_PATH_2, 0644); ALOGE("chmod 0664 %s ret:%d ", CFG_2351_PATH_2, ret); if(pBuf == pBuf2) free(pBuf1); ……………… }
(1)、推断PCB的版本号;
char *BOARD_TYPE_PATH = "/dev/board_type";
(2)、终于生成ini文件存储的位置,就是系统执行时读取ini文件的地方。
char *CFG_2351_PATH_2 ="/productinfo/2351_connectivity_configure.ini";
(3)、针对不同PCB版本号。不同的ini配置文件。
CFG_2351_PATH[0] = "/system/etc/wifi/2351_connectivity_configure_hw100.ini"; CFG_2351_PATH[1] = "/system/etc/wifi/2351_connectivity_configure_hw102.ini"; CFG_2351_PATH[2] = "/system/etc/wifi/2351_connectivity_configure_hw104.ini";
(4)、以下函数就不做详细分析,大致意识是,依据/dev/board_type中,读取的PCB类型,设置不同的ini文件。 覆盖到(2)中的文件。
四、HCI_UART_H4和H4层的增加
uart->hci_uart->Uart-H4->hci:从uart開始分析,介绍整个驱动层数据流(涉及tty_uart中断, 线路层ldisc_bcsp、tasklet、work queue、skb_buffer的等)
这是数据的流动过程,最底层的也就是和硬件打交道的是uart层了,它的存在和起作用是通过串口驱动来保证的。这个请參阅附录,可是其它的层我们都不知道什么时候work的,以下来看。
1、idh.codekerneldriversluetoothhci_ldisc.c
static int __init hci_uart_init(void) { static struct tty_ldisc_ops hci_uart_ldisc; int err; /* Register the tty discipline */ memset(&hci_uart_ldisc, 0, sizeof (hci_uart_ldisc)); hci_uart_ldisc.magic = TTY_LDISC_MAGIC; hci_uart_ldisc.name = "n_hci"; hci_uart_ldisc.open = hci_uart_tty_open; hci_uart_ldisc.close = hci_uart_tty_close; hci_uart_ldisc.read = hci_uart_tty_read; hci_uart_ldisc.write = hci_uart_tty_write; hci_uart_ldisc.ioctl = hci_uart_tty_ioctl; hci_uart_ldisc.poll = hci_uart_tty_poll; hci_uart_ldisc.receive_buf = hci_uart_tty_receive; hci_uart_ldisc.write_wakeup = hci_uart_tty_wakeup; hci_uart_ldisc.owner = THIS_MODULE; if ((err = tty_register_ldisc(N_HCI, &hci_uart_ldisc))) {//(1)、这部分完毕ldisc的注冊; BT_ERR("HCI line discipline registration failed. (%d)", err); return err; } #ifdef CONFIG_BT_HCIUART_H4 h4_init();//(2)、我们蓝牙芯片用的是H4。这部分完毕H4的注冊; #endif #ifdef CONFIG_BT_HCIUART_BCSP bcsp_init(); #endif ……………… return 0; }
(1)、这部分完毕ldisc的注冊。
tty_register_ldisc(N_HCI,&hci_uart_ldisc)
注冊了一个ldisc。这是通过把新的ldisc放在一个ldisc的数组里面实现的,tty_ldiscs是一个全局的ldisc数组里面会依据序号相应一个ldisc,这个序号就是上层通过ioctl来指定的。比方我们在前面已经看到的:
i = N_HCI;
ioctl(fd, TIOCSETD, &i) < 0
能够看到这里指定的N_HCI刚好就是这里注冊的这个号码15;
(2)、蓝牙芯片用的是H4,这部分完毕H4的注冊。
h4_init();
hci_uart_proto结构体的初始化:
idh.codekerneldriversluetoothhci_h4.c
static struct hci_uart_proto h4p = { .id = HCI_UART_H4, .open = h4_open, .close = h4_close, .recv = h4_recv, .enqueue = h4_enqueue, .dequeue = h4_dequeue, .flush = h4_flush, };
H4的注冊:
idh.codekerneldriversluetoothhci_h4.c
int __init h4_init(void) { int err = hci_uart_register_proto(&h4p); if (!err) BT_INFO("HCI H4 protocol initialized"); else BT_ERR("HCI H4 protocol registration failed"); return err; }
这是通过hci_uart_register_proto(&bcsp)来完毕的,这个函数非常easy。本质例如以下:
hup[p->id]= p;当中static struct hci_uart_proto*hup[HCI_UART_MAX_PROTO];也就是说把相应于协议p的id和协议p连接起来。这样设计的优点是hci uart层本身能够支持不同的协议。包含h4、bcsp等,通过这个数组连接这些协议,等以后有数据的时候调用相应的协议来处理。这里比較关键的是h4里面的这些函数。
五、HCI层的增加
hci的增加是通过hci_register_dev函数来做的,这时候用户通过hciconfig就能够看到有一个接口了,通过这个接口用户能够訪问底层的信息了。hci0已经生成;至于它在何时被增加的,我们再看看hciattach在内核里面的处理过程;
1、TIOCSEATD的处理流程
Ioctl的作用是设置一个新的ldisc;
2、HCIUARTSETPROTO的处理流程:
这部分比較重要,注冊生成hci0, 初始化3个工作队列,hci_rx_work、hci_tx_work、hci_cmd_work;完毕hci部分数据、命令的接收、发送。
六、数据在驱动的传递流程
1、uart数据接收
这部分流程比較简单。事实上就是注冊一个tty驱动程序和相相应的函数,注冊相应的opencloseioctl等方法。通过应用open /dev/ttyS*操作,注冊中断接收函数,接收处理蓝牙模块触发中断的数据。
在这个中断函数里面会接受到来自于蓝牙模块的数据;在中断函数里面会先读取串口的状态寄存器推断是否是data准备好,假设准备好就调用serial_sprd_rx_chars函数来接收数据。以下看看这个函数是怎样处理的:
那就是把数据一个个的增加到uart层的缓冲区,直究竟层不处于dataready状态,或者读了maxcount个数,当读完后就调用tty层的接口把数据传递给tty层。tty层则把数据交给了ldisc,于是控制权也就交给了hci_uart层;
七、Hci_uart的数据接收
它基本上就是要个二传手,通过:
spin_lock(&hu->rx_lock); hu->proto->recv(hu,(void *) data, count); hu->hdev->stat.byte_rx+= count; spin_unlock(&hu->rx_lock);把数据交给了在它之上的协议层,对于我们的设置来说实际上就交给了h4层;
八、H4层处理
这层主要是通过函数h4_recv来处理的,依据协议处理包头、CRC等,然后调用更上层的hci_recv_frame来处理已经剥去h4包头的数据。
如图:
九、HCI以上的处理
这里的hci_rx_work前面已经看到它了。它是一个工作队列用来处理hci层的数据接收的。先看是否有进程打开hci的socket用来监听数据,假设有的话,就把数据的一个copy发送给它。然后依据包的类型调用不同的处理函数。分别相应于event、acl、sco处理;
hci_event_packet是对于事件的处理。里面包含有包含扫描。信号,授权,pin码,总之基本上上层所能收到的事件,基本都是在这里处理的,它的非常多信息都是先存起来。等待上层的查询然后才告诉上层。
hci_acldata_packet是一个常常的情况,也就是说上层通常都是使用的是l2cap层的接口。而l2cap就是基于这个的,例如以下图所看到的:
到这里假设有基于BTPROTO_L2CAP的socket,那么这个socket就能够收到数据了;再看看BTPROTO_RFCOMM的流程:
十、 数据流程的总结
简单总结一下,数据的流程,
|基本上是:
1, uart口取得蓝牙模块的数据;
2。 uart口通过ldisc传给hci_uart。
3。 hci_uart传给在其上的h4;
4。 h4传给hci层。
5。 hci层传给l2cap层
6, l2cap层,然后通rfcomm。
版权声明:本文博客原创文章,博客,未经同意,不得转载。