Skip to content

yuehunliren/mpage

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mpage

嵌入式多页显示界面框架

mpage ui msg 设计

ui msg 用来在界面间传递消息:

typedef struct mpage_ui_msg_st {
    unsigned int mpage_id_src;
    unsigned int mpage_id_dst;
    unsigned int msg_type;
    unsigned int msg_len;
    unsigned char msg_ctx[MPAGE_UI_MSG_LEN_MAX];
} mpage_ui_msg_t;
  • mpage_id_src:发出该消息的页面 id(可选)
  • mpage_id_dst:要接收消息的页面 id(必填)
  • msg_type:可用于指明该消息类型,用于ui界面判断(可选)
  • msg_len:消息内容长度,单位Byte(可选)
  • msg_ctx:消息内容(可选),最大长度可由 MPAGE_UI_MSG_LEN_MAX 指定,默认256.

如何添加页面

  1. 在枚举类型中添加page id(WELCOME只是默认页,可删除),mpage通过指定 page id 来跳转到对应的页。
enum mpage_id {
    PAGE_WELCOME,
    // ...
};
  1. mpage_ui.c中添加该页对应的 ui 逻辑,添加后在mpage_ui.h中声明:
void welcom_ui(mpage_ui_msg_t *msg)
{
    
}

前端界面函数被调用时会传入ui_msg,用户可通过ui_msg拿到需要显示的信息。

  1. mpage_logic.c中添加该页对应的后台逻辑。
static int welcom_logic(mpage_ui_msg_t *msg)
{

    return 0;
}

后端逻辑函数中,用户可利用 ui_msg 全局变量封装消息,使用下面的 API 发送 ui_msg 并跳转到对应界面:

int mpage_ui_msg_post(mpage_ui_msg_t *msg);
  1. 前后端函数各自完成后,将{<页面id>,<页面ui函数>, <页面后台逻辑函数>} 注册到 mpage 中。
const mpage_t mpage[] = {
    {PAGE_WELCOME, welcom_ui, welcom_logic},
};

如何启动

mpage 启动 API 如下:

int mpage_start(void);

mpage调度器在 while (1) 循环中执行,所以该函数启动后不再返回

(1)裸机中,推荐在 while (1) 之前调用,由 mpage 接管系统中原有的死循环。

(2)RTOS中,推荐新建一个任务,任务中执行 mpage_start。

About

嵌入式多页显示界面框架

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 100.0%