openocd/src/target/riscv.c

#include <assert.h>

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "target.h"
#include "target_type.h"
#include "log.h"
#include "jtag/jtag.h"

#define get_field(reg, mask) (((reg) & (mask)) / ((mask) & ~((mask) << 1)))
#define set_field(reg, mask, val) (((reg) & ~(mask)) | (((val) * ((mask) & ~((mask) << 1))) & (mask)))

/*** JTAG registers. ***/

#define DTMINFO			0x10
#define DTMINFO_ADDRBITS	(0xf<<4)
#define DTMINFO_VERSION		(0xf)

#define DBUS			0x11

/*** Debug Bus registers. ***/

#define DMCONTROL		0x10
#define DMCONTROL_HALTNOT	(1L<<33)
#define DMCONTROL_INTERRUPT	(1L<<32)
#define DMCONTROL_BUSERROR	(7<<19)
#define DMCONTROL_SERIAL	(3<<16)
#define DMCONTROL_AUTOINCREMENT	(1<<15)
#define DMCONTROL_ACCESS	(7<<12)
#define DMCONTROL_HARTID	(0x3ff<<2)
#define DMCONTROL_NDRESET	(1<<1)
#define DMCONTROL_FULLRESET	1

#define DMINFO			0x11
#define DMINFO_ABUSSIZE		(0x7f<<25)
#define DMINFO_SERIALCOUNT	(0xf<<21)
#define DMINFO_ACCESS128	(1<<20)
#define DMINFO_ACCESS64		(1<<19)
#define DMINFO_ACCESS32		(1<<18)
#define DMINFO_ACCESS16		(1<<17)
#define DMINFO_ACCESS8		(1<<16)
#define DMINFO_DRAMSIZE		(0x3f<<10)
#define DMINFO_AUTHENTICATED	(1<<5)
#define DMINFO_AUTHBUSY		(1<<4)
#define DMINFO_AUTHTYPE		(3<<2)
#define DMINFO_VERSION		3

/*** Info about the core being debugged. ***/

#define DBUS_ADDRESS_UNKNOWN	0xffff

typedef struct {
	/* Number of address bits in the dbus register. */
	uint8_t addrbits;
	/* Width of a GPR (and many other things) in bits. */
	uint8_t xlen;
	/* Last value we wrote to DBUS_ADDRESS (eg. the address of the register
	 * whose value will be read the next time we scan dbus). */
	uint16_t dbus_address;
	/* Number of words in Debug RAM. */
	unsigned int dramsize;
	/* Our local copy of Debug RAM. */
	uint32_t *dram;
	/* One bit for every word in dram. If the bit is set, then we're
	 * confident that the value we have matches the one in actual Debug
	 * RAM. */
	uint64_t dram_valid;
} riscv_info_t;

/*** Utility functions. ***/

static uint64_t dbus_scan(struct target *target, uint16_t address,
		uint64_t data_out, bool read, bool write)
{
	riscv_info_t *info = (riscv_info_t *) target->arch_info;
	struct scan_field field;
	uint8_t in[8];
	uint8_t out[8];

	assert(info->addrbits != 0);

	// TODO: max bits is 32?
	field.num_bits = info->addrbits + 35;
	field.out_value = out;
	if (read) {
		field.in_value = in;
	}
	buf_set_u64(out, 0, 34, data_out);
	buf_set_u64(out, 34, info->addrbits, address);
	buf_set_u64(out, info->addrbits + 34, 1, write);

	/* Assume dbus is already selected. */
	jtag_add_dr_scan(target->tap, 1, &field, TAP_DRUPDATE);
	info->dbus_address = address;

	return buf_get_u64(in, 0, 34);
}

static uint64_t dbus_read(struct target *target, uint16_t address, uint16_t next_address)
{
	riscv_info_t *info = (riscv_info_t *) target->arch_info;

	if (address != info->dbus_address) {
		dbus_scan(target, address, 0, false, false);
	}
	return dbus_scan(target, next_address, 0, true, false);
}

static uint32_t dtminfo_read(struct target *target)
{
	struct scan_field field;
	uint8_t in[4];
	uint8_t out[4];

	field.num_bits = target->tap->ir_length;
	field.out_value = out;
	field.in_value = NULL;
	buf_set_u32(out, 0, field.num_bits, DTMINFO);
	jtag_add_ir_scan(target->tap, &field, TAP_DRSELECT);

	field.num_bits = 32;
	field.out_value = NULL;
	field.in_value = in;
	jtag_add_dr_scan(target->tap, 1, &field, TAP_DRUPDATE);

	/* Always return to dbus. */
	/* TODO: Can we rely on IR not being messed with between calls into
	 * RISCV code?  Eg. what happens if there are multiple cores and some
	 * other core is accessed? */
	field.num_bits = target->tap->ir_length;
	field.out_value = out;
	field.in_value = NULL;
	buf_set_u32(out, 0, field.num_bits, DBUS);
	jtag_add_ir_scan(target->tap, &field, TAP_DRSELECT);

	return buf_get_u32(field.in_value, 0, 32);
}

/*** OpenOCD target functions. ***/

static int riscv_init_target(struct command_context *cmd_ctx,
		struct target *target)
{
	target->arch_info = calloc(1, sizeof(riscv_info_t));
	if (!target->arch_info)
		return ERROR_FAIL;
	riscv_info_t *info = (riscv_info_t *) target->arch_info;
	info->dbus_address = DBUS_ADDRESS_UNKNOWN;

	return ERROR_OK;
}

static void riscv_deinit_target(struct target *target)
{
	riscv_info_t *info = (riscv_info_t *) target->arch_info;
	if (info->dram) {
		free(info->dram);
	}
	free(info);
	target->arch_info = NULL;
}

static int riscv_examine(struct target *target)
{
	if (target_was_examined(target)) {
		return ERROR_OK;
	}

	uint32_t dtminfo = dtminfo_read(target);
	riscv_info_t *info = (riscv_info_t *) target->arch_info;

	info->addrbits = get_field(dtminfo, DTMINFO_ADDRBITS);

	uint32_t dminfo = dbus_read(target, DMINFO, 0);
	info->dramsize = get_field(dminfo, DMINFO_DRAMSIZE) + 1;
	info->dram = malloc(info->dramsize * 4);
	if (!info->dram)
		return ERROR_FAIL;
	info->dram_valid = 0;

	if (get_field(dminfo, DMINFO_AUTHTYPE) != 0) {
		LOG_ERROR("Authentication required by RISC-V core but not "
				"supported by OpenOCD. dminfo=0x%x", dminfo);
		return ERROR_FAIL;
	}

	target_set_examined(target);

	return ERROR_OK;
}

static int riscv_poll(struct target *target)
{
	riscv_info_t *info = (riscv_info_t *) target->arch_info;

	uint64_t value;
	if (info->dbus_address < 0x10 || info->dbus_address == DMCONTROL) {
		value = dbus_read(target, info->dbus_address, 0);
	} else {
		value = dbus_read(target, 0, 0);
	}

	bool haltnot = get_field(value, DMCONTROL_HALTNOT);
	bool interrupt = get_field(value, DMCONTROL_INTERRUPT);

	if (haltnot && interrupt) {
		target->state = TARGET_DEBUG_RUNNING;
	} else if (haltnot && !interrupt) {
		target->state = TARGET_HALTED;
	} else if (!haltnot && interrupt) {
		// Target is halting. There is no state for that, so don't change anything.
	} else if (!haltnot && !interrupt) {
		target->state = TARGET_RUNNING;
	}

	return ERROR_OK;
}

struct target_type riscv_target = {
	.name = "riscv",

	.init_target = riscv_init_target,
	.deinit_target = riscv_deinit_target,
	.examine = riscv_examine,

	/* poll current target status */
	.poll = riscv_poll,

	/* TODO: */
	/* .virt2phys = riscv_virt2phys, */
};