oep-client-python 0.0.34__tar.gz → 0.0.37__tar.gz

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/CHANGELOG.md

@@ -2,6 +2,120 @@
 
 ## Unreleased
 
+## 0.0.37
+- (JA) 設定を core（oep-spec core §13、9fc6ad9 / c4fbd6e）に合わせた。`oep_client.config`（`oep.probe.config`）を無くし、
+  `oep_client.settings` を足した:
+  - fn 0 の get / set / unset / save / state / network。値は（fn、項目番号、key）で運び、host には（カテゴリ、平らな名前、値、出どころ）で見せる。
+  - 設定のファイル（docs/oep-settings-file.ja.md）の書き出しと入れ直し（`export`、`plan_import`、`apply_import`）。secret は読まない。
+  - `oep config` を `oep settings`（show / items / set / unset / save / state / network / export / import）に置き換えた。
+  - 仮想ベンチは fn 0 の設定（各持ち主の項目、固定・既定の値、名前での保存）を持つ。共有ベクタの設定の場合と settings_file.json を通す。
+  - 線の名前の探し方（`find_line`）は、出どころによらず全部の `channel.{}.label` から探す（firmware の label も設定の固定の値）。
+- (JA) libusb1 経由の HID（hidapi がない環境の経路）で、カーネルの HID ドライバを外して interface を claim してから、
+  レポート記述子を読むようにした。今までは claim の前に読んでいて、Linux の usbfs に LIBUSB_ERROR_IO で断られていた
+  （RP2 の HID は interface 3、2026-10-22）。OEP の記述子でなければ interface を戻し、ドライバを付け直す。
+- (JA) `CaptureDrops` に dropped_bytes を足した。ストリームが落としたバイト数の合計で、理由を問わない（写す経路で区画を捨てた
+  分も含む）。oep-probe-arduino e08687c 以降。それより前の形では None。
+- (JA) USB（vendor bulk）の既定を `UsbProcessStream` にした（POSIX のみ）。
+  - wireskein の測定: 負荷 14 の host で、P4X の 40 MB/s・30 秒を取った。thread の版は 6 回中 3 回で欠損があり、process の
+    版は 3 回とも欠損 0 だった。
+  - `OEP_USB_STREAM=thread` で、今までどおり UsbAsyncStream（このプロセスのスレッド）を使う。Windows は pipe を fd で
+    渡せないので、今までどおり。
+  - 子プロセスが動かない（起動できない、準備の前に終わった、時間切れ）ときは、警告を出して UsbAsyncStream に戻す。機器が
+    無いという答えはそのまま返す。
+  - 開くのに、子プロセスを起こす分だけ時間がかかる（約 0.6 秒）。
+- (JA) `CaptureDrops` に spill_peak と spill_bytes を足した。P4 のファーム 826eee0 からの、ストリームの DMA リングの後ろの
+  待避 FIFO（PSRAM、8 MiB）の最大使用量と大きさ。それより前のファームの形では None。
+- (JA) `UsbAsyncStream` の既定を 32 KiB × 480 本にした（前は 64 KiB × 128）。
+  - probe は各転送を短いパケットで終えるので、URB の大きさによらず 1 本に 1 フレーム（40 MB/s の P4X で約 19 KB）しか入らない。
+    host が溜められるのは「本数 × 1 フレーム」になる（64 KiB × 128 は約 2.4 MB、40 MB/s で 60 ms）。wireskein の測定による。
+  - 480 × 32 KiB は 15 MiB で、usbfs_memory_mb の既定 16 に収まる。usbfs が途中で断ったら、そこまでの本数で続ける
+    （1 本も出せなければ例外）。
+  - `open_usb_host(urb_size=, depth=)` で選べる。UsbProcessStream は、このプロセスの URB_SIZE / DEPTH を引き継ぐ。
+- (JA) `UsbProcessStream`: UsbAsyncStream を別のプロセス（`python -m oep_client.usb_stream`）で動かす。形は UsbAsyncStream と同じ
+  （read、in_waiting、write、reset_input_buffer、close、stats）。
+  - IN の転送の受け取りと出し直しは、そのプロセスの event のスレッドと GIL で行う。host の側のスレッドが GIL を長く持っても
+    （numpy、大きな bytes の結合など）、転送は止まらない。読まれていない分は、そのプロセスに溜まる。
+  - データはパイプで、write と stats は socket pair で受け渡す。multiprocessing の spawn は使わない（呼び出し側の __main__ を
+    もう一度走らせるため）。
+  - 環境変数 `OEP_USB_STREAM=process` で、open_host の USB がこれを使う（既定は今までどおり UsbAsyncStream）。
+  - wireskein の切り分けを受けた。負荷 14 のとき、event のスレッドが最大 6 秒止まり、40 MB/s の P4X で欠損が出ていた。
+    実機では、まだ確かめていない。
+- (JA) `UsbAsyncStream`: 戻った IN の転送は、データを写したらすぐ出し直し、ロック（read() と共有）はその後に取るようにした。
+  前はロックを取ってから出し直していたので、read() がロックを持つ間は転送が戻らなかった。`stats()` を足した（callbacks、
+  inflight_min = callback の時点で出ていた転送の最少、gap_max_s = callback の間隔の最大、buffered_max、bytes、urb_size、
+  depth）。`open()` / コンストラクタで urb_size と depth を選べる（既定は URB_SIZE × DEPTH = 64 KiB × 128）。
+  wireskein の切り分け（負荷 14 で 40 MB/s に欠損。event のスレッドが時々数百 ms から数秒止まる）を受けた。
+- (JA) `CaptureGroup.stream(link, tracks, seconds=, nbytes=, into=)` -> `{fn: Received}`: ストリーミングのトラックを集めた
+  capture-group で、1 本の経路に混ざって届く push をトラックごと（fn ごと）の Received に分けて集める。seq、generation、gap、
+  segment_info の扱いは `LogicCapture.stream()` と同じ（その内側を `_collect()` に切り出した）。nbytes は全トラックが届くまで待つ。
+  `CaptureGroup.finish()` は各トラックの `finish()` を呼ぶ。wireskein の依頼。
+- (JA) `Wire.scan`: 1 回の要求に入れる組を、255 までかつ経路の max_frame に収まる数にした。前は 255 組を詰めていて、
+  max_frame 1024 の経路で候補が多いと（rp2350-pins の 812 組）1031 バイトの要求を送っていた（仮想ベンチはそれを受けていた）。JS への移植で見つかった。
+
+## 0.0.36
+- (JA) 試験: segment_columns の試験は、numpy が無ければ飛ばす（numpy は任意の依存。numpy の無い CI で落ちていた）。
+- (JA) `CaptureGroup.trigger_caps()` -> `TriggerCaps | None`: capture-group の describe の trigger_caps（§4.4、0x41）を読む（max_stages、
+  max_terms、max_conds、cross_track、types、protocols、trigger_out_latency_ns。trigger_out が無ければ None）。`takes(COND[...])` と
+  `kinds()`（宣言された条件の型の名前）で、bind の前に頼めるかを確かめられる。宣言なしや知らない形では None（宣言は目安で、正しいのは
+  bind の答え）。wireskein の依頼。P4X（5a61110）で level、edge、cross_up、cross_down と読めた。
+- (JA) `capture_blocks.segment_columns` / `LogicCapture.columns(data, samples)`: 形式 1 の区画を、ブロックを作らずに列で読む（numpy が要る）。
+  raw のチャネルはビット列、events のチャネルは区画を通した刻み（`EventColumn`: quanta、levels、counts、start_level）。fallback の
+  ブロックは、その標本から probe と同じ数え方で刻みに直す。検査は read_logic_blocks と同じ。ヘッダだけを Python で辿り、raw は
+  （fallback の組、r）ごとにまとめて、events は区画の全行を一度に読む（wireskein の提案と試作。60 ブロックの区画で 54 → 10 ms）。
+- (JA) 仮想ベンチ: 形式 0 / 4 とアナログの streaming も、1 回の tick で作るサンプルを BLOCKS_A_TICK までにした（形式 1 と同じ。作れる
+  速さで遅れて流す）。前は経過した時間ぶんを一度に作ろうとして、tick が長引くほど次の tick が重くなり、1 MHz × 2 本でも 0.3 秒の
+  あいだ push が 1 つも来ず、stop の応答に 12.8 秒かかっていた（wireskein の報告）。
+- (JA) oep-spec e1d5495 に追従（registry とベクタを取り込み）。configure / query の応答の judge_latency_ns（§3.3）を
+  `Config.judge_latency_ns` で読む（組の出来事の元の条件を判定するトラックの、出来事と知るまでの最大の時間。返さない probe は None）。
+- (JA) `UsbAsyncStream.DEPTH` の既定を 32 から 128 にした（64 KiB × 128 = 8 MiB、40 MB/s で 200 ms ぶん）。P4X の 40 MHz・8 本の 30 秒で、
+  32 では USB の受け取り側のときどきの止まり（URB の出し直しの遅れ、バス）で 0.2〜0.6 % を落とした。128 では wireskein の 2 回と
+  こちらの 5 回（形式 0 を 4 回、形式 4 を 1 回）、すべて落としなし。
+- (JA) `LogicCapture.stream()` の keepalive の間隔を、同じ `into` の呼びをまたいで数えるようにした。前は呼ぶたびに数え直していたので、
+  0.2 秒ずつ刻んで呼ぶ host では keepalive が 1 度も出ず、30 秒の取得の途中で lease が切れていた（wireskein の報告）。
+- (JA) `capture.CaptureDrops.buffer_peak`: Arduino の firmware の capture-drops に足された最後の u32（ストリームの溜め、P4 では PSRAM の
+  DMA リングが、送られずに持っていた最大のバイト数）。前の形（30 B）は `buffer_peak` を None にして読む。
+- (JA) oep-spec 569e86b（capture §3.3 stream_buffer）に追従。`Config.stream_buffer` と `Config.tolerable_delay_s()`（host が読みを止めて
+  よい時間の目安。形式 1 / 2 は最悪の帯域を渡す）。仮想ベンチは streaming の応答で 1 MiB を返す。`link.reader`（"usb-async"、"usb-sync"、
+  ほかは stream の型の名前）で、どちらの USB の読みかが分かる（wireskein の依頼。同期の読みでは host の揺れが probe の落としになる）。
+- (JA) 名前付き拡張（core §2.2、tag 0x7F）を共通に読む: `message.named_extensions(tlvs)`、`Tail.named()`（名前 → data、同じ名前は最初）。
+  キャプチャの `Status.named`。Arduino の firmware 独自の診断 `capture.CaptureDrops`（`io.github.open-embedded-probe.capture-drops`:
+  落としの内訳、経路、stage の数、メモリ）を `CaptureDrops.of(status)` で読む（wireskein の依頼）。registry と vectors は oep-spec 0eb94f8。
+- (JA) 受信: 呼び出し側の時間切れの時点で frame が途中まで届いていても、FramingLost にしない（届いた分を取っておいて次の呼び出しで続ける）。
+  FramingLost は、frame の途中で受信が probe_frame_gap_ms 以上止まったときだけ。16 KiB の push が 20 ms の pump の境目にかかると「区切りが
+  崩れた」とみなして同期をやり直し、その間の push を捨てていた（2026-10-20、P4X の形式 4）。
+- (JA) `capture_blocks.LogicBlock.start_levels`: events のチャネル全部（fallback も含む）の、ブロックの直前のレベル（§1.3 start_level）。
+  区画の境目の変化を、fallback のブロックでも数えられる（wireskein の依頼）。
+- (JA) 仮想ベンチ: 形式 1 の streaming は、1 回の tick で作るサンプルを BLOCKS_A_TICK までにする（作れる速さで遅れて流す）。stop は作りかけの
+  ブロックだけを閉じる。2 MHz × 4 本で、遅れを取り戻そうとして応答しなくなっていた（wireskein の報告）。
+- (JA) 仮想ベンチの §4.4 を oep-spec e87b50b に合わせた（段の入り口の when、アーム前の最後のサンプルとの比較、決めた段のトラックの不確かさ）。
+- (JA) oep-spec 8e7ca20 の capture に追従（第 1 波）。
+  - 形式 1（ロジックのブロック、§1.3）: `capture_blocks.read_logic_blocks` で復号する。raw と fallback のチャネルはビット列（bytes）で、events の
+    チャネルは (tick、level、count) で返す。numpy があれば、見出しだけを Python で読み、残りを numpy でまとめて読む。
+    `LogicCapture.configure(data_format=, events=, roles=, block_max=)` で設定し、read_segment は区画の終わり（次の区画の position か
+    write_pos）まで 1 回で読む。`lc.blocks()` で復号し、`worst_bytes()` で最悪の大きさを計算する。
+  - 形式 4（試験の並び）: ストリームの position k のバイトが k & 0xFF になる。
+  - trigger_opts（arm、rearm、when、hysteresis）は `capture.TriggerOpts` で設定する。既定は arm 1、when 0 で、前の版の「最初に見えた条件で立つ」は
+    arm 0、when 1 で表す。
+  - トリガの記録（§3.10）は `lc.triggers()` で読む。triggered の出来事は record、sample、uncertainty_ns も持つ。
+  - 仮想ベンチ: P4 のロジックは形式 1（mode 1 / 2）と形式 4 を、アナログは形式 4 を宣言する。rearm 1 の repeat では区画の間も state 3 のまま
+    待ち、status の flags bit2、区画の flags bit3 / bit0 を立てる。configure は実装した TLV だけを知っていて、ほかを critical なら unsupported で
+    断る。capture-group の force は §4.4 を入れるまで ops から外す。
+  - conformance: triggers と group の force を任意の op として扱い、bind の TLV が定義されていても通す。
+  - 仮想ベンチの形式 1 は streaming にも対応する。ブロックは揃ってから送る。stop では短い最後のブロックを送る。区画の位置は、区画が始まるたびに
+    記録した表から引く。購読が無い間に始まった区画は丸ごと捨てる。
+  - capture-group §4.4 の出来事の元（trigger source）を入れた。
+    - クライアント: `capture.TriggerSource`、`Stage`、`Cond`（level、edge、cross_up / cross_down、above / below、timer）で式を組み、
+      `CaptureGroup.bind(tracks, source)` で送る（どれも critical）。`CaptureGroup.force()`、`GroupStatus.trigger`（fn、ns、uncertainty_ns）、
+      group の triggered（trigger_fn、record、ns、uncertainty）。トラックは `trigger=(LINKED, 0, 0)` と自分の pretrigger で configure する。
+    - 仮想ベンチ（P4 の group）: features bit 0 と trigger_caps を宣言し、force を持つ。持つものは、4 段 × 4 項 × 4 条件、トラックをまたぐ AND、
+      count、within_ns、on_timeout 0 / 1、abort、arm。rearm 1、外部の入力、trigger_out、serial は持たない。
+      - 判定は、項が見るトラックのうち最も速いもののサンプルで行う（時刻の来たサンプルだけを見る）。
+      - 出来事では、各トラックが自分のサンプルで区画を切り、自分の triggered を送る。
+      - linked のトラックを単独で start すると cause 6、trigger source の組に linked でないトラックを入れると cause 6。
+  - 仮想ベンチの `--logic-wave ROLE=SPEC`（`virtual_bench_capture.logic_wave`）: ロジックの役割ごとに波形を選ぶ。counter、quiet[:LEVEL]、
+    square:PERIOD、uart:BAUD[:TEXT]（8N1 の文字、文字の間はアイドル）。静かな線と UART のような線で、形式 1 の典型の帯域を測れる
+    （§1.3 の例: 2110 B / ブロック、125 MHz で 64.4 MB/s。仕様の見積もりは 63.6 MB/s）。
+
 ## 0.0.34
 - (JA) oep-spec bc52327（debug §2 の閉じた後の保持、§2.2 holds、probe.config の wire-hold、core §8 の例外）に追従。仮想ベンチは、線切れ以外で
   接続を閉じたらその口の休みの状態を保持し、ピンを取られる、wire-hold が off、idle / disable の項目、で保持を終える。駆動が止まると halt を失う

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oep-client-python
-Version: 0.0.34
+Version: 0.0.37
 Summary: Open Embedded Probe (OEP) v1 host: serial / USB / TCP transports, the session rules, the standard interfaces, and a virtual bench
 Project-URL: Homepage, https://github.com/Open-Embedded-Probe/oep-client-python
 Project-URL: Repository, https://github.com/Open-Embedded-Probe/oep-client-python
@@ -84,7 +84,7 @@ names starting with `_`, may change. Check probe/client compatibility using the
 | `pins` | `oep pins`: classify the channels, hold-low search, scan, identify, confirm the reset line, suggest the connection profile and the labels (`PinFinder`) |
 | `console` | `oep.target.console` (position streams: read answers carry their length; marks carry `time_ns`, the common kinds lost / clear / host and the console's reset 0x40 / restart 0x41; the lock-free `streams()` list of stream, connection and mechanism; `open(conn, mechanism)` always makes a new stream (u32) on the connection - a second on a connection with a live one is unavailable cause 6 -; a stream is the session's - close, its connection's release and the session's end release it with its buffer, and its number answers no_resource after that; a write goes into the stream's send queue - its size is the probe's own, not declared -, accepted = min(count, its free space), 0 only when full; an SDI stream's write is unsupported; marks, clear, mark and write are optional) and `ConsoleIO`, read as bytes and written in chunks of at most one frame, on from each answer's accepted (`stall_s`: TimeoutError when nothing is taken for that long) |
 | `fixture` | `oep.fixture.gpio` (`set([(ch, mode)])` applied in order in one request, `read(channels)` the levels; the output strength is the probe's own - there is no drive selection) / `uart` (its stream is the plan's; nothing is received until `configure(baud, fmt)`; `status()` = `UartStatus(baud, format)` in force, baud 0 and format 0 while not configured; a configure the probe could not bring up raises `Failed` and leaves it not configured) / `i2c-target` (one form: `configure(address)` - the target made anew -, every controller write with data one frame for `read_rx`, reads answered from `preload_tx(data)` slots or 0xFF, `status()` = `I2cStatus(state, queued, rx_frames, tx_slots, errors)`, `stretch` when the ops offer it, `internal_pullups`: whether it enables pull-ups of its own; the reserved addresses 0x00-0x07 / 0x78-0x7F refused before sending) / `spi-target` (no reset: configure again; `cs_setup_ns`: how long after CS the first bit is sure; `oep dump` shows it) |
-| `config` | `oep.probe.config` (label / idle / disable items keyed by channel, get / set / unset with counts, save / erase / state when the probe has storage; `describe()` = the declarations, `state()` = `State(storage, saved_generation, reason)`; the generation counts the changes of a boot from 1: `same_items(a, b)` compares items, `needs_save()` says whether a save would change the storage, `apply(wanted, save=False)` sets / unsets what differs (host guide §15); `find_line(cfg, "nrst", profile=None)` = host guide §5.3's line lookup, the firmware's fixed labels as its last step) |
+| `settings` | the core's settings (oep-spec core §13): fn 0's get / set / unset / save / state / network. `Settings(hst)`: `catalog()` = the names of this boot (each fn's category `core` / `name/instance`, items, choices, channel / route / netif names), `show()` = every value as (category, flat name, value, origin), `set_named(category, {flat: value})` / `unset_named` / `unset_all`, raw `set` / `unset` by (fn, number, key), `save()`, `state()`, `network()`; `export()` / `plan_import(doc)` / `apply_import(plan)` = the settings file (oep-spec docs/oep-settings-file.ja.md; secrets never read); `find_line(source, "nrst", profile=None)` = host guide §5.3's line lookup over every channel label |
 | `capture` | `oep.fixture.logic` / `analog` / `capture-group` (revision 1, oep-spec oep-if-capture). configure's TLVs follow core §2.3: a value the probe cannot honour is refused unsupported with the tag as sent (the table's TLVs go without the critical bit); the answer holds the actual values, its samples among them (analog: a scale for every role, a skew left out read as 0). Every `start()` returns a new generation (`LogicCapture.generation`, never re-used within a boot: past 0xFFFFFFFF a start is refused until a reboot) that read and release name - `read_segment(segment)` passes the segment's own - and every event carries (`events()` drops an earlier start's); streaming data frames carry their generation and their segment (segment_info, never crossing a segment: `Received.segments`); `status()` returns a `Status`. A capture-group binds configured tracks with an immediate trigger, all in one mode, and starts them at once (`CaptureGroup.start` -> the group's start_ns; the group's and each track's generation). Every segment read goes to the `Host.on_capture` callbacks as a `CaptureRecord` (the hook for run recorders; no wireskein dependency) |
 | `decode` | decoding capture channels (I2C) |
 | `registry` | generated from oep-spec's number table (never edited; copied again from oep-spec). The public way to reach an interface by name is `registry.INTERFACES[name]` (`.revision`, `.op`, `.tlv`, `.enum`, e.g. `INTERFACES["oep.fixture.uart"].enum["role"]`); the module-level names (`FIXTURE_UART`, ...) are the same objects |
@@ -135,10 +135,13 @@ A probe's CDC ports (`/dev/ttyACM*`) need no rule beyond the usual `dialout` gro
 
 ```sh
 oep dump --port <probe>                      # what the probe offers (--virtual p4-x035: no hardware)
-oep config show <probe>                      # the settings, the declarations and the storage state
-oep config state <probe>                     # the storage state alone (lock-free)
-oep config label <probe> 23 nrst             # also: idle CH MODE, disable CH..., remove KIND CH (each takes --save)
-oep config save <probe>                      # kept over a restart (also: erase)
+oep settings show <probe>                    # every value with its origin, and the storage state
+oep settings items <probe>                   # what each owner declares (names, forms, choices)
+oep settings set <probe> core channel.GPIO23.label=nrst channel.GPIO20.idle=pull-up [--save]
+oep settings unset <probe> core channel.GPIO20.idle [--save]     # or --all (then --save empties the storage)
+oep settings save <probe>                    # kept over a restart
+oep settings export <probe> jig.oep-settings.json                # the user's values by name (secrets left out)
+oep settings import <probe> jig.oep-settings.json [--save]       # shows the changes, asks, then sets / unsets
 oep speed <probe> [921600,500000] [--verify] [--flows out:2]  # port_speed: raise a UART bridge (default 500000), print the report (below)
 oep pins <probe> --power 5 --wire swio       # where the target is wired: debug pins, reset line, labels (below)
 oep clock <probe> [-n 8] [--json]            # fn 0's clock: uptime_ns and boot_id against this host's time (shortest of n)
@@ -150,7 +153,7 @@ oep linktest <probe> ...                     # --timeout: 0.3 s an answer by def
 
 `<probe>` is a serial port, `tcp://HOST:PORT`, `tcp://HOST` (the port DNS-SD finds for that host), `tcp:UNIT_ID` (the
 probe DNS-SD finds by its TXT unit_id; describe's unit_id must say the same, else it is closed) or
-`usb[:VID:PID[:SERIAL]]`. A change takes the lock (owner "oep config") and
+`usb[:VID:PID[:SERIAL]]`. A change takes the lock (owner "oep settings") and
 ends the session after it; it takes effect at once and, after `save`, stays over a restart.
 
 ### A host run again: the kept session id
@@ -176,7 +179,7 @@ sets `hst.kept = kept_session.KeptSession()` on a Host it builds itself.
 
 ### TCP
 
-A probe that serves OEP over TCP is found by DNS-SD (its network settings are not oep.probe.config's).
+A probe that serves OEP over TCP is found by DNS-SD (its network settings are the core's: transports §7).
 
 - `oep find` browses `_oep._tcp` (transports §3, host guide §4.1) and lists unit_id, host, port and address. The
   service name `oep` is not registered, so another service may advertise `_oep._tcp`: each instance is verified first
@@ -249,9 +252,9 @@ attach swio 19: target_id 00310510 (WCH DMI 0x7F) -> ch32v00x, halted at dpc 0x1
   option bytes (read only): RST_MODE 10 (USER 0xf7): NRST on PD7, 12 ms ignore window
   attach under reset through 4 (held 20 ms): dpc 0x0 -> the reset line
 profile: wire swio, pins 19   (the host's to keep: the probe keeps no wiring)
-label: oep config label ... 4 nrst   (not written)
-label: oep config label ... 5 power_hi   (not written)
-idle:  oep config idle ... 5 output-high   (keeps the target powered while no plan holds channel 5; not written by this tool)
+label: oep settings set ... core channel.GPIO4.label=nrst   (not written)
+label: oep settings set ... core channel.GPIO5.label=power_hi   (not written)
+idle:  oep settings set ... core channel.GPIO5.idle=high   (keeps the target powered while no plan holds channel 5; not written by this tool)
 released every plan (channel 5 is back to its idle state: the target is powered only while something drives it)
 done in 7.3 s
 ```
@@ -394,10 +397,10 @@ halted or a riscv-dm request of that connection runs (`console_take(sid)` hands
 lines outside through `gpio_world`); uart receives nothing until configured, status baud and format; i2c-target one form
 (a write with data one frame, cut at max_length; reads from preload_tx slots, else 0xFF); spi-target without reset.
 Capture: configure's TLVs follow core §2.3 alone; a bound track's start / configure is unavailable cause 4, a bind short
-of resources cause 2 with the fn; a read at or past the write position answers write_pos and len 0. probe.config: label / idle /
-disable items (idle 3 bytes; an item of another length malformed); the generation counts the changes of a boot from 1;
-state is storage_state, saved_generation, reason; at boot the saved items are checked one by one, disable first, and what
-fails is left out (partial). port_speed: baud / step / verify_ms on the UART bridge the request came in on, within
+of resources cause 2 with the fn; a read at or past the write position answers write_pos and len 0. The settings (core §13): each fn's items from its
+describe, values with their origin (the firmware's fixed / default ones from the profile); a value of another length
+malformed; the generation counts the changes of a boot from 1; state is storage_state, saved_generation, reason; at boot
+the saved values (by category and item name) are checked one by one, disable first, and what fails is left out (partial). port_speed: baud / step / verify_ms on the UART bridge the request came in on, within
 port_speed_tolerance_pct, phases 0-3 read by port_state; the virtual bench goes back after verify_ms, after
 port_speed_idle_ms with no good frame, or at the session's end - never on broken frames.
 

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/README.ja.md

@@ -52,7 +52,7 @@ GitHub Release、PyPI（Trusted Publishing）へ出す。変更は CHANGELOG.md
 | `pins` | `oep pins`: channel の分類、low に保つ探索、scan、識別、リセットの線の確かめ、接続プロファイルと label の提案（`PinFinder`） |
 | `console` | `oep.target.console`（位置つきのストリーム: read の応答は長さを持ち、マークは `time_ns` と、共通の kind の lost / clear / host、コンソールの reset 0x40 / restart 0x41 を持つ。ロック不要の `streams()` は stream、connection、mechanism の並び。`open(conn, mechanism)` はいつもその connection に新しいストリーム（u32）を作る - 生きているストリームのある connection への 2 つ目は unavailable cause 6 -。ストリームはセッションのもので、close、connection の解放、セッションの終わりでバッファごと解放され、その番号はその後 no_resource。write はストリームの送りの列に入る - 列の大きさは probe が決め、宣言しない -。accepted = count と列の空きの小さい方で、0 は列が満ちたときだけ。SDI のストリームへの write は unsupported。marks、clear、mark、write は任意）と、バイト列として読み、多くても 1 フレームずつ、応答の accepted の続きから書く `ConsoleIO`（`stall_s`: その間何も受けなければ TimeoutError） |
 | `fixture` | `oep.fixture.gpio`（`set([(ch, mode)])` は 1 つの要求で順に当て、`read(channels)` は level を返す。出力の強さは probe 自身のもので、選ぶ手段は無い）/ `uart`（ストリームは plan が作る。`configure(baud, fmt)` までは何も受けない。`status()` = いま効いている `UartStatus(baud, format)` で、configure していなければ baud 0、format 0。probe が立ち上げられなかった configure は `Failed` を上げ、configure していない状態に戻る）/ `i2c-target`（1 つの形: `configure(address)` - target を作り直す -、データのある controller の書き込み 1 回が `read_rx` の 1 フレーム、読み出しには `preload_tx(data)` の置き場か 0xFF で答える、`status()` = `I2cStatus(state, queued, rx_frames, tx_slots, errors)`、ops にあれば `stretch`、`internal_pullups`: 自分の pull-up を入れるか。予約のアドレス 0x00〜0x07 / 0x78〜0x7F は送る前に断る）/ `spi-target`（reset は無く、configure し直す。`cs_setup_ns`: CS の後、最初のビットが確かになるまでの時間。`oep dump` が出す） |
-| `config` | `oep.probe.config`（channel ごとの label / idle / disable の項目、count 付きの get / set / unset、保存を持つ probe では save / erase / state。`describe()` = 宣言、`state()` = `State(storage, saved_generation, reason)`。generation は起動から 1 で数える変更の回数: `same_items(a, b)` は項目で比べ、`needs_save()` は保存すると保存が変わるかを言い、`apply(wanted, save=False)` は違う分を set / unset する（host ガイド §15）。`find_line(cfg, "nrst", profile=None)` = host ガイド §5.3 の線の探し方で、firmware の固定 label が最後の段） |
+| `settings` | core の設定（oep-spec core §13）: fn 0 の get / set / unset / save / state / network。`Settings(hst)`: `catalog()` = その起動の名前（各 fn のカテゴリ `core` / `name/instance`、項目、選択肢、channel・経路・netif の名前）、`show()` = 全部の値を（カテゴリ、平らな名前、値、出どころ）で、`set_named(category, {平らな名前: 値})` / `unset_named` / `unset_all`、番号での `set` / `unset`、`save()`、`state()`、`network()`。`export()` / `plan_import(doc)` / `apply_import(plan)` = 設定のファイル（oep-spec docs/oep-settings-file.ja.md。secret は読まない）。`find_line(source, "nrst", profile=None)` = host ガイド §5.3 の線の探し方（全部の channel の label から） |
 | `capture` | `oep.fixture.logic` / `analog` / `capture-group`（revision 1、oep-spec の oep-if-capture）。configure の TLV は core §2.3 に従う: probe が守れない値は送ったままの tag で unsupported で断られる（表の TLV は critical を付けずに送る）。応答が実際の値で、samples もそれが正しい（アナログ: scale は役割ごとに必ずあり、省かれた skew は 0 と読む）。`start()` はそのたびに新しい世代を返す（`LogicCapture.generation`。同じ起動の間は使い回さず、0xFFFFFFFF の後の start は再起動まで断られる）。read と release はその世代を付け（`read_segment(segment)` は区画自身の世代を付ける）、どの出来事も世代を持つ（`events()` は前の start のものを捨てる）。ストリーミングのデータフレームは世代と自分の区画を持ち、区画をまたがない（segment_info、`Received.segments`）。`status()` は `Status` を返す。capture-group は configure 済みで即時のトリガの、同じ mode のトラックを束ね、一度に始める（`CaptureGroup.start` -> group の start_ns。group と各トラックの世代）。読んだ区画は `Host.on_capture` の callback に `CaptureRecord` で渡る（記録の受け口。wireskein には依存しない） |
 | `decode` | キャプチャのチャネルの復号（I2C） |
 | `registry` | oep-spec の番号の表から生成したモジュール（編集しない。oep-spec から写し直す）。名前からインターフェースの番号を引く公開の入口は `registry.INTERFACES[name]`（`.revision`、`.op`、`.tlv`、`.enum`。例 `INTERFACES["oep.fixture.uart"].enum["role"]`）。`FIXTURE_UART` などのモジュールの名前は同じもの |
@@ -102,10 +102,13 @@ probe の CDC の口（`/dev/ttyACM*`）は、いつもの `dialout` グルー
 
 ```sh
 oep dump --port <probe>                      # 能力の一覧（--virtual p4-x035 でハードウェアなし）
-oep config show <probe>                      # 設定、宣言、保存の状態
-oep config state <probe>                     # 保存の状態だけ（ロック不要）
-oep config label <probe> 23 nrst             # ほかに idle CH MODE、disable CH...、remove KIND CH（どれも --save を取る）
-oep config save <probe>                      # 再起動の後も残す（erase もある）
+oep settings show <probe>                    # 全部の値と出どころ、保存の状態
+oep settings items <probe>                   # 各持ち主が宣言する項目（名前、形、選択肢）
+oep settings set <probe> core channel.GPIO23.label=nrst channel.GPIO20.idle=pull-up [--save]
+oep settings unset <probe> core channel.GPIO20.idle [--save]     # --all なら全部（その後の --save で保存も空に）
+oep settings save <probe>                    # 再起動の後も残す
+oep settings export <probe> jig.oep-settings.json                # 利用者の値を名前で書き出す（secret は入らない）
+oep settings import <probe> jig.oep-settings.json [--save]       # 変わる所を見せ、確かめてから set / unset
 oep speed <probe> [921600,500000] [--verify] [--flows out:2]  # port_speed: UART bridge を速くし（既定 500000）、結果を出す（下）
 oep pins <probe> --power 5 --wire swio       # target のつながり方: debug のピン、リセットの線、label（下）
 oep clock <probe> [-n 8] [--json]            # fn 0 の clock: uptime_ns と boot_id をこの host の時刻に合わせて（n 回のうち往復が最短のもの）
@@ -116,7 +119,7 @@ oep linktest <probe> ...                     # --timeout: 既定は応答 1 つ
 ```
 
 `<probe>` はシリアルの口、`tcp://HOST:PORT`、`tcp://HOST`（その host に DNS-SD が見つけた port）、`tcp:UNIT_ID`（TXT の unit_id で
-DNS-SD が見つけた probe。describe の unit_id が同じでなければ閉じる）、`usb[:VID:PID[:SERIAL]]`。変更はロックを取り（owner "oep config"）、終わったら
+DNS-SD が見つけた probe。describe の unit_id が同じでなければ閉じる）、`usb[:VID:PID[:SERIAL]]`。変更はロックを取り（owner "oep settings"）、終わったら
 セッションを閉じる。変更はすぐ効き、`save` の後は再起動しても残る。
 
 ### 走り直す host: 残したセッションの id
@@ -141,7 +144,7 @@ Host に `hst.kept = kept_session.KeptSession()` を置く。
 
 ### TCP
 
-TCP で OEP を運ぶ probe は DNS-SD で見つける（ネットワークの設定は oep.probe.config のものではない）。
+TCP で OEP を運ぶ probe は DNS-SD で見つける（ネットワークの設定は core のもの: transports §7）。
 
 - `oep find` は `_oep._tcp` を browse し（transports §3、host ガイド §4.1）、unit_id、host、port、アドレスを並べる。service の名前
   `oep` は登録した名前ではないので、別のサービスが `_oep._tcp` を広告しうる: どの instance もまず確かめる（`discovery.verify`、
@@ -209,9 +212,9 @@ attach swio 19: target_id 00310510 (WCH DMI 0x7F) -> ch32v00x, halted at dpc 0x1
   option bytes (read only): RST_MODE 10 (USER 0xf7): NRST on PD7, 12 ms ignore window
   attach under reset through 4 (held 20 ms): dpc 0x0 -> the reset line
 profile: wire swio, pins 19   (the host's to keep: the probe keeps no wiring)
-label: oep config label ... 4 nrst   (not written)
-label: oep config label ... 5 power_hi   (not written)
-idle:  oep config idle ... 5 output-high   (keeps the target powered while no plan holds channel 5; not written by this tool)
+label: oep settings set ... core channel.GPIO4.label=nrst   (not written)
+label: oep settings set ... core channel.GPIO5.label=power_hi   (not written)
+idle:  oep settings set ... core channel.GPIO5.idle=high   (keeps the target powered while no plan holds channel 5; not written by this tool)
 released every plan (channel 5 is back to its idle state: the target is powered only while something drives it)
 done in 7.3 s
 ```
@@ -331,9 +334,9 @@ restart 0x41。DMDATA / dmseq のストリームの送りの列は poll ごと
 （外の線は `gpio_world`）。uart は configure するまで何も受けず、status は baud と format。i2c-target は 1 つの形（データのある書き込み
 1 回が 1 フレームで max_length で切る。読み出しは preload_tx の置き場から、無ければ 0xFF）。spi-target に reset は無い。capture:
 configure の TLV は core §2.3 だけに従う。bind されたトラックの start / configure は unavailable cause 4、資源の足りない bind は cause 2 と
-fn。書き込み位置以降の read は write_pos と len 0 を答える。probe.config: label / idle / disable の項目（idle は 3 byte。長さが形と違う
-項目は malformed）。generation は起動から 1 で数える変更の回数。state は storage_state、saved_generation、reason。起動時は保存した項目を
-1 つずつ確かめ、disable を先に当て、当てられないものは外す（部分適用）。port_speed: 要求が来た UART bridge の口への
+fn。書き込み位置以降の read は write_pos と len 0 を答える。設定（core §13）: 各 fn の項目は describe から、値は出どころつき（firmware の固定・既定は
+profile から）。長さが形と違う値は malformed。generation は起動から 1 で数える変更の回数。state は storage_state、saved_generation、reason。
+起動時は保存した値（カテゴリと項目の名前で）を 1 つずつ確かめ、disable を先に当て、当てられないものは外す（部分適用）。port_speed: 要求が来た UART bridge の口への
 baud / step / verify_ms で、port_speed_tolerance_pct の内、phase 0〜3 は port_state で読める。仮想ベンチが戻るのは verify_ms の後、正常な
 フレームの無い port_speed_idle_ms の後、セッションの終わり - 壊れたフレームでは戻らない。
 

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/README.md

@@ -59,7 +59,7 @@ names starting with `_`, may change. Check probe/client compatibility using the
 | `pins` | `oep pins`: classify the channels, hold-low search, scan, identify, confirm the reset line, suggest the connection profile and the labels (`PinFinder`) |
 | `console` | `oep.target.console` (position streams: read answers carry their length; marks carry `time_ns`, the common kinds lost / clear / host and the console's reset 0x40 / restart 0x41; the lock-free `streams()` list of stream, connection and mechanism; `open(conn, mechanism)` always makes a new stream (u32) on the connection - a second on a connection with a live one is unavailable cause 6 -; a stream is the session's - close, its connection's release and the session's end release it with its buffer, and its number answers no_resource after that; a write goes into the stream's send queue - its size is the probe's own, not declared -, accepted = min(count, its free space), 0 only when full; an SDI stream's write is unsupported; marks, clear, mark and write are optional) and `ConsoleIO`, read as bytes and written in chunks of at most one frame, on from each answer's accepted (`stall_s`: TimeoutError when nothing is taken for that long) |
 | `fixture` | `oep.fixture.gpio` (`set([(ch, mode)])` applied in order in one request, `read(channels)` the levels; the output strength is the probe's own - there is no drive selection) / `uart` (its stream is the plan's; nothing is received until `configure(baud, fmt)`; `status()` = `UartStatus(baud, format)` in force, baud 0 and format 0 while not configured; a configure the probe could not bring up raises `Failed` and leaves it not configured) / `i2c-target` (one form: `configure(address)` - the target made anew -, every controller write with data one frame for `read_rx`, reads answered from `preload_tx(data)` slots or 0xFF, `status()` = `I2cStatus(state, queued, rx_frames, tx_slots, errors)`, `stretch` when the ops offer it, `internal_pullups`: whether it enables pull-ups of its own; the reserved addresses 0x00-0x07 / 0x78-0x7F refused before sending) / `spi-target` (no reset: configure again; `cs_setup_ns`: how long after CS the first bit is sure; `oep dump` shows it) |
-| `config` | `oep.probe.config` (label / idle / disable items keyed by channel, get / set / unset with counts, save / erase / state when the probe has storage; `describe()` = the declarations, `state()` = `State(storage, saved_generation, reason)`; the generation counts the changes of a boot from 1: `same_items(a, b)` compares items, `needs_save()` says whether a save would change the storage, `apply(wanted, save=False)` sets / unsets what differs (host guide §15); `find_line(cfg, "nrst", profile=None)` = host guide §5.3's line lookup, the firmware's fixed labels as its last step) |
+| `settings` | the core's settings (oep-spec core §13): fn 0's get / set / unset / save / state / network. `Settings(hst)`: `catalog()` = the names of this boot (each fn's category `core` / `name/instance`, items, choices, channel / route / netif names), `show()` = every value as (category, flat name, value, origin), `set_named(category, {flat: value})` / `unset_named` / `unset_all`, raw `set` / `unset` by (fn, number, key), `save()`, `state()`, `network()`; `export()` / `plan_import(doc)` / `apply_import(plan)` = the settings file (oep-spec docs/oep-settings-file.ja.md; secrets never read); `find_line(source, "nrst", profile=None)` = host guide §5.3's line lookup over every channel label |
 | `capture` | `oep.fixture.logic` / `analog` / `capture-group` (revision 1, oep-spec oep-if-capture). configure's TLVs follow core §2.3: a value the probe cannot honour is refused unsupported with the tag as sent (the table's TLVs go without the critical bit); the answer holds the actual values, its samples among them (analog: a scale for every role, a skew left out read as 0). Every `start()` returns a new generation (`LogicCapture.generation`, never re-used within a boot: past 0xFFFFFFFF a start is refused until a reboot) that read and release name - `read_segment(segment)` passes the segment's own - and every event carries (`events()` drops an earlier start's); streaming data frames carry their generation and their segment (segment_info, never crossing a segment: `Received.segments`); `status()` returns a `Status`. A capture-group binds configured tracks with an immediate trigger, all in one mode, and starts them at once (`CaptureGroup.start` -> the group's start_ns; the group's and each track's generation). Every segment read goes to the `Host.on_capture` callbacks as a `CaptureRecord` (the hook for run recorders; no wireskein dependency) |
 | `decode` | decoding capture channels (I2C) |
 | `registry` | generated from oep-spec's number table (never edited; copied again from oep-spec). The public way to reach an interface by name is `registry.INTERFACES[name]` (`.revision`, `.op`, `.tlv`, `.enum`, e.g. `INTERFACES["oep.fixture.uart"].enum["role"]`); the module-level names (`FIXTURE_UART`, ...) are the same objects |
@@ -110,10 +110,13 @@ A probe's CDC ports (`/dev/ttyACM*`) need no rule beyond the usual `dialout` gro
 
 ```sh
 oep dump --port <probe>                      # what the probe offers (--virtual p4-x035: no hardware)
-oep config show <probe>                      # the settings, the declarations and the storage state
-oep config state <probe>                     # the storage state alone (lock-free)
-oep config label <probe> 23 nrst             # also: idle CH MODE, disable CH..., remove KIND CH (each takes --save)
-oep config save <probe>                      # kept over a restart (also: erase)
+oep settings show <probe>                    # every value with its origin, and the storage state
+oep settings items <probe>                   # what each owner declares (names, forms, choices)
+oep settings set <probe> core channel.GPIO23.label=nrst channel.GPIO20.idle=pull-up [--save]
+oep settings unset <probe> core channel.GPIO20.idle [--save]     # or --all (then --save empties the storage)
+oep settings save <probe>                    # kept over a restart
+oep settings export <probe> jig.oep-settings.json                # the user's values by name (secrets left out)
+oep settings import <probe> jig.oep-settings.json [--save]       # shows the changes, asks, then sets / unsets
 oep speed <probe> [921600,500000] [--verify] [--flows out:2]  # port_speed: raise a UART bridge (default 500000), print the report (below)
 oep pins <probe> --power 5 --wire swio       # where the target is wired: debug pins, reset line, labels (below)
 oep clock <probe> [-n 8] [--json]            # fn 0's clock: uptime_ns and boot_id against this host's time (shortest of n)
@@ -125,7 +128,7 @@ oep linktest <probe> ...                     # --timeout: 0.3 s an answer by def
 
 `<probe>` is a serial port, `tcp://HOST:PORT`, `tcp://HOST` (the port DNS-SD finds for that host), `tcp:UNIT_ID` (the
 probe DNS-SD finds by its TXT unit_id; describe's unit_id must say the same, else it is closed) or
-`usb[:VID:PID[:SERIAL]]`. A change takes the lock (owner "oep config") and
+`usb[:VID:PID[:SERIAL]]`. A change takes the lock (owner "oep settings") and
 ends the session after it; it takes effect at once and, after `save`, stays over a restart.
 
 ### A host run again: the kept session id
@@ -151,7 +154,7 @@ sets `hst.kept = kept_session.KeptSession()` on a Host it builds itself.
 
 ### TCP
 
-A probe that serves OEP over TCP is found by DNS-SD (its network settings are not oep.probe.config's).
+A probe that serves OEP over TCP is found by DNS-SD (its network settings are the core's: transports §7).
 
 - `oep find` browses `_oep._tcp` (transports §3, host guide §4.1) and lists unit_id, host, port and address. The
   service name `oep` is not registered, so another service may advertise `_oep._tcp`: each instance is verified first
@@ -224,9 +227,9 @@ attach swio 19: target_id 00310510 (WCH DMI 0x7F) -> ch32v00x, halted at dpc 0x1
   option bytes (read only): RST_MODE 10 (USER 0xf7): NRST on PD7, 12 ms ignore window
   attach under reset through 4 (held 20 ms): dpc 0x0 -> the reset line
 profile: wire swio, pins 19   (the host's to keep: the probe keeps no wiring)
-label: oep config label ... 4 nrst   (not written)
-label: oep config label ... 5 power_hi   (not written)
-idle:  oep config idle ... 5 output-high   (keeps the target powered while no plan holds channel 5; not written by this tool)
+label: oep settings set ... core channel.GPIO4.label=nrst   (not written)
+label: oep settings set ... core channel.GPIO5.label=power_hi   (not written)
+idle:  oep settings set ... core channel.GPIO5.idle=high   (keeps the target powered while no plan holds channel 5; not written by this tool)
 released every plan (channel 5 is back to its idle state: the target is powered only while something drives it)
 done in 7.3 s
 ```
@@ -369,10 +372,10 @@ halted or a riscv-dm request of that connection runs (`console_take(sid)` hands
 lines outside through `gpio_world`); uart receives nothing until configured, status baud and format; i2c-target one form
 (a write with data one frame, cut at max_length; reads from preload_tx slots, else 0xFF); spi-target without reset.
 Capture: configure's TLVs follow core §2.3 alone; a bound track's start / configure is unavailable cause 4, a bind short
-of resources cause 2 with the fn; a read at or past the write position answers write_pos and len 0. probe.config: label / idle /
-disable items (idle 3 bytes; an item of another length malformed); the generation counts the changes of a boot from 1;
-state is storage_state, saved_generation, reason; at boot the saved items are checked one by one, disable first, and what
-fails is left out (partial). port_speed: baud / step / verify_ms on the UART bridge the request came in on, within
+of resources cause 2 with the fn; a read at or past the write position answers write_pos and len 0. The settings (core §13): each fn's items from its
+describe, values with their origin (the firmware's fixed / default ones from the profile); a value of another length
+malformed; the generation counts the changes of a boot from 1; state is storage_state, saved_generation, reason; at boot
+the saved values (by category and item name) are checked one by one, disable first, and what fails is left out (partial). port_speed: baud / step / verify_ms on the UART bridge the request came in on, within
 port_speed_tolerance_pct, phases 0-3 read by port_state; the virtual bench goes back after verify_ms, after
 port_speed_idle_ms with no good frame, or at the session's end - never on broken frames.
 

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/docs/spec-follow-notes.ja.md

@@ -634,3 +634,50 @@ oep-client-python の `wip/rvswd-rest` ブランチ。
 （core §12 規則 8）。仕様は上の案のとおり（key は SWCLK の channel）。Python ebcf306 以降、Arduino 77a8002。
 実機（77a8002）: idle_clock 無しの attach で Pico 2 + L103 は low（halt を 3 秒保つ）、P4 + X035 は high。`rvswd-rest=high` で L103 は high になり halt が
 0.1 s で外れる（OFF が効く）。
+
+## 2026-10-16 capture の第 1 波（形式 1 / 4、trigger_opts、トリガの記録）
+
+- 形式 1 の区画は可変長で、区画の情報（37 byte）にバイト数が無い。host は、次の区画の position（最後なら write_pos）まで読み、ブロックの見出しで
+  切る。見出しを 1 つずつ読むと 1 ブロック 2 往復になるので避ける。wireskein と相談し、区画の情報は変えない（自己区切りで足りる）。
+- trigger_opts の既定（arm 1、when 0）は、前の版の「start から最初に見えた条件で立つ」と違う。前の版の動きは arm 0、when 1 で表す。テストの
+  多くがこの前提で書かれていて、既定が変わると一斉に落ちた（634 件）。
+- 実装して見つけ、仕様に戻したもの（oep-spec 8e7ca20）:
+  - rearm 1 のリピートで区画の間に待つときの state。2 にすると release を受けられないので、3 のまま status の bit2 で示す。
+  - flags bit0 は「置き場が無いときだけ」だったが、rearm の待ちでも区画は続かない。理由によらない意味にし、落としかどうかは bit3 で分ける。
+  - 全部 events のときの layout の w = 0。
+  - 形式 4 の「区画の position」は、ストリームの position の意味。
+  - 共有ベクタの logic triggered が旧来の 20 byte の形のまま残っていた。
+- arm 1 の飛ばしで、まだ時刻の来ていないサンプル（pretrigger − 1）を先に読むバグを、仮想ベンチの「時刻の前に波形を読まない」テストが捕まえた。
+
+## 2026-10-20 P4 の 40 MB/s streaming で当たった §2.2
+
+- §2.2 は「取り込みのキューやリングのあふれで落としたサンプルは、区画の中の落とし（エラー、state 6）」と書いている。P4 の zero-copy の
+  streaming では、区画（push の frame）は収穫のときに作る。DMA に追い越されたバイトは、まだどの区画にも入っていない。それでも
+  エラーにすると、host が 26 ms 止まっただけでキャプチャが終わる。
+- Arduino d92d988 は、追い越されたバイトと queue に入らなかった塊を落とし、position を飛ばす（隙間）。エラーにはしない。
+  wireskein が §2.2 を「失った範囲を区画の外に置けるなら、理由によらず隙間。区画の中で失ったときだけエラー」に直す案を出している。
+  → oep-spec bfbde01 でその案のとおりに直した（wireskein と合意）。実装と文面のずれは解消。
+
+## 2026-10-22 機能を選べるファームと、設定の項目の fn 番号
+
+Firmware/OepProbe のインターフェースと transport を、ビルドオプションなしで選べるようにした（oep-probe-arduino
+009873d〜cff9253）。選び方を変えて焼き直すと、fn の番号と経路（transport）の index が変わる。
+
+- probe.config の項目は、fn を番号で持つ。passthrough の fn、console-passthrough の wire_fn と console_fn がそれにあたる。
+  port も、fn 0 の経路の index で持つ。
+- 選び方を変えて焼き直すと、保存済みの項目が別の fn や経路を指す。たいていは型の検査で unsupported になり、その項目が
+  無効になるだけで済む。ただし同じ型の fn が別にあると、黙って別のものを指す。例は P4 の uart が 2 本ある場合。
+- 今の実装の回避: 新しい fn は既存の fn の後ろに足し、同じ選び方なら番号が変わらないようにした。選び方そのものを
+  変えた場合は防げない。
+- 仕様への論点（未決。所有者の判断待ち）: 項目の参照を fn の名前と instance で持つか。または、保存したときの
+  インターフェースの一覧（名前の並び）と一致しないときは、項目を unreadable にする規則を明記するか。
+  → oep-spec 9fc6ad9 で設定を core（§13）に移し、保存と書き出しは名前（カテゴリ、項目、key、参照）で持つことにして解消した。
+    fn の番号と経路の index は起動の間だけのもの。
+
+## 2026-10-22 core の設定（§13）を実装して当たったこと
+
+- §13.3 の初版は「text の規則（§2.1）に合わない text も malformed」と書いていた。2026-10-07 のルールレビューで決めた
+  「要求の text の中身は確かめない（host が見せるときに置き換える）」と食い違う。→ oep-spec c4fbd6e で「text は長さだけを
+  確かめる」に直した。Arduino と仮想ベンチも長さだけを確かめる。
+- 仮想ベンチの profile は、oep.probe.config が持っていた fn の番号を空けたままにした（後ろの fn の番号を変えないため）。
+  fn の番号に欠番があってよいかは core が明記していない（list は fn を並べるだけ）。実機の firmware は欠番を作らない。

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oep-client-python"
-version = "0.0.34"
+version = "0.0.37"
 description = "Open Embedded Probe (OEP) v1 host: serial / USB / TCP transports, the session rules, the standard interfaces, and a virtual bench"
 readme = "README.md"
 license = "MIT"

{oep_client_python-0.0.34 → oep_client_python-0.0.37}/src/oep_client/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.0.34"
+__version__ = "0.0.37"