Ellisys工具抓取HCI log.docx

1、Ellisys工具抓取HCI logEllisys的使用一、获取设备link key注：为了方便开发查看空中log，可以帮忙输入link key解密，可以避免开发说在hci中获取的link key无法解密而导致需要重新抓取log1、ROOT版手机获取方法测试机连接电脑，双击运行脚本linkkey.bat，打开linkkey.txt查看对应设备的link key2、非ROOT手机获取方法测试机先开启5959，配对连接蓝牙设备，抓取5959log；解压抓取的log，在蓝牙log文件夹下，查看抓取的log，修改hci.log的扩展名（加.cfa）直接双击打开（电脑需安装15.1及以上版本的Front

2、line）,在hci log下输入关键字：hci_link_key_Notification获取设备link key一、连接设备连接设备需要两根线（一根电源线，连接到插座（power）；一根连接到电脑端（computer）三、使用方法1、打开软件点击Record页面显示如下：A：打开软件后会有反应时间,需等待，当initializing unit recoding data方可抓包B：当显示为上图所示时，才能正常抓取A：抓取classic BT device infoB：抓取HOGP/BLE device infoC：带红色的锁和钥匙表示这条link有效且需要输入link key才能查看具体l

3、ogD：显示连接了设备的测试机（security栏位显示的是设备之间的交互信息）注：security栏位的link key一般是missing状态，只有HOGP mouse会有概率直接显示为绿色且link前面的钥匙和锁是呈绿色打开状态，表示不需要输入link key解密；我们常用到的HID/HOGP(四个设备)，都需要link key。2、常见问题：1）无法连接：无法连接的设备只要有进行过配对动作，这个ellisys是能抓到的，需要结合hci log一起看。2）搜索不到设备：建议在干净环境下去抓取这个log，确保在你打开测试机蓝牙后ellisys有图吐log就可以了，其他的交给研发去分析log

4、，搜索设备也是需要结合手机的main log一起看；如下图所示，为软件抓到的手机搜索设备的log3）断开连接：已连接设备A，手动连接设备B，设备B断开重连，这种需要输入两个设备的link key。4）如下图所示，抓取时如果出现多条显示带锁，需要重新断开连接设备。如图所示点击对应设备双击会弹出link key输入框；必须保证B显示为绿色，有时显示不对需要我们手动添加补充；在C处输入获取到的link key，点击OK（输入设备link key后，A显示为绿色的钥匙和锁）3、筛选指定的设备：如下图所示点击窗口工具栏A(Filtering：Exclude Background) 点击Configure

5、，弹出如图所示窗口，双击选择自己需要抓取log的设备（需要选择设备和测试机），点击OK确认，（如果选错，在弹窗的左窗口点击设备，点击上面remove4、修改时间为了使抓取的空中包的显示时间与发生问题的时间点相对应，方便查看问题时间节点，可对抓取的log时间点进行修订，如图所示，点击Time旁边的小图标，选择Display-Absolute time（local）。在抓取log时，由于有些问题难以复现，一直record会使单份log的体积增大，有可能会导致打不开等情况。可以在菜单点击Record选项 recording options capture management，可以修改存储路径，方便

6、寻找；自动保存可以设置勾选其默认的15min，这样会在运行15min后会自动切割保存，如图所示：也可抓取完保存，关闭软件时会弹出窗口提示是否保存，选择是，弹出保存路径，如下图所示，选择自己要保存的路径，点击保存。四、常见问题处理1、有时打开软件后点击record抓取log之后，会出现如图所示提示。原因是Ellisys tool没有正常启动。工具表现为Power灯为粉色闪烁状态解决方法：重新插拔电源或工具与电脑的数据连接线，等工具的Power灯显示为蓝色常亮后再次点击record即可抓取。2、当工具异常关闭后再次打开时会出现以下弹框，表示上次异常关闭的log是否需要保存。一般情况话会选delete all，因为保存后也无法解密3、由于抓取空中log大部分场景是在工位环境下，周围会有许多BT/BLE设备，Ellisys会抓取周围所有设备的信息显示在log上，呈现出来的状态如下图右边显示，设备间会相互的联系，不停的inquiry，这样会影响抓取的log的可解析性，所以在抓取log时尽量靠近Ellisys，以防抓取不全。