RK806是瑞芯微（Rockchip）推出的一款高性能電源管理IC（PMIC），廣泛應用于基于瑞芯微芯片的嵌入式設備中。其Linux驅動基于MFD（Multi-Function Device）框架開發，集成了電源鍵、電壓調節、中斷處理等核心功能。本文將從驅動架構、核心代碼、關鍵功能到實際擴展，全面解析RK806驅動的實現邏輯。

一、RK806驅動整體架構

RK806驅動采用Linux MFD框架設計，將PMIC的多個功能（如引腳控制、電源鍵、電壓調節器）拆分為獨立的子設備，核心特點如下：

?基于regmap管理寄存器讀寫，簡化底層硬件操作；

?通過reg_field抽象寄存器位段，降低位操作復雜度；

?基于中斷芯片（regmap_irq_chip）處理各類硬件中斷；

?支持設備樹（DT）配置，實現驅動參數的靈活定制；

?提供sysfs調試接口，方便寄存器讀寫調試。

驅動核心文件為rk806-core.c，整體流程可概括為：寄存器字段定義→設備初始化→子設備注冊→中斷初始化→功能配置。

二、核心代碼模塊解析

1.寄存器字段抽象：reg_field數組

RK806的寄存器操作是驅動的基礎，代碼中通過rk806_reg_fields數組定義了所有關鍵寄存器的位段映射，涵蓋：

?電源使能（BUCK/LDO的EN位）：如BUCK1_EN、NLDO1_EN等；

?電壓配置（ON/SLP模式電壓）：如BUCK1_ON_VSEL、PLDO3_SLP_VSEL等；

?中斷狀態/配置：如INT_POL、VB_LO_STS等；

?系統配置：如PWRON_ON_TIME（電源鍵開機延時）、DEV_OFF（設備關機）等。

示例代碼（電源使能位段）：

[BUCK1_EN] = REG_FIELD(0X00,0,0),  // 0x00寄存器的0位為BUCK1使能[NLDO1_EN] = REG_FIELD(0x03,0,0),  // 0x03寄存器的0位為NLDO1使能[DEV_OFF] = REG_FIELD(0x72,0,0),  // 0x72寄存器的0位為設備關機控制

通過regmap_field_read/write接口，可直接操作這些位段，無需手動計算寄存器偏移和掩碼，大幅簡化代碼。

2. MFD子設備注冊

RK806驅動通過mfd_cell數組注冊子設備，對應PMIC的不同功能模塊：

staticconststructmfd_cell rk806_cells[] = {  { .name ="rk806-pinctrl", },    // 引腳控制子設備  {    .name ="rk805-pwrkey",    // 電源鍵子設備    .num_resources = ARRAY_SIZE(rk806_pwrkey_resources),    .resources = &rk806_pwrkey_resources[0],  },  { .name ="rk806-regulator", },  // 電壓調節器子設備};

子設備通過devm_mfd_add_devices接口注冊，由MFD框架管理，實現功能解耦。

3.中斷處理機制

RK806的中斷包括電源鍵、低電壓（VB_LO）、VDC電壓變化等，驅動通過regmap_irq_chip實現中斷管理：

（1）中斷定義

staticconststructregmap_irq rk806_irqs[] = {  REGMAP_IRQ_REG(RK806_IRQ_PWRON_FALL,0, RK806_INT_STS_PWRON_FALL),  REGMAP_IRQ_REG(RK806_IRQ_VB_LO,0, RK806_INT_STS_VB_LO),  REGMAP_IRQ_REG(RK806_IRQ_VDC_RISE,0, RK806_INT_STS_VDC_RISE),};

（2）中斷初始化

ret = devm_regmap_add_irq_chip(rk806->dev,               rk806->regmap,               rk806->irq,               IRQF_ONESHOT | IRQF_SHARED,               0,               &rk806_irq_chip,               &rk806->irq_data);

（3）典型中斷處理

以低電壓（VB_LO）中斷為例，驅動實現了低電壓閾值配置和中斷注冊：

staticintrk806_low_power_irqs(structrk806 *rk806){ // 配置低電壓觸發方式為中斷 rk806_field_write(rk806, VB_LO_ACT, VB_LO_ACT_INT); // 配置低電壓閾值（2800~3500mV） rk806_field_write(rk806, VB_LO_SEL, (pdata->low_voltage_threshold -2800) /100); // 注冊中斷處理函數  ret =devm_request_threaded_irq(rk806->dev, vb_lo_irq,                 NULL, rk806_vb_low_irq,                  IRQF_TRIGGER_HIGH | IRQF_ONESHOT,                 "rk806_vb_low", rk806);}

4.設備初始化流程

rk806_device_init是驅動的核心初始化函數，流程如下：

1.分配寄存器字段映射（devm_regmap_field_alloc）；

2.讀取芯片ID/版本信息（CHIP_NAME_H/L、CHIP_VER）；

3.解析設備樹參數（rk806_parse_dt）：如低電壓閾值、關機電壓閾值、VDC喚醒使能等；

4.中斷初始化（rk806_irq_init）：配置中斷極性（如INT_POL為低電平有效）；

5.注冊中斷芯片和MFD子設備；

6.引腳控制初始化（rk806_pinctrl_init）；

7.低電壓/VDC中斷初始化（rk806_low_power_irqs/rk806_vdc_irqs_init）；

8.創建sysfs調試節點。

5.調試接口：sysfs節點

驅動提供了debugsysfs節點（對應rk806_master_attrs/rk806_slaver_attrs），支持讀寫寄存器：

?寫操作：echo w [addr] [value] > debug（寫入寄存器）；

?讀操作：echo r [addr] > debug（讀取寄存器）。

示例代碼（寫寄存器邏輯）：

case'w':  ret = sscanf(buf,"%c%x%x", &cmd, &input[0], &input[1]);  addr = input[0] &0xff;  data = input[1] &0xff;  regmap_write(rk806->regmap, addr, data);  regmap_read(rk806->regmap, addr, &data);//回讀驗證  pr_info("new:%x%xn", addr, data); break;

該接口可快速調試寄存器配置，無需修改驅動代碼，是開發/調試階段的重要工具。

三、關鍵功能擴展：電源鍵3秒檢測邏輯

在嵌入式設備中，常需實現“電源鍵長按3秒開機/短按關機”的邏輯，代碼中注釋的rk806_check_pwrkey_3s函數正是該需求的實現，核心思路：

1.循環檢測PWRON_STS（電源鍵狀態），每100ms檢測一次，累計3秒；

2.若中途檢測到按鍵松開，觸發硬件關機（寫入DEV_OFF字段）；

3.若3秒內按鍵持續按下，配置開機參數并喚醒系統。

核心代碼實現：

staticintrk806_check_pwrkey_3s(structrk806 *rk806){ intcheck_count =0; intmax_check =30;// 30×100ms=3000ms intpwr_on_sts; while(check_count < max_check) {   // 讀取電源鍵狀態    pwr_on_sts = rk806_field_read(rk806, PWRON_STS);   if(pwr_on_sts 0)returnpwr_on_sts;   // 按鍵松開，觸發關機   if(pwr_on_sts ==1) {      dev_info(rk806->dev,"PWRON released, trigger shutdown...n");     returnrk806_field_write(rk806, DEV_OFF,0x01);    }    msleep(100);    check_count++;  } // 3秒長按，觸發開機  dev_info(rk806->dev,"PWRON pressed 3s, trigger boot...n");  rk806_field_write(rk806, PWRON_ON_TIME,0x00);// 配置開機延時500ms  pm_wakeup_dev_event(rk806->dev,5000,true);// 喚醒系統 return0;}

該邏輯可直接集成到rk806_device_init中，實現電源鍵的定制化操作。

四、實際應用與調試技巧

1.設備樹配置示例

RK806的參數可通過設備樹靈活配置，無需修改驅動代碼：

rk806: pmic@0{  compatible ="rockchip,rk806";  low_voltage_threshold = <3000>;//低電壓閾值3000mV  shutdown_voltage_threshold = <2700>;//關機電壓閾值2700mV  vdc-wakeup-enable;//使能VDC電壓變化喚醒  pwron-on-time-500ms;//電源鍵開機延時500ms};

驅動通過device_property_read_u32解析這些參數，適配不同硬件需求。

2.調試技巧

?讀取芯片版本：通過CHIP_NAME_H/L和CHIP_VER字段，確認芯片型號和版本；

?調試寄存器：使用sysfs的debug節點讀寫寄存器，驗證配置是否生效；

?中斷調試：通過cat /proc/interrupts查看中斷觸發次數，確認中斷是否正常；

?電源鍵狀態：讀取PWRON_STS字段，確認按鍵狀態是否正確識別。

五、總結

RK806驅動是典型的MFD框架應用，其設計思路對PMIC驅動開發具有重要參考意義：

1.采用regmap和reg_field抽象寄存器操作，降低硬件耦合；

2.基于MFD框架拆分功能模塊，提高代碼可維護性；

3.充分利用設備樹，實現驅動參數的靈活配置；

4.提供完善的調試接口，降低開發/調試成本。

5.這個邏輯移植到uboot下效果會更好

無論是基礎的電壓配置、中斷處理，還是定制化的電源鍵邏輯，RK806驅動都提供了清晰的實現思路。掌握該驅動的核心邏輯，可快速適配瑞芯微平臺的PMIC定制需求，也為其他品牌PMIC驅動開發提供參考。