VNA automation에서 channel, trace, trigger와 data format은 왜 따로 관리할까?

객체 축: channel → measurement → trace → data

• Channel: frequency, power, IFBW, averaging와 trigger 같은 sweep state를 가진다.
• Measurement: S11, S21처럼 receiver ratio를 정의한다.
• Trace/window: measurement를 front-panel에 어떤 format·scale로 보일지 연결한다.
• Data: corrected/un-corrected complex pair 또는 formatted values를 host로 가져온다.

Display trace가 없어도 measurement data를 query할 수 있고, trace format을 Smith로 바꿔도 underlying corrected complex SDATA가 Smith 좌표로 바뀌어 저장되는 것은 아니다.

시간 축: configure → trigger → complete → fetch

INIT1:IMM은 acquisition을 시작하거나 trigger를 기다리도록 arm하는 명령이다. Host write가 끝난 순간 receiver sweep까지 끝났다는 뜻이 아니다. TRIG:SOUR IMM이면 INIT가 즉시 trigger event가 되고, MAN이면 *TRG, EXT이면 실제 external edge가 있어야 sweep가 시작된다. 그 뒤 *OPC? 또는 장비가 문서화한 status/event synchronization으로 완료를 확인하고 data를 가져온다.

가상 console도 idle → armed → sweeping → complete를 분리한다. MAN/EXT가 armed인 동안 *OPC?는 완료 1을 위조하지 않고 would-time-out으로 남는다. Event와 completion 전 SDAT?/FDAT?는 −230 stale data로 거절한다. EXT는 console의 EXT edge simulation 버튼으로 한 번의 edge를 재현한다.

VISA alias와 identity를 configuration으로 받는다

Keysight IO Libraries Suite/Connection Expert에서 장비를 발견하고 alias를 만든다. Production code는 IP를 source에 하드코딩하지 않고 E5080B_VISA_RESOURCE 또는 CLI argument로 승인된 alias/resource를 받는다.

import os
import pyvisa

resource = os.environ["E5080B_VISA_RESOURCE"]
rm = pyvisa.ResourceManager()
vna = rm.open_resource(resource)
vna.timeout = 20_000
vna.read_termination = "\n"
vna.write_termination = "\n"

try:
    identity = vna.query("*IDN?").strip()
    if "E5080B" not in identity:
        raise RuntimeError(f"unexpected instrument: {identity}")
    vna.write("OUTP OFF")
finally:
    try:
        vna.write("OUTP OFF")
    finally:
        vna.close()
        rm.close()

사이트와 함께 제공하는 E5080B PyVISA 실행 가이드의 예제는 dry-run이 기본이다. 실제 통신은 --execute, source enable은 추가 --rf-on consent가 필요하다. Physical RF ON은 DUT input limit, receiver working limit, 최대 DUT gain을 명시하고 signed path gain/loss·uncertainty·guard를 포함한 worst-case envelope와 full configuration query-back이 통과해야 한다. S12/S22처럼 port 2 source를 쓰는 physical acquisition은 세 번째 --reverse-drive consent가 없으면 driver와 CLI 양쪽에서 거절한다.

안전한 single-S21 acquisition

*IDN?
*OPT?
OUTP OFF
*CLS
SYST:POW1:LIM -20 DBM
SYST:POW1:LIM:STAT ON
SOUR1:POW1 -30 DBM
SENS1:FREQ:STAR 1 GHZ
SENS1:FREQ:STOP 6 GHZ
SENS1:SWE:POIN 201
SENS1:BWID 1 KHZ
CALC1:PAR:DEF:EXT 'RF_WIKI_S21','S21'
CALC1:PAR:SEL 'RF_WIKI_S21'
CALC1:PAR:MNUM?
TRIG:SOUR IMM
OUTP ON
INIT1:IMM
*OPC?
FORM:DATA ASC,0
FORM:DATA?
SENS1:CORR:STAT?
SENS1:CORR:CSET:ACT? NAME
CALC1:MEAS<mnum>:X:VAL?
CALC1:MEAS<mnum>:DATA:SDAT?
SYST:ERR?
OUTP OFF

<mnum>은 RF_WIKI_S21을 선택한 뒤 CALC1:PAR:MNUM?으로 읽은 실제 번호로 치환한다. 저장된 상태가 우연히 MEAS1이라고 추측하지 않는다. 예제는 ASCII를 강제하고 FORM:DATA?를 확인하며, correction ON과 active CalSet name이 사용자가 지정한 --expected-calset과 일치할 때만 결과를 corrected SDATA로 표시한다. OUTP ON은 identity, *OPT?의 2K0, limit, DUT, receiver protection과 bias preflight가 통과한 별도 단계에만 둔다.

*OPC?와 timeout을 함께 설계한다

• Timeout은 longest valid sweep보다 길고 hang detection에는 충분히 짧게 정한다.
• Sweep time은 points, IFBW, averaging, calibration/fixture math와 trigger 조건에 따라 바뀐다.
• MAN/EXT에서 event가 오지 않으면 *OPC?가 기다리는 것이 정상이다. Timeout을 sweep 완료로 바꾸거나 이전 trace를 새 data로 반환하지 않는다.
• 순서는 INIT → trigger event → *OPC?=1 → SDATA/FDATA다. 새 configuration 또는 ABOR 뒤에는 data를 stale로 되돌린다.
• *OPC? timeout 뒤 같은 sweep를 무조건 재시작하지 않는다. Instrument state와 pending operation을 먼저 진단한다.
• Abort path에서는 ABOR, OUTP OFF, error/status capture 순서를 장비 문서와 station safety policy에 맞춘다.
• Network loss에서는 software OFF가 보장되지 않으므로 hardware interlock가 필요하다.

SDATA 배열 검증

1. 고유 measurement name을 정의·선택하고 MNUM?으로 data query 대상 번호를 확인한다.
2. FORM:DATA?가 코드가 해석할 ASCII 또는 명시된 binary format과 같은지 확인한다.
3. SENS1:CORR:STAT?와 active CalSet name을 확인한다. 하나라도 다르면 “corrected” label을 붙이지 않는다.
4. X:VAL?의 frequency count가 requested points와 같은지 확인한다.
5. SDATA scalar count가 2 × points인지 확인한다.
6. [Re0, Im0, Re1, Im1, ...]로 complex pair를 만든다.
7. NaN/Inf, truncated block와 unexpected endian을 거절한다.
8. Measurement name/number, parameter, correction/CalSet state와 stimulus snapshot을 data artifact에 함께 저장한다.
9. Marker 값과 first/middle/last point를 front panel에서 spot-check한다.

ASCII와 binary를 분리해 구현한다

• ASCII는 사람이 확인하기 쉽지만 느리고 문자열 parsing 오버헤드가 크다.
• REAL,32는 빠르고 compact하지만 definite-length block header와 byte order를 정확히 처리해야 한다.
• FORM:BORD SWAP 또는 NORM의 의미를 host endian과 라이브러리 option에 맞춰 확인한다.
• Binary query에서 text termination을 payload에 임의 적용하지 않는다.
• Block payload bytes와 declared length, 4-byte scalar count를 검증한다.

Error queue는 no-error까지 제한된 drain을 한다

def drain_errors(vna, maximum=32):
    records = []
    for _ in range(maximum):
        response = vna.query("SYST:ERR?").strip()
        records.append(response)
        if response.startswith("+0,") or response.startswith("0,"):
            nonzero = [record for record in records if not record.startswith(("+0,", "0,"))]
            if nonzero:
                raise RuntimeError(f"configuration failed: {nonzero}")
            return records
    raise RuntimeError("error queue did not reach no-error within bound")

*CLS는 status를 정리하지만 원하는 channel/measurement/calibration을 구성하지 않는다. 기존 오류를 log하기 전에 무조건 *CLS로 지우면 원인 증거가 사라진다. Drain 끝에서 +0을 보았더라도 앞서 nonzero record가 있었다면 configure 실패로 RF ON을 차단한다.

S[k] = data[2k] + j·data[2k+1],   k=0…N−1

Mag_dB=20log₁₀√(Re²+Im²),   φ=atan2(Im,Re)

RDATA, SDATA, FDATA 선택 원칙

• RDATA: receiver/raw correction 단계 분석이 필요할 때만 해당 command의 정확한 semantics를 문서에서 확인한다.
• SDATA: corrected complex S-parameter를 후처리·저장할 때 기본 선택이다.
• FDATA: front-panel display와 같은 formatted marker/trace 값을 재현할 때 사용한다.

Data access spelling과 반환 구조는 E5080B firmware A.20.25.03 online help를 source of truth로 둔다. PNA나 E5081A 예제의 명령을 이름이 비슷하다는 이유로 섞지 않는다.

한 transaction의 최소 log

timestamp · VISA resource alias · *IDN? · *OPT? · firmware · channel state · measurement definition · correction/CalSet ID · trigger source · *OPC? latency · data format/endian · point count · error queue · cleanup result

Cause/Effect를 자기 말로 닫기

“INIT1:IMM이 channel sweep를 시작했기 때문에 host write 성공만으로 SDATA를 읽지 않고 *OPC?로 완료를 동기화했다. 그 뒤 frequency N개와 SDATA 2N개를 확인해 complex pair로 묶었고, correction state·measurement ID·error queue와 함께 저장했다.”