diff options
author | Martin Braun <martin.braun@ettus.com> | 2021-12-09 12:41:26 +0100 |
---|---|---|
committer | Aaron Rossetto <aaron.rossetto@ni.com> | 2022-03-17 14:00:06 -0500 |
commit | a120837195ebbd5c216cc10da8a075bf8a5b26f5 (patch) | |
tree | d767333250ef225382e3e381027dd9c441471625 /mpm/python/usrp_mpm | |
parent | cfcb97616ae6cd852804eade3afd322e5adc48d2 (diff) | |
download | uhd-a120837195ebbd5c216cc10da8a075bf8a5b26f5.tar.gz uhd-a120837195ebbd5c216cc10da8a075bf8a5b26f5.tar.bz2 uhd-a120837195ebbd5c216cc10da8a075bf8a5b26f5.zip |
mpm: Factor out common code between E31x_db and Neon classes
These classes share a *lot* of common code, due to them both being
AD9361-based devices. This code is now factored out into a single file.
Diffstat (limited to 'mpm/python/usrp_mpm')
-rw-r--r-- | mpm/python/usrp_mpm/dboard_manager/CMakeLists.txt | 1 | ||||
-rw-r--r-- | mpm/python/usrp_mpm/dboard_manager/__init__.py | 1 | ||||
-rw-r--r-- | mpm/python/usrp_mpm/dboard_manager/ad936x_db.py | 170 | ||||
-rw-r--r-- | mpm/python/usrp_mpm/dboard_manager/e31x_db.py | 164 | ||||
-rw-r--r-- | mpm/python/usrp_mpm/dboard_manager/neon.py | 200 |
5 files changed, 222 insertions, 314 deletions
diff --git a/mpm/python/usrp_mpm/dboard_manager/CMakeLists.txt b/mpm/python/usrp_mpm/dboard_manager/CMakeLists.txt index 49ab58b40..574cb871c 100644 --- a/mpm/python/usrp_mpm/dboard_manager/CMakeLists.txt +++ b/mpm/python/usrp_mpm/dboard_manager/CMakeLists.txt @@ -17,6 +17,7 @@ set(USRP_MPM_DBMGR_FILES ${CMAKE_CURRENT_SOURCE_DIR}/lmk_rh.py ${CMAKE_CURRENT_SOURCE_DIR}/adc_rh.py ${CMAKE_CURRENT_SOURCE_DIR}/dac_rh.py + ${CMAKE_CURRENT_SOURCE_DIR}/ad936x_db.py ${CMAKE_CURRENT_SOURCE_DIR}/neon.py ${CMAKE_CURRENT_SOURCE_DIR}/e31x_db.py ${CMAKE_CURRENT_SOURCE_DIR}/gain_rh.py diff --git a/mpm/python/usrp_mpm/dboard_manager/__init__.py b/mpm/python/usrp_mpm/dboard_manager/__init__.py index 761ab57db..2d3d2f092 100644 --- a/mpm/python/usrp_mpm/dboard_manager/__init__.py +++ b/mpm/python/usrp_mpm/dboard_manager/__init__.py @@ -11,6 +11,7 @@ from usrp_mpm import __simulated__ if not __simulated__: from .magnesium import Magnesium from .rhodium import Rhodium + from .ad936x_db import AD936xDboard from .neon import Neon from .e31x_db import E31x_db from .empty_slot import EmptySlot diff --git a/mpm/python/usrp_mpm/dboard_manager/ad936x_db.py b/mpm/python/usrp_mpm/dboard_manager/ad936x_db.py new file mode 100644 index 000000000..092d6c4de --- /dev/null +++ b/mpm/python/usrp_mpm/dboard_manager/ad936x_db.py @@ -0,0 +1,170 @@ +# +# Copyright 2021 Ettus Research, a National Instruments Brand +# +# SPDX-License-Identifier: GPL-3.0-or-later +# +""" +Common daughterboard code for E310 and E320 +""" + +from usrp_mpm import lib # Pulls in everything from C++-land +from usrp_mpm.mpmutils import async_exec + +class AD936xDboard: + """ + Holds all common code between E310 and E320 (AD936x-based MPM devices) + """ + MIN_MASTER_CLK_RATE = 220e3 + MAX_MASTER_CLK_RATE = 61.44e6 + + def __init__(self, mb_regs_getter): + self.rfic = None + self.log = None + self.master_clock_rate = None + self.swap_fe = False + self._mb_regs_getter = mb_regs_getter + + def tear_down_rfic(self): + """ + De-init this object as much as possible. + """ + self.log.trace("Tearing down E3xx DB object!") + for method in [ + x for x in dir(self.rfic) + if not x.startswith("_") and callable(getattr(self.rfic, x))]: + delattr(self, method) + self.rfic = None + + def _init_cat_api(self, rfic): + """ + Propagate the C++ Catalina API into Python land. + """ + self.rfic = rfic + def export_method(obj, method): + " Export a method object, including docstring " + meth_obj = getattr(obj, method) + def func(*args): + " Functor for storing docstring too " + return meth_obj(*args) + func.__doc__ = meth_obj.__doc__ + return func + self.log.trace("Forwarding AD9361 methods to daughterboard class...") + for method in [ + x for x in dir(self.rfic) + if not x.startswith("_") and \ + callable(getattr(self.rfic, x))]: + self.log.trace("adding {}".format(method)) + setattr(self, method, export_method(rfic, method)) + + def init_rfic(self, master_clock_rate): + """ + Initialize chains and clock rate on AD936x + """ + assert self.MIN_MASTER_CLK_RATE <= master_clock_rate <= self.MAX_MASTER_CLK_RATE, \ + "Invalid master clock rate: {:.02f} MHz".format( + master_clock_rate / 1e6) + master_clock_rate_changed = master_clock_rate != self.master_clock_rate + if master_clock_rate_changed: + self.master_clock_rate = master_clock_rate + self.log.debug("Updating master clock rate to {:.02f} MHz!".format( + self.master_clock_rate / 1e6 + )) + # Some default chains on -- needed for setup purposes + self.rfic.set_active_chains(True, False, True, False) + self.set_catalina_clock_rate(self.master_clock_rate) + + def get_ad9361_lo_lock(self, which): + """ + Return LO lock status (Boolean!) of AD9361. 'which' must be + either 'tx' or 'rx' + """ + mboard_regs_control = self._mb_regs_getter() + if which == "tx": + return mboard_regs_control.get_ad9361_tx_lo_lock() + if which == "rx": + return mboard_regs_control.get_ad9361_rx_lo_lock() + self.log.warning("get_ad9361_lo_lock(): Invalid which param `{}'" + .format(which)) + return False + + def get_lo_lock_sensor(self, which): + """ + Get sensor dict with LO lock status + """ + self.log.trace("Reading LO Lock.") + lo_locked = self.get_ad9361_lo_lock(which) + return { + 'name': 'ad9361_lock', + 'type': 'BOOLEAN', + 'unit': 'locked' if lo_locked else 'unlocked', + 'value': str(lo_locked).lower(), + } + + def get_rx_lo_lock_sensor(self, _chan): + """ + RX-specific version of get_lo_lock_sensor() (for UHD API) + """ + return self.get_lo_lock_sensor('rx') + + def get_tx_lo_lock_sensor(self, _chan): + """ + TX-specific version of get_lo_lock_sensor() (for UHD API) + """ + return self.get_lo_lock_sensor('tx') + + def get_catalina_temp_sensor(self, _): + """ + Get temperature sensor reading of Catalina. + """ + # Note: the unused argument is channel + self.log.trace("Reading Catalina temperature.") + return { + 'name': 'ad9361_temperature', + 'type': 'REALNUM', + 'unit': 'C', + 'value': str(self.rfic.get_temperature()) + } + + def get_rssi_val(self, which): + """ + Return the current RSSI of `which` chain in Catalina + """ + return self.rfic.get_rssi(which) + + def get_rssi_sensor(self, chan): + """ + Return a sensor dictionary containing the current RSSI per channel + in the RFIC + """ + which = { + # No frontend swap: + False: {0: 'RX1', 1: 'RX2'}, + # Frontend swap: + True: {0: 'RX2', 1: 'RX1'}, + }[self.swap_fe][chan] + return { + 'name': 'rssi', + 'type': 'REALNUM', + 'unit': 'dB', + 'value': str(self.get_rssi_val(which)), + } + + def set_catalina_clock_rate(self, rate): + """ + Async call to catalina set_clock_rate + """ + self.log.trace("Setting Clock rate to {}".format(rate)) + async_exec(lib.ad9361, "set_clock_rate", self.rfic, rate) + return rate + + def catalina_tune(self, which, freq): + """ + Async call to catalina tune + """ + self.log.trace("Tuning {} {}".format(which, freq)) + async_exec(lib.ad9361, "tune", self.rfic, which, freq) + return self.rfic.get_freq(which) + + def get_master_clock_rate(self): + " Return master clock rate (== sampling rate) " + return self.master_clock_rate diff --git a/mpm/python/usrp_mpm/dboard_manager/e31x_db.py b/mpm/python/usrp_mpm/dboard_manager/e31x_db.py index d95e3a13a..a8fd5e491 100644 --- a/mpm/python/usrp_mpm/dboard_manager/e31x_db.py +++ b/mpm/python/usrp_mpm/dboard_manager/e31x_db.py @@ -9,19 +9,15 @@ E310 dboard (RF and control) implementation module """ from usrp_mpm import lib # Pulls in everything from C++-land -from usrp_mpm.dboard_manager import DboardManagerBase +from usrp_mpm.dboard_manager import DboardManagerBase, AD936xDboard from usrp_mpm.mpmlog import get_logger from usrp_mpm.periph_manager.e31x_periphs import MboardRegsControl -from usrp_mpm.mpmutils import async_exec +DEFAULT_MASTER_CLOCK_RATE = 16e6 ############################################################################### # Main dboard control class ############################################################################### -DEFAULT_MASTER_CLOCK_RATE = 16E6 -MIN_MASTER_CLK_RATE = 220E3 -MAX_MASTER_CLK_RATE = 61.44E6 - -class E31x_db(DboardManagerBase): +class E31x_db(DboardManagerBase, AD936xDboard): """ Holds all dboard specific information and methods of the E31x_db dboard """ @@ -53,18 +49,17 @@ class E31x_db(DboardManagerBase): mboard_regs_label = "mboard-regs" def __init__(self, slot_idx, **kwargs): - super(E31x_db, self).__init__(slot_idx, **kwargs) + DboardManagerBase.__init__(self, slot_idx, **kwargs) + AD936xDboard.__init__( + self, lambda: MboardRegsControl(self.mboard_regs_label, self.log)) self.log = get_logger("E31x_db-{}".format(slot_idx)) self.log.trace("Initializing e31x daughterboard, slot index %d", self.slot_idx) + self.swap_fe = True self.rev = int(self.device_info['rev']) self.log.trace("This is a rev: {}".format(chr(65 + self.rev))) # These will get updated during init() self.master_clock_rate = None - # Predeclare some attributes to make linter happy: - self.catalina = None - self.eeprom_fs = None - self.eeprom_path = None # Now initialize all peripherals. If that doesn't work, put this class # into a non-functional state (but don't crash, or we can't talk to it # any more): @@ -80,33 +75,11 @@ class E31x_db(DboardManagerBase): Initialize power and peripherals that don't need user-settings """ self.log.debug("Loading C++ drivers...") - # Setup Catalina / the E31x_db Manager - self._device = lib.dboards.e31x_db_manager( - self._spi_nodes['catalina'] - ) - self.catalina = self._device.get_radio_ctrl() + # Setup AD9361 / the E31x_db Manager + self._device = lib.dboards.e31x_db_manager(self._spi_nodes['catalina']) + ad936x_rfic = self._device.get_radio_ctrl() self.log.trace("Loaded C++ drivers.") - self._init_cat_api(self.catalina) - - def _init_cat_api(self, cat): - """ - Propagate the C++ Catalina API into Python land. - """ - def export_method(obj, method): - " Export a method object, including docstring " - meth_obj = getattr(obj, method) - def func(*args): - " Functor for storing docstring too " - return meth_obj(*args) - func.__doc__ = meth_obj.__doc__ - return func - self.log.trace("Forwarding AD9361 methods to E31x_db class...") - for method in [ - x for x in dir(self.catalina) - if not x.startswith("_") and \ - callable(getattr(self.catalina, x))]: - self.log.trace("adding {}".format(method)) - setattr(self, method, export_method(cat, method)) + self._init_cat_api(ad936x_rfic) def init(self, args): """ @@ -119,122 +92,11 @@ class E31x_db(DboardManagerBase): raise RuntimeError(error_msg) master_clock_rate = \ float(args.get('master_clock_rate', DEFAULT_MASTER_CLOCK_RATE)) - assert MIN_MASTER_CLK_RATE <= master_clock_rate <= MAX_MASTER_CLK_RATE, \ - "Invalid master clock rate: {:.02f} MHz".format( - master_clock_rate / 1e6) - master_clock_rate_changed = master_clock_rate != self.master_clock_rate - if master_clock_rate_changed: - self.master_clock_rate = master_clock_rate - self.log.debug("Updating master clock rate to {:.02f} MHz!".format( - self.master_clock_rate / 1e6 - )) - # Some default chains on -- needed for setup purposes - self.catalina.set_active_chains(True, False, True, False) - self.set_catalina_clock_rate(self.master_clock_rate) + self.init_rfic(master_clock_rate) return True def tear_down(self): """ De-init this object as much as possible. """ - self.log.trace("Tearing down E310 DB object!") - for method in [ - x for x in dir(self.catalina) - if not x.startswith("_") and \ - callable(getattr(self.catalina, x))]: - delattr(self, method) - self.catalina = None - - def get_master_clock_rate(self): - " Return master clock rate (== sampling rate) " - return self.master_clock_rate - - ########################################################################## - # Sensors - ########################################################################## - def get_ad9361_lo_lock(self, which): - """ - Return LO lock status (Boolean!) of AD9361. 'which' must be - either 'tx' or 'rx' - """ - assert which in ('rx', 'tx') - mboard_regs_control = \ - MboardRegsControl(self.mboard_regs_label, self.log) - if which == "tx": - return mboard_regs_control.get_ad9361_tx_lo_lock() - # else: - return mboard_regs_control.get_ad9361_rx_lo_lock() - - def get_lo_lock_sensor(self, which): - """ - Get sensor dict with LO lock status - """ - assert which in ('rx', 'tx') - self.log.trace("Reading LO Lock.") - lo_locked = self.get_ad9361_lo_lock(which) - return { - 'name': 'ad9361_lock', - 'type': 'BOOLEAN', - 'unit': 'locked' if lo_locked else 'unlocked', - 'value': str(lo_locked).lower(), - } - - def get_rx_lo_lock_sensor(self, _chan): - """ - RX-specific version of get_lo_lock_sensor() (for UHD API) - """ - return self.get_lo_lock_sensor('rx') - - def get_tx_lo_lock_sensor(self, _chan): - """ - TX-specific version of get_lo_lock_sensor() (for UHD API) - """ - return self.get_lo_lock_sensor('tx') - - def get_catalina_temp_sensor(self, _): - """ - Get temperature sensor reading of Catalina. - """ - # Note: the unused argument is channel - self.log.trace("Reading Catalina temperature.") - return { - 'name': 'ad9361_temperature', - 'type': 'REALNUM', - 'unit': 'C', - 'value': str(self.catalina.get_temperature()) - } - - def get_rssi_val(self, which): - """ - Return the current RSSI of `which` chain in Catalina - """ - return self.catalina.get_rssi(which) - - def get_rssi_sensor(self, chan): - """ - Return a sensor dictionary containing the current RSSI of `which` chain - in the RFIC - """ - which = 'RX' + str(chan+1) - return { - 'name': 'rssi', - 'type': 'REALNUM', - 'unit': 'dB', - 'value': str(self.get_rssi_val(which)), - } - - def set_catalina_clock_rate(self, rate): - """ - Async call to catalina set_clock_rate - """ - self.log.trace("Setting Clock rate to {} MHz".format(rate/1e6)) - async_exec(lib.ad9361, "set_clock_rate", self.catalina, rate) - return rate - - def catalina_tune(self, which, freq): - """ - Async call to catalina tune - """ - self.log.trace("Tuning {} {}".format(which, freq)) - async_exec(lib.ad9361, "tune", self.catalina, which, freq) - return self.catalina.get_freq(which) + self.tear_down_rfic() diff --git a/mpm/python/usrp_mpm/dboard_manager/neon.py b/mpm/python/usrp_mpm/dboard_manager/neon.py index 1f8f9b190..cf79e2626 100644 --- a/mpm/python/usrp_mpm/dboard_manager/neon.py +++ b/mpm/python/usrp_mpm/dboard_manager/neon.py @@ -8,22 +8,19 @@ E320 dboard (RF and control) implementation module """ import threading -import time -from six import iterkeys, iteritems from usrp_mpm import lib # Pulls in everything from C++-land from usrp_mpm.bfrfs import BufferFS from usrp_mpm.chips import ADF400x -from usrp_mpm.dboard_manager import DboardManagerBase +from usrp_mpm.dboard_manager import DboardManagerBase, AD936xDboard from usrp_mpm.mpmlog import get_logger from usrp_mpm.sys_utils.udev import get_eeprom_paths -from usrp_mpm.sys_utils.uio import UIO from usrp_mpm.periph_manager.e320_periphs import MboardRegsControl -from usrp_mpm.mpmutils import async_exec +DEFAULT_MASTER_CLOCK_RATE = 16e6 ############################################################################### # Main dboard control class ############################################################################### -class Neon(DboardManagerBase): +class Neon(DboardManagerBase, AD936xDboard): """ Holds all dboard specific information and methods of the neon dboard """ @@ -52,6 +49,8 @@ class Neon(DboardManagerBase): spi_chipselect = {"catalina": 0, "adf4002": 1} ### End of overridables ################################################# + # MB regs label: Needed to access the lock bit + mboard_regs_label = "mboard-regs" # This map describes how the user data is stored in EEPROM. If a dboard rev # changes the way the EEPROM is used, we add a new entry. If a dboard rev # is not found in the map, then we go backward until we find a suitable rev @@ -64,12 +63,10 @@ class Neon(DboardManagerBase): }, } - default_master_clock_rate = 16e6 - MIN_MASTER_CLK_RATE = 220e3 - MAX_MASTER_CLK_RATE = 61.44e6 - def __init__(self, slot_idx, **kwargs): - super(Neon, self).__init__(slot_idx, **kwargs) + DboardManagerBase.__init__(self, slot_idx, **kwargs) + AD936xDboard.__init__( + self, lambda: MboardRegsControl(self.mboard_regs_label, self.log)) self.log = get_logger("Neon-{}".format(slot_idx)) self.log.trace("Initializing Neon daughterboard, slot index %d", self.slot_idx) @@ -78,7 +75,6 @@ class Neon(DboardManagerBase): # These will get updated during init() self.master_clock_rate = None # Predeclare some attributes to make linter happy: - self.catalina = None self.eeprom_fs = None self.eeprom_path = None # Now initialize all peripherals. If that doesn't work, put this class @@ -88,8 +84,7 @@ class Neon(DboardManagerBase): self._init_periphs() self._periphs_initialized = True except Exception as ex: - self.log.error("Failed to initialize peripherals: %s", - str(ex)) + self.log.error("Failed to initialize peripherals: %s", str(ex)) self._periphs_initialized = False def _init_periphs(self): @@ -108,37 +103,38 @@ class Neon(DboardManagerBase): self.adf4002 = ADF400x(adf4002_spi, freq=E320_DEFAULT_INT_CLOCK_FREQ, parent_log=self.log) - # Setup Catalina / the Neon Manager - self._device = lib.dboards.neon_manager( - self._spi_nodes['catalina'] - ) - self.catalina = self._device.get_radio_ctrl() + # Set up AD9361 / the Neon Manager + self._device = lib.dboards.neon_manager(self._spi_nodes['catalina']) + ad936x_rfic = self._device.get_radio_ctrl() self.log.trace("Loaded C++ drivers.") - self._init_cat_api(self.catalina) + self._init_cat_api(ad936x_rfic) self.eeprom_fs, self.eeprom_path = self._init_user_eeprom( self._get_user_eeprom_info(self.rev) ) - def _init_cat_api(self, cat): + def init(self, args): """ - Propagate the C++ Catalina API into Python land. + Initialize the RFIC portion of the E320 (rest happens in e320.init()) """ - def export_method(obj, method): - " Export a method object, including docstring " - meth_obj = getattr(obj, method) - def func(*args): - " Functor for storing docstring too " - return meth_obj(*args) - func.__doc__ = meth_obj.__doc__ - return func - self.log.trace("Forwarding AD9361 methods to Neon class...") - for method in [ - x for x in dir(self.catalina) - if not x.startswith("_") and \ - callable(getattr(self.catalina, x))]: - self.log.trace("adding {}".format(method)) - setattr(self, method, export_method(cat, method)) + if not self._periphs_initialized: + error_msg = "Cannot run init(), peripherals are not initialized!" + self.log.error(error_msg) + raise RuntimeError(error_msg) + master_clock_rate = \ + float(args.get('master_clock_rate', DEFAULT_MASTER_CLOCK_RATE)) + self.init_rfic(master_clock_rate) + return True + ########################################################################### + # Clocking + ########################################################################### + def update_ref_clock_freq(self, freq): + """Update the reference clock frequency""" + self.adf4002.set_ref_freq(freq) + + ########################################################################### + # EEPROM Control + ########################################################################### def _get_user_eeprom_info(self, rev): """ Return an EEPROM access map (from self.user_eeprom) based on the rev. @@ -146,8 +142,8 @@ class Neon(DboardManagerBase): rev_for_lookup = rev while rev_for_lookup not in self.user_eeprom: if rev_for_lookup < 0: - raise RuntimeError("Could not find a user EEPROM map for " - "revision %d!", rev) + raise RuntimeError( + f"Could not find a user EEPROM map for revision {rev}!") rev_for_lookup -= 1 assert rev_for_lookup in self.user_eeprom, \ "Invalid EEPROM lookup rev!" @@ -174,36 +170,13 @@ class Neon(DboardManagerBase): log=self.log ), eeprom_path - def init(self, args): - if not self._periphs_initialized: - error_msg = "Cannot run init(), peripherals are not initialized!" - self.log.error(error_msg) - raise RuntimeError(error_msg) - master_clock_rate = \ - float(args.get('master_clock_rate', - self.default_master_clock_rate)) - assert self.MIN_MASTER_CLK_RATE <= master_clock_rate <= self.MAX_MASTER_CLK_RATE, \ - "Invalid master clock rate: {:.02f} MHz".format( - master_clock_rate / 1e6) - master_clock_rate_changed = master_clock_rate != self.master_clock_rate - if master_clock_rate_changed: - self.master_clock_rate = master_clock_rate - self.log.debug("Updating master clock rate to {:.02f} MHz!".format( - self.master_clock_rate / 1e6 - )) - # Some default chains on -- needed for setup purposes - self.catalina.set_active_chains(True, False, True, False) - self.set_catalina_clock_rate(self.master_clock_rate) - - return True - def get_user_eeprom_data(self): """ Return a dict of blobs stored in the user data section of the EEPROM. """ return { blob_id: self.eeprom_fs.get_blob(blob_id) - for blob_id in iterkeys(self.eeprom_fs.entries) + for blob_id in self.eeprom_fs.entries.keys() } def set_user_eeprom_data(self, eeprom_data): @@ -218,7 +191,7 @@ class Neon(DboardManagerBase): However, get_user_eeprom_data() will immediately return the correct data after this method returns. """ - for blob_id, blob in iteritems(eeprom_data): + for blob_id, blob in eeprom_data.items(): self.eeprom_fs.set_blob(blob_id, blob) self.log.trace("Writing EEPROM info to `{}'".format(self.eeprom_path)) eeprom_offset = self.user_eeprom[self.rev]['offset'] @@ -256,102 +229,3 @@ class Neon(DboardManagerBase): # and MPM won't terminate this process until the thread is complete. # This does not stop anyone from killing this process (and the thread) # while the EEPROM write is happening, though. - - def get_master_clock_rate(self): - " Return master clock rate (== sampling rate) " - return self.master_clock_rate - - def update_ref_clock_freq(self, freq): - """Update the reference clock frequency""" - self.adf4002.set_ref_freq(freq) - - ########################################################################## - # Sensors - ########################################################################## - def get_ad9361_lo_lock(self, which): - """ - Return LO lock status (Boolean!) of AD9361. 'which' must be - either 'tx' or 'rx' - """ - assert which in ('rx', 'tx') - mboard_regs_label = "mboard-regs" - mboard_regs_control = MboardRegsControl( - mboard_regs_label, self.log) - if which == "tx": - locked = mboard_regs_control.get_ad9361_tx_lo_lock() - else: - locked = mboard_regs_control.get_ad9361_rx_lo_lock() - return locked - - def get_lo_lock_sensor(self, which): - """ - Get sensor dict with LO lock status - """ - assert which in ('rx', 'tx') - self.log.trace("Reading LO Lock.") - lo_locked = self.get_ad9361_lo_lock(which) - return { - 'name': 'ad9361_lock', - 'type': 'BOOLEAN', - 'unit': 'locked' if lo_locked else 'unlocked', - 'value': str(lo_locked).lower(), - } - - def get_rx_lo_lock_sensor(self, _chan): - """ - RX-specific version of get_lo_lock_sensor() (for UHD API) - """ - return self.get_lo_lock_sensor('rx') - - def get_tx_lo_lock_sensor(self, _chan): - """ - TX-specific version of get_lo_lock_sensor() (for UHD API) - """ - return self.get_lo_lock_sensor('tx') - - def get_catalina_temp_sensor(self, _): - """ - Get temperature sensor reading of Catalina. - """ - # Note: the unused argument is channel - self.log.trace("Reading Catalina temperature.") - return { - 'name': 'ad9361_temperature', - 'type': 'REALNUM', - 'unit': 'C', - 'value': str(self.catalina.get_temperature()) - } - - def get_rssi_val(self, which): - """ - Return the current RSSI of `which` chain in Catalina - """ - return self.catalina.get_rssi(which) - - def get_rssi_sensor(self, chan): - """ - Return a sensor dictionary containing the current RSSI of `which` chain in Catalina - """ - which = 'RX' + str(chan+1) - return { - 'name': 'rssi', - 'type': 'REALNUM', - 'unit': 'dB', - 'value': str(self.get_rssi_val(which)), - } - - def set_catalina_clock_rate(self, rate): - """ - Async call to catalina set_clock_rate - """ - self.log.trace("Setting Clock rate to {}".format(rate)) - async_exec(lib.ad9361, "set_clock_rate", self.catalina, rate) - return rate - - def catalina_tune(self, which, freq): - """ - Async call to catalina tune - """ - self.log.trace("Tuning {} {}".format(which, freq)) - async_exec(lib.ad9361, "tune", self.catalina, which, freq) - return self.catalina.get_freq(which) |