| name | asp3-mcuxsdk-ops |
| description | asp3_mcuxsdk リポジトリでの日常操作（ビルド／書込み／テスト／性能計測／デバッグ）を、 対応2ボード（EVK-MIMXRT685・FRDM-MCXN947）それぞれの正しいプリセット名・LinkServer デバイス名・プロジェクトパス・ASP3ターゲット名で叩くための早見表。 「sample1 をビルドして書き込みたい」「test_porting / testexec を回したい」「どのプリセット・ どの LinkServer デバイス名」「2ボードのどちらの手順か」「DWT で性能計測したい」「デバッガを J-Link に切替えたい」というとき使う（build / flash / LinkServer / testexec / preset / perf / DWT）。 新規ボードの追加や実機が動かない root cause 解析は porting-asp3-to-nxp、禁則・全体像は CLAUDE.md / asp3_core AGENTS.md、ホスト構築・ツール詳細は docs/ を参照（そちらへ委譲する）。
|
asp3_mcuxsdk オペレーション早見表
このリポでの build / flash / test / perf / debug の「叩き方」 に徹したスキル。
概念・規約・root cause は他に委譲する。
使い分け（最初に確認）
| やりたいこと | 参照先 |
|---|
| 既存ボード（RT685 / MCXN947）でビルド・書込み・テスト・計測 | ← このスキル |
| 新規 NXP ボードを追加する／実機が動かない root cause | .claude/skills/porting-asp3-to-nxp/（移植・ブリングアップ） |
| 書込み・デバッガ・シリアルのツール詳細（ファームウェア切替・OS Awareness） | porting-asp3-to-nxp/reference/flash-debug-tools.md |
| 禁則・リポ全体像 | CLAUDE.md / asp3/asp3_core/AGENTS.md |
| ホストPC構築・概念（TrustZone/ベクタ/HRT精度・LinkServer の罠） | docs/host-setup.md / docs/tech-notes.md |
このリポの作業は NXP 側ファイルに閉じる（asp3/asp3_core/ submodule は無変更が原則）。
1. ボード対応表（最重要）
ボードごとに「プロジェクトパス・ASP3ターゲット・SDKデバイス・LinkServer名」が違う。
ここを取り違えるとビルド／書込みが失敗する。
| 項目 | EVK-MIMXRT685 | FRDM-MCXN947 |
|---|
| プロジェクト（cd 先） | evkmimxrt685/sample1 | frdm_mcxn947/sample1 |
| CMake プリセット | Debug（/ Release） | Debug（/ Release） |
| ASP3 ターゲット | evkmimxrt685_mcuxsdk | frdmmcxn947_mcuxsdk |
| SDK デバイス submodule | sdk/devices-rt（RT600/MIMXRT685S） | sdk/devices-mcx（MCXN/MCXN947） |
LinkServer device:board | MIMXRT685S:EVK-MIMXRT685 | MCXN947:FRDM-MCXN947 |
| デバッグ USB / VCOM | J5 / /dev/ttyACM0 115200 | J17 / /dev/ttyACM0 115200 |
| ブート | FlexSPI XIP（FCFB/flash_config 要） | 内蔵フラッシュ（XIP/FCFB 不要） |
| シリアル | Flexcomm0 USART（fsl_usart） | LPUART4（fsl_lpuart） |
| コアクロック / HRT | 250.105MHz / CTIMER0 1.000421MHz（+421ppm） | 150MHz / CTIMER0 正確に 1MHz |
両ボードとも生成物は build/<preset>/asp.elf。チップ層は両方とも
TOPPERS_ENABLE_TRUSTZONE 定義（SDK startup が Secure ブートのため。詳細は porting skill）。
2. ビルド
cd evkmimxrt685/sample1
cmake --preset Debug
cmake --build build/Debug
アプリ差し替え（asp3_core 標準の -D。パスは asp3_core ルート基準）：
CORE=$PWD/../../asp3/asp3_core
cmake --preset Debug -B build/Debug-porting \
-DASP3_APPLDIR=$CORE/test/porting -DASP3_APPLNAME=test_porting \
-DASP3_EXTRA_APP_C_FILES=$CORE/test/porting/tap.c
cmake --build build/Debug-porting
CMakePresets.json は version 7（MCUXpresso for VS Code 拡張が環境ブロックを注入する）。
注入されるマシン固有パスはビルドで未参照のため、CI や別環境でもビルドは通る。
性能計測（DWT CYCCNT 時間源）
histogram サービスの時間源を μs 分解能の fch_hrt() から DWT CYCCNT（サイクル精度） に
切り替えるには、ビルド時に USE_ARM_DWT_PMCNT を定義する（裏取り済み＝ビルド通る）：
cmake --preset Debug -B build/DbgPerf -DCMAKE_C_FLAGS=-DUSE_ARM_DWT_PMCNT
cmake --build build/DbgPerf
- ns 変換係数は
target_syssvc.h の HIST_CONV_TIM（CPU_CLOCK_HZ 依存・ボード毎）。
- 仕組み・他アーキ（arm_gcc=PMCCNTR / riscv=cycle CSR）との関係は
asp3/asp3_core/arch/arm_m_gcc/common/PERF_DWT.md（概念の正本）。
- perf0..5 ベンチアプリは asp3_core の
test/ 側にあり histogram syssvc を要する。
このリポでの turnkey なビルド線は未整備（必要なら asp3_core test/testexec.py の
perf 結線＝SYSOBJ=histogram を参照）。
3. 書込み・シリアル（標準＝LinkServer）
cd <board>/sample1/build/Debug
/usr/local/LinkServer/LinkServer flash MIMXRT685S:EVK-MIMXRT685 load asp.elf
/usr/local/LinkServer/LinkServer flash MCXN947:FRDM-MCXN947 load asp.elf
load は書込み後に自動でリセット実行。LinkServer は PATH に入らない（フルパス）。
stty -F /dev/ttyACM0 115200 raw -echo
cat /dev/ttyACM0
printf 'r' > /dev/ttyACM0
VCOM 単独リーダ厳守。複数リーダがバイトを奪い合い「文字化け・無出力」に見える
（最も時間を溶かす罠）。ツール詳細（J-Link 切替・OS Awareness・ファームウェア確認）は
porting-asp3-to-nxp/reference/flash-debug-tools.md。
最小チェック：バナー → task1 is running (NNN) → r で切替 → 仕上げに test_porting で # 6/6 passed。
4. 機能テスト（testexec ラッパ・ボード占有/並行禁止）
scripts/testexec_mcuxsdk.py が「1テストずつ configure→build→書込み→シリアル判定」を回す
（既定は RT685）。MCXN947 は --board と --ls-device を渡す：
scripts/testexec_mcuxsdk.py
scripts/testexec_mcuxsdk.py task1 sem1
scripts/testexec_mcuxsdk.py --rejudge
scripts/testexec_mcuxsdk.py --board frdm_mcxn947/sample1 --ls-device MCXN947:FRDM-MCXN947
判定は完走マーカ（All check points passed. / hrt1・dlynse は専用マーカ）。
perf*・arm_* は対象外。既知 FAIL は cpuexc1/cpuexc4（arm_m 共通・上流由来。
asp3_core docs/dev/issue-cpuexc-armm.md）、cpuexc10 は SKIP。
5. デバッガ切替（標準 CMSIS-DAP+LinkServer ／ J-Link はオプション）
ターゲット名・手順は共通のまま、オプションだけ変える（詳細は flash-debug-tools.md）：
| ツール | J-Link に切替 | 既定 |
|---|
CMake（ninja flash/gdbserver/debug/osdebug） | -DMIMXRT685_DEBUGGER=jlink | linkserver |
asp3_core ボードランナ run_board_mimxrt685evk.sh | MIMXRT685_FLASH=jlink | linkserver |
| testexec ラッパ | --flash-tool jlink | linkserver |
6. オペレーション上の地雷（このリポ固有）
- MCXN947 のビルドに
sdk/devices-mcx が要る。--recurse-submodules クローンなら入るが、
MCX 追加より前のクローンは未初期化で
Cannot find source file: .../MCXN947/gcc/startup_MCXN947_cm33_core0.S になる。
→ git submodule update --init sdk/devices-mcx（裏取り済み＝これで通る）。
- CI は EVK-MIMXRT685 のみビルド（
.github/workflows/ci.yml）。MCXN947 はローカル検証
（CI 未対応）。MCXN947 を変更したらローカルで cmake --build を必ず確認。
- 書込みツール（LinkServer）は PATH 外。スクリプトは環境変数
LINKSERVER で上書き可。
- MCXN947 固有のブリングアップ地雷（CTIMER クロックディバイダ HALT・
-mcmse）は
docs/verification.md と porting skill に記録済み（運用では既に解決済み・再現不要）。
裏取り状況（2026-06-20 実行）
- 両ボードとも
cmake --preset Debug && cmake --build build/Debug → asp.elf 生成を確認。
sdk/devices-mcx 未初期化での MCXN947 ビルド失敗→git submodule update --init で解消を確認。- LinkServer デバイス名は
/usr/local/LinkServer/devices/{EVK-MIMXRT685,FRDM-MCXN947}.json で確認。
-DCMAKE_C_FLAGS=-DUSE_ARM_DWT_PMCNT のビルド成功を確認。- testexec ラッパの
--board/--ls-device/--flash-tool を実コードで確認。
