8 模块管理内存映射（下）

表 8-171 VDM 实时值（Page 24h-27h）

8.22.3 Page 28h-2Bh（VDM 阈值集组页面）#

Page 28h-2Bh 包含只读的阈值集数组，每页存储 16 个阈值集。

每个使用的阈值集（四元组）包含四个阈值，用于高/低报警/警告阈值的阈值越限监控。

实际阈值值可能取决于已开通的应用集，因此每当新应用被开通时可能会更改。

注意：模块仅会因此原因更新阈值值。对于数据路径应用，当相关数据路径达到 DPInitialized 时阈值将被更新。对于网络路径应用，当相关网络路径达到 NPInitialized 时媒体侧阈值将被更新，当相关主机路径达到 DPInitialized 时主机侧阈值将被更新。

注意：建议对阈值感兴趣的主机在数据路径初始化和/或网络路径初始化之后读取阈值。

一个或多个可观测量的阈值集的使用在 Page 20h-23h 上这些可观测量的 VDM 实例描述符中定义。

表 8-172 VDM 报警/警告阈值（Page 28h-2Bh）

8.22.4 Page 2Ch（VDM 标志位页面）#

每个 VDM 实例有四个阈值越限事件标志位：高阈值和低阈值的报警和警告。

Page 2Ch 包含所有活跃 VDM 实例的这些阈值越限报警和警告的标志位。

表 8-173 VDM 阈值越限（TC）标志位字节

表 8-174 VDM 报警和警告配置（Page 2Ch）

8.22.5 Page 2Dh（VDM 掩码页面）#

每个 VDM 实例可以设置 Page 2Ch 中描述的标志位。

每个已设置的标志位会触发中断请求信号，除非相应的掩码位被设置。

所有 VDM 掩码位的默认值为 1（已掩码）。

Page 2Dh 定义了 Page 2Ch 中定义的相应标志位的可写报警掩码位页面。

表 8-175 VDM 阈值集 0 至 15 报警和警告配置（Page 2Dh）

8.22.6 Page 2Fh（VDM 通告和动态控制）#

• 受支持的 VDM 组数量的通告（即 VDM 页面的可用性）
• 主要用于冻结和解冻统计报告寄存器的动态控制

VDM 组通告

VDMSupport 字节 2Fh:128 通告支持多少个 VDM 实例组（每组 64 个 VDM 实例），即 Page 20h-2Bh 中哪些页面以及 Page 2Ch 和 2Dh 的哪些部分可用。

模块实际提供的用于报告基本可观测量或基本可观测量统计量样本的各个 VDM 实例在 VDM 描述符页面中描述（参见第 8.22.1 节）。

冻结和解冻统计报告寄存器

为简化以下描述，报告基本可观测量的统计量（最小值、最大值或平均值）的 VDM 实例的样本寄存器（在 Page 24h-27h 中）称为统计报告寄存器。

注意：有关 VDM 中统计支持的介绍，请参见第 8.19 节开头。

在统计收集期间，模块始终更新内部统计变量（例如计数器），但仅在统计报告未被冻结时才更新关联的统计报告寄存器（如下所述）。

全局冻结统计报告意味着模块终止当前的统计收集区间（在当时冻结的统计报告寄存器中提供结果），并在内部原子性地启动新的统计收集区间（不丢失任何基本可观测量的样本）。

注意：提升 FreezeRequest 位实际上定义了一个主机控制的性能监控区间。

注意：统计收集的初始行为未被指定；不知道统计收集初始时是暂停还是运行。为达到明确定义的起点，建议主机初始时提升 FreezeRequest，然后在模块确认冻结已执行后的适当时间点启动统计收集。

统计区间和冻结的动态控制

主机提升 FreezeRequest 位 2Fh:144.7 以请求模块停止更新统计报告寄存器（以便允许一致的结果读取），同时启动新的统计区间。

读取完成后，主机可以清除 FreezeRequest 位以通知模块可以恢复更新区间统计寄存器。作为请求下一次冻结的准备，主机最终必须清除 FreezeRequest 位。

当冻结报告寄存器时，模块启动新的统计区间并确保不丢失任何可观测量的样本。为此，模块在对当时冻结的寄存器执行最后一次更新时原子性地重置并重启其内部统计变量，然后停止更新统计报告寄存器，直到主机通过终止冻结期来释放报告寄存器。

场景

主机-模块交互的场景（重复地）获取由主机定义的连续统计区间上的统计结果（即跨越主机定义的性能监控区间）如下：

1. 主机撤销 FreezeRequest（如果仍被设置）以请求解冻统计报告寄存器
2. 模块清除 UnfreezeDone（在 tVDMF 时间内）为后续的解冻完成指示做准备
3. 模块将其内部收集的统计量（在冻结期间内部收集）的当前值复制到统计报告寄存器，然后提升 UnfreezeDone
4. 主机现在可以从统计报告寄存器读取实时统计量以获取增量更新的统计结果。模块现在继续更新统计报告寄存器。
5. 为请求终止当前统计区间并准备统计结果读取，主机提升 FreezeRequest
6. 模块清除 FreezeDone（在 tVDMF 时间内）为后续的 FreezeDone 指示做准备
7. 模块在冻结后停止更新统计报告寄存器，重置其内部统计变量，并立即继续更新内部统计变量（只是不将更新复制到冻结的统计报告寄存器），然后设置 FreezeDone
8. 统计报告寄存器现在已冻结，主机可以自由读取刚结束的统计区间的冻结统计报告寄存器结果。
9. 当统计结果寄存器被冻结时，模块更新其内部统计变量，但不更新统计报告寄存器。
10. 主机可以在结束当前统计区间的任何时候撤销仍活跃的 FreezeRequest，无论是在读取前一个区间的统计量之后立即撤销，还是在结束当前区间之前撤销，然后场景重复。

节能

模块可以支持节能模式（PowerSavingMode），其中可观测量的监控和派生功能（例如报警阈值检测）被暂停以节省功耗。

注意：此功能适用于功耗包络紧张的模块，使得监控应仅在诊断时短暂启用。预计不会在其他情况下使用。

当主机对 PowerSavingMode 进行更改时，应采用以下过程以确保模块报告一致的信息，并忽略瞬态统计量：

启用 PowerSavingMode：

1. 主机发出 FreezeRequest
2. 主机等待模块确认
3. 主机将 PowerSavingMode 更改为启用

禁用 PowerSavingMode（如果需要），假设上面的 FreezeRequest 仍处于活动状态：

1. 主机将 PowerSavingMode 更改为禁用
2. 主机发出 UnFreezeRequest
3. 主机等待模块确认
4. 主机发出 FreezeRequest
5. 主机等待模块确认
6. 主机正常继续

表 8-176 VDM 通告和控制寄存器摘要（Page 2Fh）

8.23 Banked Page 1Fh（CDB 消息）#

模块在 CdbInstancesSupported 字段中通告对 Page 1Fh 的支持（参见表 8-54）。

注意：可以通过不同的 CDB 实例进行并发消息传递。

Page 1Fh 是可选的命令数据块（CDB）消息传递功能（参见第 7.2 节）的主页面。

每个受支持的 Page 1Fh Bank（与受支持的 Page A0h-AFh 子集使用相同的 Bank）仅在模块支持时作为一个独立的内存映射命令/回复消息交换设施。

表 8-177 Page 1Fh 概览（CDB 消息）

CDB 消息页面同时用于命令消息（由主机组成）和回复消息（由模块组成）。

CDB 命令消息头 字节（Page 1Fh:128-133）在表 8-178 中描述，由主机填充以指定要由模块执行的 CDB 命令、使用的本地命令有效载荷长度（LPLLength）、使用的扩展命令有效载荷长度（EPLLength）以及消息校验和（CdbChkCode）。这些字段在主机组成命令消息时填充，在模块接收命令消息时评估。模块不会在回复中更改命令头字段。

表 8-178 CDB 命令消息头（Page 1Fh）

CDB 回复消息头 字节（Page 1Fh:134-135）在表 8-179 中描述，由模块填充以提供关于在一个或两个有效载荷区域（LPL 或 EPL）中携带的回复消息体（如有）的信息。当接收命令时，这些回复头字段被模块忽略；相反，它们在组成回复时由模块确定和填充。

注意：为了稍后验证模块是否确实正确填充了回复头字段，主机在组成命令消息时可以将所有回复头字段设置为回复中预期不到的值。

表 8-179 CDB 回复消息头（Page 1Fh）

本地有效载荷（LPL）区域 Page 1Fh:136-255 在表 8-180 中描述，可以在与消息头相同的页面上携带不超过 120 字节长度的消息体。

LPL 区域同时用于 CMD 参数和回复数据（即回复 LPL 可能覆盖 CMD LPL）。

注意：CDB EPL 页面范围（A0h-AFh）称为扩展有效载荷（EPL），允许最多 2048 字节的大型消息体长度，如下一节所述。

表 8-180 CDB 消息体（Page 1Fh）

消息交换协议

主机必须写入长度、消息校验和、有效载荷（如适用）和 CMDID。

主机写入结束于或包含 CMDID 字段 LSB 的 WRITE “发送消息”并触发模块执行命令。

注意：如果主机在当前 CDB 命令完成之前写入新的 CMDID，行为是不可预测的。

在处理 CDB 命令时，模块在 CdbStatus 00h:38 或 00h:37 中更新命令执行状态，并在 CDB CMD 完成标志位 00h:8.7 或 00h:8.6 中发出完成信号。

注意：命令消息头字段 EPLLength 和 LPLLength 始终包含在命令消息校验和 CdbChkCode 中（即使未使用），而回复头字段 RPLLength 和 RPLChkCode 永远不会包含。

编者注：在本规范的未来修订中，以下文本应予以整合。

触发 CDB 命令执行

触发模块开始 CDB 命令处理的事件取决于通告位 01h:165.7。

假设当前页面为 Page 1Fh，模块中的 CDB 处理触发如下：

• 当 01h:165.7=0b 时：当包含字节 Page 1Fh:129 的二字节或一字节 WRITE 的 I2CMCI STOP 条件被接收时
• 当 01h:165.7=1b 时：当包含字节 Page 1Fh:129 的多字节 WRITE 的 I2CMCI STOP 条件被接收时

注意：在第一种方法中，至少需要两次 WRITE 来调用 CDB 命令，除非主机以环绕方式写入 Page 1Fh 的全部 128 字节。在第二种方法中，单次 WRITE 可能足以调用完全在 Page 1Fh 中表示的 CDB 命令。

注意：主机必须使用通告的方法。

注意：CDB 每次 ACCESS 的最大字节数在 Page 01h Byte 164 中通告。

LPLLength 字段和/或 EPLLength 字段由主机填充，且取决于 CDB 命令。

命令可以使用 LPL 或 EPL 或同时使用 LPL 和 EPL。

EPL 的长度在 EPLLength 字段中指定。确保 EPL 数据有效性的任何检查未被一般性地定义。如果需要额外检查，将为每种类型或命令代码组独立指定。

例如，固件下载假设写入 EPL 块中的 CDB 数据直接来自表示供应商提供文件的二进制字节流，由供应商负责向文件内嵌入的任何数据添加额外检查。

8.23.1 在 WRITE 结束于 9Fh:129 时触发 CDB 命令#

当 CDB 命令执行由写入字节 Page 1Fh:129 或 Page 1Fh:128-129 触发时，模块通告 01h:165.7=0b。

注意：在此情况下，调用带 LPL 的 CDB 命令的推荐方法至少包括两次 WRITE：

1. 将命令参数写入字节 Page 1Fh:130-(135+LPLLength)。 a. 这些写入可能需要分成多次 WRITE 访问。 b. 每次 WRITE 允许的最大字节数在 01h:164 中通告。
2. 将 16 位 CDBID 字段通过二字节 WRITE 写入 Page 1Fh:128-129，或通过两次一字节 WRITE 先写入 Page 1Fh:128 再写入 Page 1Fh:129。

注意：在此模式下，将字节 Page 1Fh:128-(135+LPLLength) 在一次 WRITE 中写入的结果是不可预测的。

8.23.2 在 WRITE 包含 9Fh:129 时触发 CDB 命令#

当 CDB 命令执行由包含字节 129 的 WRITE 的 STOP 条件触发时（即在 MCI 写入事务完成后），模块通告 01h:165.7=1b。

注意：使用此选项时，调用带 LPL 的 CDB 命令的推荐方法涉及对 Page 1Fh:128-(135+LPLLength) 的一次 WRITE（如果 CDB 页面中的最大 WRITE 长度允许）。

注意：尽管字节 129 作为第 2 个字节发送，但命令在接收到 STOP 位之前不会被处理。

注意：如果每次 WRITE 的最大字节数至少为 8，则没有 LPL（LPLLength 为 0）的命令可以通过单次 WRITE 调用。

注意：如果每次 WRITE 的最大字节数为 128，则任何仅使用 LPL 的 CDB 命令都可以在一次 WRITE 中触发。

注意：主机仍然可以使用多次 WRITE 或逐字节 WRITE，因为对字节 129 的单字节写入以 STOP 条件结束，也会调用 CDB 命令。

8.24 Banked 页面范围 A0h-AFh（CDB 扩展有效载荷页面）#

Page A0h-AFh 包含可选的命令数据块（CDB）消息传递功能（参见第 7.2 节）的扩展有效载荷（EPL）区域，为超出 Page 1Fh 本地有效载荷（LPL）区域容量的长消息体数据提供空间（参见上一节）。

每个 Page A0h-AFh Bank 对应一个 CDB 消息传递实例。

实际支持的 EPL 页面集在 CdbMaxPagesEPL 字段中通告，并取决于 CDB 支持（在 CdbInstancesSupported 字段中通告，参见表 8-54）。

为实现对多页 EPL 区域的高效 READ 或 WRITE 访问，模块可以支持自动分页和 READ/WRITE 长度扩展。

如果 CdbAutoPagingSupported 位被设置（参见表 8-54），则除最后一个受支持的 EPL 页面外，EPL 页面范围 A0h-AFh 中超出页面末尾的主机 READ 或 WRITE 访问会导致模块自动递增页面编号并将当前地址指针环绕到下一页的开头（字节 128）。在最后一个 EPL 页面上，自动分页将页面编号环绕回 A0h，并将当前地址指针环绕到字节 A0h:128。

否则，如果 CdbAutoPagingSupported 位被清除，超出页面末尾的主机 READ 或 WRITE 访问将环绕到同一页面的字节 128，如第 B.1 节和第 B.2.5.2.1 节中分别描述。

READ 和 WRITE 操作的允许长度由 CdbReadWriteLengthExtension 通告字段确定（参见表 8-54）。

表 8-181 EPL 段（Page A0h-AFh）