mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

hal/itm_api.h@169:a7c7b631e539, 2018-06-22 (annotated)

Committer:
Anna Bridge
Date:
Fri Jun 22 15:38:59 2018 +0100
Revision:
169:a7c7b631e539
Parent:
165:d1b4690b3f8b
Child:
170:e95d10626187
mbed library. Release version 162

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 165:d1b4690b3f8b 1 /** \addtogroup hal */
AnnaBridge 165:d1b4690b3f8b 2 /** @{*/
AnnaBridge 165:d1b4690b3f8b 3 /* mbed Microcontroller Library
AnnaBridge 165:d1b4690b3f8b 4 * Copyright (c) 2017 ARM Limited
AnnaBridge 165:d1b4690b3f8b 5 *
AnnaBridge 165:d1b4690b3f8b 6 * Licensed under the Apache License, Version 2.0 (the "License");
AnnaBridge 165:d1b4690b3f8b 7 * you may not use this file except in compliance with the License.
AnnaBridge 165:d1b4690b3f8b 8 * You may obtain a copy of the License at
AnnaBridge 165:d1b4690b3f8b 9 *
AnnaBridge 165:d1b4690b3f8b 10 * http://www.apache.org/licenses/LICENSE-2.0
AnnaBridge 165:d1b4690b3f8b 11 *
AnnaBridge 165:d1b4690b3f8b 12 * Unless required by applicable law or agreed to in writing, software
AnnaBridge 165:d1b4690b3f8b 13 * distributed under the License is distributed on an "AS IS" BASIS,
AnnaBridge 165:d1b4690b3f8b 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
AnnaBridge 165:d1b4690b3f8b 15 * See the License for the specific language governing permissions and
AnnaBridge 165:d1b4690b3f8b 16 * limitations under the License.
AnnaBridge 165:d1b4690b3f8b 17 */
AnnaBridge 165:d1b4690b3f8b 18
AnnaBridge 165:d1b4690b3f8b 19 #ifndef MBED_ITM_API_H
AnnaBridge 165:d1b4690b3f8b 20 #define MBED_ITM_API_H
AnnaBridge 165:d1b4690b3f8b 21
AnnaBridge 165:d1b4690b3f8b 22 #if defined(DEVICE_ITM)
AnnaBridge 165:d1b4690b3f8b 23
AnnaBridge 165:d1b4690b3f8b 24 #include <stdint.h>
AnnaBridge 165:d1b4690b3f8b 25
AnnaBridge 165:d1b4690b3f8b 26 #ifdef __cplusplus
AnnaBridge 165:d1b4690b3f8b 27 extern "C" {
AnnaBridge 165:d1b4690b3f8b 28 #endif
AnnaBridge 165:d1b4690b3f8b 29
AnnaBridge 165:d1b4690b3f8b 30 /**
AnnaBridge 165:d1b4690b3f8b 31 * \defgroup itm_hal Instrumented Trace Macrocell HAL API
AnnaBridge 165:d1b4690b3f8b 32 * @{
AnnaBridge 165:d1b4690b3f8b 33 */
AnnaBridge 165:d1b4690b3f8b 34
AnnaBridge 165:d1b4690b3f8b 35 enum {
AnnaBridge 165:d1b4690b3f8b 36 ITM_PORT_SWO = 0
AnnaBridge 165:d1b4690b3f8b 37 };
AnnaBridge 165:d1b4690b3f8b 38
AnnaBridge 165:d1b4690b3f8b 39 /**
AnnaBridge 165:d1b4690b3f8b 40 * @brief Target specific initialization function.
AnnaBridge 165:d1b4690b3f8b 41 * This function is responsible for initializing and configuring
AnnaBridge 165:d1b4690b3f8b 42 * the debug clock for the ITM and setting up the SWO pin for
AnnaBridge 165:d1b4690b3f8b 43 * debug output.
AnnaBridge 165:d1b4690b3f8b 44 *
AnnaBridge 165:d1b4690b3f8b 45 * The only Cortex-M register that should be modified is the clock
AnnaBridge 165:d1b4690b3f8b 46 * prescaler in TPI->ACPR.
AnnaBridge 165:d1b4690b3f8b 47 *
AnnaBridge 165:d1b4690b3f8b 48 * The generic mbed_itm_init initialization function will setup:
AnnaBridge 165:d1b4690b3f8b 49 *
AnnaBridge 165:d1b4690b3f8b 50 * ITM->LAR
AnnaBridge 165:d1b4690b3f8b 51 * ITM->TPR
AnnaBridge 165:d1b4690b3f8b 52 * ITM->TCR
AnnaBridge 165:d1b4690b3f8b 53 * ITM->TER
AnnaBridge 165:d1b4690b3f8b 54 * TPI->SPPR
AnnaBridge 165:d1b4690b3f8b 55 * TPI->FFCR
AnnaBridge 165:d1b4690b3f8b 56 * DWT->CTRL
AnnaBridge 165:d1b4690b3f8b 57 *
AnnaBridge 165:d1b4690b3f8b 58 * for SWO output on stimulus port 0.
AnnaBridge 165:d1b4690b3f8b 59 */
AnnaBridge 165:d1b4690b3f8b 60 void itm_init(void);
AnnaBridge 165:d1b4690b3f8b 61
AnnaBridge 165:d1b4690b3f8b 62 /**
AnnaBridge 165:d1b4690b3f8b 63 * @brief Initialization function for both generic registers and target specific clock and pin.
AnnaBridge 165:d1b4690b3f8b 64 */
AnnaBridge 165:d1b4690b3f8b 65 void mbed_itm_init(void);
AnnaBridge 165:d1b4690b3f8b 66
AnnaBridge 165:d1b4690b3f8b 67 /**
AnnaBridge 165:d1b4690b3f8b 68 * @brief Send data over ITM stimulus port.
AnnaBridge 165:d1b4690b3f8b 69 *
AnnaBridge 165:d1b4690b3f8b 70 * @param[in] port The stimulus port to send data over.
AnnaBridge 165:d1b4690b3f8b 71 * @param[in] data The data to send.
AnnaBridge 165:d1b4690b3f8b 72 *
AnnaBridge 165:d1b4690b3f8b 73 * @return value of data sent.
AnnaBridge 165:d1b4690b3f8b 74 */
AnnaBridge 165:d1b4690b3f8b 75 uint32_t mbed_itm_send(uint32_t port, uint32_t data);
AnnaBridge 165:d1b4690b3f8b 76
AnnaBridge 165:d1b4690b3f8b 77 /**@}*/
AnnaBridge 165:d1b4690b3f8b 78
AnnaBridge 165:d1b4690b3f8b 79 #ifdef __cplusplus
AnnaBridge 165:d1b4690b3f8b 80 }
AnnaBridge 165:d1b4690b3f8b 81 #endif
AnnaBridge 165:d1b4690b3f8b 82
AnnaBridge 165:d1b4690b3f8b 83 #endif
AnnaBridge 165:d1b4690b3f8b 84
AnnaBridge 165:d1b4690b3f8b 85 #endif /* MBED_ITM_API_H */
AnnaBridge 165:d1b4690b3f8b 86
AnnaBridge 165:d1b4690b3f8b 87 /**@}*/