本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：本文深入分析了在Android系统中，特别是在MediaTek（mtk）平台上，传感器驱动和框架的重要性及其工作原理。重点讲解了 hwmsen_dev.c 文件中的传感器驱动核心代码，如何连接驱动程序与硬件，处理中断和数据读写，以及如何适配特定芯片组。同时，介绍了Android系统层面的传感器框架，包括SensorService服务、JNI交互以及SensorManager API的使用。强调了理解传感器驱动和Android框架对于开发感知应用和硬件性能优化的重要性。
mtk sensor 传感器驱动及安卓层框架

1. Android系统传感器驱动核心

传感器是现代移动设备中不可或缺的组件，对于Android系统而言，传感器驱动程序是连接硬件和软件的桥梁。在本章中，我们将探讨Android系统传感器驱动的核心要素，包括其工作原理、关键文件及其在Linux内核中的适配。

1.1 Android传感器驱动概述

传感器驱动程序负责从硬件传感器读取数据，并将其转换为操作系统可以理解和使用的格式。Android系统采用了分层的驱动架构，使得驱动程序可以更专注于硬件交互，同时与上层应用进行有效通信。

1.2 传感器驱动的重要性

对于移动设备，传感器提供了用户与设备交互的新维度，如加速度计、陀螺仪、接近传感器等。这些传感器的数据对于应用程序来说是至关重要的，比如运动跟踪、屏幕方向调整等。因此，高效的传感器驱动不仅提升了用户体验，而且对于应用开发者来说，也是必不可少的工具。

1.3 传感器驱动的挑战

随着技术的进步，传感器的种类和功能日益增加，对传感器驱动程序提出了更高的要求。如何在保证性能的同时，降低功耗，成为传感器驱动开发者必须面对的问题。本系列文章将逐一分析传感器驱动的各个方面，带领读者深入了解Android系统传感器驱动的核心技术。

2. hwmsen_dev.c文件分析

2.1 hwmsen_dev.c结构概述

2.1.1 hwmsen_dev.c代码组成

hwmsen_dev.c是Android系统中负责硬件传感器设备驱动的核心文件，主要负责对硬件传感器进行操作。它位于Android开源项目的 hardware/libhardware/modules/sensors 目录下。该文件的代码主要分为以下几个部分：

  • 设备初始化与注销
  • 传感器事件的读取和报告
  • 中断处理和传感器数据同步
  • 功率管理和休眠唤醒机制
  • 设备属性和配置接口

代码的编写采用C语言，并且使用了Android硬件抽象层(HAL)的接口。hwmsen_dev.c文件中的核心功能是实现 hw_module_t 和 hw_device_t 这两个结构体的实例化，并定义了操作这些实例的函数。 

#include <hardware/hardware.h>
#include <hardware/sensors.h>

struct sensors_module_t HAL_MODULE_INFO_SYM = {
    .common = {
        .tag = HARDWARE_MODULE_TAG,
        .module_api_version = SENSORS_MODULE_API_VERSION_0_1,
        .hal_api_version = HARDWARE_MODULE_API_VERSION(0, 1),
        .id = SENSORS_HARDWARE_MODULE_ID,
        .name = "Android Sensors HAL",
        .author = "The Android Open Source Project",
    },
    .get_sensors_list = get_sensors_list,
    .get_sensors_event = get_sensors_event,
    .set_delay = set_delay,
    .batch = batch,
    .flush = flush,
    .activate = activate,
};

上面的代码块展示了 hw_module_t 结构体在hwmsen_dev.c文件中的实例化，其中包含了模块的基本信息和核心函数指针。每个函数指针都对应于特定的HAL接口函数，这些函数将被上层调用来与硬件设备进行交互。

2.1.2 主要函数及其功能

hwmsen_dev.c文件中的主要函数包括：

  • get_sensors_list ：获取传感器列表，返回系统中可用传感器的信息。
  • get_sensors_event ：获取传感器事件，负责从硬件读取数据并转换为事件结构体。
  • set_delay ：设置传感器数据的采样率。
  • batch ：用于启用批量数据读取模式。
  • flush ：清空所有等待上报的传感器数据。
  • activate ：激活或禁用传感器，调整传感器的工作状态。

这些函数构成了传感器驱动的基础框架，通过它们，应用层和系统服务层可以管理传感器的状态和数据流。

2.2 hwmsen_dev.c中的关键数据结构

2.2.1 数据结构定义与作用

在hwmsen_dev.c文件中，数据结构主要用于定义和管理传感器相关的数据。其中，几个关键的数据结构包括： 

struct sensors_module_t {
    struct hw_module_t common;
    sensors_module_get_sensors_list_t get_sensors_list;
    sensors_module_get_sensors_event_t get_sensors_event;
    sensors_module_set_delay_t set_delay;
    sensors_module_batch_t batch;
    sensors_module_flush_t flush;
    sensors_module_activate_t activate;
};

struct sensors_event_t {
    int32_t version;
    int32_t sensor;
    int32_t type;
    int64_t timestamp;
    union {
        struct {
            float x, y, z;
        }加速计;
        // ... 其他传感器事件数据
    }数据;
};

struct sensors_module_t 结构体定义了传感器模块的所有操作接口，而 struct sensors_event_t 则用于表示从传感器硬件读取到的事件数据。这些数据结构是驱动程序与上层应用进行数据交换的基础。

2.2.2 数据结构在驱动中的应用实例

为了进一步阐述数据结构在驱动中的应用，我们可以通过一个实例来查看 get_sensors_list 函数的实现。这个函数需要遍历所有已注册的传感器并返回它们的信息。 

static int sensors_get_sensors_list(struct sensors_module_t* module, struct sensors_list_t* list) {
    struct sensors_list_t* sensors_list_ptr = list;
    int count = 0;
    for (int i = 0; i < SENSOR_MAX; i++) {
        if (sensor_data[i].enabled) {
            sensors_list_ptr->sensors[count] = &sensor_data[i];
            count++;
        }
    }
    sensors_list_ptr->count = count;
    return 0;
}

在这个函数中， sensor_data 数组包含了所有传感器的元数据， sensors_list_ptr 用于构建一个传感器列表结构体 struct sensors_list_t ，它将被返回给调用者。这样，上层应用就可以知道系统支持哪些传感器，并根据这些信息来初始化它们。

数据结构在驱动中的应用不仅仅限于数据的存储和传递，还包括对硬件设备状态的管理以及上层接口的抽象。通过合理设计数据结构，可以极大地提升代码的可读性和维护性。

3. Linux内核设备模型适配

Linux内核设备模型是操作系统中一个核心的组成部分，它为驱动程序和硬件设备提供了一个统一的框架，确保设备可以被系统发现、管理并提供服务。Android作为基于Linux内核的操作系统，在设备驱动的开发中，同样依赖于这一模型来实现其传感器驱动的适配。

3.1 Linux设备模型基础

3.1.1 设备模型的核心概念

Linux设备模型以设备（device）、总线（bus）、驱动（driver）和设备类（class）这四个核心概念为基础。

  • 设备（Device） ：代表系统中的一个硬件组件。
  • 总线（Bus） ：是连接设备和驱动的桥梁，设备和驱动都注册到总线上。
  • 驱动（Driver） ：向内核注册，提供操作硬件的接口。
  • 设备类（Class） ：根据设备的功能和用途进行分类，提供了统一的接口供用户空间程序访问。

这一层次化的模型，不仅提高了代码的可维护性，还有助于系统管理设备。

3.1.2 驱动与设备的关联机制

驱动和设备之间的关联，依赖于内核提供的匹配机制。驱动通过定义一组ID表来表明它可以支持哪些设备，这些ID包括供应商ID、产品ID等。当设备被发现时，内核会遍历所有已加载的驱动，并用设备ID与驱动ID表进行匹配，找到合适的驱动程序。

例如，对于传感器设备，一个典型的ID匹配过程如下： 

static const struct of_device_id sensor_ids[] = {
    { .compatible = "vendor,model" },
    { },
};

MODULE_DEVICE_TABLE(of, sensor_ids);

这段代码展示了如何在驱动中定义一个设备ID表，并将之与模块表关联。这样，当内核发现一个与 sensor_ids 中的 compatible 字段匹配的设备节点时，就会加载对应的驱动。

3.2 Android中Linux内核传感器适配

3.2.1 传感器设备在Linux内核中的注册

在Android中，传感器设备通常是以I2C、SPI或platform总线的形式连接到系统。传感器设备在Linux内核中的注册主要通过设备树（Device Tree）来完成。设备树描述了硬件设备的层次结构和属性信息，使得内核能够在启动时读取这些信息，识别并初始化设备。

以下是一个简单的设备树节点示例，描述了如何在设备树中注册一个I2C传感器设备： 

/ {
    ...
    i2c@1000 {
        compatible = "vendor,sensor型号";
        reg = <0x00 0x10>;
        interrupts = <GIC_SPI 192 IRQ_TYPE_LEVEL_HIGH>;
        pinctrl-names = "default";
        pinctrl-0 = <&sensor_pinctrl>;
        status = "okay";
    };
    ...
};

在上述代码中， i2c@1000 表示I2C总线上的设备节点， compatible 定义了匹配的驱动， reg 定义了设备的寄存器地址， interrupts 定义了中断信息。

3.2.2 驱动与硬件抽象层(HAL)的交互

传感器驱动与HAL的交互是Android系统中实现传感器功能的关键步骤。HAL层提供了一组标准的API供应用层调用，而驱动层则需要实现这些API对应的功能。

传感器驱动通常需要实现以下HAL回调函数： 

static struct sensors_classdev sensors_cdev = {
    .name = "accelerometer",
    .sensor_api_version = SENSORS_CLASSDEV_API_VERSION_1,
    .handle = SENSORS_HANDLE_ACCELEROMETER,
    .enable = sensorsAccelerometerEnable,
    .get_name = sensorsAccelerometerGetTypeName,
    .getVendor = sensorsAccelerometerGetVendor,
    .getType = sensorsAccelerometerGetTypeId,
    .getResolution = sensorsAccelerometerGetResolution,
    .getMaxRange = sensorsAccelerometerGetMaxRange,
    .getMinDelay = sensorsAccelerometerGetMinDelay,
    .poll = sensorsAccelerometerPoll,
    .getMeasurementRange = sensorsAccelerometerGetMeasurementRange,
    .setDelay = sensorsAccelerometerSetDelay,
    .setFrequency = sensorsAccelerometerSetFrequency,
    .activate = sensorsAccelerometerActivate,
    .version = 1,
};

HAL层通过这些回调函数与驱动层进行通信，获取传感器数据和控制传感器的行为。驱动层在初始化过程中注册这些回调函数，并通过sysfs文件系统或设备属性接口暴露给HAL层。

通过内核设备模型适配，Android系统能有效地管理传感器设备，确保传感器数据的准确采集和传输，从而支持各类应用场景的需求。

4. 中断处理与电源管理

4.1 中断处理机制分析

4.1.1 中断处理流程概述

在嵌入式系统和操作系统中，中断处理是关键的一部分，它允许系统快速响应外部或内部事件。中断处理流程大致可以分为以下几个步骤：

  1. 中断发生：硬件设备通过发送信号到中断控制器表明需要服务。
  2. 中断识别：中断控制器识别中断源，并决定哪个处理器（在多处理器系统中）或处理器核心（在多核处理器系统中）应当响应该中断。
  3. 中断分派：CPU暂停当前任务，保存当前的执行状态。
  4. 中断服务程序（ISR）执行：执行与特定中断源关联的中断处理函数。
  5. 恢复环境：ISR执行完毕后，恢复之前保存的状态，继续之前的任务。

在Android系统中，传感器驱动的中断处理通常涉及到读取传感器数据，并将这些数据通知到上层应用。这一过程需要优化以减少延时和能耗。

4.1.2 中断处理中的优化策略

中断处理的优化是提高系统性能和效率的关键。以下是几种常见的优化策略：

  • 中断合并：合并多个中断信号为一个，减少中断处理次数。
  • 动态中断使能/禁用：在不必要时关闭中断，以降低能耗和提高处理效率。
  • 中断优先级调整：根据系统的实时需求，动态调整中断优先级。
  • 中断共享：将多个中断源绑定到同一个中断处理函数上，减少ISR的编码和维护工作。

具体到代码层面上，下面是一个简单的例子来展示如何在Linux内核中注册一个中断服务函数。 

// 假设我们有一个名为example_irq的中断处理函数
static irqreturn_t example_irq(int irq, void *dev_id)
{
    // 处理中断的代码

    return IRQ_HANDLED; // 表示中断已被处理
}

// 注册中断
int request_irq(unsigned int irq, irq_handler_t handler, unsigned long flags,
                const char *name, void *dev)
{
    // 注册中断的代码

    return 0;
}

// 示例使用
void setup_irq()
{
    int irq = 11; // 假设硬件中断号为11

    // 注册中断处理函数
    request_irq(irq, example_irq, IRQF_SHARED, "example_irq", NULL);
}

在上述代码中，我们定义了一个名为 example_irq 的中断处理函数，并通过 request_irq 函数注册了这个中断。注意，实际使用中要确保正确的中断号、处理函数和参数。

4.2 电源管理策略实施

4.2.1 电源管理的原理与重要性

电源管理是指对设备的能源使用进行优化，以延长电池寿命，减少能耗。在Android系统中，传感器驱动的电源管理非常关键，因为传感器通常工作在移动设备上，这些设备的电池容量有限。

电源管理策略通常包括以下几个方面：

  • 动态电压和频率调整（DVFS）：根据负载动态调整处理器的电压和频率。
  • 睡眠模式：将处理器或外设置于低功耗模式，直到它们被唤醒。
  • 电源门控：关闭未使用组件的电源。

为了在Android系统中实施有效的电源管理，通常需要在内核层面进行配置和编程，以支持这些高级电源管理功能。

4.2.2 传感器驱动中的电源管理实现

在Android系统中，传感器驱动的电源管理通常通过控制传感器的工作状态来实现。例如，当传感器不再需要时，可以将它们置于低功耗模式或关闭电源。

下面是一个简化的例子来说明如何在驱动中实现电源管理。 

// 假设有一个传感器电源控制的函数
void sensor_power_enable(int sensor_id, bool enable)
{
    if (enable) {
        // 启动传感器电源
        enable_sensor_power(sensor_id);
    } else {
        // 关闭传感器电源
        disable_sensor_power(sensor_id);
    }
}

// 启动传感器电源
void enable_sensor_power(int sensor_id)
{
    // 根据sensor_id打开对应的电源线
}

// 关闭传感器电源
void disable_sensor_power(int sensor_id)
{
    // 根据sensor_id关闭对应的电源线
}

// 使用传感器时，调用sensor_power_enable函数开启电源
sensor_power_enable(sensor_id, true);

// 不使用传感器时，调用sensor_power_enable函数关闭电源
sensor_power_enable(sensor_id, false);

代码中 sensor_power_enable 函数控制传感器的电源。 enable_sensor_power 和 disable_sensor_power 函数具体执行打开或关闭电源线的操作。这些操作通过写入硬件寄存器或发送控制命令来实现。

实际上，电源管理是一个复杂的主题，通常需要根据具体的硬件设备和内核版本进行详细的定制和优化。在多传感器设备中，电源管理还可以通过整合所有传感器的电源状态，来进一步优化电池寿命。

5. Android传感器系统框架

5.1 Android传感器系统架构

5.1.1 系统框架组成

Android传感器系统架构是构建在Linux内核之上的，它为应用层提供了丰富的接口，使开发者能够轻松获取各种传感器数据。系统框架主要由以下几部分组成：

  • 传感器驱动层 ：位于Linux内核中，负责与硬件传感器通信，通常包含hwmsen_dev.c等驱动文件，是整个系统与硬件交互的基础。

  • 硬件抽象层(HAL) ：位于用户空间，是一个抽象层，提供统一的API接口给上层应用。HAL层负责将内核层的原始数据转换成应用层可以理解的格式。

  • 系统服务层 ：包括SensorService服务，它负责管理HAL层，并提供跨应用的传感器数据共享和管理。

  • 应用层API ：提供给开发者使用的接口，如Android SDK中的SensorManager和Sensor类，允许应用程序访问传感器数据。

通过这些层次分明的架构设计，Android能够在保持代码清晰、易于维护的同时，为用户带来丰富的传感器功能体验。

5.1.2 各层之间的通信机制

通信机制是保证系统各层之间顺畅交互的关键。在Android传感器系统中，各层之间的通信主要通过以下方式：

  • 内核空间与用户空间的通信 ：通过 ioctl 系统调用实现。传感器驱动将数据通过 ioctl 传递给HAL层。

  • HAL层与系统服务层 ：通过本地方法调用（JNI）和 Binder 进程间通信（IPC）机制。HAL层会提供一个动态链接库（.so 文件），SensorService通过Binder IPC调用HAL层提供的方法。

  • 系统服务层与应用层 ：通过Binder IPC机制。应用层通过Android SDK提供的API，间接通过Binder与SensorService通信，获取传感器数据。

为了保持通信的高效性和低延迟，系统精心设计了数据流路径和处理机制，确保传感器数据能快速准确地传递给需要的组件。

5.2 传感器数据采集与处理流程

5.2.1 数据采集的步骤与方法

传感器数据的采集流程大致可以分为以下几个步骤：

  1. 初始化传感器 ：系统启动时，传感器驱动程序会被加载，同时HAL层和系统服务层也会初始化相关组件。

  2. 注册传感器 ：应用程序通过调用SensorManager的 registerListener 方法注册对特定类型传感器的关注。

  3. 采样 ：传感器驱动按照预设的频率采集传感器数据。

  4. 数据上报 ：采集到的数据通过内核空间传递到用户空间的HAL层，HAL层将数据格式化，并通过Binder IPC机制上报给SensorService。

  5. 数据处理 ：SensorService处理这些数据，包括缓存、滤波等操作，并准备好向应用程序提供数据。

  6. 回调通知 ：最终，经过处理的数据通过Binder IPC机制传递给注册的监听器（应用程序），并触发回调函数。

5.2.2 数据处理的策略与技术

为了确保数据的准确性和可用性，数据处理环节采取了多种策略和技术：

  • 滤波技术 ：如滑动窗口平均滤波、加权平均滤波等，用于去除噪声，平滑数据曲线。

  • 校准算法 ：对传感器数据进行偏差校准，提高数据的准确性。

  • 数据融合 ：将来自多个不同类型的传感器的数据进行整合处理，提供更全面的环境信息。

  • 阈值检测 ：对特定类型的传感器数据进行实时监测，当数据超出正常范围时触发相应的事件或操作。

  • 事件触发机制 ：基于数据变化或时间间隔来触发数据采集与上报，优化系统性能。

综上所述，Android传感器系统通过一套完善的架构设计和数据处理机制，实现了从原始数据采集到应用层的高效流通，确保了传感器数据的准确获取和应用。

6. 应用层与系统服务层传感器框架

6.1 Sensor.java与SensorService交互

6.1.1 Sensor.java的角色与功能

在Android系统中， Sensor.java 扮演着应用层中传感器数据访问的关键角色。它是一个桥梁，通过它应用可以与系统服务 SensorService 进行通信，来获取传感器数据或者注册传感器数据监听器。 Sensor.java 内部定义了多个传感器类型、数据处理方法和回调机制，使得应用程序可以方便地访问和使用各种传感器。

Sensor.java 还封装了对 SensorManager 的调用，提供了一系列方法供应用程序获取传感器服务、注册和注销监听器等。当应用程序调用 SensorManager 的方法时，其背后正是通过 Sensor.java 与 SensorService 进行实际的交互。

6.1.2 SensorService的作用与交互机制

SensorService 是Android系统服务层的一部分，它运行在系统进程当中，负责管理传感器硬件。它处理来自 Sensor.java 的请求，并与内核中的驱动程序交互，执行具体的传感器数据采集工作。

交互机制主要是通过Binder机制完成的。当应用通过 SensorManager 发起请求时，请求会通过Binder通信发送给 SensorService 。 SensorService 根据请求内容，调用相应的硬件抽象层(HAL)接口与驱动交互，完成数据获取或者设置。获取到的数据再次通过Binder返回给应用程序。

6.2 应用层传感器框架细节

6.2.1 应用层传感器API介绍

应用层的传感器API主要通过 SensorManager 类来实现。 SensorManager 提供了丰富的API，允许应用注册监听特定类型的传感器变化，或者根据需要获取历史数据。此外， SensorManager 还提供了传感器校准、数据转换及类型转换等功能。

例如，使用 SensorManager 注册一个加速度传感器监听器的代码片段如下： 

SensorManager sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
Sensor accelerometer = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);

SensorListener listener = new SensorListener() {
    @Override
    public void onAccuracyChanged(Sensor sensor, int accuracy) {
        // 处理传感器精度变化
    }

    @Override
    public void onSensorChanged(SensorEvent event) {
        // 处理传感器数据变化
    }
};

sensorManager.registerListener(listener, accelerometer, SensorManager.SENSOR_DELAY_NORMAL);

6.2.2 高级传感器功能的实现与应用实例

高级传感器功能通常包括传感器数据的融合处理、自定义传感器事件处理等。实现这些功能需要对 SensorManager 和 SensorEvent 有深入的理解。

例如，通过多个传感器数据的融合，可以实现应用层面的运动跟踪。这需要同时监听加速度传感器、陀螺仪传感器等，然后通过算法分析这些数据，以识别用户的运动模式。 

// 示例中，可能需要创建自定义的算法来处理多个传感器数据
public class MotionTracker {
    // ...自定义算法细节
}

6.3 系统服务层传感器框架细节

6.3.1 系统服务层框架结构

系统服务层的传感器框架是一个复杂的结构，它包含了多个组件，例如 SensorService 、 SensorManager 以及背后与硬件交互的HAL层。这个框架不仅处理应用层的请求，还要负责管理传感器设备的生命周期、数据同步、事件分发等工作。

6.3.2 服务层框架中的关键组件与数据流向

关键组件包括传感器管理器( SensorManager )、传感器事件监听器( SensorListener )、传感器( Sensor )以及HAL接口。数据流向大体上是：

  • 应用层调用 SensorManager 的相关API。
  • SensorManager 向 SensorService 请求操作。
  • SensorService 处理请求，调用HAL层接口与驱动交互。
  • 驱动程序采集传感器数据后，通过HAL层回调 SensorService 。
  • SensorService 更新传感器状态，将数据分发给注册的监听器。

最终，应用层通过回调方法接收处理传感器数据。整个数据流中，每个组件都发挥着其不可或缺的作用，确保了数据的准确性和实时性。

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：本文深入分析了在Android系统中，特别是在MediaTek（mtk）平台上，传感器驱动和框架的重要性及其工作原理。重点讲解了 hwmsen_dev.c 文件中的传感器驱动核心代码，如何连接驱动程序与硬件，处理中断和数据读写，以及如何适配特定芯片组。同时，介绍了Android系统层面的传感器框架，包括SensorService服务、JNI交互以及SensorManager API的使用。强调了理解传感器驱动和Android框架对于开发感知应用和硬件性能优化的重要性。


本文还有配套的精品资源，点击获取
menu-r.4af5f7ec.gif

Logo
天工造物局

北京人形旗下天工造物具身智能开源社区，聚焦具身天工与慧思开物两大平台

更多推荐

deck.gl TripsLayer 出租车轨迹动画示例实战：从示例运行到着色器原理

TripsLayer 是 deck.gl 中用于渲染**随时间流动的轨迹动画**（如出租车行程、物流路径、迁徙路线）的核心图层。本文以仓库中的最小独立示例 [examples/website/trips](https://link.gitcode.com/i/1442af8f442f4cff39ff546e050fceb5) 为骨架，带你完成从安装依赖、启动应用、理解曼哈顿出租车数据格式，到深入

avatar 天工造物局

Foundry Anvil 中 eth_simulateV1 的 Blob 交易与 Blob Gas 字段规范化：原理、实现与测试验证

本篇技术指南以 [anvil-simulate-blob-transactions.md](https://link.gitcode.com/i/3d2ebe227262de169335eb290af80da8) 这条 changelog 条目为起点，深入剖析 Foundry Anvil 对 `eth_simulateV1` RPC 返回结果中 blob（EIP-4844）交易与 blob gas

avatar 天工造物局

LMCache CLI 实战：用 `lmcache kvcache clear` 管理运行中服务的 KV Cache 状态

本文是一份针对 LMCache 官方 CLI 命令 `lmcache kvcache` 的完整技术指南。该命令用于在**运行中的 LMCache 服务（MP HTTP server）**上管理 KV cache 状态，当前提供 `clear` 子命令，用于清空 L1（CPU 内存）层中缓存的全部 KV 数据。读完本文，你将掌握该命令的完整参数体系、退出码语义、终端/JSON/静默三种输出模式，并能

avatar 天工造物局