Discover

VISA instrument discovery: scan resources, query identity, match to known drivers.

VisaInstrumentInfo dataclass

VisaInstrumentInfo(
    resource: str,
    idn: str,
    category: str,
    driver_class_name: str,
    num_channels: int | None,
)

resource instance-attribute

resource: str

idn instance-attribute

idn: str

category instance-attribute

category: str

driver_class_name instance-attribute

driver_class_name: str

num_channels instance-attribute

num_channels: int | None

VisaScanError dataclass

VisaScanError(resource: str, message: str, hint: str | None = None)

resource instance-attribute

resource: str

message instance-attribute

message: str

hint class-attribute instance-attribute

hint: str | None = None

VisaUnrecognizedInstrument dataclass

VisaUnrecognizedInstrument(resource: str, idn: str)

resource instance-attribute

resource: str

idn instance-attribute

idn: str

VisaScanResult dataclass

VisaScanResult(
    instruments: list[VisaInstrumentInfo],
    unrecognized: list[VisaUnrecognizedInstrument],
    errors: list[VisaScanError],
)

instruments instance-attribute

instruments: list[VisaInstrumentInfo]

unrecognized instance-attribute

unrecognized: list[VisaUnrecognizedInstrument]

errors instance-attribute

errors: list[VisaScanError]

scan_visa_resources

scan_visa_resources(
    backend: str | None = None,
    timeout: int = 2,
    *,
    rm: ResourceManager | None = None,
) -> VisaScanResult

Scan VISA resources, query each for identity, and return matched instruments.

Pass an already-open rm (e.g. one a caller opened via _open_resource_manager for its own backend diagnostics) with the backend string used to open it, to reuse that resource manager instead of opening a second one.