关于解决一键配网失败的解决办法与如何热点配网

野机工程师 · 发表于 2025-12-2 15:06:55

本帖最后由野机工程师于 2025-12-2 15:11 编辑

概要：本文主要介绍机智云APP里面一键配网失败的主要原因以及解决办法

先搞懂：你的机智云APP一键配网为啥总失败？
个人总结主要有以下几个原因：1、WiFi 频段不对（这是很多人最主要的原因）：机智云多数入门设备（比如 esp8266）只支持2.4G WiFi，你连了 5G WiFi 肯定搜不到
判断：看手机 WiFi 名称，带 “5G” 字样就是 5G 频段；
解决办法：切换到的 2.4G WiFi，一般用另一台手机开热点，打开2.4G模式即可
2、设备程序问题问题：检查设备的代码是不是正确的：可以从以下几个方面入手：代码里有没有设置wifi模式？如相关代码 gizwitsSetMode(WIFI_AIRLINK_MODE);
代码里有没有开启定时器中断、串口中断？如相关代码 HAL_TIM_Base_Start_IT();HAL_UART_Receive_IT();
代码里有没有机智云初始化的调用？如相关代码 gizwitsInit();

3、硬件设备的问题

wifi模块接线是否正确？对应端口不能接错
wifi模块是需要烧录机智云的固件才可以使用机智云的SDK联网的，机智云固件可以去机智云官网下载中心下载

如果排查了以上问题均找不出原因的话，可以使用热点配网来解决，可以先试试热点配网
热点配网没问题再回头去试试一键配网
以下介绍热点配网以及详细步骤

热点配网介绍：
热点配网（也叫 AP 配网），是机智云设备的一种备用配网方式
热点配网和一键配网的区别：
一键配网：你（手机）→ 把 WiFi 密码告诉路由器 → 路由器再传给设备（容易因为信号差、频段错出现问题）；
热点配网：你（手机）→ 直接走到设备身边 “贴耳说话” → 把 WiFi 密码直接告诉设备（干扰少，不容易出现问题）。

/专业点介绍：
热点配网本质是设备端启动 SoftAP（软件接入点）模式，构建本地无线局域网，移动端（手机 / 平板）作为 Station 接入该局域网后，通过 TCP/UDP 协议向设备端透传目标 WiFi 网络参数（SSID、Password），最终设备端切换至 Station 模式接入目标网络并完成云端鉴权的技术流程。

快速入门配网可以看这期教程
《快速入门手把手》机智云上云（STM32 HAL篇）上篇

以下热点配网详细流程：
1、连接好硬件设备之后，我们修改一下代码里面。把wifi配网设置模式改为热点配网（SoftAP模式）
main函数中添加代码：
gizwitsSetMode(WIFI_SOFTAP_MODE); //设置配网模式

2、重新编译烧录代码之后，打开机制云APP，开始AP热点配网

首先、这里我用一部手机来打开机智云来配网，然后另一部手机打开2.4G热点给第一步手机连接

把这个热点的自动连接关闭

接下来打开打开机智云APP后，直接跳过登录界面

添加设备

这里选择热点配网

这里会自动填好当前连接的热点和密码，下面是后面需要连接的，这里我们默认即可

这里选择乐鑫然后给板子断电，点击按钮后再供电

点击跳转到wifi界面

这里选择这个开头的wifi，输入刚刚的默认密码123456789

然后返回机智云APP，可以看到正在连接中了

连接成功，如果这里显示连接超时的话，就大退机智云APP，清除后台重新进。

这个时候就配网成功了，可以正常显示数据和控制了