CloudEdge/bl_mcu_sdk
Archived
1
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity
This repository has been archived on 2023-07-17. You can view files and clone it, but cannot push or open issues or pull requests.
aa5a88a88e
bl_mcu_sdk/docs/source/api_reference/peripherals/adc.rst
jzlv aa5a88a88e [doc] update readme and rst
2022-11-18 16:47:16 +08:00

483 lines
8.4 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

ADC
=============
Macros
------------
adc channel
^^^^^^^^^^^^^^^^^^^^
参考 `bflb_adc.h` 文件，不详细列出。
adc clock div
^^^^^^^^^^^^^^^^^^^^
对 adc 时钟再一次进行分频。分频后的时钟必须小于 2M。
.. code-block:: c
:linenos:
#define ADC_CLK_DIV_4 1
#define ADC_CLK_DIV_8 2
#define ADC_CLK_DIV_12 3
#define ADC_CLK_DIV_16 4
#define ADC_CLK_DIV_20 5
#define ADC_CLK_DIV_24 6
#define ADC_CLK_DIV_32 7
adc resolution
^^^^^^^^^^^^^^^^^^^^
adc 位数，可以选择 12B、14B、16B。其中 14B 和 16B 自带过采样处理。
.. code-block:: c
:linenos:
#define ADC_RESOLUTION_12B 0
#define ADC_RESOLUTION_14B 2
#define ADC_RESOLUTION_16B 4
adc vref
^^^^^^^^^^^^^^^^^^^^
adc 内置参考电压选择，可以选择 2.0 V 或者 3.2V。
.. code-block:: c
:linenos:
#define ADC_VREF_3P2V 0
#define ADC_VREF_2P0V 1
Structs
------------
struct bflb_adc_config_s
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
adc 初始化配置结构体。
.. code-block:: c
:linenos:
struct bflb_adc_config_s {
uint8_t clk_div;
uint8_t scan_conv_mode;
uint8_t continuous_conv_mode;
uint8_t differential_mode;
uint8_t resolution;
uint8_t vref;
};
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - clk_div
- 分频值
* - scan_conv_mode
- 是否开启扫描模式
* - continuous_conv_mode
- 是否开启连续转换模式
* - differential_mode
- 是否开启差分模式
* - resolution
- 采样位数
* - vref
- 参考电压选择
struct bflb_adc_channel_s
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
配置 adc 通道时使用。
.. code-block:: c
:linenos:
struct bflb_adc_channel_s {
uint8_t pos_chan;
uint8_t neg_chan;
};
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - pos_chan
- 正向通道
* - neg_chan
- 反向通道（单端模式下无用）
struct bflb_adc_result_s
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
adc 标准转换结果
.. code-block:: c
:linenos:
struct bflb_adc_result_s {
int8_t pos_chan;
int8_t neg_chan;
int32_t value;
int32_t millivolt;
};
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - pos_chan
- 正向通道
* - neg_chan
- 反向通道（单端模式下无用）
* - value
- adc 转换结果
* - millivolt
- 转换结果转 mv
Functions
------------
bflb_adc_init
^^^^^^^^^^^^^^^^^^^^
说明: 初始化 adc。adc 使用之前需要开启 adc ip 时钟、设置 adc 时钟源和分频值、选择使用的 gpio 为 analog 模式。
.. code-block:: c
:linenos:
void bflb_adc_init(struct bflb_device_s *dev, const struct bflb_adc_config_s *config);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - config
- 配置项
bflb_adc_deinit
^^^^^^^^^^^^^^^^^^^^
说明: 反初始化 adc。
.. code-block:: c
:linenos:
void bflb_adc_deinit(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
bflb_adc_link_rxdma
^^^^^^^^^^^^^^^^^^^^
说明: adc dma 功能开关。
.. code-block:: c
:linenos:
void bflb_adc_link_rxdma(struct bflb_device_s *dev, bool enable);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - enable
- 是否开启 dma 功能
bflb_adc_channel_config
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 配置 adc 通道。
.. code-block:: c
:linenos:
int bflb_adc_channel_config(struct bflb_device_s *dev, struct bflb_adc_channel_s *chan, uint8_t channels);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - chan
- 通道（一对）
* - channels
- 通道对数（单次扫描模式下只能为 1）
bflb_adc_start_conversion
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 启动 adc 转换。连续转换模式下只需要调用一次。
.. code-block:: c
:linenos:
void bflb_adc_start_conversion(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
bflb_adc_stop_conversion
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 停止 adc 转换。
.. code-block:: c
:linenos:
void bflb_adc_stop_conversion(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
bflb_adc_get_count
^^^^^^^^^^^^^^^^^^^^
说明: 获取 adc 转换个数。
.. code-block:: c
:linenos:
uint8_t bflb_adc_get_count(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - return
- 转换个数（最大为32）
bflb_adc_read_raw
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 读取一次 adc 转换值。
.. code-block:: c
:linenos:
uint32_t bflb_adc_read_raw(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - return
- 转换值（注意不是最终采样值）
bflb_adc_rxint_mask
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: adc 转换完成中断开关。
.. code-block:: c
:linenos:
void bflb_adc_rxint_mask(struct bflb_device_s *dev, bool mask);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - mask
- 是否屏蔽中断
bflb_adc_errint_mask
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: adc 错误中断开关。
.. code-block:: c
:linenos:
void bflb_adc_errint_mask(struct bflb_device_s *dev, bool mask);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - mask
- 是否屏蔽中断
bflb_adc_get_intstatus
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: adc 中断标志。
.. code-block:: c
:linenos:
uint32_t bflb_adc_get_intstatus(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - return
- 中断标志
返回值如下:
.. code-block:: c
:linenos:
ADC_INTSTS_NEG_SATURATION
ADC_INTSTS_NEG_SATURATION
ADC_INTSTS_FIFO_UNDERRUN
ADC_INTSTS_FIFO_OVERRUN
ADC_INTSTS_ADC_READY
bflb_adc_int_clear
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 清除 adc 中断标志。
.. code-block:: c
:linenos:
void bflb_adc_int_clear(struct bflb_device_s *dev, uint32_t int_clear);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - int_clear
- 清除值
`int_clear` 可以填入以下参数:
.. code-block:: c
:linenos:
ADC_INTCLR_NEG_SATURATION
ADC_INTCLR_POS_SATURATION
ADC_INTCLR_FIFO_UNDERRUN
ADC_INTCLR_FIFO_OVERRUN
ADC_INTCLR_ADC_READY
bflb_adc_parse_result
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 对 adc 转换结果进行解析。
.. code-block:: c
:linenos:
void bflb_adc_parse_result(struct bflb_device_s *dev, uint32_t *buffer, struct bflb_adc_result_s *result, uint16_t count);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - buffer
- 转换值
* - result
- 输出结果
* - count
- 转换个数
bflb_adc_tsen_init
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 初始化 adc tsen 模块。
.. code-block:: c
:linenos:
void bflb_adc_tsen_init(struct bflb_device_s *dev, uint8_t tsen_mod);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - tsen_mod
- 模式选择
bflb_adc_tsen_get_temp
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
说明: 初始化 adc tsen 模块。
.. code-block:: c
:linenos:
float bflb_adc_tsen_get_temp(struct bflb_device_s *dev);
.. list-table::
:widths: 10 10
:header-rows: 1
* - parameter
- description
* - dev
- 设备句柄
* - return
- 温度
Reference in New Issue View Git Blame Copy Permalink