Bluez调试工具hcitool与gattool的使用实例

1 篇文章 0 订阅
1 篇文章 0 订阅

转载:https://blog.csdn.net/talkxin/article/details/50610984

作者:PaulYoung_Blog

Bluez协议栈在安装完以后,会提供两个命令行调试工具,hcitool与gattool,我们可以根据提供的工具来轻松的调试我们的蓝牙设备。
当然

需要注意的是,在调试BLE设备时,需要获得root权限。

蓝牙设备的开启与关闭

首先,查看在使用hci工具时,我们需要查看当前能够识别的蓝牙设备,这里我们需要使用的工具是hciconfig命令,该命令如ifconfig一样,可以控制蓝牙设备的开启与关闭,在默认情况下,蓝牙设备在插入host时是不会自动开启的,所以我们在调试之前要先开启设备。

如果我们需要查看蓝牙设备的话:

$ hciconfig
hci0:   Type: BR/EDR  Bus: USB
    BD Address: 00:02:72:14:27:0E  ACL MTU: 1021:8  SCO MTU: 64:1
    DOWN 
    RX bytes:2715 acl:1 sco:0 events:146 errors:0
    TX bytes:2500 acl:0 sco:0 commands:133 errors:0

会输出以上内容,我们可以看到蓝牙设备的编号为hci0,这是host分配给设备的ID,我们用来启动或关闭设备也是需要该ID来控制。

开启与关闭设备:

#设备打开
sudo hciconfig hci0 up
#设备关闭
sudo hciconfig hci0 down

hcitool命令及参数

在打开蓝牙设备以后,就可以使用hcitool工具集对蓝牙进行控制,工具集参数 分为两部分,一为正常的蓝牙设备调试,二为低功耗即BLE设备, 工具参数如下:

$  hcitool                                                      
hcitool - HCI Tool ver 4.93
Usage:
        hcitool [options] <command> [command parameters]
Options:
        --help  Display help
        -i dev  HCI device
Commands:
        dev     Display local devices
        inq     Inquire remote devices
        scan    Scan for remote devices
        name    Get name from remote device 
        info    Get information from remote device
        spinq   Start periodic inquiry
        epinq   Exit periodic inquiry
        cmd     Submit arbitrary HCI commands
        con     Display active connections
        cc      Create connection to remote device
        dc      Disconnect from remote device
        sr      Switch master/slave role
        cpt     Change connection packet type
        rssi    Display connection RSSI
        lq      Display link quality
        tpl     Display transmit power level
        afh     Display AFH channel map
        lp      Set/display link policy settings
        lst     Set/display link supervision timeout
        auth    Request authentication
        enc     Set connection encryption
        key     Change connection link key
        clkoff  Read clock offset
        clock   Read local or remote clock
        lescan  Start LE scan
        lewladd Add device to LE White List
        lewlrm  Remove device from LE White List
        lewlsz  Read size of LE White List
        lewlclr Clear LE White list
        lecc    Create a LE Connection
        ledc    Disconnect a LE Connection
        lecup   LE Connection Update

For more information on the usage of each command use:
        hcitool <command> --help

官方资料 参考资料

命令说明调用方式
参数  
–help进入帮助hcitool –help
-i在host插有多个蓝牙适配器的情况下,可以通过该参数来指定某控制某一适配器hcitool -i [dbaddr] [command]
命令下面的命令是普通蓝牙设备,不需要sudo 
dev同hciconfig一样,显示当前适配器设备,输出格式为[hciid MAC]hcitool dev
inq查询可发现的远程设备,与scan不同的是,除了能查询出MAC以外,还可以查出远程设备的时钟偏移值“clock offset”与设备类型“class”,scan是不会输出相关设备的类型,这可以让我们区分设备是蓝牙耳机,或蓝牙鼠标hcitool inq
  hcitool inq [–length=N]设置最大查询时间
  hcitool inq [–numrsp=N]设置最大查询数量
  hcitool inq [–iac=lap]指定查询的lac码
  hcitool inq [–flush]清除缓存
scan查询可发现的远程设备,与inq不同的是,除了能查询出MAC以外,还可以输出设备的名字【名字写在标准的module中,若查询不到该key对应的values则会输出N/A】,可以通过设置参数来获取设备的类型,信息等hcitool scan
  hcitool scan[–length=N]设置最大查询时间
  hcitool scan[–numrsp=N]设置最大查询数量
  hcitool scan[–iac=lap]指定查询的lac码
  hcitool scan[–class]查询设备类型
  hcitool scan[–info]查询设备信息
  hcitool scan[–oui]查询设备唯一标识
  hcitool scan[–flush]清除缓存
name通过指定MAC地址来获取设备的名称,该命令可以补全inq查询时无法输出设备名称的问题.hcitool name [dbaddr]
info通过指定MAC地址来获取设备的相关信息。hcitool info [dbaddr]
spinq开启定期查询,使设备被发现,没有则无输出hcitool spinq
epinq关闭定期查询,没有则无输出hcitool epinq
cmd向远程设备发送命令hcitool cmd < ogf > < ocf > [parameters]
con显示当前连接信息hcitool con
cc连接设备,可以设置数据类型,与主从关系hcitool cc < bdaddr >
  hcitool cc [–ptype=pkt_types] < bdaddr > 可以设置接收数据的类型,数据类型包括[DM1, DM3, DM5,DH1,DH3,DH5, HV1, HV2, HV3],可以设置多个类型,类型中间以逗号分隔,默认接收所有类型数据
  hcitool cc [–role=m/s] < bdaddr >可以设置设备的主从关系,M为master,S为slave,默认为s
 Example:hcitool cc –ptype=dm1,dh3,dh5 01:02:03:04:05:06
  cc –role=m 01:02:03:04:05:06
dc断开远程设备连接hcitool dc < bdaddr > [reason]
sr设置设备的主从关系hcitool sr < bdaddr > < role >
cpt设置远程设备数据类型hcitool cpt < bdaddr > < packet_types >可以设置接收数据的类型,数据类型包括[DM1, DM3, DM5,DH1,DH3,DH5, HV1, HV2, HV3],可以设置多个类型,类型中间以逗号分隔
rssi显示设备的信号强度hcitool rssi < bdaddr>
lq显示设备的链路质量hcitool lq < bdaddr>
tpl显示设备的发射功率级别hcitool tpl < bdaddr> [type]
afh显示设备的AFH(适应性跳频)的信道地图hcitool afh < bdaddr>
lp设置或显示设备的链路hcitool lp < bdaddr> [link policy]
lst设置或显示连接超时时间,默认情况下连接超时断开连接为20s可以设置超时时间来缩短超时断开连接的时间hcitool lst < bdaddr> [new value in slots]
auth请求设备配对认证hcitool auth < bdaddr>
enc设置连接加密,同样可以关闭连接加密hcitool enc < bdaddr> [encrypt enable]
key更新与远程设备的link keyhcitool key < bdaddr>
clkoff读取远程设备的时钟偏移量,不过这个变量不太靠谱hcitool clkoff < bdaddr>
clock读取本地时钟或远程设备的时钟hcitool clock [bdaddr] [which clock]
BLE设备命令以下命令需要root权限才能执行 
lescan搜索BLE设备hcitool lescan
  hcitool lescan[–privacy]启用隐私搜索
  hcitool lescan [–passive]默认参数,设置被动扫描
  hcitool lescan [–discovery=g/l] 设置搜索条件为综合设备或限制设备
  hcitool lescan [–duplicates]过滤重复的设备
lewladd将设备加入BLE白名单hcitool lewladd [–random] < bdaddr>可声明该设备的MAC地址为随机地址,有的BLE设备可以被设置为随机MAC地址以增加私密性,为以后也能连接到该MAC地址,需要声明MAC地址是随机,这样才能用旧的MAC地址连接到设备
lewlrm将设备移除BLE白名单hcitool lewlrm < bdaddr>
lewlsz输出白名单设备列表hcitool lewlsz
lewlclr清空白名单列表hcitool lewlclr
lecc连接BLE设备hcitool lecc < bdaddr>
  hcitool lecc [–random] < bdaddr>随机MAC地址连接
  hcitool lecc –whitelist 连接所有白名单设备
ledc断开BLE设备的连接。在通过lecc链接后,hci工具会随机分配给该设备一个handle名,断开连接时需要使用该handle,因为在蓝牙4.0以后,一个蓝牙适配器可以连接7个BLE设备hcitool ledc < handle> [reason]
lecup更新BLE设备的连接及状态hcitool lecup [Options]
 Options: 
  -H, –handle < 0xXXXX>指定更新状态的BLE设备Handle,在通过lecc链接后,hci工具会随机分配给该设备一个handle名
  -m, –min < interval> 设置设备蓝牙的休眠时间与–max联合使用,设置的区间为: 0x0006~0x0C80
  -M, –max < interval> 设置实例【hcitool lecup –handle 71 –min 6 –max 100】
  -l, –latency < range> 设置BLE数据传输速率,区间为: 0x0000~0x03E8
  -t, –timeout < time> N * 10ms 设置设备超时等待时间,区间为 0x000A~0x0C80
 备注:min/max参数区间为7.5ms到4s,误差在1.25ms,timeout的区间为100ms到32s

gattool命令及其参数

使用hcitool是为了对设备的连接进行管理,那么对BLE数据进行精细化管理的话,就需要用到gattool,使用gattool对蓝牙设备发送指令的操作上要比hcitool的cmd齐全很多,关于gattool的使用分为两种,一种直接使用参数对蓝牙设备进行控制,二就是使用-I参数进入gattool的interactive模式对蓝牙设备进行控制。

首先,看一下gattool的参数:

# gattool -h

Usage:
  gatttool [OPTION...]

Help Options:
  -h, --help                                Show help options
  --help-all                                Show all help options
  --help-gatt                               Show all GATT commands
  --help-params                             Show all Primary Services/Characteristics arguments
  --help-char-read-write                    Show all Characteristics Value/Descriptor Read/Write arguments


Application Options:
  -i, --adapter=hciX                        Specify local adapter interface
  -b, --device=MAC                          Specify remote Bluetooth address
  -t, --addr-type=[public | random]         Set LE address type. Default: public
  -m, --mtu=MTU                             Specify the MTU size
  -p, --psm=PSM                             Specify the PSM for GATT/ATT over BR/EDR
  -l, --sec-level=[low | medium | high]     Set security level. Default: low
  -I, --interactive                         Use interactive mode

具体含义如下:

参数说明调用方式
-i指定适配器gatttool -i < hciX> -b < MAC Address>
-b指定远程设备,在连接多个设备的情况下需要指定控制某一设备gatttool -b < bdaddr>
-t指定设备的类型,是开放设备还是私密设备gatttool -b < MAC Address> -t [public/random]
-m设置数据包长度-m MTU
–sec-leve设置数据发送级别,默认情况下是low,需要高频发射数据的情况下需要将级别设置为high,但相应的耗电会上升gatttool -b < MAC Address> -l [low/medium/high]
-I进入interactive模式gatttool -b < MAC Address> -I
 以下参数可以直接在interactive模式下使用,也可以在命令行直接使用 
–primary寻找BLE中可用的服务gatttool -b < MAC Address> –primary
–characteristics查看设备服务的特性,其中handle是特性的句柄,char properties是特性的属性值,char value handle是特性值的句柄,uuid是特性的标识。gatttool -b < MAC Address> –characteristics
–char-desc配合查看服务特性使用,可以查看该设备所有服务特性的值,该值类型为键值对gatttool –b < MAC Address> –char-desc [–uuid 0x000]可以通过设置UUID来查看某一特性的值
–char-write更新特性的值,该更新类似于键值对,一个uuid匹配一个valuegatttool -b –char-write –uuid [0x000] –value [0]
–char-write-req读取notifications里的内容,可以设置listen来开启监听否则每次只读一次,监听读取notifications时需要向该handle写入一个1,在命令行中16进制的表示为0100,若向该handle写入0200的话则改为读取indications的内容gatttool -b < MAC Address> –char-write-req –handle=0xXXXX –value=0100 –listen
 完整示例:gatttool -i hci0 -b aa:bb:cc:dd -t random –char-write-req -a 0x0039 -n 0100 –listen

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值