xref: /freebsd/sys/arm64/coresight/coresight_etm4x.h (revision 95ee2897e98f5d444f26ed2334cc7c439f9c16c6)

/*-
 * Copyright (c) 2018-2020 Ruslan Bukin <br@bsdpad.com>
 * All rights reserved.
 *
 * This software was developed by BAE Systems, the University of Cambridge
 * Computer Laboratory, and Memorial University under DARPA/AFRL contract
 * FA8650-15-C-7558 ("CADETS"), as part of the DARPA Transparent Computing
 * (TC) research program.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

#ifndef	_ARM64_CORESIGHT_ETM4X_H_
#define	_ARM64_CORESIGHT_ETM4X_H_

#define	TRCPRGCTLR		0x004 /* Trace Programming Control Register */
#define	 TRCPRGCTLR_EN		(1 << 0) /* Trace unit enable bit */
#define	TRCPROCSELR		0x008 /* Trace PE Select Control Register */
#define	TRCSTATR		0x00C /* Trace Trace Status Register */
#define	 TRCSTATR_PMSTABLE	(1 << 1) /* The programmers' model is stable. */
#define	 TRCSTATR_IDLE		(1 << 0) /* The trace unit is idle. */
#define	TRCCONFIGR		0x010 /* Trace Trace Configuration Register */
#define	 TRCCONFIGR_DV		(1 << 17) /* Data value tracing is enabled when INSTP0 is not 0b00 */
#define	 TRCCONFIGR_DA		(1 << 16) /* Data address tracing is enabled when INSTP0 is not 0b00. */
#define	 TRCCONFIGR_VMIDOPT	(1 << 15) /* Control bit to configure the Virtual context identifier value */
#define	 TRCCONFIGR_QE_S	13 /* Q element enable field */
#define	 TRCCONFIGR_QE_M	(0x3 << TRCCONFIGR_QE_S)
#define	 TRCCONFIGR_RS		(1 << 12) /* Return stack enable bit */
#define	 TRCCONFIGR_TS		(1 << 11) /* Global timestamp tracing is enabled. */
#define	 TRCCONFIGR_COND_S	8 /* Conditional instruction tracing bit. */
#define	 TRCCONFIGR_COND_M	(0x7 << TRCCONFIGR_COND_S)
#define	 TRCCONFIGR_COND_DIS	0
#define	 TRCCONFIGR_COND_LDR	(1 << TRCCONFIGR_COND_S) /* Conditional load instructions are traced. */
#define	 TRCCONFIGR_COND_STR	(2 << TRCCONFIGR_COND_S) /* Conditional store instructions are traced. */
#define	 TRCCONFIGR_COND_LDRSTR	(3 << TRCCONFIGR_COND_S) /* Conditional load and store instructions are traced. */
#define	 TRCCONFIGR_COND_ALL	(7 << TRCCONFIGR_COND_S) /* All conditional instructions are traced. */
#define	 TRCCONFIGR_VMID	(1 << 7) /* Virtual context identifier tracing is enabled. */
#define	 TRCCONFIGR_CID		(1 << 6) /* Context ID tracing is enabled. */
#define	 TRCCONFIGR_CCI		(1 << 4) /* Cycle counting in the instruction trace is enabled. */
#define	 TRCCONFIGR_BB		(1 << 3) /* Branch broadcast mode is enabled. */
#define	 TRCCONFIGR_INSTP0_S	1 /* Instruction P0 field. */
#define	 TRCCONFIGR_INSTP0_M	(0x3 << TRCCONFIGR_INSTP0_S)
#define	 TRCCONFIGR_INSTP0_NONE	0 /* Do not trace load and store instructions as P0 instructions. */
#define	 TRCCONFIGR_INSTP0_LDR	(1 << TRCCONFIGR_INSTP0_S) /* Trace load instructions as P0 instructions. */
#define	 TRCCONFIGR_INSTP0_STR	(2 << TRCCONFIGR_INSTP0_S) /* Trace store instructions as P0 instructions. */
#define	 TRCCONFIGR_INSTP0_LDRSTR (3 << TRCCONFIGR_INSTP0_S) /* Trace load and store instructions as P0 instr. */
#define	TRCAUXCTLR		0x018 /* Trace Auxiliary Control Register */
#define	TRCEVENTCTL0R		0x020 /* Trace Event Control 0 Register */
#define	TRCEVENTCTL1R		0x024 /* Trace Event Control 1 Register */
#define	TRCSTALLCTLR		0x02C /* Trace Stall Control Register */
#define	TRCTSCTLR		0x030 /* Trace Global Timestamp Control Register */
#define	TRCSYNCPR		0x034 /* Trace Synchronization Period Register */
#define	 TRCSYNCPR_PERIOD_S	0
#define	 TRCSYNCPR_PERIOD_M	0x1f
#define	 TRCSYNCPR_1K		(10 << TRCSYNCPR_PERIOD_S)
#define	 TRCSYNCPR_2K		(11 << TRCSYNCPR_PERIOD_S)
#define	 TRCSYNCPR_4K		(12 << TRCSYNCPR_PERIOD_S)
#define	TRCCCCTLR		0x038 /* Trace Cycle Count Control Register */
#define	TRCBBCTLR		0x03C /* Trace Branch Broadcast Control Register */
#define	TRCTRACEIDR		0x040 /* Trace Trace ID Register */
#define	TRCQCTLR		0x044 /* Trace Q Element Control Register */
#define	 TRCQCTLR_MODE_INC	(1 << 8) /* Include mode. */
#define	TRCVICTLR		0x080 /* Trace ViewInst Main Control Register */
#define	 TRCVICTLR_SSSTATUS	(1 << 9) /* The start/stop logic is in the started state. */
#define	 TRCVICTLR_EXLEVEL_NS_S	20
#define	 TRCVICTLR_EXLEVEL_NS_M	(0xf << TRCVICTLR_EXLEVEL_NS_S)
#define	 TRCVICTLR_EXLEVEL_NS(n) (0x1 << ((n) + TRCVICTLR_EXLEVEL_NS_S))
#define	 TRCVICTLR_EXLEVEL_S_S	16
#define	 TRCVICTLR_EXLEVEL_S_M	(0xf << TRCVICTLR_EXLEVEL_S_S)
#define	 TRCVICTLR_EXLEVEL_S(n)	(0x1 << ((n) + TRCVICTLR_EXLEVEL_S_S))
#define	 EVENT_SEL_S		0
#define	 EVENT_SEL_M		(0x1f << EVENT_SEL_S)
#define	TRCVIIECTLR		0x084 /* Trace ViewInst Include/Exclude Control Register */
#define	 TRCVIIECTLR_INCLUDE_S	0
#define	TRCVISSCTLR		0x088 /* Trace ViewInst Start/Stop Control Register */
#define	TRCVIPCSSCTLR		0x08C /* Trace ViewInst Start/Stop PE Comparator Control Register */
#define	TRCVDCTLR		0x0A0 /* Trace ViewData Main Control Register */
#define	 TRCVDCTLR_TRCEXDATA	(1 << 12) /* Exception and exception return data transfers are traced */
#define	 TRCVDCTLR_TBI		(1 << 11) /* The trace unit assigns bits[63:56] to have the same value as bits[63:56] of the data address. */
#define	 TRCVDCTLR_PCREL	(1 << 10) /* The trace unit does not trace the address or value portions of PC-relative transfers. */
#define	 TRCVDCTLR_SPREL_S	8
#define	 TRCVDCTLR_SPREL_M	(0x3 << TRCVDCTLR_SPREL_S)
#define	 TRCVDCTLR_EVENT_S	0
#define	 TRCVDCTLR_EVENT_M	(0xff << TRCVDCTLR_EVENT_S)
#define	TRCVDSACCTLR		0x0A4 /* Trace ViewData Include/Exclude Single Address Comparator Control Register */
#define	TRCVDARCCTLR		0x0A8 /* Trace ViewData Include/Exclude Address Range Comparator Control Register */
#define	TRCSEQEVR(n)		(0x100 + (n) * 0x4)	/* Trace Sequencer State Transition Control Register [n=0-2] */
#define	TRCSEQRSTEVR		0x118 /* Trace Sequencer Reset Control Register */
#define	TRCSEQSTR		0x11C /* Trace Sequencer State Register */
#define	TRCEXTINSELR		0x120 /* Trace External Input Select Register */
#define	TRCCNTRLDVR(n)		(0x140 + (n) * 0x4) /* 32 Trace Counter Reload Value Register [n=0-3] */
#define	TRCCNTCTLR(n)		(0x150 + (n) * 0x4) /* 32 Trace Counter Control Register [n=0-3] */
#define	TRCCNTVR(n)		(0x160 + (n) * 0x4) /* 32 Trace Counter Value Register [n=0-3] */
#define	TRCIMSPEC(n)		(0x1C0 + (n) * 0x4)	/* Trace IMPLEMENTATION DEFINED register [n=0-7] */

#define	TRCIDR0(n)		(0x1E0 + 0x4 * (n))
#define	TRCIDR8(n)		(0x180 + 0x4 * (n))
#define	TRCIDR(n)		((n > 7) ? TRCIDR8(n) : TRCIDR0(n))
#define	 TRCIDR1_TRCARCHMAJ_S	8
#define	 TRCIDR1_TRCARCHMAJ_M	(0xf << TRCIDR1_TRCARCHMAJ_S)
#define	 TRCIDR1_TRCARCHMIN_S	4
#define	 TRCIDR1_TRCARCHMIN_M	(0xf << TRCIDR1_TRCARCHMIN_S)

#define	TRCRSCTLR(n)		(0x200 + (n) * 0x4) /* Trace Resource Selection Control Register [n=2-31] */
#define	TRCSSCCR(n)		(0x280 + (n) * 0x4) /* Trace Single-shot Comparator Control Register [n=0-7] */
#define	TRCSSCSR(n)		(0x2A0 + (n) * 0x4) /* Trace Single-shot Comparator Status Register [n=0-7] */
#define	TRCSSPCICR(n)		(0x2C0 + (n) * 0x4) /* Trace Single-shot PE Comparator Input Control [n=0-7] */
#define	TRCOSLAR		0x300 /* Management OS Lock Access Register */
#define	TRCOSLSR		0x304 /* Management OS Lock Status Register */
#define	TRCPDCR			0x310 /* Management PowerDown Control Register */
#define	TRCPDSR			0x314 /* Management PowerDown Status Register */
#define	TRCACVR(n)		(0x400 + (n) * 0x8) /* Trace Address Comparator Value Register [n=0-15] */
#define	TRCACATR(n)		(0x480 + (n) * 0x8) /* Trace Address Comparator Access Type Register [n=0-15] */
#define	 TRCACATR_DTBM		(1 << 21)
#define	 TRCACATR_DATARANGE	(1 << 20)
#define	 TRCACATR_DATASIZE_S	18
#define	 TRCACATR_DATASIZE_M	(0x3 << TRCACATR_DATASIZE_S)
#define	 TRCACATR_DATASIZE_B	(0x0 << TRCACATR_DATASIZE_S)
#define	 TRCACATR_DATASIZE_HW	(0x1 << TRCACATR_DATASIZE_S)
#define	 TRCACATR_DATASIZE_W	(0x2 << TRCACATR_DATASIZE_S)
#define	 TRCACATR_DATASIZE_DW	(0x3 << TRCACATR_DATASIZE_S)
#define	 TRCACATR_DATAMATCH_S	16
#define	 TRCACATR_DATAMATCH_M	(0x3 << TRCACATR_DATAMATCH_S)
#define	 TRCACATR_EXLEVEL_S_S	8
#define	 TRCACATR_EXLEVEL_S_M	(0xf << TRCACATR_EXLEVEL_S_S)
#define	 TRCACATR_EXLEVEL_S(n)	(0x1 << ((n) + TRCACATR_EXLEVEL_S_S))
#define	 TRCACATR_EXLEVEL_NS_S	12
#define	 TRCACATR_EXLEVEL_NS_M	(0xf << TRCACATR_EXLEVEL_NS_S)
#define	 TRCACATR_EXLEVEL_NS(n)	(0x1 << ((n) + TRCACATR_EXLEVEL_NS_S))
#define	TRCDVCVR(n)		(0x500 + (n) * 0x8) /* Trace Data Value Comparator Value Register [n=0-7] */
#define	TRCDVCMR(n)		(0x580 + (n) * 0x8) /* Trace Data Value Comparator Mask Register [n=0-7] */
#define	TRCCIDCVR(n)		(0x600 + (n) * 0x8) /* Trace Context ID Comparator Value Register [n=0-7] */
#define	TRCVMIDCVR(n)		(0x640 + (n) * 0x8) /* Trace Virtual context identifier Comparator Value [n=0-7] */
#define	TRCCIDCCTLR0		0x680 /* Trace Context ID Comparator Control Register 0 */
#define	TRCCIDCCTLR1		0x684 /* Trace Context ID Comparator Control Register 1 */
#define	TRCVMIDCCTLR0		0x688 /* Trace Virtual context identifier Comparator Control Register 0 */
#define	TRCVMIDCCTLR1		0x68C /* Trace Virtual context identifier Comparator Control Register 1 */
#define	TRCITCTRL		0xF00 /* Management Integration Mode Control register */
#define	TRCCLAIMSET		0xFA0 /* Trace Claim Tag Set register */
#define	TRCCLAIMCLR		0xFA4 /* Trace Claim Tag Clear register */
#define	TRCDEVAFF0		0xFA8 /* Management Device Affinity register 0 */
#define	TRCDEVAFF1		0xFAC /* Management Device Affinity register 1 */
#define	TRCLAR			0xFB0 /* Management Software Lock Access Register */
#define	TRCLSR			0xFB4 /* Management Software Lock Status Register */
#define	TRCAUTHSTATUS		0xFB8 /* Management Authentication Status register */
#define	TRCDEVARCH		0xFBC /* Management Device Architecture register */
#define	TRCDEVID		0xFC8 /* Management Device ID register */
#define	TRCDEVTYPE		0xFCC /* Management Device Type register */
#define	TRCPIDR4		0xFD0 /* Management Peripheral ID4 Register */
#define	TRCPIDR(n)		(0xFE0 + (n) * 0x4)	/* Management Peripheral IDn Register [n=0-3] */
#define	TRCPIDR567(n)		(0xFD4 + ((n) - 5) * 0x4) /*  Management Peripheral ID5 to Peripheral ID7 Registers */
#define	TRCCIDR(n)		(0xFF0 + (n) * 0x4)	/* Management Component IDn Register [n=0-4] */

DECLARE_CLASS(etm_driver);

struct etm_softc {
	struct resource			*res;
	struct coresight_platform_data	*pdata;
};

int etm_attach(device_t dev);

#endif /* !_ARM64_CORESIGHT_ETM4X_H_ */