clocks(v5): annotate HPM with source (chip|board) and svb_version

[widgetii]

Follow-up to #168. Two cheap, useful annotations on the existing V5 hpm block — both surfaced from registers we already discovered while bringing up Hi3519DV500.

What

Field	Source	Meaning
source	HPM_STORAGE_REG bit[30] (u_hpm_storage_reg.use_board_hpm)	chip = in-die measurement averaged by boot software; board = board-fixture calibration override.
svb_version	SVB_VER_REG (SYSCTRL+0x168) bits[5:2] (u_svb_version_reg.svb_type)	none / 10 / 20 / 00 / 608 per enum product_type in svb.h.

The source annotation matters when comparing HPM readings across boards — a board value is whatever the manufacturing line decided to ship, not the real silicon process bin.

svb_version is the missing piece for SVB-version-aware binning. svb.h ships three different boundary constants (CORE_HPM_BOUND_10 = 230, CORE_HPM_BOUND_20 = 222, CORE_HPM_BOUND_10_ESMT = 210) and the "right" threshold depends on which SVB the firmware is configured for. When svb_version=none (this board's case), the firmware isn't running SVB at all and the standard tri-state classification is informational only.

Output on Hi3519DV500

clocks:
  hpm:
    bin: high
    source: chip            # NEW
    svb_version: none       # NEW

ipctool clocks (full) appends source and svb_version after the existing reg/raw/value/bin/binning_window/aux_reg/aux_value/aux_name block.

Test plan

• Reads HPM_STORAGE_REG=0x12d47d2c → bit[30]=0 → source: chip ✓
• Reads SVB_VER_REG=0x00100200 → svb_type=0 → svb_version: none ✓
• CI green on all three matrix targets (arm32 / mips32 / arm64)
• Verify on a board where SVB is actually configured (svb_type ∈ {1,2,3,4}) — none in the lab right now

Not in scope

• SVB-aware bin thresholding — i.e., picking bin_min from the live SVB version rather than the V4-style window 210..310 baked into v5_hpms[]. Doable but needs validation on multiple SVB-version chips; left for a follow-up.
• APHY SSC block (CRG+0x1A0 area, much richer bitfield map in the u-boot patch) — separate spread-spectrum module attached to the ethernet APHY, not part of HPM.

🤖 Generated with Claude Code