import { writeA7Payload } from '../core/packet' import { waitForProtocolState } from '../core/stateWait' const WIFI_FINAL_STATE_CODES = Object.freeze([1, 2, 3]) // STATE=4 为 WiFi 连接中中间态,收到后用于刷新等待窗口 const WIFI_CONNECTING_STATE_CODES = Object.freeze([4]) // 总等待上限:覆盖弱信号/5G/企业级路由真实 DHCP 时长 const WIFI_TOTAL_TIMEOUT_MS = 60000 // 收到 STATE=4 后的单次刷新窗口 const WIFI_REFRESH_TIMEOUT_MS = 30000 // ED713 分包写入间隔:连续 writeWithoutResponse 易丢包,固件需留处理时间 const ED713_PACKET_INTERVAL_MS = 50 /** * 校验 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(';')) } } /** * 校验鉴权状态。 * 厂家确认密钥流程已不启用,此处仅记录未鉴权状态,不阻断 WiFi 配置。 */ function requireAuthorized(ble) { const state = ble.getState() if (!state.auth || state.auth.keyMatched !== true) { console.debug('[BLE][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),默认60000 * @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 特征值') } const totalTimeout = options.timeout || WIFI_TOTAL_TIMEOUT_MS // 先注册 STATE 等待,再写入,确保不漏回执 // 收到 STATE=4(连接中) 时刷新窗口,避免固定上限短于真实 DHCP 时长误判超时 const waitPromise = waitForProtocolState(ble, { allowedCodes: WIFI_FINAL_STATE_CODES, rejectOnUnexpected: false, timeout: totalTimeout, timeoutMessage: '等待 WiFi 状态超时', refreshOnCodes: WIFI_CONNECTING_STATE_CODES, refreshTimeout: WIFI_REFRESH_TIMEOUT_MS }) // 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 packetInterval = Number(options.packetInterval) || (profile.id === 'ED713' ? ED713_PACKET_INTERVAL_MS : 0) const sent = await writeA7Payload(ble, wifi.uuid, `${s}|${p}`, profile.packet, { packetInterval }) log('write WiFi done, packets=', sent, 'interval=', packetInterval) let code try { code = Number((await waitPromise).stateCode) } catch (error) { // 超时时带上设备最后上报的 STATE 码,便于区分"设备未响应"与"设备回了非预期态" const lastState = ble.getState().auth?.lastStateCode const hint = (lastState === undefined || lastState === null) ? '(设备未上报任何 STATE,可能 WiFi 分包写入丢失或固件未处理)' : `(设备最后上报 STATE=${lastState},未收到最终态 1/2/3)` throw new Error(`${error.message}${hint}`) } log('STATE(final) received for WiFi=', code) // STATE=3 表示 WiFi 连接成功 return { success: code === 3, stateCode: code } } return { configureWifi, requireAuthorized } }