* [PATCH v3 1/2] hwmon: add Raspberry Pi PMIC driver
2026-11-19 19:41 [PATCH v3 0/2] hwmon: add Raspberry Pi 5 PMIC driver Sander Speetjens
@ 2026-11-19 19:41 ` Sander Speetjens
2026-11-19 19:51 ` sashiko-bot
2026-11-19 19:41 ` [PATCH v3 2/2] firmware: raspberrypi: Register PMIC hwmon driver on Pi 5 Sander Speetjens
1 sibling, 1 reply; 5+ messages in thread
From: Sander Speetjens @ 2026-11-19 19:41 UTC (permalink / raw)
To: Florian Fainelli, Broadcom internal kernel review list,
Guenter Roeck, Ray Jui, Scott Branden, Jonathan Corbet,
Shuah Khan, Randy Dunlap
Cc: linux-kernel, linux-rpi-kernel, linux-arm-kernel, linux-hwmon,
linux-doc, Peter Robinson, Sander Speetjens
Add a hwmon driver for the PMIC found on the Raspberry Pi 5.
The PMIC exposes voltages, currents and temperatures exclusively
through the VideoCore firmware mailbox interface (property
0x0003009f).
Requires a sufficiently recent Raspberry Pi firmware that
implements the structured PMIC ADC property.
The driver:
- is instantiated at runtime by the raspberrypi-firmware driver
(same pattern as the Pi 5 RTC driver)
- reads all channels in a single batch mailbox call
- uses a short refresh-on-read cache
- exposes the sensors via the standard hwmon sysfs interface
Signed-off-by: Sander Speetjens <sander.speetjens@gmail.com>
---
Documentation/hwmon/index.rst | 1 +
Documentation/hwmon/raspberrypi-pmic-hwmon.rst | 49 ++++
drivers/hwmon/Kconfig | 11 +
drivers/hwmon/Makefile | 1 +
drivers/hwmon/raspberrypi-pmic-hwmon.c | 296 +++++++++++++++++++++++++
include/soc/bcm2835/raspberrypi-firmware.h | 1 +
6 files changed, 359 insertions(+)
diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
index c9018fb4b009..41b7da5a19ea 100644
--- a/Documentation/hwmon/index.rst
+++ b/Documentation/hwmon/index.rst
@@ -245,6 +245,7 @@ Hardware Monitoring Kernel Drivers
q54sj108a2
qnap-mcu-hwmon
raspberrypi-hwmon
+ raspberrypi-pmic-hwmon
sbrmi
sbtsi_temp
sch5627
diff --git a/Documentation/hwmon/raspberrypi-pmic-hwmon.rst b/Documentation/hwmon/raspberrypi-pmic-hwmon.rst
new file mode 100644
index 000000000000..000d85359515
--- /dev/null
+++ b/Documentation/hwmon/raspberrypi-pmic-hwmon.rst
@@ -0,0 +1,49 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+Kernel driver raspberrypi-pmic-hwmon
+=======================================
+
+Supported boards:
+
+ * Raspberry Pi 5 Model B
+ * Raspberry Pi Compute Module 5
+ * Raspberry Pi 500
+ * Raspberry Pi 500+
+
+Author: Sander Speetjens <sander.speetjens@gmail.com>
+
+Description
+-----------
+
+The Raspberry Pi 5 uses a PMIC that monitors supply voltages,
+currents and internal temperatures. These sensors are accessed
+via the VideoCore firmware mailbox (property 0x0003009f).
+
+This driver registers with the firmware device at runtime and exposes
+the ADC readings through the standard hwmon sysfs interface. All
+channels are read in a single mailbox transaction and cached for a
+short interval so concurrent or repeated sysfs reads do not generate
+excessive firmware traffic.
+
+Sysfs entries
+-------------
+
+======================= ======================================================
+curr[1-12]_input Current in milliamps
+curr[1-12]_label Current rail name
+in[0-13]_input Voltage in millivolts
+in[0-13]_label Voltage rail name
+temp[1-9]_input Temperature in millidegrees Celsius
+temp[1-9]_label Temperature sensor name
+======================= ======================================================
+
+Current and voltage labels follow the firmware naming (e.g. 3V3_SYS,
+VDD_CORE, EXT5V, BATT). Temperature labels are TEMP1–TEMP8 and TEMP_BG
+(bandgap reference).
+
+Notes
+-----
+
+The driver depends on Raspberry Pi firmware that implements the
+structured PMIC ADC property (0x0003009f). Older firmware will cause
+probe to fail when the property is unavailable.
diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
index bd408fc6f876..58b7dff5e636 100644
--- a/drivers/hwmon/Kconfig
+++ b/drivers/hwmon/Kconfig
@@ -2076,6 +2076,17 @@ config SENSORS_RASPBERRYPI_HWMON
This driver can also be built as a module. If so, the module
will be called raspberrypi-hwmon.
+config SENSORS_RASPBERRYPI_PMIC
+ tristate "Raspberry Pi PMIC monitor"
+ depends on RASPBERRYPI_FIRMWARE || (COMPILE_TEST && !RASPBERRYPI_FIRMWARE)
+ help
+ If you say yes here you get support for the PMIC
+ voltage, current and temperature sensors on the Raspberry Pi 5,
+ accessed via the firmware mailbox interface.
+
+ This driver can also be built as a module. If so, the module
+ will be called raspberrypi-pmic-hwmon.
+
config SENSORS_SL28CPLD
tristate "Kontron sl28cpld hardware monitoring driver"
depends on MFD_SL28CPLD || COMPILE_TEST
diff --git a/drivers/hwmon/Makefile b/drivers/hwmon/Makefile
index dfb6fa4d4492..5dbc6b864f76 100644
--- a/drivers/hwmon/Makefile
+++ b/drivers/hwmon/Makefile
@@ -214,6 +214,7 @@ obj-$(CONFIG_SENSORS_PT5161L) += pt5161l.o
obj-$(CONFIG_SENSORS_PWM_FAN) += pwm-fan.o
obj-$(CONFIG_SENSORS_QNAP_MCU_HWMON) += qnap-mcu-hwmon.o
obj-$(CONFIG_SENSORS_RASPBERRYPI_HWMON) += raspberrypi-hwmon.o
+obj-$(CONFIG_SENSORS_RASPBERRYPI_PMIC) += raspberrypi-pmic-hwmon.o
obj-$(CONFIG_SENSORS_SBTSI) += sbtsi_temp.o
obj-$(CONFIG_SENSORS_SCH56XX_COMMON)+= sch56xx-common.o
obj-$(CONFIG_SENSORS_SCH5627) += sch5627.o
diff --git a/drivers/hwmon/raspberrypi-pmic-hwmon.c b/drivers/hwmon/raspberrypi-pmic-hwmon.c
new file mode 100644
index 000000000000..cb6ddb5b7d4f
--- /dev/null
+++ b/drivers/hwmon/raspberrypi-pmic-hwmon.c
@@ -0,0 +1,296 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Raspberry Pi 5 PMIC hwmon driver
+ *
+ * Reads voltages, currents and temperatures through the VideoCore
+ * firmware mailbox property
+ */
+
+#include <linux/device.h>
+#include <linux/err.h>
+#include <linux/hwmon.h>
+#include <linux/jiffies.h>
+#include <linux/module.h>
+#include <linux/platform_device.h>
+#include <linux/slab.h>
+#include <soc/bcm2835/raspberrypi-firmware.h>
+
+#define RPI_PMIC_NUM_CHANNELS 35 /* 0..34 */
+#define RPI_PMIC_CACHE_MS 500
+
+struct rpi_pmic_data {
+ struct rpi_firmware *fw;
+ u32 values[RPI_PMIC_NUM_CHANNELS];
+ u64 last_update;
+};
+
+struct rpi_pmic_adc_msg {
+ __le32 index;
+ __le32 length;
+ __le32 values[RPI_PMIC_NUM_CHANNELS];
+} __packed;
+
+static const char * const rpi_pmic_labels[RPI_PMIC_NUM_CHANNELS] = {
+ /* Currents 0-7 */
+ [0] = "3V7_WL_SW",
+ [1] = "3V3_SYS",
+ [2] = "1V8_SYS",
+ [3] = "DDR_VDD2",
+ [4] = "DDR_VDDQ",
+ [5] = "1V1_SYS",
+ [6] = "0V8_SW",
+ [7] = "VDD_CORE",
+ /* Voltages 8-15 */
+ [8] = "3V7_WL_SW",
+ [9] = "3V3_SYS",
+ [10] = "1V8_SYS",
+ [11] = "DDR_VDD2",
+ [12] = "DDR_VDDQ",
+ [13] = "1V1_SYS",
+ [14] = "0V8_SW",
+ [15] = "VDD_CORE",
+ /* More currents / voltages */
+ [16] = "0V8_AON",
+ [17] = "3V3_DAC",
+ [18] = "3V3_ADC",
+ [19] = "0V8_AON",
+ [20] = "3V3_DAC",
+ [21] = "3V3_ADC",
+ [22] = "HDMI",
+ [23] = "HDMI",
+ [24] = "EXT5V",
+ [25] = "BATT",
+ /* Temperatures 26-34 (µ°C) */
+ [26] = "TEMP1",
+ [27] = "TEMP2",
+ [28] = "TEMP3",
+ [29] = "TEMP4",
+ [30] = "TEMP5",
+ [31] = "TEMP6",
+ [32] = "TEMP7",
+ [33] = "TEMP8",
+ [34] = "TEMP_BG",
+};
+
+/* Firmware ADC indices for each hwmon channel */
+static const u8 rpi_pmic_curr_idx[] = {
+ 0, 1, 2, 3, 4, 5, 6, 7, 16, 17, 18, 22
+};
+
+static const u8 rpi_pmic_in_idx[] = {
+ 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 21, 23, 24, 25
+};
+
+static const u8 rpi_pmic_temp_idx[] = {
+ 26, 27, 28, 29, 30, 31, 32, 33, 34
+};
+
+static int rpi_pmic_update(struct rpi_pmic_data *data)
+{
+ struct rpi_pmic_adc_msg msg = {
+ .index = cpu_to_le32(0),
+ .length = cpu_to_le32(RPI_PMIC_NUM_CHANNELS),
+ };
+ int ret;
+ unsigned int i;
+
+ ret = rpi_firmware_property(data->fw, RPI_FIRMWARE_GET_PMIC_ADC,
+ &msg, sizeof(msg));
+ if (ret)
+ return ret;
+
+ /* Sanity-check the response */
+ if (le32_to_cpu(msg.length) != RPI_PMIC_NUM_CHANNELS)
+ return -EIO;
+
+ for (i = 0; i < RPI_PMIC_NUM_CHANNELS; i++)
+ data->values[i] = le32_to_cpu(msg.values[i]);
+
+ data->last_update = get_jiffies_64();
+ return 0;
+}
+
+static int rpi_pmic_read(struct device *dev, enum hwmon_sensor_types type,
+ u32 attr, int channel, long *val)
+{
+ struct rpi_pmic_data *data = dev_get_drvdata(dev);
+ int ret = 0;
+
+ if (time_after64(get_jiffies_64(),
+ data->last_update + msecs_to_jiffies(RPI_PMIC_CACHE_MS))) {
+ ret = rpi_pmic_update(data);
+ if (ret)
+ goto out;
+ }
+
+ switch (type) {
+ case hwmon_in:
+ *val = data->values[rpi_pmic_in_idx[channel]] / 1000; /* µV → mV */
+ break;
+ case hwmon_curr:
+ *val = data->values[rpi_pmic_curr_idx[channel]] / 1000; /* µA → mA */
+ break;
+ case hwmon_temp:
+ *val = data->values[rpi_pmic_temp_idx[channel]] / 1000; /* µ°C → m°C */
+ break;
+ default:
+ ret = -EOPNOTSUPP;
+ }
+
+out:
+ return ret;
+}
+
+static int rpi_pmic_read_string(struct device *dev,
+ enum hwmon_sensor_types type, u32 attr,
+ int channel, const char **str)
+{
+ size_t idx;
+
+ switch (type) {
+ case hwmon_in:
+ idx = rpi_pmic_in_idx[channel];
+ break;
+ case hwmon_curr:
+ idx = rpi_pmic_curr_idx[channel];
+ break;
+ case hwmon_temp:
+ idx = rpi_pmic_temp_idx[channel];
+ break;
+ default:
+ return -EOPNOTSUPP;
+ }
+
+ *str = rpi_pmic_labels[idx];
+ return 0;
+}
+
+static umode_t rpi_pmic_is_visible(const void *data,
+ enum hwmon_sensor_types type,
+ u32 attr, int channel)
+{
+ switch (type) {
+ case hwmon_in:
+ if (channel < ARRAY_SIZE(rpi_pmic_in_idx) &&
+ (attr == hwmon_in_input || attr == hwmon_in_label))
+ return 0444;
+ break;
+ case hwmon_curr:
+ if (channel < ARRAY_SIZE(rpi_pmic_curr_idx) &&
+ (attr == hwmon_curr_input || attr == hwmon_curr_label))
+ return 0444;
+ break;
+ case hwmon_temp:
+ if (channel < ARRAY_SIZE(rpi_pmic_temp_idx) &&
+ (attr == hwmon_temp_input || attr == hwmon_temp_label))
+ return 0444;
+ break;
+ default:
+ break;
+ }
+ return 0;
+}
+
+static const struct hwmon_ops rpi_pmic_ops = {
+ .is_visible = rpi_pmic_is_visible,
+ .read = rpi_pmic_read,
+ .read_string = rpi_pmic_read_string,
+};
+
+static const struct hwmon_channel_info * const rpi_pmic_info[] = {
+ HWMON_CHANNEL_INFO(in,
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 8 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 9 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 10 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 11 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 12 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 13 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 14 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 15 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 19 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 20 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 21 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 23 */
+ HWMON_I_INPUT | HWMON_I_LABEL, /* 24 */
+ HWMON_I_INPUT | HWMON_I_LABEL /* 25 */
+ ),
+ HWMON_CHANNEL_INFO(curr,
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 0 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 1 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 2 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 3 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 4 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 5 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 6 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 7 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 16 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 17 */
+ HWMON_C_INPUT | HWMON_C_LABEL, /* 18 */
+ HWMON_C_INPUT | HWMON_C_LABEL /* 22 */
+ ),
+ HWMON_CHANNEL_INFO(temp,
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 26 TEMP1 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 27 TEMP2 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 28 TEMP3 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 29 TEMP4 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 30 TEMP5 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 31 TEMP6 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 32 TEMP7 */
+ HWMON_T_INPUT | HWMON_T_LABEL, /* 33 TEMP8 */
+ HWMON_T_INPUT | HWMON_T_LABEL /* 34 TEMP_BG */
+ ),
+ NULL
+};
+
+static const struct hwmon_chip_info rpi_pmic_chip_info = {
+ .ops = &rpi_pmic_ops,
+ .info = rpi_pmic_info,
+};
+
+static int rpi_pmic_probe(struct platform_device *pdev)
+{
+ struct device *dev = &pdev->dev;
+ struct rpi_pmic_data *data;
+ struct rpi_firmware *fw;
+ struct device *hwmon_dev;
+ int ret;
+
+ fw = devm_rpi_firmware_get(dev, dev->parent->of_node);
+ if (!fw)
+ return -EPROBE_DEFER;
+
+ data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
+ if (!data)
+ return -ENOMEM;
+
+ data->fw = fw;
+
+ ret = rpi_pmic_update(data);
+ if (ret)
+ return -ENODEV;
+
+ hwmon_dev =
+ devm_hwmon_device_register_with_info(dev,
+ "rpi-pmic", data, &rpi_pmic_chip_info, NULL);
+
+ return PTR_ERR_OR_ZERO(hwmon_dev);
+}
+
+static const struct platform_device_id rpi_pmic_id[] = {
+ { "raspberrypi-pmic-hwmon", },
+ { }
+};
+MODULE_DEVICE_TABLE(platform, rpi_pmic_id);
+
+static struct platform_driver rpi_pmic_driver = {
+ .probe = rpi_pmic_probe,
+ .driver = {
+ .name = "raspberrypi-pmic-hwmon",
+ },
+ .id_table = rpi_pmic_id,
+};
+module_platform_driver(rpi_pmic_driver);
+
+MODULE_AUTHOR("Sander Speetjens <sander.speetjens@gmail.com>");
+MODULE_DESCRIPTION("Raspberry Pi 5 PMIC hwmon driver");
+MODULE_LICENSE("GPL");
diff --git a/include/soc/bcm2835/raspberrypi-firmware.h b/include/soc/bcm2835/raspberrypi-firmware.h
index 20141eb2cb67..90d7b66b96e3 100644
--- a/include/soc/bcm2835/raspberrypi-firmware.h
+++ b/include/soc/bcm2835/raspberrypi-firmware.h
@@ -84,6 +84,7 @@ enum rpi_firmware_property_tag {
RPI_FIRMWARE_GET_REBOOT_FLAGS = 0x00030064,
RPI_FIRMWARE_NOTIFY_DISPLAY_DONE = 0x00030066,
RPI_FIRMWARE_GET_RTC_REG = 0x00030087,
+ RPI_FIRMWARE_GET_PMIC_ADC = 0x0003009f,
RPI_FIRMWARE_SET_CLOCK_STATE = 0x00038001,
RPI_FIRMWARE_SET_CLOCK_RATE = 0x00038002,
RPI_FIRMWARE_SET_VOLTAGE = 0x00038003,
--
2.56.1
^ permalink raw reply related [flat|nested] 5+ messages in thread