Skip to content

Commit fdb4638

Browse files
author
Amanda Butler
authored
Copy edit itm.md
Copy edit for active voice, consistent tense and proper formatting.
1 parent 0ac6a71 commit fdb4638

File tree

1 file changed

+7
-7
lines changed
  • docs/reference/contributing/target

1 file changed

+7
-7
lines changed

docs/reference/contributing/target/itm.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
### Instrumented Trace Macrocell
22

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.
44

55
#### Assumptions
66

77
##### Defined behavior
88

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.
1010

1111
##### Undefined behavior
1212

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.
1515

16-
##### Notes
16+
##### Note
1717

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.
1919

2020
#### Dependencies
2121

@@ -29,7 +29,7 @@ For targets with Arm CoreSight (for example, Cortex-M3 and Cortex-M4), the Instr
2929
- The SWO pin must be configured for debug output.
3030
- You must add `ITM` to the `device_has` section in `target.json`.
3131

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.
3333

3434
#### Testing
3535

0 commit comments

Comments
 (0)