1. 功能流程

1.1. 语音唤醒交互流程

avater

用户通过关键词“alexa”唤醒alexa之后, YodaOS AVS方案中的前端模块会检测关键词事件,将关键词事件以及关键词在音频数据中的位置发送给AVS云端。

1.2. 按键唤醒交互流程

avater

用户通过按开发板上的power键, 唤醒alexa, 由alexa云端自己判断VAD。

1.3. 音量大小调节流程

avater

1.4. 语音交互流程

语音交互流程包含在按键唤醒和语音唤醒流程中,参考 3.1和3.2

1.5. 麦克风操作流程

avater

YODAOS的的语音采集以及唤醒被turen模块接管,因此只需要turen模块进行操作就可以实现麦克风的关闭和打开。同时把相关的灯效和声音提示添加上去。

1.6. 通知流程

暂无

1.7. 报警流程

暂无

1.8. 蓝牙配网流程

avater

蓝牙配网协议:

Bind



1.9. Alexa 授权流程

avater

Rokid的APP通过蓝牙和手机通讯, 手机获取metadata以及发送授权信息给设备,都是通过蓝牙。

下面是蓝牙通讯的协议。

1.9.1. 获取MetaData

Request

{
    topic: "AlexaMetaData",
}

Response

{
    topic:"AlexaMetaData",
    data:{
       "PID":"",
       "DSN":"",
       "Code":"",       
    }
}

PID: 是在亚马逊注册的产品ID号,我们注册的是"RokidAlexa",DSN:是设备序列号, Code:是挑战码,按照Alexa的官方要求生成的挑战码。亚马逊官方说明

1.9.2. 发送认证信息

{
    topic:"Auth",
    data:{
    "ACode":"",
    "ClientID":"",
    "RedirectURI":""
   }
}

相关字段参见亚马逊官方说明

1.10. AVS OTA升级

1.10.1. 概述

OTA升级是当设备在联网状态下,自动检测是否有最新版本镜像,有最新镜像则自动下载升级到最新版本,没有则定时检测版本。OTA升级可以让用户体验最新的功能.

OTA升级必备条件

  • 完整OTA流程需要在镜像服务器添加正确的版本和镜像。
  • 设备必须可以连接网络。
  • 设备空间比镜像包大,可以下载升级镜像包。

OTA升级流程

  • 检测OTA镜像版本之前,需要查看当前网络状态。可以上网,则可以进行OTA镜像版本检测。
  • 登录帐号服务器获取key和secret信息,用于检测时的设备认证。
  • OTA镜像版本检测,若有镜像,则把正确的镜像下载到设备/data/upgrade目录,文件名是镜像的md5值(小写32位),并使用.img后缀,用于确认下载的镜像是否正确,若没有最新镜像信息,则定期检测,当前设置是半个小时检测一次。
  • 设置recovery接口,把升级镜像的路径设置进去,设置设备⾃动重启,进⼊升级状态,此时⽤户⽆法使⽤设备。
  • 升级完成后,设备⾃动重启,开机并联⽹。

如下是OTA流程图:

avater

OTA镜像版本检测接口 httpsPOST方法访问https://apigwrest-dev.open.rokid.com网址。

接口URL: https://apigwrest-dev.open.rokid.com/v1/extended/ota/check

在OTA镜像检测之前需要从开发者平台获取获取key和secret信息,用于后面的设备认证。

设备认证: 设备向https://apigwrest-dev.open.rokid.com发起OTA镜像版本检测请求时,需要在HTTP请求头部中增加字段Authorization。Authorization字段内容如下所示:

version={version};time={time};sign={sign};key={key};device_type_id={device_type_id};device_id={device_id};service={service}

Authorization中的sign字段是签名串,是对下列组合的字符串(UTF-8编码)做MD5计算:

key={key}&device_type_id={device_type_id}&device_id={device_id}&service={service}&version={version}&time={time}&secret={secret}

字段说明

字段名称 意义
version 版本,当前为1.0
time UNIX时间
sign 签名串,具体⽣成⽅式如上所示
key 授权KEY,从开发者平台获取
device_type_id 设备类型ID,同样从开发者平台获取
device_id 设备ID,客户端⾃⼰维护
service 服务类型,⾃定义,建议与请求的服务名保持⼀致
secret 密钥,从开发者平台获取

HTTP请求头部中还需要字段Content-Type,字段信息如下:

Content-Type: application/json;charset=utf-8

HTTP请求体由json串组成,内容如下所示:

  {"version":"XXXXX"}

请求体中version字段是必须字段,其他字段可以根据需要添加。

响应返回结果:

{
 /**镜像地址**/
 "imageUrl": "http://xxxx.img",        //必须

 /**是否成功**/
 "authorize": true,    //必须

 /**错误信息**/
 "errorMessage": "",

 /**错误码**/
 "code": "OK",

 /**变更说明**/
 "changelog": "",

 /**镜像md5**/
 "checksum": "xxxx",    //必须

 /**是否强制升级**/
 "isForceUpdate": true,

 /**镜像版本**/
 "vertion": "3.0.0-xxxx-xxx"    //必须

}

对于设备的OTA镜像升级,如果需要自己实现,可以参考如上信息。

results matching ""

    No results matching ""