HarmonyOS NEXT-杰理SDK对接流程 原创

let authListener: JL_Auth.AuthListener = {
  onSendData: (devId: string, data: ArrayBuffer) => {
    // 发送认证数据
    if (writeTrait_JieLi) {
      bleSendClass.BLESEND_autoPushSend({serviceData:new Uint8Array(data),serviceType:writeTrait_JieLi})
    }
  },
  onAuthSuccess: () => {
    console.log("认证成功");
  },
  onAuthFailed: () => {
    console.log("认证失败");
  },
}

// 开始认证
let JLAuth = new JL_Auth.Auth();
JLAuth.startAuth(deviceId, authListener)
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

// ⭐1. 首先我们需要先创建好 RCSP协议对象
let BLEPROPERTY_rcspImpl: JL_RCSP.RcspImpl = new JL_RCSP.RcspImpl();


// ⭐⭐⭐ 然后给 RCSP协议对象 添加Rcsp事件回调 和 设置RCSP数据发送回调
// 2. 添加 RCSP事件回调
// 2-1 创建回调函数
let  oRcspCallback: JL_RCSP.OnRcspCallback = {
  //Rcsp协议初始化回调
  onRcspInit: async (device, isInit) => {
      // ⭐ isInit true 代表初始化成功
      // ⭐ isInit false 代表初始化失败
     console.log('Rcsp协议已经初始化，结果为：', isInit)
  },
  //RCSP错误事件回调
  onRcspError: (_device, _error, message) => {
    console.log('RCSP错误事件回调', message)
  },
  //需要强制升级回调
  onMandatoryUpgrade: () => { 
    console.log('需要强制升级回调')
  },
  //设备连接状态
  onConnectStateChange: () => { 
    console.log('设备连接状态')
  },
  //设备主动发送的rcsp命令回调
  onRcspCommand: () => {
  },
  //设备回复的rcsp命令回调
  onRcspResponse: () => {
  },
  //设备主动发送的数据命令回调
  onRcspDataCmd: () => {
  },
}
// 2-2 添加事件回调
BLEPROPERTY_rcspImpl.addOnRcspCallback(oRcspCallback)



// 3. 设置RCSP数据发送回调
// 3-1 创建发送数据的回调函数
let onSendDataCallback: JL_RCSP.OnSendDataCallback = {
  //向设备发送RCSP数据包
  sendDataToDevice: (device, data) => {
    // 把收到的消息依旧放入消息队列
    bleSendClass.BLESEND_autoPushSend({serviceData:data ,serviceType:writeTrait_JieLi})
    return true
  }
}
// 3-2 设置RCSP数据发送回调
BLEPROPERTY_rcspImpl.setOnSendDataCallback(this.onSendDataCallback)



// 4 连接状态传递 -- 这两步骤必须做
// 4-1 通知设备状态
BLEPROPERTY_rcspImpl.transmitDeviceState(new JL_RCSP.BtDevice(deviceId), JL_RCSP.ConnectState.CONNECTED)
// 4-2 初始化RCSP操作封装对象
const operateWrapper = new JL_RCSPOP.RcspOperateWrapper(rcspImpl);

// 注意点：⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
// 1、2、3 这个步骤在认证之前做也可以。不用非的等到认证成功再去创建。
// 4-2 可以在 步骤三 中的 onAuthSuccess 回调中做
// 4-1 需要在 'BLECharacteristicChange' 监听蓝牙状态中调用，通知杰理SDK当前设备的状态
//     并且，new JL_RCSP.BtDevice(deviceId) 这个需要保存下来让更新状态的时候为 同一个设备。

// 所以当设备认证成功后，执行 4-2 , 然后实时的还要更新当前设备的状态

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.

//step:获取系统flash信息(必须)
  const flashInfo =
    await operateWrapper.getOperateByClass(JL_RCSPOP.OPWatch.OperateWatch.prototype)?.getFlashInfo()

//step:获取在线的SDCardBean信息(在线的存储设备)(必须)
  const lineSdCardBeans =
    await operateWrapper.getOperateByClass(JL_RCSPOP.OPFile.OperateFile.prototype)?.getOnLineSdCardBeansAsync()

//step:读取表盘列表(必须)
  const diallist =
    await operateWrapper.getOperateByClass(JL_RCSPOP.OPWatchDial.OperateWatchDial.prototype)?.getWatchResourseFileList()

//step:获取手表配置信息(必须)
  const configureInfo =
    await operateWrapper.getOperateByClass(JL_RCSPOP.OPDevice.OperateDevice.prototype)?.getDeviceConfigureInfo()

//step:读取手表是否在运动模式(必须)
  const sportStatus =
    await operateWrapper.getOperateByClass(JL_RCSPOP.OPSport.OperateSport.prototype)?.getSportsStatus(true)

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.

// updateFilePath 是资源文件的路径
let file = fileIo.openSync(updateFilePath, fileIo.OpenMode.READ_WRITE);
// 获取文件的 文件描述符fd
let fileFD = file.fd;

// ⭐⭐⭐ 注意：现在获取完了不要关闭文件！！！！
1.
2.
3.
4.
5.
6.

const OTAManager = new JL_OTA.RcspOTAManager(rcspImpl);
1.

// 1. 创建 配置信息
let otaConfig: JL_OTA.OtaConfig = new JL_OTA.OtaConfig();
otaConfig.isSupportNewRebootWay = true;


// 2. 创建 回调对象
let upgradeCallback: JL_OTA.OnUpgradeCallback = {
  onStartOTA: () => {
    console.log('OTA开始')
  },
  onReadData: (offset: number, size: number): Uint8Array => {
    console.log('OTA读取升级数据并返回')
  },
  onNeedReconnect: (reConnectMsg: JL_OTA.ReconnectInfo) => {
    console.log('OTA需要回连进行升级重启')
  },
  onProgress: (type: JL_OTA.UpgradeType, progress: number) => {
    console.log('OTA当前升级进度')
  },
  onStopOTA: () => {
    console.log('OTA升级结束')
  },
  onCancelOTA: () => {
    console.log('OTA取消升级')
  },
  onError: (error: number, message: string) => {
    console.log('OTA升级出现错误')
  },
};


// 通过 startOTA 方法开始升级
OTAManager.startOTA(otaConfig, upgradeCallback);

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.

// ⭐⭐⭐ 1. onReadData 读取升级资源文件进度并返回给 SDK
onReadData: (offset: number, size: number): Uint8Array => {
    const buffer = new Uint8Array(size)
    const result = fileIo.readSync(fileFD, buffer.buffer, { offset: offset, length: size })
    if (result == size) {
      return buffer
    } else {
      return new Uint8Array();
    }
}
// ⭐⭐⭐ 2. onNeedReconnect  设备回连
onNeedReconnect: (reConnectMsg: JL_OTA.ReconnectInfo) => {
  // 回连设备的 MAC 地址 
  const oldDeviceMac = reConnectMsg.deviceBleMac?.toUpperCase().replace(/:/g, "");
  
  // 断开已经连接的设备然后重置所有数据
  // 1. 断开连接设备
  // 2. 重置所有数据(包括设备信息、蓝牙gattClient、和所有 杰理相关的所有数据)
  // ⭐ 3. 但是需要保留一个数据就是刚刚为了升级创建的 OTAManager ， 因为这个等下回连还需要用到
  
  // 断开连接重置所有数据之后，重新进行蓝牙扫描
  // 把扫描到的数据执行 设备回连函数
},
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

// 重连函数
reconnect(scanResult: ble.ScanResult) {
  let result = false;
  // 判断刚刚获取的 回连设备的mac地址
  if (oldDeviceMac) {
    const advertisStr = (JL_OTA.toHexString(scanResult.data) as string).toUpperCase();
    const index = advertisStr.indexOf("D60541544F4C4A");
    if (index != -1 && scanResult.data) {
      const unit8Array = new Uint8Array(scanResult.data);
      const macArray = unit8Array.slice((index / 2) + 8, (index / 2) + 14).reverse();
      result = this.oldDeviceMac == JL_OTA.toHexString(macArray).toUpperCase();
    }
  }
  // 判断当前扫描到的设备是需要回连的设备
  if (result) {
     // 当找到了需要回连设备时候，重新完整走一下蓝牙的流程。
     // 因为已经找到需要回连的设备了，直接走 第3步 开始连接。
     // 这个第3步就是完整蓝牙流程中的第3步，可点击上方连接查看
     // 而且杰理的 RCSP 协议一些数据也需要重新释放然后创建
  }
  // return result;
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.

// 通过 OTAManager.updateRcspImpl 来更新，刚刚新创建的 RCSP协议 对象
OTAManager.updateRcspImpl(BLEPROPERTY_rcspImpl);
1.
2.