ADC
一、模数转换(ADC)概述
1.1 ADC 简介
ADC 通常指模拟/数字转换器，是指将连续变量的模拟信号转换为离散的数字信号的器件。 合宙 Cat.1 模块 ADC 接口主要用来检测模拟电压信号量，用于电池电压检测，温湿度检测，TDS 检测等应用。
1.2 ADC 接口介绍
根据 Air700ECQ 产品手册内《 AirAir700ECQ_硬件设计手册_V1.3.3.pdf 》可知：
1. Air780E 内部 ADC 接口精度为 12bits 外部直流分压为 0-3.4V 2. Air780E 内部具有 2 个 ADC 接口，ADC0 -- AIO3 ADC1 -- AIO4 3. 两个特殊通道, CPU 内部温度 Temp -- adc.CH_CPU 主供电脚电压 VBAT -- adc.CH_VBAT
注意事项： 设置分压(adc.setRange)要在 adc.open 之前设置，否则无效!! Air780E 内部具有 2 个 ADC 接口，ADC0 和 ADC1，如下图红框所示：
1.3 输入电压的范围
Air780E 关闭分压后，量程范围 0~1.1V 注意：外接输入电压切记不可超过量程，否则有烧毁风险！！！
adc.setRange(adc.ADC_RANGE_1_2) -- Air780E 关闭 ADC0,1 分压电阻，范围 0~1.1V adc.setRange(adc.ADC_RANGE_3_8) -- Air780E 开启 ADC0,1 分压电阻，范围 0~3.2V
二、演示功能概述
本章节演示了 Air780E 内部 2 个 ADC 接口，以及 2 个特殊通道：CPU 内部温度 Temp -- adc.CH_CPU 主供电脚电压 VBAT -- adc.CH_VBAT 的使用教程。
1. 通过 adc.get()读取 ADC 的外部输入模拟电压，
注：启用分压后量程最高也只能到达3.2V，若想测量更高的外部电源电压，需要外接分压电阻，具体设计请参考ADC接口设计指导；本教程外部输入电压在3.2v以内，需要外部电源与模组共地，保持参考电压一致
2. 通过 adc.get(adc.CH_VBAT)读取供电电压 3. 通过 adc.get(adc.CH_CPU)读取 CPU 温度
三、准备硬件环境
3.1 Air700ECQ 开发板
使用 Air700ECQ 开发板，如下图所示：
淘宝购买链接：Air700ECQ 开发板淘宝购买链接 ；
此开发板的详细使用说明参考：Air700ECQ 产品手册 中的 《开发板EVB-Air700ECQ-IO使用手册VX.X.X.pdf》，写这篇文章时最新版本的使用说明为：开发板EVB-Air700ECQ-IO使用手册V1.0.0.pdf ；开发板使用过程中遇到任何问题，可以直接参考这份使用说明 pdf 文档。
3.2 数据通信线
USB 转 typeC 数据线一根。
3.3 PC 电脑
WIN10以及以上版本的WINDOWS系统。
3.4 直流稳压电源
合宙功耗分析仪 Air9000P，淘宝购买链接：Air9000P 淘宝购买链接 ；
四、准备软件环境
4.1 下载调试工具
使用说明参考：Luatools 下载和详细使用
4.2 源码及固件
1. 底层 core 固件下载地址：LuatOS 固件版本下载地址
下载之后，固件如下图所示：
2. 本教程使用的 demo：https://gitee.com/openLuat/LuatOS-Air700ECQ/tree/master/demo/adc
3. 源码和固件已打包，如下所示：
注：压缩包中 core 文件夹存放固件，code 文件夹存放 demo
五、模数转换(ADC)软硬件资料
5.1 API 接口介绍
本教程使用 api 接口为：adc - 模数转换 - LuatOS 文档
5.2 Air700ECQ 烧录说明
将 Air700ECQ 通过 usb 数据线连接电脑，如下图所示：
注：
1、按住下载模式按键（BOOT 键）不放，同时再长按开机键开机，这时开发板会进入下载模式，Luatools 下载进度条会开始跑，这时可以松开 BOOT 按键。直到工具提示下载完成。
2、如果，未能成功进入下载模式，而是进入正常开机模式，这时可以按住 BOOT 键，再短按复位按键，让开发板重启，重新进入下载模式。
如何判断有没有进入下载模式:可以通过 PC 端的设备管理器中虚拟出来的 USB 端口数量来判断。
正常开机模式：
下载模式：
六、代码示例介绍
6.1 读取 adc 外部输入模拟电压
6.1.1 代码介绍
adc.open()开启 ADC 后，通过 adc.get(1)获取 ADC1 的输入模拟电压值。
adc.setRange(adc.ADC_RANGE_3_8) -- 启用分压
if adc.open(1) then
log.info("adc", adc.get(1)) --单位为mv
end
6.1.2 运行结果展示
可以将 adc0/adc1 外接稳压电源供电，注意供电不可超过量程！（本示例启用分压后量程 0~3.2V)， 本示例将 adc1 输入 3V（电源正极接adc1，负极接GND）,查看 Luatools的 log 如下(返回值单位为 mV):
本示例中直流稳压电源使用合宙 Air9000P，淘宝购买链接：Air9000P 淘宝购买链接
6.2 读取供电电压
6.2.1 代码介绍
-- 读取VBAT供电电压, 单位为mV
adc.open(adc.CH_VBAT)
local vbat = adc.get(adc.CH_VBAT)
adc.close(adc.CH_VBAT)
6.2.2 运行结果展示
通过下图可以看到，VBAT 端供电电压为 4.1V
6.3 读取 CPU 温度
6.3.1 代码介绍
-- 读取CPU温度, 单位为0.001摄氏度, 是内部温度, 非环境温度
adc.open(adc.CH_CPU)
local temp = adc.get(adc.CH_CPU)
adc.close(adc.CH_CPU)
6.3.2 运行结果展示
通过下图可以看到，模组 CPU 温度为 34 摄氏度
七、总结
本教程简单举例了如何读取 adc 输入电压、读取供电电压、读取 CPU 温度，除此之外，adc 可以将各种连续变化的模拟信号（如温度、湿度、压力、电压、电流等）转换为离散的数字信号，本模块内部 ADC 精度 12bits,对许多应用已经足够，如温湿度传感器、压力传感器、音频信号处理等，然而对于需要更高精度的应用，可以外挂更高精度的 ADC,如 16 位，24 位等。使用过程中需注意量程范围，不可超出量程。
扩展
常见问题
1. 为什么 ADC 输入 3V，读取模拟电压只有 1.1V？
未启用分压时，量程最高只能到达 1.1V，若想测量 3V，需启用分压。
2. ADC 测量电压来回跳变，为什么？
看外部输入电压是否与模块共地，正常情况需要共地，保持参考电压一致。
3. adc.read()和 adc.get()要用哪一个？
adc.read()返回两个值，一个原始值,一般没用,可以直接抛弃；另一个是从原始值换算得出的实际值，通常单位是 mV。（仅作了解，不建议使用） adc.get()返回的就是计算值，通常单位是 mV，推荐使用这个接口来获取电压值。
<!-- ## 给读者的话
本篇文章由
王世豪开发；本篇文章描述的内容，如果有错误、细节缺失、细节不清晰或者其他任何问题，总之就是无法解决您遇到的问题；
请登录合宙技术交流论坛，点击文档找错赢奖金-Air700ECQ-LuatOS-软件指南-硬件驱动-ADC
用截图标注+文字描述的方式跟帖回复，记录清楚您发现的问题；
我们会迅速核实并且修改文档；
同时也会为您累计找错积分，您还可能赢取月度找错奖金！ -->