1 /***************************************************************************
2 * Copyright (C) 2015 Paul Fertser <fercerpav@gmail.com> *
4 * This program is free software; you can redistribute it and/or modify *
5 * it under the terms of the GNU General Public License as published by *
6 * the Free Software Foundation; either version 2 of the License, or *
7 * (at your option) any later version. *
9 * This program is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12 * GNU General Public License for more details. *
14 * You should have received a copy of the GNU General Public License *
15 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
16 ***************************************************************************/
18 #ifndef OPENOCD_TARGET_ARMV7M_TRACE_H
19 #define OPENOCD_TARGET_ARMV7M_TRACE_H
21 #include <target/target.h>
26 * Holds the interface to TPIU, ITM and DWT configuration functions.
29 enum trace_config_type
{
30 DISABLED
, /**< tracing is disabled */
31 EXTERNAL
, /**< trace output is captured externally */
32 INTERNAL
/**< trace output is handled by OpenOCD adapter driver */
35 enum tpio_pin_protocol
{
36 SYNC
, /**< synchronous trace output */
37 ASYNC_MANCHESTER
, /**< asynchronous output with Manchester coding */
38 ASYNC_UART
/**< asynchronous output with NRZ coding */
41 enum itm_ts_prescaler
{
42 ITM_TS_PRESCALE1
, /**< no prescaling for the timestamp counter */
43 ITM_TS_PRESCALE4
, /**< refclock divided by 4 for the timestamp counter */
44 ITM_TS_PRESCALE16
, /**< refclock divided by 16 for the timestamp counter */
45 ITM_TS_PRESCALE64
, /**< refclock divided by 64 for the timestamp counter */
48 struct armv7m_trace_config
{
49 /** Currently active trace capture mode */
50 enum trace_config_type config_type
;
52 /** Currently active trace output mode */
53 enum tpio_pin_protocol pin_protocol
;
54 /** TPIU formatter enable/disable (in async mode) */
56 /** Synchronous output port width */
59 /** Bitmask of currenty enabled ITM stimuli */
61 /** Identifier for multi-source trace stream formatting */
62 unsigned int trace_bus_id
;
63 /** Prescaler for the timestamp counter */
64 enum itm_ts_prescaler itm_ts_prescale
;
65 /** Enable differential timestamps */
66 bool itm_diff_timestamps
;
67 /** Enable async timestamps model */
68 bool itm_async_timestamps
;
69 /** Enable synchronisation packet transmission (for sync port only) */
70 bool itm_synchro_packets
;
72 /** Current frequency of TRACECLKIN (usually matches HCLK) */
73 unsigned int traceclkin_freq
;
74 /** Current frequency of trace port */
75 unsigned int trace_freq
;
76 /** Handle to output trace data in INTERNAL capture mode */
80 extern const struct command_registration armv7m_trace_command_handlers
[];
83 * Configure hardware accordingly to the current TPIU target settings
85 int armv7m_trace_tpiu_config(struct target
*target
);
87 * Configure hardware accordingly to the current ITM target settings
89 int armv7m_trace_itm_config(struct target
*target
);
91 #endif /* OPENOCD_TARGET_ARMV7M_TRACE_H */