KJX ENGINEERING GUIDE · 04

K230 Wi‑Fi 联网与超时诊断指南

把“能连网”拆成硬件识别、扫描、认证、取址、服务可达和断线恢复六个检查点。

参考流程 · 固件差异需复测 中级 参考学习时长 45–90 分钟 核查 2026-08-09
返回所选配置与 BOM 商城搜索 K230
CanMV-K230 / 四轮编码底盘 / 控制协议待适配

公开资料核对，不使用未经确认的整机照片。

适用说明：本手册用于 具备受支持 WLAN 硬件的 K230/CanMV 板卡；API 与 active 行为随固件分支可能不同。实施时请以目标板卡、固件和外设的实际版本为准；正式交付的功能、资料与验收标准以订单或技术协议为准。
返回配置：K230 视觉小车软硬件联调 · 同版参考基线。手册是适用范围内的工程参考，不代表所选配置已经完成实测。

准备与目标

适用范围具备受支持 WLAN 硬件的 K230/CanMV 板卡；API 与 active 行为随固件分支可能不同
实施方式参考流程 · 固件差异需复测；按目标硬件执行并记录结果

开始前准备

  • 目标板 Wi‑Fi 硬件已被固件识别
  • 2.4GHz 测试网络
  • 串口日志
  • 已完成版本基线

完成后应得到

  • 区分扫描、认证、DHCP 和业务服务故障
  • 避免无限等待造成界面假死
  • 形成可复测的断线恢复策略

01 · 确认网卡与扫描

先证明固件识别了实际 WLAN 硬件。

3 个步骤
  1. 记录 network 模块和 WLAN 对象是否存在。
  2. 执行扫描并记录 SSID、信号和频段。
  3. 扫描不到时先检查天线、固件与模组，不反复改密码。
✓ 网卡对象可创建✓ 能看到目标 2.4GHz SSID✓ 日志中无驱动初始化失败

02 · 有超时的连接

连接流程必须有截止时间、状态输出和失败回收。

3 个步骤
  1. 发起连接前清理旧状态。
  2. 轮询连接状态并设置 15–30 秒截止时间。
  3. 成功后记录 IP、网关和 DNS；失败时输出状态码并断开。
✓ 不会无限阻塞✓ IP 信息完整✓ 错误能够区分认证和取址

03 · 服务与恢复

拿到 IP 不等于业务可用，还要验证目标服务和重连。

3 个步骤
  1. 访问局域网健康检查或执行 DNS/HTTP 最小请求。
  2. 关闭 AP 或移出覆盖区，验证状态提示。
  3. 恢复网络后按退避策略重连，不高频死循环。
✓ 目标服务可达✓ 断线有可见提示✓ 恢复后业务自动继续

故障定位

现象常见原因建议动作
能扫描但认证失败密码、加密方式或仅支持频段不匹配使用独立 2.4GHz 测试网络并核对密码编码。
已连接但无 IPDHCP、路由或地址池问题记录状态与网关侧租约，暂不进入业务层。

验收与归档

  • 连接流程有超时
  • IP/网关/DNS 已记录
  • 断线提示明确
  • 恢复测试连续完成三次

建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论，方便后续复现、维护与售后。