Mohamed Moawya / SnakeGame

test test test

Dependencies:   mbed

snake-test/mbed/hal/itm_api.h@0:e4c5e6ec922e, 2020-05-25 (annotated)

Committer:
mohamedmoawya
Date:
Mon May 25 19:06:11 2020 +0000
Revision:
0:e4c5e6ec922e
snake game tteest

Who changed what in which revision?

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