# 项目名称：Adc_PwmTrg_Demo

---
## 功能描述

本示例用于演示 MCAL PWM触发ADC转换的方法:

- **Adc**: 
  - 配置两个Group(Adc0_HwTrigGroup/Adc0_SwTrigGroup), 分别配置为硬件触发采集与软件触发采集模式, Adc0_SwTrigGroup配置为连续模式。 各通道组的详细信息如下：
  
|通道组名称|传输类型|触发类型|转换和访问模式|通道列表|
|----|----|----|----|----|
|Adc0_HwTrigGroup|中断|硬件|单次转换和单次访问|ADC0_SE0, ADC0_SE1, PMC VREF, TEMP, VREFH|
|Adc0_SwTrigGroup|中断|软件|连续转换和单次访问|ADC0_SE0, ADC0_SE1, PMC VREF, TEMP, VREFH|

- **Pwm**
  - 配置eTMR0_CH0输出2kHz 50% PWM波，并使能eTMR0 `PwmEtmrMidTrgEn`用于触发Adc0。

- **CddTrg**
  - 配置`TMU_TRIG_TARGET_ADC0_EXT_TRIG0`的触发源为`TMU_TRIG_SOURCE_eTMR0_EXT_TRIG`,同时配置`TMU_TRIG_TARGET_TMU_OUT4`用于观察触发信号。

- **Adc_PwmTrig_Demo硬件配置需求**
  | 功能 | MCU引脚 | EVB 插针|
  | ---- | ------- | ------ |
  | ADC0_SE0 | PTA0 | H4_4P |
  | ADC0_SE1 | PTA1 | H4_3P |
  | eTMR0_CH2 | PTC0 | H2_15P |
  | TMU_OUT4 | PTE10 | H1_6P |

 在该示例中Adc0_HwTrgGroup与Adc0_SwTrgGroup交替进行数据转化。MCU复位并完成初始化后，分别使能Adc0_HwTrgGroup、Adc0_SwTrgGroup以及PWM输出，硬件触发信号产生后，Adc先转换Adc0_HwTrgGroup，并在其完成的通知函数中，关闭Adc0_HwTrgGroup，将Adc硬件交还给Adc0_SwTrgGroup，Adc0_SwTrgGroup开始转换。Adc0_SwTrgGroup完成转换后再次使能Adc0_HwTrgGroup，此时Adc0_HwTrgGroup等待PWM触发信号，并在信号产生后开始转换，循环往复。在While(1)中检查两个Group的转换结果是否一致。

本示例代码定义了以下变量来观察采集结果和程序运行状态：
- **保存ADC转换结果的变量**
  - `Adc0_HwTrigGroupResultPhys`: 用于存储Adc0_HwTrgGroup的转换结果，单位为毫伏。
  - `Adc0_SwTrigGroupResultPhys`: 用于存储Adc0_SwTrigGroup的转换结果，单位为毫伏。 
- **计数转换次数的变量**
  - `Adc0_HwTrigGroupConCompCnt`: Adc0_HwTrgGroup完成转换次数计数。
  - `Adc0_SwTrigGroupConCompCnt`: Adc0_SwTrgGroup完成转换次数计数。
  - `Adc0_ResultNotMachCnt`: Adc0_HwTrgGroup与Adc0_SwTrgGroup在同一输入通道上的转换结果不匹配的次数。
- **各通道的转换结果预期值**（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_PwmTrg_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 团队***获取.

---