oep-client-python 0.0.42__py3-none-any.whl → 0.0.44__py3-none-any.whl

oep_client/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.0.42"
+__version__ = "0.0.44"

oep_client/conformance/__init__.py

@@ -144,7 +144,7 @@ def checker_sources_sha256():
             for name in CHECKER_SOURCES}
 
 
-REVIEWED_CORE_SHA256 = 'd63f99f1809146ad41f1643526c81417b366d7a9d85af3845daee6654a229a14'   # oep-spec 02c08c9 docs/oep-core.ja.md
+REVIEWED_CORE_SHA256 = '699f7eb6333b6eb6678ddcf27074c03544f0f0a6ee0ef6ccdf02edd3757f962e'   # oep-spec docs/oep-core.ja.md
 
 
 def require_reviewed_contract(registry, spec=None):

oep_client/conformance/core_smoke.py

@@ -8,7 +8,7 @@ import struct
 from . import ops, require, tlvs
 from .. import conformance as _helpers
 
-REVIEWED_CORE_SHA256 = 'd63f99f1809146ad41f1643526c81417b366d7a9d85af3845daee6654a229a14'  # oep-spec 02c08c9 docs/oep-core.ja.md
+REVIEWED_CORE_SHA256 = '699f7eb6333b6eb6678ddcf27074c03544f0f0a6ee0ef6ccdf02edd3757f962e'  # oep-spec docs/oep-core.ja.md
 
 
 class CoreSmokeChecks:

oep_client/conformance/host_core.py

@@ -4,7 +4,7 @@ from pathlib import Path
 import struct
 from . import require,spec_identity
 
-REVIEWED_CORE_SHA256='d63f99f1809146ad41f1643526c81417b366d7a9d85af3845daee6654a229a14'
+REVIEWED_CORE_SHA256='699f7eb6333b6eb6678ddcf27074c03544f0f0a6ee0ef6ccdf02edd3757f962e'
 CORE_OPS={'confirm':1,'list':2,'describe':3,'clock':4,'open':16,'end':17,'keepalive':18,'lock_state':19}
 # the settings' ops (core §13.5 / §13.7, transports §7.3): their numbers reviewed, their results not read here
 SETTINGS_OPS={'get':32,'set':33,'unset':34,'save':35,'state':36,'network':37}

oep_client/conformance/host_deadline.py

@@ -9,7 +9,7 @@ from pathlib import Path
 from . import require,spec_identity
 
 
-REVIEWED={'docs/oep-core.ja.md':'d63f99f1809146ad41f1643526c81417b366d7a9d85af3845daee6654a229a14',
+REVIEWED={'docs/oep-core.ja.md':'699f7eb6333b6eb6678ddcf27074c03544f0f0a6ee0ef6ccdf02edd3757f962e',
           'docs/oep-transports.ja.md':'2117de20712f7dfad6c81e247cf1b0b206ccf7528fcdf70702cbfce1c17dbadc'}
 QUICK_MS=1000  # core_quick_op_max_ms
 

oep_client/conformance/host_requests.py

@@ -12,11 +12,11 @@ from . import require, spec_identity
 REVIEWED = {
     'interfaces/oep-if-plan.ja.md': 'da8bd60af53499573c07bc33dbd8c4df93eb61a93b91dc57907f26620ae36bbf',
     'interfaces/oep-if-fixture.ja.md': '780beb7a3f9adb51fccf3441930e4c04d2bb64ef738e302195cf5a4e7c2a60a6',
-    'docs/oep-core.ja.md': 'd63f99f1809146ad41f1643526c81417b366d7a9d85af3845daee6654a229a14',
-    'interfaces/oep-if-debug.ja.md': '6743420c31bcd354dd5b4b5352f4d8bcfa695f787dbc28644dba9e9533357338',
+    'docs/oep-core.ja.md': '699f7eb6333b6eb6678ddcf27074c03544f0f0a6ee0ef6ccdf02edd3757f962e',
+    'interfaces/oep-if-debug.ja.md': '58843357aae5afd31082b068c76c754cbd047446fe4b0aa77b5c22cbedf1f3f8',
     'interfaces/oep-if-capture.ja.md': 'ffd89a6a1abf006aea788a6b47b270e6ac0e6d8190a716f4123c4f499bd3a61e',
 }
-REVIEWED_REGISTRY_SHA256='21057dbfc117365e0b9f9d96f377ed99dbc28568efc70829bf8d53384077f44e'
+REVIEWED_REGISTRY_SHA256='278114efc9235b4c6026cd66e11ed558e0ac5afd789011973f6293ae1abffb9c'
 
 
 def reviewed_identity(spec):

oep_client/conformance/host_wait.py

@@ -6,7 +6,7 @@ from .. import registry as _reg
 SAVE=_reg.CORE.op['save']  # fn 0's save (core §13.7)
 
 
-REVIEWED={'docs/oep-core.ja.md':'d63f99f1809146ad41f1643526c81417b366d7a9d85af3845daee6654a229a14',
+REVIEWED={'docs/oep-core.ja.md':'699f7eb6333b6eb6678ddcf27074c03544f0f0a6ee0ef6ccdf02edd3757f962e',
           'docs/oep-transports.ja.md':'2117de20712f7dfad6c81e247cf1b0b206ccf7528fcdf70702cbfce1c17dbadc'}
 QUICK_MS=1000  # core_quick_op_max_ms
 

oep_client/conformance/oep_smoke.py

@@ -6,10 +6,10 @@ import struct
 
 from . import ops, require, tlvs
 
-REVIEWED_INTERFACES = {  # oep-spec 02c08c9 interfaces/
+REVIEWED_INTERFACES = {  # oep-spec interfaces/
     'oep-if-fixture.ja.md': '780beb7a3f9adb51fccf3441930e4c04d2bb64ef738e302195cf5a4e7c2a60a6',
     'oep-if-plan.ja.md': 'da8bd60af53499573c07bc33dbd8c4df93eb61a93b91dc57907f26620ae36bbf',
-    'oep-if-debug.ja.md': '6743420c31bcd354dd5b4b5352f4d8bcfa695f787dbc28644dba9e9533357338',
+    'oep-if-debug.ja.md': '58843357aae5afd31082b068c76c754cbd047446fe4b0aa77b5c22cbedf1f3f8',
     'oep-if-common.ja.md': '25fed0b1b8b7f246a8b71d02cea810249803b1c3c1e9c3df466c04f38687f70c',
 }
 

oep_client/core.py

@@ -216,15 +216,16 @@ def transports(hst: h.Host) -> list[tuple[int, int, int]]:
 
 
 def take(hst: h.Host, lease_ms: int = 3000, *, owner: str | None = None, wait_s: float = 5.0,
-         force: bool = False) -> h.Opened:
+         force: bool = False, extensions=()) -> h.Opened:
     """Take the lock as host guide §6 says: when the probe's only transport is a serial port and this host opened it
     exclusively, the previous holder cannot be there any more - force at once; otherwise wait out the holder's lease
-    (up to wait_s), and name it (InUse) if it keeps it going. force: the user asked for it."""
+    (up to wait_s), and name it (InUse) if it keeps it going. force: the user asked for it. extensions: named
+    extensions for the open, sent critical (Host.open; a broker's sharing, host guide §7)."""
     link = getattr(hst, "link", None)
     ways = transports(hst)
     only = len(ways) == 1 and ways[0][1] in SERIAL_KINDS and getattr(link, "framing", None) == "cobs" \
         and getattr(link, "transport", None) == "serial"
-    return hst.take(lease_ms, owner=owner, only_way_in=only, wait_s=wait_s, force=force)
+    return hst.take(lease_ms, owner=owner, only_way_in=only, wait_s=wait_s, force=force, extensions=extensions)
 
 
 def plan_fn(hst: h.Host) -> int:

oep_client/dump.py

@@ -27,7 +27,7 @@ class Capabilities:
     max_frame: int
     offers: list[Offer] = field(default_factory=list)
     requests: dict[str, int] = field(default_factory=dict)
-    missing: list[str] = field(default_factory=list)   # what core §1.2 requires and the probe did not give (C-10)
+    missing: list[str] = field(default_factory=list)   # what core §1.2 requires and the probe did not give
 
 
 _REQUIRED_CORE_TAGS = {reg.CORE.tlv["describe"][k]: k for k in ("unit_id", "transport", "max_op_ms")}
@@ -44,7 +44,7 @@ CORE_REQUIRED_OPS = ("confirm", "list", "describe", "clock", "open", "end", "kee
 
 
 def required_missing(confirm_payload: bytes, core_describe: list[tuple[int, bytes]]) -> list[str]:
-    """What every probe must give, as far as a lock-free look on one transport shows it (core §1.2, C-10; oep-spec
+    """What every probe must give, as far as a lock-free look on one transport shows it (core §1.2; oep-spec
     docs/conformance.md section 1): confirm's answer carries TLV transport, naming an entry of fn 0's describe or 0xFF
     (§7.1); fn 0's describe carries unit_id, transport, max_op_ms (§1.2, §7.5) and ops in core §7.4's form with every
     required op set (core §11; a probe whose fn 0 ops break the form is not used). -> what is missing (empty: nothing seen missing). The bounds of confirm's values and of
@@ -95,7 +95,7 @@ def _describe_all(call, fn: int, caps: Capabilities) -> bytes:
 def collect(call, prefix: str = "", exact: bool = False, confirm: tuple[int, int] = (0, 1)) -> Capabilities:
     """confirm, then fn 0's describe (the core: no name, never listed, core §7.2) and every listed interface's (the
     ones under `prefix` on label boundaries, `exact`: that name only - list itself returns every one, core §7.2). `confirm`: the revision range the confirm asks for - a host that confirmed already passes the
-    revision in use (core §7.1, C-15: every later confirm on a transport asks for it alone). fn 0 is shown first, as
+    revision in use (core §7.1: every later confirm on a transport asks for it alone). fn 0 is shown first, as
     an Offer with fn 0 and no name."""
     p = call(CORE_FN, OP_CONFIRM, m.CONFIRM_REQUEST + bytes(confirm))   # v0 and v1 both answer (0..1)
     magic, revision = struct.unpack_from("<4sB", p)

oep_client/endpoint.py

@@ -629,7 +629,7 @@ class Endpoint(FixtureDrive):
         """`now_ms`: the clock the timers run on (leases, retries, port_speed), since this boot. `now_ns`: the same clock
         in ns when it has that resolution (virtual_bench_serve: time.monotonic_ns); without it the probe's clock (core §2.6a)
         is `now_ms` in ns. confirm's limits are checked against core §7.1 (max_frame 64 or more, window max_frame or
-        more, max_inflight 1 or more, C-20) and the declared max_op_ms against core §7.5 (1 to max_op_ms_max, C-47):
+        more, max_inflight 1 or more) and the declared max_op_ms against core §7.5 (1 to max_op_ms_max):
         a probe outside them is not built."""
         if probe.max_frame < reg.MIN_MAX_FRAME or window < probe.max_frame or max_inflight < 1:
             raise ValueError(f"confirm's limits out of core §7.1's bounds: max_frame {probe.max_frame}, window {window}, "
@@ -639,7 +639,7 @@ class Endpoint(FixtureDrive):
         self.now = now_ms
         self._clock_ns = now_ns
         self._origin_ns = 0                               # the probe clock's 0: this boot's start (core §2.6a)
-        self._last_ns = 0                                 # the clock never goes back while the boot_id stays (C-31)
+        self._last_ns = 0                                 # the clock never goes back while the boot_id stays
         self.current_core = None
         self.boot_id = boot_id
         self.lease_default_ms = lease_default_ms
@@ -1260,7 +1260,7 @@ class Endpoint(FixtureDrive):
 
     def now_ns(self) -> int:
         """The probe's one clock (core §2.6a): ns since boot, at the resolution of `now_ns` when the endpoint has one
-        (else ms). It never decreases while the boot_id is the same (C-31), and starts again at a reboot."""
+        (else ms). It never decreases while the boot_id is the same, and starts again at a reboot."""
         self._last_ns = max(self._last_ns, self._raw_ns() - self._origin_ns)
         return self._last_ns
 
@@ -1306,7 +1306,7 @@ class Endpoint(FixtureDrive):
                 self.current_core = Core(self)
             return self.current_core.handle(data, transport)
         if not data or data[0] != m.ROLE_REQUEST or len(data) < REQUEST_HEADER:
-            self.discarded += 1                                   # not a request, or shorter than its header (C-36)
+            self.discarded += 1                                   # not a request, or shorter than its header
             return None
         if self.restarting:
             self.unanswered += 1                                  # the restart's answer is out: nothing more (oep-if-restart §2)
@@ -1602,7 +1602,7 @@ class Endpoint(FixtureDrive):
         """The probe restarts: lock, last id, the resend table, connections, streams, captures, subscriptions, the
         revision in use, the port speed, the unsaved config and the plan are gone; the saved config comes back, and the
         clock starts again from 0 (ns since boot, core §2.6a). `boot_id` None
-        draws a new one, as from a hardware random source (core §6.5, C-19); passing the current one plays a probe
+        draws a new one, as from a hardware random source (core §6.5); passing the current one plays a probe
         whose only source repeated it - its hosts learn only that their session is gone (no_session, core §6.2)."""
         if boot_id is None:
             boot_id = self.boot_id
@@ -3134,7 +3134,7 @@ class Endpoint(FixtureDrive):
             if address > 0x7F:
                 raise Reject(m.MALFORMED)                          # a 7-bit address (excluded for every revision)
             if address <= 0x07 or address >= 0x78:
-                raise unsupported_fixed()                          # reserved by I2C: general call, 10-bit, ... (△5)
+                raise unsupported_fixed()                          # reserved by I2C: general call, 10-bit, ...
             if not planned:
                 raise unavailable("wrong_state")                   # before the plan (cause 6)
             if fn in self.target_fail_configure:                   # taken, not brought up: state 0, the queue, slots

oep_client/frames.py

@@ -1,6 +1,6 @@
 """Length-prefixed frames on a reliable byte stream (USB vendor bulk, HID, TCP): u16 length, then the message (oep-spec
 oep-core §3). No CRC: a length that cannot be right, or a frame that stops half way, means the boundaries are lost -
-FramingLost, and the link resyncs. Not on TCP (transports §5, C-07): a pause inside a frame is normal there and the
+FramingLost, and the link resyncs. Not on TCP (transports §5): a pause inside a frame is normal there and the
 frame is read on; a stream that keeps its boundaries says so with `keeps_boundaries = True`."""
 
 from __future__ import annotations

oep_client/host.py

@@ -86,7 +86,7 @@ RESTART_WAIT_S = 10.0                          # restart_probe: the wait for a p
 
 
 def check_confirm(max_frame: int, window: int, max_inflight: int) -> str:
-    """core §7.1 (C-20): max_frame >= min_max_frame (64), window >= max_frame, max_inflight >= 1. -> "" or why not."""
+    """core §7.1: max_frame >= min_max_frame (64), window >= max_frame, max_inflight >= 1. -> "" or why not."""
     if max_frame < reg.MIN_MAX_FRAME or window < max_frame or max_inflight < 1:
         return (f"confirm answered max_frame {max_frame}, window {window}, max_inflight {max_inflight}: outside core "
                 f"§7.1 (max_frame >= {reg.MIN_MAX_FRAME}, window >= max_frame, max_inflight >= 1); the transport is not used")
@@ -163,7 +163,7 @@ class Unsupported(Rejected):
 
     @property
     def supported(self) -> tuple[int, int] | None:
-        """confirm's refusal (core §7.1, C-15): (min, max) of the protocol revisions the probe handles (TLV 0x01
+        """confirm's refusal (core §7.1): (min, max) of the protocol revisions the probe handles (TLV 0x01
         supported after tag 0x00); None for any other refusal."""
         if self.tag is not None:
             return None
@@ -294,7 +294,7 @@ class Host:
     before_request: Callable[[], None] | None = None
     # Called with confirm's limits after every confirm answer (the link's max_frame for the transfer time, core §4.4)
     on_limits: Callable[[dict], None] | None = None
-    unusable: str = ""                     # why this probe is not used (C-20, C-47): set, nothing more is sent
+    unusable: str = ""                     # why this probe is not used: set, nothing more is sent
     restart_reopened: bool = False         # the last restart_probe came back only on its reopen_s (the user's reopen)
     # The session id kept per probe for the next run (kept_session.KeptSession; link.open_host sets one): None = not kept
     kept: object | None = None
@@ -438,7 +438,7 @@ class Host:
         self._boot_id = boot_id
 
     def not_usable(self, why: str) -> None:
-        """Stop using this probe (C-20, C-47): every later request raises NotUsable with `why`."""
+        """Stop using this probe: every later request raises NotUsable with `why`."""
         self.unusable = why
         raise NotUsable(why)
 
@@ -484,7 +484,7 @@ class Host:
 
     # ---- confirm (§5, §2) -----------------------------------------------------------------------
     def confirm_range(self) -> tuple[int, int]:
-        """The revisions a confirm asks for (core §7.1, C-15): the range this client handles before the first confirm,
+        """The revisions a confirm asks for (core §7.1): the range this client handles before the first confirm,
         then min_rev = max_rev = the revision in use, in every later confirm (a resync, probing again) - so a later
         probe never switches the revision in the middle of a session."""
         if self.revision:
@@ -499,7 +499,7 @@ class Host:
         """Ask for a revision in [min_rev, max_rev] (default `confirm_range()`). -> {"revision", "max_frame",
         "window", "max_inflight", "boot_id", "transport", "tail"}. The boot_id is the probe's for this boot (core §6.5,
         §7.1): a host without the lock learns of a restart from it. transport: the index (fn 0's describe) of the
-        transport this confirm came on (core §7.1, C-05; 0xFF from a relaying broker; None when the probe sent none).
+        transport this confirm came on (core §7.1; 0xFF from a relaying broker; None when the probe sent none).
         The answer's fixed part is the same in every revision (core §7.1): a revision outside the range asked is a
         ProtocolError and nothing of the answer is used. A probe that refuses the ranged confirm as malformed is not v1
         (revision 0 is recorded and the rejection raised). No revision in the range: rejected unsupported (Unsupported:
@@ -527,7 +527,7 @@ class Host:
         tail = rd.tail()
         why = check_confirm(max_frame, window, inflight)
         if why:
-            self.not_usable(why)                            # sends nothing more and reports the values (C-20)
+            self.not_usable(why)                            # sends nothing more and reports the values
         self.boot_id_seen(boot_id)
         self.revision = revision
         where = tail.get(CONFIRM_TRANSPORT)
@@ -556,13 +556,15 @@ class Host:
             raise NotV1(f"the probe speaks OEP revision {self.revision}; session requests need revision 1 or more")
 
     # ---- session --------------------------------------------------------------------------------
-    def open(self, lease_ms: int = 0, *, force: bool = False, owner: str | None = None) -> Opened:
+    def open(self, lease_ms: int = 0, *, force: bool = False, owner: str | None = None, extensions=()) -> Opened:
         """Open a new session under a new random id (core §6.4; the id goes in the header, never 0). lease_ms 0 = the
         probe's default; 1000..60000 are taken as asked. owner: who holds the lock (1-32 bytes), shown to other hosts.
         force: take the lock from another session (its resources are released first). A session this host had open
         is left behind: it ended, or the probe refuses this open locked while it holds the lock - end it first. The
         answer's boot_id is watched (core §6.5: a reboot drops the fn mapping). fn 0's describe (its max_op_ms) is read
-        first when this host has not read it yet (core §4.4)."""
+        first when this host has not read it yet (core §4.4). extensions: named extensions (core §2.2, §12) to carry, each
+        a name or (name, data), sent critical - a probe that does not know one refuses the open (Unsupported, tag the
+        named extension's with bit 7) rather than ignore it; a broker's sharing is asked this way (host guide §7)."""
         self.require_v1()
         if self.kept is not None and self.session is None:
             self.kept.before_open(self, owner)              # once: the previous run's session ended (host guide §5)
@@ -571,6 +573,12 @@ class Host:
             core.describe(self, m.CORE_FN)                  # max_op_ms before a request that changes state (core §4.4)
         sid = self.rng.randrange(1, 1 << 32)                # random, never 0 (core §6.1)
         tail = m.tlv(OWNER, owner_text(owner)) if owner else b""
+        for item in extensions:
+            name, data = (item, b"") if isinstance(item, str) else item
+            raw = name.encode("ascii")
+            if not 1 <= len(raw) <= 255:
+                raise ValueError(f"named extension {name!r}: 1 to 255 bytes (core §2.2)")
+            tail += m.tlv(m.TAG_NAMED_EXTENSION, bytes([len(raw)]) + raw + bytes(data), critical=True)
         r = self.request(m.CORE_FN, m.OP_OPEN, struct.pack("<IB", lease_ms, int(force)) + tail, session=sid)
         rd = m.Reader(r.payload)
         lease, boot_id = rd.take("II")
@@ -646,17 +654,17 @@ class Host:
         return bool(locked), remaining, owner_of(p[5:])
 
     def take(self, lease_ms: int = 3000, *, owner: str | None = None, only_way_in: bool = False,
-             wait_s: float = 5.0, force: bool = False) -> Opened:
+             wait_s: float = 5.0, force: bool = False, extensions=()) -> Opened:
         """open() the way host guide §6 takes the lock. only_way_in: this link is the probe's only transport and a
         serial port opened exclusively - whoever held the lock cannot be there any more, so it is taken by force at
         once. Otherwise the holder's lease is waited out (up to wait_s); a holder that keeps it going raises InUse,
-        naming it. force: take it anyway (the user said so)."""
+        naming it. force: take it anyway (the user said so). extensions: as open's."""
         if force or only_way_in:
-            return self.open(lease_ms, force=True, owner=owner)
+            return self.open(lease_ms, force=True, owner=owner, extensions=extensions)
         deadline = time.monotonic() + wait_s
         while True:
             try:
-                return self.open(lease_ms, owner=owner)
+                return self.open(lease_ms, owner=owner, extensions=extensions)
             except Locked as e:
                 left = deadline - time.monotonic()
                 if left <= 0 or e.remaining_ms / 1000 > left:

oep_client/link.py

@@ -25,8 +25,8 @@ host as a reboot; read the state before repeating a state-changing request.
 Frames the probe sends by itself are routed: data pushes and events are kept (`pushes`, `events`) for the clients
 of the interfaces that sent them (fn 0 sends none, core §10.2). A result shorter than 5
 bytes, or an event or data frame shorter than its header, is a broken frame; a request role from the probe is dropped
-(core §2.4, C-36). The transfer time of the wait counts min_max_frame (64) until a confirm answer came on the
-transport, then the latest one's max_frame (core §4.4, N-1).
+(core §2.4). The transfer time of the wait counts min_max_frame (64) until a confirm answer came on the
+transport, then the latest one's max_frame (core §4.4).
 
 A serial port is opened exclusively (host guide §6): pyserial's `exclusive=True` (flock, advisory) and, on Linux and
 macOS, TIOCEXCL, so a second open fails at once (EBUSY) instead of sharing the answers. The port opens with pyserial's
@@ -93,7 +93,7 @@ from . import cobs, host as _host, message as m, registry as reg
 from .frames import FramingLost, LengthFrames
 
 # the link's own confirms (resync §5.1, confirm_raw) ask for the revisions this client handles before the first
-# confirm, and for the revision in use after it (core §7.1, C-15) - never 0..0xFF
+# confirm, and for the revision in use after it (core §7.1) - never 0..0xFF
 _OWN_CONFIRM = m.CONFIRM_REQUEST + bytes([_host.MIN_REVISION, _host.MAX_REVISION])
 
 RESYNC_QUIET_S = 0.05                                    # transports §5: read and discard until the input is this quiet
@@ -121,7 +121,7 @@ def _session_of(message: bytes) -> int:
 
 
 class TransportFailed(TimeoutError):
-    """core §5.2 (C-38): a request's resend got no answer either. Its outcome is unknown and the requests outstanding
+    """core §5.2: a request's resend got no answer either. Its outcome is unknown and the requests outstanding
     on the transport failed with it; the link sends nothing else there until it has recovered with the §5.1 confirm
     (done before the next request; ConnectionError when no confirm is answered). After that, read the state before
     repeating a state-changing request."""
@@ -144,7 +144,7 @@ class PortBusy(OSError):
     """Another program holds the serial port (it was opened exclusively): only one host at a time on a serial port."""
 
 
-BASE_BAUD = reg.TIMING["uart_bridge_boot_baud"]   # every UART bridge boots at 115200 8N1 (transports §4, C-09)
+BASE_BAUD = reg.TIMING["uart_bridge_boot_baud"]   # every UART bridge boots at 115200 8N1 (transports §4)
 IDLE_MS = reg.TIMING["port_speed_idle_ms"]   # a committed rate goes back after this with no good frame (oep-if-link §3)
 KEEPALIVE_S = 1.0    # raised: a keepalive once the link has been quiet this long (under half of port_speed_idle_ms, §17)
 OPEN_RETRY_S = (IDLE_MS + reg.TIMING["host_wait_add_ms"]) / 1000   # the confirms at the boot speed (transports §4)
@@ -171,8 +171,7 @@ else:
 
 def open_serial(port: str, baud: int = BASE_BAUD):
     """The port opened exclusively (flock and TIOCEXCL): a second open by anyone fails with PortBusy. 8 data bits, no
-    parity, 1 stop bit, no flow control, DTR and RTS asserted from the open on and while it stays open (transports §4,
-    C-09: a UART bridge may wire them to the probe's reset; what a probe does with DTR deasserted is not defined). The
+    parity, 1 stop bit, no flow control, DTR and RTS asserted from the open on and while it stays open (transports §4: a UART bridge may wire them to the probe's reset; what a probe does with DTR deasserted is not defined). The
     driver's low-latency mode on where it has one (the FTDI latency timer 16 -> 1 ms; a pty or a driver without it:
     ignored)."""
     try:
@@ -352,15 +351,15 @@ class SerialLink:
         self.keepalive_frame = None                # raised: a keepalive request in the session, once bound (attach_host)
         self.last_tx = time.monotonic()            # when the link last wrote (raised: quiet for KEEPALIVE_S = keepalive)
         self.last_write: float | None = None       # when this host last wrote to the port (None: never; transports §5)
-        self.max_frame = reg.MIN_MAX_FRAME         # min_max_frame until a confirm answer, then its max_frame (§4.4, N-1)
+        self.max_frame = reg.MIN_MAX_FRAME         # min_max_frame until a confirm answer, then its max_frame (§4.4)
         self.on_boot_id = lambda boot_id: None     # the boot_id of the link's own confirms (resync, recovery)
         self.on_reopen = lambda: None              # the transport closed and opened again (`_reopen`)
-        self.failed_transport = ""                 # why: a resend went unanswered (core §5.2, C-38); recover first
+        self.failed_transport = ""                 # why: a resend went unanswered (core §5.2); recover first
         self.recoveries = 0                        # failed-transport recoveries made (a confirm answered)
         self.wait_add_s = WAIT_ADD_S               # the floor's host_wait_add_ms (a test of an in-process virtual bench shortens it)
         self._req_bound_s: float | None = None     # the processing bound of the requests whose answers are awaited now
         self.tx_len = 0                            # the longest frame on the wire of the last write
-        self.confirm_body = lambda: _OWN_CONFIRM   # the link's own confirm: the revision in use once bound (C-15)
+        self.confirm_body = lambda: _OWN_CONFIRM   # the link's own confirm: the revision in use once bound
         self.held = lambda: False                  # a session holds the port (its raw transfer stopped): broken = resend
         self._corr_n = 0x8000
         if self.framing == "length":
@@ -399,7 +398,7 @@ class SerialLink:
         return (self.tx_len + self.max_frame * (1 + NOTIFY_PENDING)) * 10 / self.baud
 
     def wait_floor_s(self, bound_s: float | None = None) -> float:
-        """The least a request's answer is waited for (core §4.4, C-06): the request's processing bound (Host.expecting:
+        """The least a request's answer is waited for (core §4.4): the request's processing bound (Host.expecting:
         Host.op_bound_ms - max_op_ms, fn 0's quick ops' shorter one - or longer when its arguments say so; `bound_s`:
         the bound of the requests on the wire, `_bound_s`) + host_wait_add_ms + the transfer time; counted
         from the write, or from the answer before it while several are outstanding (each reply's wait starts when it is
@@ -472,7 +471,7 @@ class SerialLink:
         dropped (core §2.4). True if `frame` was one of them. Only a result (role 0x02) carries a correlation id;
         matching anything else by its bytes 1-2 would take a push for a reply whenever its fn happened to equal the id.
         A result shorter than 5 bytes, or an event / data frame shorter than its header,
-        is a broken frame (core §2.4, C-36): `_broken`."""
+        is a broken frame (core §2.4): `_broken`."""
         if frame and frame[0] == m.ROLE_RESULT:
             return len(frame) < RESULT_HEADER and self._broken(frame, "a result shorter than its header")
         if frame and frame[0] == m.ROLE_DATA:
@@ -488,7 +487,7 @@ class SerialLink:
         return True
 
     def _broken(self, frame: bytes, why: str) -> bool:
-        """A frame that decoded but cannot be read (C-36): on a length-framed link the boundaries are in doubt (the
+        """A frame that decoded but cannot be read: on a length-framed link the boundaries are in doubt (the
         §5.1 resync follows); on a serial port it is a broken frame like a bad CRC - most likely the awaited answer,
         resent at once (core §5.1; transports §4: the port carries OEP frames only)."""
         if self.framing == "length":
@@ -620,7 +619,7 @@ class SerialLink:
         self.on_reopen()                                   # the subscriptions stayed on the closed one (core §10.3)
 
     def _fail_transport(self, e: Exception) -> None:
-        """core §5.2 (C-38): the resend went unanswered too - the transport failed. Its outcome is unknown, so are the
+        """core §5.2: the resend went unanswered too - the transport failed. Its outcome is unknown, so are the
         requests outstanding with it; nothing else goes out before `recover_transport` (the next request runs it)."""
         if getattr(self, "_probing", False):
             raise e                                        # probing: the probe() caller closes the link (transports §3)
@@ -646,7 +645,7 @@ class SerialLink:
             self.failed_transport = f"a request got no answer and was not sent again ({type(e).__name__}: {e})"
 
     def recover_transport(self, tries: int = 3) -> None:
-        """core §5.2 / §5.1 (C-38), on every kind of frame, COBS included: read and discard until the input is quiet,
+        """core §5.2 / §5.1, on every kind of frame, COBS included: read and discard until the input is quiet,
         wait host_resync_wait_ms since this host's last write, then a confirm until the answer with its own corr comes
         (other frames read past). A changed boot_id in it goes to the host (a reboot, core §6.5). ConnectionError when
         no confirm is answered in `tries`: the transport stays failed (close and open it again)."""
@@ -713,7 +712,7 @@ class SerialLink:
 
     def send(self, message: bytes) -> bytes:
         if self.failed_transport:
-            self.recover_transport()                       # nothing else goes out before (core §5.2, C-38)
+            self.recover_transport()                       # nothing else goes out before (core §5.2)
         self._keep_raised()
         try:
             reply = self._send(message)
@@ -972,7 +971,7 @@ class SerialLink:
                 wait = min(wait, max(RAISED_WAIT_MIN_S, lease / 4))
         if self._own and self._req_bound_s is None:
             return wait                                           # a read of the link's own (pump, a repeated confirm)
-        return max(wait, self.wait_floor_s(self._req_bound_s))    # never under core §4.4's floor (C-06)
+        return max(wait, self.wait_floor_s(self._req_bound_s))    # never under core §4.4's floor
 
     def _strike(self, e: Exception) -> None:
         """A request's answer did not come (`e`): a lost frame (host guide §17.3.2: counted at the boot speed for the
@@ -1211,10 +1210,10 @@ class SerialLink:
         self.lease_s = lambda: hst.lease_ms / 1000 if hst.session is not None and hst.lease_ms else None
         hst.before_request = self._keep_raised      # the keepalive before the request's corr is taken (core §4.1)
         self.expected_s = lambda: hst.expect_ms / 1000
-        self.confirm_body = hst.confirm_body        # the revision in use after the first confirm (core §7.1, C-15)
-        self.on_boot_id = hst.boot_id_seen          # the link's own confirms (resync, recovery): a reboot shows (C-38)
+        self.confirm_body = hst.confirm_body        # the revision in use after the first confirm (core §7.1)
+        self.on_boot_id = hst.boot_id_seen          # the link's own confirms (resync, recovery): a reboot shows
         self.on_reopen = hst.transport_reopened     # a subscribe again moves the pushes to the new one (core §10.3)
-        hst.on_limits = self._limits                # every confirm answer: max_frame for the transfer time (N-1)
+        hst.on_limits = self._limits                # every confirm answer: max_frame for the transfer time
         hst.link = self
 
     def reopen_after_restart(self, hst, wait_s: float) -> dict:
@@ -1262,7 +1261,7 @@ class SerialLink:
 
     def _limits(self, limits: dict) -> None:
         """confirm's answer on this transport: until the first one the transfer time counts min_max_frame (64), then
-        the max_frame of the latest (core §4.4, N-1); a length-framed reader bounds frames by it."""
+        the max_frame of the latest (core §4.4); a length-framed reader bounds frames by it."""
         if limits.get("max_frame"):
             self.max_frame = limits["max_frame"]
             if self.framing == "length":
@@ -2052,7 +2051,7 @@ class SpeedReport:
 
 def _speed_port(hst) -> tuple[int | None, int | None, str]:
     """(the probe's oep.probe.link fn, the port this host's requests come in on - the transport TLV of confirm's answer, core
-    §7.1, C-05) when the probe offers oep.probe.link with port_speed set in its ops (oep-if-link §1) and that transport is a
+    §7.1) when the probe offers oep.probe.link with port_speed set in its ops (oep-if-link §1) and that transport is a
     UART bridge; else Nones and why not."""
     from . import core
     try:
@@ -2365,7 +2364,7 @@ def raise_speed(hst, candidates=DEFAULT_CANDIDATES, *, flows=None, verify: bool
         unit = _unit_id(hst)
         if rec.names_a_unit(unit):
             lk.record, lk.record_key = rec, (lk.port_path or "<stream>", unit)
-        else:                                               # an x- unit_id names no unit: nothing kept (C-24)
+        else:                                               # an x- unit_id names no unit: nothing kept
             rec = None
             report.why = f"unit_id {unit} names no unit (core §7.5): no speed record"
     run = _Run(flows, verify, frames, wait, port, rec, max(0, int(probation_bytes)), max(0.0, probation_s),

oep_client/pins.py

@@ -1,5 +1,5 @@
 """oep pins: find where a target is wired to a probe whose pins the host chooses - its debug pins and its reset line -
-from what worked and what misled on 2026-10-02 (ESP32-P4 probe, CH32V003 target; oep-spec host guide §19, finding pins and docs/target-scan-notes.ja.md).
+from what worked and what misled (ESP32-P4 probe, CH32V003 target).
 
 Steps, each optional and each saying what it did:
 

oep_client/riscv.py

@@ -899,7 +899,7 @@ class RiscvDm(Interface, BlockLength):
 
     def step(self) -> tuple[bool, int, int]:
         """One instruction (dcsr.step, one resume, privilege kept). -> (moved, dpc before, dpc after). A hart that did
-        not come back, and any status but ok, raises StepError (oep-if-debug §4.2, P2-○4) without moved or the dpcs
+        not come back, and any status but ok, raises StepError (oep-if-debug §4.2) without moved or the dpcs
         (0 unless status ok, not read): `step_left` False - the probe halted it with haltreq and restored it (read its
         dpc with dmi); True (answer TLV step_left) - it could not halt it again: the hart runs and dcsr.step may still
         be set, so the host halts it and clears dcsr.step. DATA0 is written back first (`restore_data`)."""

oep_client/speed_record.py

@@ -19,7 +19,7 @@ guide §17.4), `passed` true / false / null (the same, for a reader of the older
   rec.note("/dev/ttyUSB0", "fafe00000003", 921600, passed=True, phase="verify")
 
 `link.raise_speed(..., record=True)` (the `oep speed` CLI's default) reads and writes it; the library default is off.
-A unit_id starting with `x-` names no unit (core §7.5, C-24: a probe with neither a unique number nor storage): nothing
+A unit_id starting with `x-` names no unit (core §7.5: a probe with neither a unique number nor storage): nothing
 is kept or found under it, so another unit on the same port inherits nothing.
 """
 

oep_client/targets.py

@@ -1,7 +1,7 @@
 """What the host knows about target families, in one table: which wire, the reset vector, how to read whether the reset
 line (NRST) exists, the line settings to attach with. The probe knows none of it (oep-if-debug: the host knows the
-target). `oep pins` and anything else that meets a target by its target_id read it from here, and oep-spec
-docs/target-scan-notes.ja.md records where each fact comes from.
+target). `oep pins` and anything else that meets a target by its target_id read it from here; each family's notes
+say what was measured.
 
 A family is matched by the target_id an attach reports (scheme 1 = dmi_7f: the u32 at DMI address 0x7F, which on these
 parts equals the chip's ESIG ID):
@@ -99,7 +99,7 @@ def gpio_clock_bit(port: str) -> int:
     return 1 << (2 + ord(port) - ord("A"))
 
 
-# The families met on the OEP benches (oep-spec docs/target-scan-notes.ja.md §2). ids: the top 12 bits of the ESIG ID
+# The families met on the OEP benches. ids: the top 12 bits of the ESIG ID
 # name the series (CH32V003 0x003..., CH32X035 0x035...).
 FAMILIES: tuple[Family, ...] = (
     Family("ch32v00x", "swio", ids=tuple((0xFFF00000, s << 20) for s in (0x002, 0x003, 0x004, 0x005, 0x006, 0x007)),
@@ -114,8 +114,9 @@ FAMILIES: tuple[Family, ...] = (
     Family("ch32l103", "rvswd", max_speed=1_000_000, idle_clock="low", gpio_ports="ABCD", gpio_pads=16,
            debug_pads=("PA13", "PA14"),
            notes="SWCLK resting high resets the debug link; over 1 MHz fails right after a reset; target_id not recorded"),
-    Family("ch32v203", "rvswd", idle_clock="low", gpio_ports="ABCD", gpio_pads=16, debug_pads=("PA13", "PA14"),
-           notes="no OEP bench yet; target_id not recorded"),
+    Family("ch32v20x", "rvswd", ids=((0xFFF00000, 0x20800000),), idle_clock="low", gpio_ports="ABCD", gpio_pads=16,
+           debug_pads=("PA13", "PA14"),
+           notes="the CH32V208 recorded (target_id 0x2080051c, CH32V208WBU6); the CH32V203's not yet"),
 )
 
 

oep_client/virtual_bench.py

@@ -82,7 +82,7 @@ class VirtualProbe:
             # an interface with plan roles: the probe lists oep.probe.plan too (oep-if-plan), at the next free fn
             offered.append(_plan(max(o.fn for o in offered) + 1))
         if core_contract and any(o.fn != 0 for o in offered):
-            raise ValueError('core-v1 profile cannot expose legacy interfaces')
+            raise ValueError('core-v1 profile exposes fn 0 only')
         self.offered = sorted((o if not fill_ops else self._filled(o) for o in offered), key=lambda o: o.fn)
         self.requests = 0
         for o in self.offered:
@@ -196,7 +196,7 @@ _CAPD = reg.FIXTURE_LOGIC.tlv["describe"]
 _ANAD = reg.FIXTURE_ANALOG.tlv["describe"]
 _GRPD = reg.FIXTURE_CAPTURE_GROUP.tlv["describe"]
 CORE_CHIP = reg.CORE.tlv["describe"]["chip"]
-UNIT_ID = re.compile(r"[a-z0-9-]{1,32}")                    # an x- unit_id is not unique (core §7.5, C-24)
+UNIT_ID = re.compile(r"[a-z0-9-]{1,32}")                    # an x- unit_id is not unique (core §7.5)
 
 
 def _analog_decl(frontends: list[tuple[int, int, int]], max_samples: int, min_hz: int, max_hz: int) -> tuple[bytes, ...]:
@@ -269,7 +269,7 @@ def block_max_length(max_frame: int) -> int:
 
 
 def _transports(kinds: list[tuple[int, int]]) -> tuple[bytes, ...]:
-    """(kind, interface) per transport, index = position (core §7.5, C-41): a USB CDC names its communication
+    """(kind, interface) per transport, index = position (core §7.5): a USB CDC names its communication
     interface (the first of the function), built-in USB serial the number the hardware presents or 0xFF, vendor bulk
     and HID their interface; a UART bridge and TCP 0xFF."""
     for k, itf in kinds:
@@ -712,7 +712,7 @@ def minimal_ops(probe: VirtualProbe) -> VirtualProbe:
 
 def with_unit_id(probe: VirtualProbe, unit_id: str) -> VirtualProbe:
     """The profile with another unit_id in fn 0's describe - an `x-` one is a probe with neither a unique number nor
-    storage (core §7.5, C-24: hosts key nothing kept across sessions by it). VIRTUAL BENCH ONLY."""
+    storage (core §7.5: hosts key nothing kept across sessions by it). VIRTUAL BENCH ONLY."""
     return _again(probe, [_with(o, (catalog.text(CORE_UNIT_ID, unit_id) if t[0] == CORE_UNIT_ID else t for t in o.tlvs))
                           if o.fn == CORE_FN else o for o in probe.offered])
 

oep_client/virtual_bench_serve.py

@@ -171,7 +171,7 @@ def build(a: argparse.Namespace) -> endpoint.Endpoint:
     if getattr(a, "minimal_ops", False):
         probe = virtual_bench.minimal_ops(probe)                          # console / fixture UART at their smallest
     start = time.monotonic_ns()
-    # the clock in ns since this start (core §2.6a), and a boot_id from the OS's random source (core §6.5, C-19)
+    # the clock in ns since this start (core §2.6a), and a boot_id from the OS's random source (core §6.5)
     ep = endpoint.Endpoint(probe, lambda: (time.monotonic_ns() - start) // 1_000_000, boot_id=secrets.randbits(32),
                            now_ns=lambda: time.monotonic_ns() - start)
     wire = min(ep.pairs) if ep.pairs else None
@@ -451,7 +451,7 @@ def serve_tcp(a, ep, console, commands: Commands) -> None:
     srv.listen(8)
     port = srv.getsockname()[1]
     if a.framing == "length":
-        # the listening socket is a TCP transport of its own (transports §1, C-05): listed in describe, named by confirm
+        # the listening socket is a TCP transport of its own (transports §1): listed in describe, named by confirm
         ep.tcp_index = ep.add_transport(virtual_bench.TRANSPORT["tcp"])
     if a.announce:
         commands.responder = announce(a, ep, port)

oep_client/virtual_core.py

@@ -1,6 +1,6 @@
-"""Virtual fn 0 implementation of the pre-freeze core (oep-spec 4681d22).
+"""Virtual fn 0 implementation of the core, for the core-v1 profile and the conformance sample models.
 
-Independent of the conformance checker and the legacy interface registry.
+Independent of the conformance checker and of the virtual bench's Endpoint and its interface registry.
 The core-v1 profile has no resources, subscriptions, interfaces or targets.
 Explicit sample models may supply an independently defined extension hook.
 """
@@ -62,8 +62,7 @@ def tail(data, owner=False):
 class Core:
     def __init__(self, endpoint, extension=None):
         self.ep = endpoint
-        # Only explicit current-contract models supply this hook. Legacy profiles
-        # and the core-v1 profile continue to expose fn 0 alone.
+        # Only explicit sample models supply this hook; the core-v1 profile exposes fn 0 alone.
         self.extension = extension
         self.holder, self.last, self.owner = None, None, b''
         self.lease, self.deadline, self.high = 3000, 0, 0

{oep_client_python-0.0.42.dist-info → oep_client_python-0.0.44.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oep-client-python
-Version: 0.0.42
+Version: 0.0.44
 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
@@ -31,11 +31,10 @@ Description-Content-Type: text/markdown
 
 The host side of Open Embedded Probe (OEP). It speaks the v1 protocol of
 [oep-spec](https://github.com/Open-Embedded-Probe/oep-spec) (the core `docs/oep-core.ja.md`, `docs/oep-transports.ja.md`
-and the interfaces `interfaces/*.ja.md`), v1 before the freeze: until the freeze the spec may still break. The wire numbers come from `oep_client.registry`, a verbatim copy of
-oep-spec's generated `generated/oep-v1/oep_v1_registry.py`. This is an experimental stage: breaking changes are expected and
-no compatible API is promised.
+and the interfaces `interfaces/*.ja.md`). The wire numbers come from `oep_client.registry`, a verbatim copy of
+oep-spec's generated `generated/oep-v1/oep_v1_registry.py`.
 
-**The spec this implements: the oep-spec commit in `tests/vectors/SPEC_COMMIT`** (no `v0.x` tag yet; oep-spec versioning §2 / §6 - before the
+**The spec this implements: the oep-spec commit in `tests/vectors/SPEC_COMMIT`** (oep-spec versioning §2 / §6: before the
 freeze, revision 1 alone does not fix the forms, so an implementation names the spec commit it implements). The registry
 and the shared vectors in `tests/vectors/` are copied from that commit; the history is in [CHANGELOG.md](CHANGELOG.md).
 
@@ -66,7 +65,7 @@ sets the version in pyproject.toml, uv.lock and `oep_client.__version__` and tur
 the tests and the build it commits, tags, makes the GitHub Release and publishes to PyPI (Trusted Publishing). Record changes
 under Unreleased in CHANGELOG.md, (EN) and (JA).
 
-A minimal check: [hardware quickstart](docs/hardware-quickstart.ja.md). See the shared [testing policy](docs/testing-policy.ja.md) and [guide for projects using OEP](docs/testing-consumers.ja.md). The [hardware design](docs/hardware-configuration.ja.md) and [configuration examples](docs/hardware-schema.ja.md) describe the planned format; its offline validator/planner is available; integration with the hardware runner is pending. These working documents are in Japanese.
+A minimal check: [hardware quickstart](docs/hardware-quickstart.ja.md). See the shared [testing policy](docs/testing-policy.ja.md) and [guide for projects using OEP](docs/testing-consumers.ja.md). Equipment configuration: [hardware design](docs/hardware-configuration.ja.md) and [configuration examples](docs/hardware-schema.ja.md) (in Japanese).
 
 ## Modules (`oep_client`)
 
@@ -500,4 +499,3 @@ IP_MULTICAST_IF 127.0.0.1. A different `--unit-id` per job keeps parallel jobs a
 name too). A container or VM answers only on its own network. tests/test_virtual_bench_announce.py does this with
 `oep find`, `discovery.find_unit` and `oep://UNIT_ID?via=net` (both engines) - with in-process responders announcing a non-OEP
 TCP service and a wrong TXT unit_id beside it, which the verify drops - skipped where multicast does not loop back.
-

{oep_client_python-0.0.42.dist-info → oep_client_python-0.0.44.dist-info}/RECORD

@@ -1,4 +1,4 @@
-oep_client/__init__.py,sha256=7OWbOEpQIfTwz_cjNABCmX2dm4vDMKyRJVsFedFOaR0,164
+oep_client/__init__.py,sha256=BKL5jblIAcotJRxILFXHy_ZQK96TtAGpJBG_e8J0FbQ,164
 oep_client/__main__.py,sha256=fXvhDWRLSEPpHM6eSuBzztNzvDQi-Yqgrvz6MS5iRbg,31431
 oep_client/acquire.py,sha256=uecNDT1onLMeIxFkHFYgqG7chWWvLrAji93KnIisn0A,100072
 oep_client/arm.py,sha256=SszSLae8zErD4T-a1uQ6s6o3Lz7pe2SR8d3Qy-wi5rY,15633
@@ -8,45 +8,45 @@ oep_client/catalog.py,sha256=WkaksNn9cFvkTRnvtX4I9g1AvkFoldEiNQaKiyPQ7_E,10772
 oep_client/ch32_flash.py,sha256=lY_HKxf2foSfhNda91lcWefgRnY9ebTljsg4zJEj-Ks,12885
 oep_client/cobs.py,sha256=RbdPrqgzD3SukxOIXX9m2dZpVTud8xAYYEhm3rcW2nA,2513
 oep_client/console.py,sha256=hDxoaXDCzk6KiOo-Y3RqC4yZuLPkCXOVi886_C4xXaE,12910
-oep_client/core.py,sha256=qyOCFlujvSzIjbBbZmvA6cMjBn2FEOQYlq1KU2WLdOQ,22040
+oep_client/core.py,sha256=o7qJjZc68RS9p91TfV3aLsLcTq-jWBO1atB9kGL_tkA,22188
 oep_client/decode.py,sha256=6pTFVBT0MLAKedZLVKyd5yT8hjrRw4fdDjnoDiE9XRs,2380
 oep_client/discovery.py,sha256=oES0_NkR1Hc9E_cgPcfW8qfevQcVuYmayMaHuqufdO8,20180
-oep_client/dump.py,sha256=rnPOwbcXKk0ATk2Ka8O8p_XN6lTzmAQAhIHjm-iwT7I,13014
-oep_client/endpoint.py,sha256=vFlMsctxyBzrSV0NBvWTVz4jXrP1ayTQg3Zr_9yDkfs,238451
+oep_client/dump.py,sha256=9rfO07q1EOY4aLFZkm_9RO8awjxNQa75DIDeKAoF_ac,12995
+oep_client/endpoint.py,sha256=h-B1E8Db8qfRZUmAe1abMy38Xjy4CifF4_WmBInp_6g,238405
 oep_client/fixture.py,sha256=bEbW7JNIh6uqOq1enp6hRiZ0Ipu8YdzEzS37WaM3cd8,33977
-oep_client/frames.py,sha256=44h0dy4xlW3S3y39k3jwxHoKkI2Ib2fsmHdjlPYF310,4990
+oep_client/frames.py,sha256=FM1AGn5NY_e-r1yKBsDkEEOqNrk5XTrlKA5Mq6Ycqiw,4984
 oep_client/hardware.py,sha256=RboxkRxkQJ3DbNJEXyyiOFYlLFKGxrlcSwHho8zFC1U,30256
 oep_client/hid_stream.py,sha256=1dG1C5rSqSWs2f0WpzMOKdFd3oY_mzF7z9SxUztjpQA,14093
-oep_client/host.py,sha256=wMknfgqNyZeG0WAmj29_nVGHNoGoyQURj459gv75TRY,47159
+oep_client/host.py,sha256=Wv0AKySaRu1ERJKERjnGnzfdKYkmFlQsL-Nh3SF_bbE,47875
 oep_client/interfaces.py,sha256=p-dQ3dtElTIPSmNFEnUzP_Mys6M43_yUqH1cZA0q5LI,11934
 oep_client/kept_session.py,sha256=S45NwNjeZry5kc5HAyk_orqXKAYf26MuyjJ2ojT51FQ,8084
-oep_client/link.py,sha256=4mKefivvb80pSNXMXebXXb97wgut9K_qihmxyfDEl6I,145569
+oep_client/link.py,sha256=-6N95ruUInNFJnmVOXCr-7XSgXDK-fpkjYJEK5nUFuE,145428
 oep_client/linktest.py,sha256=zj9Ek28VkjyuIPsiU3iF-UEZmY_xMnNjNL-vK-jOQ3Q,10258
 oep_client/message.py,sha256=Kw-PwkMCwa8VGUBd1HWTXe8Epe4FwNcBx8262mWx2rk,14152
 oep_client/names.py,sha256=ohrRvQNURraYyJ-BtjHRwxGt_GLq-t8IO0aOji9Dhe0,3531
-oep_client/pins.py,sha256=yY4B5XKkUa9jtZeWM0UuPowhHxYLLxT0RxkpH-ep-mo,53777
+oep_client/pins.py,sha256=c5aNQtj7ZWM1bxYBtByLuWtkWM4JOra2QCbjvlHybmg,53690
 oep_client/probe_log.py,sha256=gAamfON2M7lMH3xOn4Wpmes_Wp0H4c2EBNbpXjIvCMM,4927
 oep_client/pytest_conformance.py,sha256=-bcJU2E1UE4xjQ7HZjaIgtp0l65cIibBTNFnaW2tews,2929
 oep_client/registry.py,sha256=GfLdoZYSc37PBQ2rgXHM4DtFdU0mpnroM42jVofRx44,23309
-oep_client/riscv.py,sha256=ywBg1VvvpJydOO-D1UlpuKgNAVV8w1lvWhKc6JXeDlo,60428
+oep_client/riscv.py,sha256=o_YElQuJZoBUzqO7QV9VkWVeD4UE2pUx_ciR_TMHRWI,60419
 oep_client/rp2350.py,sha256=7OMyj270k3AY1e3-ljicPwOjf9jOlokbT6QNkA0b0yY,4227
 oep_client/settings.py,sha256=wVRpvAmcvDygVE9PCbo4-7k-tq6pIzKh7VRlmtLO1Fk,26391
-oep_client/speed_record.py,sha256=6THUKbN7gQKpfIdUO2551P8mXiAFqbFDky72Xbki7L0,7229
+oep_client/speed_record.py,sha256=hdVx8mCeWqPC3gWrBsOyfzVZcJfN5_CJfpW18WbsBmc,7223
 oep_client/stimulus.py,sha256=pfX4xLjyG3UWIJRWUHnkg9c1ueL1MeozHj3CnlJ7dpA,6072
-oep_client/targets.py,sha256=IBKVso3bbPj61stzoHlFA74-ANgr-dVgwc5ppYh5X68,7176
+oep_client/targets.py,sha256=ixUxbZUfYqOJjZzcaOudwV2wweVwdk0G85dfRiZzMeA,7183
 oep_client/uiapduino.py,sha256=oafP1SyKPO3cox-2RYbWUZusy4vc6NsEVC7Z-Y1sjWI,6337
 oep_client/usb_stream.py,sha256=zRGGHkvtOme6lIZ-gkrCe2xKn9hC62JGqmc7pKQDAJI,23540
-oep_client/virtual_bench.py,sha256=I1SBbqJ0Dk9zQzGjyYzV9rAUApiLOQVL4vFQzv43a94,52794
+oep_client/virtual_bench.py,sha256=PC6pOoTcm10p0WHUrIO-_xyzPWAyXZimXgQks3IgOYY,52762
 oep_client/virtual_bench_capture.py,sha256=vwlLPkiWopgQxNGNxCFI84FR_cX0y6XWgszkDcoieiY,110696
 oep_client/virtual_bench_mdns.py,sha256=cnJNBKg5zTduXUcH-wqN_ZBDGl7DyL-tL3CBn2jro0E,13305
 oep_client/virtual_bench_serial.py,sha256=EvbdOYeGrM6CRti2b90I0PzpmmherfoJRaAg4v7Iq9Y,13205
-oep_client/virtual_bench_serve.py,sha256=jmesv58pfQr3KvwqlX4brIWoZ5iEe2q5IWGdZ2aCG3g,39027
+oep_client/virtual_bench_serve.py,sha256=oNXrESlch-fXpfCg0Y5w3OmKNdtrOVwXkuhZBTPP6PQ,39015
 oep_client/virtual_bench_trigger.py,sha256=2c3gGOM8wXucTXbc1bTKQ5haX7bAkGJeOryGghrtcRk,23874
 oep_client/virtual_bench_usb.py,sha256=cnewgbsl30b0PgwkfebwSf3xjKyPg9y8vTd5Jew5r9o,4001
-oep_client/virtual_core.py,sha256=cFqqCKBgVU0Wbf0UWBmKx16K3cSriiqU60FK3lfalAQ,10709
+oep_client/virtual_core.py,sha256=F-UxtQIld4eE04_M8j4ANMlQ12jXANzfTnfn59kUWHk,10716
 oep_client/virtual_fixture_drive.py,sha256=_G3MVqkxpd1SfKPz1XRkYbPzAQvgBlJzVUNhjAhDdz4,21708
 oep_client/virtual_names.py,sha256=p72ME65R9Jy56xmVYnVCtapK3Id8iFpAdI5xLe2tNZ0,1449
-oep_client/conformance/__init__.py,sha256=lcfb87SMXISE1N1CgUZNkBtbDZNcGVQ6bP5XEnaVwG8,61746
+oep_client/conformance/__init__.py,sha256=o17AgcYob-Ahn7qWewjCo_7jK4o6kMnX-xHwG9V4Kv8,61738
 oep_client/conformance/allocator.py,sha256=VE2nzIpXZJe4IBfgbRShp69JIwUFtLpxorQ_mO28SlM,6251
 oep_client/conformance/allocator_model.py,sha256=j6l1E1Hlju1jNeFQ_N0a2mDaegaTeyk6iScqzMpvvTc,1563
 oep_client/conformance/allocator_sample.py,sha256=xtiXuZa3VDTilrZArIWOiRyOkuXJ98_rY2M65sIVvpo,855
@@ -81,7 +81,7 @@ oep_client/conformance/clock.py,sha256=bDqBjih71zg_mhkgCSryzKI_N8FEoGoGv9jO4PMYD
 oep_client/conformance/clock_model.py,sha256=jyB8oTVR5sqbzeJCCWxdQBnzNNl4_uITLLYQ-yx8pRU,2568
 oep_client/conformance/clock_sample.py,sha256=x24mSpQoOamrXrinmnF_Tk4NPk76LwS6ZhfuK2SCwCo,673
 oep_client/conformance/core_fixed_fields.py,sha256=LRFP9yGOjDHQM1diX1HMdwXh9jMgAOY6xIC-woCikSk,6297
-oep_client/conformance/core_smoke.py,sha256=7Dn9sw7MEgyUAhQXmha3aGz6njhc-ditYyovFJ8YHKw,10823
+oep_client/conformance/core_smoke.py,sha256=4vLm1j2yIuvUH5sxWa7yJzNKzRTAFYzRhby9Ef2eZ6Y,10815
 oep_client/conformance/corr.py,sha256=P6ljdsXpBq-vyEXRWOB1MqACQjT6HRBXgfAxgkyPjl4,6552
 oep_client/conformance/cut.py,sha256=Oj9aj48g2VSrqFHRNlkY22MzXxQbr13Q8QXUsEMETis,7942
 oep_client/conformance/cut_model.py,sha256=bHPnK8vKoInKVslW0KlJXRRgpGK-7ktIVGUEXo60X34,4791
@@ -115,21 +115,21 @@ oep_client/conformance/gpio_lifecycle_model.py,sha256=K0nzlXf-43kj3jsfaAuzEWOftO
 oep_client/conformance/gpio_lifecycle_sample.py,sha256=Yk1WENQ-2tbPCM2yUY4Yk9dgWkjIfL42VtUSpx1qhhM,369
 oep_client/conformance/gpio_model.py,sha256=CXy42K8cdRSTBxLC44h-gTYhjh3HrduSehsgsbvmDpo,5633
 oep_client/conformance/gpio_sample.py,sha256=JHsOrjkYcM738IGSzP5q7v5vANETwKT6-csCTxH55MQ,490
-oep_client/conformance/host_core.py,sha256=3eFMNjSpEaYIWLV9k-9D66JC2XJjq10dhrl5M_6kfdE,12634
+oep_client/conformance/host_core.py,sha256=o_M0nCTRzGvThC6G2C27DO3QdM1GRSE-eGkbhB7ZIO0,12634
 oep_client/conformance/host_core_sample.py,sha256=egU8Xw-f3eHx_CmUooN1yW1lzltOam6IsJbnD8uOx9I,3803
-oep_client/conformance/host_deadline.py,sha256=C_-kfZpGbW1_t7EU-Mjr19EsRzdCrotTbHWhtaRsHOc,6978
+oep_client/conformance/host_deadline.py,sha256=_Ri9HSAlB27rgAqXdP-evsF-DGBegajXzV9l7NgAh-k,6978
 oep_client/conformance/host_deadline_sample.py,sha256=G471jEc2HxDIu52Acw_aHDSxFAEC72OBCuvn2YQtAdU,5136
 oep_client/conformance/host_notifications.py,sha256=LGRJhOS66_36MYG8fHLcyHroXtoZRQVJgammDieVhQY,9307
 oep_client/conformance/host_notifications_sample.py,sha256=auze2DdWtUOdQMHnfDF8WXLAiETv3OuODR6y77VmsTQ,1788
 oep_client/conformance/host_request_sample.py,sha256=pFlgw_nw_LTPoojI3Igdl1bQzsyMJSEDkuTgGOAV1Gg,1973
-oep_client/conformance/host_requests.py,sha256=uQlzxVuSysvXxhRG8OaxiM6lp2EiBQyA96ApELqgR5Y,11197
+oep_client/conformance/host_requests.py,sha256=eVgWvAt3PMVVLVfEmpIoySVBiRaG_1G1nGNHwFvKsGg,11197
 oep_client/conformance/host_resend.py,sha256=P8tFWtr6TwQ33ph-JO0l8EXyJGxSjC6fBeyKQ4AhqxU,5519
 oep_client/conformance/host_resend_sample.py,sha256=nwaru9ZVcxpcTi1OEritp8PSF6Qfic_IRGuutH2aBA4,4808
 oep_client/conformance/host_tlv.py,sha256=h5SZT9r3DCsxMLcRacdyKOoZNQHSL8DzRgT1VPu_86A,6140
 oep_client/conformance/host_tlv_sample.py,sha256=V6ORb5E2i76dc8O73Bew0eO2CbjG-ZPc02JLi6w5vmY,743
 oep_client/conformance/host_values.py,sha256=VnjEB5TQbI34fuyAx0OGVbiyfI2ZH_of9I4TLT7Dyyk,4742
 oep_client/conformance/host_values_sample.py,sha256=7C58mSP9jjrkNSgSb3uNK44VrdPXOznof_oe5UCcZro,1532
-oep_client/conformance/host_wait.py,sha256=8MWihd6uLsGduC9ovRcpijUfR5iekKThzPe-7K64Bzg,5591
+oep_client/conformance/host_wait.py,sha256=2upJp_9wWfssDO-CDnEb2RVp7_cQAnpLIt4MWwAtveE,5591
 oep_client/conformance/host_wait_sample.py,sha256=7SkJ8H_9ScMv8gLnT85xBKj_GXciPvAzmH-KxfMWYCg,3257
 oep_client/conformance/i2c.py,sha256=fNDweyCLlCsv7fCwmmQMC7di5AG1HzDCflW0miWwcjc,18041
 oep_client/conformance/i2c_model.py,sha256=HLYqRKdKMvlCGMcgYxSS3dy50Zf7aPojN_gO5fBvy6U,9759
@@ -157,7 +157,7 @@ oep_client/conformance/notification_sequence.py,sha256=TGdLjqPkCBtjH6f_oxgPGfl-l
 oep_client/conformance/notification_sequence_sample.py,sha256=awSniydBvRoy03PCR5Y6xHAVmLWV1wjKwfA2dwI8XCI,494
 oep_client/conformance/oep_declaration_model.py,sha256=_Zq_eLLkHNGcDfA0tPptWpqT4tZbCsVrdjE2k9lAcco,2947
 oep_client/conformance/oep_declarations.py,sha256=0DrrDdveGEiSMp5fjy-ZJjR0mjAxv2TQLylZl_hnqfo,7492
-oep_client/conformance/oep_smoke.py,sha256=iZ9UrDQruknM-DYnYiU7aLSh-obqG254_FNEQe-5Cjc,12496
+oep_client/conformance/oep_smoke.py,sha256=8XjyK4Rx27YLYek_JTJtyS8swGa0x0Pf5dbzb-YlIlg,12488
 oep_client/conformance/outcome_model.py,sha256=jnKDNvkLBsSFQqQQEqCDt3zliKZx0b5LiLCHafrBv4U,3697
 oep_client/conformance/outcome_sample.py,sha256=6dbEwddcY0z4jGZsazp_gGI_Vu0em-0rOrGN2BVUMzI,673
 oep_client/conformance/outcomes.py,sha256=FktfF9aaexnXCgSNDYU6OZeqRuLd3ppFMXE1UrW-H2o,10047
@@ -250,8 +250,8 @@ oep_client/conformance/wire_options_sample.py,sha256=dog-yvUcu693M8b51tA5TnhAnKr
 oep_client/conformance/writer_lease.py,sha256=5VXS7kt1R4j6B26XdJa6UOqJg-a05ZewC2ynVmyxMTM,7331
 oep_client/conformance/writer_lease_model.py,sha256=FxhDqqzdFOa_SSHSvjdQFh49Wn3YuZ98ISSlRRxrq9E,1721
 oep_client/conformance/writer_lease_sample.py,sha256=oowRwYUNAE4f6rEE2HmYlSS9dDWE0TGegkcsqVH8Nak,455
-oep_client_python-0.0.42.dist-info/METADATA,sha256=a5b4YJJEEj69W9ExstaBRtCZufyidN96e5sABcHjcxk,55578
-oep_client_python-0.0.42.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-oep_client_python-0.0.42.dist-info/entry_points.txt,sha256=XEt39Jz7oQyU9Hfg_tV6eDGofNxWYrjSfslxKP-fh70,135
-oep_client_python-0.0.42.dist-info/licenses/LICENSE,sha256=ntlalztb3L1OaNAxmQdHlubu5fVhjMc9oRZi3PeQhXg,1076
-oep_client_python-0.0.42.dist-info/RECORD,,
+oep_client_python-0.0.44.dist-info/METADATA,sha256=6_CmjBSUWjX21ppK-I0ujv-7oApIOpmgWnRnqEUofA4,55269
+oep_client_python-0.0.44.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+oep_client_python-0.0.44.dist-info/entry_points.txt,sha256=XEt39Jz7oQyU9Hfg_tV6eDGofNxWYrjSfslxKP-fh70,135
+oep_client_python-0.0.44.dist-info/licenses/LICENSE,sha256=ntlalztb3L1OaNAxmQdHlubu5fVhjMc9oRZi3PeQhXg,1076
+oep_client_python-0.0.44.dist-info/RECORD,,