2.2. 概述

蓝牙BLE Host测试需要过认证,传统的方式就是人工打开PTS软件,选择需要认证的case,验证通过就行,这样操作简单直接。

但是PTS测试需要设备配置不同的参数,如配置不同的GATT Service,配对模式等。也就是说跑不同的case,需要根据不同的case写不同的Application,如果这个工作只进行一次还好,但是SPEC一直在演进,协议栈也会一直迭代,认证的流程需要进行多次,继续用人工的方式不仅仅容易出错,工作量还特别大。

PTS本身提供了,auto的支持,可以通过其提供的接口来实现自动完成PTS的认证工作。

image-20231201171940961

既然是自动的,肯定有一套协议来控制协议栈来做不同的动作,设备端只要实现这套协议即可,就可以实现Auto-PTS测试功能。但是PTS提供的接口是一个COM库 (Component Object Model)的API接口,这些API接口是完成和PTS软件进行交互的,并不适合直接将这些接口转发到设备端,所以就需要一个转换接口,将这些API转化为设备好处理的协议。

2.3. auto-pts开源项目介绍

直接去看官方的文档,将COM API转成设备好处理协议工作量很大,网上有开源的auto-pts项目(GitHub - auto-pts/auto-pts: The Bluetooth PTS automation framework),里面有BlueZ、Zephyr和Mynewt的实现。

该项目实现了官方COM接口,并提供了BTP(Bluetooth Test Protocol) 协议接口,该接口类似于HCI接口格式,设备可以很好的对这些数据进行处理(相关协议说明在项目的doc目录下,auto-pts/doc at master · auto-pts/auto-pts · GitHub)。

其支持Linux和Windows模式,但是由于PTS只支持Windows模式,如果设备端是Linux环境的话,需要Windows(PTS)+Linux(设备),然后通过RPC接口进行通信。

image-20231201174028653

image-20231201174042242

其交互主要包含Command、Response和Event三种数据报文格式。

image-20231201173255924

每笔包的数据包格式如下说是,Header有5个字节,后面加具体的Payload内容。

image-20231201173451096

目前Auto-Pts项目支持如下的Service ID,从下图可以看出,目前该项目只支持BLE相关的测试例程,如果是双模设备需要过认证,就得自己参考该项目,将官方的COM API转成新的Service ID的BTP格式(自己实现)。

image-20231201173642841

2.4. Zephyr_polling工作

如上述沟通,要实现Auto-PTS功能,设备端只需要实现BTP相关协议即可。然后物理接口再在Auto-PTS设计实现,参考已有的BlueZ、Zephyr和Mynewt的实现来做即可。

Zephyr_polling参考的是Zephyr项目,可以先参考官方的文档AutoPTS on Windows 10 with nRF52 board — Zephyr Project Documentation

Zephyr的Auto-PTS实现在(zephyr/tests/bluetooth/tester/)目录下,支持BTP packets 的收发,用nordic的板子,就可直接用于auto pts 的测试。

Zephyr_polling就是将Zephyr这块代码直接搬过来了。然后通过UART和PC进行BTP交互,Auto-PTS全用github的就行。

相关项目代码已提交:GitHub - bobwenstudy/RTT_PACKAGE_zephyr_polling: 专用于rtthread package的分支,代码在example/tester目录下,目前还有些bug。

2.5. Artpi运行实现

硬件准备

运行Auto-PTS需要2个硬件设备,一个是待测设备(也就是Artpi),一个是PTS Dongle。

PTS Dongle

Bluetooth SIG

image-20231201182529547

ArtPi

另外一个就是Artpi了,官网是:ART-Pi (gitee.io)

image-20231201182643376

auto-pts环境安装

  1. 首先从 https://github.com/auto-pts/auto-pts 安装工程

  2. 安装python依赖

    python -m pip install –user wheel python -m pip install –user -r autoptsserver_requirements.txt python -m pip install –user -r autoptsclient_requirements.txt

socat安装

下载网址:Unix Utils ported to Windows - Browse /socat/1.7.3.2 at SourceForge.net Auto-pts 通过socat 进行PC 与IUT 之间的交互。 进入网站下载并解压指定软件压缩包,并将socat.exe 所在目录路径添加至环境变量。

确保where socat可以找到。

image-20231201182245167

Artpi-Zephyr_polling环境安装

参考该文章,搭建RTT的Artpi环境。zephyr_polling rtthread移植平台说明_zephyr 移植-CSDN博客

目前代码还有问题,通路通了。直接将tester目录下的代码替换到beacon中,然后运行例程,输入zephyr,启动程序。

image-20231201181616405

其中Uart1作为和PC的BTP交互通道。

image-20231201181648362

也就是下图的这两个IO口。

image-20231201181725776

也就是板子的这个位置。

image-20231201181821143

这时通过串口工具,就可以和设备进行BTP交互了。

设备刚上电会上报<00 80 FF 00 00>,注意,这里每次case运行的时候都必须上报。不然auto-pts不会继续运行。

测试发送<00 03 ff 01 00 01>,看设备是否能正常回复<00 03 FF 00 00>,这里通了代表硬件和软件代码ready。

image-20231201181923573

auto-pts运行

启动auto-pts server

将PTS Dongle接入PC,通过sscom确认其串口号。

image-20231201222013533

而后直接在拉取的auto-pts工程下输入,注意调整串口号,这里是COM14。

python autoptsserver.py -S 65000 --dongle COM14

看到如下显示就是ok了。

注意,这里因为要运行PTS,所以必须要有Sig账号,如果没登录过,这里会提示登录。

image-20231201222145343

启动auto-pts client

接着就是要启动IUT设备了,这里直接使用Zephyr的工程,因为其本身就是串口,而且串口交互的就是BTP帧格式,只要串口参数配置对了,直接就可以用Zephyr的工程跑了。

接入Artpi,如下图所示,COM12是Debug口,COM13是引出来和Auto-PTS通信的uart1口。

image-20231201222751846

用RTT的终端接入COM12作为调试口,需要注意,这里暂时别输入zephyr,启动蓝牙。

因为Auto-PTS要求每次运行Case前,需要设备先上报一个Event<00 80 FF 00 00>,该命令是程序一启动就自动上报,且只上报一次。

Zephyr项目通过指定board(-b nrf52)来知道如何该板子是什么,然后通过Jlink下发Reset命令,这里暂时通过手动操作来解决。

image-20231201222913782

而后就运行Auto-PTS的client脚本。命令如下,COM口选13,因为这里只是为了演示需要,所以以简单的DIS相关例程做演示,<-c DIS>指定。

python autoptsclient-zephyr.py zephyr-master -t COM13 -S 65000 -C 65001 -c DIS

启动后会看到server终端有HTTPS的提示。

image-20231201223448905

然后由于没有做硬件reset,所以需要在case启动后,输入zephyr,启动蓝牙,并上报Event<00 80 FF 00 00>。

之后就能看到日志里打印正常进行BTP通信了。

image-20231201223738784

由于目前还有bug,case都未通过,失败日志可以在auto-pts工程路径下看到。

image-20231201223925651

虽然因为时间仓促,case未运行成功,但是整个通道是打通的,之后按照case要求,解决相关bug即可。