LVGL -meter的应用

1 meter介绍

lv_meter 是 LVGL v8 引入的一种图形控件，用于创建仪表盘样式的用户界面元素，它可以模拟像速度表、电压表、温度表这类模拟表盘。它通过可视化刻度、指针、颜色弧线等来展示数值信息，是一种非常直观的数据展示控件。

1.1 核心特性

支持多个刻度刻度表（scale）
每个刻度表可以有多个刻度（tick）
每个刻度可以添加多个指针（needle/arc/image）
支持多种类型的指针：线针、弧线、图像
可以设置最小值/最大值和角度范围
动态更新数据值，模拟实时仪表

1.2 lv_meter 的结构组成

在逻辑上，lv_meter 由三个核心部分组成：

刻度盘（scale）
是整个仪表盘的“底盘”。定义了仪表盘的值范围（例如 0 ~ 100）、显示的角度范围（如 270°）、以及刻度线的数量和样式。一个 lv_meter 对象可以拥有多个刻度盘（通常用一个就够了）。
刻度线（ticks）
是刻度盘上的线条，包括主刻度线（粗、带标签）和次刻度线（细、不带标签）。它们用于可视化数据分布，帮助用户读数。可以自定义刻度数量、线宽、颜色、标签间隔等。
指示器（indicator）用于显示当前值。

指示器有三种主要类型：

针状指示器（needle）：像时钟的指针一样旋转。

弧形指示器（arc）：显示某一段范围，常用于区域显示。

图像指针（image）：用图像作为指针，更加美观。

每个指示器都与某个刻度盘绑定，并根据数据自动旋转或变化。

1.3 工作原理

创建仪表：先创建 lv_meter 对象。
添加刻度盘：定义刻度盘的数值范围、角度范围。
设置刻度线：设置次刻度和主刻度的外观。
添加指示器：添加针或弧等指示器来展示当前值。
设置指针值：调用函数实时更新指针的位置或弧度。

1.4 实际用途举例

电动车仪表盘：显示速度、电量、温度等。
工业控制界面：如气压表、水温表、转速表。
医疗设备 UI：心率仪、氧气浓度计等。
智能家居：如空调温度、湿度显示表盘。

2 常见函数介绍

2.1 创建仪表对象

lv_obj_t * meter = lv_meter_create(lv_scr_act());

在这里插入图片描述

2.2 添加刻度盘

lv_meter_scale_t * scale = lv_meter_add_scale(meter);

在这里插入图片描述

2.3 设置刻度盘范围（数值范围 & 角度范围）

lv_meter_set_scale_range(meter, scale, min_value, max_value, angle_range, rotation_offset);

angle_range：刻度盘覆盖的角度
rotation_offset：起始角度
angle = rotation_offset + (value - min) × (angle_range / (max - min))

在这里插入图片描述

2.4 设置刻度线

2.4.1 控制小刻度的数量和外观

lv_meter_set_scale_ticks(meter,scale,tick_num,     // 🟡 刻度线总数（含起点和终点）tick_width,   // 🟢 每条刻度线的宽度（像素）tick_length,  // 🔵 每条刻度线的长度（像素）color         // 🔴 刻度线的颜色
);

tick_num = (max_value - min_value) / 间隔 + 1

在这里插入图片描述

2.4.2 控制主刻度（带数字）的显示

主刻度（Major Ticks），即那些更长、更粗、带有标签文字的刻度线。这类刻度通常用于强调关键数值，如 0、20、40 等。

lv_meter_set_scale_major_ticks(meter,scale,major_tick_every, // 🟡 每隔几个 tick 出现一个主刻度（=多少小刻度间隔）width,             // 🟢 主刻度的线宽length,            // 🔵 主刻度的线长color,             // 🔴 主刻度颜色label_gap          // 🟣 标签（数字）与线之间的像素间距
);

主刻度数 ≈ tick_num / major_tick_every
主刻度值 = min + i * (max - min) / (tick_num - 1) * major_tick_every
在这里插入图片描述

2.5 添加指针

2.5.1 创建一个线状指针

lv_meter_indicator_t * lv_meter_add_needle_line(lv_obj_t *meter,             /* 表盘对象 */lv_meter_scale_t *scale,     /* 对应的刻度盘 */uint16_t width,              /* 指针的线宽，单位：像素 */lv_color_t color,            /* 指针的颜色 */int16_t r_mod                /* 指针的长度相对于半径的比例，0-100 */
);

在这里插入图片描述

2.5.2 创建一个弧形指示器（可用于范围值显示）

lv_meter_indicator_t * arc = lv_meter_add_arc(meter, scale, thickness, color, r_mod);

在这里插入图片描述

2.6 设置指针值

lv_meter_set_indicator_value(meter, indicator, value);

在这里插入图片描述

3 简单示例

3.1 温度

3.1.1 数据标准

温度范围：0°C ~ 100°C
仪表角度范围：270°（从左下到右下）
主刻度每 10°C 一个，次刻度每 5°C 一个
一个红色针状指针
可以通过定时器或动画更新温度值

3.1.2 具体代码

static lv_obj_t* meter;
static lv_meter_indicator_t* needle;/* 模拟温度值更新的回调函数 */
static void update_temperature_cb(lv_timer_t* timer) {static int temp = 0;lv_meter_set_indicator_value(meter, needle, temp);temp = (temp + 1) % 101; // 循环 0 ~ 100
}void create_temperature_meter(void) {/* 创建仪表对象 */meter = lv_meter_create(lv_scr_act());/* 设置大小和位置 */lv_obj_set_size(meter, 200, 200);lv_obj_center(meter);/* 添加刻度盘 */lv_meter_scale_t* scale = lv_meter_add_scale(meter);///* 设置数值范围 0~100°C，角度覆盖 270°，从135°起始 */lv_meter_set_scale_range(meter, scale, 0, 100, 270, 135);/* 设置刻度线（小刻度） */lv_meter_set_scale_ticks(meter, scale, 21, 2, 10, lv_palette_main(LV_PALETTE_GREY));///* 设置主刻度线（带数字标签） */lv_meter_set_scale_major_ticks(meter, scale, 5, 4, 15, lv_color_black(), 10);/* 添加一个红色指针（长度为90%） */needle = lv_meter_add_needle_line(meter, scale, 6, lv_palette_main(LV_PALETTE_RED), 1);lv_meter_indicator_t* arc_green = lv_meter_add_arc(meter, scale,6,lv_palette_main(LV_PALETTE_GREEN), 4); // 线宽6px，圆弧在刻度后面lv_meter_set_indicator_start_value(meter, arc_green, 0);lv_meter_set_indicator_end_value(meter, arc_green, 60);lv_meter_indicator_t* arc_orange = lv_meter_add_arc(meter, scale,6,lv_palette_main(LV_PALETTE_ORANGE), 4);lv_meter_set_indicator_start_value(meter, arc_orange, 60);lv_meter_set_indicator_end_value(meter, arc_orange, 80);lv_meter_indicator_t* arc_red = lv_meter_add_arc(meter, scale,6, lv_palette_main(LV_PALETTE_RED), 4);lv_meter_set_indicator_start_value(meter, arc_red, 80);lv_meter_set_indicator_end_value(meter, arc_red, 100);///* 初始温度设为25°C */lv_meter_set_indicator_value(meter, needle, 25);///* 创建定时器，每500ms更新一次温度 */lv_timer_create(update_temperature_cb, 500, NULL);
}