一、Common PDR header format

所有PDR均包含以下固定格式的头部，后接可变长度的记录数据。头部字段定义如下：

二、PDR Type 

标准PDR类型（1~24）

 三、Terminus Locator PDR

用于将 PLDMTerminusHandle 与唯一标识PLDM终结点（设备或软件）的值关联。其格式包含公共头部和以下特有字段：

字段定义

terminusLocatorValue 字段结构（按类型划分）

1. terminusLocatorType = UID

2. terminusLocatorType = MCTP_EID

3. terminusLocatorType = SMBusRelative

4. terminusLocatorType = systemSoftware

四、Numeric Sensor PDR 概述

用于描述PLDM数值型传感器的语义、单位转换参数及关联实体信息，支持传感器原始数据到标准化单位的转换。其格式包含公共头部和以下特有字段 

字段定义

阈值与稳定性相关字段

可读范围与标称值字段

四、 Numeric Sensor Initialization PDR 

用于配置需要初始化代理（Initialization Agent）初始化的数值型传感器，定义阈值、启用状态及初始化触发条件。其格式包含公共头部和以下特有字段： 

字段定义

阈值字段定义

以下字段的 类型和大小 由 sensorDataSize 决定，值以 传感器原始单位（未经转换） 表示：

 五、State Sensor PDR 概述

用于描述复合状态传感器（Composite State Sensor），包含多个子状态传感器的配置信息，所有子传感器共享同一实体关联。其格式包含公共头部和以下特有字段： 

字段定义

子状态传感器字段（possibleStates）

每个子状态传感器包含以下字段，由 compositeSensorCount 指定数量：

六、 State Sensor Initialization PDR 概述

用于配置复合状态传感器（Composite State Sensor）中子传感器的初始化参数，包括启用状态、事件触发条件及初始状态值。其格式包含公共头部和以下特有字段： 

字段定义

七、 Sensor Auxiliary Names PDR 概述

用于为传感器提供多语言辅助名称（如多语言显示名称），支持单个数值传感器或复合状态传感器（Composite State Sensor）。其格式包含公共头部和以下特有字段： 

字段定义

八、 OEM Unit PDR 概述

用于定义OEM厂商自定义的传感器或执行器单位名称（如特殊测量单位），支持多语言字符串。其格式包含公共头部和以下特有字段： 

字段定义

 九、OEM State Set PDR 

用于定义OEM厂商自定义的状态集（如传感器或执行器的非标准状态），支持多语言状态名称和状态值范围配置。其格式包含公共头部和以下特有字段：

字段定义

OEM State Value Record（状态值记录）

每个记录定义一组连续状态值的名称，格式如下：

十、Numeric Effecter PDR 概述

用于描述PLDM数值型执行器（Numeric Effecter）的配置参数，包括单位转换、初始化策略和实体关联信息。其格式包含公共头部和以下特有字段： 

字段定义

 十一、Numeric Effecter Initialization PDR 概述

用于配置PLDM数值型执行器的初始化参数（如初始值、启用状态及触发条件）。其格式包含公共头部和以下特有字段：

字段定义

 十二、State Effecter PDR 概述

用于描述PLDM复合状态执行器（Composite State Effecter）的配置信息，包括关联实体、状态集支持及初始化策略。其格式包含公共头部和以下特有字段：

字段定义

State Effecter Possible States Fields（状态集支持字段）

每个复合执行器包含一个或多个状态集支持定义，格式如下：

十三、State Effecter Initialization PDR 概述 

用于配置PLDM状态执行器的初始化参数（如初始状态值、启用策略及触发条件），支持单个或复合状态执行器。其格式包含公共头部和以下特有字段：

字段定义

十四、Effecter Auxiliary Names PDR 概述

用于为PLDM执行器（单个或复合）提供多语言辅助名称信息，支持不同语言环境下的名称展示。其格式包含公共头部和以下特有字段：

字段定义

每个执行器的名称信息

每个独立执行器对应一组名称描述字段：

 十五、OEM Effecter Semantic PDR 概述

用于定义OEM厂商自定义的效果器语义（如特定功能或状态描述），支持多语言名称和厂商唯一标识。其格式包含公共头部和以下特有字段：

字段定义

十六、 Entity Association PDR 概述

用于定义实体间的关联关系（如物理或逻辑包含关系），构建实体层次结构。其格式包含公共头部和以下特有字段：

字段定义

容器实体标识信息

被包含实体信息

十七、 Entity Auxiliary Names PDR 概述

用于为PLDM实体实例（单个或范围）提供多语言辅助名称，支持实体在不同语言环境下的标识。其格式包含公共头部和以下特有字段：

字段定义

实体辅助名称信息

十八、 Entity Auxiliary Names PDR 概述

用于为PLDM实体实例（单个或范围）提供多语言辅助名称，支持实体在不同语言环境下的标识。其格式包含公共头部和以下特有字段：

字段定义

实体辅助名称信息

每个实体实例对应一组名称描述字段：

十九、Interrupt Association PDR 概述 

用于建立中断源实体与中断目标实体之间的关联关系，描述中断监控传感器与实体的对应关系。其格式包含公共头部和以下特有字段：

字段定义

目标实体标识信息

源实体标识信息

二十、 Event Log PDR 概述

用于描述PLDM事件日志的存储特性与策略，每个主PDR库仅允许存在一个Event Log PDR。其格式包含公共头部和以下特有字段：

字段定义

1. 日志清除策略

   • fillAndStop（填满停止）：日志满后停止记录新条目。
   • FIFO（先进先出）：日志满后覆盖最旧条目。
   • clearOnAge（基于时间清除）：根据条目时间戳自动清除旧条目。

2. 存储计算规则

   • 总存储空间：logSize仅包含日志条目数据，可能不包含固定开销。
   • 条目开销：若perEntryOverhead=2且条目大小为10字节，则实际占用10+2=12字节（若未隐藏开销）。
   • 分配粒度：若allocationGranularity=16，则24字节条目占用32字节空间（16字节对齐）。

3. 超时与传输管理

   • entryIDTimeout：用于部分传输场景（如大条目分片传输），超时后需重新获取完整条目。
   • 默认超时：若entryIDTimeout=0x01，超时时间与PDR Handle Timeout（规范28.25节）一致。

4. 存储使用监控

   • percentUsedResolution：定义GetPLDMEventLogInfo返回的storagePercentUsed精度。
     • 例如，percentUsedResolution=5时，storagePercentUsed=1表示5%~10%已用。

二十一、FRU Record Set PDR 概述

用于描述与PLDM实体关联的FRU（现场可更换单元）记录集数据特性，支持通过DSP0257规范定义的命令访问FRU数据。其格式包含公共头部和以下特有字段：

字段定义

二十二、 OEM Device PDR 概述

用于存储厂商自定义数据，支持设备或终结点级厂商扩展。每个PDR的厂商数据最大为64 KB，且必须包含至少1字节的VendorSpecificData。其格式包含公共头部和以下特有字段：

字段定义

二十三、OEM PDR 概述

用于存储厂商自定义数据，提供轻量化扩展能力，无需关联终结点或复制到主PDR库。其格式包含公共头部和以下特有字段，厂商数据最大为64 KB，且必须包含至少1字节的VendorSpecificData。

字段定义

1. 与OEM Device PDR的区别

   • OEM PDR：轻量化设计，不关联终结点（无PLDMTerminusHandle字段），不支持复制到主库（无copyPDR字段）。
   • OEM Device PDR：扩展版本，支持终结点关联和主库复制（需额外字段）。

2. 数据长度计算

   • dataLength字段表示数据字节数减1。例如，dataLength=5表示实际数据为6字节。
   • 最大限制：dataLength+1 ≤ 65535 → 实际数据最大65536字节（64 KB）。

3. 唯一性规则

   • 同一PDR库内，vendorIANA和OEMRecordID组合必须唯一。
   • 跨库允许重复：不同PDR库（如设备库与主库）可存在相同vendorIANA和OEMRecordID的PDR。

4. 应用场景

   • 存储静态厂商配置（如设备固件签名、兼容性标识）。
   • 扩展非终结点相关的自定义元数据（如日志格式定义、私有协议参数）

二十四、 Compact Numeric Sensor PDR 概述

专为无需数据转换的简单数值型传感器设计（如温度、计数器），直接报告规范化整数值。其格式包含公共头部和以下特有字段：

字段定义

1. 与标准Numeric Sensor PDR的区别

   • Compact版：仅支持整数值，无数据转换公式，适用于简单场景。
   • 标准版：支持浮点数、线性化公式（如y = mx + b），适用于复杂传感器。

 二十五、Redfish Resource PDR 概述

用于描述Redfish资源的层次结构、路径及模式信息，支持Redfish设备在PLDM架构中的集成管理。其格式包含公共头部和以下特有字段：

字段定义

1. 路径构造规则

   • SubURI：从父资源路径（PP）到当前资源路径（PR）的差值。
     • 示例：若PP为/Chassis/1/NetworkAdapters/1，PR为/Chassis/1/NetworkAdapters/1/NetworkPorts，则SubURI=NetworkPorts。
   • Settings资源：SubURI格式为/settings（仅当ContainingResourceID=EXTERNAL时允许首斜杠）。

2. 层次结构管理

   • 根资源：is_device_root=1且ContainingResourceID=EXTERNAL表示设备逻辑根。
   • 集合资源：is_collection=1表示此资源包含多个子资源（如ProcessorCollection）。

3. 签名与版本控制

   • CRC-32签名：用于验证主模式字典数据的完整性。
   • 模式版本：遵循PLDM版本格式（如0x01020003表示版本1.2.3）。

4. OEM扩展支持

   • 允许关联多个OEM厂商名称，用于标识资源的自定义扩展来源。

 二十六、Redfish Entity Association PDR 概述

用于定义Redfish资源的层次化拓扑关系，描述实体间的父子关联，支持设备组件在PLDM架构中的逻辑管理。其格式包含公共头部和以下特有字段：

字段定义

1. 层次结构构建

   • 父资源：通过ContainingResourceID指向父资源（若为EXTERNAL表示无父资源）。
   • 子资源：通过ContainedEntityResourceID列表绑定子资源，形成树状拓扑。

2. 资源命名建议

   • ProposedContainingResourceName：仅当容器为EXTERNAL时生效，管理控制器（MC）可决定是否接受此命名建议。
   • 格式要求：遵循Redfish标准命名规则（如Namespace.EntityType）。

3. 与Redfish Resource PDR的关系

   • Redfish Resource PDR：定义资源本身的模式、路径及属性。
   • Redfish Entity Association PDR：定义资源间的父子关系，共同构建完整的Redfish资源树。

4. 唯一性规则

   • 所有ContainedEntityResourceID必须指向同一设备内存在的Redfish Resource PDR中的有效ResourceID。
   • 同一容器资源（ContainingResourceID）下，子资源ID不可重复。

 二十七、Redfish Action PDR 概述

用于描述Redfish资源支持的操作（Action），如“重启”、“关机”等，支持动态调用。其格式包含公共头部和以下特有字段：

字段定义

关键说明

1. 操作路径规则

   • 标准操作：路径格式为Actions/<ResourceType>.<ActionName>（如Actions/ComputerSystem.Reset）。
   • OEM操作：路径可自定义，但需符合厂商命名规则（如Actions/Oem/VendorX.UpdateFirmware）。

2. 拆分规则

   • 按资源拆分：当关联资源过多时，优先按RelatedResourceID拆分为多个PDR。
   • 按操作拆分：仅当单资源操作过多时，按ActionCount拆分。

3. 索引与排序

   • ActionPDRIndex用于同一资源关联的多个Action PDR的顺序管理（如资源支持10个操作，需拆分为两个PDR时，索引分别为0和1）。

4. 与Redfish Resource PDR的关联

   • RelatedResourceID必须指向有效的Redfish Resource PDR的ResourceID。
   • 同一资源的所有Action PDR需通过RelatedResourceID和ActionPDRIndex组合唯一标识。