在智能设备的人机交互界面中,记事本功能是基础且重要的应用场景。本教程将基于STM32F4和LVGL库,在3.5英寸ILI9486显示屏上实现完整的记事本功能,包含文本输入、虚拟键盘、内容清除等核心功能。
目录
一、硬件连接(同电子书教程)
二、软件UI组件实现
三、零知IDE配置(同电子书教程)
四、演示效果
五、常见问题解决
六、总结与扩展
一、硬件连接(同电子书教程)
硬件连接方式与电子书阅读器完全一致,请参考系列教程(一)的硬件连接部分。显示屏直接插入零知增强板专用接口,无需额外连线。
系列教程直达:零知开源——STM32F4实现ILI9486显示屏UI界面系列教程(一):电子书阅读器功能
ILI9486扩展板显示屏及记事本UI页面图:
二、软件UI组件实现
2.1 核心功能实现
lv_obj_t *win = create_app_win("NotePad");lv_coord_t hres = lv_disp_get_hor_res(NULL);lv_coord_t vres = lv_disp_get_ver_res(NULL);lv_coord_t header_height = 32; // 标题栏高度// 创建文本区域lv_obj_t *ta = lv_ta_create(win, NULL);lv_obj_set_size(ta, hres - 40, (vres - header_height) / 2);lv_obj_align(ta, NULL, LV_ALIGN_IN_TOP_MID, 0, header_height + 10);lv_ta_set_text(ta, "");lv_ta_set_cursor_type(ta, LV_CURSOR_BLOCK);lv_ta_set_placeholder_text(ta, "Type your note here...");lv_ta_set_sb_mode(ta, LV_SB_MODE_AUTO);// 创建键盘 - 使用更小的键盘节省空间lv_obj_t *kb = lv_kb_create(win, NULL);lv_obj_set_size(kb, hres - 40, (vres - header_height) / 3);lv_obj_align(kb, ta, LV_ALIGN_OUT_BOTTOM_MID, 0, 10);lv_kb_set_ta(kb, ta);// 创建按钮容器 - 简化按钮数量lv_obj_t *btn_cont = lv_cont_create(win, NULL);lv_cont_set_layout(btn_cont, LV_LAYOUT_ROW_M);lv_obj_set_size(btn_cont, hres - 40, 40);lv_obj_align(btn_cont, kb, LV_ALIGN_OUT_BOTTOM_MID, 0, 10);// 只保留清除按钮节省空间lv_obj_t *btn_clear = lv_btn_create(btn_cont, NULL);lv_obj_t *btn_clear_label = lv_label_create(btn_clear, NULL);lv_label_set_text(btn_clear_label, "Clear");lv_obj_set_event_cb(btn_clear, note_clear_event_cb);lv_obj_set_user_data(btn_clear, ta);
2.2 文本区域功能详解
光标控制:
LV_CURSOR_BLOCK
:块状光标,提高可视性
自动光标跟踪:滚动时保持光标可见
触摸精确定位:点击任意位置移动光标
滚动优化:
自动滚动条管理(LV_SB_MODE_AUTO)
平滑滚动动画
长文本分页渲染
占位提示:
引导用户输入的提示文本
输入内容时自动消失
内容清空后重新显示
2.3 清除功能实现
// 清除按钮事件处理
static void note_clear_event_cb(lv_obj_t * btn, lv_event_t event)
{if(event == LV_EVENT_SHORT_CLICKED) {lv_obj_t *ta = (lv_obj_t *)lv_obj_get_user_data(btn);lv_ta_set_text(ta, "");}
}
三、零知IDE配置(同电子书教程)
请参考系列教程(一)的零知IDE配置部分,确保:
- 正确配置LCD屏幕驱动
- 启用触摸屏支持
- 添加LVGL库依赖
关键配置项:
#define LV_USE_TA 1
#define LV_USE_KB 1
#define LV_USE_ANIMATION 1 // 启用动画效果
#define LV_FONT_ROBOTO_16 1 // 启用默认字体
触摸屏校准:
bool my_touchpad_read(lv_indev_drv_t * indev, lv_indev_data_t * data)
{static lv_coord_t last_x = 0;static lv_coord_t last_y = 0;data->state = ts.touched() ? LV_INDEV_STATE_PR : LV_INDEV_STATE_REL;if(data->state == LV_INDEV_STATE_PR){TS_Point p = ts.getPoint();last_x = LV_HOR_RES-(p.y *LV_HOR_RES)/4095; last_y = (p.x *LV_VER_RES)/4095; Serial.print("touched:");Serial.print(last_x);Serial.print(",");Serial.println(last_y);}data->point.x = last_x;data->point.y = last_y;return false;
}
四、演示效果
4.1 功能演示
- 触摸键盘输入英文内容
- 触摸文本区域移动光标
- 滑动查看长文本内容
- 点击清除按钮清空内容
- 大小写和符号键盘切换
4.2 视频效果
STM32F4驱动ILI9486实现记事本功能
记事本界面包含文本编辑区、虚拟键盘和清除按钮
4.3 性能指标
项目 | 数值 | 说明 |
---|---|---|
键盘响应时间 | < 50ms | 从触碰到键盘弹出的延迟 |
内存占用 | 32KB | 包括LVGL核心和文本缓冲区 |
输入响应延迟 | < 30ms | 按键到字符显示的时间 |
最大字符容量 | 无限制 | 动态内存管理 |
触摸精度 | ±3像素 | 键盘按键触发精度 |
五、常见问题解决
▶ 输入卡顿/优化方法
// 在lv_conf.h中增加内存池大小
#define LV_MEM_SIZE (16U * 1024U) // 增加至48KB
#define LV_DISP_DEF_REFR_PERIOD 30 // 降低刷新率至30ms
六、总结与扩展
6.1 实现总结
本教程实现了基础记事本功能:
文本输入与编辑功能
虚拟键盘输入支持
一键清除内容
滚动查看长文本
触摸优化的用户界面
6.2 扩展建议
// 1. 中文输入支持(需外置字库)
void init_chinese_font() {lv_font_t * cn_font = lv_font_load("S:/fonts/simhei_20.bin");static lv_style_t style;lv_style_init(&style);lv_style_set_text_font(&style, LV_STATE_DEFAULT, cn_font);lv_obj_add_style(ta, LV_TEXTAREA_PART_MAIN, &style);
}// 2. 保存到Flash
void save_to_flash() {const char* text = lv_ta_get_text(ta);// 使用W25Q128 Flash芯片存储w25qxx_write_str(0x1000, text);
}// 3. 添加时间戳
void add_timestamp() {char time_str[20];sprintf(time_str, "\n[%02d:%02d]", rtc.getHours(), rtc.getMinutes());lv_ta_add_text(ta, time_str);
}// 4. 云同步功能
void sync_to_cloud() {if(WiFi.status() == WL_CONNECTED) {httpClient.post("/api/notes", lv_ta_get_text(ta));}
}
6.3 下一步
在下一个系列教程中,我们将实现相册浏览功能,支持图片预览和大图查看模式。
✔零知开源是一个真正属于国人自己的开源软硬件平台,在开发效率上超越了Arduino平台并且更加容易上手,大大降低了开发难度。
✔零知开源在软件方面提供了完整的学习教程和丰富示例代码,让不懂程序的工程师也能非常轻而易举的搭建电路来创作产品,测试产品。快来动手试试吧!✔访问零知开源平台,获取更多实战项目和教程资源吧!
www.lingzhilab.com