ADC设备用户开发指南

简介

本开发指南给用户提供了ADC的基本配置，工程构建编译、操作API介绍以及使用示例展示。

目录

• 简介
• 目录
• 配置指南
• ADC API介绍
• 使用示例

配置指南

以下配置均以万耦一代开发板（STML475）为例，STM32的ADC目前只支持单通道模式，即任意时刻只能访问获得一个通道的有效数据，其配置如下：

STM32CubeMX配置

打开oneos\projects\xxxxx(project文件夹)\board\CubeMX_Config下的STM32CubeMX工程文件,按照具体的需求进行配置。

ADC单通道模式下，可以开启多个ADC，如打开了三个ADC，按照ADC的名称进行注册，每个ADC可以配置开启多个通道，通道顺序号和配置一致，但是任意时刻只能访问一个通道，配置实际上是配置好对应的引脚的参数。 配置ADC通道，并配置ADC通道参数：

1. Analog标题下是模拟外设信息，选择ADC外设；
2. Mode标题下是通道信息，选择通道模式；
3. ADC_Setings需要根据实际使用进行配置；
4. ADC_Regular_ConversionMode等ADC通道配置参数不需要进行配置，实际使用时调用默认参数，修改需要在drv_adc.c的stm32_adc_get_channel_config函数中添加（STM32官方工具和ADC自身使用有限制导致）；
5. 右侧的芯片示意图上根据需要配置硬件引脚；

配置和生成工程

1. 点击Clock Configuration检查时钟配置，然后点击GENARATE CODE生成STM32CubeMX工程代码；

1. 在对应的oneos\projects\xxxxx(project文件夹) 目录下打开OneOS-Cube工具，在命令行输入menuconfig打开可视化配置界面；
2. 如下图示，通过空格或向右方向键选择 Top) → Drivers→ MISC 下的 Using ADC device drivers 选项；

Top) → Drivers→ MISC
                                      OneOS Configuration
[*] Using generic GPIO device drivers
[*] Using push button device drivers
[*] Using led device drivers
[ ] Using buzzer device drivers
[*] Using ADC device drivers
[ ] Using DAC device drivers
[ ] Using PWM device drivers
[ ] Using Input Capture device drivers
[ ] Using Pulse Encoder device drivers

1. 通过Esc退出配置界面，退出时选择保存。
2. 在命令行输入scons --ide=mdk5命令，构建工程；

工程编译及实现

1. 打开对应的oneos\projects\xxxxx(project文件夹)目录下的project.uvprojx工程文件；
2. 在工程中将原有或自己编写的adc test文件加入到application子文件夹中；
3. 编译并下载工程，运行程序；
4. 打开串口工具如xshell等，通信成功后，即可通过输入adc_sample指令获得相关的调试指令，根据提示和设置进行输入和ADC测试；
5. 通过硬件调节电压，即可观察到不断回读ADC采样电压值(电压值单位mv);

ADC API介绍

API 列表

API说明

os_device_find

该函数根据ADC设备名查找对应的ADC设备，函数原型如下：

os_device_t *os_device_find(const char *name);

os_device_open

该函数用于开启ADC设备，函数原型如下:

os_err_t os_device_open(os_device_t *dev);

os_device_control

该函数用于控制ADC设备通道开关，函数原型如下：

os_err_t os_device_control(os_device_t *dev, int cmd, void *arg);

os_device_read_nonblock

该函数用于以非阻塞方式读取ADC通道采样值（mV），函数原型如下：

os_size_t os_device_read_nonblock((os_device_t *dev, os_off_t pos, void *buffer, os_size_t size);

注：使用时需要用户自己保证通道参数正确，驱动不能判断是否为有效通道；

os_device_close

该函数用于关闭设备，函数原型如下：

os_err_t os_device_close(os_device_t *dev);

使用示例

ADC设备使用示例

本例读取ADC的数据，并输出。

/**
 ***********************************************************************************************************************
 * Copyright (c) 2020, China Mobile Communications Group Co.,Ltd.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with 
 * the License. You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations under the License.
 *
 * @file        adc_test.c
 *
 * @brief       The test file for adc.
 *
 * @revision
 * Date         Author          Notes
 * 2020-02-20   OneOS Team      First Version
 ***********************************************************************************************************************
 */

#include <drv_cfg.h>
#include <shell.h>
#include <stdlib.h>

int adc_sample(int argc, char **argv)
{
    os_uint32_t adc_channel;
    os_int32_t  adc_databuf;
    os_err_t    ret = OS_EOK;

    os_device_t *adc_dev;

    if (argc != 3)
    {
        os_kprintf("usage: adc_sample name  channel\r\n");
        os_kprintf("       adc_sample adc1     0\r\n");
        return -1;
    }

    /* find device */
    adc_dev = os_device_find(argv[1]);
    if (adc_dev == OS_NULL)
    {
        os_kprintf("adc device not find! \r\n");
        return -1;
    }
    adc_channel = strtol(argv[2], OS_NULL, 0);;
    /* open adc */
    os_device_open(adc_dev);
    ret = os_device_control(adc_dev, OS_ADC_CMD_ENABLE, OS_NULL);
    if (ret != OS_EOK)
    {
        os_kprintf("adc device cannot enable! \r\n");
        os_device_close(adc_dev);
        return -1;
    }

    for (int i = 0; i < 10;i++)
    {
        ret = os_device_read_nonblock(adc_dev, adc_channel, &adc_databuf, sizeof(adc_databuf));
        if (ret == sizeof(adc_databuf))
        {
            os_kprintf("%s channel %s voltage value: %d\r\n", argv[1] ,argv[2], adc_databuf);
        }
        os_task_msleep(100);
    }

    os_device_control(adc_dev, OS_ADC_CMD_DISABLE, OS_NULL);
    os_device_close(adc_dev);
    return ret;
}

SH_CMD_EXPORT(adc_sample, adc_sample, "test set adc");

运行结果如下：

sh />adc_sample adc1 1
adc1 channle 1 voltage value: 514
adc1 channle 1 voltage value: 1010