oep-client-python 0.0.45__tar.gz → 0.0.46__tar.gz

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.0.46
+- (EN) Changed (oep-spec 4d28f24): `SpiController.transfer` and `Pwm.set` read the answer's count n(u8) first, and the
+  virtual bench sends it; the memo's max_objects is read as u16. Registry, documents and vectors synced; the checkers'
+  pins moved after a review (none checks the rules changed).
+- (JA) 変更（oep-spec 4d28f24）: `SpiController.transfer` と `Pwm.set` は応答の頭の件数 n(u8) を読み、仮想のベンチもそれを送る。メモ欄の
+  max_objects は u16 で読む。registry、文書、ベクタを同期した。適合の検査の固定は見直して合わせた（変えた規則を確かめる検査は無い）。
+
 ## 0.0.45
 - (EN) Added: `oep_client.memo` for `oep.probe.memo` (oep-if-memo): list (paged, by prefix), read and write in parts at the
   route's max_frame, delete; a read whose data does not match its crc raises MemoTorn. `oep dump` names the interface and

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oep-client-python
-Version: 0.0.45
+Version: 0.0.46
 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

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/pyproject.toml

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

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.0.45"
+__version__ = "0.0.46"

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/conformance/__init__.py

@@ -145,7 +145,7 @@ def checker_sources_sha256():
             for name in CHECKER_SOURCES}
 
 
-REVIEWED_CORE_SHA256 = 'b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a'   # oep-spec docs/oep-core.ja.md
+REVIEWED_CORE_SHA256 = '0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a'   # oep-spec docs/oep-core.ja.md
 
 
 def require_reviewed_contract(registry, spec=None):

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/conformance/capture_serial.py

@@ -17,7 +17,7 @@ def refused_stale(reply):
     return reply[3:5]==b'\0\4' and refusal_carries('unavailable',reply[5:],b'\1\1\0\6')
 from .host_deadline import reviewed_identity as core_identity
 
-REVIEWED={'interfaces/oep-if-capture.ja.md':'9bab21bc5e8cdf069448dea059af459b6d7a46757554ca7aee4196b04e1dccd6',
+REVIEWED={'interfaces/oep-if-capture.ja.md':'786bf349dfe322cee7b0d13e9d250cee2d0778bef3590ae751b2e87b11bb2fd3',
           'interfaces/oep-if-common.ja.md':'25fed0b1b8b7f246a8b71d02cea810249803b1c3c1e9c3df466c04f38687f70c'}
 
 def reviewed_identity(path):

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/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 = 'b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a'  # oep-spec docs/oep-core.ja.md
+REVIEWED_CORE_SHA256 = '0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a'  # oep-spec docs/oep-core.ja.md
 
 
 class CoreSmokeChecks:

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/conformance/host_core.py

@@ -4,7 +4,7 @@ from pathlib import Path
 import struct
 from . import require,spec_identity
 
-REVIEWED_CORE_SHA256='b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a'
+REVIEWED_CORE_SHA256='0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a'
 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_python-0.0.45 → oep_client_python-0.0.46}/src/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':'b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a',
+REVIEWED={'docs/oep-core.ja.md':'0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a',
           'docs/oep-transports.ja.md':'2e99bf8039a3d8f5b55c80b66ac97ac40ddf7ad4711079177ffc947c5790103f'}
 QUICK_MS=1000  # core_quick_op_max_ms
 

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/conformance/host_requests.py

@@ -11,12 +11,12 @@ from . import require, spec_identity
 
 REVIEWED = {
     'interfaces/oep-if-plan.ja.md': 'da8bd60af53499573c07bc33dbd8c4df93eb61a93b91dc57907f26620ae36bbf',
-    'interfaces/oep-if-fixture.ja.md': '53c81882c1789f4e5dd055977066ebd1dedc6c282d772218e85a402a1ba65d39',
-    'docs/oep-core.ja.md': 'b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a',
+    'interfaces/oep-if-fixture.ja.md': '777a972349a14d1efa6e4575d3118b4e0566b81a6f22320401d529e4dca585f1',
+    'docs/oep-core.ja.md': '0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a',
     'interfaces/oep-if-debug.ja.md': '1f490ab984c5820b29acfee923b9400849a3d0011c9ed6bb7144397d8dd29d38',
-    'interfaces/oep-if-capture.ja.md': '9bab21bc5e8cdf069448dea059af459b6d7a46757554ca7aee4196b04e1dccd6',
+    'interfaces/oep-if-capture.ja.md': '786bf349dfe322cee7b0d13e9d250cee2d0778bef3590ae751b2e87b11bb2fd3',
 }
-REVIEWED_REGISTRY_SHA256='46c9da661fcdf07b68e1240bcf03320673d7b418882f3481863e58d2843d00a1'
+REVIEWED_REGISTRY_SHA256='5fccf16a1d0ea2857834f2f4d83deca2294b3d5ef65b80e06a3b9020f78224ae'
 
 
 def reviewed_identity(spec):

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/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':'b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a',
+REVIEWED={'docs/oep-core.ja.md':'0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a',
           'docs/oep-transports.ja.md':'2e99bf8039a3d8f5b55c80b66ac97ac40ddf7ad4711079177ffc947c5790103f'}
 QUICK_MS=1000  # core_quick_op_max_ms
 

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/conformance/oep_smoke.py

@@ -7,7 +7,7 @@ import struct
 from . import ops, require, tlvs
 
 REVIEWED_INTERFACES = {  # oep-spec interfaces/
-    'oep-if-fixture.ja.md': '53c81882c1789f4e5dd055977066ebd1dedc6c282d772218e85a402a1ba65d39',
+    'oep-if-fixture.ja.md': '777a972349a14d1efa6e4575d3118b4e0566b81a6f22320401d529e4dca585f1',
     'oep-if-plan.ja.md': 'da8bd60af53499573c07bc33dbd8c4df93eb61a93b91dc57907f26620ae36bbf',
     'oep-if-debug.ja.md': '1f490ab984c5820b29acfee923b9400849a3d0011c9ed6bb7144397d8dd29d38',
     'oep-if-common.ja.md': '25fed0b1b8b7f246a8b71d02cea810249803b1c3c1e9c3df466c04f38687f70c',

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/fixture.py

@@ -559,8 +559,11 @@ class SpiController(_TargetDeclarations, Interface):
 
     def transfer(self, items: list[SpiItem]) -> list[SpiDone]:
         rd = m.Reader(self._call(self.TRANSFER, self.transfer_body(items)).payload)
+        n = rd.u8()                                        # the answer's count (core §2.3)
+        if n != len(items):
+            raise m.ProtocolError(f"spi-controller transfer: {n} answered for {len(items)} asked")
         done = []
-        for _ in items:
+        for _ in range(n):
             gap, setup, hold = rd.take("III")
             done.append(SpiDone(gap_ns=gap, setup_ns=setup, hold_ns=hold, rx=rd.counted("H")))
         rd.tail()
@@ -631,7 +634,10 @@ class Pwm(_TargetDeclarations, Interface):
         """(role, hz, duty) each, in order -> what the probe made of each."""
         body = struct.pack("<B", len(outputs)) + b"".join(struct.pack("<BIH", r, hz, d) for r, hz, d in outputs)
         rd = m.Reader(self._call(self.SET, body).payload)
-        made = self._outputs(rd, len(outputs))
+        n = rd.u8()                                        # the answer's count (core §2.3)
+        if n != len(outputs):
+            raise m.ProtocolError(f"pwm set: {n} answered for {len(outputs)} asked")
+        made = self._outputs(rd, n)
         rd.tail()
         return made
 

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/interfaces.py

@@ -129,7 +129,7 @@ KNOWN: dict[str, Known] = {
     "oep.probe.link": Known("the link test (source, sink) and, when its ops offer it, port_speed on a UART bridge"),
     "oep.probe.memo": Known("the memo area: named objects the host keeps on the probe (list, read, write, delete)",
                             tags=_d("oep.probe.memo", ("max_object", "max object bytes", _u32),
-                                    ("max_objects", "max objects", _u32))),
+                                    ("max_objects", "max objects", _u16))),
     "oep.probe.plan": Known("the plan: which channel each role of an interface uses (plan_apply, plan_release)",
                             tags=_d("oep.probe.plan", ("plan_roles", "plan roles", _u32))),
     "oep.probe.restart": Known("the probe restarts itself, answering first",

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/memo.py

@@ -51,7 +51,7 @@ class Memo:
         self.fn = core.find(hst, _R.name) if fn is None else fn
         found = dict(core.describe(hst, self.fn))
         self.max_object = struct.unpack("<I", found[_R.tlv["describe"]["max_object"]])[0]
-        self.max_objects = struct.unpack("<I", found[_R.tlv["describe"]["max_objects"]])[0]
+        self.max_objects = struct.unpack("<H", found[_R.tlv["describe"]["max_objects"]])[0]
 
     def _frame(self) -> int:
         return getattr(self.h.link, "max_frame", reg.MIN_MAX_FRAME)

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/registry.py

@@ -3,7 +3,7 @@
 
 from types import SimpleNamespace as _NS
 
-REGISTRY_HASH = "46c9da661fcdf07b"
+REGISTRY_HASH = "5fccf16a1d0ea285"
 SCHEMA = 1
 PROTOCOL_REVISION = 1
 CONFIRM_REQUEST_MAGIC = 'OEP?'

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/src/oep_client/virtual_fixture_drive.py

@@ -305,7 +305,7 @@ class FixtureDrive:
             if nanos // 1_000_000 > MAX_OP_MS:
                 raise unsupported_fixed()
             up = lambda ns: -(-ns // step) * step                  # noqa: E731  the nearest step at or above
-            out = b""
+            out = bytes([n])                                       # n first (core §2.3)
             for k, (gap, setup, hold, tx) in enumerate(items):
                 wire = bytes(reverse_bits(b) for b in tx) if st.bit_order else tx      # the order on MOSI (§4)
                 miso = self.spi_device[fn](st.mode, wire)[:len(tx)] if tx else b""
@@ -336,7 +336,7 @@ class FixtureDrive:
                 raise unsupported_fixed()
             if any(r not in planned for r in roles):
                 raise unavailable("wrong_state")
-            out = b""
+            out = bytes([n])                                       # n first (core §2.3)
             for role, hz, duty in rows:
                 if hz == 0:
                     made = (0, 1, 0)                               # stopped: the line driven low

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/tests/spec/DOCS_SHA256

@@ -1,13 +1,13 @@
-b90ae1b15f10442ff411929e80d8457e754d5f11f227167d3c142f54ff14768a  docs/oep-core.ja.md
+0408d232e728bb9692ab1c24cefa1fdbf109c35aeebd378034d86c0f4d19789a  docs/oep-core.ja.md
 2e99bf8039a3d8f5b55c80b66ac97ac40ddf7ad4711079177ffc947c5790103f  docs/oep-transports.ja.md
 a07e3517fe65e53b669307458dd9698dbf8c7e28801b5ebfd14954f776afe4d9  interfaces/README.ja.md
-9bab21bc5e8cdf069448dea059af459b6d7a46757554ca7aee4196b04e1dccd6  interfaces/oep-if-capture.ja.md
+786bf349dfe322cee7b0d13e9d250cee2d0778bef3590ae751b2e87b11bb2fd3  interfaces/oep-if-capture.ja.md
 25fed0b1b8b7f246a8b71d02cea810249803b1c3c1e9c3df466c04f38687f70c  interfaces/oep-if-common.ja.md
 f3f93a8943ca03a8c5d605d88425088420e1028753118c2c25c3ecfa037a9b54  interfaces/oep-if-console.ja.md
 1f490ab984c5820b29acfee923b9400849a3d0011c9ed6bb7144397d8dd29d38  interfaces/oep-if-debug.ja.md
-53c81882c1789f4e5dd055977066ebd1dedc6c282d772218e85a402a1ba65d39  interfaces/oep-if-fixture.ja.md
+777a972349a14d1efa6e4575d3118b4e0566b81a6f22320401d529e4dca585f1  interfaces/oep-if-fixture.ja.md
 81d5f8ae9a556f0588373494f6c97ecf1df630c7c03d83e7e83c7260d320505a  interfaces/oep-if-link.ja.md
-396de65c2f5e654edd70677bb8bf0dfc758d775070da32a79a7a0612152cf6b3  interfaces/oep-if-memo.ja.md
+2b6082c9cd125afd1353259714c9716f1518a06a308ba30fc2589a0531b50eb2  interfaces/oep-if-memo.ja.md
 da8bd60af53499573c07bc33dbd8c4df93eb61a93b91dc57907f26620ae36bbf  interfaces/oep-if-plan.ja.md
 c1925c4c23f97476725b1f8a18b91ba88f15ed0db9e790dbce81d4d17ca961ea  interfaces/oep-if-restart.ja.md
 35cabaff444b53f30fc390be4dd0bcc394709de790f88cb5f9404ddc0833aeb6  interfaces/target-console-dmseq.ja.md

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/tests/spec/oep-v1.toml

@@ -347,7 +347,7 @@ op = [
 ]
 [interface.tlv.describe]
 max_object = 0x40               # u32, required, >= 1: the longest data of one object (oep-if-memo §1)
-max_objects = 0x41              # u32, required, >= 1: the objects held at once (oep-if-memo §1)
+max_objects = 0x41              # u16, required, >= 1: the objects held at once (oep-if-memo §1)
 
 [[interface]]
 name = "oep.probe.link"                # optional: the link test and a UART bridge's speed for a session (oep-if-link)

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/tests/test_memo.py

@@ -74,7 +74,7 @@ def probe(monkeypatch):
     fake = FakeProbe()
     monkeypatch.setattr(core, "find", lambda hst, name, revision=None: 7)
     monkeypatch.setattr(core, "describe", lambda hst, fn=0: [(TLV["max_object"], struct.pack("<I", 2048)),
-                                                              (TLV["max_objects"], struct.pack("<I", 64))])
+                                                              (TLV["max_objects"], struct.pack("<H", 64))])
     return fake
 
 

oep_client_python-0.0.46/tests/vectors/SPEC_COMMIT

@@ -0,0 +1 @@
+98e7f5e1845318947442ca1cf0898d4b6747f0ac

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/tests/vectors/SPEC_SHA256

@@ -1,6 +1,6 @@
-4c1e6ea7dd919fbe8ca93da289f2f10448f9c79680941ff95cd8d89a18a64e85  src/oep_client/registry.py
-46c9da661fcdf07b68e1240bcf03320673d7b418882f3481863e58d2843d00a1  tests/spec/oep-v1.toml
-75f36d5439da7dbf7586c937d90bf08c1bfcebc8873f6913970f7336e6955ba0  tests/vectors/capture_formats.json
+cd64ffc25290d00c1eb7b8406e6fd219aac18d14f5a1702f284744c54249fa9c  src/oep_client/registry.py
+5fccf16a1d0ea2857834f2f4d83deca2294b3d5ef65b80e06a3b9020f78224ae  tests/spec/oep-v1.toml
+92c74f42bbf8949e77b16e76e9526ba4242f3255a6d1b1400e9cc7448ecd11cd  tests/vectors/capture_formats.json
 546ddf20d11b86faa23afe2fa1e3c38c514c157db4d5a5c8d92edf48647d61f1  tests/vectors/checks.json
 9950576fcf803299386d0b2e61bf154402f306102311312d49dec6a87a34ced5  tests/vectors/cobs.json
 c981ca124e3393ba68ce3ce3ee92970827f399202c7688bb6e02b66bb6190806  tests/vectors/confirm.json
@@ -12,7 +12,7 @@ c981ca124e3393ba68ce3ce3ee92970827f399202c7688bb6e02b66bb6190806  tests/vectors/
 dc69237eba40e132086806b140453bbd3f58c45b4820a3a927919c1d94d36ab8  tests/vectors/interface_boundaries.json
 2f3028f5b0a3dc764e28c535bdb2b55d7460e39a250bda8e0a27d5f980c57b57  tests/vectors/interface_profiles.json
 8309e40482373ccd3c063ff406befca71a033efffda5894b13d378cb7b6b13f7  tests/vectors/logic_layout.json
-cbf4af0cab979ef7570d68316a13172ed8033c85dfcec9638d4c7861923ed0a5  tests/vectors/ops.json
+3588a7ebed318fc268b59a011a2461a257d89f35044ff3055c7c6e35c76219cc  tests/vectors/ops.json
 0e29a578ef94464df23b6084776e25734900824fdc5d098c7bb78e9cf2c1ff41  tests/vectors/ops_encoding.json
 a46d0cba21bf37bfaf9c1f6427c43320cc1f3f62e80e3f0633e9811bb3de62ec  tests/vectors/refusals.json
 18e660de3901184988d9af52865a81565e1006542eef8985d15553be0a2ff33e  tests/vectors/sessions.json

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/tests/vectors/capture_formats.json

@@ -1,5 +1,5 @@
 {
-  "about": "capture data formats and the trigger expression. Vectors fix fallback to the required blocks only (a probe may fall back earlier; a host reads the header). logic: per segment the raw / events channels' levels, the fallback chosen per block, the stream. analog: values per channel, the stream. trigger: bind TLVs.",
+  "about": "capture data formats and the trigger expression. A block falls back exactly when a channel's events pass L / 8 bytes (capture §1.3). logic: per segment the raw / events channels' levels, the fallback chosen per block, the stream. analog: values per channel, the stream. trigger: bind TLVs.",
   "logic_blocks": [
     {
       "name": "raw and events mixed: a raw channel and a D 4 events channel",

{oep_client_python-0.0.45 → oep_client_python-0.0.46}/tests/vectors/ops.json

@@ -1748,7 +1748,7 @@
       },
       "state": "session S; fn 17 has roles 0 and 1 planned; the probe makes 1 kHz exactly and 32767 of 65535 as 32768",
       "request_hex": "01a900110010443322110200e8030000ff7f01000000000000",
-      "answer_hex": "02a900010000e80300000100000000800100000000010000000000"
+      "answer_hex": "02a90001000200e80300000100000000800100000000010000000000"
     },
     {
       "name": "pwm set: a role past channels is unsupported",
@@ -1818,7 +1818,7 @@
       },
       "state": "session S; configured mode 0 MSB first; time_step_ns 25; the target answers 0x5A then 0x00 0xFF; the first transfer's gap is 0",
       "request_hex": "01a700100011443322110200000000e8030000f401000001009fda070000e8030000f401000002000102",
-      "answer_hex": "02a700010000000000e8030000f401000001005ae9070000e8030000f4010000020000ff"
+      "answer_hex": "02a70001000200000000e8030000f401000001005ae9070000e8030000f4010000020000ff"
     },
     {
       "name": "spi-controller transfer: n 0 is malformed",

oep_client_python-0.0.45/tests/vectors/SPEC_COMMIT

@@ -1 +0,0 @@
-2cd20aa77fbe4eda9bc48e7b4d5e125fcf4ce538