mini_program_gizwits_sdk 3.7.7-kuka → 3.7.8-kuka

package/README.md

@@ -329,3 +329,84 @@ const errorCode: IErrorCode = {
   },
 };
 ```
+
+### 探趣 BLE 配网
+
+SDK 将 `name` / `localName` 以“探趣”开头的设备映射到
+`188c3f02286f472b898f9fadc8058372`，仍需在 `productInfo` 中配置该产品。
+广播不含 MAC，扫描阶段以 `bleDeviceID` 区分设备，不生成虚假 MAC。
+
+```ts
+// 先初始化蓝牙并扫描，从设备列表选择探趣设备。
+const deviceId = device.bleDeviceID;
+// 选择设备时不用连接，输入 Wi-Fi 后直接调用统一配网接口。
+const result = await sdk.setDeviceOnboardingDeploy({
+  mode: 11,
+  bleDeviceID: deviceId,
+  ssid: '家庭WiFi',
+  password: 'your-password', // 开放网络可传空字符串
+  timeout: 60,
+  isBind: false,
+  softAPSSIDPrefix: '',
+});
+// result.success 表示设备报告网络配置成功，不代表云端注册或绑定完成。
+// SDK 自动连接、进入配网、发送凭据、查询状态，并在结束后清理连接。
+```
+
+直接调用 mode 11 即可完成配网。SDK 缓存已发现设备的身份，实时扫描列表过期不会阻止已选设备连接。
+`prepareTqOnboarding()` 仍可选用来读取设备 Wi-Fi 列表，但不再是 demo 的前置步骤。
+取消使用 `stopDeviceOnboardingDeploy()`，会中断请求并断开当前配网连接。
+SDK 销毁会清理探趣连接、通知监听和未完成请求。
+
+探趣设备也可通过统一接口查询信息，无需先绑定或进入配网模式：
+
+```ts
+const result = await sdk.getDeviceInfo({ device });
+if (result.success) {
+  console.log(result.data.deviceID, result.data.deviceHardVersion, result.data.deviceSoftVersion);
+}
+```
+
+SDK 使用 L2 `ver=1, fun=0x01, cmd=0x01`，请求数据为空。发送失败、响应超时或
+响应长度不为 29 字节时，改用 `ver=2` 重试；成功后使用回复中的 `ver` 作为当前
+会话后续命令的协议版本。独立查询结束会断开连接；已有配网会话会保持连接。
+
+|返回字段|协议来源|格式|
+|---|---|---|
+|`deviceTypeID`|Byte[0–3]|8 位十六进制字符串，保留字节顺序|
+|`deviceID`|Byte[4–20]|UTF-8 文本，去掉末尾 NUL；无法解码时保留十六进制原值|
+|`deviceHardVersion`|Byte[21–24]|8 位十六进制字符串，保留字节顺序|
+|`deviceSoftVersion`|Byte[25–28]|8 位十六进制字符串，保留字节顺序|
+|`protocolVersion`|L2 回复的 `ver`|数字|
+
+协议未说明版本编码，暂保留原始十六进制值。没有分别提供模组、MCU 和业务版本，
+因此 `moduleHardVersion`、`moduleSoftVersion`、`mcuHardVersion`、`mcuSoftVersion`
+和 `businessVersion` 均为空字符串。
+
+仅探趣设备支持设置设备 ID，接口参数中的 `deviceId` 是要写入设备的新 ID，
+蓝牙连接仍使用 `device.bleDeviceID`：
+
+```ts
+const result = await sdk.setDeviceId({ device, deviceId: 'TQ123456789012345' });
+// result.success 为 true 表示设备返回 status code 0。
+// 有效的设备回复会在 result.data.statusCode 中保留原始单字节状态码。
+```
+
+ID 必须是字符串，UTF-8 编码后恰好 17 字节；长度不符不会连接或发送命令，
+不会自动截断、补零或去除空格。中文等多字节字符按编码字节数计算。
+SDK 先通过查询设备信息确定当前会话的协议版本，再发送 `fun=0x01, cmd=0x10`。
+回复必须为 1 字节，状态码非 0 返回失败。独立调用结束清理连接，已有配网会话保持连接。
+
+服务 `18FF`，写入 `2B02`，通知 `2B01`。L0 每包最多 20 字节，CRC8
+多项式 `0x07`、初始值 `0`，校验 Data；L2 长度为大端。每包匹配序号
+等待 ACK，超时 2 秒，最多发送 3 次。该实现依据 tq_ble_tools，未添加加密。
+收到开始配网确认后等待 2 秒，每秒查询状态，最多 20 次，外层 timeout
+限制整个配网过程。云端绑定及其他设备控制功能不在此接口支持范围内。
+
+协议及模拟设备测试（需要安装 TypeScript）：
+
+```sh
+node tests/tq-protocol.cjs
+node tests/tq-session.cjs
+node tests/tq-device-info.cjs
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import 'miniprogram-api-typings';
+import gizwitsSdk from './src/sdk';
+import errorCode from './src/utils/errorCode';
+import { BleHandle } from './src/handler/ble';
+export { errorCode, BleHandle };
+export default gizwitsSdk;
+export * from './src/types';