WouoUI-PageVersion 项目教程

WouoUI-PageVersion 项目教程

WouoUI-PageVersion 项目地址: https://gitcode.com/gh_mirrors/wo/WouoUI-PageVersion

1. 项目目录结构及介绍

WouoUI-PageVersion 项目的目录结构如下：

WouoUI-PageVersion/
├── Csource/
│   ├── src/
│   │   ├── oled_g.c
│   │   ├── oled_ui.c
│   │   ├── oled_conf.h
│   │   ├── oled_g.h
│   │   ├── oled_ui.h
│   │   ├── oled_port.h
│   │   └── oledfont.h
│   ├── example/
│   │   ├── example1.c
│   │   ├── example1.h
│   │   ├── example2.c
│   │   └── example2.h
│   ├── ProjectExamples/
│   │   ├── Air001/
│   │   │   ├── main.c
│   │   │   └── ...
│   │   └── STM32/
│   │       ├── main.c
│   │       └── ...
│   └── Image/
│       └── ...
├── README.md
└── ...

目录结构介绍

• Csource/: 包含项目的核心源代码文件。

  • src/: 存放主要的源代码文件，包括 oled_g.c 和 oled_ui.c，以及相关的头文件。
  • example/: 包含使用 WouoUI-PageVersion 接口构建的应用示例代码。
  • ProjectExamples/: 包含使用 WouoUI-PageVersion 的工程参考，按主控类型划分，为移植时提供参考。
  • Image/: 存放一些展示用的图片。

• README.md: 项目的说明文档，包含项目的基本介绍、使用方法和示例。

2. 项目的启动文件介绍

项目的启动文件通常是指 main.c 文件，它在 ProjectExamples/ 目录下按主控类型（如 Air001 或 STM32）进行组织。以下是一个典型的 main.c 文件结构：

#include "oled_g.h"
#include "oled_ui.h"
#include "oled_port.h"

int main(void) {
    // OLED 初始化
    OLED_Init();

    // UI 初始化
    OLED_UiInit();

    // 主循环
    while (1) {
        // UI 处理函数
        OLED_UIProc();
    }

    return 0;
}

启动文件介绍

• OLED_Init(): 初始化 OLED 显示屏，配置 I/O 口和通信接口。
• OLED_UiInit(): 初始化 UI 系统，设置页面和动画参数。
• OLED_UIProc(): 在主循环中调用，处理 UI 事件和动画更新。

3. 项目的配置文件介绍

项目的配置文件主要位于 src/ 目录下的 oled_conf.h 文件中。以下是 oled_conf.h 文件的部分内容：

#ifndef OLED_CONF_H
#define OLED_CONF_H

// 配置宏定义
#define UI_CONWIN_ENABLE 1 // 是否使能确认弹窗
#define UI_MAX_PAGE_NUM 32 // 页面的最大数量
#define UI_INPUT_MSG_QUNEE_SIZE 4 // UI 内部消息队列的大小

// 页面类型使能宏
#define PAGE_WAVE_ENABLE 1
#define PAGE_RADIO_ENABLE 1
#define PAGE_RADERPIC_ENABLE 1
#define PAGE_DIGITAL_ENABLE 1

#endif // OLED_CONF_H

配置文件介绍

• UI_CONWIN_ENABLE: 控制是否启用确认弹窗功能。
• UI_MAX_PAGE_NUM: 定义页面最大数量，确保页面 ID 不超出范围。
• UI_INPUT_MSG_QUNEE_SIZE: 设置 UI 内部消息队列的大小，至少为 2。
• PAGE_WAVE_ENABLE, PAGE_RADIO_ENABLE, PAGE_RADERPIC_ENABLE, PAGE_DIGITAL_ENABLE: 控制不同页面类型的启用状态。

通过这些配置，开发者可以根据项目需求灵活调整 UI 的行为和功能。

WouoUI-PageVersion 项目地址: https://gitcode.com/gh_mirrors/wo/WouoUI-PageVersion