oep-client-python 0.0.36__tar.gz → 0.0.38__tar.gz

{oep_client_python-0.0.36 → oep_client_python-0.0.38}/CHANGELOG.md

@@ -2,6 +2,67 @@
 
 ## Unreleased
 
+## 0.0.38
+- (JA) 名前と初期値（oep-spec cc82b5e）に合わせた:
+  - 設定の値は出どころを持たない。get の値は fn number key len data で、`Value.origin` と `show()` の 4 つ目を無くした。書き出しは全部の値、
+    入れ直しは unset を先に、全部の値と比べる。`unset_all` は全部の値を消す。`changeable()`（set / unset があるか。初期値だけの probe は get だけ）。
+  - 口と線（host ガイド §5.3）: label `S.N` が口 S の線 N（S は英字で始まる英字・数字・`-` の 16 文字まで、N は英字・数字・`-`・`_`）。
+    大小文字を区別せずに比べ、書いたとおりに見せる。裸の `nrst` は口の線にならない。`find_line(source, name, port=None)`（口を省くと名付けられた
+    口が 1 つのときだけ）、`ports_named`、`port_line`。`core.firmware_labels` / `probe_labels` は無くした（固定の label が無いため）。
+  - `oep pins` は `<口>.nrst` / `<口>.power_hi` を勧める（口は `--name`、無ければ probe にある 1 つの口）。
+  - 仮想ベンチ: 出どころを無くし、profile の label は初期値（保存の無い起動で入る。`x035.swdio`、`v003.swio` などの `S.N` の形）。label は
+    大小文字を区別せずに一意（重なる set は unavailable cause 5、保存に 2 つあれば channel の小さい方）。`with_settings(changeable=False)` で get だけ。
+
+## 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、

{oep_client_python-0.0.36 → oep_client_python-0.0.38}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oep-client-python
-Version: 0.0.36
+Version: 0.0.38
 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) (no origin: the firmware's initial values are values like any other, core §13.4), `changeable()` (set / unset offered), `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", port=None)` = host guide §5.3's line lookup: port S's line N is the label `S.N` (ignoring ASCII case; without a port the one port named), `ports_named(labels)` the ports as written |
 | `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, and the storage state
+oep settings items <probe>                   # what each owner declares (names, forms, choices)
+oep settings set <probe> core channel.GPIO23.label=v003.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                # every value by name (secrets as present only)
+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
@@ -220,8 +223,8 @@ option-byte reader for the reset line, max_speed / idle_clock).
    NRST exists (read only, never written); then resume.
 5. **reset**: attach under reset through each candidate - the real line stops the hart at the reset vector.
 6. **labels**: the connection profile the host keeps (wire, pins, line settings: the probe keeps no wiring) and the
-   labels `nrst` / `power_hi` (`<name>.nrst` / `<name>.power_hi` with `--name`, a probe serving several targets),
-   checked with `config.find_line` against the probe's settings (a note when another channel already carries the name:
+   labels `<port>.nrst` / `<port>.power_hi` (the port: `--name`, else the one port the probe's labels name; neither:
+   a note asks for `--name`), checked with `settings.find_line` against the probe's settings (a note when another channel already carries the name:
    the line would not be found); `--save` writes the labels (set + save). Nothing is written without `--save`.
 
 Safety: a driven or active channel is never driven, scanned or held; the power channel is touched only with `--power`;
@@ -233,7 +236,7 @@ pulls; its "pulled-up" row (channel 4, the reset line's weak pull-up) is left ou
 alone that channel reads floating:
 
 ```
-$ oep pins /run/board-identify/by-id/esp32-series-30eda0ea068b --power 5 --wire swio
+$ oep pins /run/board-identify/by-id/esp32-series-30eda0ea068b --power 5 --wire swio --name v003
 power: channel 5 low 300 ms (target off: read), then high 400 ms before the reads
 classify: 52 channels, 16 reads each under pull-up, pull-down
   floating     0-3,6,9-20,26-34,36-50,52-54
@@ -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=v003.nrst   (not written)
+label: oep settings set ... core channel.GPIO5.label=v003.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,11 @@ 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 without origin (the profile's initial values in on a boot without a save; labels unique but for ASCII
+case, a probe of get alone with `changeable=False`); 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.36 → oep_client_python-0.0.38}/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()` = 全部の値を（カテゴリ、平らな名前、値）で（出どころは無い。firmware の初期値もほかの値と同じ、core §13.4）、`changeable()`（set / unset があるか）、`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", port=None)` = host ガイド §5.3 の線の探し方（口 S の線 N は label `S.N`、ASCII の大小文字を区別しない。口を省くと名付けられた口が 1 つのときだけそれ）、`ports_named(labels)` は口の名前を書いたとおりに |
 | `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=v003.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`、
@@ -180,9 +183,9 @@ TCP で OEP を運ぶ probe は DNS-SD で見つける（ネットワークの
 4. **identify**: 答えた線に attach（halt）し、target_id で系統を見る。CH32V00x は option bytes で NRST の有無を見る（読むだけ、
    書かない）。その後 resume。
 5. **reset**: 候補ごとにリセットをかけながら attach する。本物の線なら hart はリセットのベクタで止まる。
-6. **labels**: host が持つ接続プロファイル（線、ピン、線の設定。probe は配線を持たない）と、label `nrst` / `power_hi`
-   （`--name` を付けると `<名前>.nrst` / `<名前>.power_hi`。複数の target を受ける probe 向け）を勧める。label は probe の設定に
-   対して `config.find_line` で確かめる（別の channel がもうその名前を持っていれば、線が見つからなくなるので note で言う）。
+6. **labels**: host が持つ接続プロファイル（線、ピン、線の設定。probe は配線を持たない）と、label `<口>.nrst` / `<口>.power_hi`
+   （口は `--name`、無ければ probe の label が名付ける口が 1 つのときその口。どちらも無ければ note で `--name` を求める）を勧める。label は probe の設定に
+   対して `settings.find_line` で確かめる（別の channel がもうその名前を持っていれば、線が見つからなくなるので note で言う）。
    `--save` で label を書く（set + save）。`--save` が無ければ何も書かない。
 
 安全: driven / active の channel は駆動も scan も保持もしない。電源の channel は `--power` のときだけ触る。low に保つのは
@@ -193,7 +196,7 @@ ESP32-P4 と CH32V003（電源は GPIO5）、2026-10-02。2026-10-07 の変更
 "pulled-up" の行（channel 4、リセットの線の弱い pull-up）はここでは除いた - pull-up と pull-down だけなら floating と読める:
 
 ```
-$ oep pins /run/board-identify/by-id/esp32-series-30eda0ea068b --power 5 --wire swio
+$ oep pins /run/board-identify/by-id/esp32-series-30eda0ea068b --power 5 --wire swio --name v003
 power: channel 5 low 300 ms (target off: read), then high 400 ms before the reads
 classify: 52 channels, 16 reads each under pull-up, pull-down
   floating     0-3,6,9-20,26-34,36-50,52-54
@@ -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=v003.nrst   (not written)
+label: oep settings set ... core channel.GPIO5.label=v003.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 から、値は出どころを持たない（profile の初期値は保存の無い起動で入る。label は
+ASCII の大小文字を区別せずに一意。`changeable=False` で get だけの probe）。長さが形と違う値は 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.36 → oep_client_python-0.0.38}/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) (no origin: the firmware's initial values are values like any other, core §13.4), `changeable()` (set / unset offered), `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", port=None)` = host guide §5.3's line lookup: port S's line N is the label `S.N` (ignoring ASCII case; without a port the one port named), `ports_named(labels)` the ports as written |
 | `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, and the storage state
+oep settings items <probe>                   # what each owner declares (names, forms, choices)
+oep settings set <probe> core channel.GPIO23.label=v003.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                # every value by name (secrets as present only)
+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
@@ -195,8 +198,8 @@ option-byte reader for the reset line, max_speed / idle_clock).
    NRST exists (read only, never written); then resume.
 5. **reset**: attach under reset through each candidate - the real line stops the hart at the reset vector.
 6. **labels**: the connection profile the host keeps (wire, pins, line settings: the probe keeps no wiring) and the
-   labels `nrst` / `power_hi` (`<name>.nrst` / `<name>.power_hi` with `--name`, a probe serving several targets),
-   checked with `config.find_line` against the probe's settings (a note when another channel already carries the name:
+   labels `<port>.nrst` / `<port>.power_hi` (the port: `--name`, else the one port the probe's labels name; neither:
+   a note asks for `--name`), checked with `settings.find_line` against the probe's settings (a note when another channel already carries the name:
    the line would not be found); `--save` writes the labels (set + save). Nothing is written without `--save`.
 
 Safety: a driven or active channel is never driven, scanned or held; the power channel is touched only with `--power`;
@@ -208,7 +211,7 @@ pulls; its "pulled-up" row (channel 4, the reset line's weak pull-up) is left ou
 alone that channel reads floating:
 
 ```
-$ oep pins /run/board-identify/by-id/esp32-series-30eda0ea068b --power 5 --wire swio
+$ oep pins /run/board-identify/by-id/esp32-series-30eda0ea068b --power 5 --wire swio --name v003
 power: channel 5 low 300 ms (target off: read), then high 400 ms before the reads
 classify: 52 channels, 16 reads each under pull-up, pull-down
   floating     0-3,6,9-20,26-34,36-50,52-54
@@ -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=v003.nrst   (not written)
+label: oep settings set ... core channel.GPIO5.label=v003.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,11 @@ 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 without origin (the profile's initial values in on a boot without a save; labels unique but for ASCII
+case, a probe of get alone with `changeable=False`); 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.36 → oep_client_python-0.0.38}/docs/spec-follow-notes.ja.md

@@ -657,3 +657,27 @@ oep-client-python の `wip/rvswd-rest` ブランチ。
 - 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.36 → oep_client_python-0.0.38}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oep-client-python"
-version = "0.0.36"
+version = "0.0.38"
 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.36 → oep_client_python-0.0.38}/src/oep_client/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.0.36"
+__version__ = "0.0.38"