170 lines
7.4 KiB
Python
170 lines
7.4 KiB
Python
"""Raw acquisition producer for the external Kamil ADC radar mode."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from contextlib import ExitStack
|
|
import logging
|
|
import threading
|
|
import time
|
|
|
|
import numpy as np
|
|
|
|
from python_app.hardware_full.kamil_adc import KamilAdcService
|
|
from python_app.hardware_full.switch_service import SwitchService, select_and_settle
|
|
from python_app.models.dataset_model import ComboKey, SweepCollection, TraceData
|
|
from python_app.models.run_config_schema import RunConfigModel
|
|
from python_app.scripts.producer_common import RawPublisher, close_devices, load_producer_config, retry_open
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def _open_radar_with_retry(
|
|
config: RunConfigModel,
|
|
radar: KamilAdcService,
|
|
input_switch: SwitchService | None,
|
|
output_switch: SwitchService | None,
|
|
stop_requested: threading.Event,
|
|
) -> bool:
|
|
"""Reopen the ADC and Python-owned switches, cleaning partial opens before retry."""
|
|
close_devices(input_switch, output_switch, radar)
|
|
|
|
def attempt() -> KamilAdcService:
|
|
try:
|
|
radar.open(stop_event=stop_requested)
|
|
radar.configure(config.radar.sweep)
|
|
if output_switch is not None:
|
|
output_switch.open()
|
|
if input_switch is not None:
|
|
input_switch.open()
|
|
except Exception:
|
|
close_devices(input_switch, output_switch, radar)
|
|
raise
|
|
return radar
|
|
|
|
return retry_open(attempt, stop_requested, "Kamil ADC") is not None
|
|
|
|
|
|
def main() -> int:
|
|
"""Run producer process until config or signal requests exit."""
|
|
config_path, config, stop_requested = load_producer_config("Publish Kamil ADC raw sweeps to SHM rings")
|
|
if not config.is_kamil_adc:
|
|
raise RuntimeError("kamil_adc_raw_producer requires radar.model='kamil_adc'")
|
|
logger.info(
|
|
"Kamil ADC raw producer starting: config=%s, combos=%d, continuous=%s",
|
|
config_path, len(config.combos), config.runtime.continuous,
|
|
)
|
|
|
|
radar = input_switch = output_switch = None
|
|
cleanup = ExitStack()
|
|
try:
|
|
publisher = RawPublisher(config.rings, cleanup)
|
|
# Switch-aware mode: with native switches the collector drives the RF switches
|
|
# itself, in the hardware gap between sweeps, and tags each sweep with its combo
|
|
# — no sweep lost at a switch boundary. The producer then only reads tagged
|
|
# sweeps and must not touch the GPIO lines the collector owns. With mock switches
|
|
# (dev/tests) we keep the Python-driven path, which is fine where speed and the
|
|
# in-gap timing do not matter.
|
|
collector_driven = (
|
|
config.input_switch.driver_mode == "native"
|
|
and config.output_switch.driver_mode == "native"
|
|
)
|
|
radar = KamilAdcService(
|
|
config,
|
|
switch_config_path=str(config_path) if collector_driven else None,
|
|
)
|
|
input_switch = None if collector_driven else SwitchService.from_model(config.input_switch)
|
|
output_switch = None if collector_driven else SwitchService.from_model(config.output_switch)
|
|
logger.info(
|
|
"Kamil ADC switch control: %s",
|
|
"collector-driven (in-gap, lossless)" if collector_driven else "producer-driven",
|
|
)
|
|
|
|
if not _open_radar_with_retry(config, radar, input_switch, output_switch, stop_requested):
|
|
return 0 # asked to stop before a device became available
|
|
|
|
collection_id = 1
|
|
while not stop_requested.is_set():
|
|
collection_start = time.monotonic()
|
|
capture_start_ns = time.monotonic_ns()
|
|
traces: list[TraceData] = []
|
|
|
|
try:
|
|
for combo in config.combos:
|
|
if stop_requested.is_set():
|
|
break
|
|
if collector_driven:
|
|
# The collector already switched and tagged the sweep; just
|
|
# read the clean capture for this combination.
|
|
sweep_start_ns = time.monotonic_ns()
|
|
sweep = radar.acquire(combo=(combo.input, combo.output))
|
|
else:
|
|
if input_switch is None or output_switch is None:
|
|
raise RuntimeError("Producer-driven switches are not initialized")
|
|
if not select_and_settle(output_switch, input_switch, combo.output, combo.input,
|
|
config.runtime.settling_ms, wait=stop_requested.wait):
|
|
break
|
|
# Stamped after switching and settling so the window covers
|
|
# the sweep alone, not the dead time before it.
|
|
sweep_start_ns = time.monotonic_ns()
|
|
sweep = radar.acquire()
|
|
traces.append(
|
|
TraceData(
|
|
combo=ComboKey(input=combo.input, output=combo.output),
|
|
frequency_hz=np.asarray(sweep.x, dtype=np.float32),
|
|
s21=np.asarray(sweep.trace("s21"), dtype=np.complex64),
|
|
capture_start_ns=sweep_start_ns,
|
|
capture_end_ns=time.monotonic_ns(),
|
|
)
|
|
)
|
|
except Exception as exc: # noqa: BLE001 — reconnect forever, never give up
|
|
logger.warning(
|
|
"Kamil ADC acquisition failed; reconnecting and waiting for the device: %s",
|
|
exc,
|
|
exc_info=True,
|
|
)
|
|
if not _open_radar_with_retry(config, radar, input_switch, output_switch, stop_requested):
|
|
break # stop requested while waiting to reconnect
|
|
continue
|
|
|
|
# An incomplete sweep set means the device dropped out (or a stop was
|
|
# requested mid-collection). Only exit on stop; otherwise reconnect and
|
|
# wait for the device rather than killing the producer.
|
|
if len(traces) != len(config.combos):
|
|
if stop_requested.is_set():
|
|
break
|
|
logger.warning(
|
|
"Kamil ADC produced an incomplete collection (%d of %d combos); "
|
|
"reconnecting and waiting for the device",
|
|
len(traces),
|
|
len(config.combos),
|
|
)
|
|
if not _open_radar_with_retry(config, radar, input_switch, output_switch, stop_requested):
|
|
break # stop requested while waiting to reconnect
|
|
continue
|
|
|
|
collection = SweepCollection(
|
|
collection_id=collection_id,
|
|
monotonic_ns=time.monotonic_ns(),
|
|
traces=traces,
|
|
capture_start_ns=capture_start_ns,
|
|
capture_end_ns=time.monotonic_ns(),
|
|
)
|
|
publisher.publish(collection)
|
|
|
|
if not config.runtime.continuous:
|
|
break
|
|
collection_duration_s = time.monotonic() - collection_start
|
|
if collection_id == 1 or collection_id % 20 == 0 or collection_duration_s > 2.0:
|
|
logger.info("Kamil ADC collection %d acquired in %.3f s", collection_id, collection_duration_s)
|
|
collection_id += 1
|
|
finally:
|
|
close_devices(output_switch, input_switch, radar)
|
|
cleanup.close()
|
|
|
|
logger.info("Kamil ADC raw producer stopped")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|