dpmutil
描述
dpmutil提供了一个命令行接口，用于发现Digilent Syzygy平台板的特性和配置信息。还提供了用于发现连接到板的SmartVIO端口的Zmods (SYZYGY pod)和用于操作各种平台MCU设置的命令。本文档描述了dpmutil命令的功能和语法。
支持董事会
dpmutil适用于eclipse Z7和USB104 A7。实现其功能的演示可以在各自的资源中心找到，链接如下:
注意:dpmutil以前被称为decutil，这个名称在某些eclipse Z7文档中仍然存在。
使用
dpmutil [-] [- version)命令(选项)
命令
| 命令 | 描述 |
|---|---|
| getinfo | 获取PlatformMCU (PMCU)的一般配置和支持的特性信息。该命令通过I2C总线与PMCU通信，检索PMCU的功能和单板配置的一般信息。包括PMCU固件版本、SmartVIO端口数、电源组数(5V0、3V3、VADJ)、单板支持的温度探头数、单板支持的风扇数。如果板支持一个或多个温度探头，则每个支持探头的能力和该探头的最新温度测量通过控制台显示。如果单板支持一个或多个风扇，则显示每个支持的风扇的能力，如果一个风扇支持RPM测量，则也显示最近的RPM测量。 |
| getinfo5v0 | 获取与板上SmartVIO端口相关联的板上5V0电源的信息。这个函数与平台通信MCU (PMCU) I2C确定船上5 v0电力供应的数量,来检索当前的数量,每个供应能力提供,并检索当前的和要求所有SmartVIO港口与每个相关供应。 “-chanid”选项可用于指定特定电源的通道标识符(0-7,a-f，或a-f)，以限制显示到特定通道的信息。如果没有提供通道标识符，则此命令将检索和显示板支持的每个通道的信息。 |
| getinfo3v3 | 获取与板载SmartVIO端口相关联的板载3V3电源的信息。这个函数与平台通信MCU (PMCU) I2C确定船上3 v3电力供应的数量,来检索当前的数量,每个供应能力提供,并检索当前的和要求所有SmartVIO港口与每个相关供应。 “-chanid”选项可用于指定特定电源的通道标识符(0-7,a-f，或a-f)，以限制显示到特定通道的信息。如果没有提供通道标识符，则此命令将检索和显示板支持的每个通道的信息。 |
| getinfovio | 获取与机载SmartVIO端口相关联的机载VIO (VADJ)电源的信息。该功能通过I2C与平台MCU (PMCU)通信，以确定板上VIO电源的数量，检索每个电源能够提供的电流量，检索与每个电源相关联的所有SmartVIO端口请求的电流之和，并检索与每个电源相关联的所有状态和配置信息。 “-chanid”选项可用于指定特定电源的通道标识符(0-7,a-f，或a-f)，以限制显示到特定通道的信息。如果没有提供通道标识符，则此命令将检索和显示板支持的每个通道的信息 |
| getinfopower | 获取与板上SmartVIO端口相关联的板上电源(5V0、3V3、VIO)的信息。该命令通过I2C与平台MCU (PMCU)通信，以确定与机载VIO端口相关联的机载5V0、3V3和VIO电源的数量，并检索关于每个电源的各种信息。执行该命令相当于依次执行“getinfo5v0”、“getinfo3v3”和“getinfovio”。 |
| 枚举 | 列举SmartVIO港口。该命令通过I2C总线与平台MCU通信，以确定板包含多少SmartVIO端口，并检索每个端口的配置和状态。如果SmartVIO端口安装了SYZYGY pod，那么将使用I2C总线检索标准SYZYGY固件寄存器以及SYZYGY DNA(包括所有字符串字段)，并将该信息输出到控制台。当Digilent Zmod附加到端口时，可能会显示额外的信息。 |
| setplatcfg | 修改PMCU (Platform MCU)平台配置寄存器的一个或多个字段。这个函数使用I2C总线检索PMCU的平台配置寄存器的内容，修改寄存器的指定字段，然后将新的设置写入寄存器。可以修改的设置包括强制5V0电流限制、强制3V3电流限制、强制VIO电流限制和对SYZYGY头执行CRC检查。请注意平台配置存储在PMCU的eepm并且仅在固件初始化期间读取。因此，在PMCU下次重置之前，对平台配置寄存器所做的任何更改都不会生效。可以通过发出“resetpmcu”命令来重置PMCU。 “强制5V0”选项可用于启用或禁用强制5V0电流限制。如果启用强制，并且所有相关SmartVIO pod的当前请求的总和超过了板载电源能够提供的总电流，那么与SmartVIO端口关联的VIO电源将不会启用。 “强制3V3”选项可用于启用或禁用强制3V3当前限制。如果启用强制，并且所有关联SmartVIO pod的当前请求的总和超过了电源可以提供的总电流，那么与SmartVIO端口关联的VIO电源将不会启用。 “强制VIO”选项可用于启用或禁用强制VIO当前限制。如果启用强制，并且所有关联SmartVIO pod的当前请求的总和超过了电源可以提供的总电流，那么与SmartVIO端口关联的VIO电源将不会启用。 “-checkcrc”选项可用于启用或禁用SYZYGY头部DNA检查。如果启用了CRC检查，而计算出的CRC不匹配，则不会启用与SmartVIO端口关联的VIO供应。 |
| setviocfg | 修改平台MCU (PMCU) VADJ_n_OVERRIDE寄存器的一个或多个字段。VADJ_n_OVERRIDE寄存器可用于覆盖特定VIO供应的状态。这包括启用或禁用电源，以及设置输出电压。当编写VADJ_n_OVERRIDE寄存器时，PMCU将进行检查，以确保指定的设置不会与与指定供应相关联的任何SmartVIO端口的需求相冲突。如果没有任何冲突，则指定的设置将立即应用。但是，如果存在冲突，那么对VADJ_n_OVERRIDE寄存器和相关电源的更改将受到限制，以满足所有相关SmartVIO端口的要求。 “-chanid”选项必须用于指定VIO电源的通道标识符(0-7、a-f或a-f)。 “-override”选项可用于启用(' y ')或禁用(' n ')覆盖VIO供应配置。如果启用了覆盖，那么将根据VADJ_n_OVERRIDE寄存器的启用和电压字段配置相关的VIO供应。 " -enable "选项可用于启用(' y ')或禁用(' n ')相关的VIO供应。当清除VADJ_n_OVERRIDE寄存器的override字段时，此设置没有影响。 “-voltage”选项可用于指定相关VIO电源的电压(毫伏)。当清除VADJ_n_OVERRIDE寄存器的override字段时，此设置没有影响。 |
| setfancfg | 修改平台MCU (PMCU) FAN_n_CONFIGURATION寄存器的一个或多个字段。FAN_n_CONFIGURATION寄存器用于指定相关风扇的设置。这可能包括风扇的使能状态、风扇的速度和相关的温度探头。请注意，不是所有的风扇端口支持启用/禁用，固定速度控制，或自动速度控制(基于温度)。对FAN_n_CONFIGURATION寄存器的更改将被限制在端口支持的功能范围内，并在寄存器写入后立即生效。此外，FAN配置被写入eepm并且在PMCU每次复位或电源循环时恢复。 选项" -fanid "必须用于指定要修改的风扇配置的标识符(1-4)。 " -enable "选项可用于启用(' y ')或禁用(' n ')相关的风扇。 选项" -speed "可用于指定相关风扇的速度(" minimum "、" medium "、" maximum "或" auto ")。请注意，不是所有的风扇都支持这个功能，一些端口确实支持这个功能，可能不支持自动风扇速度控制。 " -probe "选项可用于指定与风扇关联的温度探头(" none "， " p1 "， " p2 "， " p3 "， " p4 ")，如果该风扇支持自动调速。 |
| resetpmcu | 该命令使用I2C总线向平台MCU (PMCU)的软件复位寄存器写入一个正值，从而导致处理器执行软件复位。 |
选项
| 选项 | 函数 |
|---|---|
| -chanid | 指定通道标识符，以便在执行一个getinfo命令时获取有关特定电源的信息，或者指定由“setviocfg”命令配置的VIO通道。通道标识符可以使用数字0到7、字符' a '到' h '或字符' a '到' h '指定。VIO供应或通道的数量因产品而异。使用“getinfopower”命令确定设备支持多少5V0、3V3和VIO通道。 |
| -fanid | 使用“setfancfg”指定设置风扇配置时使用的风扇标识符。风扇标识符可以使用数字1到4指定。不同的产品支持的粉丝数量可能不同。使用“getinfo”命令确定设备支持多少风扇。 |
| - port | 指定物理端口的端口标识符，该物理端口包含在执行“writedna”命令时希望写入其DNA的pod。端口标识符命令可以使用数字0到25、字符' a '到' z '或字符' a '到' z '来指定。支持的物理端口数量因产品而异。使用" getinfo "或" enum "命令确定设备支持多少SmartVIO端口。 |
| 启用 | 指定函数是启用(' y ')还是禁用(' n ')。 |
| 覆盖 | 使用" setviocfg "命令指定是否覆盖VADJ电源的配置(' y ')或(' n ')。 |
| 电压 | 在执行“setviocfg”命令时，指定要在VADJ_n_OVERRIDE寄存器中设置的VIO电压(单位为毫伏)。 |
| -enforce5v0 | 指定5V0当前限制是强制(' y ')还是忽略(' n ')。通过发出“setplatcfg”命令，将该设置写入平台MCU的平台配置寄存器。 |
| -enforce3v3 | 指定是否强制(' y ')或忽略(' n ') 3V3当前限制。通过发出“setplatcfg”命令，将该设置写入平台MCU的平台配置寄存器。 |
| -enforcevio | 指定VIO当前限制是强制的(' y ')还是忽略的(' n ')。通过发出“setplatcfg”命令，将该设置写入平台MCU的平台配置寄存器。 |
| -checkcrc | 指定是否对每个SYZYGY头执行CRC检查(' y ')或跳过(' n ')。这个选项必须与“setplatcfg”命令一起发出，以指定平台MCU在枚举SmartVIO端口时是否执行CRC检查。这个选项还可以用来告诉“enum”命令在枚举SmartVIO端口时跳过CRC检查。 |
| - speed | 指定下发“setfancfg”命令时使用的风扇转速设置。风扇转速可以指定为“最小”、“中等”、“最大”或“自动”。不是所有的风扇头都支持设置固定速度或自动速度控制。使用" getinfo "命令来确定设备包含多少风扇头，以及是否支持每个头的固定速度或自动速度设置。 |
| 探针 | 指定执行自动速度控制时使用的温度源或探头。温度探头可以指定为“none”、“p1”、“p2”、“p3”或“p4”。使用“getinfo”命令来确定设备支持多少个温度探头。 |
| - - - - - - ?, - | 显示典型的应用程序使用情况、支持的命令列表和支持的选项列表。 |