Merge protocol-cert-m0 (vSafe UNKNOWN 2.83) into ui-apple-shell.

Keep Apple shell + findings tree; include USB-C vSafe UNKNOWN from catalog (no invented volts). Changelog 2.83.0 covers both.
2026-09-22 18:49:52 +02:00
parent d5fff7c6dd 29e1a3033d
commit b32d581d27
5 changed files with 70 additions and 10 deletions
@@ -582,9 +582,19 @@ DOC_USB_LSFS = (
    "Universal Serial Bus Specification Revision 2.0 §7 (field not a single PCB number)"
 )
 DOC_USB_PD_VSAFE = (
-    "USB Power Delivery specification vSafe5V (not on file; Type-C CabCon R2.5 names vSafe5V "
-    "and tVBUSON as the minimum vSafe5V threshold without restating the volt range. "
-    "Type-C Current charger 4.75–5.5 V is not vSafe5V)"
+    "USB Power Delivery Specification (USB-IF; not on file). "
+    "USB Type-C Cable and Connector Specification Release 2.5, March 2026 "
+    "§1.6 p.35: vSafe5V is VBUS “5 volts” as defined by the USB PD specification "
+    "(no volt range restated). "
+    "Alta Frequenza zip snla027b.pdf (AN-807 Reflections SNLA027B–May 2004–Revised May 2004) "
+    "and sdaa499.pdf (Simple Methods to Reduce EMI from a PCB Trace, SDAA499 – September 2026) "
+    "do not state vSafe5V. Type-C Current charger Figure 4-39 4.75–5.5 V is not vSafe5V."
+)
+DOC_USB_PD_VSAFE0 = (
+    "USB Power Delivery Specification (USB-IF; not on file). "
+    "USB Type-C Cable and Connector Specification Release 2.5, March 2026 "
+    "§1.6 p.35: vSafe0V is VBUS “0 volts” as defined by the USB PD specification "
+    "(no volt range restated). Alta Frequenza TI SI PDFs do not state vSafe0V."
 )
 DOC_IEEE_8023 = "IEEE 802.3 (clause for this variant; not on file)"
 DOC_IEEE_2012 = "IEEE Std 802.3-2012 IEEE Standard for Ethernet"
@@ -1173,6 +1183,10 @@ def build_m0_catalog() -> dict[str, Any]:
            pid, "vsafe5v", "UNKNOWN",
            needed_document=DOC_USB_PD_VSAFE,
        ))
+        out.append(_c(
+            pid, "vsafe0v", "UNKNOWN",
+            needed_document=DOC_USB_PD_VSAFE0,
+        ))
        return out

    def _eth_cons(pid: str, lid: str) -> list[dict[str, Any]]:
@@ -1949,7 +1963,7 @@ def build_m0_catalog() -> dict[str, Any]:
        hints=["USB_C", "TYPE_C", "CC1", "CC2"],
        notes=(
            "USB Type-C connector/interface system. Not USB 2.0/3.x/USB4 protocol. "
-            "Rp/Rd/Ra from CabCon R2.5 Tables 4-27/4-28/4-29. VBUS volts still USB PD vSafe5V."
+            "Rp/Rd/Ra from CabCon R2.5 Tables 4-27/4-28/4-29. Figure 4-39 charger volts are not vSafe5V. USB PD vSafe still not on file."
        ),
    ))
    usb2_over_c = _usb2_cons("usb-c-usb2-receptacle", speed="hs")
@@ -2930,10 +2930,25 @@
          "conditions": [],
          "value_origin": "SPEC",
          "typical": false,
-          "needed_document": "USB Power Delivery specification vSafe5V (not on file; Type-C CabCon R2.5 names vSafe5V and tVBUSON as the minimum vSafe5V threshold without restating the volt range. Type-C Current charger 4.75\u20135.5 V is not vSafe5V)"
+          "needed_document": "USB Power Delivery Specification (USB-IF; not on file). USB Type-C Cable and Connector Specification Release 2.5, March 2026 \u00a71.6 p.35: vSafe5V is VBUS \u201c5 volts\u201d as defined by the USB PD specification (no volt range restated). Alta Frequenza zip snla027b.pdf (AN-807 Reflections SNLA027B\u2013May 2004\u2013Revised May 2004) and sdaa499.pdf (Simple Methods to Reduce EMI from a PCB Trace, SDAA499 \u2013 September 2026) do not state vSafe5V. Type-C Current charger Figure 4-39 4.75\u20135.5 V is not vSafe5V."
+        },
+        {
+          "id": "usb-c-receptacle-vsafe0v",
+          "parameter": "vsafe0v",
+          "value_kind": "UNKNOWN",
+          "mandatory": "MANDATORY",
+          "source_type": "STANDARD",
+          "source_class": "NORMATIVE",
+          "value": null,
+          "unit": null,
+          "source": null,
+          "conditions": [],
+          "value_origin": "SPEC",
+          "typical": false,
+          "needed_document": "USB Power Delivery Specification (USB-IF; not on file). USB Type-C Cable and Connector Specification Release 2.5, March 2026 \u00a71.6 p.35: vSafe0V is VBUS \u201c0 volts\u201d as defined by the USB PD specification (no volt range restated). Alta Frequenza TI SI PDFs do not state vSafe0V."
        }
      ],
-      "notes": "USB Type-C connector/interface system. Not USB 2.0/3.x/USB4 protocol. Rp/Rd/Ra from CabCon R2.5 Tables 4-27/4-28/4-29. VBUS volts still USB PD vSafe5V.",
+      "notes": "USB Type-C connector/interface system. Not USB 2.0/3.x/USB4 protocol. Rp/Rd/Ra from CabCon R2.5 Tables 4-27/4-28/4-29. Figure 4-39 charger volts are not vSafe5V. USB PD vSafe still not on file.",
      "incomplete": false
    },
    {
@@ -3902,7 +3917,22 @@
          "conditions": [],
          "value_origin": "SPEC",
          "typical": false,
-          "needed_document": "USB Power Delivery specification vSafe5V (not on file; Type-C CabCon R2.5 names vSafe5V and tVBUSON as the minimum vSafe5V threshold without restating the volt range. Type-C Current charger 4.75\u20135.5 V is not vSafe5V)"
+          "needed_document": "USB Power Delivery Specification (USB-IF; not on file). USB Type-C Cable and Connector Specification Release 2.5, March 2026 \u00a71.6 p.35: vSafe5V is VBUS \u201c5 volts\u201d as defined by the USB PD specification (no volt range restated). Alta Frequenza zip snla027b.pdf (AN-807 Reflections SNLA027B\u2013May 2004\u2013Revised May 2004) and sdaa499.pdf (Simple Methods to Reduce EMI from a PCB Trace, SDAA499 \u2013 September 2026) do not state vSafe5V. Type-C Current charger Figure 4-39 4.75\u20135.5 V is not vSafe5V."
+        },
+        {
+          "id": "usb-c-usb2-receptacle-vsafe0v",
+          "parameter": "vsafe0v",
+          "value_kind": "UNKNOWN",
+          "mandatory": "MANDATORY",
+          "source_type": "STANDARD",
+          "source_class": "NORMATIVE",
+          "value": null,
+          "unit": null,
+          "source": null,
+          "conditions": [],
+          "value_origin": "SPEC",
+          "typical": false,
+          "needed_document": "USB Power Delivery Specification (USB-IF; not on file). USB Type-C Cable and Connector Specification Release 2.5, March 2026 \u00a71.6 p.35: vSafe0V is VBUS \u201c0 volts\u201d as defined by the USB PD specification (no volt range restated). Alta Frequenza TI SI PDFs do not state vSafe0V."
        },
        {
          "id": "usb-c-usb2-receptacle-cc_rd_rp",
@@ -2,14 +2,18 @@

 What's new in Periscope.

-## 2.83.0 — 2026-09-22 — Apple-like shell, findings tree, HDMI 1.4 UNKNOWN
+## 2.83.0 — 2026-09-22 — Apple-like shell; USB-C vSafe still UNKNOWN

-Shell Finder/Settings: sidebar, large title, system font, hairline. Findings tree keeps Error / Warning / Info folders (FAIL first) with + disclosure, then domains/rules, then Certificazioni/Protocolli. HDMI 1.4 TMDS electrical displays UNKNOWN — no guessed Zdiff. Catalog JSON untouched.
+Shell Finder/Settings: sidebar, large title, system font, hairline. Findings tree keeps Error / Warning / Info folders (FAIL first) with + disclosure, then domains/rules, then Certificazioni/Protocolli. HDMI 1.4 TMDS electrical displays UNKNOWN — no guessed Zdiff.
+
+Alta Frequenza zip and `af-allegati` were searched for vSafe5V / vSafe0V. Contents are TI SI (`snla027b` AN-807, `sdaa499` EMI) — they do not state vSafe voltages. USB Type-C CabCon R2.5 §1.6 p.35 points at USB PD without a volt range. Charger Figure 4-39 4.75–5.5 V stays not-vSafe.

 - [Changed] App chrome (`sidebar`, `globals.css`, dashboard list, report large title).
 - [Changed] Findings tree grouping + protocol section inside the tree.
 - [Changed] Protocol UI: HDMI 1.4 TMDS Zdiff/limit/measured show `UNKNOWN`.
 - [Changed] Frontend tests `findings-forest`, `protocol-report`.
+- [Changed] `vsafe5v` / `vsafe0v` needed_document; `catalog.json`.
+- [Changed] INDEX archives AF TI SI as not packed for vSafe.

 ## 2.82.0 — 2026-09-22 — HDMI 2.0+ TI fields use source_type VENDOR

@@ -21,5 +21,7 @@ TI files are **source_type VENDOR**, never HDMI Forum STANDARD. `https://pcbsync
 | `tmds1204.pdf` | TMDS1204 12Gbps HDMI Hybrid Redriver | SLLSF57A – August 2022 / revised April 2024 | `tmds1204-hdmi-sink`, `tmds1204-hdmi-source`; HDMI **2.0 / FRL** common layout `source_type=VENDOR` | **VENDOR** |
 | `slla633.pdf` | TMDS_CLOCK/FRL_Data Detection Design in HDMI Sink Applications TMDS1204 | SLLA633 – May 2024 | HDMI 2.0+/`tmds1204-*` `sigdet_wakeup` PHY_DEPENDENT (no layout ohms) | **VENDOR** |
 | `HDMI-FRL-Software-Datasheet-61W6169600.pdf` | HDMI 2.1 FRL Compliance Test Solution Datasheet (Tektronix) | (on file; 4 pages) | **not packed** — test-equipment datasheet, not HDMI Forum Adopter | archived only |
+| `snla027b.pdf` | AN-807 Reflections: Computations and Waveforms | SNLA027B – May 2004 / revised May 2004 | **not packed** for USB-C vSafe — TI SI, no vSafe5V/vSafe0V | archived only |
+| `sdaa499.pdf` | Simple Methods to Reduce EMI from a PCB Trace | SDAA499 – September 2026 | **not packed** for USB-C vSafe — TI EMI, no vSafe | archived only |

 Duplicates on Desktop (same MD5, not stored twice here): `USB2_Electrical_Compliance.pdf`, `DVI_Spec_v1.0.pdf`, `USB_TypeC_Functional_Test.pdf`.
@@ -123,7 +123,17 @@ def test_type_c_rp_rd_from_cabcon_r25_vbus_volts_unknown():
    assert by["t_vbuson_max"].source.page == "247"
    assert "2.5" in by["t_vbuson_max"].source.revision
    assert by["vsafe5v"].value_kind == "UNKNOWN"
-    assert "vSafe5V" in (by["vsafe5v"].needed_document or "")
+    assert by["vsafe5v"].value is None
+    assert "USB Power Delivery" in (by["vsafe5v"].needed_document or "")
+    assert "snla027b" in (by["vsafe5v"].needed_document or "")
+    assert "Figure 4-39" in (by["vsafe5v"].needed_document or "")
+    assert by["vsafe0v"].value_kind == "UNKNOWN"
+    assert by["vsafe0v"].value is None
+    assert "vSafe0V" in (by["vsafe0v"].needed_document or "")
+    hdmi14 = next(p for p in cat.physical_interfaces if p.id == "hdmi-1.4-tmds-type-a")
+    hz14 = next(c for c in hdmi14.constraints if c.parameter == "differential_impedance")
+    assert hz14.value_kind == "UNKNOWN"
+    assert hz14.value is None
    _cite_ok(by["gnd_ir_drop_cable"])
    assert by["gnd_ir_drop_cable"].value == 250.0
    assert by["gnd_ir_drop_cable"].source_type == "CABLE"