K230 · DEVELOPER SUPPORT

11 / 网络、MQTT 与消息边界

把网络连接、数据传输和设备动作拆开验收,先在受控网络验证。

操作指南 · 待实机核对阅读与电脑练习参考 20–40 分钟;板端联调按配置另评估 资料版本 2026.10.28-r1更新 2026-10-28

本课验证范围:本课为操作与验收方法。尚无对应 KJX 板型的实机记录,不作为已适配或量产承诺。

起步包提供原创说明、可在电脑运行的示例、板端参考代码和记录表。镜像、模型权重及第三方 EDA 工程需从对应来源获取;此包不是可烧录 BSP。

选择你的开发配置

课程、配件入口与下载包保持同一板型;选择不代表兼容性已验证

当前配置:KJX K230 1GB 核心模组方案

仅所选核心模组有明确商品入口;底板、相机、供电、线材和固件待组合确认,不是完整开发套件。

当前参考方案独立展示,不代表所选板型的已确认 BOM;板型与配套需求请通过技术支持核对。

开始前准备

  • 先阅读板型与版本课,并确认本课是否需要目标硬件。
  • 下载起步包;保留原始配置,不直接覆盖板上的 main.py。

操作步骤

  1. 确认网络硬件

    记录所用Wi-Fi/以太网模块、驱动与接口。核心模组有处理器不等于自带联网模块。

  2. 先测连接再测业务

    先检查地址获取与可达性,再连接测试服务端。网络凭据放私有配置;不在截图、示例包或公共日志中保存密码。

  3. 规范消息

    采用带版本、序号、时间和有效状态的消息;重连后丢弃过期控制信息。连接失败应可停止、可重试,不无限阻塞主循环。

  4. 限制可执行范围

    公网控制必须具备认证与权限。收到二维码、串口或MQTT文本都按输入数据校验,不能直接当Python代码执行。

预期结果与核对

  • 断网、重连与重复消息有明确状态,不导致执行机构持续动作。
  • 没有把客户网络凭据打包到资源下载中。

遇到问题时

板能联网但消息收不到
分别核对服务端、端口、主题、认证和消息方向,先用测试主题隔离。
断线后一直卡住
加超时与退出条件,保持安全停止路径不依赖网络恢复。

本课配套文件

当前下载配置:KJX K230 1GB 核心模组方案。下载并解压后,进入 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当前所选板型、起步配置清单与适用边界;不替代实物配置文件。