Files
mr-library/document/device/adc/adc.md
2024-02-02 16:38:44 +08:00

4.9 KiB
Raw Blame History

ADC设备

English

打开ADC设备

int mr_dev_open(const char *path, int flags);
参数 描述
path 设备路径
flags 打开设备的标志
返回值
>=0 设备描述符
<0 错误码
  • pathADC设备路径一般为adcxadc1adc2
  • flags:打开设备的标志,支持 MR_O_RDONLY

使用时应根据实际情况为不同的任务分别打开ADC设备并使用适当的flags进行管理和权限控制,以确保它们不会相互影响。

关闭ADC设备

int mr_dev_close(int desc);
参数 描述
desc 设备描述符
返回值
=0 关闭成功
<0 错误码

注:关闭设备时所有的通道都将被自动恢复到默认配置,重新打开后需要重新配置通道(可关闭此功能)。

控制ADC设备

int mr_dev_ioctl(int desc, int cmd, void *args);
参数 描述
desc 设备描述符
cmd 命令码
args 命令参数
返回值
=0 设置成功
<0 错误码
  • cmd:命令码,支持以下命令:
    • MR_IOC_ADC_SET_CHANNEL:设置通道编号。
    • MR_IOC_ADC_SET_CHANNEL_CONFIG:设置通道配置。
    • MR_IOC_ADC_GET_CHANNEL:获取通道编号。
    • MR_IOC_ADC_GET_CHANNEL_CONFIG:获取通道配置。

设置/获取通道编号

通道编号范围:0 ~ 31

/* 定义通道编号 */
#define CHANNEL_NUMBER                  5

/* 设置通道编号 */
mr_dev_ioctl(ds, MR_IOC_ADC_SET_CHANNEL, MR_MAKE_LOCAL(int, CHANNEL_NUMBER));

/* 获取通道编号 */
int number;
mr_dev_ioctl(ds, MR_IOC_ADC_GET_CHANNEL, &number);

不依赖ADC接口

/* 定义通道编号 */
#define CHANNEL_NUMBER                  5

/* 设置通道编号 */
mr_dev_ioctl(ds, MR_IOC_SPOS, MR_MAKE_LOCAL(int, CHANNEL_NUMBER));

/* 获取通道编号 */
int number;
mr_dev_ioctl(ds, MR_IOC_GPOS, &number);

设置/获取通道配置

通道配置:

  • MR_DISABLE:禁用通道。
  • MR_ENABLE:启用通道。
/* 设置通道配置 */
mr_dev_ioctl(ds, MR_IOC_ADC_SET_CHANNEL_CONFIG, MR_MAKE_LOCAL(int, MR_ENABLE));

/* 获取通道配置 */
int state;
mr_dev_ioctl(ds, MR_IOC_ADC_GET_CHANNEL_CONFIG, &state);

不依赖ADC接口

/* 设置通道配置 */
mr_dev_ioctl(ds, MR_IOC_SCFG, MR_MAKE_LOCAL(int, MR_ENABLE));

/* 获取通道配置 */
int state;
mr_dev_ioctl(ds, MR_IOC_GCFG, &state);

读取ADC设备通道值

ssize_t mr_dev_read(int desc, void *buf, size_t count);
参数 描述
desc 设备描述符
buf 读取数据缓冲区
count 读取数据大小
返回值
>=0 读取数据大小
<0 错误码
/* 读取通道值 */
uint32_t data;
int ret = mr_dev_read(ds, &data, sizeof(data));
/* 是否读取成功 */
if (ret != sizeof(data))
{
    return ret;
}

读取数据为ADC原始数据。单次读取最小单位为uint32_t即4个字节。

使用示例:

#include "include/mr_lib.h"

/* 定义通道编号 */
#define CHANNEL_NUMBER                  5

/* 定义ADC设备描述符 */
int adc_ds = -1;

void adc_init(void)
{
    int ret = MR_EOK;

    /* 初始化ADC */
    adc_ds = mr_dev_open("adc1", MR_O_RDONLY);
    if (adc_ds < 0)
    {
        mr_printf("ADC1 open failed: %s\r\n", mr_strerror(adc_ds));
        return;
    }
    /* 打印ADC描述符 */
    mr_printf("ADC1 desc: %d\r\n", adc_ds);
    /* 设置到通道5 */
    mr_dev_ioctl(adc_ds, MR_IOC_ADC_SET_CHANNEL, MR_MAKE_LOCAL(int, CHANNEL_NUMBER));
    /* 设置通道使能 */
    ret = mr_dev_ioctl(adc_ds, MR_IOC_ADC_SET_CHANNEL_CONFIG, MR_MAKE_LOCAL(int, MR_ENABLE));
    if (ret < 0)
    {
        mr_printf("Channel5 enable failed: %s\r\n", mr_strerror(ret));
    }
}
/* 导出到自动初始化APP级 */
MR_INIT_APP_EXPORT(adc_init);

int main(void)
{
    /* 自动初始化adc_init函数将在此处自动调用 */
    mr_auto_init();

    while(1)
    {
        uint32_t data;
        int ret = mr_dev_read(adc_ds, &data, sizeof(data));
        if (ret != sizeof(data))
        {
            mr_printf("Read failed: %s\r\n", mr_strerror(ret));
        }
        mr_printf("ADC value: %d\r\n", data);
        mr_delay_ms(1000);
    }
}

ADC1通道5使能间隔一秒读取一次ADC值并打印。