# 工程名称：Adc_Dma_Demo

---
## 功能描述

本示例用于演示 MCAL Adc 模块的配置和使用:

- **Adc**: 
  - 本示例中ADC0配置了两个通道组，所有均配置为通过DMA传输结果。各通道组的详细信息如下：
  
|通道组名称|传输类型|触发类型|转换和访问模式|通道列表|
|----|----|----|----|----|
|AdcGroup0|DMA|软件|连续转换和单次访问|ADC0_SE0, ADC0_SE1, PMC VREF,TEMP,VREFH,PMC VREFH,ADC0_SE0|
|AdcGroup1|DMA|软件|连续转换和循环流访问|ADC0_SE0, ADC0_SE1|

复位后，初始化ADC模块，为所有通道组设置结果缓存区，为需要的通道组启用通知并启动所有通道组进行转换。各通道组的操作如下：
  - **AdcGroup0**：在while(1)中读取结果，读取结果后自动重新启动该通道组转换。
  - **AdcGroup0**：在回调通知中读取结果，读取结果后自动重新启动该通道组转换。
  - 对各通道组的SE0_ADCH0通道转换结果进行相互检查。

本示例代码定义了以下变量来观察采集结果和程序运行状态：
- **ADC转换结果变量**
  - `Adc_Group0An0PhyValue`：AdcGroup0中ADC0_SE0通道转换结果的物理值，单位为毫伏。
  - `Adc_Group0An1PhyValue`：AdcGroup0中ADC0_SE1通道转换结果的物理值，单位为毫伏。
  - `Adc_Group1An0PhyValue`：AdcGroup1中ADC0_SE0通道转换结果的物理值，单位为毫伏。
  - `Adc_Group1An1PhyValue`：AdcGroup1中ADC0_SE1通道转换结果的物理值，单位为毫伏。
  - `Adc_McuPmcVrefValue`：AdcGroup0中PMC VREF通道转换结果的物理值，单位为毫伏。
  - `Adc_McuVrefhValue`：AdcGroup0中VREFH通道转换结果的物理值，单位为毫伏。
- **转换次数计数变量**
  - `Adc_Group0ConCompCnt`：计数AdcGroup0完成的转换次数。
  - `Adc_Group1ConCompCnt`：计数AdcGroup1完成的转换次数。
  - `Adc_RstDiffOverFlowCnt`：程序检查ADC0通道0在不同通道组中的转换结果是否正确。具体来说，它将AdcGroup0的结果与AdcGroup1的结果进行比较。如果Group 0的结果与其他组的结果之间的差异超过100毫伏，则递增`Adc_RstDiffOverFlowCnt`变量。
- **预期每个通道的转换结果值**（VDD供电电压为5V）：

|通道|描述|预期值 (mV)|
|----|----|----|
|ADC0_SE0~ADC0_SE1|ADC0 外部输入通道 |外部输入值  |
|PMC VREF|PMC 1.2V参考电压  |1200  |
|VREFH|VREFH电压值|5000  |
|TEMP|MCU内部温度传感器  |不确定值，与环境温度相关|

**注意**：在本示例中，MCU使用5V供电。如果您需要使用3.3V供电，请自行修改该示例中ADC转换结果物理值的计算方式。

---


## 操作步骤

+ ***步骤1***：使用 YCT 工具打开示例的配置工程文件（`Adc_Dma_Demo.yct`），根据您的需求配置工具链（默认使用 VS Code + GCC）。
+ ***步骤2***：生成代码，如果需要，您可以更改配置（以适应您自己的硬件设计），如果这样做，请确保所有修改都正确无误，并且在生成代码之前没有错误存在。
+ ***步骤3***：根据您的配置，使用相应的工具（VS Code/IAR/Keil IDE）打开生成的工程。
+ ***步骤4***：编译生成的工程，打开 EVB 电源并通过可用的调试器（如 J-Link 调试探针）将编译好的可执行文件下载到 EVB。
+ ***步骤5***：调试、运行示例代码。
  
---


## 硬件需求
+ **EVB**: YTM32B1MD1-EVB-Q100-Rev.A/B
+ **调试器**: J-Link HW v9 或更高版本，安装了 YUNTU `YTM32B1MD1` 补丁（支持包）。

***注意***: 请确认EVB底部的版本号，如果是***YTM32B1MD1-EVB-Q100-Rev.A***，`Icu_Demo`请使用以`_RevA`结尾的样例工程。

---

## 软件需求

+ **配置和代码生成工具**
  + **MCAL**: Yuntu Config Tool(YCT) v2.7.0 或更高版本
+ **编译器工具链**
  + **GCC**: GNU GCC v10.3 或更高版本
  + **Keil/MDK**: ARM Keil/MDK v5.36 或更高版本(编译器推荐使用`armclang v6.18.2`)
  + **IAR**: IAR v9.50 或更高版本
  + **VS Code**: Microsoft Visual Studio Code IDE v1.76 或更高版本（需要 C/C++ 支持，GNU 工具链，CMake v3.25，ninja，Cortex-Debug 扩展安装）
+ **Debugger driver**
    + **J-Link**: SEGGER J-Link v7.82 或更高版本，需要安装 YUNTU `YTM32B1MD1` 补丁（支持包）。
    + **Ozone Debugger tool**: SEGGER Ozone v3.28 或更高版本。

    ***注意***: 需要安装 **YTM32B1MD1** 补丁，补丁可通过 **YCT** 工具或联系 ***云途 销售/FAE 团队***获取.

---