103 lines
3.5 KiB
JavaScript
103 lines
3.5 KiB
JavaScript
import { writeA7Payload } from '../core/packet'
|
||
import { waitForProtocolState } from '../core/stateWait'
|
||
|
||
const WIFI_FINAL_STATE_CODES = Object.freeze([1, 2, 3])
|
||
|
||
/**
|
||
* 校验 WiFi 入参，规则来源于 profile.wifi。
|
||
*/
|
||
function validateWifi(profile, ssid, password) {
|
||
const errors = []
|
||
|
||
if (!ssid || ssid.length > profile.wifi.maxSsidLength) {
|
||
errors.push(`SSID 长度需在 1-${profile.wifi.maxSsidLength} 之间`)
|
||
}
|
||
|
||
if (password.length < profile.wifi.minPasswordLength || password.length > profile.wifi.maxPasswordLength) {
|
||
errors.push(`密码长度需在 ${profile.wifi.minPasswordLength}-${profile.wifi.maxPasswordLength} 之间`)
|
||
}
|
||
|
||
const invalidChars = profile.wifi.invalidChars || []
|
||
if (invalidChars.some((char) => ssid.includes(char))) {
|
||
errors.push(`SSID 不能包含特殊字符: ${invalidChars.join(' ')}`)
|
||
}
|
||
|
||
if (errors.length) {
|
||
throw new Error(errors.join('；'))
|
||
}
|
||
}
|
||
|
||
/** 校验鉴权状态，未完成密钥匹配则抛出异常。 */
|
||
function requireAuthorized(ble) {
|
||
const state = ble.getState()
|
||
|
||
if (!state.auth || state.auth.keyMatched !== true) {
|
||
throw new Error('请先完成密钥鉴权，再发送 WiFi 配置')
|
||
}
|
||
}
|
||
|
||
/**
|
||
* WiFi 配网模块：负责打包发送 ssid|password，并等待 STATE 回执。
|
||
* 使用前必须先完成密钥鉴权。
|
||
* @param {object} ble createBleCore 实例
|
||
*/
|
||
export function createWifiModule(ble) {
|
||
function delay(ms) {
|
||
return new Promise((resolve) => setTimeout(resolve, Number(ms) || 0))
|
||
}
|
||
const log = (...args) => { try { console.debug('[BLE][WiFi]', ...args) } catch (e) {} }
|
||
|
||
/**
|
||
* 发送WiFi配网指令。
|
||
* 将 ssid|password 按 A7 分包写入 UUID_WIFI，等待 STATE 回执判定结果。
|
||
* @param {string} ssid WiFi名称
|
||
* @param {string} password WiFi密码
|
||
* @param {object} options
|
||
* @param {number} options.timeout 等待状态回执超时(ms)，默认12000
|
||
* @param {number} options.preDelayMs 写入前延迟(ms)，ED713 默认120ms
|
||
* @param {number} options.packetInterval 分包写入间隔(ms)
|
||
* @returns {{ success: boolean, stateCode: number }} stateCode=3 表示连接成功
|
||
*/
|
||
async function configureWifi(ssid, password, options = {}) {
|
||
const profile = ble.getProfile()
|
||
const s = String(ssid || '').trim()
|
||
const p = String(password || '').trim()
|
||
validateWifi(profile, s, p)
|
||
requireAuthorized(ble)
|
||
|
||
const { wifi } = ble.getState().characteristics
|
||
if (!wifi || !wifi.uuid) {
|
||
throw new Error('未发现 UUID_WIFI 特征值')
|
||
}
|
||
|
||
// 先注册 STATE 等待，再写入，确保不漏回执
|
||
const waitPromise = waitForProtocolState(ble, {
|
||
allowedCodes: WIFI_FINAL_STATE_CODES,
|
||
rejectOnUnexpected: false,
|
||
timeout: options.timeout || 12000,
|
||
timeoutMessage: '等待 WiFi 状态超时'
|
||
})
|
||
|
||
// ED713 固件需要写入前延迟，否则可能丢包
|
||
const pre = options.preDelayMs ?? (profile.id === 'ED713' ? 120 : 0)
|
||
if (pre) {
|
||
log('preDelay before WiFi write(ms)=', pre)
|
||
await delay(pre)
|
||
}
|
||
|
||
log('write WiFi start', { service: ble.getState().serviceId, char: wifi.uuid })
|
||
const sent = await writeA7Payload(ble, wifi.uuid, `${s}|${p}`, profile.packet, {
|
||
packetInterval: Number(options.packetInterval) || 0
|
||
})
|
||
log('write WiFi done, packets=', sent)
|
||
|
||
const code = Number((await waitPromise).stateCode)
|
||
log('STATE(final) received for WiFi=', code)
|
||
|
||
// STATE=3 表示 WiFi 连接成功
|
||
return { success: code === 3, stateCode: code }
|
||
}
|
||
|
||
return { configureWifi, requireAuthorized }
|
||
}
|