]> git.sur5r.net Git - openocd/blobdiff - src/target/register.h
flash/at91sam4: fix clang static analyzer warning
[openocd] / src / target / register.h
index 422fbd29318b5f0c8fdb67f9b085c94e3f1c6f33..32c1f39aceadc50b55673de05137a994565a3182 100644 (file)
  *   GNU General Public License for more details.                          *
  *                                                                         *
  *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
  ***************************************************************************/
-#ifndef REGISTER_H
-#define REGISTER_H
 
-#include "types.h"
+#ifndef OPENOCD_TARGET_REGISTER_H
+#define OPENOCD_TARGET_REGISTER_H
 
-struct target_s;
+struct target;
 
-struct bitfield_desc
-{
-       char *name;
-       int num_bits;
+enum reg_type {
+       REG_TYPE_BOOL,
+       REG_TYPE_INT,
+       REG_TYPE_INT8,
+       REG_TYPE_INT16,
+       REG_TYPE_INT32,
+       REG_TYPE_INT64,
+       REG_TYPE_INT128,
+       REG_TYPE_UINT,
+       REG_TYPE_UINT8,
+       REG_TYPE_UINT16,
+       REG_TYPE_UINT32,
+       REG_TYPE_UINT64,
+       REG_TYPE_UINT128,
+       REG_TYPE_CODE_PTR,
+       REG_TYPE_DATA_PTR,
+       REG_TYPE_FLOAT,
+       REG_TYPE_IEEE_SINGLE,
+       REG_TYPE_IEEE_DOUBLE,
+       REG_TYPE_ARCH_DEFINED,
 };
 
-typedef struct reg_s
-{
-       char *name;
+struct reg_feature {
+       const char *name;
+};
+
+struct reg_data_type_vector {
+       struct reg_data_type *type;
+       uint32_t count;
+};
+
+struct reg_data_type_union_field {
+       const char *name;
+       struct reg_data_type *type;
+       struct reg_data_type_union_field *next;
+};
+
+struct reg_data_type_union {
+       struct reg_data_type_union_field *fields;
+};
+
+struct reg_data_type_bitfield {
+       uint32_t start;
+       uint32_t end;
+       enum reg_type type;
+};
+
+struct reg_data_type_struct_field {
+       const char *name;
+       bool use_bitfields;
+       union {
+               struct reg_data_type_bitfield *bitfield;
+               struct reg_data_type *type;
+       };
+       struct reg_data_type_struct_field *next;
+};
+
+struct reg_data_type_struct {
+       uint32_t size;
+       struct reg_data_type_struct_field *fields;
+};
+
+struct reg_data_type_flags_field {
+       const char *name;
+       struct reg_data_type_bitfield *bitfield;
+       struct reg_data_type_flags_field *next;
+};
+
+struct reg_data_type_flags {
+       uint32_t size;
+       struct reg_data_type_flags_field *fields;
+};
+
+enum reg_data_type_class {
+       REG_TYPE_CLASS_VECTOR,
+       REG_TYPE_CLASS_UNION,
+       REG_TYPE_CLASS_STRUCT,
+       REG_TYPE_CLASS_FLAGS,
+};
+
+struct reg_data_type {
+       enum reg_type type;
+       const char *id;
+       enum reg_data_type_class type_class;
+       union {
+               struct reg_data_type_vector *reg_type_vector;
+               struct reg_data_type_union *reg_type_union;
+               struct reg_data_type_struct *reg_type_struct;
+               struct reg_data_type_flags *reg_type_flags;
+       };
+};
+
+struct reg {
+       /* Canonical name of the register. */
+       const char *name;
+       /* Number that gdb uses to access this register. */
+       uint32_t number;
+       /* TODO. This should probably be const. */
+       struct reg_feature *feature;
+       /* TODO: When true, the caller will save this register before running any algorithm. */
+       bool caller_save;
+       /* Pointer to place where the value is stored, in the format understood by
+        * the binarybuffer.h functions. */
        void *value;
-       int dirty;
-       int valid;
+       /* The stored value needs to be written to the target. */
+       bool dirty;
+       /* When true, value is valid. */
+       bool valid;
+       /* When false, the register doesn't actually exist in the target. */
+       bool exist;
+       /* Size of the register in bits. */
        uint32_t size;
-       struct bitfield_desc *bitfield_desc;
-       int num_bitfields;
+       /* Used for generating XML description of registers. Can be set to NULL for
+        * targets that don't use that. */
+       struct reg_data_type *reg_data_type;
+       /* Used for generating XML description of registers. Can be set to NULL for
+        * targets that don't use that. */
+       const char *group;
+       /* Pointer to architecture-specific info for this register. */
        void *arch_info;
-       int arch_type;
-} reg_t;
+       const struct reg_arch_type *type;
+};
 
-struct reg_cache
-{
-       char *name;
+struct reg_cache {
+       const char *name;
        struct reg_cache *next;
-       reg_t *reg_list;
-       int num_regs;
+       struct reg *reg_list;
+       unsigned num_regs;
 };
 
-typedef struct reg_arch_type_s
-{
-       int id;
-       int (*get)(reg_t *reg);
-       int (*set)(reg_t *reg, uint8_t *buf);
-       struct reg_arch_type_s *next;
-} reg_arch_type_t;
+struct reg_arch_type {
+       int (*get)(struct reg *reg);
+       int (*set)(struct reg *reg, uint8_t *buf);
+};
 
-reg_t* register_get_by_name(struct reg_cache *first,
+struct reg *register_get_by_name(struct reg_cache *first,
                const char *name, bool search_all);
-struct reg_cache** register_get_last_cache_p(struct reg_cache **first);
-
-int register_reg_arch_type(int (*get)(reg_t *reg),
-               int (*set)(reg_t *reg, uint8_t *buf));
-reg_arch_type_t* register_get_arch_type(int id);
+struct reg_cache **register_get_last_cache_p(struct reg_cache **first);
+void register_unlink_cache(struct reg_cache **cache_p, const struct reg_cache *cache);
+void register_cache_invalidate(struct reg_cache *cache);
 
-void register_init_dummy(reg_t *reg);
+void register_init_dummy(struct reg *reg);
 
-#endif /* REGISTER_H */
+#endif /* OPENOCD_TARGET_REGISTER_H */