// // Copyright 2019 Ettus Research, a National Instruments Brand // // SPDX-License-Identifier: GPL-3.0-or-later // #pragma once #include #include #include #include #include #include #include namespace uhd { namespace rfnoc { /*! MPM-Specific version of the mb_controller * * Reminder: There is one of these per motherboard. * * This motherboard controller abstracts out a bunch of RPC calls. */ class mpmd_mb_controller : public mb_controller, public ::uhd::features::discoverable_feature_registry { public: using sptr = std::shared_ptr; mpmd_mb_controller(uhd::usrp::mpmd_rpc_iface::sptr rpcc, uhd::device_addr_t device_info); //! Return reference to the RPC client uhd::rpc_client::sptr get_rpc_client() { return _rpc->get_raw_rpc_client(); } template std::shared_ptr dynamic_cast_rpc_as() { return std::dynamic_pointer_cast(_rpc); } /************************************************************************** * Timekeeper API *************************************************************************/ //! MPM-specific version of the timekeeper controls // // MPM devices talk to MPM via RPC to control the timekeeper class mpmd_timekeeper : public mb_controller::timekeeper { public: using sptr = std::shared_ptr; mpmd_timekeeper(const size_t tk_idx, uhd::usrp::mpmd_rpc_iface::sptr rpc_client) : _tk_idx(tk_idx), _rpc(rpc_client) { // nop } uint64_t get_ticks_now() override; uint64_t get_ticks_last_pps() override; void set_ticks_now(const uint64_t ticks) override; void set_ticks_next_pps(const uint64_t ticks) override; void set_period(const uint64_t period_ns) override; /*! Update the tick rate * Note: This is separate from set_tick_rate because the latter is * protected, and we need to implement mpmd-specific functionality here */ void update_tick_rate(const double tick_rate); private: const size_t _tk_idx; uhd::usrp::mpmd_rpc_iface::sptr _rpc; }; /************************************************************************** * Motherboard Control API (see mb_controller.hpp) *************************************************************************/ std::string get_mboard_name() const override; void set_time_source(const std::string& source) override; std::string get_time_source() const override; std::vector get_time_sources() const override; void set_clock_source(const std::string& source) override; std::string get_clock_source() const override; std::vector get_clock_sources() const override; void set_sync_source( const std::string& clock_source, const std::string& time_source) override; void set_sync_source(const uhd::device_addr_t& sync_source) override; uhd::device_addr_t get_sync_source() const override; std::vector get_sync_sources() override; void set_clock_source_out(const bool enb) override; void set_time_source_out(const bool enb) override; uhd::sensor_value_t get_sensor(const std::string& name) override; std::vector get_sensor_names() override; uhd::usrp::mboard_eeprom_t get_eeprom() override; std::vector get_gpio_banks() const override; std::vector get_gpio_srcs(const std::string& bank) const override; std::vector get_gpio_src(const std::string& bank) override; void set_gpio_src( const std::string& bank, const std::vector& src) override; void register_sync_source_updater( mb_controller::sync_source_updater_t callback_f) override; private: /************************************************************************** * Attributes *************************************************************************/ //! Reference to RPC interface mutable uhd::usrp::mpmd_rpc_iface::sptr _rpc; uhd::device_addr_t _device_info; //! List of MB sensor names std::unordered_set _sensor_names; //! Cache of available GPIO sources std::vector _gpio_banks; std::unordered_map> _gpio_srcs; std::vector _sync_source_updaters; public: /*! When the FPGA is reloaded, pass the notification to every Radio block * Public to allow other classes to register for notifications. */ class fpga_onload : public uhd::features::fpga_load_notification_iface { public: using sptr = std::shared_ptr; fpga_onload(); void onload() override; void request_cb(uhd::features::fpga_load_notification_iface::sptr handler); private: std::vector> _cbs; }; //! Class to expose the ref_clk_calibration discoverable feature functions. class ref_clk_calibration : public uhd::features::ref_clk_calibration_iface { public: using sptr = std::shared_ptr; ref_clk_calibration(uhd::usrp::mpmd_rpc_iface::sptr rpcc); void set_ref_clk_tuning_word(uint32_t tuning_word) override; uint32_t get_ref_clk_tuning_word() override; void store_ref_clk_tuning_word(uint32_t tuning_word) override; private: uhd::usrp::mpmd_rpc_iface::sptr _rpcc; }; fpga_onload::sptr _fpga_onload; ref_clk_calibration::sptr _ref_clk_cal; }; }} // namespace uhd::rfnoc