Ni系统配置20.5 API参考

属性节点(硬件)说明信息

  • 更新时间2023-02-21
  • 阅读时长22分钟

所属选板:硬件管理

获取或设置本地或远程硬件终端的属性和方法。使用系统硬件属性节点配置系统中的设备。使用保存改动VI保存新的属性设置。

属性说明
属于设备指定资源是否为设备。NI将设备定义为“监视、测量、输出、展示或处理信号的硬件产品”。资源可以同时为设备和机箱。

一般来说,如果序列号属性不是空字符串并且资源支持诊断功能,则属性为TRUE。请注意,该属性为TRUE时,也可存在这些功能。
Note 注:设备不一定是独立的现场可更换单元。如果一个资源对于连接到它的其他设备具有不同的配置属性和信息,那控制器或机箱可能会返回为多个嵌入式设备。例如,嵌入式 PXI 控制器将为控制器本身返回一个资源,为其 GPIB控制器(如有)返回一个资源,为其串口(如有)返回一个资源。


请参看下表,了解详细范例。
属于机箱指定资源是否为机箱。机箱有模块或设备可插入的若干插槽以及外壳。资源可以同时为设备和机箱。

如果此资源只有一个用于电缆或附件的外部连接器,则此属性将为FALSE。例如,对于GPIB控制器或串口相关的资源,该属性将返回FALSE,因为设备通过外部线缆连接。

请参看下表,了解详细范例。
服务类型指定资源类型。不是所有资源都包含服务。

有效至包括:(0) NI网络资源、(1) NI Real-Time、(2) NI系统配置、(3) NI网络接口、(4) 本地系统、(5) 本地网络接口、(6) 本地计时器、(7) 本地时间参考和(8) LXI仪器。
启动设置:禁用FPGA启动应用程序指定下次终端重启时,禁用任何FPGA启动程序。
启动设置:用户指定型安全模式指定终端下次重启时进入安全模式。如果设置该属性为FALSE,则在出错或未安装软件时,终端可能以安全模式启动。终端的安全模式定义取决于终端的启动流程。在NI Linux RT上,安全模式是一个单独的分区和操作系统镜像,仅启用关键服务,与运行模式不同。对于使用基础系统镜像21.0以及更高版本的终端,可使用全新的启动流程,安全模式被定义为启动NI Linux RT操作系统至运行级别4。在新的启动流程中,启动终端进入安全模式不是格式化和软件安装的必要前提。但是,某些操作仍然需要重新启动。在这两种情况下,安全模式表示没有启动应用程序和运行较少NI进程的一种模式。
启动设置:启用控制台输出指定终端下次重启时启用控制台输出。
启动设置:IP重置指定终端下次重启时恢复网络配置为出厂默认设置。
启动设置:启用sshd服务器指定在终端上启用sshd服务器。开始sshd表示启用通过SSH(加密通信协议)的登录。建议在通过SSH或串口连接登录之前,为控制器设置密码。
启动设置:禁用RT启动应用程序指定下次终端重启时,禁用任何RT启动程序。
启动设置:启用UI桌面环境指定下次终端重启后,启用桌面环境。启用桌面环境时,可连接显示设备至终端以查看图形化工作环境(包括运行在终端上VI的前面板)。
启动设置:启用LabVIEW项目访问指定下次终端重启后,启用从LabVIEW项目访问。
设备与机箱:连接至总线类型 指定设备插入的总线类型。属于父总线或上行总线类型。

有效值包括:(0) 内置/系统、(1) PXI/PCI、(2) USB、(3) GPIB、(4) VXI、(5) 串口、(6) TCP/IP、(7) cRIO、(8) SCXI、(9) cDAQ、(10) SwitchBlock外盒、(11) SCC、(12) 固件、(13) 附件、(14) CAN、(15) SwitchBlock设备、(16) SLSC。
设备与机箱:提供总线类型指定机箱内的总线类型。

有效值包括:(0) 内置/系统、(1) PXI/PCI、(2) USB、(3) GPIB、(4) VXI、(5) 串口、(6) TCP/IP、(7) cRIO、(8) SCXI、(9) cDAQ、(10) SwitchBlock外盒、(11) SCC、(12) 固件、(13) 附件、(14) CAN、(15) SwitchBlock设备、(16) SLSC。

请参看下表,了解详细范例。
设备与机箱:供应商名称指定供应商的名称。通常(但不一定)为制造商。
注 注:该属性的值仅用于显示,不适用于编程。该值可能因实现版本或修订版本而不同。
设备与机箱:产品名称指定资源的型号名称。
注 注:该属性的值仅用于显示,不适用于编程。该值可能因实现版本或修订版本而不同。
设备与机箱:型号名称号指定产品的型号名称的数字部分。范例:对于NI USB-6212 (BNC)和NI USB-6212 (Mass Termination),该值为6212。

这既不是可销售产品编号,也不是特定总线产品标识符代码。对于名称中不包含数字的设备和控制器(如NI ELVIS),该值为0。
设备与机箱:序列号指定资源的序列号。
设备与机箱:属于NI产品指定该资源是否为NI产品。
设备与机箱:属于仿真指定该资源是否为仿真,即非真实物理资源。
设备与机箱:连接至链接名称指定其他资源(如机箱、网络适配器)提供的链接名称。这是资源所连接的父项。该名称格式为基于总线。
设备与机箱:提供链接名称指定该资源连接的名称。该名称格式为基于总线。
设备与机箱:插槽连接数指定设备实际占用的插槽数量。不包括未编号的插槽,例如系统控制器占用的空白区。如值未知或者系统未被争取配置,该项可能为-1。
设备与机箱:提供插槽数对于机箱而言,表示机箱中的插槽数量。对于模块或设备而言,表示端口数量。如值未知或者系统未被争取配置,该项可能为-1。
设备与机箱:插槽号对于模块而言,表示模块连接的插槽编号。对于端口而言,表示其父模块或设备上显示的端口号。如值未知或者系统未被争取配置,该项可能为-1。
设备与机箱:插槽左偏移指定设备所在插槽的左侧实际编号的插槽的数量。不包括未编号的插槽,例如系统控制器占用的空白区。0表示连接的插槽就是第一个编号插槽。
设备与机箱:当前温度指定该资源测量的当前温度(单位为摄氏度)。
设备与机箱:硬件版本指定该设备的硬件版本。对于兼容多个电路板装配的产品,该栏包含模块的装配版本。

连续的版本间不总是按照字典序排列,常见的顺序为A, B ... Y, Z, AA, BB。
设备与机箱:包含驱动指定该资源是否安装驱动。
设备与机箱:已存在指定该资源当前是否存在。

有效值包括:(-2) 初始化,(-1) 未知,(0) 不存在,(1) 存在。
初始化 — 资源存在但尚未使用。例如,设备可能在加载总线固件。
未知 — 资源的状态不能或尚未确定。例如,可能是一个已知的网络设备,但是驱动程序最近未与设备发生交互。
不存在 — 资源不存在,驱动程序无法与其通信。例如,某个从机箱中拔出的模块。
存在 — 资源已连接且处于待用状态。仿真资源通常也表示为存在。
设备与机箱:总线特定:供应商ID指定设备的总线定义供应商ID。例如,对于NI,PXI/PCI和USB分别为0x1093和0x3293。

对于PXI/PCI资源,如该值非0,表示子系统供应商ID (SSVID)。否则,该值表示供应商ID (VID)。对于USB设备,该值表示供应商ID (VID)。对于VXI设备,该值表示VXI生厂商ID。
设备与机箱:总线特定:产品ID指定特定总线产品标识符代码。该ID不属于可销售产品编号。

对于PXI/PCI资源,如子系统供应商ID不为0,该值表示子系统ID (SSID)。否则,该值表示设备ID (DID)。对于USB资源,该值表示产品ID (PID)。对于VXI资源,是指型号代码。
设备与机箱:总线特定:PXI/PCI总线数指定PXI/PCI设备的PCI总线数。
设备与机箱:总线特定:PXI/PCI设备数指定PXI/PCI设备的PCI设备数。
设备与机箱:总线特定:PXI/PCI函数数指定PXI/PCI设备的PCI函数数。
设备与机箱:总线特定:PXI/PCI实际链接宽度指定位于Express主机控制器与设备间的PXIe/PCIe链接宽度。值-1表示该设备不属于Express设备。常用值包括1、2、4、8和16。
设备与机箱:总线特定:PXI/PCI最大链接宽度指定该设备的最大PXIe/PCIe链接宽度。值-1表示该设备不属于PXIe/PCIe设备。常用值包括1、2、4、8和16。
设备与机箱:总线特定:PXI/PCI插槽链接宽度指定该设备所在的PXI Express外围插槽的PXIe/PCIe链接宽度。值-1表示该设备不属于PXI Express设备。常用值包括1、4和8。
设备与机箱:总线特定:USB接口指定该资源的USB接口数。
设备与机箱:总线特定:TCP/IP主机名称指定该设备的主机名称。如不存在可用主机名称,该属性将返回一个空字符串。
设备与机箱:总线特定:TCP/IP MAC地址指定该设备的唯一标识符(MAC地址)。如MAC地址未知,该属性将返回一个空字符串。
设备与机箱:总线特定:TCP/IP地址指定该设备的主IP地址。
设备与机箱:总线特定:TCP/IP设备类指定远程系统或网络设备的类。例如PXI和cRIO。
设备与机箱:总线特定:GPIB主地址指定该GPIB设备的主地址。
设备与机箱:总线特定:GPIB次地址指定该GPIB设备的次地址。如设备不包括次地址,该值可能为-1。
设备和机箱:总线特定:串行COM端口绑定指定串行设备绑定的端口。
设备与机箱:总线特定:cRIO模块编程模式指定该模块的程序模式。

有效值包括:(0) 无、(1) Real-Time CPU、(2) Real-Time扫描引擎以及(4) LabVIEW FPGA。
-该资源不是模块,或不支持程序模式。
Real-Time CPU-该模块是由运行在CPU上的实时应用程序控制的。
Real-Time扫描引擎-该模块是由NI扫描引擎控制的,其数据对实时应用程序可用。
LabVIEW FPGA-该模块是由LabVIEW FPGA比特位文件控制的。
设备与机箱:外部校准:支持外部校准指定设备是否支持外部校准。
设备与机箱:外部校准:支持校准写入 指定用户是否可写入外部校准时间标识和新校准密码。
设备与机箱:外部校准:校准注释返回设备的校准注释。
设备与机箱:外部校准:外部校准返回该设备的外部校准属性,包括时间标识、上一次温度(单位为摄氏度)和建议下一次校准。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。
设备与机箱:外部校准:外部校准日期 指定上一次外部校准验证的时间标识。验证是为了保证仪器在其产品规范规定的误差范围内,不涉及任何类型的改动。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。

仅当支持校准写入为TRUE时,可修改此日期。
设备与机箱:外部校准:外部校准调整日期 指定上一次外部校准调整的时间标识。调整是对仪器进行行为的改变,保证仪器尽可能接近理想的性能。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。

仅当支持校准写入为TRUE时,可修改此日期。
设备与机箱:外部校准:外部校准温度返回上一次外部校准调整时板载设备的温度,以摄氏度为单位。
设备与机箱:外部校准:外部校准截止日期指定下一次外部校准的推荐截止日期。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。

支持校准写入为TRUE,用户可更改该截止日期。

如该属性为只读,返回的日期为下一次校准的推荐日期。
设备与机箱:外部校准:校准密码 指定设备的当前校准密码。保存密码保护校准信息前,客户端必须设置校准密码。
设备与机箱:外部校准:推荐校准间隔 指定设备的出厂推荐校准间隔,以月为单位。
设备与机箱:外部校准:外部校准有限指定设备的上一次外部校准是否是有限校准。如支持校准写入为TRUE,用户可更改该值。
设备与机箱:外部校准:校准Checksum返回外部校准数据的Base64编码加密检验和。
设备与机箱:外部校准:新校准密码 指定设备的新校准密码。保存改动前,客户端必须设置校准密码属性。
设备与机箱:内部校准:支持内部校准返回设备是否支持内部校准。
设备与机箱:内部校准:内部校准有限返回设备的上一次内部校准是否是有限校准。
设备与机箱:内部校准:范围内内部校准值返回最后一次内部/自校准值是否一致以及是否在范围内。自上次自校准以来的时间量、温度传感器和复合装置的所有模块等因素都会影响校准结果。
设备和机箱:内部校准:内部校准详细信息计数返回此资源上内部/自校准详细信息的数量。
设备与机箱:内部校准:内部校准名称返回每个内部校准详细信息的名称。
设备与机箱:内部校准:内部校准日期返回上次自校准时每个详细信息的时间标识。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。
设备与机箱:内部校准:内部校准温度返回上次自校准时每个板载设备的详细温度,以摄氏度为单位。
设备与机箱:固件:固件版本指定该资源的固件版本信息。
设备与机箱:固件:支持固件更新指定远程系统是否支持固件更新。
设备与机箱:固件:固件更新模式指定是否由用户或驱动器管理此资源的固件版本。

有效值包括:(0) 无,(1) 手动,以及(2) 驱动器管理。
设备与机箱:固件:固件文件匹配模式指定该资源固件文件名的文件扩展名模式。
设备与机箱:固件:可用固件版本指定该资源的已知可用固件版本。
网络适配器:适配器类型指定网络适配器是否为Ethernet或WLAN (802.11)。
网络适配器:MAC地址指定该网络适配器的唯一标识符(MAC地址)。
网络适配器:属于主适配器指定该设备是否为主网络适配器。
网络适配器:适配器模式指定网络适配器的模式。

有效值包括:(1) 禁用、(2) TCP/IP、(4) 确定性、(8) EtherCAT、(32) TCP/IP WLAN和(64) TCP/IP接入点。
网络适配器:TCP/IP:IP地址请求模式指定网络适配器是否静态或动态获取IP地址。部分适配器仅支持部分模式。通常支持静态和DHCP/Link-Local模式。如系统或设备包含多个适配器,该属性仅适用于主网卡。

有效值包括:(1) Static、(2) DHCP/Link Local、(4) 仅Link Local和(8) 仅DHCP。
网络适配器:TCP/IP:IP地址指定网络适配器的IP地址。
网络适配器:TCP/IP:子网掩码指定网络适配器的子网掩码。
网络适配器:TCP/IP:网关指定用于网络适配器的网络网关的IP地址。
网络适配器:TCP/IP:DNS服务器指定网络适配器的DNS服务器地址。
网络适配器:TCP/IP:首选链接速度指定网络适配器的首选链接速度。

用于Ethernet适配器的有效值包括:(1) 自适应、(2) 10mbps/半双工、(4) 10mbps/全双工、(8) 100mbps/半双工、(16) 100mbps/全双工、(32) Gigabit/半双工和(64) Gigabit/全双工。

用于WLAN适配器的有效值包括:(1) 自适应、(131072) WLAN 802.11a、(262144) WLAN 802.11b、(524288) WLAN 802.11g、(1048576) WLAN 802.11n和(2097152) WLAN 802.11n (5GHz)。
网络适配器:TCP/IP:当前链接速度指定网络适配器的当前链接速度。

用于Ethernet适配器的有效值包括:(1) 自适应、(2) 10mbps/半双工、(4) 10mbps/全双工、(8) 100mbps/半双工、(16) 100mbps/全双工、(32) Gigabit/半双工和(64) Gigabit/全双工。

用于WLAN适配器的有效值包括:(1) 自适应、(131072) 802.11a、(262144) 802.11b、(524288) 802.11g、(1048576) 802.11n和(2097152) 802.11n (5GHz)。
网络适配器:TCP/IP:包检测指定网络适配器的当前包检测。

有效值包括:(1)中断、(2)轮询和(4)消息信号中断。
网络适配器:TCP/IP:轮询间隔对于设置为数据包检测轮询的设备,需指定驱动检查新数据包的频率。有效值为1 ms ~ 10000 ms。如设备没有被设置为轮询包检测,该选项被禁用。
网络适配器:无线:发现接入点进行无线扫描后,将返回包含所有无线接入点信息的数组。每项均包含以下关于接入点的信息:接入点的SSID、BSSID、连接类型、安全类型、链接质量、通道编号、链接速度(a、b、g或n)。
网络适配器:无线:SSID指定网络适配器正在连接或已连接的接入点的SSID。
网络适配器:无线:连接类型指定网络适配器正在连接或已连接的接入点的连接类型。

有效值包括:(0) 无、(1) 基础结构和(2) Ad Hoc。
网络适配器:无线:安全类型指定网络适配器正在连接或已连接的接入点的安全类型。

有效值包括:(0) 无、(1) 不支持、(2) 开放、(4) WEP、(8) WPA-PSK、(16) WPA-EAP、(32) WPA2-PSK和(64) WPA2-EAP。
网络适配器:无线:链接质量指定网络适配器正在连接或已连接的接入点的链接质量。链接质量等级为0(无信号)至100(高质量)之间。
网络适配器:无线:通道编号指定网络适配器正在连接或已连接的接入点用于广播无线信号的通道编号。
网络适配器:无线:BSSID指定网络适配器已连接的接入点的广播SSID。
网络适配器:无线:国家代码根据ISO-3166-1数值编码指定使用该网络适配器的所在国家。
网络适配器:无线:认证类型指定网络适配器正在连接或已连接的接入点的认证类型。

有效值包括:(0) 无、(1) EAP-TLS、(2) EAP-TTLS、(4) EAP-FAST、(8) LEAP和(16) PEAP。
网络适配器:无线:安全身份指定连接接入点时用于认证的安全身份(用户名称)。
网络适配器:无线:安全密钥指定连接接入点时用于认证的安全密钥(密码)。
网络适配器:无线:客户端证书指定连接接入点时用于认证的客户端证书。
网络适配器:EtherCAT:主站ID标识实时系统中EtherCAT主站的值,在0至255之间。同一个实时终端上的EtherCAT主站ID不能重复,必须为唯一。
网络适配器:EtherCAT:主站冗余指定是否有多个终端连接至同一个EtherCAT网络,作为备用主站。不能将一个终端的启用模式设置为多个网络适配器备用主站。
远程访问:系统配置Web访问指定访问终端系统设置的位置。
仅限于本地-表示仅允许从终端访问配置。
本地和远程-表示可从本地和远程访问配置。
系统资源:主磁盘空间指定系统中主驱动器(例如,C:)的总磁盘空间。
系统资源:剩余主磁盘空间指定系统中主驱动器(例如,C:)的剩余磁盘空间总数,以KB为单位。
系统资源:CPU:CPU核心数量指定系统中CPU核心的数量。
系统资源:CPU:CPU逻辑处理器数量指定系统中逻辑处理器的数量。
系统资源:CPU:模型指定系统CPU的模型信息。可能也包含供应商信息,具体取决于使用的平台。
系统资源:CPU:步进修订指定同一系列名称中系统CPU的版本数量。
系统资源:CPU:总负载指定系统中各个逻辑处理器的总负载。结果为0至100的数值。
系统资源:CPU:中断负载指定系统中各个逻辑处理器使用在核心任务(例如中断处理)的时间百分比。结果为0-100的数字。
系统资源:CPU:速度指定系统中每个CPU的当前速度,以MHz为单位。
系统资源:风扇:数量指定该资源可用的风扇数量。
系统资源:风扇:名称指定该资源可用的风扇数量。
系统资源:风扇:读数指定该资源各个风扇的当前读数,以RPM为单位。
系统资源:内存:物理内存总数指定系统中物理内存的总大小,以KB为单位。
系统资源:内存:剩余物理内存指定系统中剩余物理内存的总大小,以KB为单位。
系统资源:内存:最大可用内存块指定运行VxWorks或Phar Lap ETS的系统中最大可用内存块的大小,以KB为单位。
系统资源:内存:虚拟内存总数指定系统中虚拟内存的总大小(以KB为单位),包含物理内存和交换文件空间。如果不支持虚拟内存或未启用虚拟内存,该值等同于物理内存总数。
系统资源:内存:剩余虚拟内存指定系统中剩余虚拟内存的总数,以KB为单位。
系统资源:功率传感器:数量指定该资源可用的功率传感器数量。
系统资源:功率传感器:名称指定该资源可用的功率传感器名称。
系统资源:功率传感器:读数指定该资源各个功率传感器的当前读数,单位为瓦特。
系统资源:功率传感器:高临界值指定该资源各个功率传感器的临界范围(正常工作范围)的高临界值,单位为瓦特。
系统资源:温度传感器:数量指定该资源可用的温度传感器数量。
系统资源:温度传感器:名称指定该资源可用的温度传感器名称。
系统资源:温度传感器:读数指定该资源各个温度传感器的当前读数,单位为摄氏度。
系统资源:温度传感器:低临界值指定该资源各个温度传感器的临界范围(正常工作范围)的低临界值,单位为摄氏度。
系统资源:温度传感器:高临界值指定该资源各个温度传感器的临界范围(正常工作范围)的高临界值,单位为摄氏度。
系统资源:User LED:数量 指定该资源可用的LED指示灯的数量。
系统资源:User LED:名称 指定该资源可用的LED指示灯的名称。
系统资源:User LED:状态 指定每个LED指示灯的当前状态。
系统资源:用户开关:数量 指定该资源可用的用户开关数量。
系统资源:用户开关:名称 指定该资源可用的用户开关名称。
系统资源:用户开关:状态 指定每个用户开关的当前状态。对于按钮开关,禁用(断开)状态为向上方向,启用(闭合)状态为向下方向。
系统资源:电压传感器:数量指定该资源可用的电压传感器数量。
系统资源:电压传感器:名称指定该资源可用的电压传感器名称。
系统资源:电压传感器:读数指定该资源各个电压传感器的当前读数,单位为伏特。
系统资源:电压传感器:额定值指定该资源各个电压传感器的额定/期望读数,单位为伏特。
系统资源:电压传感器:低临界值指定该资源各个电压传感器的临界范围(正常工作范围)的低临界值,单位为伏特。
系统资源:电压传感器:高临界值指定该资源各个电压传感器的临界范围(正常工作范围)的高临界值,单位为伏特。
时间:系统开始时间指定系统上一次重启的时间。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。
时间:当前时间指定远程系统或网络设备的当前时间。LabVIEW通过自1904年1月1日星期五12:00 a.m(通用时间)以来的秒数计算时间标识。
时间:时区指定远程系统或网络设备的时区。在Date and Time Gateway website可以查看时区字符串列表。
注 注:如终端不支持夏令时自动调整,可指定所在位置对应的GMT时间而不是实际时区。否则,数据的时间标识可能不精确。
专项软件信息:专项软件名称指定包含该资源的专项系统的编程名称。
专项软件信息:资源名称指定专项软件与该资源关联的原资源名称。
注: 注:请勿将此属性的值用于编程决策。该值可能因实现版本或修订版本而不同。
专项软件信息:用户别名指定该资源的用户定义名称。
专项软件信息:全部专项软件指定所有包含该资源的专家系统的信息数组。每项均包含专项软件编程名称、原资源名称和用户指定名称。


以下是在一个假设系统中资源和属性的示例:
资源属于设备属于机箱提供总线类型
PXI 8槽机箱FALSETRUEPXI/PCI
插槽1为PXI嵌入式控制器TRUEFALSEN/A
PXI控制器上的GPIB端口TRUEFALSEGPIB
插槽2为PXI DAQ模块TRUEFALSEN/A
USB CompactDAQ 4槽机箱TRUETRUEcDAQ
插槽2为C系列模块TRUEFALSEN/A

Log in to get a better experience