电源 - Lager

控制可编程电源，为您的被测设备设置电压、电流和保护阈值。

导入

from lager import Net, NetType

方法

方法	说明
`set_voltage()`	设置输出电压
`set_current()`	设置输出限流值
`voltage()`	读取实测电压
`current()`	读取实测电流
`power()`	读取实测功率
`enable()`	打开电源输出
`disable()`	关闭电源输出
`set_ovp()`	设置过压保护阈值
`set_ocp()`	设置过流保护阈值
`get_ovp_limit()`	获取过压保护限值
`get_ocp_limit()`	获取过流保护限值
`is_ovp()`	检查 OVP 故障是否已触发
`is_ocp()`	检查 OCP 故障是否已触发
`clear_ovp()`	清除过压保护故障
`clear_ocp()`	清除过流保护故障
`state()`	把电源状态打印到 Box 的硬件服务日志；返回 `None`
`get_full_state()`	把扩展状态打印到同一个日志；返回 `None`
`set_mode()`	仅限 Keithley 2281S：把仪器切换到直流电源模式
`disable_ocp(channel)`	在支持的仪器上关闭过流保护
`disable_ovp(channel)`	在支持的仪器上关闭过压保护
`get_monitor_state(channel)`	一次调用读取一个通道的完整状态；返回一个 dict
`get_monitor_states(channels)`	对多个通道执行 `get_monitor_state()`；返回以通道为键的 dict

方法参考

`Net.get(name, type=NetType.PowerSupply)`

按名称获取一个电源 Net。

from lager import Net, NetType

psu = Net.get('VDD', type=NetType.PowerSupply)

参数：

参数	类型	说明
`name`	`str`	电源 Net 的名称
`type`	`NetType`	必须为 `NetType.PowerSupply`

返回： 电源 Net 实例

`set_voltage(value)`

设置输出电压。

psu.set_voltage(3.3)  # Set to 3.3V

参数	类型	说明
`value`	`float`	目标电压，单位伏特

`set_current(value)`

设置输出限流值。

psu.set_current(0.5)  # Set limit to 0.5A

参数	类型	说明
`value`	`float`	限流值，单位安培

`voltage()`

读取实测的输出电压。

v = psu.voltage()
print(f"Voltage: {v}V")

返回： float - 实测电压，单位伏特

`current()`

读取实测的输出电流。

i = psu.current()
print(f"Current: {i}A")

返回： float - 实测电流，单位安培

`power()`

读取实测的输出功率。

p = psu.power()
print(f"Power: {p}W")

返回： float - 实测功率，单位瓦特

`enable()`

打开电源输出。

psu.enable()

`disable()`

关闭电源输出。

psu.disable()

`set_ovp(limit)`

设置过压保护阈值。当实测电压超过该阈值时，输出会被自动关闭。在 Keithley 2281S 上，低于电压设定值的 OVP 会引发错误。其他驱动会接受它。

psu.set_ovp(3.6)  # Trip at 3.6V

参数	类型	说明
`limit`	`float`	OVP 阈值，单位伏特

`set_ocp(limit)`

设置过流保护阈值。当实测电流超过该阈值时，输出会被自动关闭。

psu.set_ocp(1.0)  # Trip at 1.0A

参数	类型	说明
`limit`	`float`	OCP 阈值，单位安培

`get_ovp_limit()`

获取已配置的 OVP 限值。

ovp = psu.get_ovp_limit()
print(f"OVP limit: {ovp}V")

返回： float - OVP 阈值，单位伏特

`get_ocp_limit()`

获取已配置的 OCP 限值。

ocp = psu.get_ocp_limit()
print(f"OCP limit: {ocp}A")

返回： float - OCP 阈值，单位安培

`is_ovp()`

检查过压故障是否已触发。

if psu.is_ovp():
    print("OVP fault detected!")

返回： bool - OVP 故障已触发时为 True

`is_ocp()`

检查过流故障是否已触发。

if psu.is_ocp():
    print("OCP fault detected!")

返回： bool - OCP 故障已触发时为 True

`clear_ovp()`

清除过压保护故障。

psu.clear_ovp()

`clear_ocp()`

清除过流保护故障。

psu.clear_ocp()

`state()`

打印完整的电源状态，包括通道、是否已打开、模式（CV/CC）、实测电压/电流/功率，以及保护状态。该调用在 Box 的硬件服务中运行。文本写入 Box 上的 /tmp/lager-hardware-service.log，而不是您的脚本，并且调用返回 None。若要在脚本中读取状态，请使用 get_monitor_state()。请参阅 #845。

psu.state()

输出示例：

Channel: CH1
Enabled: ON
Mode: CV
Voltage: 3.3000
Current: 0.1520
Power: 0.5016
OCP Limit: 1.0000
    OCP Tripped: NO
OVP Limit: 3.6000
    OVP Tripped: NO

`get_full_state()`

打印扩展状态，包括全部测量值、已配置的设定值、保护限值和硬件最大额定值。与 state() 一样，它打印到硬件服务日志并返回 None。

psu.get_full_state()

输出示例：

Channel: CH1
Enabled: ON
Mode: CV
Voltage: 3.3000
Current: 0.1520
Power: 0.5016
Voltage_Set: 3.3000
Current_Set: 1.0000
OCP Limit: 1.0000
    OCP Tripped: NO
OVP Limit: 3.6000
    OVP Tripped: NO
Voltage_Max: 30.0000
Current_Max: 3.0000

相比 state() 多出的字段：

Voltage_Set / Current_Set - 已配置的设定值
Voltage_Max / Current_Max - 硬件通道的额定值

`get_monitor_state(channel)`

一次调用读取一个通道的完整状态，并以 dict 返回。这是在脚本中读取状态的方法。

state = psu.get_monitor_state(psu.channel)
print(state['voltage'], state['current'], state['enabled'])

键	说明
`voltage`、`current`、`power`	实测值；读取失败时为 `None`
`enabled`	`True`、`False`；未知时为 `None`
`mode`	`CV` 或 `CC`
`voltage_set`、`current_set`	已配置的设定值
`voltage_max`、`current_max`	硬件通道的额定值
`ocp_limit`、`ocp_tripped`、`ovp_limit`、`ovp_tripped`	保护限值与触发状态

请传入该 Net 的通道。不传通道时，DP832 这样的多通道电源会读取其前面板上选中的输出（#846）。get_monitor_states([1, 2]) 读取多个通道，并返回 {'1': {...}, '2': {...}}。

`disable_ocp(channel)` / `disable_ovp(channel)`

关闭过流或过压保护。用 set_ocp() 或 set_ovp() 设置限值会重新打开保护。

psu.disable_ovp(psu.channel)

仪器	结果
Rigol DP700、Rigol DP800、Keysight E36200	保护被关闭
Keysight E36300、Keithley 2281S、Siglent SPD1000X、EA	引发错误

请传入该 Net 的通道。不传通道时，多通道电源会作用于其前面板上选中的输出（#846）。设置了 max_voltage 安全限值的 Net 会拒绝关闭 OVP，设置了 max_current 的 Net 会拒绝关闭 OCP。

示例

基本的电源控制

from lager import Net, NetType

# Get power supply net
psu = Net.get('VDD', type=NetType.PowerSupply)

# Configure output
psu.set_voltage(3.3)
psu.set_current(0.5)

# Enable output
psu.enable()

# Read measurements
print(f"Voltage: {psu.voltage():.2f}V")
print(f"Current: {psu.current():.3f}A")
print(f"Power: {psu.power():.3f}W")

# Disable when done
psu.disable()

带保护阈值

from lager import Net, NetType
import time

psu = Net.get('VDD', type=NetType.PowerSupply)

# Configure voltage/current
psu.set_voltage(5.0)
psu.set_current(0.5)

# Set protection thresholds
psu.set_ovp(5.5)  # Trip at 5.5V
psu.set_ocp(0.6)  # Trip at 0.6A

# Enable output
psu.enable()
print("Power enabled")

# Monitor for faults
time.sleep(1)
if psu.is_ocp():
    print("OCP fault! Clearing...")
    psu.clear_ocp()

if psu.is_ovp():
    print("OVP fault! Clearing...")
    psu.clear_ovp()

# Clean up
psu.disable()

监视功耗

from lager import Net, NetType
import time

psu = Net.get('VDD', type=NetType.PowerSupply)
psu.set_voltage(3.3)
psu.set_current(1.0)
psu.enable()

# Log power consumption
for sample in range(10):
    v = psu.voltage()
    i = psu.current()
    p = psu.power()
    print(f"V={v:.2f}V, I={i:.3f}A, P={p:.3f}W")
    time.sleep(1)

psu.disable()

查看完整状态

from lager import Net, NetType

psu = Net.get('VDD', type=NetType.PowerSupply)
psu.set_voltage(3.3)
psu.set_ovp(3.6)
psu.set_ocp(0.5)
psu.enable()

# Read the full state as a dict
print(psu.get_monitor_state(psu.channel))

psu.disable()

受支持的硬件

厂商	型号系列	通道	特性
Rigol	DP832 / DP832A	3	通道 1-2：30V/3A，通道 3：5V/3A
Rigol	DP821	2	通道 1：60V/1A，通道 2：8V/10A
Rigol	DP811 / DP811A	1	20V/10A 或 40V/5A
Rigol	DP711 / DP712	1	DP711：30V/5A，DP712：50V/3A
Siglent	SPD1168X / SPD1305X	1	SPD1168X：16V/8A，SPD1305X：30V/5A。无 OVP 或 OCP
Keithley	2281S	1	20V/6A/120W，支持电池模拟模式
Keysight	E36200 系列	2	E36233A：每通道 30V/20A
Keysight	E36300 系列	3	E36311A/12A/13A
EA	PSB 10060-60 / 10080-60	1	双象限。请参阅下面的警告

目前 EA 电源无法通过 Net.get() 使用。set_voltage()、set_current()、set_ovp()、set_ocp()、enable() 和 disable() 会以 “Function not found” 失败。对 EA 电源请使用 lager supply。请参阅 #843。

说明

该 Net 必须配置为 NetType.PowerSupply
设置好电压/电流之后，请调用 enable() 打开输出
结束时请务必调用 disable()
保护故障会自动关闭输出；处理完故障之后，请用 clear_ovp() 或 clear_ocp() 清除
在 Keithley 2281S 上，低于电压设定值的 OVP 会引发错误
电压和电流的上限取决于硬件能力
多通道电源：每个通道配置为一个单独的 Net
state() 和 get_full_state() 打印到 Box 的硬件服务日志并返回 None；在代码中取值请用 voltage()、current()、power() 或 get_monitor_state()

入门

开发

电源与仿真

测量

I/O 与通信

实用工具

电源

导入

方法

方法参考

`Net.get(name, type=NetType.PowerSupply)`

`set_voltage(value)`

`set_current(value)`

`voltage()`

`current()`

`power()`

`enable()`

`disable()`

`set_ovp(limit)`

`set_ocp(limit)`

`get_ovp_limit()`

`get_ocp_limit()`

`is_ovp()`

`is_ocp()`

`clear_ovp()`

`clear_ocp()`

`state()`

`get_full_state()`

`get_monitor_state(channel)`

`disable_ocp(channel)` / `disable_ovp(channel)`

示例

基本的电源控制

带保护阈值

监视功耗

查看完整状态

受支持的硬件

说明

导入

方法

方法参考

Net.get(name, type=NetType.PowerSupply)

set_voltage(value)

set_current(value)

voltage()

current()

power()

enable()

disable()

set_ovp(limit)

set_ocp(limit)

get_ovp_limit()

get_ocp_limit()

is_ovp()

is_ocp()

clear_ovp()

clear_ocp()

state()

get_full_state()

get_monitor_state(channel)

disable_ocp(channel) / disable_ovp(channel)

示例

基本的电源控制

带保护阈值

监视功耗

查看完整状态

受支持的硬件

说明

`Net.get(name, type=NetType.PowerSupply)`

`set_voltage(value)`

`set_current(value)`

`voltage()`

`current()`

`power()`

`enable()`

`disable()`

`set_ovp(limit)`

`set_ocp(limit)`

`get_ovp_limit()`

`get_ocp_limit()`

`is_ovp()`

`is_ocp()`

`clear_ovp()`

`clear_ocp()`

`state()`

`get_full_state()`

`get_monitor_state(channel)`

`disable_ocp(channel)` / `disable_ovp(channel)`