150 lines
4.7 KiB
Python
150 lines
4.7 KiB
Python
"""Ferrite beads: recover Z from evidence; never invent; never abort ingest."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
from pathlib import Path
|
|
|
|
import pytest
|
|
from pydantic import ValidationError
|
|
|
|
from backend.periscopex.ferrite_z import recover_bead_specs, z_from_datasheet_text
|
|
from backend.periscopex.graph import _load_component_models
|
|
from backend.periscopex.models import ComponentModel, InductorSpecs, SimpleComponentSpecs
|
|
from backend.periscopex.resolve_passives import simple_to_typed_passive_specs
|
|
|
|
|
|
def test_ferrite_bead_quoted_ohm_fills_z_not_henries():
|
|
specs = InductorSpecs(
|
|
component_subtype="passive.ferrite_bead",
|
|
value_formatted="120 ohm @ 100 MHz",
|
|
current_rating_a="3A",
|
|
dcr_ohms=0.03,
|
|
)
|
|
assert specs.impedance_ohm == 120.0
|
|
assert specs.value_henries is None
|
|
model = ComponentModel(mpn="BLM21PG121SN1D", specs=specs)
|
|
assert model.specs.impedance_ohm == 120.0
|
|
|
|
|
|
def test_ferrite_bead_live_payload_fills_z_from_formatted():
|
|
model = ComponentModel.model_validate({
|
|
"mpn": "BLM21PG121SN1D",
|
|
"specs": {
|
|
"specs_type": "inductor",
|
|
"component_subtype": "passive.ferrite_bead",
|
|
"value_henries": 120.0,
|
|
"value_formatted": "120 ohm @ 100 MHz",
|
|
"tolerance": None,
|
|
"package": "0805",
|
|
"current_rating_a": "3A",
|
|
"dcr_ohms": 0.03,
|
|
},
|
|
})
|
|
assert model.specs.impedance_ohm == 120.0
|
|
assert model.specs.value_henries is None
|
|
assert model.specs.current_rating_a == "3A"
|
|
assert model.specs.dcr_ohms == 0.03
|
|
|
|
|
|
def test_ferrite_bead_with_impedance_ohm_still_ok():
|
|
specs = InductorSpecs(
|
|
component_subtype="passive.ferrite_bead",
|
|
value_formatted="120 ohm @ 100 MHz",
|
|
impedance_ohm=120.0,
|
|
current_rating_a="3A",
|
|
dcr_ohms=0.03,
|
|
)
|
|
assert specs.impedance_ohm == 120.0
|
|
assert specs.value_henries is None
|
|
|
|
|
|
def test_inductor_still_requires_value_henries():
|
|
with pytest.raises(ValidationError, match="inductor requires value_henries"):
|
|
InductorSpecs(
|
|
component_subtype="passive.inductor",
|
|
value_formatted="15nH",
|
|
)
|
|
|
|
|
|
def test_load_models_bead_without_z_does_not_raise(tmp_path: Path):
|
|
payload = {
|
|
"mpn": "BLM21PG121SN1D",
|
|
"specs": {
|
|
"specs_type": "inductor",
|
|
"component_subtype": "passive.ferrite_bead",
|
|
"value_formatted": "FB",
|
|
"current_rating_a": "3A",
|
|
"dcr_ohms": 0.03,
|
|
},
|
|
}
|
|
(tmp_path / "BLM21PG121SN1D.json").write_text(json.dumps(payload) + "\n")
|
|
loaded = _load_component_models(tmp_path)
|
|
assert "BLM21PG121SN1D" in loaded
|
|
assert loaded["BLM21PG121SN1D"].impedance_ohm is None
|
|
|
|
|
|
def test_load_models_skips_inductor_missing_henries(tmp_path: Path):
|
|
bad = {
|
|
"mpn": "LQW-BAD",
|
|
"specs": {
|
|
"specs_type": "inductor",
|
|
"component_subtype": "passive.inductor",
|
|
"value_formatted": "x",
|
|
},
|
|
}
|
|
(tmp_path / "LQW-BAD.json").write_text(json.dumps(bad) + "\n")
|
|
loaded = _load_component_models(tmp_path)
|
|
assert loaded == {}
|
|
|
|
|
|
def test_simple_to_typed_bead_without_z():
|
|
simple = SimpleComponentSpecs(
|
|
specs_type="passive",
|
|
component_subtype="passive.ferrite_bead",
|
|
values={"current_rating_a": "3A", "dcr_ohms": 0.03},
|
|
)
|
|
specs = simple_to_typed_passive_specs(simple)
|
|
assert specs.specs_type == "inductor"
|
|
assert specs.impedance_ohm is None
|
|
assert specs.dcr_ohms == 0.03
|
|
|
|
|
|
def test_bead_mpn_datasheet_text_fills_z():
|
|
text = (
|
|
"BLM21PG121SN1D chip ferrite bead\n"
|
|
"Impedance (at 100MHz / 20°C) 120 ohm\n"
|
|
"Rated current 3A\n"
|
|
"DC resistance 0.03 ohm\n"
|
|
)
|
|
hit = z_from_datasheet_text(text)
|
|
assert hit is not None
|
|
z, formatted = hit
|
|
assert z == 120.0
|
|
assert "100" in formatted
|
|
assert "datasheet" in formatted
|
|
specs = InductorSpecs(
|
|
component_subtype="passive.ferrite_bead",
|
|
value_formatted="FB",
|
|
current_rating_a="3A",
|
|
dcr_ohms=0.03,
|
|
)
|
|
filled = recover_bead_specs(specs, extra_text=text)
|
|
assert filled.impedance_ohm == 120.0
|
|
assert filled.value_henries is None
|
|
|
|
|
|
def test_bead_mpn_datasheet_without_z_does_not_invent():
|
|
text = "BLM21PG121SN1D\nRated current 3 A\nDCR 0.03 ohm max\nPackage 0805"
|
|
assert z_from_datasheet_text(text) is None
|
|
specs = InductorSpecs(
|
|
component_subtype="passive.ferrite_bead",
|
|
value_formatted="FB",
|
|
current_rating_a="3A",
|
|
dcr_ohms=0.03,
|
|
)
|
|
filled = recover_bead_specs(specs, extra_text=text)
|
|
assert filled.impedance_ohm is None
|
|
model = ComponentModel(mpn="BLM21PG121SN1D", specs=filled)
|
|
assert model.specs.impedance_ohm is None
|