#星光不负 码向未来# HarmonyOS开发实战：串行通信全流程解析 原创

// 导入串行通信所需模块：socket模块用于通信，AsyncCallback/BusinessError用于异步回调与错误处理
import { socket } from '@kit.ConnectivityKit';
import { AsyncCallback, BusinessError } from '@kit.BasicServicesKit';

// 1. 创建服务端监听Socket，生成唯一serverId（用于标识服务端）
let serverNumber = -1; // 初始化serverId为-1，标识未创建成功
// 配置SPP参数：uuid为标准串口协议UUID，secure表示是否加密，type为连接类型（0为默认）
let sppOption: socket.SppOptions = {
  uuid: '00001101-0000-1000-8000-00805f9b34fb', // 通用SPP协议UUID，多数蓝牙外设支持
  secure: true, // 开启加密传输，保障数据安全
  type: 0 // 连接类型：0为RFCOMM类型（经典蓝牙常用）
};
// 调用sppListen创建服务端，异步回调返回结果
socket.sppListen('server1', sppOption, (code, serverSocketID) => {
  if (code != null) {
    // 若code不为null，说明创建失败（如权限不足、蓝牙未开启），可在此处添加错误处理逻辑
    console.error('创建服务端socket失败，错误码：', code);
    return;
  } else {
    // 创建成功，将返回的serverSocketID赋值给serverNumber，用于后续操作
    serverNumber = serverSocketID;
    console.log('服务端socket创建成功，serverId：', serverNumber);
  }
});

// 2. 服务端等待客户端连接，连接成功后返回clientId（用于标识客户端）
let clientNumber = -1; // 初始化clientId为-1，标识未连接成功
// 调用sppAccept等待连接，传入serverNumber指定服务端
socket.sppAccept(serverNumber, (code, clientSocketID) => {
  if (code != null) {
    // 连接失败（如客户端超时、设备离线），添加错误处理逻辑
    console.error('客户端连接失败，错误码：', code);
    return;
  } else {
    // 连接成功，将返回的clientSocketID赋值给clientNumber
    clientNumber = clientSocketID;
    console.log('客户端连接成功，clientId：', clientNumber);
  }
});

// 3. 服务端向客户端写入数据（示例：写入"A""B""C""D"四个字符）
// 创建Uint8Array数组存储数据（串行通信常用二进制格式传输）
let array = new Uint8Array(990); // 初始化数组长度为990，可根据实际数据长度调整
array[0] = 'A'.charCodeAt(0); // 将字符"A"转为ASCII码，存入数组第0位
array[1] = 'B'.charCodeAt(0); // 字符"B"存入第1位
array[2] = 'C'.charCodeAt(0); // 字符"C"存入第2位
array[3] = 'D'.charCodeAt(0); // 字符"D"存入第3位
// 调用sppWrite写入数据，传入clientNumber指定客户端，array.buffer为二进制数据
socket.sppWrite(clientNumber, array.buffer);
console.log('数据已向客户端发送');

// 4. （可选）服务端订阅读请求事件，实时接收客户端写入的数据
socket.on('sppRead', clientNumber, (dataBuffer: ArrayBuffer) => {
  // 将接收到的ArrayBuffer转为Uint8Array，便于解析
  const data = new Uint8Array(dataBuffer);
  if (data != null && data.length > 0) {
    // 数据非空，可在此处解析数据（如转为字符串、解析指令）
    console.log('接收到客户端数据：', data);
  } else {
    // 数据为空，添加异常处理逻辑
    console.warn('接收到客户端空数据');
  }
});

// 5. （可选）取消订阅读请求事件（如通信结束、不需要再接收数据时）
socket.off('sppRead', clientNumber, (dataBuffer: ArrayBuffer) => {
  const data = new Uint8Array(dataBuffer);
  if (data != null) {
    console.log('已取消订阅，最后接收的客户端数据：', data);
  } else {
    console.log('已取消订阅，无未处理数据');
  }
});

// 6. 通信结束后，注销服务端socket，释放资源
socket.sppCloseServerSocket(serverNumber);
console.log('服务端socket已注销，serverId：', serverNumber);

// 7. 通信结束后，注销客户端socket，释放资源
socket.sppCloseClientSocket(clientNumber);
console.log('客户端socket已注销，clientId：', clientNumber);

// 导入串行通信所需模块
import { socket } from '@kit.ConnectivityKit';
import { AsyncCallback, BusinessError } from '@kit.BasicServicesKit';

// 1. 开启BLE扫描，获取对端设备的MAC地址（deviceId）
// 注：实际开发中，需通过蓝牙扫描API获取周边设备列表，此处直接模拟目标设备的MAC地址
let deviceId = 'xx:xx:xx:xx:xx:xx'; // 替换为实际扫描到的对端设备MAC地址（格式：XX:XX:XX:XX:XX:XX）
console.log('目标对端设备MAC地址：', deviceId);

// 2. 通过socket连接对端设备，建立串行通信链路
// 传入deviceId（目标设备MAC）与SPP配置参数，异步回调返回连接结果
socket.sppConnect(deviceId, {
  uuid: '00001101-0000-1000-8000-00805f9b34fb', // 通用SPP协议UUID，需与对端设备一致
  secure: true, // 开启加密传输，保障数据安全
  type: 0 // 连接类型：0为RFCOMM类型
}, (code, socketID) => {
  if (code != null) {
    // 连接失败（如设备离线、UUID不匹配、权限不足），添加错误处理逻辑
    console.error('连接对端设备失败，错误码：', code);
    return;
  } else {
    // 连接成功，返回的socketID用于后续数据收发操作
    console.log('连接对端设备成功，socketID：', socketID);
    // 连接成功后，可在此处添加数据收发逻辑（如发送指令、接收响应）
  }
});