SPMI 概览

概念

SPMI 是一根总线，最多可有 4 个 控制器设备可与多达十六个目标设备通信 完成不同的电源管理任务。每个控制器和目标设备 最多包含 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 SPMI_USID>;
        reg-names = "$TARGET_NAME";
    };
};

您的驱动程序应连接到 fuchsia.hardware.spmi.TargetService， 并且在其组件清单中具有相应的条目SPMI 控制器驱动程序 将为您的目标添加一个具有以下绑定属性的节点：

属性 可选 用途
fuchsia.hardware.spmi.TargetService 否 SPMI 目标服务。
fuchsia.spmi.TARGET_ID 否 SPMI 目标 ID。
fuchsia.spmi.TARGET_NAME 是 目标的字符串名称。在设备树平台上，这是通过目标节点的 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 进行的寄存器访问将映射到子目标的起始地址，并且仅限于分配给子目标的范围。

子目标设备树绑定

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。

资源