You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/reference/contributing/target/itm.md
+7-7Lines changed: 7 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -1,21 +1,21 @@
1
1
### Instrumented Trace Macrocell
2
2
3
-
For targets with Arm CoreSight (for example, Cortex-M3 and Cortex-M4), the Instrumented Trace Macrocell provides a lightweight, nonintrusive way to collect debug trace output.
3
+
For targets with Arm CoreSight (for example, Cortex-M3 and Cortex-M4), the Instrumented Trace Macrocell provides a lightweight, nonintrusive way to collect debug trace output.
4
4
5
5
#### Assumptions
6
6
7
7
##### Defined behavior
8
8
9
-
-When initialized, writing data to the ITM stimulus registers will result in the data being transmitted over the SWO line.
9
+
When initialized, writing data to the ITM stimulus registers results in the data being transmitted over the SWO line.
10
10
11
11
##### Undefined behavior
12
12
13
-
- The debug clock frequency is left undefined because the most optimal frequency varies from target to target. It is up to each target's owner to choose a frequency that doesn't interfere with normal operation and that the owner's preferred debug monitor supports.
14
-
- If another peripheral tries to take control of the SWO pin it is undefined whether that operation should succeed or not.
13
+
- The debug clock frequency is left undefined because the most optimal frequency varies from target to target. It is up to each target's owner to choose a frequency that doesn't interfere with normal operation and that the owner's preferred debug monitor supports.
14
+
- If another peripheral tries to take control of the SWO pin, it is undefined whether that operation succeeds.
15
15
16
-
##### Notes
16
+
##### Note
17
17
18
-
-Some SWO viewers do not allow for an arbitrary frequency to be set. Make sure that the chosen frequency is supported by the development tools you expect your users to use.
18
+
Some SWO viewers do not allow an arbitrary frequency to be set. Make sure that the development tools you expect your users to use support the chosen frequency.
19
19
20
20
#### Dependencies
21
21
@@ -29,7 +29,7 @@ For targets with Arm CoreSight (for example, Cortex-M3 and Cortex-M4), the Instr
29
29
- The SWO pin must be configured for debug output.
30
30
- You must add `ITM` to the `device_has` section in `target.json`.
31
31
32
-
It should not be necessary to mofify any of the ITM registers in `itm_init`, except for the one related to the clock prescaling, `TPI->ACPR`. The helper function `mbed_itm_init` is responsible for calling `itm_init` and initializing the generic ITM registers. `mbed_itm_init`will only call the function `itm_init`exactly once making it unnecessary to protect `itm_init` against multiple initializations.
32
+
It is not necessary to modify any of the ITM registers in `itm_init`, except for the one related to the clock prescaling, `TPI->ACPR`. The helper function `mbed_itm_init` is responsible for calling `itm_init` and initializing the generic ITM registers. `mbed_itm_init` only calls the function `itm_init` once, making it unnecessary to protect `itm_init` against multiple initializations.
0 commit comments