summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--utils/regtools/lib/soc_desc.cpp4
-rw-r--r--utils/regtools/lib/soc_desc.hpp19
2 files changed, 16 insertions, 7 deletions
diff --git a/utils/regtools/lib/soc_desc.cpp b/utils/regtools/lib/soc_desc.cpp
index 21c2f8acac..6a6d47648f 100644
--- a/utils/regtools/lib/soc_desc.cpp
+++ b/utils/regtools/lib/soc_desc.cpp
@@ -147,6 +147,7 @@ bool parse_field_elem(xmlNode *node, soc_reg_field_t& field)
BEGIN_ATTR_MATCH(node->properties)
MATCH_TEXT_ATTR("name", field.name)
MATCH_BITRANGE_ATTR("bitrange", field.first_bit, field.last_bit)
+ MATCH_TEXT_ATTR("desc", field.desc)
END_ATTR_MATCH()
BEGIN_NODE_MATCH(node->children)
@@ -194,6 +195,7 @@ bool parse_reg_elem(xmlNode *node, soc_reg_t& reg)
MATCH_TEXT_ATTR("name", reg.name)
SOFT_MATCH_SCT_ATTR("sct", reg.flags)
SOFT_MATCH_X_ATTR("addr", parse_add_trivial_addr, reg)
+ MATCH_TEXT_ATTR("desc", reg.desc)
END_ATTR_MATCH()
BEGIN_NODE_MATCH(node->children)
@@ -227,6 +229,8 @@ bool parse_dev_elem(xmlNode *node, soc_dev_t& dev)
{
BEGIN_ATTR_MATCH(node->properties)
MATCH_TEXT_ATTR("name", dev.name)
+ MATCH_TEXT_ATTR("long_name", dev.long_name)
+ MATCH_TEXT_ATTR("desc", dev.desc)
MATCH_TEXT_ATTR("version", dev.version)
END_ATTR_MATCH()
diff --git a/utils/regtools/lib/soc_desc.hpp b/utils/regtools/lib/soc_desc.hpp
index 0324a90fad..efaf813eb2 100644
--- a/utils/regtools/lib/soc_desc.hpp
+++ b/utils/regtools/lib/soc_desc.hpp
@@ -63,15 +63,17 @@ const soc_reg_flags_t REG_HAS_SCT = 1 << 0; /// register SCT variants
/** SoC register field named value */
struct soc_reg_field_value_t
{
- std::string name;
- soc_word_t value;
+ std::string name; /// name of the value
+ soc_word_t value; /// numeric value
+ std::string desc; /// human description
};
/** SoC register field */
struct soc_reg_field_t
{
- std::string name;
- unsigned first_bit, last_bit;
+ std::string name; /// name of the field
+ std::string desc; /// human description
+ unsigned first_bit, last_bit; /// bit range of the field
soc_word_t bitmask() const
{
@@ -94,7 +96,7 @@ struct soc_reg_field_t
struct soc_reg_addr_t
{
std::string name; /// actual register name
- soc_addr_t addr;
+ soc_addr_t addr; /// actual register address (relative to device)
};
/** SoC register formula */
@@ -108,8 +110,9 @@ struct soc_reg_formula_t
struct soc_reg_t
{
std::string name; /// generic name (for multi registers) or actual name
- std::vector< soc_reg_addr_t > addr;
- soc_reg_formula_t formula;
+ std::string desc; /// human description
+ std::vector< soc_reg_addr_t > addr; /// instances of the registers
+ soc_reg_formula_t formula; /// formula for the instance addresses
soc_reg_flags_t flags; /// ORed value
std::vector< soc_reg_field_t > field;
@@ -126,6 +129,8 @@ struct soc_dev_addr_t
struct soc_dev_t
{
std::string name; /// generic name (of multi devices) or actual name
+ std::string long_name; /// human friendly name
+ std::string desc; /// human description
std::string version; /// description version
std::vector< soc_dev_addr_t > addr;