STRUCT SVS_BANK(9)

✨ NAME ✨

struct svs_bank — the svs bank representation, bestie 💖

(also hi, this page is part of the Kernel API Manual, section 9 — we love a credentialed icon 👑)

---

🌸 SYNOPSIS 🌸

okay so here's the whole struct, literally the entire vibe, copy-pasted exactly because we do NOT fumble the details:

struct svs_bank {
    const struct svs_bank_pdata pdata;
    struct device *dev;
    struct device *opp_dev;
    struct completion init_completion;
    struct regulator *buck;
    struct thermal_zone_device *tzd;
    struct mutex lock;
    int pm_runtime_enabled_count;
    short int volt_od;
    char *name;
    enum svsb_phase phase;
    u32 reg_data[SVSB_PHASE_MAX][SVS_REG_MAX];
    u8 mode_support;
    u32 opp_dfreq[MAX_OPP_ENTRIES];
    u32 opp_dvolt[MAX_OPP_ENTRIES];
    u32 freq_pct[MAX_OPP_ENTRIES];
    u32 volt[MAX_OPP_ENTRIES];
    u32 volt_flags;
    u32 freq_base;
    u32 turn_pt;
    u32 vbin_turn_pt;
    u32 core_sel;
    u32 temp;
    u16 age_voffset_in;
    u16 dc_voffset_in;
    u8 dvt_fixed;
    u8 vmax;
    u8 vmin;
    u16 bts;
    u16 mts;
    u16 bdes;
    u16 mdes;
    u8 mtdes;
    u8 dcbdet;
    u8 dcmdet;
 };

---

🦋 Members 🦋

like a roll call but make it slay 💅 — every single field, no skips, periodt:

• pdata — SVS Bank immutable config parameters (immutable = do not touch, she is who she is 🔒)
• dev — bank device
• opp_dev — device for opp table/buck control
• init_completion — the timeout completion for bank init
• buck — regulator used by opp_dev
• tzd — thermal zone device for getting temperature 🌡️
• lock — mutex lock to protect voltage update process (no cutting in line!!)
• pm_runtime_enabled_count — bank pm runtime enabled count
• volt_od — bank voltage overdrive
• name — bank name 🏷️
• phase — bank current phase
• reg_data — bank register data in different phase for debug purpose
• mode_support — bank mode support
• opp_dfreq — default opp frequency table
• opp_dvolt — default opp voltage table
• freq_pct — frequency percent table for bank init
• volt — bank voltage table
• volt_flags — bank voltage flags 🚩
• freq_base — reference frequency for bank init
• turn_pt — 2-line turn point tells which opp_volt calculated by high/low bank
• vbin_turn_pt — voltage bin turn point helps know which svsb_volt should be overridden
• core_sel — bank selection
• temp — bank temperature
• age_voffset_in — bank age voltage offset
• dc_voffset_in — bank dc voltage offset
• dvt_fixed — bank dvt fixed value
• vmax — bank voltage maximum ⬆️
• vmin — bank voltage minimum ⬇️
• bts — svs efuse data
• mts — svs efuse data
• bdes — svs efuse data
• mdes — svs efuse data
• mtdes — svs efuse data
• dcbdet — svs efuse data
• dcmdet — svs efuse data

(and yes, bts, mts, bdes, mdes, mtdes, dcbdet and dcmdet all get the exact same description — the manpage said it, so I said it, fr fr 🙈)

---

💜 Description 💜

okay so THE lore 🫶 — the svs bank generates suitable voltages using this general math equation down below, and then it hands those voltages over to the opp voltage table:

opp_volt[i] = (volt[i] * volt_step) + volt_base;

that's it, that's the whole bit — bank makes voltages, opp voltage table receives voltages, everyone claps 👏✨

---

🌈 SEE ALSO 🌈

go be nosy, the receipts are all here 🔥:

• Kernel file ./drivers/soc/mediatek/mtk-svs.c
• enum svsb_sw_id(9)
• enum svsb_type(9)
• enum svsb_phase(9)
• struct svs_platform(9)
• struct svs_bank_pdata(9)

---

k bye bestie, go read the source, drink water, and remember: ./drivers/soc/mediatek, October 2026 — that's the version + date tea 🍓💅 mwah 🎀