SPMI 概览

概念

系统电源管理接口 (SPMI) 是一种总线，最多可有 4 个控制器设备通过该总线与最多 16 个目标设备通信，以完成不同的电源管理任务。每个控制器和目标设备都有一个最多 16 位的地址空间，该地址空间由 8 位寄存器组成，其功能由硬件供应商定义。

虽然不属于 SPMI 规范，但具有多种功能的一些目标设备可以进一步划分为子目标设备，这些子目标设备对目标设备的地址空间具有有限的视图。对设备功能进行逻辑分离，可让相应的软件驱动程序也实现分离。

编写 SPMI 客户端驱动程序

从客户端驱动程序使用 SPMI 取决于您打算使用的设备是目标还是子目标。无论哪种情况，要使用的 FIDL 协议都是 fuchsia.hardware.spmi.Device。

目标设备

首先，更新主板驱动程序，以便 SPMI 控制器驱动程序为您的目标添加节点。在设备树平台中，这会涉及添加一个新节点，例如：

#include "sdk/lib/driver/devicetree/visitors/drivers/spmi-controllers/spmi/spmi.h"

spmi@0xffff0000 {
    /* The new node is below */
    $TARGET_DEVICE_TYPE@$TARGET_ID {
        reg = <$TARGET_ID_0 SPMI_USID>, <$TARGET_ID_1 SPMI_USID>;
        reg-names = "$TARGET_NAME_0", "$TARGET_NAME_1";
    };
};

一个目标可以有多个 reg 条目（最多 16 个），从而允许单个设备树节点表示多个 SPMI 目标 (SID)。

驱动程序应连接到 fuchsia.hardware.spmi.TargetService，并在其组件清单中包含相应条目。SPMI 控制器驱动程序将为每个目标添加一个节点。SPMI 访问者将为您的设备生成一个复合节点规范，其中每个目标都有一个父级，并为每个父级使用以下绑定属性：

属性 可选 用途
fuchsia.hardware.spmi.TargetService 否 SPMI 目标服务。
fuchsia.spmi.TARGET_ID 否 SPMI 目标 ID。
fuchsia.spmi.TARGET_NAME 是 目标的字符串名称。在设备树平台中，此名称是从目标节点的 reg-names 属性生成的。如果定义了多个目标，则使用 reg-names 中的相应名称。

子目标设备

首先，更新主板驱动程序，以便 SPMI 控制器驱动程序为您的子目标添加节点。在设备树平台上，这需要添加一个新节点，例如：

#include "sdk/lib/driver/devicetree/visitors/drivers/spmi-controllers/spmi/spmi.h"

spmi@0xffff0000 {
    $TARGET_DEVICE_TYPE@$TARGET_ID {
        reg = <$TARGET_ID SPMI_USID>;
        reg-names = "$TARGET_NAME";

        /* Your driver's node is below */
        $SUB_TARGET_DEVICE_TYPE@$SUB_TARGET_ADDRESS {
            compatible = "$COMPATIBLE"
            reg = <$SUB_TARGET_ADDRESS $SUB_TARGET_SIZE>;
            reg-names = "$SUB_TARGET_NAME";
        };
    };
};

如果驱动程序节点必须是某个其他总线的子节点，您还可以通过 spmis 引用属性访问子目标。例如：

#include "sdk/lib/driver/devicetree/visitors/drivers/spmi-controllers/spmi/spmi.h"

$BUS@0xffff1000 {
    /* Your driver's node is below */
    $BUS_CHILD {
        compatible = "$COMPATIBLE"
        spmis = <&$SUB_TARGET_LABEL>;
    };
};

spmi@0xffff0000 {
    $TARGET_DEVICE_TYPE@$TARGET_ID {
        reg = <$TARGET_ID SPMI_USID>;
        reg-names = "$TARGET_NAME";

        /* This is the sub-target your driver can access */
        $SUB_TARGET_LABEL: $SUB_TARGET_DEVICE_TYPE@$SUB_TARGET_ADDRESS {
            reg = <$SUB_TARGET_ADDRESS $SUB_TARGET_SIZE>;
            reg-names = "$SUB_TARGET_NAME";
        };
    };
};

驱动程序应连接到 fuchsia.hardware.spmi.SubTargetService，并在其组件清单中包含相应条目。SPMI 控制器驱动程序将为您的子目标或引用属性添加一个节点，并包含以下绑定属性：

属性 可选 用途
fuchsia.hardware.spmi.SubTargetService 否 SPMI 子目标服务。
fuchsia.spmi.TARGET_ID 否 包含相应子目标的目标的 ID。
fuchsia.spmi.TARGET_NAME 是 包含相应子目标的目标的字符串名称。在设备树平台中，此名称是从目标节点的 reg-names 属性生成的。
fuchsia.spmi.SUB_TARGET_ADDRESS 否 相应子目标在目标中的起始地址。
fuchsia.spmi.SUB_TARGET_NAME 是 子目标的字符串名称。在设备树平台中，此值是从子目标节点的 reg-names 属性生成的。

通过 fuchsia.hardware.spmi.Device 注册的访问权限将映射到子目标的起始地址，并限制在分配给子目标的范围内。

子目标和父目标都可以有多个 reg 条目，但不能同时使用：具有多个 SID 的父目标不得有子目标。如果父目标有子目标，则必须只有一个 SID，不过子目标本身仍然可以有多个 reg 条目（区域）。

子目标设备树绑定

SPMI 设备树访问器禁止以下操作：

  • spmis 属性中引用的目标节点
  • 具有 compatible 属性且在 spmis 属性中被引用的子目标节点
  • 被多个其他节点中的 spmis 属性引用的子目标节点

编写 SPMI 控制器驱动程序

SPMI 控制器驱动程序负责根据从主板驱动程序收到的 fuchsia.hardware.spmi.ControllerInfo 元数据设置子节点。

目标设备

对于 ControllerInfo 中没有 sub_targets 的每个 TargetInfo，控制器驱动程序应添加一个提供 fuchsia.hardware.spmi.TargetService 且具有以下属性的子节点：

属性 值
fuchsia.spmi.CONTROLLER_ID ControllerInfo 中的 id（如果已指定）
fuchsia.spmi.TARGET_ID id（在 TargetInfo 中）
fuchsia.spmi.TARGET_NAME TargetInfo 中的 name（如果已指定）

子目标设备

对于 ControllerInfo 中每个 TargetInfo 中的每个 SubTargetInfo，控制器驱动程序应添加一个提供 fuchsia.hardware.spmi.SubTargetService 且具有以下属性的子节点：

属性 值
fuchsia.spmi.CONTROLLER_ID ControllerInfo 中的 id（如果已指定）
fuchsia.spmi.TARGET_ID id（在 TargetInfo 中）
fuchsia.spmi.TARGET_NAME TargetInfo 中的 name（如果已指定）
fuchsia.spmi.SUB_TARGET_ADDRESS address（在 SubTargetInfo 中）
fuchsia.spmi.SUB_TARGET_NAME SubTargetInfo 中的 name（如果已指定）

控制器驱动程序应将对子目标的寄存器访问限制在 [0, size) 范围内，并按 address 对其进行偏移。

资源