From 975fe95ed8978278485c31cbb1f4b62ab1689237 Mon Sep 17 00:00:00 2001
From: Chris Reed <flit@me.com>
Date: Sun, 8 Oct 2023 13:47:00 -0500
Subject: [PATCH] docs: update builtin targets and commands, XDS110 note

---
 docs/builtin-targets.md   | 82 ++++++++++++++++++++++++++++++++++++++-
 docs/command_reference.md | 18 +++++++++
 docs/debug_probes.md      |  4 ++
 3 files changed, 103 insertions(+), 1 deletion(-)

diff --git a/docs/builtin-targets.md b/docs/builtin-targets.md
index c18ce7dad..68d663aa4 100644
--- a/docs/builtin-targets.md
+++ b/docs/builtin-targets.md
@@ -6,6 +6,36 @@ title: Built-in targets
 
 <tr><th>Target Type Name</th><th>Vendor</th><th>Name</th></tr>
 
+    <tr><td><code>air001</code></td>
+    <td>AirM2M</td>
+    <td>Air001</td>
+    </tr>
+
+    <tr><td><code>air32f103xb</code></td>
+    <td>AirM2M</td>
+    <td>Air32F103xB</td>
+    </tr>
+
+    <tr><td><code>air32f103xc</code></td>
+    <td>AirM2M</td>
+    <td>Air32F103xC</td>
+    </tr>
+
+    <tr><td><code>air32f103xe</code></td>
+    <td>AirM2M</td>
+    <td>Air32F103xE</td>
+    </tr>
+
+    <tr><td><code>air32f103xg</code></td>
+    <td>AirM2M</td>
+    <td>Air32F103xG</td>
+    </tr>
+
+    <tr><td><code>air32f103xp</code></td>
+    <td>AirM2M</td>
+    <td>Air32F103xP</td>
+    </tr>
+
     <tr><td><code>cc3220sf</code></td>
     <td>Texas Instruments</td>
     <td>CC3220SF</td>
@@ -126,6 +156,16 @@ title: Built-in targets
     <td>CY8C6xxA</td>
     </tr>
 
+    <tr><td><code>hc32a460xe</code></td>
+    <td>HDSC</td>
+    <td>HC32F460xE</td>
+    </tr>
+
+    <tr><td><code>hc32a4a0xi</code></td>
+    <td>HDSC</td>
+    <td>HC32F4A0xI</td>
+    </tr>
+
     <tr><td><code>hc32f003</code></td>
     <td>HDSC</td>
     <td>HC32F003</td>
@@ -176,6 +216,16 @@ title: Built-in targets
     <td>HC32F196</td>
     </tr>
 
+    <tr><td><code>hc32f448xa</code></td>
+    <td>HDSC</td>
+    <td>HC32F448xA</td>
+    </tr>
+
+    <tr><td><code>hc32f448xc</code></td>
+    <td>HDSC</td>
+    <td>HC32F448xC</td>
+    </tr>
+
     <tr><td><code>hc32f451xc</code></td>
     <td>HDSC</td>
     <td>HC32F451xC</td>
@@ -546,6 +596,11 @@ title: Built-in targets
     <td>MAX32660</td>
     </tr>
 
+    <tr><td><code>max32666</code></td>
+    <td>Maxim</td>
+    <td>MAX32666</td>
+    </tr>
+
     <tr><td><code>max32670</code></td>
     <td>Maxim</td>
     <td>MAX32670</td>
@@ -668,7 +723,7 @@ title: Built-in targets
 
     <tr><td><code>nrf91</code></td>
     <td>Nordic Semiconductor</td>
-    <td>NRF9160</td>
+    <td>NRF91XX</td>
     </tr>
 
     <tr><td><code>rp2040</code></td>
@@ -691,6 +746,16 @@ title: Built-in targets
     <td>RTL8195AM</td>
     </tr>
 
+    <tr><td><code>rtl8762c</code></td>
+    <td>Realtek Semiconductor</td>
+    <td>RTL8762C</td>
+    </tr>
+
+    <tr><td><code>s32k344</code></td>
+    <td>NXP</td>
+    <td>S32K344</td>
+    </tr>
+
     <tr><td><code>s5js100</code></td>
     <td>Samsung</td>
     <td>S5JS100</td>
@@ -741,6 +806,21 @@ title: Built-in targets
     <td>STM32F767xx</td>
     </tr>
 
+    <tr><td><code>stm32h723xx</code></td>
+    <td>STMicroelectronics</td>
+    <td>STM32H723xx</td>
+    </tr>
+
+    <tr><td><code>stm32h743xx</code></td>
+    <td>STMicroelectronics</td>
+    <td>STM32H743xx</td>
+    </tr>
+
+    <tr><td><code>stm32h7b0xx</code></td>
+    <td>STMicroelectronics</td>
+    <td>STM32H7B0xx</td>
+    </tr>
+
     <tr><td><code>stm32l031x6</code></td>
     <td>STMicroelectronics</td>
     <td>STM32L031x6</td>
diff --git a/docs/command_reference.md b/docs/command_reference.md
index fea90fc10..92947c577 100644
--- a/docs/command_reference.md
+++ b/docs/command_reference.md
@@ -368,6 +368,16 @@ ADDR DATA+
 Write 8-bit bytes to memory.
 </td></tr>
 
+<tr><td colspan="3"><b>Nrf91</b></td></tr>
+
+<tr><td>
+<a href="#nrf91-update-modem-fw"><tt>nrf91-update-modem-fw</tt></a>
+</td><td>
+[-f] mfw_nrf91xx_x.x.x.zip
+</td><td>
+Update modem firmware for an nRF91 target.
+</td></tr>
+
 <tr><td colspan="3"><b>Openocd_compatibility</b></td></tr>
 
 <tr><td>
@@ -992,6 +1002,14 @@ Write 64-bit double-words to memory. The data arguments are 64-bit words in big-
 Write 8-bit bytes to memory. The data arguments are 8-bit bytes. Can write to both RAM and flash. Flash writes are subject to minimum write size and alignment, and the flash page must have been previously erased.
 
 
+### Nrf91
+
+##### `nrf91-update-modem-fw`
+
+**Usage**: nrf91-update-modem-fw [-f] mfw_nrf91xx_x.x.x.zip \
+Update modem firmware for an nRF91 target. If -f is specified, modem firmware is written to the device, even if the correct version is already present.
+
+
 ### Openocd compatibility
 
 ##### `init`
diff --git a/docs/debug_probes.md b/docs/debug_probes.md
index 39d4cc9a4..f0af792d3 100644
--- a/docs/debug_probes.md
+++ b/docs/debug_probes.md
@@ -174,6 +174,10 @@ DAPLink firmware updates are available on the [daplink.io](https://daplink.io/)
 The Microchip (previously Atmel) EDBG probe firmware, at the time of this writing, provides a CMSIS-DAP v1 interface.
 On macOS, reading command responses always times out. The probe works on other OSes, however.
 
+### TI XDS110
+
+XDS110 firmware version 03.00.00.25 is known to have an issue when using multiple outstanding packets (the default setting). To work around this, set the `cmsis_dap.limit_packets` session option, e.g. `-Ocmsis_dap.limit_packets=1` on the command line. Earlier firmware versions most likely exhibit the issue; it is unknown whether it is fixed in more recent versions.
+
 
 ### PE Micro Cyclone and Multilink