|
#申请原创# #技术资源#
最近在开发的一个产品,要通过几个按键操作LCD显示屏,并且某些按键还要同时支持单按、双按和长按,于是乎我就用某个AI软件生成了一段大概满足需求按键驱动代码,我把它们分别放入了源文件和头文件,其中修改或增加了按键个数,按键触发电平和按键事件个数等宏定义,以及修改了按键绑定的GPIO信息等接口,但核心代码未做修改,主要代码如下所示: 头文件代码: - <font face="Tahoma">// 最大按键数量
- #define KEY_MAX_NUM 3
- // 按键参数配置
- #define KEY_SCAN_INTERVAL_MS 10 // 扫描周期(ms)
- #define DEBOUNCE_TIME 2 // 消抖次数(约30ms)
- #define SHORT_PRESS_TIME 30 // 短按判定时间(300ms)
- #define LONG_PRESS_TIME 300 // 长按判定时间(3000ms)
- #define DOUBLE_CLICK_INTERVAL 30 // 双击间隔(300ms)
- //按键按下时的电平
- #define KEY_TRIGGER_LEVEL 0
- //按键事件的个数(短按,双按,长按)
- #define KEY_EVENT_MAX 3
- // 按键事件枚举
- typedef enum
- {
- KEY_EVENT_NONE = 0, // 无事件
- KEY_EVENT_SINGLE, // 单按
- KEY_EVENT_DOUBLE, // 双按
- KEY_EVENT_LONG // 长按
- } KeyEvent_t;
- // 按键ID枚举(方便调用)
- typedef enum
- {
- KEY_UP_ID = 0,
- KEY_SET_ID,
- KEY_DOWN_ID,
- } KeyId_t;
- // 按键状态机
- typedef enum
- {
- STATE_IDLE = 0, // 空闲状态
- STATE_PRESSED, // 按键已按下(已经去抖)
- STATE_LONG_PRESSED, // 按键长按触发
- STATE_WAIT_RELEASE, // 等待释放(用于单双击判定)
- } KeyState_t;
- // 单个按键对象
- typedef struct
- {
- uint8_t (*getLevel)(void); // IO电平读取函数
- KeyState_t state; //按键处理状态机
- uint8_t debounceCnt; //消抖时间计时
- uint16_t pressCnt; //按下时间计时
- uint16_t releaseCnt; //释放时间计时
- uint8_t isLongPressTriggered; //长按触发标志
- uint8_t isDoublePressCheck; //双击检测标志
- uint8_t isDoublePressTriggered; //双击触发标志
- KeyEvent_t event;
- } KeyObject_t;
- // 按键管理器
- static struct
- {
- KeyObject_t keys[KEY_MAX_NUM];
- uint8_t keyCount;
- } keyManager = {0};
- extern uint8_t (*keyLevelFuncs[])(void);
- // 初始化:传入每个按键的读取函数指针数组和数量
- void Key_Init(uint8_t (*getLevelFuncs[])(void), uint8_t keyNum);
- // 定时扫描函数(每10ms调用一次)
- void Key_Scan(void);
- // 获取指定按键的事件(非阻塞)
- KeyEvent_t Key_GetEvent(KeyId_t keyId);
- // 可选:清空指定按键的事件
- void Key_ClearEvent(KeyId_t keyId);</font>
源文件代码如下: 其中: 按键初始化接口Key_Init上电执行一次,用于按键结构体数据初始化和绑定GPIO; 按键处理接口ProcessKey被按键扫描接口Key_Scan调用,用于按键事件的检测; 按键扫描接口Key_Scan在10ms定时器中断里周期执行,用于按键扫描和计时处理; 按键事件读取接口Key_GetEvent在应用层里周期执行,用于读取按键事件并处理; 按键事件清除接口Key_ClearEvent在读取按键事件后被调用,用于清除上一次按键信息。 总体来说,AI生成的代码在可读性,变量和函数命名以及实现逻辑上都还不错,所以我就赶紧移植到工程上,然后试试效果。
我增加了一段按键测试代码,只要有按键事件,就会打印按键消息到串口,如下所示: - <font face="Tahoma">// 打印按键事件信息结构体
- typedef struct
- {
- KeyId_t key_id;
- KeyEvent_t key_event;
- uint8_t *pKeyInfo;
- } KeyEventPrint_t;
- const KeyEventPrint_t stKeyInfoList[KEY_MAX_NUM*KEY_EVENT_MAX] =
- {
- {KEY_UP_ID, KEY_EVENT_SINGLE, "UP键单按事件触发"},
- {KEY_UP_ID, KEY_EVENT_DOUBLE, "UP键双按事件触发"},
- {KEY_UP_ID, KEY_EVENT_LONG, "UP键长按事件触发"},
- {KEY_SET_ID, KEY_EVENT_SINGLE, "SET键单按事件触发"},
- {KEY_SET_ID, KEY_EVENT_DOUBLE, "SET键双按事件触发"},
- {KEY_SET_ID, KEY_EVENT_LONG, "SET键长按事件触发"},
- {KEY_DOWN_ID, KEY_EVENT_SINGLE, "DOWN键单按事件触发"},
- {KEY_DOWN_ID, KEY_EVENT_DOUBLE, "DOWN键双按事件触发"},
- {KEY_DOWN_ID, KEY_EVENT_LONG, "DOWN键长按事件触发"},
- };
- //读取按键事件
- for(i=0; i<KEY_MAX_NUM; i++)
- {
- keyEventBuff[i] = Key_GetEvent(i);
- if(keyEventBuff[i] != KEY_EVENT_NONE)
- {
- printf("按键信息: %s\r\n", Key_PrintEvent(i, keyEventBuff[i]));
- }
- }</font>
一开始没有使用Keil仿真调试,是直接看串口打印的,发现的确可以实现我需要的功能: 然后后面想实时仿真看下按键结构体keyManager的成员变量数据,结果发现其中的指示按键数量的变量却是13,正常是3才对;然后看了每个按键管理下的变量,显示的值也是奇奇怪怪: 然后我还通过clean Targets再全编译等操作,都一样,太奇怪了吧!此时还是比较疑惑~
然后反复仿真,有一次发现指示main循环运行次数的全局变量gRunCount一直为0,就是说main没有正常跑起来: 然后单步运行看一下,果然是触发HardFault异常中断了,实际显示的现象如下图所示: 其实这个时候按键管理器结构体里面的变量数据,在进入仿真且还没有全速运行程序的时候,就已经是上面的错误显示了。 然后没办法,我只能怀疑是按键驱动代码里面哪里有非法操作了,然后就去检查 …… ……
从头到尾仔细检查了一遍,唯一看着有点别扭的地方就是按键管理器那个结构体的写法: 用static定义了一个没有名字的静态结构体类型,然后结构体变量的名称是keyManager,所以在按键驱动源文件里面都是直接用keyManager加成员变量的方式来操作的。
看这里的写法我总觉得别扭,因为这里没有使用常用的typedef struct方式来定义结构体,然后我先试着去掉static,编译时候报错了: 我把这个按键管理器结构体定义放到按键驱动源文件里面,再编译,就OK了。
此时我再通过单步调试的方式去查看按键管理器的相关数据变量,发现全部正常了: 因为这个时候keyManager还是static类型,所以没办法在全速运行的时候去监控它的数据变化,但是我估计,应该是没问题了。
接着,我换了一个方式,我用自己常用的typedef方式在头文件里面直接重新定义了这个结构体,并命名为keyManager_t,也更方便再单独定义结构体变量或者结构体数组如下所示: - <font face="Tahoma">// 按键管理器
- typedef struct
- {
- KeyObject_t keys[KEY_MAX_NUM];
- uint8_t keyCount;
- } keyManager_t;</font>
然后定义了一个结构体变量来管理按键,名称还是用keyManager,这样的话,其他代码就不用修改了: keyManager_t keyManager; 修改完成,赶紧编译试试效果! 大家先猜测是什么结果?? …… …… 反正我不管按键能不能正常触发,我就先看按键管理器里的变量数据是否正常!
真是是正常了,全部都是上电后的默认值(缺省值): 然后试了长按SET键和短按SET键,串口也是有正常打印的,按键管理器也是正常显示状态的: 后面进行了多次测试,目前暂未出现之前的HardFault异常了! 为什么把最初的那种定义方式放在头文件里面会导致HardFault异常呢? 程序编译的时候没有产生报错,也没有产生警告,加上我自己当时也没注意,以为都正常的。 其实static struct { ... } keyManager = {0};这种写法定义在头文件里面,其中static 修饰的是文件作用域变量,每个包含该头文件的源文件都会生成自己独立的一份keyManager副本;如果头文件被多个源文件包含(当然,实际是肯定有),链接时不会报重复定义(因为 static 是内部链接,如果把static去掉,就会像我之前那样报重复定义错误了)错误,但每个源文件都有自己的副本,你以为在A.c文件里初始化/写入的keyManager,在B.c文件里读到的是另一份全0的数据,据不完全统计,这类数据不一致的Bug就很有可能导致HardFault异常,看来在我这里的现象,应该就是这个原因了。 的确,按以为的代码编写习惯,好像是真没有操作过在头文件里面用static关键词的,疏忽了,有点尴尬~~
用AI生成的按键驱动代码,如果我们操作不当,真是有可能造成一些程序问题,说不定一开始我们还会认为是AI生成的代码有问题,但有时候吧,有些代码的写法的确不是最好的,加上我们的错误操作,就导致Bug了。所以啊,至少对我来说,这是一次好的经验教训。
|