项目介绍
AiPi-Clock-Mini 是安信可基于 Ai-WB2 系列模组推出的迷你桌面时钟开发板：出厂即预烧好时钟固件，开箱即用——上电就是一个能联网、能看时间的桌面小钟；同时整套硬件与源码均支持二次开发，加个天气、放张图片、做个倒计时，全凭你发挥。
用大白话讲：它是一块「装进外壳里的小开发板」。对普通用户，它是一个免安装的桌面时钟——首次使用花一分钟配好家里的 Wi-Fi，之后每次上电自动联网显示时间；对开发者，它又是一个可以随便折腾的 Ai-WB2 开发板——烧自己的固件进去，屏幕想显示什么由你说了算。
🔗 项目已开源：本项目代码与硬件全部开源——代码可克隆修改，外壳结构可直接打样复刻，按下文二次开发 即可做出属于自己的时钟：
项目功能
出厂固件（V1.0）内置以下两个核心功能：
▫️ 时钟显示
上电即进入时钟主界面，清晰显示当前时间，作为桌面摆件随取随用。联网（配网）成功后，每次上电都会自动连接 Wi-Fi 并进入时钟界面，无需任何额外操作。
▫️ Wi-Fi 配网
出厂固件内置了一套网页配网方案，无需刷机、无需改代码即可让设备联网：
- 首次上电自动进入配网模式：屏幕上会显示设备创建的热点名称，跟着下文「使用教程」一分钟内即可配好；
- 随时可重新配网：在时钟界面连续按动按键 5 次以上，即可再次进入配网模式，换路由器、换 Wi-Fi 密码都能应对。
💡 其余功能（如天气、图片等）由二次开发实现，出厂固件暂未内置，详见下文二次开发。
使用教程
AiPi-Clock-Mini 出厂已预烧原厂固件 V1.0，首次使用只需完成一次配网，全程在手机上操作：
将 Type-C 线连接 AiPi-Clock-Mini 供电，首次上电会自动进入配网模式，屏幕显示配网信息与设备创建的 Wi-Fi 热点名称。
⚠️ 注意：请记下屏幕上的热点名称，形如
Clock-Mini-XXXX（XXXX 为该设备的唯一后缀），下一步要用它连接。
打开手机的 Wi-Fi 设置，在可用网络列表中找到并点击连接 Clock-Mini-XXXX（该热点由时钟创建，无需密码）。
连接成功后手机会自动跳转到配网页面；若未自动弹出，请打开手机浏览器访问 192.168.4.1，即可打开配网页面。
在配网页面中，选择你的 2.4GHz Wi-Fi 名称（Ai-WB2 仅支持 2.4GHz 频段，搜不到 5G 是正常的），输入对应的 Wi-Fi 密码，点击页面上的「配网/连接」按钮，设备开始连接路由器。
设备成功连接路由器后，屏幕会提示配网成功，随后设备会自动重启并退出配网模式——出现该提示即代表配网完成，无需任何手动操作，等它重启即可。
设备自动重启完成后自动进入时钟主界面开始显示时间（联网状态下会自动与网络时间同步校准）。之后每次上电都会自动连接已保存的 Wi-Fi 并直接进入时钟界面，无需再次配网。
重新配网
当换了路由器、改了 Wi-Fi 密码，或希望把时钟连到别的 Wi-Fi 时，在时钟主界面下连续按动按键 5 次以上，屏幕会再次进入配网模式，重复上面第 ②~④ 步即可完成重新配网：
💡 配网流程走不通时，也先这样「按 5 次重新进入配网模式」从头再来一次，多数是上一步热点没连上导致的。
外观与硬件资料
▫️ 2D 尺寸图
▫️ 3D 结构图
▫️ 原理图
二次开发
AiPi-Clock-Mini 支持二次开发：硬件上是完整的 Ai-WB2 开发板，软件上基于安信可官方 SDK（Ai-Thinker-Open/Ai-Thinker-WB2）编译，屏幕（ST7789 驱动）与时钟界面基于 LVGL 编写，UI 和功能都可以随意改。
整个时钟工程已开源，你可以直接基于开源代码做二次开发，例如：
- 天气显示：联网获取天气数据，在屏幕上展示温度、天气图标等；
- 图片/相册播放：把图片显示在屏幕上，做桌面电子相册轮播；
- 界面自定义：修改时钟 UI 样式、配色、动画（LVGL 所见即所得）；
- 以及倒计时、番茄钟、桌面摆件交互等一切你想做的显示。
完整流程分四步：① 安装 SDK 开发环境 → ② 获取开源工程代码 → ③ （可选）编译自研固件 → ④ 用 BLDevCube 烧录固件，下面逐一展开。
▫️ 1. 安装 SDK 开发环境（一次性准备）
以 Windows 为例（官方推荐的 MSYS2 方案，全程无需虚拟机）：
安装 MSYS2：打开 https://www.msys2.org/ 下载安装包，一路「下一步」安装，安装目录建议默认（如
C:\msys64）。安装完成后从开始菜单打开 MSYS2 MINGW64（注意选 MINGW64 那个），在里面执行命令安装编译软件：bashpacman -S git make克隆官方 SDK（
--recursive必须带上，用于拉取工具链子模块；不要手动下载 GitHub/Gitee 页面的 Zip 压缩包，会导致工具链缺失）：bashgit clone --recursive https://gitee.com/Ai-Thinker-Open/Ai-Thinker-WB2.git配置环境变量：打开「系统设置 → 系统信息 → 高级系统设置 → 环境变量」，在用户变量中新建
MSYS2_PATH_TYPE = inherit，并把下面两行加入Path（按实际路径修改）：C:\msys64\usr\bin C:\Users\你的用户名\Ai-Thinker-WB2\toolchain\riscv\MSYS\bin验证：重启 MSYS2 终端，执行
riscv64-unknown-elf-gcc -v，能输出版本号即安装成功。
📌 完整的图文环境搭建教程（含编译、命令行烧录验证）见 Windows 平台环境搭建；Linux / WSL 用户见 Linux 平台环境搭建。
▫️ 2. 获取开源工程代码
AiPi-Clock-Mini 的完整工程已开源，基于它做二次开发：
git clone https://github.com/XEMOWO/AiPi-Clock-Mini.git工程技术栈：Ai-WB2（BL602）+ ST7789 172×320 屏 + LVGL 8 界面 + Wi-Fi / SNTP 校时，时钟界面、配网、天气、图片等功能的代码都在仓库内（代码结构与说明以仓库 README 为准）。想改哪个功能，在工程中找到对应代码修改后重新编译即可。
编译固件：在工程目录内打开 MSYS2 终端，执行：
make -j8编译成功后，生成的固件文件即用于下文烧录（如需把工程作为 SDK 应用运行，放置方式以仓库 README 说明为准）。
▫️ 3. 原厂固件
如需恢复出厂状态（把设备刷回出厂时钟体验），可下载原厂固件烧录（出厂默认固件，含时钟 + 配网功能）：
| 固件 | 版本 | 下载链接 |
|---|---|---|
| Clock-Mini 原厂固件 | V1.0 | Clock-Mini固件.zip |
▫️ 4. 烧录固件流程（BLDevCube）
烧录使用安信可 BL Dev Cube（BLDevCube.exe） 图形化烧录工具，先下载工具压缩包：
烧录步骤：
下载上方的 bl602_flash_download_tool.zip 并解压，双击运行其中的 BLDevCube.exe，出现如下主界面即运行成功：
💡 把 AiPi-Clock-Mini 用 Type-C 数据线连接电脑，并在「设备管理器 → 端口」确认已识别出串口（COM 号），再开始下面的操作。
在芯片类型中选择 BL602/604（AiPi-Clock-Mini 使用的 Ai-WB2 模组，内部芯片即 BL602）：
在烧录界面中选择固件文件（点浏览图标选中 .bin 固件）：
- 恢复出厂：选择原厂固件压缩包解压出的
.bin文件（见上文「原厂固件」下载）； - 二次开发：选择你自己编译生成的固件文件。
选中固件后，按工具界面提示选择对应的串口（COM 号）。
点击「开始烧写」（Create & Download）后，烧写过程中会遇到以下 4 种情况，对照处理即可：
烧写过程中的 4 种界面状态：
(1) 报错：串口被占用
此错误表示该串口被其他软件占用了（如串口调试助手、其他烧录工具没关），必须关闭占用该串口的软件后重新烧写。
(2) 提示 Please Press Reset Key
界面提示 Please Press Reset Key 时，给模块的 EN 引脚进行低电平复位（把 EN 引脚拉低一下，即让芯片复位进入下载模式），随后自动继续烧写。
(3) 烧写进行中
开始烧写：等待进度条走完即可，期间不要拔线、不要关闭软件。
(4) 烧写完成
烧写完成：断开连接后重新上电即可使用。若烧录的是原厂固件，首次上电会自动进入配网模式（见上文「使用教程」重新配网一次即可）。
⚠️ 最容易踩的坑：烧写失败十有八九是 ①串口被占用 或 ②忘记给 EN 引脚复位。请先关闭所有占用串口的软件（串口调试助手等），并在工具提示
Please Press Reset Key时，把开发板的 EN 引脚对地（GND）短接一下再松开，完成一次低电平复位。
FAQ
手机搜不到 Clock-Mini-XXXX 热点
确认时钟已供电且屏幕处于配网页面（首次上电自动进入；其他状态下连续按动按键 5 次以上可重新进入配网模式）。也请将手机靠近时钟再刷新 Wi-Fi 列表。
配网页面里搜不到我的 Wi-Fi / 连不上家里的 Wi-Fi
AiPi-Clock-Mini 仅支持 2.4GHz Wi-Fi，请确认路由器开启了 2.4G 频段（5G 频段搜不到、连不上是正常的）；同时确认 Wi-Fi 密码输入无误。
换路由器 / 改了 Wi-Fi 密码后时钟不联网了
在时钟主界面连续按动按键 5 次以上进入配网模式，按「使用教程」第 ②~④ 步重新配网即可，无需刷机。
自己刷了固件，想恢复成出厂时钟功能
下载「二次开发 → 原厂固件」V1.0 压缩包，按「烧录固件流程（BLDevCube）」用 BLDevCube 工具重新烧录即可恢复出厂体验。
如何做二次开发？
直接基于开源工程 XEMOWO/AiPi-Clock-Mini 修改即可：按本页「二次开发」先装好 SDK 环境、克隆工程，修改代码后 make -j8 编译，再用 BLDevCube 烧录到开发板。
烧录时提示串口被占用 / 卡在 Please Press Reset Key
串口占用：关闭所有占用该串口的软件（串口调试助手等）后重试；提示 Please Press Reset Key：对开发板 EN 引脚做一次低电平复位（EN 引脚对地短接一下再松开）即可继续烧写。
遇到问题？
如有其他问题，请到统一的提问与讨论区：Ai-Thinker Discussions