ADC接口
=======

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

作者：金艺

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

Air720UG/UH模块内置两路通用ADC，可以用来做电池电压检测，温湿度检测，TDS检测等应用。ADC精度为12bit，测量输入范围为0到VBAT电压。若测量的电压输入范围大于模块的VBAT电压则需要进行分压后再输入ADC。

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

注意：

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

1. AT版本不支持ADC功能。

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

2.如果ADC的输入电压超过VBAT电压，测试出的值不准确，所以一定要确认ADC的输入范围

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

3.模块内部集成模块VBAT供电电压的检测ADC，LUAT开发方式下只需要调用misc.getVbatt()获取电压值，单位mV。无需要再用外部ADC检测。

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-left:21.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

4.
ADC原始测量数据的值是电压值（单位mv）的三分之一，例如电压值是4200mv，则ADC值为1400

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

ADC管脚定义

.. raw:: html

   </p>

.. raw:: html

   <table style="margin-left:26.7pt;border-collapse:collapse;mso-yfti-tbllook:1184;
    mso-padding-alt:0cm 0cm 0cm 0cm" border="0" cellspacing="0" cellpadding="0">

.. raw:: html

   <tbody>

.. raw:: html

   <tr style="mso-yfti-irow:0;mso-yfti-firstrow:yes;height:22.7pt">

.. raw:: html

   <td width="66" valign="top" style="width:49.6pt;border:solid windowtext 1.0pt;
     background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

接口

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="132" valign="top" style="width:99.2pt;border:solid windowtext 1.0pt;
     border-left:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

名称

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="95" valign="top" style="width:70.9pt;border:solid windowtext 1.0pt;
     border-left:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

管脚

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="350" valign="top" style="width:262.25pt;border:solid windowtext 1.0pt;
     border-left:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

作用

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:1;height:22.7pt">

.. raw:: html

   <td width="66" style="width:49.6pt;border:solid windowtext 1.0pt;
     border-top:none;padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt" rowspan="2">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

ADC

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="132" style="width:99.2pt;border-top:none;border-left:none;
     border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

ADC2

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="95" style="width:70.9pt;border-top:none;border-left:none;border-bottom:
     solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:0cm 5.4pt 0cm 5.4pt;
     height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

45

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="350" valign="top" style="width:262.25pt;border-top:none;border-left:
     none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

数模转换输入

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:2;mso-yfti-lastrow:yes;height:22.7pt">

.. raw:: html

   <td width="132" style="width:99.2pt;border-top:none;border-left:none;
     border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

ADC3

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="95" style="width:70.9pt;border-top:none;border-left:none;border-bottom:
     solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:0cm 5.4pt 0cm 5.4pt;
     height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

44

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="350" valign="top" style="width:262.25pt;border-top:none;border-left:
     none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:22.7pt">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

数模转换输入

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   </tbody>

.. raw:: html

   </table>

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
   mso-pagination:widow-orphan">

       
ADC相关接口：详细请参考script_LuaTask_Vx.x.x:raw-latex:`\demo`:raw-latex:`\adc`

.. raw:: html

   </p>

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

lua打开ADC接口

.. raw:: html

   </p>

.. raw:: html

   <table style="margin-left:26.7pt;border-collapse:collapse;mso-yfti-tbllook:1184;
    mso-padding-alt:0cm 0cm 0cm 0cm" border="0" cellspacing="0" cellpadding="0">

.. raw:: html

   <tbody>

.. raw:: html

   <tr style="mso-yfti-irow:0;mso-yfti-firstrow:yes;height:32.15pt">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     background:#92CDDC;padding:0cm 5.4pt 0cm 5.4pt;height:32.15pt">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

adc.open()

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border:solid windowtext 1.0pt;
     border-left:none;background:#92CDDC;padding:0cm 5.4pt 0cm 5.4pt;height:32.15pt" colspan="2">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

打开对应ID的通道

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:1">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     border-top:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt">

.. raw:: html

   <p align="center" style="margin-bottom:12.0pt;text-align:center;
     mso-pagination:widow-orphan">

语法

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border-top:none;
     border-left:none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt" colspan="2">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

result = adc.open( id )

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:2;height:3.65pt">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     border-top:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt;height:3.65pt">

.. raw:: html

   <p align="center" style="margin-bottom:12.0pt;text-align:center;
     mso-pagination:widow-orphan">

参数

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="95" valign="top" style="width:71.6pt;border-top:none;border-left:none;
     border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:3.65pt">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

id

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="415" valign="top" style="width:310.95pt;border-top:none;border-left:
     none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:3.65pt">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

number，adc通道，仅支持2和3，2对应adc0，3对应adc1

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:3;mso-yfti-lastrow:yes">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     border-top:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt">

.. raw:: html

   <p align="center" style="margin-bottom:12.0pt;text-align:center;
     mso-pagination:widow-orphan">

返回值

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border-top:none;
     border-left:none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt" colspan="2">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

1:成功 ；0：其他

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   </tbody>

.. raw:: html

   </table>

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
   text-indent:21.0pt;mso-pagination:widow-orphan">

lua ADC读接口

.. raw:: html

   </p>

.. raw:: html

   <table style="margin-left:26.7pt;border-collapse:collapse;mso-yfti-tbllook:1184;
    mso-padding-alt:0cm 0cm 0cm 0cm" border="0" cellspacing="0" cellpadding="0">

.. raw:: html

   <tbody>

.. raw:: html

   <tr style="mso-yfti-irow:0;mso-yfti-firstrow:yes;height:32.15pt">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     background:#92CDDC;padding:0cm 5.4pt 0cm 5.4pt;height:32.15pt">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

adc.read()

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border:solid windowtext 1.0pt;
     border-left:none;background:#92CDDC;padding:0cm 5.4pt 0cm 5.4pt;height:32.15pt" colspan="2">

.. raw:: html

   <p align="left" style="margin-bottom:12.0pt;text-align:left;
     mso-pagination:widow-orphan">

读取原始测量数据和电压值，电压值单位为mv

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:1">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     border-top:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt">

.. raw:: html

   <p align="center" style="margin-bottom:12.0pt;text-align:center;
     mso-pagination:widow-orphan">

语法

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border-top:none;
     border-left:none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt" colspan="2">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

adcValue,voltValue = adc.read( id )

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:2;height:3.65pt">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     border-top:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt;height:3.65pt">

.. raw:: html

   <p align="center" style="margin-bottom:12.0pt;text-align:center;
     mso-pagination:widow-orphan">

参数

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="95" valign="top" style="width:71.6pt;border-top:none;border-left:none;
     border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:3.65pt">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

id

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="415" valign="top" style="width:310.95pt;border-top:none;border-left:
     none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt;height:3.65pt">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

number，adc通道，仅支持2和3，2对应adc0，3对应adc1

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:3">

.. raw:: html

   <td width="141" valign="top" style="width:105.55pt;border:solid windowtext 1.0pt;
     border-top:none;background:#CCCCCC;padding:0cm 5.4pt 0cm 5.4pt" rowspan="2">

.. raw:: html

   <p align="center" style="margin-bottom:12.0pt;text-align:center;
     mso-pagination:widow-orphan">

返回值

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border-top:none;
     border-left:none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt" colspan="2">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

adcValue:原始数据ad值，无效值为0xFFFF

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   <tr style="mso-yfti-irow:4;mso-yfti-lastrow:yes">

.. raw:: html

   <td width="510" valign="top" style="width:382.55pt;border-top:none;
     border-left:none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
     padding:0cm 5.4pt 0cm 5.4pt" colspan="2">

.. raw:: html

   <p style="margin-bottom:12.0pt;mso-pagination:widow-orphan">

voltvalue:电压值，单位为mv，无效值为0xFFFF

.. raw:: html

   </p>

.. raw:: html

   </td>

.. raw:: html

   </tr>

.. raw:: html

   </tbody>

.. raw:: html

   </table>

.. raw:: html

   <p>

 

.. raw:: html

   </p>