Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

target: add xc2xx device support for XHSC #1687

Open
wants to merge 29 commits into
base: develop
Choose a base branch
from
Open
Changes from 1 commit
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
4a8cbb7
commands: reset: fall back to reset via probe if context has no selec…
flit May 22, 2023
73b9ce9
cortex-m: reset_halt: just warn about invalid T-bit, don't fix (#1559)
flit May 22, 2023
574359c
target: family: psoc6: remove unnecessary sleep during reset. (#1562)
te-johan May 23, 2023
b995d84
docs: move outline to be colocated with source
flit May 26, 2023
035f81b
debug: sequences: assignment expressions (#1564)
flit May 28, 2023
0f53af6
flash: fix some type errors, sort imports (#1566)
flit May 30, 2023
3ea6ec0
core: session: only create one session to access options when there's…
flit May 30, 2023
d09fd5f
docs: board_ids: alert, D0xx range, other small updates
flit May 28, 2023
f3c9c80
docs: outline changes to rename User guide, move API arch location
flit May 28, 2023
89fd4f2
docs: add faq
flit May 28, 2023
c72b949
docs: add gdbserver
flit May 28, 2023
4033cd0
docs: developer guide: add section on debugging pyocd
flit Jun 11, 2023
376d3f4
Use correct flash address for MAX32670
ozersa Jun 16, 2023
dc9f2c0
docs: fix missing import of time in api example (#1582)
liux-pro Jul 11, 2023
0189b2f
flash: loader: fix missing import of RamRegion (#1588)
flit Jul 20, 2023
fdaf08a
target: hc32l130: fix 32k+ flash error (#1590)
kaidegit Jul 21, 2023
e662365
probe: cmsis-dap: use test binary from builtin board data for v2.1 ba…
flit Jul 23, 2023
94f1860
coresight: adiv5 discovery: increment invalid AP count on exception (…
flit Jul 23, 2023
401a01c
target: family: remove part number match for NXP MIMXRTxxxx series fa…
flit Jul 23, 2023
37c8efb
probe: cmsis-dap: usb backends: windows performance fix and more (#1595)
flit Jul 30, 2023
6dcd439
rtt: fix cb not found (#1583)
tdasika Aug 5, 2023
9253740
target: fix HC32L13x size and enable double buffering (#1609)
kaidegit Aug 13, 2023
0e3742a
target: add s32k344 support (#1627)
PetervdPerk-NXP Sep 26, 2023
fba00fb
target: added target Realtek RTL8762C (#1624)
suphammer Sep 26, 2023
cb97846
Merge branch 'develop'
flit Oct 8, 2023
975fe95
docs: update builtin targets and commands, XDS110 note
flit Oct 8, 2023
6dc261a
Add mps2 an521, reset on loading to Ram and soft-bkpt-as-hard (#1638)
ithinuel Oct 19, 2023
5ab5c32
target: add Ambiq Apollo3 target and NM180410 board support (#1632)
joshua-nmi Oct 19, 2023
48a0976
target: add xc2xx device support for XHSC
xhsctool Apr 16, 2024
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
Prev Previous commit
Next Next commit
docs: board_ids: alert, D0xx range, other small updates
flit committed Jun 11, 2023
commit d09fd5fdf0b07b1109ce7e406c92326408270ded
17 changes: 15 additions & 2 deletions docs/developer/board_ids.md
Original file line number Diff line number Diff line change
@@ -2,6 +2,11 @@
title: Board IDs
---

<div class="alert alert-warning">
New CMSIS-DAP firmware releases should use the CMSIS-DAP v2.1 board and target identification features
rather than board IDs.
</div>

This page documents the board IDs reported by certain [debug probes]({% link _docs/debug_probes.md %}) with which pyOCD can automatically identify a board and its target type.

## Introduction
@@ -20,11 +25,12 @@ Board ID definition:
- There are multiple cases of boards from different vendors being incorrectly allocated in another vendor's namespace, so this cannot solely be relied upon. It's only really useful for grouping of IDs.
- Reserved values::
- "C0xx" is reserved for "community" boards, i.e. open source hardware and non-commercial projects.
- "D0xx" is reserved for boards that are not also Mbed platforms, mostly DAPLink firmware.
- "0000" is reserved to mean "no on-board target". That is, the debug probe is standalone must be connected to the target with a cable.

Currently these debug probe firmware support board IDs:
- [DAPLink](https://daplink.io/), via the first 4 chars of the USB serial number
- STLinkV2-1 and V3, via an `.htm` file on the associated USB mass storage volume.
- STLinkV2-1 and V3, via an `.htm` file on the associated USB mass storage volume and an STLink protocol command.

## Lists

@@ -34,10 +40,17 @@ You can see the full list of public Mbed platforms at [https://os.mbed.com/api/v

## Getting a new ID

To request a new board ID, fill out the form here: [https://os.mbed.com/request-board-id](https://os.mbed.com/request-board-id)
There are two ways to get new board IDs:

1. Post a request to the #daplink channel on the [pyOCD Slack workspace](https://pyocd.slack.com/) ([Join](https://join.slack.com/t/pyocd/shared_invite/zt-zqjv6zr5-ZfGAXl_mFCGGmFlB_8riHA)). We can allocate you a 0xDxxx board ID.

2. For new Mbed OS platforms, request a new board ID by filling out the form here: [https://os.mbed.com/request-board-id](https://os.mbed.com/request-board-id)

## Moving forward

Version 2.1 of the [CMSIS-DAP](https://arm-software.github.io/CMSIS_5/DAP/html/index.html) specification adds support for new [DAP_Info](https://arm-software.github.io/CMSIS_5/DAP/html/group__DAP__Info.html) selectors that identify the board and target. The values returned by these selectors are required to match board and target identifiers in CMSIS-Packs.

PyOCD supports the new CMSIS-DAP v2.1 info selectors and will use them in preference to a board ID if available. This works with any debug probe firmware compatible with CMSIS-DAP. Thus, any new CMSIS-DAP firmware projects should support v2.1 and the new DAP_Info selectors rather than implementing board IDs.

The DAPLink open source CMSIS-DAP firmware has support for the v2.1 identifiers. We recommend using these identifiers rather than a board ID for any new DAPLink based firmware.