USRP Hardware Driver and USRP Manual: uhd::rfnoc::registry Class Reference

| USRP Hardware Driver and USRP Manual Version: 4.8.0.makepkg-0-g308126a4 UHD and USRP Manual |

Loading...
Searching...
No Matches
Public Types | Static Public Member Functions | List of all members
uhd::rfnoc::registry Class Reference

`#include <uhd/rfnoc/registry.hpp>`

## Public Types
using | factory_t = std::function<noc_block_base::sptr(noc_block_base::make_args_ptr)>

## Static Public Member Functions
static void | register_block_direct (noc_id_t noc_id, device_type_t device_id, const std::string &block_name, bool mb_access, const std::string &timebase_clock, const std::string &ctrlport_clock, factory_t factory_fn)
static void | register_block_direct (std::vector< noc_id_t > noc_ids, device_type_t device_id, const std::string &block_name, bool mb_access, const std::string &timebase_clock, const std::string &ctrlport_clock, factory_t factory_fn)
static void | register_block_descriptor (const std::string &block_key, factory_t factory_fn)

## Detailed Description

RFNoC Block Registry

A container for various functions to register blocks

## Member Typedef Documentation

## ◆ factory_t

using uhd::rfnoc::registry::factory_t = std::function<noc_block_base::sptr(noc_block_base::make_args_ptr)>

## Member Function Documentation

## ◆ register_block_descriptor()

static void uhd::rfnoc::registry::register_block_descriptor | ( | const std::string & | block_key,
|  | factory_t | factory_fn )
| static

Register a block that does use a block descriptor file

Use this registry function for blocks that also have a textual description (block descriptor file).

For these blocks, the framework will first look up the Noc-ID from the blocks on the FPGA, and then find the corresponding block key by searching all the availble block descriptor files. When such a key is found, it will be used to find a block that was previously registered here.

## ◆ register_block_direct() [1/2]

static void uhd::rfnoc::registry::register_block_direct | ( | noc_id_t | noc_id,
|  | device_type_t | device_id,
|  | const std::string & | block_name,
|  | bool | mb_access,
|  | const std::string & | timebase_clock,
|  | const std::string & | ctrlport_clock,
|  | factory_t | factory_fn )
| static

Register a block that does not use a block descriptor file

Note: It is highly recommended to use the UHD_RFNOC_BLOCK_REGISTER_DIRECT() macro instead of calling this function.

Use this registry function for blocks that do not read from a textual description (block descriptor file).

If the Noc-ID is already registered, it will print an error to stderr and ignore the new block.

Parameters

  noc_id | The 32-bit Noc-ID for this block (e.g. 0xDDC00000).
  device_id | The 16-bit Device-ID for this block (ANY_DEVICE for device agnostic blocks).
  block_name | The name used for the block ID (e.g. "Radio").
  mb_access | Set this to true to request full access to the motherboard in the block controller. Radio blocks, for example, require this. If set, UHD may grant access to the underlying motherboard controller to the block. See also uhd::rfnoc::noc_block_base::get_mb_controller().
  timebase_clock | The name of the clock that is used for time reference on timed commands. Blocks that derive time from the graph (e.g. DDC, DUC blocks) should set this to uhd::rfnoc::CLOCK_KEY_GRAPH.
  ctrlport_clock | The name of the clock that is driving the control port. This is device-dependent. A typical value is `"bus_clk"`.
  factory_fn | A factory function that returns a reference to the block.

## ◆ register_block_direct() [2/2]

static void uhd::rfnoc::registry::register_block_direct | ( | std::vector< noc_id_t > | noc_ids,
|  | device_type_t | device_id,
|  | const std::string & | block_name,
|  | bool | mb_access,
|  | const std::string & | timebase_clock,
|  | const std::string & | ctrlport_clock,
|  | factory_t | factory_fn )
| static

Same as above, but with multiple noc_ids

The documentation for this class was generated from the following file:

- registry.hpp