测试指南

测试环境

硬件
- 开发板
软件
- PC 端的串口终端软件，用于 PC 和开发板进行串口通信
- test_psadc 测试程序
软件配置
test_psadc 配置
在 Luban-Lite 根目录下执行 scons --menuconfig，进入 menuconfig 的功能配置界面，按如下选择：
```
Drivers options  --->
    Drivers examples  --->
        [*] Enable PSADC driver test command
```

RTOS 环境

test_psadc 测试
在打开 test_psadc 的编译后，板子上可直接运行 test_psadc 命令：
```
test_psadc -h
```
```
Compile time: Jul 26 2023 08:20:53
Usage: test_psadc [options]:
     -r, --read             Read the adc value
     -t, --voltage          Set default voltage
     -s, --status           Show more hardware information
     -n, --number           Set the number of samples, default is 10
     -h, --help

Example: test_psadc -r
```
- ADC 基准参考电压：通过 eFuse 获取的电压。不同产品系列的 ADC 基准参考电压如下所示：
  - D21x: 3.0 V
  - D13x: 2.5 V
  - D12x: 2.5 V
- 默认电压：无法通过 eFuse 获取电压时才使用的电压。默认电压值配置为如上不同产品系列所对应的 adc 基准参考电压。
  提示：
  无法获取 ADC 基准参考电压时，系统会返回信息提示： Failed to obtainre ference voltage through efuse，此时才需执行 -t, --voltage 命令配置默认电压值。

ADC 读取测试

ADC 数据的读取可以使用 Shell 命令 test_psadc：

每次可读取某一个通道中的当前数据：

test_psadc -s

In PSADC V1.01
enabled 3 channels: [5][6][7]

设置 ADC 基准参考电压的默认值：
```
test_psadc -t 3
```
未设置采样次数时，默认采样 10 次：
```
test_psadc -n 2
```

test_psadc -r

The reference voltage is 3. 0v # 当前 ADC 计算所使用的的电压值
Start samplng 2 samples for3 channels
Sample time: 11 us
[1] PSADC:  4095976833# ADC 值依次是所设置通道(从小到大排序[5][6][7]通道)的采样值
voltage:  3. 0v 0.71v 0.61v # 同理，该电压值依次是[5][6][7]通道的电压
Sample time: 10 us
[2] PSADC:  4095907750
voltage:  3. 0v 0.66v 0.54v
Sample time: 10 us

裸机环境

test_psadc 测试
在打开 test_psadc 的编译后，板子上可直接运行 test_psadc 命令：
```
test_psadc help
```
```
Compile time: May 29 2024 13:23:14
Usage: test_psadc [options]
test_psadc read                       : Get the adc value
test_psadc modify <default_voltage>   : Modify default voltage
test_psadc status                     : Check the psadc status
test_psadc help                       : Get this help

Example: test_psadc read
```
- ADC 基准参考电压：通过 eFuse 获取的电压。不同产品系列的 ADC 基准参考电压如下所示：
  - D21x: 3.0 V
  - D13x: 2.5 V
  - D12x: 2.5 V
- 默认电压：无法通过 eFuse 获取电压时才使用的电压。默认电压值配置为如上不同产品系列所对应的 adc 基准参考电压。
  提示：
  无法获取 ADC 基准参考电压时，系统会返回信息提示： Failed to obtain reference voltage through efuse，此时才需执行 modify 命令配置默认电压值。

ADC 读取测试

ADC 数据的读取可以使用 Shell 命令 test_psadc，每次可读取某一个通道中的当前数据。

test_psadc status

In PSADC V1.01
enabled 3 channels: [5][6][7]

test_psadc modify 3# 设置 adc 基准参考电压的默认值

test_psadc read

The reference voltage is 3. 0v # 当前 ADC 计算所使用的的电压值
Start samplng for3 channels
Sample time: 11 us
[1] PSADC:  4095976833# ADC 值依次是所设置通道(从小到大排序[5][6][7]通道)的采样值
voltage:  3. 0v 0.71v 0.61v # 同理，该电压值依次是[5][6][7]通道的电压
Sample time: 10 us
[2] PSADC:  4095907750
voltage:  3. 0v 0.66v 0.54v
Sample time: 10 us