发新帖我要提问
返回列表
打印
[技术讨论]

全志R128 SDK HAL 模块开发指南——PMU

[复制链接]
652|0
手机看帖
扫描二维码
随时随地手机跟帖
跳转到指定楼层
楼主
神棍地海棠|  楼主 | 2024-4-12 10:05 | 只看该作者 回帖奖励 |倒序浏览 |阅读模式
128, 开发指南, sdk, sd, PMU
# PMU

PMU - 电源管理单元，负责系统各模块供电及电池充放电管理。

## 模块配置

regulator 相关配置项：

```
Drivers Options --->
    soc related device drivers --->
        REGULATOR Devices --->
            [*] enable regulator driver
            [*] regulator test
```

power 相关配置项：

```
Drivers Options --->
    soc related device drivers --->
        POWER Devices --->
            [*] enable power driver
                [*] use axp2585
                [*] regulator test
```

## 源码结构介绍

```
lichee/rtos-hal/hal/source/power/
├── axp2585.c
├── axp2585.h
├── axp.c
├── axp_twi.c
├── ffs.h
├── Kconfig
├── Makefile
├── sun20iw2p1
│ └── core.c
└── type.h

lichee/rtos-hal/hal/source/regulator/
├── Kconfig
├── Makefile
└── sun20iw2p1
  └── core.c
```

## 模块接口说明

头文件：

```c
#include <sunxi_hal_power.h>
#include <sunxi_hal_regulator.h>
```

### regulator 相关结构体

```c
struct regulator_ops{
        int (*enable) (struct regulator_dev *);
        int (*disable) (struct regulator_dev *);
        int (*set_voltage) (struct regulator_dev *, int target_uV);
        int (*get_voltage) (struct regulator_dev *, int *vol_uV);
        int (*set_en) (struct regulator_dev *, unsigned int flags);
        int (*set_voltage_ext) (struct regulator_dev *, int target_uV, unsigned int status);
        int (*get_voltage_ext) (struct regulator_dev *, int *vol_uV,  unsigned int status);
};

struct regulator_dev{
        unsigned int flag;
        struct regulator_ops *ops;
        void *private;
};
```

### power 相关结构体

```c
struct power_dev{
        unsigned int flag;
        struct bat_power_ops *bat_ops;
        struct usb_power_ops *usb_ops;
        struct power_supply  *config;
        hal_sem_t irq_schd;
};
```

### regulator 获取电路接口

函数原型

```c
int hal_regulator_get(unsigned int request_flag, struct regulator_dev *rdev)
```

参数：

- rdev: 指定regulator的结构体
- request_flag: 指定regulator的电路参数

返回值：

- 成功：0
- 失败：‑1



### regulator 电路使能接口

函数原型

```c
int hal_regulator_set_able(struct regulator_dev *rdev, unsigned int flags)
```

参数：

- rdev: 指定regulator的结构体
- flags: 电路开关状态

返回值：

- 成功：0
- 失败：‑1



### regulator 获取电压接口

函数原型

```c
int hal_regulator_get_voltage_ext(struct regulator_dev *rdev, int *vol_uV, unsigned int status)
```

参数：

- rdev: 指定regulator的结构体
- vol_uV: 获取的电压信息
- status: 运行/休眠时的电压

返回值：

- 成功：0
- 失败：‑1



### regulator 调节电压接口

函数原型

```c
int hal_regulator_set_voltage_ext(struct regulator_dev *rdev, int target_uV, unsigned int status)
```

参数：

- rdev: 指定regulator的结构体
- target_uV: 指定调压信息
- status: 运行/休眠时的电压

返回值：

- 成功：0
- 失败：‑1



### power 初始化

函数原型

```c
int hal_power_init(void);
```

参数：

- 无

返回值：

- 成功：0
- 失败：‑1



### 获取当前 power 驱动

函数原型

```c
int hal_power_get(struct power_dev *rdev);
```

参数：

- rdev：初始化前的 power_dev 结构体

返回值：

- 0



### 获取电池电量信息

函数原型

```c
int hal_power_get_bat_cap(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 电池电量，[0‑100]
- 失败：‑1



### 获取库仑计信息

函数原型

```c
int hal_power_get_coulumb_counter(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：返回电流大小，单位mA
- 失败：‑1



### 查看电池当前状态

函数原型

```c
int hal_power_get_bat_present(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：电池有效返回1，否则返回0
- 失败：‑1



### 查看电池是否连接

函数原型

```c
int hal_power_get_bat_online(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：电池存在返回1，否则返回0
- 失败：‑1



### 获取电池充电状态

函数原型

```c
int hal_power_get_bat_status(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：返回电池的多种状态，[0] 未知状态；[1] 充电状态；[3] 连接单不充电；[4] 充满电。
- 失败：‑1



### 获取电池当前的健康状态

函数原型

```c
int hal_power_get_bat_health(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：返回1，电池健康
- 失败：‑1



### 获取电池电压

函数原型

```c
int hal_power_get_vbat(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：返回当前电压，单位mV
- 失败：‑1



### 获取充电电流

函数原型

```c
int hal_power_get_ibat(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：返回当前充电电流，单位mA
- 失败：‑1



### 获取放电电流

函数原型

```c
int hal_power_get_disibat(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：返回当前放电电流，单位mA
- 失败：‑1



### 获取 AXP IC 温度

函数原型

```c
int hal_power_get_temp(struct power_dev *rdev);
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：当前AXP IC 温度，单位为温度数值*10
- 失败：‑1



### 获取电池温度

函数原型

```c
int hal_power_get_temp_ambient(struct power_dev *rdev)
```

参数：

- 成功：当前电池温度，单位为温度数值*10

返回值：

- 失败：‑1



### 设置充电电流

函数原型

```c
int hal_power_set_chg_cur(struct power_dev *rdev, int cur)
```

参数：

- rdev：初始化后power_dev 结构体
- cur：充电电流大小，单位mA

返回值：

- 成功：0
- 失败：‑1



### 设置充电截止电压

函数原型

```c
int hal_power_set_chg_vol(struct power_dev *rdev, int vol)
```

参数：

- rdev：初始化后power_dev 结构体
- vol：充电截止电压，单位mV

返回值：

- 成功：0
- 失败：‑1



### 设置电池开关

函数原型

```c
int hal_power_set_batfet(struct power_dev *rdev, int onoff)
```

参数：

- rdev：初始化后power_dev 结构体
- onoff：电池开关，0 关闭电池与电路连接，1 打开连接

返回值：

- 成功：0
- 失败：‑1



### 获取当前USB 状态

函数原型

```c
int hal_power_get_usb_status(struct power_dev *rdev)
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：[1]USB 连接，有VBUS；[0] 无USB 连接，无VBUS
- 失败：‑1



### 获取USB 口输入限流值

函数原型

```c
int hal_power_get_usb_ihold(struct power_dev *rdev)
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：USB 口限流的电流值，单位mA
- 失败：‑1



### 获取USB 口输入限压值

函数原型

```c
int hal_power_get_usb_vhold(struct power_dev *rdev)
```

参数：

- rdev：初始化后power_dev 结构体

返回值：

- 成功：USB 口限压电流值，单位mV
- 失败：‑1



### 设置USB 口输入限流值

函数原型

```c
int hal_power_set_usb_ihold(struct power_dev *rdev, int cur)
```

参数：

- rdev：初始化后power_dev 结构体
- cur：USB 口限流的电流值，单位mA，范围[0‑3100]

返回值：

- 成功：0
- 失败：‑1



### 设置USB 口输入限压值

函数原型

```c
int hal_power_set_usb_vhold(struct power_dev *rdev, int vol)
```

参数：

- rdev：初始化后power_dev 结构体
- vol：USB 口输入限压值，单位mV，范围[3880mV~5080mV]

返回值：

- 成功：0
- 失败：‑1



## 模块使用范例

### regulator 模块使用范例

```c
#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>
#include <stddef.h>

#include <unistd.h>

#include <sunxi_hal_regulator.h>
#include <sunxi_hal_common.h>
#include <hal_cmd.h>
#include <hal_log.h>

#define SOC_PRCM_BASE                       (0x40050000)
#define SOC_PRCM_DCDC_CTRL0       (SOC_PRCM_BASE+0x0004)
#define SOC_PRCM_DCDC_CTRL1       (SOC_PRCM_BASE+0x0008)
#define SOC_PRCM_DCDC_LDO_MODE    (SOC_PRCM_BASE+0x000c)
#define SOC_PRCM_RTC_LDO_CTRL     (SOC_PRCM_BASE+0x0020)
#define SOC_PRCM_EXT_LDO_CTRL     (SOC_PRCM_BASE+0x0024)
#define SOC_PRCM_TOP_LDO_CTRL     (SOC_PRCM_BASE+0x0028)
#define SOC_PRCM_AON_LDO_CTRL     (SOC_PRCM_BASE+0x0040)
#define SOC_PRCM_APP_LDO_CTRL     (SOC_PRCM_BASE+0x0044)
#define SOC_PRCM_DSP_LDO_CTRL     (SOC_PRCM_BASE+0x004c)

//test : rpccli arm hal_regulator_set_current_able

static int hal_regulator_regs_check(void)
{
        printf("[regulator] %x:%x\n", SOC_PRCM_DCDC_CTRL0, readl(SOC_PRCM_DCDC_CTRL0));
        printf("[regulator] %x:%x\n", SOC_PRCM_DCDC_CTRL1, readl(SOC_PRCM_DCDC_CTRL1));
        printf("[regulator] %x:%x\n", SOC_PRCM_DCDC_LDO_MODE, readl(SOC_PRCM_DCDC_LDO_MODE));
        printf("[regulator] %x:%x\n", SOC_PRCM_RTC_LDO_CTRL, readl(SOC_PRCM_RTC_LDO_CTRL));
        printf("[regulator] %x:%x\n", SOC_PRCM_EXT_LDO_CTRL, readl(SOC_PRCM_EXT_LDO_CTRL));
        printf("[regulator] %x:%x\n", SOC_PRCM_TOP_LDO_CTRL, readl(SOC_PRCM_TOP_LDO_CTRL));
        printf("[regulator] %x:%x\n", SOC_PRCM_AON_LDO_CTRL, readl(SOC_PRCM_AON_LDO_CTRL));
        printf("[regulator] %x:%x\n", SOC_PRCM_APP_LDO_CTRL, readl(SOC_PRCM_APP_LDO_CTRL));
        printf("[regulator] %x:%x\n", SOC_PRCM_DSP_LDO_CTRL, readl(SOC_PRCM_DSP_LDO_CTRL));
        return 0;
}

static int cmd_set_able(int argc, const char **argv)
{
        int ret;
        int id = SOC_ID_MAX;
        unsigned int flag = 0;
        struct regulator_dev regulator;
        if (argv[1])
                id = (int)*argv[1] - 48;
        if (argv[2])
                flag = (int)*argv[2] - 48;
        printf("[regulator] set regulator_en[%d]:%x, flage:%d\n", id, REGULATOR_GET(SOC_REGULATOR, id), flag);
        hal_regulator_get(REGULATOR_GET(SOC_REGULATOR, id), &regulator);
        printf("[regulator] set_able regulator_en\n");
        hal_regulator_set_able(&regulator, flag);
        printf("[regulator] set_regulator[%d]able_status:%d\n", id, flag);
        hal_regulator_regs_check();
        return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_set_able, hal_regulator_set_current_able, regulator hal APIs tests)

static int cmd_get_voltage_ext(int argc, const char **argv)
{
        int ret;
        int id = SOC_ID_MAX;
        unsigned int flag = 0;
        struct regulator_dev regulator;
        if (argv[1])
                id = (int)*argv[1] - 48;
        if (argv[2])
                flag = (int)*argv[2] - 48;
        printf("[regulator] get regulator:%x\n", REGULATOR_GET(SOC_REGULATOR, id));
        hal_regulator_get(REGULATOR_GET(SOC_REGULATOR, id), &regulator);
        printf("[regulator] cat check_dedc_status\n");
        hal_regulator_get_voltage_ext(&regulator, &ret, flag);
        printf("[regulator] get_regulator[%d]status[%d]voltage:%d\n", id, flag, ret);
        hal_regulator_regs_check();
        return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_get_voltage_ext, hal_regulator_get_voltage, regulator hal APIs tests)

static int cmd_set_voltage_ext(int argc, const char **argv)
{
        int ret[4] = {0};
        int ret1;
        int id = SOC_ID_MAX;
        unsigned int flag = 0;
        struct regulator_dev regulator;
        if (argv[1])
                id = (int)*argv[1] - 48;
        if (argv[2])
                flag = (int)*argv[2] - 48;
        if (argv[3])
                ret[0] = ((int)*argv[3] - 48) * 1000;
        if (argv[4])
                ret[1] = ((int)*argv[4] - 48) * 100;
        if (argv[5])
                ret[2] = ((int)*argv[5] - 48) * 10;
        if (argv[6])
                ret[3] = ((int)*argv[6] - 48) * 1;
        ret1 = (ret[0] + ret[1] + ret[2] + ret[3]) * 1000;
        printf("[regulator] set regulator:%x\n", REGULATOR_GET(SOC_REGULATOR, id));
        hal_regulator_get(REGULATOR_GET(SOC_REGULATOR, id), &regulator);
        printf("[regulator] set_regulator[%d]status[%d]voltage:%d\n", id, flag, ret1);
        hal_regulator_set_voltage_ext(&regulator, ret1, flag);
        printf("[regulator] finishe-set_regulator[%d]status[%d]voltage:%d\n", id, flag, ret1);
        hal_regulator_regs_check();
        return 0;
}

FINSH_FUNCTION_EXPORT_CMD(cmd_set_voltage_ext, hal_regulator_set_voltage, regulator hal APIs tests)
```

### power 模块使用范例

```c
#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>

#include <sunxi_hal_power.h>
#include <hal_cmd.h>
#include <hal_log.h>

static int cmd_test_power_get_bat(int argc, const char **argv)
{
        int ret;
        struct power_dev rdev;
        printf("[power] get power\n");
        hal_power_get(&rdev);

        printf("[power] get bat cap\n");
        ret = hal_power_get_bat_cap(&rdev);
        printf("[power] bat cap:%d\n", ret);

        printf("[power] get_coulumb_counter\n");
        ret = hal_power_get_coulumb_counter(&rdev);
        printf("[power] coulumb_counter:%d\n", ret);

        printf("[power] get bat_present\n");
        pr_err("pmu_bat_unused:%d\n", rdev.config->pmu_bat_unused);
        pr_err("pmu_version:%d\n", rdev.config->pmu_version);
        ret = hal_power_get_bat_present(&rdev);
        printf("[power] bat_present:%d\n", ret);

        printf("[power] get online\n");
        ret = hal_power_get_bat_online(&rdev);
        printf("[power] bat online:%d\n", ret);

        printf("[power] get status\n");
        ret = hal_power_get_bat_status(&rdev);
        printf("[power] bat status:%d\n", ret);

        printf("[power] get bat health\n");
        ret = hal_power_get_bat_health(&rdev);
        printf("[power] bat health:%d\n", ret);

        printf("[power] get vbat\n");
        ret = hal_power_get_vbat(&rdev);
        printf("[power] bat vbat:%d\n", ret);

        printf("[power] get ibat\n");
        ret = hal_power_get_ibat(&rdev);
        printf("[power] bat ibat:%d\n", ret);

        printf("[power] get disibat\n");
        ret = hal_power_get_disibat(&rdev);
        printf("[power] bat disibat:%d\n", ret);

        printf("[power] get temp\n");
        ret = hal_power_get_temp(&rdev);
        printf("[power] bat temp:%d\n", ret);

        printf("[power] bat get test finish\n");
        return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_test_power_get_bat, test_power_get_bat, power hal APIs tests)

static int cmd_test_power_set_bat(int argc, const char **argv)
{
        int ret;
        struct power_dev rdev;
    int cur = strtol(argv[1], NULL, 0);
    int vol = strtol(argv[2], NULL, 0);

        printf("[power] set bat power:cur:%d vol:%d\n", cur, vol);
        hal_power_get(&rdev);

        printf("[power] set bat cur:%d\n", cur);
        ret = hal_power_set_chg_cur(&rdev, cur);
        printf("[power] chg_cur:%d\n", ret);

        printf("[power] set bat vol:%d\n", vol);
        ret = hal_power_set_chg_vol(&rdev, vol);
        printf("[power] _chg_vol:%d\n", ret);

        printf("[power] bat set test finish\n");
        return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_test_power_set_bat, test_power_set_bat, power hal APIs tests)

static int cmd_test_power_get_usb(int argc, const char **argv)
{
        int ret;
        struct power_dev rdev;
        printf("[power] get power\n");
        hal_power_get(&rdev);

        printf("[power] get usb_status\n");
        ret = hal_power_get_usb_status(&rdev);
        printf("[power] usb_status:%d\n", ret);

        printf("[power] usb_ihold\n");
        ret = hal_power_get_usb_ihold(&rdev);
        printf("[power] usb_ihold:%d\n", ret);

        printf("[power] get usb_vhold\n");
        ret = hal_power_get_usb_vhold(&rdev);
        printf("[power] usb_vhold:%d\n", ret);

        printf("[power] get cc_status\n");
        ret = hal_power_get_cc_status(&rdev);
        printf("[power] cc_status:%d\n", ret);

        printf("[power] usb get test finish\n");
        return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_test_power_get_usb, test_power_get_usb, power hal APIs tests)

static int cmd_test_power_set_usb(int argc, const char **argv)
{
        int ret;
        struct power_dev rdev;
    int cur = strtol(argv[1], NULL, 0);
    int vol = strtol(argv[2], NULL, 0);

        printf("[power] set usb power:cur:%d vol:%d\n", cur, vol);
        hal_power_get(&rdev);

        printf("[power] set usb_ihold:%d\n", cur);
        ret = hal_power_set_usb_ihold(&rdev, cur);
        printf("[power] usb_ihold:%d\n", ret);

        printf("[power] set usb_vhold:%d\n", vol);
        ret = hal_power_set_usb_vhold(&rdev, vol);
        printf("[power] usb_vhold:%d\n", ret);

        printf("[power] usb set test finish\n");
        return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_test_power_set_usb, test_power_set_usb, power hal APIs tests)
```


使用特权

评论回复 赏

相关下载

相关帖子

返回列表
发新帖 我要提问
高级模式
B Color Image Link Quote Code 收费 Smilies
您需要登录后才可以回帖 登录 | 注册

本版积分规则

神棍地海棠

262

主题

270

帖子

0

粉丝