Skip to content

Docs for LibXR v2.0.1, xrobot 1.0.1 and CodeGenerator 6.0.1: MSPM0/HPM pages, tools, LibXR and versions - #26

Merged
Jiu-xiao merged 16 commits into
devfrom
docs/release-x.0.1-20261010
Oct 11, 2026
Merged

Jiu-xiao merged 16 commits into
devfrom
docs/release-x.0.1-20261010

Conversation

@Jiu-xiao

@Jiu-xiao Jiu-xiao commented Oct 10, 2026 •

Copy link
Copy Markdown
Member

The website follows the release of LibXR v2.0.1, xrobot 1.0.1, CodeGenerator 6.0.1 and the VS Code extension 2.0.1. Merge into master together with the release.

MSPM0 and HPM pages (earlier local commits)

  • Code generation for MSPM0 (SysConfig) and HPM (Pinmux Tool), the pin layout page, the refreshed MSPM0 and HPM environment pages.
  • HPM: the dma_mgr dependency; the GPIO clock joins the clock group before init_bsp_pins().

LibXR v2.0.1, xrobot 1.0.1, CodeGenerator 6.0.1

  • Module CI: xrobot-ref, libxr-ref and dependency-ref follow the event (pull request: target branch; push: same branch or dev; tag: master); new input build-type, default RelWithDebInfo with -O2 -g and LIBXR_DEBUG_BUILD=ON (XRobot#109).
  • Lock and setup: same-or-dev keeps the original context through dependency chains, the release gate, setup --leave-local <Module...> [-f], BSP outside Git with --update (XRobot#110).
  • Instance config: pointer parameters as bare names, synced defaults as native YAML, manifest errors at the header's line and column.
  • LibXR: LIBXR_DEBUG_BUILD follows the build type unless set; RamFS::CreateCommand(name, int (*)(int, char**)); MSPM0 and HPM power managers and the power command; ObjectPool rewritten for the shared handles (#295); new pages LatestSnapshot (#320) and SlotPool (#340); the MPMCQueue selection advice points interrupt-shared cases to SlotPool.
  • Code generation: the generated power_manager object on MSPM0 and HPM; the HPM pin data covers the IO pins only (known issue, fixed in 6.0.2).
  • Versions: install and pin examples at xrobot 1.0.1, libxr 6.0.1, extension 2.0.1.

npm run build passes for both languages.

… the BSPs

- The libxr pins overlay is the project section (assignments, peripherals), not a
  pins section; the command and its output share one block.
- The example runs and app_main.cpp excerpts are the first generation on a BSP
  copy; the MSPM0 excerpt no longer references a callback it leaves out, and
  wiring a key interrupt in the User Code regions is shown separately.
- HPM: I2C needs SCL and SDA, a capture-only GPTMR is display-only, GPIO names
  drop leading zeros, the settings rules (null defaults, integer literals, keys
  in any case, rename checks, stale null entries) and why there is no terminal.
- MSPM0: object and settings keys come from the peripheral name (UART0), not the
  SysConfig instance name; the regeneration steps keep the XRobot choice and
  remind to run xrobot gen.
- Environment pages: building a BSP needs xrobot setup first; mspm0_syscalls.c
  provides __dso_handle, _getpid and _kill as weak definitions, not the newlib
  system calls; driver/hpm also has hpm_dma.
- VS Code extension: the pin layout opens from the LibXR view; MSPM0/HPM need
  extension 2.1.0 and libxr 6.1.0; the SysConfig settings also serve parsing.
Adds the SlotPool page (core features, common APIs, concurrency constraints,
example and selection advice) in both languages, links it from the structure
index, and updates the MPMCQueue selection advice with the same division of
labor: SlotPool for interrupt-facing pools where FULL/EMPTY must be accurate,
MPMCQueue where callers can wait or retry and for large or multi-core heavy
queues. The CAN TX queue example now points at SlotPool, matching the driver
change in the same release.
@Jiu-xiao Jiu-xiao changed the title Docs for the x.0.1 release: MSPM0/HPM pages, tools, LibXR and versions Docs for LibXR v2.0.1, xrobot 1.0.1 and CodeGenerator 6.0.1: MSPM0/HPM pages, tools, LibXR and versions Oct 10, 2026
@Jiu-xiao
Jiu-xiao merged commit 7c0d19e into dev Oct 11, 2026
2 checks passed
@Jiu-xiao
Jiu-xiao deleted the docs/release-x.0.1-20261010 branch October 11, 2026 02:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant