简介本资源是一份面向嵌入式Linux驱动开发工程师与电源管理技术学习者的Hi6421 PMIC核心驱动源码解析资料聚焦移动设备与嵌入式系统中低功耗电源管理的落地实现。压缩包仅含1个关键C源文件hi6421-pmic-core.c大小仅1KB精炼呈现Hi6421电源管理芯片的驱动框架——涵盖初始化配置、I2C通信协议实现、电压/电流动态调控、中断响应机制及过压/欠压等故障保护逻辑。内容深度结合硬件特性完整覆盖驱动结构设计、DVFS策略支持、热节流算法接口与调试日志机制可直接用于内核模块移植、定制化电源策略开发或教学案例分析。目前已有458人下载学习适合具备C语言基础和Linux设备驱动开发经验的中高级开发者快速掌握PMIC驱动核心逻辑与工程实践要点。1. HI6421 PMIC Core 驱动到底在干啥——不是“烧录固件”而是让 SoC 和电源芯片真正“说上话”你手头有一份hi6421-pmic-core.rar解压后看到hi6421-pmic-core.c、一堆.h头文件还附带一份hi6421.pdf规格书。别急着双击打开——这不是一个能直接“运行”的程序也不是拿来刷进手机的固件包。它是一套Linux 内核态的电源管理集成电路PMIC驱动核心模块专为华为海思 Hi6421 这颗多通道、高集成度的 PMIC 芯片设计。它的核心任务是让运行 Linux 的主控 SoC比如 Kirin 系列平台能通过 I²C 或 SPI 总线可靠读写 HI6421 的寄存器组动态控制 12 路以上 DC-DC 和 LDO 的电压、使能状态、过压/过流保护阈值甚至响应其 IRQ 中断上报的电源异常事件。换句话说没有它你的板子可能连内核都起不来因为 DDR 供电没配对或者跑几分钟就热关机温控策略没生效。它面向的是嵌入式 Linux BSP 工程师、驱动开发人员和硬件调试老手——如果你正卡在“板子上电后 kernel panic 在 regulator_init”或“dmesg | grep hi6421一片空白”那这篇笔记就是为你写的。我们不讲 PDF 里第 37 页的电气参数表格只聚焦怎么把它编进内核、怎么确认它真在干活、以及为什么你改了vdd_core电压却没生效。2. 从源码包到内核模块四步走通 HI6421 驱动编译与加载链路HI6421 驱动不是独立可执行程序它必须作为 Linux 内核的一部分被编译、链接、加载。整个过程环环相扣漏掉任一环节都会导致modprobe hi6421_pmic_core报错或dmesg无任何输出。下面按真实调试顺序拆解。2.1 解压与源码结构定位认准hi6421-pmic-core.c是主干不是全部# 先解压注意rar 文件需安装 unrar sudo apt install unrar unrar x hi6421-pmic-core.rar # 查看解压后结构典型布局 ls -R # . # ├── hi6421-pmic-core.c # 驱动主文件probe/init/remove 函数、regmap 初始化、regulator_ops 定义 # ├── hi6421-regulator.c # 关键子模块所有 DC-DC/LDO 的 regulator_desc 数组定义、电压映射表 # ├── hi6421-irq.c # 中断处理模块注册 IRQ handler解析 STATUS 寄存器上报的 overtemp/ovp/uvt 事件 # ├── hi6421.h # 核心头文件寄存器地址宏HI6421_REG_CTRL1、位域定义HI6421_VSEL_MASK、芯片 ID 检测值 # ├── Kconfig # 内核配置项提供 CONFIG_HI6421_PMIC_COREy/m 选项 # └── Makefile # 编译规则obj-$(CONFIG_HI6421_PMIC_CORE) hi6421-pmic-core.o提示hi6421-pmic-core.c是入口但hi6421-regulator.c才决定你能用几个 regulator。比如hi6421_regulators[]数组里定义了vdd_arm,vdd_core,vdd_gpu等 15 个条目每个条目绑定了n_voltages,min_uV,uV_step和ops—— 这些直接决定你在用户态echo 1000000 /sys/class/regulator/regulator.0/microvolts是否合法。2.2 内核配置Kconfig 必须启用且依赖项一个不能少HI6421 驱动不是孤立存在它强依赖内核的REGULATOR、I2C和MFD_CORE子系统。在你的内核源码树中进入drivers/power/supply/或drivers/regulator/目录具体路径依内核版本而定5.10 多在drivers/regulator/将hi6421-pmic-core/目录复制进去然后修改对应Kconfig# drivers/regulator/Kconfig 中追加位置在 menuconfig REGULATOR 下 config HI6421_PMIC_CORE tristate HiSilicon HI6421 PMIC support depends on I2C REGULATOR MFD_CORE select REGULATOR_FIXED_VOLTAGE select REGULATOR_DA9062 if ARCH_ARM64 # 常见关联驱动非必须但建议开启 help Say Y here to enable support for the HiSilicon HI6421 Power Management IC. This provides voltage regulation and interrupt handling.参数说明depends on I2C REGULATOR MFD_CORE是硬性门槛。MFD_COREMulti-Function Device是关键——HI6421 被内核视为一个 MFD 设备其下的 regulator、rtc、adc 等子功能由mfd_cell结构体统一管理。如果MFD_CORE未选hi6421_pmic_core_probe()里的devm_mfd_add_devices()就会失败dmesg里只会显示mfd: failed to add devices根本看不到 HI6421 字样。2.3 编译与模块生成Makefile 写法决定它是 built-in 还是 ko将hi6421-pmic-core/目录放入内核源码后在drivers/regulator/Makefile末尾添加# drivers/regulator/Makefile obj-$(CONFIG_HI6421_PMIC_CORE) hi6421-pmic-core/然后执行编译以 ARM64 平台为例# 清理旧配置重要避免残留 .config 影响 make mrproper # 加载你的板级 defconfig如 hisi_defconfig make ARCHarm64 hisi_defconfig # 手动启用 HI6421或用 menuconfig 图形界面 echo CONFIG_HI6421_PMIC_COREm .config make ARCHarm64 olddefconfig # 自动解决依赖 # 编译模块推荐先编译为模块便于调试 make ARCHarm64 modules -j$(nproc) # 查看生成结果 ls drivers/regulator/hi6421-pmic-core/ # hi6421-pmic-core.ko hi6421-regulator.ko hi6421-irq.ko # 三个独立 ko 文件逻辑说明obj-$(CONFIG_...) dir/表示将该目录下所有*.c编译为一个模块。hi6421-pmic-core.c里module_platform_driver(hi6421_pmic_driver)是注册入口hi6421-regulator.c提供regulator_ops实现hi6421-irq.c提供中断服务例程。三者必须同时加载顺序为hi6421_pmic_core.ko→hi6421_regulator.ko→hi6421_irq.koinsmod时需按此序或打包进modules.order。2.4 DTS 设备树绑定没有正确的 node驱动永远 probe 失败驱动代码写得再好没有设备树DTS描述内核根本不会调用probe()。HI6421 在 DTS 中必须声明为mfd设备并显式列出其子节点regulator, irq。典型hi6421.dtsi片段如下i2c0 { #address-cells 1; #size-cells 0; hi6421_pmic: pmic34 { compatible hisilicon,hi6421; reg 0x34; // I2C 地址查 HI6421 PDF 第 5 页 Table 1 interrupts GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH; // IRQ 引脚号需与硬件原理图一致 interrupt-controller; #interrupt-cells 2; /* 子节点regulator */ vdd_core: regulator0 { reg 0; regulator-name vdd_core; regulator-min-microvolt 700000; regulator-max-microvolt 1300000; regulator-boot-on; regulator-always-on; }; vdd_arm: regulator1 { reg 1; regulator-name vdd_arm; regulator-min-microvolt 700000; regulator-max-microvolt 1200000; }; }; };参数说明compatible hisilicon,hi6421是驱动匹配的关键hi6421-pmic-core.c中of_match_table必须包含此字符串reg 0x34是 I2C 地址HI6421 默认为0x34PDF Section 5.1但部分定制版可能为0x35务必实测interrupts的123是 GIC 中断号必须与硬件设计完全一致否则 IRQ 不触发过温保护失效。vdd_core0的reg 0对应hi6421-regulator.c中hi6421_regulators[0]的索引。3. 验证驱动是否真在运行从 dmesg 到 sysfs五层证据链闭环光编译出.ko不代表成功。必须用五层证据交叉验证内核日志、设备节点、sysfs 属性、寄存器读写、实际电压测量。缺一层都可能是“假启动”。3.1 dmesg 日志第一道门看 probe 是否完成加载模块后立即执行# 加载三个 ko顺序不能错 sudo insmod drivers/regulator/hi6421-pmic-core.ko sudo insmod drivers/regulator/hi6421-regulator.ko sudo insmod drivers/regulator/hi6421-irq.ko # 查看内核日志 dmesg | grep -i hi6421\|pmic\|regulator成功现象[ 5.123456] hi6421-pmic-core 3-0034: HI6421 PMIC detected (ID0x6421) [ 5.123457] hi6421-pmic-core 3-0034: Registered 15 regulators [ 5.123458] hi6421-irq 3-0034: IRQ handler registered, status mask0x3f [ 5.123459] regulator-dummy: regulator_init_complete: 15 regulators initialized失败现象及排查No such deviceI2C 地址0x34错误用i2cdetect -y 0扫描确认。Failed to get IRQDTS 中interrupts值错误或硬件 IRQ 引脚未连接。Failed to register regulatorhi6421-regulator.c中某 regulator 的ops-set_voltage_sel返回负值检查vsel映射表是否越界。3.2 /sys/class/regulator/确认 regulator 设备节点已创建ls /sys/class/regulator/ # regulator.0 regulator.1 ... regulator.14 # 应有 15 个对应 hi6421_regulators[] 长度 cat /sys/class/regulator/regulator.0/name # vdd_core cat /sys/class/regulator/regulator.0/microvolts # 1000000 # 当前设定电压单位 uV逻辑说明regulator.0的name必须与 DTS 中regulator0的regulator-name一致。若ls /sys/class/regulator/为空说明hi6421-regulator.ko未加载或hi6421_pmic_core_probe()中devm_regulator_register()失败常见于rdev-desc初始化错误。3.3 读写寄存器用 i2cget/i2cset 直接验证通信链路HI6421 PDF 第 12 页定义了REG_CHIP_ID 0x00读取应返回0x6421。这是检验 I2C 通路最直接的方法# 读取芯片 ID0x00 寄存器2 字节 i2cget -y 0 0x34 0x00 w # 返回 0x6421 即通信正常 # 读取 vdd_core 当前电压设置假设 vdd_core 对应 REG_VDDCORE 0x10 i2cget -y 0 0x34 0x10 b # 返回值如 0x0a查 HI6421 PDF Table 150x0a - 1000mV # 写入新电压0x0b 1050mV i2cset -y 0 0x34 0x10 0x0b b参数说明i2cget -y 0 0x34 0x00 w中-y跳过交互确认0是 I2C bus number查ls /sys/class/i2c-adapter/w表示读 2 字节word。若i2cget报Connection timed out说明硬件 I2C 线路断开上拉电阻缺失、SCL/SDA 短路或地址错误。3.4 用户态电压调节echo 修改并验证是否生效# 查看当前 vdd_core 支持的电压范围 cat /sys/class/regulator/regulator.0/min_microvolts # 700000 cat /sys/class/regulator/regulator.0/max_microvolts # 1300000 # 尝试设为 1100mV1100000 uV echo 1100000 | sudo tee /sys/class/regulator/regulator.0/microvolts # 确认是否写入成功 cat /sys/class/regulator/regulator.0/microvolts # 应返回 1100000 # 再用 i2cget 读寄存器验证 i2cget -y 0 0x34 0x10 b # 应返回对应 1100mV 的 vsel 值如 0x0d注意microvolts文件是只写的write-onlycat读取返回的是当前设定值不是实时测量值。要测真实电压必须用万用表。3.5 万用表实测终极验证排除软件“幻觉”用数字万用表精度 0.1mV红表笔接vdd_core测试点原理图中标注黑表笔接地。在执行echo 1100000 ...后等待 100ms读数应稳定在1098~1102mV区间。若万用表读数不变仍为 1000mV而cat /sys/.../microvolts显示 1100000则问题在hi6421-regulator.c中hi6421_set_voltage_sel()函数未真正调用regmap_write()或regmap配置错误如regmap_config.val_bits 8但 HI6421 寄存器是 16 位或硬件层面 DC-DC 的EN引脚被拉死始终使能但电压反馈环路未接入。4. HI6421 驱动避坑指南五个血泪经验省你三天调试时间HI6421 是一颗“功能全但脾气怪”的 PMIC文档PDF和代码C之间常有 gap。以下五条是我在三块不同板子上翻车后记下的硬核教训每一条都对应一个dmesg里不会明说的静默失败。4.1 现象dmesg显示 “HI6421 PMIC detected”但/sys/class/regulator/为空原因hi6421-pmic-core.c中hi6421_pmic_probe()调用了devm_mfd_add_devices()但传入的mfd_cells数组长度为 0或mfd_cell.name与子驱动MODULE_DEVICE_TABLE(of, ...)不匹配。HI6421 的 regulator 子驱动名必须是hi6421-regulator而mfd_cell.name若写成hi6421就会导致子驱动无法绑定。解决检查hi6421-pmic-core.c中hi6421_cells[]数组确认name hi6421-regulator同时检查hi6421-regulator.c开头是否有MODULE_DEVICE_TABLE(of, hi6421_of_match);且hi6421_of_match[]包含hisilicon,hi6421。4.2 现象echo 1100000 /sys/.../microvolts成功但万用表测电压不变i2cget读寄存器值也不变原因hi6421-regulator.c的hi6421_set_voltage_sel()函数里regmap_write()调用失败但被忽略。HI6421 的电压寄存器如REG_VDDCORE是 16 位宽但默认regmap_config可能设为 8 位。regmap_write(regmap, reg, val)若val超过 255且val_bits8则高位被截断写入无效值。解决在hi6421_pmic_probe()初始化regmap时确保regmap_config.val_bits 16并在hi6421_set_voltage_sel()中添加错误检查ret regmap_write(pmic-regmap, reg, vsel); if (ret 0) { dev_err(pdev-dev, Failed to write VSEL %d to reg 0x%x\n, vsel, reg); return ret; }4.3 现象dmesg报 “IRQ handler registered”但cat /proc/interrupts | grep hi6421无计数过温时无 log原因HI6421 的 IRQ 是低电平有效active-low但 DTS 中interrupts GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH写成了LEVEL_HIGH。硬件上 IRQ 引脚拉低时GIC 误判为无效中断。解决查 HI6421 PDF Section 6.2.1确认 IRQ 极性为Active LowDTS 中改为interrupts GIC_SPI 123 IRQ_TYPE_LEVEL_LOW同时检查hi6421-irq.c中irq_set_irq_type(irq, IRQ_TYPE_LEVEL_LOW)是否被调用。4.4 现象vdd_core电压可调但vdd_gpu调节失败dmesg报 “regulator vdd_gpu: set_voltage_sel: invalid selector”原因hi6421-regulator.c中hi6421_vdd_gpu的vsel_to_uv映射表长度n_voltages为 32但实际 HI6421 GPU 通道只支持 16 档电压PDF Table 18。当用户echo 1200000 ...时计算出的selector为 25超出映射表边界vsel_to_uv[25]访问越界。解决严格对照 HI6421 PDF Table 18重写hi6421_vdd_gpu.vsel_to_uv[]确保数组长度等于n_voltages且每个vsel_to_uv[i]值与 PDF 一一对应。宁可删掉不支持的档位也不要留空洞。4.5 现象系统启动后vdd_core电压正确但运行 2 分钟后自动降为 700mVdmesg无任何 log原因HI6421 的REG_PROT_CTRL保护控制寄存器地址0x2F默认使能了OVPT_EN过压保护和UVT_EN欠压关断但硬件设计中vdd_core的反馈电阻网络精度不足±5%导致轻载时反馈电压波动触发 UVT。解决在hi6421_pmic_probe()初始化末尾添加寄存器屏蔽// 禁用欠压关断UVT保留过压保护OVPT regmap_write(pmic-regmap, HI6421_REG_PROT_CTRL, 0x00); // 0x00 all protection disabled // 或更安全只关 UVT开 OVPT regmap_write(pmic-regmap, HI6421_REG_PROT_CTRL, BIT(0)); // BIT(0)UVT_EN, BIT(1)OVPT_EN提示此操作需硬件确认——若 PCB 上vdd_core反馈电阻是 ±1% 精密电阻则无需禁用 UVT若为普通 ±5% 电阻则必须禁用否则必翻车。5. 进阶技巧用 regmap-debugfs 实时监控 HI6421 寄存器把黑匣子变成透明窗口HI6421 的寄存器多达 128 个PDF Section 10靠i2cget逐个读效率极低且无法观察变化趋势。Linux 内核提供了regmap-debugfs接口能将整个 regmap 映射为/sys/kernel/debug/regmap/下的虚拟文件实现毫秒级寄存器快照与差异比对。这是我调试 HI6421 时最常用的“后悔药”。5.1 启用 regmap-debugfs内核配置一步到位在内核配置中确保启用CONFIG_DEBUG_FSy CONFIG_REGMAP_DEBUGFSy编译后启动/sys/kernel/debug/目录即存在。加载 HI6421 驱动后ls /sys/kernel/debug/regmap/ # 3-0034 # 名称格式为 bus-addr对应 I2C bus 3, addr 0x345.2 实时寄存器快照用 cat 读取整个寄存器空间# 读取全部寄存器0x00 到 0x7F输出为十六进制 cat /sys/kernel/debug/regmap/3-0034/registers # 输出示例 # 0000: 6421 0000 0000 0000 0000 0000 0000 0000 # 0020: 000a 0000 0000 0000 0000 0000 0000 0000 # ... # 其中 0000 行的 6421 即 CHIP_ID0020 行的 000a 即 REG_VDDCORE (0x20) 的值参数说明registers文件是只读的输出格式为offset: value1 value2 ...每行 16 字节32 个 hex 值。0000:表示偏移 0x000020:表示偏移 0x20。HI6421 PDF 中所有寄存器地址都是 8 位所以0x20对应REG_VDDCORE。5.3 寄存器差异监控用 diff 抓住瞬态异常当遇到“电压莫名跳变”这类玄学问题时用两个快照做 diff 最有效# 拍摄 baseline 快照正常时 cat /sys/kernel/debug/regmap/3-0034/registers hi6421_baseline.txt # 运行一段时间或触发异常场景如 GPU 满载 # ... # 拍摄 current 快照 cat /sys/kernel/debug/regmap/3-0034/registers hi6421_current.txt # 差异对比只显示变化的行 diff hi6421_baseline.txt hi6421_current.txt | grep ^ # 输出示例 # 0020: 000a 0000 0000 0000 0000 0000 0000 0000 # 002f: 0001 0000 0000 0000 0000 0000 0000 0000逻辑说明0020行变化说明vdd_core电压被修改002f行变化REG_PROT_CTRL说明保护寄存器被写入可能触发了保护动作。这比在dmesg里大海捞针高效十倍。5.4 写寄存器调试用 debugfs 直接注入测试值regmap-debugfs还支持写入用于快速验证寄存器功能# 向 REG_VDDCORE (0x20) 写入 0x0b1050mV echo 0x20 0x0b /sys/kernel/debug/regmap/3-0034/write # 验证是否写入成功 cat /sys/kernel/debug/regmap/3-0034/registers | grep ^0020 # 应显示 0020: 000b ...注意write文件格式为offset valueoffset和value都是十六进制中间空格分隔。此操作绕过驱动的set_voltage逻辑直接作用于硬件仅用于调试切勿在生产环境使用。5.5 我的日常调试习惯三步闭环法第一步抓 baseline—— 系统刚启动、idle 状态下执行cat /sys/kernel/debug/regmap/3-0034/registers base.txt存档。第二步复现问题—— 运行stress-ng --cpu 4 --timeout 60s模拟负载或手动echo 1200000 /sys/.../microvolts。第三步diff cross-check——diff base.txt current.txt找出变化寄存器再查 PDF 确认该寄存器功能如0x2f是保护控制0x10是 vdd_arm 电压最后用i2cget单独读验证。这套方法让我在两周内定位了 HI6421 的一个隐藏 bugREG_TEMP_CTRL温度控制寄存器的 bit 7TEMP_AUTO_EN被硬件默认拉高导致芯片在 60°C 就自动降频而驱动未初始化该寄存器。补上regmap_write(..., 0x2E, 0x00)后问题消失。希望帮到你。本文还有配套的精品资源点击获取
简介本资源是一份面向嵌入式Linux驱动开发工程师与电源管理技术学习者的Hi6421 PMIC核心驱动源码解析资料聚焦移动设备与嵌入式系统中低功耗电源管理的落地实现。压缩包仅含1个关键C源文件hi6421-pmic-core.c大小仅1KB精炼呈现Hi6421电源管理芯片的驱动框架——涵盖初始化配置、I2C通信协议实现、电压/电流动态调控、中断响应机制及过压/欠压等故障保护逻辑。内容深度结合硬件特性完整覆盖驱动结构设计、DVFS策略支持、热节流算法接口与调试日志机制可直接用于内核模块移植、定制化电源策略开发或教学案例分析。目前已有458人下载学习适合具备C语言基础和Linux设备驱动开发经验的中高级开发者快速掌握PMIC驱动核心逻辑与工程实践要点。1. HI6421 PMIC Core 驱动到底在干啥——不是“烧录固件”而是让 SoC 和电源芯片真正“说上话”你手头有一份hi6421-pmic-core.rar解压后看到hi6421-pmic-core.c、一堆.h头文件还附带一份hi6421.pdf规格书。别急着双击打开——这不是一个能直接“运行”的程序也不是拿来刷进手机的固件包。它是一套Linux 内核态的电源管理集成电路PMIC驱动核心模块专为华为海思 Hi6421 这颗多通道、高集成度的 PMIC 芯片设计。它的核心任务是让运行 Linux 的主控 SoC比如 Kirin 系列平台能通过 I²C 或 SPI 总线可靠读写 HI6421 的寄存器组动态控制 12 路以上 DC-DC 和 LDO 的电压、使能状态、过压/过流保护阈值甚至响应其 IRQ 中断上报的电源异常事件。换句话说没有它你的板子可能连内核都起不来因为 DDR 供电没配对或者跑几分钟就热关机温控策略没生效。它面向的是嵌入式 Linux BSP 工程师、驱动开发人员和硬件调试老手——如果你正卡在“板子上电后 kernel panic 在 regulator_init”或“dmesg | grep hi6421一片空白”那这篇笔记就是为你写的。我们不讲 PDF 里第 37 页的电气参数表格只聚焦怎么把它编进内核、怎么确认它真在干活、以及为什么你改了vdd_core电压却没生效。2. 从源码包到内核模块四步走通 HI6421 驱动编译与加载链路HI6421 驱动不是独立可执行程序它必须作为 Linux 内核的一部分被编译、链接、加载。整个过程环环相扣漏掉任一环节都会导致modprobe hi6421_pmic_core报错或dmesg无任何输出。下面按真实调试顺序拆解。2.1 解压与源码结构定位认准hi6421-pmic-core.c是主干不是全部# 先解压注意rar 文件需安装 unrar sudo apt install unrar unrar x hi6421-pmic-core.rar # 查看解压后结构典型布局 ls -R # . # ├── hi6421-pmic-core.c # 驱动主文件probe/init/remove 函数、regmap 初始化、regulator_ops 定义 # ├── hi6421-regulator.c # 关键子模块所有 DC-DC/LDO 的 regulator_desc 数组定义、电压映射表 # ├── hi6421-irq.c # 中断处理模块注册 IRQ handler解析 STATUS 寄存器上报的 overtemp/ovp/uvt 事件 # ├── hi6421.h # 核心头文件寄存器地址宏HI6421_REG_CTRL1、位域定义HI6421_VSEL_MASK、芯片 ID 检测值 # ├── Kconfig # 内核配置项提供 CONFIG_HI6421_PMIC_COREy/m 选项 # └── Makefile # 编译规则obj-$(CONFIG_HI6421_PMIC_CORE) hi6421-pmic-core.o提示hi6421-pmic-core.c是入口但hi6421-regulator.c才决定你能用几个 regulator。比如hi6421_regulators[]数组里定义了vdd_arm,vdd_core,vdd_gpu等 15 个条目每个条目绑定了n_voltages,min_uV,uV_step和ops—— 这些直接决定你在用户态echo 1000000 /sys/class/regulator/regulator.0/microvolts是否合法。2.2 内核配置Kconfig 必须启用且依赖项一个不能少HI6421 驱动不是孤立存在它强依赖内核的REGULATOR、I2C和MFD_CORE子系统。在你的内核源码树中进入drivers/power/supply/或drivers/regulator/目录具体路径依内核版本而定5.10 多在drivers/regulator/将hi6421-pmic-core/目录复制进去然后修改对应Kconfig# drivers/regulator/Kconfig 中追加位置在 menuconfig REGULATOR 下 config HI6421_PMIC_CORE tristate HiSilicon HI6421 PMIC support depends on I2C REGULATOR MFD_CORE select REGULATOR_FIXED_VOLTAGE select REGULATOR_DA9062 if ARCH_ARM64 # 常见关联驱动非必须但建议开启 help Say Y here to enable support for the HiSilicon HI6421 Power Management IC. This provides voltage regulation and interrupt handling.参数说明depends on I2C REGULATOR MFD_CORE是硬性门槛。MFD_COREMulti-Function Device是关键——HI6421 被内核视为一个 MFD 设备其下的 regulator、rtc、adc 等子功能由mfd_cell结构体统一管理。如果MFD_CORE未选hi6421_pmic_core_probe()里的devm_mfd_add_devices()就会失败dmesg里只会显示mfd: failed to add devices根本看不到 HI6421 字样。2.3 编译与模块生成Makefile 写法决定它是 built-in 还是 ko将hi6421-pmic-core/目录放入内核源码后在drivers/regulator/Makefile末尾添加# drivers/regulator/Makefile obj-$(CONFIG_HI6421_PMIC_CORE) hi6421-pmic-core/然后执行编译以 ARM64 平台为例# 清理旧配置重要避免残留 .config 影响 make mrproper # 加载你的板级 defconfig如 hisi_defconfig make ARCHarm64 hisi_defconfig # 手动启用 HI6421或用 menuconfig 图形界面 echo CONFIG_HI6421_PMIC_COREm .config make ARCHarm64 olddefconfig # 自动解决依赖 # 编译模块推荐先编译为模块便于调试 make ARCHarm64 modules -j$(nproc) # 查看生成结果 ls drivers/regulator/hi6421-pmic-core/ # hi6421-pmic-core.ko hi6421-regulator.ko hi6421-irq.ko # 三个独立 ko 文件逻辑说明obj-$(CONFIG_...) dir/表示将该目录下所有*.c编译为一个模块。hi6421-pmic-core.c里module_platform_driver(hi6421_pmic_driver)是注册入口hi6421-regulator.c提供regulator_ops实现hi6421-irq.c提供中断服务例程。三者必须同时加载顺序为hi6421_pmic_core.ko→hi6421_regulator.ko→hi6421_irq.koinsmod时需按此序或打包进modules.order。2.4 DTS 设备树绑定没有正确的 node驱动永远 probe 失败驱动代码写得再好没有设备树DTS描述内核根本不会调用probe()。HI6421 在 DTS 中必须声明为mfd设备并显式列出其子节点regulator, irq。典型hi6421.dtsi片段如下i2c0 { #address-cells 1; #size-cells 0; hi6421_pmic: pmic34 { compatible hisilicon,hi6421; reg 0x34; // I2C 地址查 HI6421 PDF 第 5 页 Table 1 interrupts GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH; // IRQ 引脚号需与硬件原理图一致 interrupt-controller; #interrupt-cells 2; /* 子节点regulator */ vdd_core: regulator0 { reg 0; regulator-name vdd_core; regulator-min-microvolt 700000; regulator-max-microvolt 1300000; regulator-boot-on; regulator-always-on; }; vdd_arm: regulator1 { reg 1; regulator-name vdd_arm; regulator-min-microvolt 700000; regulator-max-microvolt 1200000; }; }; };参数说明compatible hisilicon,hi6421是驱动匹配的关键hi6421-pmic-core.c中of_match_table必须包含此字符串reg 0x34是 I2C 地址HI6421 默认为0x34PDF Section 5.1但部分定制版可能为0x35务必实测interrupts的123是 GIC 中断号必须与硬件设计完全一致否则 IRQ 不触发过温保护失效。vdd_core0的reg 0对应hi6421-regulator.c中hi6421_regulators[0]的索引。3. 验证驱动是否真在运行从 dmesg 到 sysfs五层证据链闭环光编译出.ko不代表成功。必须用五层证据交叉验证内核日志、设备节点、sysfs 属性、寄存器读写、实际电压测量。缺一层都可能是“假启动”。3.1 dmesg 日志第一道门看 probe 是否完成加载模块后立即执行# 加载三个 ko顺序不能错 sudo insmod drivers/regulator/hi6421-pmic-core.ko sudo insmod drivers/regulator/hi6421-regulator.ko sudo insmod drivers/regulator/hi6421-irq.ko # 查看内核日志 dmesg | grep -i hi6421\|pmic\|regulator成功现象[ 5.123456] hi6421-pmic-core 3-0034: HI6421 PMIC detected (ID0x6421) [ 5.123457] hi6421-pmic-core 3-0034: Registered 15 regulators [ 5.123458] hi6421-irq 3-0034: IRQ handler registered, status mask0x3f [ 5.123459] regulator-dummy: regulator_init_complete: 15 regulators initialized失败现象及排查No such deviceI2C 地址0x34错误用i2cdetect -y 0扫描确认。Failed to get IRQDTS 中interrupts值错误或硬件 IRQ 引脚未连接。Failed to register regulatorhi6421-regulator.c中某 regulator 的ops-set_voltage_sel返回负值检查vsel映射表是否越界。3.2 /sys/class/regulator/确认 regulator 设备节点已创建ls /sys/class/regulator/ # regulator.0 regulator.1 ... regulator.14 # 应有 15 个对应 hi6421_regulators[] 长度 cat /sys/class/regulator/regulator.0/name # vdd_core cat /sys/class/regulator/regulator.0/microvolts # 1000000 # 当前设定电压单位 uV逻辑说明regulator.0的name必须与 DTS 中regulator0的regulator-name一致。若ls /sys/class/regulator/为空说明hi6421-regulator.ko未加载或hi6421_pmic_core_probe()中devm_regulator_register()失败常见于rdev-desc初始化错误。3.3 读写寄存器用 i2cget/i2cset 直接验证通信链路HI6421 PDF 第 12 页定义了REG_CHIP_ID 0x00读取应返回0x6421。这是检验 I2C 通路最直接的方法# 读取芯片 ID0x00 寄存器2 字节 i2cget -y 0 0x34 0x00 w # 返回 0x6421 即通信正常 # 读取 vdd_core 当前电压设置假设 vdd_core 对应 REG_VDDCORE 0x10 i2cget -y 0 0x34 0x10 b # 返回值如 0x0a查 HI6421 PDF Table 150x0a - 1000mV # 写入新电压0x0b 1050mV i2cset -y 0 0x34 0x10 0x0b b参数说明i2cget -y 0 0x34 0x00 w中-y跳过交互确认0是 I2C bus number查ls /sys/class/i2c-adapter/w表示读 2 字节word。若i2cget报Connection timed out说明硬件 I2C 线路断开上拉电阻缺失、SCL/SDA 短路或地址错误。3.4 用户态电压调节echo 修改并验证是否生效# 查看当前 vdd_core 支持的电压范围 cat /sys/class/regulator/regulator.0/min_microvolts # 700000 cat /sys/class/regulator/regulator.0/max_microvolts # 1300000 # 尝试设为 1100mV1100000 uV echo 1100000 | sudo tee /sys/class/regulator/regulator.0/microvolts # 确认是否写入成功 cat /sys/class/regulator/regulator.0/microvolts # 应返回 1100000 # 再用 i2cget 读寄存器验证 i2cget -y 0 0x34 0x10 b # 应返回对应 1100mV 的 vsel 值如 0x0d注意microvolts文件是只写的write-onlycat读取返回的是当前设定值不是实时测量值。要测真实电压必须用万用表。3.5 万用表实测终极验证排除软件“幻觉”用数字万用表精度 0.1mV红表笔接vdd_core测试点原理图中标注黑表笔接地。在执行echo 1100000 ...后等待 100ms读数应稳定在1098~1102mV区间。若万用表读数不变仍为 1000mV而cat /sys/.../microvolts显示 1100000则问题在hi6421-regulator.c中hi6421_set_voltage_sel()函数未真正调用regmap_write()或regmap配置错误如regmap_config.val_bits 8但 HI6421 寄存器是 16 位或硬件层面 DC-DC 的EN引脚被拉死始终使能但电压反馈环路未接入。4. HI6421 驱动避坑指南五个血泪经验省你三天调试时间HI6421 是一颗“功能全但脾气怪”的 PMIC文档PDF和代码C之间常有 gap。以下五条是我在三块不同板子上翻车后记下的硬核教训每一条都对应一个dmesg里不会明说的静默失败。4.1 现象dmesg显示 “HI6421 PMIC detected”但/sys/class/regulator/为空原因hi6421-pmic-core.c中hi6421_pmic_probe()调用了devm_mfd_add_devices()但传入的mfd_cells数组长度为 0或mfd_cell.name与子驱动MODULE_DEVICE_TABLE(of, ...)不匹配。HI6421 的 regulator 子驱动名必须是hi6421-regulator而mfd_cell.name若写成hi6421就会导致子驱动无法绑定。解决检查hi6421-pmic-core.c中hi6421_cells[]数组确认name hi6421-regulator同时检查hi6421-regulator.c开头是否有MODULE_DEVICE_TABLE(of, hi6421_of_match);且hi6421_of_match[]包含hisilicon,hi6421。4.2 现象echo 1100000 /sys/.../microvolts成功但万用表测电压不变i2cget读寄存器值也不变原因hi6421-regulator.c的hi6421_set_voltage_sel()函数里regmap_write()调用失败但被忽略。HI6421 的电压寄存器如REG_VDDCORE是 16 位宽但默认regmap_config可能设为 8 位。regmap_write(regmap, reg, val)若val超过 255且val_bits8则高位被截断写入无效值。解决在hi6421_pmic_probe()初始化regmap时确保regmap_config.val_bits 16并在hi6421_set_voltage_sel()中添加错误检查ret regmap_write(pmic-regmap, reg, vsel); if (ret 0) { dev_err(pdev-dev, Failed to write VSEL %d to reg 0x%x\n, vsel, reg); return ret; }4.3 现象dmesg报 “IRQ handler registered”但cat /proc/interrupts | grep hi6421无计数过温时无 log原因HI6421 的 IRQ 是低电平有效active-low但 DTS 中interrupts GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH写成了LEVEL_HIGH。硬件上 IRQ 引脚拉低时GIC 误判为无效中断。解决查 HI6421 PDF Section 6.2.1确认 IRQ 极性为Active LowDTS 中改为interrupts GIC_SPI 123 IRQ_TYPE_LEVEL_LOW同时检查hi6421-irq.c中irq_set_irq_type(irq, IRQ_TYPE_LEVEL_LOW)是否被调用。4.4 现象vdd_core电压可调但vdd_gpu调节失败dmesg报 “regulator vdd_gpu: set_voltage_sel: invalid selector”原因hi6421-regulator.c中hi6421_vdd_gpu的vsel_to_uv映射表长度n_voltages为 32但实际 HI6421 GPU 通道只支持 16 档电压PDF Table 18。当用户echo 1200000 ...时计算出的selector为 25超出映射表边界vsel_to_uv[25]访问越界。解决严格对照 HI6421 PDF Table 18重写hi6421_vdd_gpu.vsel_to_uv[]确保数组长度等于n_voltages且每个vsel_to_uv[i]值与 PDF 一一对应。宁可删掉不支持的档位也不要留空洞。4.5 现象系统启动后vdd_core电压正确但运行 2 分钟后自动降为 700mVdmesg无任何 log原因HI6421 的REG_PROT_CTRL保护控制寄存器地址0x2F默认使能了OVPT_EN过压保护和UVT_EN欠压关断但硬件设计中vdd_core的反馈电阻网络精度不足±5%导致轻载时反馈电压波动触发 UVT。解决在hi6421_pmic_probe()初始化末尾添加寄存器屏蔽// 禁用欠压关断UVT保留过压保护OVPT regmap_write(pmic-regmap, HI6421_REG_PROT_CTRL, 0x00); // 0x00 all protection disabled // 或更安全只关 UVT开 OVPT regmap_write(pmic-regmap, HI6421_REG_PROT_CTRL, BIT(0)); // BIT(0)UVT_EN, BIT(1)OVPT_EN提示此操作需硬件确认——若 PCB 上vdd_core反馈电阻是 ±1% 精密电阻则无需禁用 UVT若为普通 ±5% 电阻则必须禁用否则必翻车。5. 进阶技巧用 regmap-debugfs 实时监控 HI6421 寄存器把黑匣子变成透明窗口HI6421 的寄存器多达 128 个PDF Section 10靠i2cget逐个读效率极低且无法观察变化趋势。Linux 内核提供了regmap-debugfs接口能将整个 regmap 映射为/sys/kernel/debug/regmap/下的虚拟文件实现毫秒级寄存器快照与差异比对。这是我调试 HI6421 时最常用的“后悔药”。5.1 启用 regmap-debugfs内核配置一步到位在内核配置中确保启用CONFIG_DEBUG_FSy CONFIG_REGMAP_DEBUGFSy编译后启动/sys/kernel/debug/目录即存在。加载 HI6421 驱动后ls /sys/kernel/debug/regmap/ # 3-0034 # 名称格式为 bus-addr对应 I2C bus 3, addr 0x345.2 实时寄存器快照用 cat 读取整个寄存器空间# 读取全部寄存器0x00 到 0x7F输出为十六进制 cat /sys/kernel/debug/regmap/3-0034/registers # 输出示例 # 0000: 6421 0000 0000 0000 0000 0000 0000 0000 # 0020: 000a 0000 0000 0000 0000 0000 0000 0000 # ... # 其中 0000 行的 6421 即 CHIP_ID0020 行的 000a 即 REG_VDDCORE (0x20) 的值参数说明registers文件是只读的输出格式为offset: value1 value2 ...每行 16 字节32 个 hex 值。0000:表示偏移 0x000020:表示偏移 0x20。HI6421 PDF 中所有寄存器地址都是 8 位所以0x20对应REG_VDDCORE。5.3 寄存器差异监控用 diff 抓住瞬态异常当遇到“电压莫名跳变”这类玄学问题时用两个快照做 diff 最有效# 拍摄 baseline 快照正常时 cat /sys/kernel/debug/regmap/3-0034/registers hi6421_baseline.txt # 运行一段时间或触发异常场景如 GPU 满载 # ... # 拍摄 current 快照 cat /sys/kernel/debug/regmap/3-0034/registers hi6421_current.txt # 差异对比只显示变化的行 diff hi6421_baseline.txt hi6421_current.txt | grep ^ # 输出示例 # 0020: 000a 0000 0000 0000 0000 0000 0000 0000 # 002f: 0001 0000 0000 0000 0000 0000 0000 0000逻辑说明0020行变化说明vdd_core电压被修改002f行变化REG_PROT_CTRL说明保护寄存器被写入可能触发了保护动作。这比在dmesg里大海捞针高效十倍。5.4 写寄存器调试用 debugfs 直接注入测试值regmap-debugfs还支持写入用于快速验证寄存器功能# 向 REG_VDDCORE (0x20) 写入 0x0b1050mV echo 0x20 0x0b /sys/kernel/debug/regmap/3-0034/write # 验证是否写入成功 cat /sys/kernel/debug/regmap/3-0034/registers | grep ^0020 # 应显示 0020: 000b ...注意write文件格式为offset valueoffset和value都是十六进制中间空格分隔。此操作绕过驱动的set_voltage逻辑直接作用于硬件仅用于调试切勿在生产环境使用。5.5 我的日常调试习惯三步闭环法第一步抓 baseline—— 系统刚启动、idle 状态下执行cat /sys/kernel/debug/regmap/3-0034/registers base.txt存档。第二步复现问题—— 运行stress-ng --cpu 4 --timeout 60s模拟负载或手动echo 1200000 /sys/.../microvolts。第三步diff cross-check——diff base.txt current.txt找出变化寄存器再查 PDF 确认该寄存器功能如0x2f是保护控制0x10是 vdd_arm 电压最后用i2cget单独读验证。这套方法让我在两周内定位了 HI6421 的一个隐藏 bugREG_TEMP_CTRL温度控制寄存器的 bit 7TEMP_AUTO_EN被硬件默认拉高导致芯片在 60°C 就自动降频而驱动未初始化该寄存器。补上regmap_write(..., 0x2E, 0x00)后问题消失。希望帮到你。本文还有配套的精品资源点击获取
