触摸开关控件
触摸开关控件 v1.2一、项目概述
本项目是基于STC8H8K64U单片机和RA8889/RA6809图形处理芯片(Micro GPU)开发的一款触摸开关控件，适用于TFT显示屏(最高1366*xxxx)和电容触摸屏(GT911)。该控件提供了美观、响应灵敏的开关界面，支持多个开关同时工作，可应用于各类嵌入式人机交互界面。
二、硬件配置
[*]单片机：STC8H8K64U（RT8H8K001开发板）（也可以采用ARM等各种MCU）
[*]图形处理芯片：RA8889/RA6809（RT6809CNN01开发板）
[*]显示屏：TFT 1024x600分辨率
[*]触摸屏：电容式GT911
[*]单片机-图形处理芯片的通信方式：SPI-4
三、程序流程
初始化流程
[*]硬件初始化
- 配置IO口：P0.5为双向口模式(SPI_MISO)，其它为推挽输出
- 配置GT911的IIC通信引脚
- 配置触摸中断引脚(INT2/P3.6)
[*]SPI通信初始化
- 初始化SPI4接口
[*]RA8889初始化
- 硬件复位RA8889
- 初始化RA8889显示配置
[*]中断初始化
- 配置INT2/P3.6为触摸屏中断输入
[*]GT911触摸控制器初始化
- 初始化GT911配置
[*]开关控件初始化
- 初始化开关控件数组
- 添加并配置所需开关
- 绘制所有开关
- 显示开关初始状态
主循环流程
[*]触摸检测
- 通过中断方式检测触摸事件
- 当触摸中断发生时，设置触摸标志
[*]触摸处理
- 读取触摸点坐标
- 判断触摸位置是否在开关区域内
- 返回触发的开关ID
[*]状态更新
- 切换被触发开关的状态
- 重绘被触发的开关
- 更新状态显示
- 等待防抖时间
[*]触摸释放处理
- 当无触摸点时，重置触摸状态
- 清除触摸标志
四、控件使用说明
基本参数配置
[*]开关数量：最多开关数量可通过修改MAX_SWITCHES_NUM调整
[*]防抖动时间：默认20ms，可通过修改DEBOUNCE_TIME调整
[*]开关样式：可通过修改default_style结构体调整颜色、尺寸等样式
五、开关控件API
初始化函数void Switch_Init(void);初始化开关数组，清空已有开关。应在使用控件前首先调用。
添加开关void Switch_Add(unsigned int x, unsigned int y, unsigned char initial_state);添加一个新开关：
[*]x、y：开关左上角坐标
[*]initial_state：初始状态（0：关闭，1：打开）
绘制开关void Switch_Draw(unsigned char switch_id);绘制指定ID的开关。ID从1开始编号。
void Switch_DrawAll(void);绘制所有已添加的开关。
触摸处理unsigned char Switch_HandleTouch(unsigned int touch_x, unsigned int touch_y);处理触摸事件，判断是否触发开关：
[*]touch_x、touch_y：触摸点坐标
[*]返回值：被触发的开关ID，返回0表示无开关被触发
状态显示（该函数用于检视触摸开关状态值）void Switch_PrintStatus(unsigned char switch_id);打印指定开关的状态信息。
void Switch_PrintAllStatus(void);打印所有开关的状态信息。
使用示例// 初始化开关控件
Switch_Init();
// 添加三个开关，位置和初始状态
Switch_Add(280, 200, 0);// 开关1：位置(280,200)，初始状态:关闭
Switch_Add(280, 300, 1);// 开关2：位置(280,300)，初始状态:打开
Switch_Add(280, 400, 0);// 开关3：位置(280,400)，初始状态:关闭// 绘制所有开关
Switch_DrawAll();
// 显示文字说明：所有开关初始状态
Switch_PrintAllStatus();
// 在触摸处理中：
widget_switch_id = Switch_HandleTouch(touch_x, touch_y);
if(widget_switch_id > 0) {
// 切换对应开关的状态
switches.state = !switches.state;
// 重绘被触发的开关
Switch_Draw(widget_switch_id);
// 更新状态显示
Switch_PrintStatus(widget_switch_id);
}
外观定制
开关外观可通过修改default_style结构体进行定制，包括：
[*]尺寸：通过SWITCH_HEIGHT调整基准高度，宽度自动按比例计算
[*]倒角：通过SWITCH_CORNER调整按钮圆角
[*]偏移量：通过SWITCH_OFFSET调整边框宽度
[*]颜色：
- bgColor：背景色（关闭状态）
- selectBgColor：选中背景色（打开状态）
- textbgColor：文字颜色（关闭状态）
- textselectBgColor：选中文字颜色（打开状态）
- switchColor：滑块颜色
- borderColor：边框颜色
注意事项
[*]使用前确保已正确初始化SPI、RA8889和GT911
[*]开关数量不要超过MAX_SWITCHES_NUM定义的最大值
[*]放置开关时注意坐标不要超出屏幕范围
[*]触摸处理应在中断或主循环中周期性调用
六、控件源码下载
请至菜单栏：组件与控件中心
七、视频演示
https://www.bilibili.com/video/BV1kndXYvEbE/?share_source=copy_web&vd_source=c0cd4c87f6dcc19bcebab2f4cf3c40db
页:
[1]