HoloCubic_AIO AP热点模式详解：没有WiFi时如何给小电视配网-育师

HoloCubic_AIO AP热点模式详解：没有WiFi时如何给小电视配网

【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO

HoloCubic_AIO 是一款运行在 HoloCubic 透明小电视上的多功能 ESP32 固件，内置天气时钟、相册、视频播放、桌面投屏、Web 服务等丰富 APP。本文将面向新手，手把手讲解如何利用固件自带的AP 热点模式，在没有可用 WiFi 的情况下快速完成小电视配网。

什么是 AP 热点模式？

正常情况下，小电视需要通过 WiFi 连接路由器才能使用天气、股票、B站粉丝等联网功能。但刚刷完固件、还没配网时，设备根本连不上任何网络，这就产生了"先有鸡还是先有蛋"的问题。

AIO 固件的解决方案是：进入 Web Server（网页配置服务）APP 后，小电视会自动把自己变成一台 WiFi 路由器，放出一个名为HoloCubic_AIO、无需密码的热点。手机或电脑连上这个热点后，就能访问小电视内置的 Web 配置页面，在其中填写家里路由器的 SSID 和密码，完成配网。

核心实现在 network.cpp 的open_ap()函数中，固件会执行WiFi.softAP()开启热点，并将 AP 的固定 IP 设置为192.168.4.2（见 network.cpp）。

三步完成首次配网

第 1 步：进入 Web Server APP

开机后等待 RGB 灯完全亮起（MPU6050 初始化完成），左右摇晃小电视 0.5 秒切换 APP，选中Web Server，向前倾斜 1 秒进入。进入后屏幕会显示 "WebServer Start"，并标注出Local_IP与AP_IP两个地址。

第 2 步：连接热点并打开配置页面

在手机或电脑的 WiFi 列表中，找到名为HoloCubic_AIO的热点（无密码），连接它；
打开浏览器，在地址栏输入 AP 地址http://192.168.4.2，或使用域名http://holocubic直接访问（部分浏览器对域名访问支持不佳，推荐用 IP）。

第 3 步：填写路由器信息并保存

在 Web 配置页的System（系统设置）中填入：

WiFi SSID_0：你家路由器的 WiFi 名称（必须是 2.4G 频段，ESP32 不支持 5G）；
WiFi Passwd_0：对应的 WiFi 密码；

点击保存后，配置会写入小电视的内部 Flash，下次开机自动联网，无需重复操作。表单定义见 web_setting.cpp。

AP_IP 与 Local_IP 的区别

配置页面上会同时显示两个 IP，新手常分不清：

地址	含义	何时使用
`AP_IP`（192.168.4.2）	小电视自己放出的热点地址	未配网时，用电脑/手机连热点后访问
`Local_IP`（如 192.168.x.x）	小电视连上路由器后获得的地址	已配网成功，与电脑同网段时使用

固件每 5 秒会自动刷新一次屏幕上的 IP 信息，逻辑在 server.cpp 中。已配网的小电视再进 Web Server 时，直接用Local_IP访问即可。

热点为何过段时间就消失？（AP 超时机制）

如果你长时间停留在 Web Server 页面不操作，热点可能会自动关闭。这是因为固件设计了心跳保活 + 超时断开机制：

Web Server APP 每 5 秒向系统发送一次APP_MESSAGE_WIFI_ALIVE心跳，只要 APP 在前台运行，AP 就不会被关闭；
系统层面对长时间无人访问的 AP 设有超时保护，超过ap_timeout（300 秒）计数后会调用softAPdisconnect()断开热点，见 network.cpp；
退出 Web Server APP（后仰 1 秒）时，也会主动停止 Web 服务并关闭 WiFi，见 server.cpp。

所以配网时保持在 Web Server 界面内完成填写和保存即可，中途退出 APP 会导致热点关闭、页面失效。

常见故障排查清单

遇到连不上、打不开配置页的情况，按下面清单逐项排查：

热点列表找不到 HoloCubic_AIO：重启小电视（断电 3 秒再上电），确认 RGB 灯完全亮起后重新进入 Web Server APP；
能连热点但打不开网页：检查地址是否为http://192.168.4.2（注意是 http 不是 https），并确认手机已关闭移动数据，避免流量优先导致路由异常；
填完密码后连不上路由器：确认填入的是 2.4G 频段的 WiFi 名称，密码中是否含特殊字符（部分输入框对中文密码支持不佳）；
连接 WiFi 时设备反复重启：多为 USB 供电不足，WiFi 发射瞬间电流较大，建议换用输出电流更大的 5V 电源；
固件异常无法恢复：使用配套上位机 CubicAIO_Tool.py 重新刷写固件，刷写文件放在 base_bin 目录中即可，无需任何 IDE 环境。