Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 38 additions & 10 deletions docs/tipsandtricks.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,6 @@ To get this working, use a browser that is not installed as a Snap package:

- Install it on your machine.

## Memory and Peripheral Inspector are missing

If your **Debug** view does not contain
["PERIPHERALS"](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.peripheral-inspector) and you cannot
open the [Memory Inspector](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.memory-inspector), check if
the extensions are installed correctly. If you had previously uninstalled the
[Arm Debugger](https://marketplace.visualstudio.com/items?itemName=Arm.arm-debugger) extension, these two extensions
might have been removed with it. Just reinstall them via the **Extensions** view.

## Create a library file

With Keil Studio, it is possible to create a library file. All you need to do is to change the **output type** in the
Expand Down Expand Up @@ -103,7 +94,18 @@ If you rely on **LL** for your peripherals, select/add an unused peripheral:

Now, the **GENERATE CODE** button creates/writes the `*.cgen.yml` file.

## Change variable display radix
## Debugging

### Memory and Peripheral Inspector are missing

If your **Debug** view does not contain
["PERIPHERALS"](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.peripheral-inspector) and you cannot
open the [Memory Inspector](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.memory-inspector), check if
the extensions are installed correctly. If you had previously uninstalled the
[Arm Debugger](https://marketplace.visualstudio.com/items?itemName=Arm.arm-debugger) extension, these two extensions
might have been removed with it. Just reinstall them via the **Extensions** view.

### Change variable display radix

In the **Watch** and **Live Watch** views, you can change the radix of variables by using the
`set output-radix base` command in the **Debug Console**. For example,
Expand All @@ -117,3 +119,29 @@ changes the radix to hexadecimal. Supported choices for base are decimal `8`, `1
!!! NOTE
- The `>` is part of the entered command instructing the console processing to use GDB CLI.
- Refer to [Numbers](https://sourceware.org/gdb/current/onlinedocs/gdb.html/Numbers.html) for more information.

### Cannot connect UART when debugging

**Symptom**

Using older **DAPLink** or **LPC-Link2** implementations, it is not possible to have a debug connection and monitor the
output of the UART on the SERIAL MONITOR at the same time. Once the serial connection is opened, the debug connect
stalls and throws these two errors:

```txt
Cannot execute this command while the target is running.
Use the "interrupt" command to stop the target and then try again.
```

And

```txt
Unable to read memory.
```

**Solution**

Using an NXP board with the new MCU-Link FW, this problem does not occur.

For older boards, there is no new DAPLink firmware available. Please avoid using the UART when debugging or use an
external debug adapter.
1 change: 1 addition & 0 deletions site/build_run.html
Original file line number Diff line number Diff line change
Expand Up @@ -150,6 +150,7 @@ <h2 id="build-output">Build output</h2>
<p>After you initiate the build process, a Terminal opens and displays the build operation:</p>
<pre><code class="language-txt">🔄 Execute: cbuild /Users/user/Git/Org/Blinky_PL10-CNANO/Blinky.csolution.yml --target all --active PIC32CM6408PL10048 --packs --skip-convert
Building CMake target 'Blinky.Debug+PIC32CM6408PL10048'
Using compiler: AC6 V6.24.0
[20/20] Linking C executable /Users/user/Git/Org/Blinky_PL10-CNANO/out/Blinky/PIC32CM6408PL10048/Debug/Blinky.axf
Program Size: Code=24128 RO-data=1304 RW-data=196 ZI-data=4652
[1/1] cd /Users/user/Git/Org/Blinky_PL10-CNANO/tmp/1 &amp;...Git/Org/Blinky_PL10-CNANO/out/Blinky/PIC32CM6408PL10048/Debug
Expand Down
2 changes: 1 addition & 1 deletion site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -272,5 +272,5 @@ <h2 id="revision-history">Revision history</h2>

<!--
MkDocs version : 1.6.1
Build Date UTC : 2026-02-20 10:03:29.761676+00:00
Build Date UTC : 2026-02-27 09:27:57.001887+00:00
-->
2 changes: 1 addition & 1 deletion site/search/search_index.json

Large diffs are not rendered by default.

Binary file modified site/sitemap.xml.gz
Binary file not shown.
44 changes: 33 additions & 11 deletions site/tipsandtricks.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,15 +92,21 @@
</li>
<li class="toctree-l2"><a class="reference internal" href="#documentation-does-not-open">Documentation does not open</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#memory-and-peripheral-inspector-are-missing">Memory and Peripheral Inspector are missing</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#create-a-library-file">Create a library file</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#downgrading-tool-versions">Downgrading tool versions</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#stm32cubemx-generator-issues">STM32CubeMX generator issues</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#change-variable-display-radix">Change variable display radix</a>
<li class="toctree-l2"><a class="reference internal" href="#debugging">Debugging</a>
<ul>
<li class="toctree-l3"><a class="reference internal" href="#memory-and-peripheral-inspector-are-missing">Memory and Peripheral Inspector are missing</a>
</li>
<li class="toctree-l3"><a class="reference internal" href="#change-variable-display-radix">Change variable display radix</a>
</li>
<li class="toctree-l3"><a class="reference internal" href="#cannot-connect-uart-when-debugging">Cannot connect UART when debugging</a>
</li>
</ul>
</li>
</ul>
</li>
Expand Down Expand Up @@ -163,13 +169,6 @@ <h2 id="documentation-does-not-open">Documentation does not open</h2>
<p>Install it on your machine.</p>
</li>
</ul>
<h2 id="memory-and-peripheral-inspector-are-missing">Memory and Peripheral Inspector are missing</h2>
<p>If your <strong>Debug</strong> view does not contain
<a href="https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.peripheral-inspector">"PERIPHERALS"</a> and you cannot
open the <a href="https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.memory-inspector">Memory Inspector</a>, check if
the extensions are installed correctly. If you had previously uninstalled the
<a href="https://marketplace.visualstudio.com/items?itemName=Arm.arm-debugger">Arm Debugger</a> extension, these two extensions
might have been removed with it. Just reinstall them via the <strong>Extensions</strong> view.</p>
<h2 id="create-a-library-file">Create a library file</h2>
<p>With Keil Studio, it is possible to create a library file. All you need to do is to change the <strong>output type</strong> in the
<code>*.cproject.yml</code> file to <code>lib</code>:</p>
Expand Down Expand Up @@ -222,7 +221,15 @@ <h2 id="stm32cubemx-generator-issues">STM32CubeMX generator issues</h2>
<p>If you rely on <strong>LL</strong> for your peripherals, select/add an unused peripheral:</p>
<p><img alt="Make STM32CubeMX generate the cgen.yml file" src="images/cubemx-cgen-hal.png" /></p>
<p>Now, the <strong>GENERATE CODE</strong> button creates/writes the <code>*.cgen.yml</code> file.</p>
<h2 id="change-variable-display-radix">Change variable display radix</h2>
<h2 id="debugging">Debugging</h2>
<h3 id="memory-and-peripheral-inspector-are-missing">Memory and Peripheral Inspector are missing</h3>
<p>If your <strong>Debug</strong> view does not contain
<a href="https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.peripheral-inspector">"PERIPHERALS"</a> and you cannot
open the <a href="https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.memory-inspector">Memory Inspector</a>, check if
the extensions are installed correctly. If you had previously uninstalled the
<a href="https://marketplace.visualstudio.com/items?itemName=Arm.arm-debugger">Arm Debugger</a> extension, these two extensions
might have been removed with it. Just reinstall them via the <strong>Extensions</strong> view.</p>
<h3 id="change-variable-display-radix">Change variable display radix</h3>
<p>In the <strong>Watch</strong> and <strong>Live Watch</strong> views, you can change the radix of variables by using the
<code>set output-radix base</code> command in the <strong>Debug Console</strong>. For example,</p>
<pre><code class="language-txt">&gt; set output-radix 16
Expand All @@ -235,6 +242,21 @@ <h2 id="change-variable-display-radix">Change variable display radix</h2>
<li>Refer to <a href="https://sourceware.org/gdb/current/onlinedocs/gdb.html/Numbers.html">Numbers</a> for more information.</li>
</ul>
</div>
<h3 id="cannot-connect-uart-when-debugging">Cannot connect UART when debugging</h3>
<p><strong>Symptom</strong></p>
<p>Using older <strong>DAPLink</strong> or <strong>LPC-Link2</strong> implementations, it is not possible to have a debug connection and monitor the
output of the UART on the SERIAL MONITOR at the same time. Once the serial connection is opened, the debug connect
stalls and throws these two errors:</p>
<pre><code class="language-txt">Cannot execute this command while the target is running.
Use the &quot;interrupt&quot; command to stop the target and then try again.
</code></pre>
<p>And</p>
<pre><code class="language-txt">Unable to read memory.
</code></pre>
<p><strong>Solution</strong></p>
<p>Using an NXP board with the new MCU-Link FW, this problem does not occur.</p>
<p>For older boards, there is no new DAPLink firmware available. Please avoid using the UART when debugging or use an
external debug adapter.</p>

</div>
</div><footer>
Expand Down
Loading