Net

Net 类是与硬件仪器交互的主要抽象。它为控制各类硬件提供统一的接口，包括电源、示波器、GPIO、ADC、DAC 等。

导入

from lager import Net, NetType

# For exception handling
from lager import InvalidNetError, SetupFunctionRequiredError

类方法

方法	说明
`Net.get()`	为指定的 Net 名称和类型创建一个 Net 实例
`Net.list_saved()`	列出 Lager Box 上配置的全部 Net
`Net.list_all_from_env()`	从环境变量列出 Net（旧方式）
`Net.get_local_nets()`	获取全部本地 Net 配置
`Net.save_local_nets()`	保存多个 Net 配置
`Net.save_local_net()`	保存单个 Net 配置
`Net.delete_local_net()`	删除一个 Net 配置
`Net.delete_all_local_nets()`	删除全部 Net 配置
`Net.rename_local_net()`	重命名一个 Net 配置
`Net.filter_nets()`	返回去掉了名称与角色匹配的 Net 之后的列表

实例方法

方法	说明
`enable()`	启用该 Net 并连接硬件
`disable()`	停用该 Net 并断开硬件连接

方法参考

`Net.get(name, type, *, setup_function=None, teardown_function=None)`

为指定的 Net 名称和类型创建一个 Net 实例。

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

# Get a GPIO net
led = Net.get('LED', type=NetType.GPIO)

# Get an analog oscilloscope net
scope = Net.get('PROBE', type=NetType.Analog)

参数：

参数	类型	说明
`name`	`str`	要创建的 Net 名称
`type`	`NetType`	Net 类型（例如 `NetType.PowerSupply`、`NetType.GPIO`）
`setup_function`	`callable`	可选函数，在该 Net 被启用时调用
`teardown_function`	`callable`	可选函数，在该 Net 被停用时调用

返回： 与该 Net 角色对应的对象。对大多数角色而言，这是一个角色专用的类，例如 LabJackGPIO、DebugNet、UARTNet、YubiHsm2 或某个电源函数映射器。这些类提供该角色页面上的方法，但不一定有 enable() 和 disable()。

`Net.list_saved()`

列出 Lager Box 上配置的全部 Net。

nets = Net.list_saved()
for net in nets:
    print(f"{net['name']}: {net['role']}")

返回： list[dict] - Net 配置列表，包含以下键：

name（str）- Net 名称
role（str）- Net 类型/角色
pin（str）- 硬件通道，与 lager nets add 保存的值相同
instrument（str）- 关联的仪器类型
address（str）- 仪器地址

`Net.list_all_from_env()`

从 LAGER_MUXES 环境变量列出 Net（旧行为）。

nets = Net.list_all_from_env()
for net in nets:
    print(f"{net['name']}: {net['role']} on channel {net['channel']}")

返回： list[dict] - Net 信息列表

`Net.save_local_net(data)`

把一个 Net 配置保存到 Lager Box。

Net.save_local_net({
    'name': 'VDD',
    'role': 'power-supply',
    'pin': '1',
    'instrument': 'Rigol_DP832',
    'address': '192.168.1.100'
})

参数：

参数	类型	说明
`data`	`dict`	Net 配置字典

`Net.delete_local_net(name, role=None)`

从 Lager Box 删除一个 Net 配置。

# Delete by name only
Net.delete_local_net('VDD')

# Delete by name and role
Net.delete_local_net('VDD', role='power-supply')

参数：

参数	类型	说明
`name`	`str`	要删除的 Net 名称
`role`	`str`	可选，要匹配的角色

返回： bool - 删除成功时为 True

`Net.rename_local_net(old_name, new_name)`

重命名一个 Net 配置。

Net.rename_local_net('OLD_NAME', 'NEW_NAME')

参数：

参数	类型	说明
`old_name`	`str`	当前的 Net 名称
`new_name`	`str`	新的 Net 名称

返回： bool - 重命名成功时为 True

`Net.get_local_nets()`

获取全部本地 Net 配置。

nets = Net.get_local_nets()
for net in nets:
    print(f"{net['name']}: {net['role']}")

返回： list[dict] - Net 配置字典的列表

`Net.save_local_nets(nets)`

一次保存多个 Net 配置。

Net.save_local_nets([
    {'name': 'VDD', 'role': 'power-supply', 'pin': '1', 'instrument': 'Rigol_DP832', 'address': '192.168.1.100'},
    {'name': 'GND', 'role': 'power-supply', 'pin': '2', 'instrument': 'Rigol_DP832', 'address': '192.168.1.100'}
])

参数：

参数	类型	说明
`nets`	`list[dict]`	Net 配置字典的列表

`Net.delete_all_local_nets()`

从 Lager Box 删除全部 Net 配置。

Net.delete_all_local_nets()

返回： bool - 删除成功时为 True

`Net.filter_nets(all_nets, name, role=None)`

返回去掉了与名称（以及可选的角色）匹配的 Net 之后的列表。delete_local_net() 使用的就是这个辅助函数。若要查找某个 Net，请自行过滤列表：[n for n in all_nets if n['name'] == 'VDD']。

all_nets = Net.get_local_nets()

# Every net except the ones named 'VDD'
without_vdd = Net.filter_nets(all_nets, 'VDD')

# Every net except 'VDD' with this role
without_vdd_psu = Net.filter_nets(all_nets, 'VDD', role='power-supply')

参数：

参数	类型	说明
`all_nets`	`list[dict]`	要搜索的 Net 列表
`name`	`str`	要去掉的 Net 名称
`role`	`str`	可选，要匹配的角色

返回： list[dict] - 不匹配的 Net

`enable()`

启用该 Net 并连接硬件。

scope = Net.get('PROBE', type=NetType.Analog)
scope.enable()  # Connect to oscilloscope

不同 Net 类型的行为：

Analog：连接多路复用器并启用示波器通道
Logic：启用逻辑分析仪通道
Battery：打开电池仿真输出
PowerSupply：打开电源输出
ELoad：打开电子负载

`disable(teardown=True)`

停用该 Net 并断开硬件连接。

scope.disable()  # Disconnect and run teardown
scope.disable(teardown=False)  # Disconnect without teardown

参数：

参数	类型	默认值	说明
`teardown`	`bool`	`True`	是否调用 teardown 函数

NetType 枚举

可用的 Net 类型：

NetType	角色字符串	说明
`NetType.Analog`	`analog`、`scope`、`scope-channel`	示波器。`scope` Net 是整台仪器；`scope-channel` Net 是它的一个通道
`NetType.Logic`	`logic`	逻辑分析仪输入
`NetType.Waveform`	`waveform`	尚未实现。没有驱动支持此类型，因此 `Net.get()` 会引发错误。请参阅 #844
`NetType.Battery`	`battery`	电池模拟器
`NetType.PowerSupply`	`power-supply`	电源
`NetType.ELoad`	`eload`	电子负载
`NetType.GPIO`	`gpio`	数字 I/O
`NetType.ADC`	`adc`	模数转换器
`NetType.DAC`	`dac`	数模转换器
`NetType.Thermocouple`	`thermocouple`	温度传感器
`NetType.DMM`	`dmm`	台式万用表
`NetType.Hsm`	`hsm`	硬件安全模块
`NetType.WattMeter`	`watt-meter`	功率计
`NetType.EnergyAnalyzer`	`energy-analyzer`	能量分析仪
`NetType.UART`	`uart`	串行通信
`NetType.SPI`	`spi`	SPI 总线
`NetType.I2C`	`i2c`	I2C 总线
`NetType.Webcam`	`webcam`	摄像头串流
`NetType.Router`	`router`、`mikrotik`	MikroTik 路由器
`NetType.Debug`	`debug`	调试探针
`NetType.Arm`	`arm`	机械臂
`NetType.Usb`	`usb`	USB 设备
`NetType.Rotation`	`rotation`	旋转编码器
`NetType.Wifi`	`wifi`	WiFi 模块
`NetType.Actuate`	`actuate`	执行器控制
`NetType.PowerSupply2Q`	`power-supply-2q`	双象限电源。太阳能 Net 以角色 `solar` 保存，不使用此类型；请参阅太阳能仿真

属性

`name`

获取 Net 名称。

print(net.name)  # 'VDD'

`type`

获取 Net 类型。

print(net.type)  # NetType.PowerSupply

示例

列出并使用 Net

from lager import Net, NetType

# List all available nets
nets = Net.list_saved()
print("Available nets:")
for net in nets:
    print(f"  {net['name']}: {net['role']}")

# Get and use a specific net
psu = Net.get('VDD', type=NetType.PowerSupply)
psu.set_voltage(3.3)
psu.enable()

简单的 Net（GPIO、ADC、DAC）

from lager import Net, NetType

# GPIO - no enable/disable needed
button = Net.get('BUTTON', type=NetType.GPIO)
state = button.input()

led = Net.get('LED', type=NetType.GPIO)
led.output(1)

# ADC - no enable/disable needed
sensor = Net.get('SENSOR', type=NetType.ADC)
voltage = sensor.input()

# DAC - no enable/disable needed
vref = Net.get('VREF', type=NetType.DAC)
vref.output(2.5)

复杂的 Net（电源、示波器）

from lager import Net, NetType

# Power supply - requires enable/disable
psu = Net.get('VDD', type=NetType.PowerSupply)
psu.set_voltage(3.3)
psu.set_current(0.5)
psu.enable()
# ... use the power supply ...
psu.disable()

# Oscilloscope - requires enable/disable
scope = Net.get('PROBE', type=NetType.Analog)
scope.enable()
freq = scope.measurement.frequency()
scope.disable()

管理 Net 配置

from lager import Net

# Save a new net
Net.save_local_net({
    'name': 'NEW_PSU',
    'role': 'power-supply',
    'pin': '2',
    'instrument': 'Rigol_DP832',
    'address': '192.168.1.100'
})

# Rename a net
Net.rename_local_net('NEW_PSU', 'MAIN_POWER')

# Delete a net
Net.delete_local_net('MAIN_POWER')

说明

简单的 Net（GPIO、ADC、DAC、Thermocouple）可直接使用，不需要 enable()/disable() 调用
复杂的 Net（Analog、Logic、PowerSupply、Battery、ELoad）在使用前需要先 enable()
用完复杂的 Net 之后，请务必调用 disable() 以正确释放硬件
Net 名称必须与 Lager Box 上配置的名称一致
用 Net.list_saved() 查看全部可用的 Net

入门

开发

电源与仿真

测量

I/O 与通信

实用工具

导入

类方法

实例方法

方法参考

`Net.get(name, type, *, setup_function=None, teardown_function=None)`

`Net.list_saved()`

`Net.list_all_from_env()`

`Net.save_local_net(data)`

`Net.delete_local_net(name, role=None)`

`Net.rename_local_net(old_name, new_name)`

`Net.get_local_nets()`

`Net.save_local_nets(nets)`

`Net.delete_all_local_nets()`

`Net.filter_nets(all_nets, name, role=None)`

`enable()`

`disable(teardown=True)`

NetType 枚举

属性

`name`

`type`

示例

列出并使用 Net

简单的 Net（GPIO、ADC、DAC）

复杂的 Net（电源、示波器）

管理 Net 配置

说明