本课验证范围:本课为操作与验收方法。尚无对应 KJX 板型的实机记录,不作为已适配或量产承诺。
起步包提供原创说明、可在电脑运行的示例、板端参考代码和记录表。镜像、模型权重及第三方 EDA 工程需从对应来源获取;此包不是可烧录 BSP。
选择你的开发配置
课程、配件入口与下载包保持同一板型;选择不代表兼容性已验证
开始前准备
- 先阅读板型与版本课,并确认本课是否需要目标硬件。
- 下载起步包;保留原始配置,不直接覆盖板上的 main.py。
操作步骤
确认网络硬件
记录所用Wi-Fi/以太网模块、驱动与接口。核心模组有处理器不等于自带联网模块。
先测连接再测业务
先检查地址获取与可达性,再连接测试服务端。网络凭据放私有配置;不在截图、示例包或公共日志中保存密码。
规范消息
采用带版本、序号、时间和有效状态的消息;重连后丢弃过期控制信息。连接失败应可停止、可重试,不无限阻塞主循环。
限制可执行范围
公网控制必须具备认证与权限。收到二维码、串口或MQTT文本都按输入数据校验,不能直接当Python代码执行。
预期结果与核对
- 断网、重连与重复消息有明确状态,不导致执行机构持续动作。
- 没有把客户网络凭据打包到资源下载中。
遇到问题时
- 板能联网但消息收不到
- 分别核对服务端、端口、主题、认证和消息方向,先用测试主题隔离。
- 断线后一直卡住
- 加超时与退出条件,保持安全停止路径不依赖网络恢复。
本课配套文件
当前下载配置:KJX K230 2GB 核心模组方案。下载并解压后,进入 KJX-K230-starter 目录,再按以下相对路径打开文件;先看 CONFIGURATION.md 中的适用范围。
HANDS_ON.md本课相关源文件或操作说明;见包内 README 的验证范围。vision_events.py本课相关源文件或操作说明;见包内 README 的验证范围。records/validation-record.json本课相关源文件或操作说明;见包内 README 的验证范围。courses/network-and-messages.md本课完整离线说明,与网页同源。CONFIGURATION.md当前所选板型、起步配置清单与适用边界;不替代实物配置文件。