gdbstub.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 Intel Corporation.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#include <inttypes.h>
 
#ifndef ZEPHYR_INCLUDE_ARCH_XTENSA_GDBSTUB_SYS_H_
#define ZEPHYR_INCLUDE_ARCH_XTENSA_GDBSTUB_SYS_H_
 
#ifdef CONFIG_GDBSTUB
 
#define XTREG_GRP_MASK                  0x0F00
#define XTREG_GRP_GENERAL               0x0000
#define XTREG_GRP_ADDR                  0x0100
#define XTREG_GRP_SPECIAL               0x0200
#define XTREG_GRP_USER                  0x0300
 
struct xtensa_register {
        uint32_t        val;
 
        uint8_t         idx;
 
        uint8_t         byte_size;
 
        uint16_t        regno;
 
        int16_t         gpkt_offset;
 
        int8_t          stack_offset;
 
        uint8_t         seqno;
 
        uint8_t         is_read_only:1;
};
 
/* Due to Xtensa SoCs being highly configurable,
 * the register files between SoCs are not identical.
 *
 * This means generic registers can, sometimes, have
 * different offsets from start of register files
 * needed to communicate with GDB.
 *
 * Therefore, it is better to defer to the SoC layer
 * for proper support for GDB.
 */
#include <gdbstub/soc.h>
 
struct gdb_ctx {
        unsigned int            exception;
 
        struct xtensa_register  *regs;
 
        uint8_t                 num_regs;
 
        uint8_t                 seqno;
 
        uint8_t                 a0_idx;
 
        uint8_t                 ar_idx;
 
        uint8_t                 wb_idx;
};
 
static inline bool gdb_xtensa_is_logical_addr_reg(struct xtensa_register *reg)
{
        if (reg->regno < 16) {
                return true;
        } else {
                return false;
        }
}
 
static inline bool gdb_xtensa_is_address_reg(struct xtensa_register *reg)
{
        if ((reg->regno & XTREG_GRP_MASK) == XTREG_GRP_ADDR) {
                return true;
        } else {
                return false;
        }
}
 
static inline bool gdb_xtensa_is_special_reg(struct xtensa_register *reg)
{
        if ((reg->regno & XTREG_GRP_MASK) == XTREG_GRP_SPECIAL) {
                return true;
        } else {
                return false;
        }
}
 
static inline bool gdb_xtensa_is_user_reg(struct xtensa_register *reg)
{
        if ((reg->regno & XTREG_GRP_MASK) == XTREG_GRP_USER) {
                return true;
        } else {
                return false;
        }
}
 
#endif /* CONFIG_GDBSTUB */
 
#endif /* ZEPHYR_INCLUDE_ARCH_XTENSA_GDBSTUB_SYS_H_ */