AiPi-Clock-Mini迷你网络时钟，Ai-WB2-12F(BL602) #28

XEMOWO · 2026-08-26T06:12:36Z

XEMOWO
Aug 26, 2026
Collaborator

🕐 AiPi-Clock-Mini

一颗 BL602 (Ai-WB2-12F) 驱动的 1.47" ST7789V 桌面时钟 — LVGL 8 图形界面 + WiFi/SNTP 网络校时 + 软 AP 配网 + 串口上位机协议。

📌 项目简介


🎯 定位	桌面迷你时钟 · 网络自动校时 · 零上位机也能用
🔩 主控	安信可 Ai-WB2-12F (BL602): SiFive E24 RISC-V 内核 + 2.4G WiFi/BLE 5.0)
🖥️ 屏幕	ST7789V 172×320 (1.47") RGB565,硬件 SPI0 40MHz 驱动
🎨 界面	LVGL 8.3,大数字 Morganite 字体 + 中文点阵字体,渐变背景
⏰ 时间	SNTP 校时 (ntp.aliyun.com) + 离线漂移校准 (脱网数天仍准)
📡 配网	连按 EN 5 次 → 软 AP + captive portal 配网页 (SSID 可扫描)
🖥️ 上位机	串口 xcmd 协议 (2M bps):状态灯 / 壁纸上传 / 天气配置 / 时钟背景
💾 存储	EasyFlash 持久化配置 + media 分区存图 (开机图 / 壁纸 / 开机计数)
🔄 自愈	30s 硬件看门狗 · 45s 连不上 WiFi 自动进配网 · 新固件首启自动恢复出厂

🧩 功能总览

出厂即用 = 默认开启,开机就能用;出厂关闭 = 功能已内置,出厂不启用,按需开启。

✅ 主要功能 (出厂默认开启)

功能	说明	入口
🕐 数字时钟	大号 Morganite 数字,冒号 0.5s 呼吸闪烁,秒级刷新	开机即用
📅 日期星期	月/日 + Mon..Sun + 周数 (周一=1)	SNTP 后自动
🌐 网络校时	SNTP 60s 轮询,毫秒级系统时钟 (bl_sys_time)	自动
🧭 离线校准	学习本地晶振漂移 (us/s),断网按漂移外推补偿	自动
🌈 时钟背景	出厂淡蓝→淡紫垂直渐变;纯色/水平渐变/双色可配	`#XBG`
🎞️ 翻页动画	分钟切换滚动翻页 (出厂默认开)	`#XCLOCK`
🔥 配网模式	连按 EN 5 次触发;软 AP `Clock-Mini-XXXX` / `12345678`	硬件按键
📶 配网页	SSID 扫描 + 密码 + 城市选择,captive portal 自动弹出	手机浏览器
🎬 开机图	出厂内置安信可 logo (media 分区 XIP 直读,展示 2s)	开机自动
🧹 开机计数	flash 扇区持久化,5 次进配网;成功/3 分钟/显示时间后清零	自动
🧨 出厂重置	固件带编译时间戳,新版本首启自动清旧配置恢复出厂	自动
🐶 看门狗	30s 硬件看门狗,死机自动复位	自动
🔌 串口协议	`#X` 前缀行协议,应答/事件推送,与日志共用 UART0	PC 上位机
🗄️ 配置持久化	EasyFlash (PSM 分区),20+ 个配置键	自动
🧱 屏保自愈	连不上 WiFi 45s → 自动进配网重配	自动

🔧 可选功能 (出厂默认关闭)

固件已全部内置,只差"打开"这一步 —— 出厂保持关闭,按需开启。

功能	出厂默认	开启方式
🌦️ 天气显示	关 (`wx_on=0`,key 已内置)	高德 (HTTP) / 和风 (HTTPS+gzip) / Open-Meteo 三源;`#XWXAPI` 切源,`#XWXKEY` 下发 Key
🖼️ 壁纸轮播	关 (`wall_mode=0`)	`#XWALL` 开启;时钟↔壁纸各 5s 独立时长切换
🎨 自定义壁纸上传	关 (默认无)	`#XIMGSTART` / `#XIMG` / `#XIMGEND` hex 分块上传
🎬 自定义开机图	关 (默认内置 logo)	`#XBOOTIMG` 上传,media 分区 XIP 直读
💡 Claude 状态灯	关 (默认无灯)	`#XMON` 总开关 + `#XLAMP` 颜色 (黄/绿/红/黄色呼吸)

🖼️ 项目图片

📷 实物图	🔬 PCB 图
📐 原理图	🧊 3D 建模图

⚙️ 构建与烧录

# 依赖: Ai-Thinker-WB2 SDK (同级目录)
make                    # → build_out/WB2-clock2.bin
make flash              # 串口烧录 (921600 bps, /dev/ttyUSB0)

项目	值
固件大小	~1.2 MB (mbedtls 已引入)
Flash 总容量	2 MB
FW 分区	0x10000 ~ 0x170000 (1408 KiB,无 OTA,合并单段)
工具链	RISC-V GCC (SDK 内置)

📁 项目结构

⏱️ 固件启动流程

🔬 技术分享:BL602 如何驱动 1.47" LCD

这是本项目技术含量最高、也最"踩坑"的部分:ST7789V 172×320 屏通过硬件 SPI0 40MHz 驱动 + LVGL 8 刷新,完整原理与关键坑位如下。

📦 配套源码（当前版本 v0.2.2）: github.com/XEMOWO/ai-wb2-clock/tree/v0.2.2

1️⃣ 硬件连接与总线架构

引脚	GPIO	方向	说明
SCL (SCK)	GPIO3	输出	SPI0 时钟,40MHz
SDA (MOSI)	GPIO12	输出	SPI0 数据 (半双工:屏只收不发)
CS	GPIO14	输出	片选,软件 GPIO 控制
DC	GPIO4	输出	数据/命令选择,软件 GPIO 控制
RST	GPIO17	输出	复位,软件 GPIO 控制 (仅开机一次)

关键点:SPI 数据线只有 MOSI (半双工写)。 屏幕只接收不回复,所以 MISO 不需要复用 —— 这也是 GPIO17 能同时干两件事 (先 RST、后复用为 SPI) 的原因。

2️⃣ 为什么不能用 `hosal_spi_send`?(血泪坑)

/* ❌ 会永久死锁! */
hosal_spi_send(&spi_dev, data, len);   /* 中断驱动路径 */

/* ✅ 正确方案: bl602_std 寄存器级轮询 API */
SPI_Send_8bits(SPI_ID_0, buf, len, SPI_TIMEOUT_ENABLE);

路径	驱动方式	结论
`hosal_spi_send`	中断 + 信号量	❌ 本 SDK 的 ROM 构建下 SPI IRQ 不触发,发送完没人唤醒,永久死锁
`SPI_Send_8bits` (bl602_std)	寄存器轮询 + 超时	✅ 与已验证的 Arduino SPI 库同方案,可靠

💡 排查此类问题的通用思路:优先怀疑"中断驱动路径在特定构建下不工作",死锁类 bug 用 bl_irq_save 级别的寄存器直读 API 绕开最快。

3️⃣ SPI0 初始化详解

GLB_GPIO_Func_Init(GPIO_FUN_SPI, pins, 3);          /* GPIO3/12/17 复用为 SPI */
GLB_Set_SPI_0_ACT_MOD_Sel(GLB_SPI_PAD_ACT_AS_MASTER); /* 主机模式 */

SPI_SetClock(SPI_ID_0, 40000000);                   /* 40MHz! */
SPI_SetDeglitchCount(SPI_ID_0, 0x2);

/* SPI_CFG_Type 关键配置 */
spicfg.continuousEnable = ENABLE;                    /* 连续传输 */
spicfg.byteSequence     = SPI_BYTE_INVERSE_BYTE0_FIRST; /* 字节高字节在前 */
spicfg.bitSequence      = SPI_BIT_INVERSE_MSB_FIRST;    /* 位序 MSB 先 */
spicfg.frameSize        = SPI_FRAME_SIZE_32;
spicfg.clkPhaseInv      = SPI_CLK_PHASE_INVERSE_0;   /* MODE0 */
spicfg.clkPolarity      = SPI_CLK_POLARITY_LOW;
SPI_Init(SPI_ID_0, &spicfg);
SPI_IntMask(SPI_ID_0, SPI_INT_ALL, MASK);            /* 轮询模式: 屏蔽中断 */

为什么能上 40MHz?

参数	值	说明
ST7789V 数据手册 SPI 上限	62 MHz+	40MHz 余量充足
全屏数据量	320 × 220 × 2 B ≈ 140 KB	RGB565 每像素 2 字节
8MHz 全屏刷新	~121 ms	初版 bit-bang 时代
40MHz 全屏刷新	~24 ms	提速 5 倍,动画丝滑

📐 理论验证: 140,800 B × 8 bit ÷ 40 MHz ≈ 28 ms,实测 ~24 ms (含 DMA/轮询开销差),与理论吻合,说明 SPI 时钟已顶到接近理论极限。

4️⃣ 命令/数据时序 (_cmd / _dat)

ST7789 靠 DC 线区分命令与数据:

static void _cmd(uint8_t c){                       /* 发命令 */
    hosal_gpio_output_set(&dc,0);                  /* DC=0 → 命令 */
    hosal_gpio_output_set(&cs,0);                  /* CS 拉低 → 选中 */
    SPI_Send_8bits(SPI_ID_0,&c,1,SPI_TIMEOUT_ENABLE);
    hosal_gpio_output_set(&cs,1);                  /* 释放 */
}
static void _dat(uint8_t d){                       /* 发数据 */
    hosal_gpio_output_set(&dc,1);                  /* DC=1 → 数据 */
    hosal_gpio_output_set(&cs,0);
    SPI_Send_8bits(SPI_ID_0,&d,1,SPI_TIMEOUT_ENABLE);
    hosal_gpio_output_set(&cs,1);
}

DC 线上: ────────▄▄▄▄▄▄──────────────────────────────
              命令字节       数据字节
        (0x2A 等)     (x1>>8, x1, x2>>8, x2 ...)

💡 逐字节 CS 拉高拉低是轮询模式下的标准做法:每次传输都是完整事务,简单可靠。40MHz 下每字节 ~0.2µs,CS 翻转开销可忽略。

5️⃣ ST7789 初始化序列 (逐条拆解)

/* 复位时序: RST 低 50ms → 高 150ms */
hosal_gpio_output_set(&rst,0); vTaskDelay(50);
hosal_gpio_output_set(&rst,1); vTaskDelay(150);

_cmd(0x01); vTaskDelay(150);   /* SWRESET  软复位 */
_cmd(0x11); vTaskDelay(120);   /* SLPOUT   退出睡眠 */
_cmd(0x36); _dat(0x60);        /* MADCTL   RGB 顺序 + 扫描方向 */
_cmd(0x3A); _dat(0x55);        /* COLMOD   = 16bit/pixel (RGB565) */
_cmd(0xB2); ...                /* PORCTRL   porch 设置 */
_cmd(0xB7); _dat(0x35);        /* GCTRL    门控 */
_cmd(0xBB); _dat(0x19);        /* VCOMS    共模电压 */
_cmd(0xC0); _dat(0x2C);        /* LCMCTRL  电源控制 */
_cmd(0xC2); _dat(0x01);        /* VDVVRHEN */
_cmd(0xC3); _dat(0x12);        /* VRH      显示电压 */
_cmd(0xC4); _dat(0x20);        /* VDV      液晶驱动电压 */
_cmd(0xC6); _dat(0x0F);        /* FRCTRL2  帧率 */
_cmd(0xD0); _dat(0xA4); _dat(0xA1); /* PWCTRL1 电源 */
_cmd(0xE0); 14 字节            /* PVGAMCTRL 正极性伽马 */
_cmd(0xE1); 14 字节            /* NVGAMCTRL 负极性伽马 */
_cmd(0x21);                    /* INVON    反色开 (此屏必须) */
_cmd(0x13);                    /* NORON    正常显示模式 */
_cmd(0x29); vTaskDelay(50);    /* DISPON   开显示 */

命令	含义	本项目取值	备注
`0x36 MADCTL`	内存访问控制	`0x60`	RGB 次序 + 扫描方向,决定画面正反
`0x3A COLMOD`	颜色模式	`0x55`	16bit/pixel = RGB565,必须与 LVGL 一致
`0x21 INVON`	反色	开	1.47" 面板特性,不开会负片
`0xE0/0xE1`	伽马曲线	各 14 字节	对比度/色温全靠它调

⚠️ 常见坑:颜色模式 0x55 (RGB565) 必须和 LVGL 的 LV_COLOR_DEPTH=16 完全一致,否则颜色错乱。0x36 的 0x60 与你的 PCB 接线方向强相关,方向不对 → 镜像/翻转,调 0x00/0x60/0xC0/0xA0 四组值试。

初始化最后还有一步:全屏清零,防止上电出现雪花噪点:

_cmd(0x2C);  /* 进入 RAM 写模式 */
for (uint32_t i = 0; i < 320*320*2; i += 1024)
    SPI_Send_8bits(SPI_ID_0, zeros, 1024, SPI_TIMEOUT_ENABLE);

6️⃣ 窗口写入:0x2A / 0x2B / 0x2C (画哪里写哪里)

ST7789 的显存写入必须先设窗口,再灌像素:

static void _win(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2){
    x1 += OX; x2 += OX;               /* OX=0: 水平不偏移 */
    _cmd(0x2A);                        /* 列地址 (X) */
    _dat(x1>>8); _dat(x1); _dat(x2>>8); _dat(x2);   /* 16bit 大端 */
    _cmd(0x2B);                        /* 行地址 (Y) */
    _dat((y1+OY)>>8); _dat(y1+OY); _dat((y2+OY)>>8); _dat(y2+OY); /* OY=30 */
    _cmd(0x2C);                        /* RAMWR: 之后发的是像素 */
}

💡 172×320 屏如何显示 320×220? 屏幕是"横"着用的:172 是高度方向,320 是宽度方向。OY=30 把逻辑画布向下平移 30 行 —— 屏厂把玻璃做高了 30 行(弯折/排线区),必须跳过顶部无效区,否则画面下移/错位。

7️⃣ LVGL flush 回调:字节序是最深的坑

static void my_flush(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color){
    _win(area->x1, area->y1, area->x2, area->y2);
    hosal_gpio_output_set(&dc,1); hosal_gpio_output_set(&cs,0);

    uint32_t w = area->x2 - area->x1 + 1;
    uint32_t h = area->y2 - area->y1 + 1;
    uint8_t *p = (uint8_t*)color;

    /* LVGL 缓冲小端 (SWAP=0), ST7789 要高字节在前 → 逐行交换 */
    static uint8_t line[W*2];
    for(uint32_t y=0; y<h; y++){
        for(uint32_t x=0; x<w; x++){
            line[x*2]   = p[1];      /* 高字节在前 */
            line[x*2+1] = p[0];
            p += 2;
        }
        SPI_Send_8bits(SPI_ID_0, line, w*2, SPI_TIMEOUT_ENABLE);  /* 整行一发 */
    }
    hosal_gpio_output_set(&cs,1);
    lv_disp_flush_ready(drv);        /* 通知 LVGL 缓冲区已释放 */
}

为什么必须交换字节?

位置	字节序	例:像素 0xF800 (红色)
LVGL 内存 (小端 CPU,`SWAP=0`)	低字节在前	`00 F8`
ST7789 SPI 传输 (MADCTL RGB)	高字节在前	`F8 00`

⚠️ 不交换 = 每个像素高低字节互换 → 颜色完全乱掉(红蓝互调、渐变呈噪点)。两个解法:代码里逐像素交换(本项目),或 LVGL 开 LV_COLOR_16_SWAP=1 让 LVGL 直接生成大端。本项目选前者,static uint8_t line[W*2] 行缓冲 + 整行 SPI 发送,把 344 次单字节发送合并成 1 次,开销集中在 swap 循环(纯内存操作),40MHz 下整行 ~9µs。

8️⃣ LVGL 心跳与缓冲策略 (内存紧张 BL602)

/* 1. 心跳: 硬件定时器 1ms 中断喂 LVGL (hosal_timer period 单位 µs) */
static hosal_timer_dev_t tdev = {
    .config = {.cb = tick_cb, .period = 1000, .reload_mode = TIMER_RELOAD_PERIODIC},
    .port = 0};
static void tick_cb(void *arg){ lv_tick_inc(1); }   /* period=1000µs → 1ms tick */

/* 2. 部分帧缓冲: 320 × 20 行 × 2B = 12.8 KB (不整屏缓冲!) */
static lv_color_t buf1[W*20];
lv_disp_draw_buf_init(&dbuf, buf1, NULL, W*20);     /* 单缓冲, LVGL 自己分块 */

方案	RAM 占用	说明
全屏缓冲 320×220×2	140 KB ❌	BL602 应用堆总共 ~200KB,直接爆
部分缓冲 320×20	12.8 KB ✅	LVGL 自动分块重绘,flush 按区域触发

💡 LVGL 部分缓冲模式下,flush_cb 收到的是脏区域 (area),_win() 每次只设脏区窗口 —— 时钟这种小面积更新,一次刷新只有几十 KB 流量,40MHz 下肉眼无感。

9️⃣ 开机图:不依赖 LVGL 的直刷路径

/* 在 lv_init() 之前调用 —— 纯 SPI 刷屏 */
_win(0, 0, W-1, H-1);          /* 全屏窗口 */
for (uint32_t y = 0; y < H; y++){
    for (uint32_t x = 0; x < W; x++){
        line[x*2]   = p[1];    /* 同样的字节序交换 */
        line[x*2+1] = p[0];
        p += 2;
    }
    SPI_Send_8bits(SPI_ID_0, line, W*2, SPI_TIMEOUT_ENABLE);
}

图源	存储	说明
出厂内置	`boot_builtin.c` 常量数组 (flash)	安信可 logo,开箱即用
用户上传	media 分区 XIP 直读	`#XBOOTIMG` 上传,无需读 flash 到 RAM

💡 media 分区挂在 XIP (内存映射),img_boot_get() 拿到的指针直接指向 flash 地址,p[1] 就是 flash 读取 —— 省掉整图搬运 RAM 的 140KB,这是图能在 200KB 堆的 MCU 上全屏显示的关键。

📡 配网模式详解

项	值
触发方式	连续按 EN 5 次 (上电第一时间计数,flash 扇区,不被复位清掉)
软 AP 名	`Clock-Mini-XXXX` (MAC 后 4 位)
密码
AP IP	`192.168.169.1`
交互	captive portal (DNS 重定向) → 手机自动弹配网页
页面能力	SSID 扫描 / 密码 / 城市选择 / 状态回显
退出条件	配网成功自动重启;或 10 分钟无操作自动退出
计数器清零	配网成功 / 稳定运行 3 分钟 / SNTP 显示时间后

🧠 为什么开机计数存 flash 扇区? 最初尝试 HBN 寄存器,实测 EN 复位会清空整个 HBN 域;再试 EasyFlash,又被启动时序/出厂重置干扰。最终方案:media 分区最后一个 4KB 扇区,magic(0xB007C0DE) + count 小端,bl_flash_erase/write 自带关中断 + ROM 轮询驱动,bfl_main 极早期 (UART 初始化后) 即可安全调用 —— 连按 EN 每下都立刻计入,不被任何初始化挡住。

🖥️ 串口协议 (xcmd)

UART0 @ 2M bps,与 printf 日志共用,协议行以 #X 开头。PC 上位机 (EXE) 通过此协议控制时钟。

方向	命令	功能
PC → 设备	`#XVER`	查询版本
PC → 设备	`#XST`	查询状态 (WiFi/时间/IP...)
PC → 设备	`#XLAMP`	Claude Code 状态灯 (0=呼吸 1/2=黄 3=绿 4=红)
PC → 设备	`#XMON`	状态灯开关
PC → 设备	`#XBG`	时钟背景 (颜色/渐变方向)
PC → 设备	`#XCITY` `#XWXCITY`	城市设置
PC → 设备	`#XWXAPI` `#XWXKEY`	天气源切换 / API Key 下发
PC → 设备	`#XWALL`	壁纸轮播开关
PC → 设备	`#XIMGSTART` `#XIMG` `#XIMGEND`	图片上传 (hex 分块)
PC → 设备	`#XBOOTIMG`	开机图上传
PC → 设备	`#XBOOTCLR`	清开机计数
设备 → PC	`#XA,res,cmd`	命令应答
设备 → PC	`#XEV,ev`	事件推送 (`GOT_IP` / `WIFI_DISCONNECT`)

⏰ 时间同步与离线走时

系统毫秒时间 bl_sys_time (SNTP 同步时写入精确服务器时间,FreeRTOS tick 持续推进),100ms 轮询,秒级刷新 (分钟切换滞后 <0.1s)。

/* 漂移学习: 每次真实对时, 跳变量 ÷ 间隔 = 本地漂移速率 (µs/s) */
s_drift_us_per_s = s_drift_us_per_s * 3 / 10 + d * 7 / 10;  /* 7成新 + 3成旧平滑 */

/* 离线外推: 显示时间 = NTP 锚点 + tick 流逝 + 漂移补偿 */
int64_t disp_ms = s_anchor_ms + el + el * s_drift_us_per_s / 1000000;

场景	行为
有网	SNTP 60s 轮询校准,毫秒精度
断网	按学习到的漂移速率外推,脱网数天仍基本准确
晶振	BL602 内部 RC 实测有漂移,校准后误差可接受

🌦️ 天气功能 (可选,默认关)

项	说明
源 1	高德 (HTTP 明文,需 key)
源 2	和风 (HTTPS + gzip 强制压缩,需解压)
源 3	Open-Meteo (免 key,内置)
认证	和风新版 `X-QW-Api-Key` 请求头
HTTPS	SDK 预构建 mbedtls_lts,无 CA 存储 → `VERIFY_NONE`
城市	40+ 内置城市列表 (配网页可搜索选择)

⚠️ 注意:BL602 做 HTTPS 要省着点 —— 天气任务栈 3KB,mbedtls 上下文放堆上,VERIFY_NONE 省掉 CA 链校验的开销。

💾 Flash 分区与存储布局 (2MB)

分区	地址	大小	用途
FW	0x10000	1408 KiB	固件 (无 OTA,合并单段)
mfg	0x170000	200 KiB	出厂参数
media	0x1A2000	290 KiB	开机图 + 壁纸 + 开机计数
PSM	0x1E9000	32 KiB	EasyFlash 配置 (ENV)
KEY / DATA	0x1F1000	8/20 KiB	密钥 / 数据
factory	0x1F8000	28 KiB	工厂分区

💡 media 分区 = 全部 XIP 映射,图直接指针读,无需搬运 RAM。开机计数刻意放在最后一个 4KB 扇区,上传工具只擦自己的区域,永远碰不到它。

🧹 开机日志静音工程 (SYS_BOOT_LOG_DISABLE)

出厂固件刷屏的 SDK 日志 (EasyFlash "Not found" ×21、FlashCfg dump、MTD dump、IRQ 清理打印…) 全部关掉,有用信息收进上电横幅。

# Makefile: 宏注入到全部组件
EXTRA_CFLAGS += -D SYS_BOOT_LOG_DISABLE

来源	关闭手段
EasyFlash EF_DEBUG / EF_INFO	`ef_log_debug` / `ef_log_info` 内 `#ifndef SYS_BOOT_LOG_DISABLE`
EasyFlash 裸 printf	ef_port.c 裸 printf 加守卫
mfg_efuse 25 处打印	`mfg_print` 宏重写为空操作
MTD / FlashCfg / IRQ dump	各文件 `#ifndef` 守卫

📋 效果:固件中 16 个 SDK 启动字符串出现次数全部为 0,启动输出只剩干净的横幅 + 关键事件日志。

🐛 排障笔记

展开:常见问题与解法

现象	根因	解法
SPI 发送卡死	走了 `hosal_spi_send` (中断路径不触发)	用 bl602_std 轮询 API `SPI_Send_8bits`
颜色错乱 / 红蓝互换	LVGL 小端 vs ST7789 大端	flush 里逐像素字节交换,或 `LV_COLOR_16_SWAP=1`
画面翻转 / 镜像	MADCTL (0x36) 与接线方向不匹配	试 `0x00 / 0x60 / 0xC0 / 0xA0`
画面负片 (反色)	未开反色	初始化加 `0x21 INVON`
上电雪花噪点	未清显存	RAMWR 全屏写 0
串口横幅乱码/截断	WSL usbipd 高速 USB 串口丢字节	用 Windows 侧串口工具,或降波特率
按 EN 不进配网	计数被某初始化挡掉	计数必须放 bfl_main 极早期 (app_boot_early)
时间越来越偏	RC 晶振漂移未校准	SNTP 漂移学习自动补偿

📜 License

MIT © 2026 xemowo — 自由使用,保留出处。

Yaqing-Zheng · 2026-08-26T07:18:55Z

Yaqing-Zheng
Aug 26, 2026
Maintainer

哎哟，还真的交作业啦~

1 reply

XEMOWO Aug 26, 2026
Collaborator Author

当然，一点内幕都没有

WildboarG · 2026-08-28T05:29:31Z

WildboarG
Aug 28, 2026

学习了，SPI 发送问题原来出在这

2 replies

WildboarG Aug 28, 2026

等等，你是莫哥！

SeaHi-Mo Aug 28, 2026
Maintainer

你个假粉丝

Navigation Menu

AiPi-Clock-Mini迷你网络时钟，Ai-WB2-12F(BL602) #28

Uh oh!

{{title}}

Uh oh!

Replies: 2 comments 3 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

AiPi-Clock-Mini迷你网络时钟，Ai-WB2-12F(BL602) #28

Uh oh!

XEMOWO Aug 26, 2026 Collaborator

🕐 AiPi-Clock-Mini

📌 项目简介

🧩 功能总览

✅ 主要功能 (出厂默认开启)

🔧 可选功能 (出厂默认关闭)

🖼️ 项目图片

⚙️ 构建与烧录

📁 项目结构

⏱️ 固件启动流程

🔬 技术分享:BL602 如何驱动 1.47" LCD

1️⃣ 硬件连接与总线架构

2️⃣ 为什么不能用 hosal_spi_send?(血泪坑)

3️⃣ SPI0 初始化详解

为什么能上 40MHz?

4️⃣ 命令/数据时序 (_cmd / _dat)

5️⃣ ST7789 初始化序列 (逐条拆解)

6️⃣ 窗口写入:0x2A / 0x2B / 0x2C (画哪里写哪里)

7️⃣ LVGL flush 回调:字节序是最深的坑

为什么必须交换字节?

8️⃣ LVGL 心跳与缓冲策略 (内存紧张 BL602)

9️⃣ 开机图:不依赖 LVGL 的直刷路径

📡 配网模式详解

🖥️ 串口协议 (xcmd)

⏰ 时间同步与离线走时

🌦️ 天气功能 (可选,默认关)

💾 Flash 分区与存储布局 (2MB)

🧹 开机日志静音工程 (SYS_BOOT_LOG_DISABLE)

🐛 排障笔记

📜 License

Replies: 2 comments · 3 replies

Uh oh!

Yaqing-Zheng Aug 26, 2026 Maintainer

Uh oh!

XEMOWO Aug 26, 2026 Collaborator Author

Uh oh!

WildboarG Aug 28, 2026

Uh oh!

WildboarG Aug 28, 2026

Uh oh!

SeaHi-Mo Aug 28, 2026 Maintainer

XEMOWO
Aug 26, 2026
Collaborator

2️⃣ 为什么不能用 `hosal_spi_send`?(血泪坑)

Replies: 2 comments 3 replies

Yaqing-Zheng
Aug 26, 2026
Maintainer

XEMOWO Aug 26, 2026
Collaborator Author

WildboarG
Aug 28, 2026

SeaHi-Mo Aug 28, 2026
Maintainer