STM32+OLED屏多级菜单显示（三）_stm32多级菜单
前面两章实现了OLED屏幕显示的基本功能，这一章就做一个多级菜单显示功能
单片机选择STM32F103C8T6最小系统板，OLED屏选择0.96寸OLED显示器，除了单片机和OLED屏之外，还需要三个按键(下一位键、确认键和返回键)，当然一个按键也可以(单击、双击和长击完成)，为了提高可玩性这里就只使用一个按键。
1.1 STM32+OLED屏初始化（一）
1.2 STM32+OLED屏显示字符串、汉字、图片（二）
1.3 STM32+OLED屏多级菜单显示（三）
1.4 STM32+OLED屏(软件IIC+位带+帧缓冲区)刷新速率优化(四)
1.多级菜单
多级菜单是一种用户界面设计，它将信息和选项组织为层次结构，使得用户可以快速找到所需的选项。多级菜单的实现基于两种方案索引法和树结构法，索引法阅读性好，扩展性不错，查找性最优，但是比较占用内存，并且一旦选项过多就会造成逻辑混乱
下面展示使用索引法设计的多级目录(黑色的板子是底板，可以理解为面包板)，首先是一级目录：
其次，二级目录：
最后，三级目录：
2.typedef用法
在使用多级界面之前，首先要了解一些基础知识。typedef是C/C++中的一个关键字，用来给一个已存在的数据类型（比如int、float、struct等）取一个新的别名(自定义数据类型)。通过typedef声明的别名，可以像原类型一样被使用，但具有更直观、更易读的含义，从而提高代码可读性和可维护性。typedef的使用格式为：
typedef 原类型 新类型举个例子，如：typedef int MyInt;MyInt a = 10;//等效int a = 10再看这个例子，将一个结构体定义为Point类型的别名，使用时就可以使用Point代替这个结构体。这个例子中的第三行代码创建了一个Point类型的结构体变量p，并为其成员变量赋值，除此之外，还有更多的定义方式，如数组、函数指针、enum等
typedef struct { int x; int y;} Point;Point p;p.x = 1;p.y = 2;2.函数指针
简单来说，函数指针是指向函数的指针变量，它存储了函数的入口地址，可以用来调用函数。在C语言中，函数指针的定义格式为：返回值类型 (*函数指针名称)(参数列表)。
在下面的例子中，定义了一个函数指针func_ptr，它指向同样返回int类型的函数add。将add函数的地址赋给了函数指针func_ptr后，就可以使用func_ptr来调用add函数，和直接使用add(3,5)是等效的
#include int add(int a, int b) { return a + b;}int main() { int result； int (*func_ptr)(int, int); // 定义函数指针 func_ptr = add; // 将函数的地址赋给函数指针 result = func_ptr(3, 5); // 使用函数指针调用函数 printf(\"%d\\n\", result); // 输出结果：8 return 0;}3.定义多级菜单数据显示类型
前面的基础知识讲完了，现在正式开始使用索引法实现多级菜单的第一步，定义多级菜单的数据类型，通过typedef声明的结构体设计界面菜单功能的数据类型，当前索引序号、三个按键、当前执行的函数指针，索引序号表示界面页码，要进入界面就要输入它的索引序号(就像是在宾馆房间编号，要进入房间就要知道它的房间编号)，通过按键赋值索引序号达到跳转的目的(给房间编号的前台服务员)，最后是执行的函数指针指向要执行的函数(可以理解为通往房间的路径)
typedef struct{uint8_t CurrentNum;//当前索引序号:页码uint8_t Enter;//确认键uint8_t Next;//下一个uint8_t Return;//返回键void (*Current_Operation)(void);//当前操作(函数指针)}Menu_table_t;根据上面自定义的数据类型，定义一个一维数组taskTable[ ]，一维数组中的元素的数据类型就是Menu_table_t(就像我定义一个int array[] = { 0 ,}，0的数据类型就是int)，taskTable的元素中的元素与自定义数据类型里的数据类型统一对应，就像最后一个函数指针元素指向菜单界面函数，简单说明一下，taskTable[0] = {0, 1, 0, 0, Menu_Innterface}，
//界面调度表 //假定 int array[] = { 0, };Menu_table_t taskTable[] ={ //菜单界面函数 -- 一级界面 {0, 1, 2, 3, Menu_Interface}, };/** * @brief 菜单界面函数 * @param 无 * @retval 无 */void Menu_Interface(void){char buff[50];RTC_Get_StdTime(RTC_GetCounter());sprintf(buff,\"%0.2d:%0.2d:%0.2d\",RTC_CLOCK.hour, RTC_CLOCK.min, RTC_CLOCK.sec);OLED_ShowString(4, 10, 24, buff);sprintf(buff,\"Date:%0.4d-%0.2d-%0.2d\",RTC_CLOCK.year,RTC_CLOCK.mon,RTC_CLOCK.day);OLED_ShowString(1, 6, 16, buff);}所以，数据类型就是这样对应的，第一个为索引序号，中间三个为按键，最后一个执行函数，将它的首地址赋值给指针函数
4.菜单逻辑顺序表
通过上述的对应关系，可以制定一张菜单逻辑顺序，通过中间的三个按键将索引序号赋值给任务调度序号，当在一级界面时，按下确认键就通过索引序号把务调度序号切换为1，进入到二级界面的第一个元素了，按下下一位键和返回键
uint8_t taskIndex = 0;//任务调度序号//任务调度表Menu_table_t taskTable[] ={ //菜单界面函数 -- 一级界面 {0, 1, 0, 0, Menu_Interface}, //功能界面函数 -- 二级界面 {1, 4, 2, 0, Function_Interface1}, {2, 5, 3, 0, Function_Interface2}, {3, 6, 1, 0, Function_Interface3},//功能设置界面函数 -- 三级界面{4, 4, 4, 1, Function_Interface4},{5, 5, 5, 2, Function_Interface5},{6, 6, 6, 3, Function_Interface6},};用三张张图简单的说明一下，第一张图，当前页面为0，按下确认键跳到索引序号为1的元素
第二张图，当前页面为1，按下确认键跳到索引序号为4的元素
第三张图，当前页面为6，按下返回键跳到索引序号为3的元素
5.按键切换索引序号
编写一个按键值获取函数，按键将索引序号赋值给任务调度序号，任务调度表根据任务调度序号执行运行界面，前面有说过，最后一个元素只是指向运行函数的指针(也就是路径)，真正的执行需要解引用，也就是最后的执行函数
keyval = Keyval_Scan();if(keyval == 2) {//双击taskIndex = taskTable[taskIndex].Enter;//双击表示确认键OLED_Clear();}else if(keyval == 1) {//单击taskIndex = taskTable[taskIndex].Next;//单击表示下一位键}else if(keyval == 10) {//长击taskIndex = taskTable[taskIndex].Return;//长击表示返回键OLED_Clear();}taskTable[taskIndex].Current_Operation();//执行函数按键获取函数，按下按键30ms的按键抖动，2s内松开视为有效单击，0.5s后无按键按下，结算总共按下几次有效单击，单击返回1，双击返回2，三击返回3，长击返回10；用不到三击以上的按键，而且十击与长按都返回10，之后可能会出巨大的事故问题
uint8_t Keyval_Scan(void){static uint16_t key_state, key_time, key_cnt;uint8_t key_return = 0;switch(key_state) {case 0://按键状态0:判断有无按键按下if(KEY_STATA0) {key_time = 0;//按键按下时,按键计时器清0key_state = 1;//按键状态置1}break;case 1://按键状态1:按键消抖if(KEY_STATA0) {delay_ms(1);if(key_time++ >= 30) key_state = 2;//当按键按下超过30ms时,进入按键单击状态}else key_state = 0;//松开按键,视为误触break;case 2://按键状态2:单击或长击if(!KEY_STATA0) {key_time = 0;key_cnt++;//按键计数器自增key_state = 3;//此时按键松开,表示已经单击,进入下个状态}else {delay_ms(1);if(key_time++ >= 2000) {key_cnt = 0;key_return = 10;key_state = 4;}}break;case 3://按键状态3:按键多击if(!KEY_STATA0) {delay_ms(1);if(key_time++ >= 500) {//松开按键0.5s无按键按下,返回按键计数器key_return = key_cnt;key_cnt = 0;key_state = 0;}}else {key_state = 0;}break;case 4://按键状态4:等待长按按键释放if(!KEY_STATA0) key_state = 0;break;}return key_return;}对应不确定什么时候到的接收，最好使用按键中断，这边使用按键中断与定时器完成单击、双击和长击，中间加了一个互斥锁g_APPTOIN_MUTEX，防止中断切换界面时运行程序出错，常规初始化配置就不写了，直接上中断函数的代码； -- 使不使用中断由读者自己选择
uint8_t g_APPTOIN_MUTEX = 1;//程序互斥锁void EXTI0_IRQHandler(void){static uint8_t Keystate = 0;//静态按键状态 0 -- 松开 1 -- 按下if(EXTI_GetITStatus(EXTI_Line0) != RESET) {if(!KEY_STATA0 && Keystate) {Keystate = 0;//松开按键TIM_Cmd(TIM2, DISABLE);//关闭定时器if(g_Time_Count 3) && (g_Time_Count = 2) {//双击taskIndex = taskTable[taskIndex].Enter;//双击表示确认键OLED_Clear();printf(\"double keyval!\\r\\n\");};}if((g_Keyval_Count >= 2) || (g_Keyval_Count == 0)) {g_Keyval_Count = 0;g_APPTOIN_MUTEX = 1;//关闭互斥}else { g_Time_Count = 0;//清空定时器溢出次数TIM_Cmd(TIM2, ENABLE);//启动定时器}}else if(KEY_STATA0 && !Keystate){Keystate = 1;//按下按键g_Time_Count = 0;//清空定时器溢出次数TIM_Cmd(TIM2, ENABLE);//启动定时器g_APPTOIN_MUTEX = 0;//开启互斥}EXTI_ClearITPendingBit(EXTI_Line0);//清除中断标志}}//#include \"key.h\"#define KEY_STATA0!!GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0)extern uint8_t g_APPTOIN_MUTEX;void KEY_Init(void);定时器也一样，直接上中断函数的代码
uint16_t g_Time_Count;//TIM溢出次数 -- 10ms Tout(溢出时间) = (ARR+1)(PSC+1)/Tclk(时钟分割)uint8_t g_Keyval_Count;//按键计数器void TIM2_IRQHandler(void){if (TIM_GetITStatus(TIM2, TIM_IT_Update) == SET) {//进入中断表示定时器计数(CNT)溢出, 自增(10ms溢出一次, 可通过配置ARR, PSC和Tclk自定义溢出时间)g_Time_Count++;if((g_Time_Count >= 200) && KEY_STATA0) {TIM_Cmd(TIM2, DISABLE);//关闭定时器g_Time_Count = 0;//清空溢出次数g_Keyval_Count = 0;//清空按键计数taskIndex = taskTable[taskIndex].Return;//长击表示返回键OLED_Clear();printf(\"long keyval!\\n\");g_APPTOIN_MUTEX = 1;}else if((g_Time_Count >= 50) && !KEY_STATA0 && (g_Keyval_Count == 1)) {TIM_Cmd(TIM2, DISABLE);//关闭定时器g_Time_Count = 0;//清空溢出次数g_Keyval_Count = 0;//清空按键计数taskIndex = taskTable[taskIndex].Next;//单击表示下一位键printf(\"short keyval!\\n\");g_APPTOIN_MUTEX = 1;}TIM_ClearITPendingBit(TIM2, TIM_IT_Update);}}//#include \"time.h\"extern uint16_t g_Time_Count;extern uint8_t g_Keyval_Count;void TIME_Init(uint16_t psc, uint16_t arr);6.界面设计
使用了三级界面，一级界面显示时间，利用sprintf函数将时间数据写入buff数组中，再显示到OLED屏幕上，完成显示
二级界面提供功能选项，因为有三个功能选项所以用到三个函数，>>箭头在那个地方就表示选择那个功能，这三个功能分别表示字符串、汉字和图片
三级界面显示内容，效果就不一个一个展示了，直接看后面的操作演示
最后，显示代码：
//#inlude \"oled_show.c\"uint8_t taskIndex = 0;//初始任务//任务调度表Menu_table_t taskTable[] ={ //菜单界面函数 -- 一级界面 {0, 1, 0, 1, Menu_Interface}, //功能界面函数 -- 二级界面 {1, 4, 2, 0, Function_Interface1}, {2, 5, 3, 0, Function_Interface2}, {3, 6, 1, 0, Function_Interface3},//功能设置界面函数 -- 三级界面{4, 4, 4, 1, Function_Interface4},{5, 5, 5, 2, Function_Interface5},{6, 6, 6, 3, Function_Interface6},};/** * @brief 菜单界面函数 * @param 无 * @retval 无 */void Menu_Interface(void){char buff[50];RTC_Get_StdTime(RTC_GetCounter());sprintf(buff,\"%0.2d:%0.2d:%0.2d\",RTC_CLOCK.hour, RTC_CLOCK.min, RTC_CLOCK.sec);OLED_ShowString(4, 10, 24, buff);sprintf(buff,\"Date:%0.4d-%0.2d-%0.2d\",RTC_CLOCK.year,RTC_CLOCK.mon,RTC_CLOCK.day);OLED_ShowString(1, 6, 16, buff);}/** * @brief 功能界面函数 * @param 无 * @retval 无 */void Function_Interface1(void){OLED_ShowString(0, 0, 16, \">>String\");OLED_ShowString(2, 0, 16, \" Chinese\");OLED_ShowString(4, 0, 16, \" ImageBMG\");}void Function_Interface2(void){OLED_ShowString(0, 0, 16, \" String\");OLED_ShowString(2, 0, 16, \">>Chinese\");OLED_ShowString(4, 0, 16, \" ImageBMG\");}void Function_Interface3(void){OLED_ShowString(0, 0, 16, \" String\");OLED_ShowString(2, 0, 16, \" Chinese\");OLED_ShowString(4, 0, 16, \">>ImageBMG\");}/** * @brief 功能设置界面函数 * @param 设置有三种状态 * @retval 无 */void Function_Interface4(void){OLED_ShowString(1, 0, 8, \"ABCD\");OLED_ShowString(2, 0, 16, \"ABCD\");OLED_ShowString(4, 0, 24, \"ABCD\");}void Function_Interface5(void){ OLED_ShowChinese(3,16*2,0);// 点OLED_ShowChinese(3,16*3,1);// 个OLED_ShowChinese(3,16*4,2);// 赞OLED_ShowChinese(3,16*5,3);// 吧OLED_ShowChinese(3,16*6,4);// ! }void Function_Interface6(void){OLED_ShowImageBMG();}7.主函数
在main.c文件中，不使用中断，cnt是为了OLED屏幕刷新慢一点，不影响按键而设计的
//#include \"main.c\"int main(void){uint8_t keyval = 0, cnt = 0;KEY_Init();OLED_Init();Usart_Init();MyRTC_Init();printf(\"多级界面\\r\\n\");while (1) {keyval = Keyval_Scan();if(keyval == 2) {printf(\"double\\r\\n\");taskIndex = taskTable[taskIndex].Enter;//双击表示确认键OLED_Clear();}else if(keyval == 1) {printf(\"press\\r\\n\");taskIndex = taskTable[taskIndex].Next;//单击表示下一位键}else if(keyval == 10) {printf(\"long\\r\\n\");taskIndex = taskTable[taskIndex].Return;//长击表示返回键OLED_Clear();}if(cnt++ >= 200) {cnt = 0;taskTable[taskIndex].Current_Operation();//执行函数}}}在main.c文件中，使用中断，只需要一个互斥锁和一个执行函数就可以了，按键按下时，互斥锁开启，不执行执行函数，和上面的cnt用法相似
//#include \"main.c\"int main(void){KEY_Init();TIME_Init(72, 10000);OLED_Init();Usart_Init();MyRTC_Init();printf(\"多级界面\\r\\n\");while (1) {if(g_APPTOIN_MUTEX) {taskTable[taskIndex].Current_Operation();//执行函数}}}操作演示：
WeChat_20231205093715
源码分享：链接：https://pan.baidu.com/s/1CujKS8I7-eok3y9y3CxkUA?pwd=457e
提取码：457e
