aboutsummaryrefslogtreecommitdiffstats
path: root/host/include
diff options
context:
space:
mode:
Diffstat (limited to 'host/include')
-rw-r--r--host/include/uhd/rfnoc/block_id.hpp2
-rw-r--r--host/include/uhd/rfnoc/mb_controller.hpp1
-rw-r--r--host/include/uhd/rfnoc/node.hpp8
-rw-r--r--host/include/uhd/rfnoc/radio_control.hpp3
-rw-r--r--host/include/uhd/rfnoc/register_iface.hpp1
-rw-r--r--host/include/uhd/usrp/multi_usrp.hpp8
-rw-r--r--host/include/uhd/utils/gain_group.hpp1
-rw-r--r--host/include/uhd/utils/graph_utils.hpp3
8 files changed, 16 insertions, 11 deletions
diff --git a/host/include/uhd/rfnoc/block_id.hpp b/host/include/uhd/rfnoc/block_id.hpp
index d15220aa7..113124eea 100644
--- a/host/include/uhd/rfnoc/block_id.hpp
+++ b/host/include/uhd/rfnoc/block_id.hpp
@@ -26,7 +26,7 @@ namespace rfnoc {
*
* The rules for formatting such a string are:
*
- * DEVICE/BLOCKNAME#COUNTER
+ * DEVICE/BLOCKNAME\#COUNTER
*
* DEVICE: Identifies the device (usually the motherboard index)
* BLOCKNAME: A name given to this block
diff --git a/host/include/uhd/rfnoc/mb_controller.hpp b/host/include/uhd/rfnoc/mb_controller.hpp
index 0269301ff..e6276d39c 100644
--- a/host/include/uhd/rfnoc/mb_controller.hpp
+++ b/host/include/uhd/rfnoc/mb_controller.hpp
@@ -345,6 +345,7 @@ public:
* motherboard controller are removed from the list.
* On return, the list should be (ideally) identical
* to its value at call time.
+ * \param time_spec Time specification to syncrhonize \p mb_controllers to
* \param quiet If true, don't print any errors or warnings if
* synchronization fails.
* \returns true if all motherboards that were removed from \p mb_controllers
diff --git a/host/include/uhd/rfnoc/node.hpp b/host/include/uhd/rfnoc/node.hpp
index 33831a4d7..9424a6b58 100644
--- a/host/include/uhd/rfnoc/node.hpp
+++ b/host/include/uhd/rfnoc/node.hpp
@@ -114,7 +114,7 @@ public:
* be of a different type than \p prop_data_t due to the usage of runtime
* type information (RTTI), a lookup_error is thrown.
*
- * \param prop_data_t The data type of the property
+ * \tparam prop_data_t The data type of the property
* \param id The identifier of the property to write. To find out which
* values of \p id are valid, call get_property_ids()
* \param instance The instance number of this property
@@ -148,7 +148,7 @@ public:
* This is because internally, it can resolve properties, which may cause
* changes within the object.
*
- * \param prop_data_t The data type of the property
+ * \tparam prop_data_t The data type of the property
* \param id The identifier of the property to write.
* \param instance The instance number of this property
* \return The value of the property.
@@ -279,7 +279,7 @@ protected:
* This is like set_property(), but it also allows setting edge properties.
* All comments from set_property() still apply.
*
- * \param prop_data_t The data type of the property
+ * \tparam prop_data_t The data type of the property
* \param id The identifier of the property to write. To find out which
* values of \p id are valid, call get_property_ids()
* \param val The new value of the property.
@@ -294,7 +294,7 @@ protected:
* This is like get_property(), but it also allows reading edge properties.
* All comments from get_property() still apply.
*
- * \param prop_data_t The data type of the property
+ * \tparam prop_data_t The data type of the property
* \param id The identifier of the property to write.
* \param src_info Source info of this property
* \return The value of the property.
diff --git a/host/include/uhd/rfnoc/radio_control.hpp b/host/include/uhd/rfnoc/radio_control.hpp
index 4b1bd3d82..01fcb1d48 100644
--- a/host/include/uhd/rfnoc/radio_control.hpp
+++ b/host/include/uhd/rfnoc/radio_control.hpp
@@ -554,7 +554,7 @@ public:
/*! Enable/disable the automatic IQ imbalance correction.
*
- * \param enb true to enable automatic IQ balance correction
+ * \param correction the complex correction (1.0 is full-scale)
* \param chan the channel index 0 to N-1
*/
virtual void set_rx_iq_balance(
@@ -582,7 +582,6 @@ public:
* \param bank the name of a GPIO bank (e.g., FP0)
* \param attr the name of a GPIO attribute (e.g., CTRL)
* \param value the new value for this GPIO bank
- * \param mask the bit mask to effect which pins are changed
*/
virtual void set_gpio_attr(const std::string& bank,
const std::string& attr,
diff --git a/host/include/uhd/rfnoc/register_iface.hpp b/host/include/uhd/rfnoc/register_iface.hpp
index 23f24b242..5d95e6aae 100644
--- a/host/include/uhd/rfnoc/register_iface.hpp
+++ b/host/include/uhd/rfnoc/register_iface.hpp
@@ -84,6 +84,7 @@ public:
* (truncated to 20 bits).
* \param data New value of the register(s).
* \param time The time at which the transaction should be executed.
+ * \param ack Should transaction completion be acknowledged?
*
* \throws op_failed if the transaction fails
* \throws op_timeout if no response is received
diff --git a/host/include/uhd/usrp/multi_usrp.hpp b/host/include/uhd/usrp/multi_usrp.hpp
index 4efc062b0..9742a8ab6 100644
--- a/host/include/uhd/usrp/multi_usrp.hpp
+++ b/host/include/uhd/usrp/multi_usrp.hpp
@@ -1539,13 +1539,14 @@ public:
* Enumerate the available filters in the RX signal path.
* \param chan RX channel index 0 to N-1
* \return a vector of strings representing the selected filter names.
- * \returnblock Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
+ * \return Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
*/
virtual std::vector<std::string> get_rx_filter_names(const size_t chan) = 0;
/*!
* Return the filter object for the given RX filter name.
* \param name the name of the filter as returned from get_rx_filter_names().
+ * \param chan RX channel index 0 to N-1
* \return a filter_info_base::sptr.
*/
virtual uhd::filter_info_base::sptr get_rx_filter(const std::string& name, const size_t chan) = 0;
@@ -1555,6 +1556,7 @@ public:
* This filter can be a modified version of the originally returned one.
* \param name the name of the filter as returned from get_rx_filter_names().
* \param filter the filter_info_base::sptr of the filter object to be written
+ * \param chan RX channel index 0 to N-1
*/
virtual void set_rx_filter(
const std::string& name, uhd::filter_info_base::sptr filter, const size_t chan) = 0;
@@ -1564,13 +1566,14 @@ public:
* Enumerate the available filters in the TX signal path.
* \param chan TX channel index 0 to N-1
* \return a vector of strings representing the selected filter names.
- * \returnblock Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
+ * \return Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
*/
virtual std::vector<std::string> get_tx_filter_names(const size_t chan) = 0;
/*!
* Return the filter object for the given TX filter name.
* \param name the name of the filter as returned from get_tx_filter_names().
+ * \param chan TX channel index 0 to N-1
* \return a filter_info_base::sptr.
*/
virtual uhd::filter_info_base::sptr get_tx_filter(const std::string& name, const size_t chan) = 0;
@@ -1580,6 +1583,7 @@ public:
* This filter can be a modified version of the originally returned one.
* \param name the name of the filter as returned from get_tx_filter_names().
* \param filter the filter_info_base::sptr of the filter object to be written
+ * \param chan TX channel index 0 to N-1
*/
virtual void set_tx_filter(
const std::string& name, uhd::filter_info_base::sptr filter, const size_t chan) = 0;
diff --git a/host/include/uhd/utils/gain_group.hpp b/host/include/uhd/utils/gain_group.hpp
index bfc6a94a6..5901d71bb 100644
--- a/host/include/uhd/utils/gain_group.hpp
+++ b/host/include/uhd/utils/gain_group.hpp
@@ -94,7 +94,6 @@ public:
/*!
* Make a new gain group with all zero values.
- * \param name the name of the (only and zero-valued) gain element
* \return a gain group object populated with zeroes
*/
static sptr make_zero();
diff --git a/host/include/uhd/utils/graph_utils.hpp b/host/include/uhd/utils/graph_utils.hpp
index b2c61f78f..1cdfe389c 100644
--- a/host/include/uhd/utils/graph_utils.hpp
+++ b/host/include/uhd/utils/graph_utils.hpp
@@ -39,7 +39,7 @@ static const std::vector<block_port_def> TERMINATOR_BLOCKS{
* \param graph The rfnoc_graph that is being examined
* \param start_block The block we begin to build the chain from
* \param port The block port of `src_port` that the path will begin at
- * \param source_block Whether or not the `start_block` is a source (or a destination).
+ * \param source_chain Whether or not the `start_block` is a source (or a destination).
* If true, the chain will start at `start_block`'s output port. If
* false, the chain will start with `start_block`'s output port.
* \return The edge list representing the data path requested
@@ -52,6 +52,7 @@ std::vector<graph_edge_t> UHD_API get_block_chain(const rfnoc_graph::sptr graph,
/*! Connect desired blocks by whatever path that can be found
*
+ * \param graph The rfnoc_graph that is being examined
* \param src_blk Source block's ID
* \param src_port Block port where the path starts
* \param dst_blk Destination block's ID
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-29 11:41:24 +0000