dac

数字模拟转换器。 更多...

dac 的协作图:

结构体
struct	_xf_hal_dac_config_t
	用于对接 dac 设置的参数。 更多...

类型定义
typedef uint32_t	xf_dac_num_t
	dac 序号。
typedef enum _xf_hal_dac_cmd_t	xf_hal_dac_cmd_t
	用于对接 dac 设置的命令。
typedef struct _xf_hal_dac_config_t	xf_hal_dac_config_t
	用于对接 dac 设置的参数。

枚举
enum	_xf_hal_dac_cmd_t {   XF_HAL_DAC_CMD_DEFAULT = 0x0 , XF_HAL_DAC_CMD_ENABLE = 0x1 << 0 , XF_HAL_DAC_CMD_RESOLUTION = 0x1 << 1 , XF_HAL_DAC_CMD_SPEED = 0x1 << 2 ,   XF_HAL_DAC_CMD_VALUE_MAX = 0x1 << 3 , XF_HAL_DAC_CMD_VERF = 0x1 << 4 , XF_HAL_DAC_CMD_ALL = 0x7FFFFFFF }
	用于对接 dac 设置的命令。 更多...

函数
xf_err_t	xf_hal_dac_init (xf_dac_num_t dac_num)
	dac 初始化。
xf_err_t	xf_hal_dac_deinit (xf_dac_num_t dac_num)
	dac 反初始化。
xf_err_t	xf_hal_dac_enable (xf_dac_num_t dac_num)
	dac 启用函数。
xf_err_t	xf_hal_dac_disable (xf_dac_num_t dac_num)
	dac 禁用函数。
xf_err_t	xf_hal_dac_set_resolution (xf_dac_num_t dac_num, uint8_t resolution)
	dac 设置分辨率。
xf_err_t	xf_hal_dac_set_speed (xf_dac_num_t dac_num, uint32_t speed)
	设置 dac 输出速度。
xf_err_t	xf_hal_dac_write (xf_dac_num_t dac_num, uint32_t value)
	dac 输出电压
xf_err_t	xf_hal_dac_write_mv (xf_dac_num_t dac_num, uint32_t mv)
	dac 输出电压 mv

详细描述

数字模拟转换器。

类型定义说明

xf_dac_num_t

typedef uint32_t xf_dac_num_t

dac 序号。

在文件 xf_hal_dac.h 第 41 行定义.

xf_hal_dac_cmd_t

typedef enum _xf_hal_dac_cmd_t xf_hal_dac_cmd_t

用于对接 dac 设置的命令。

注解

普通用户可忽略，移植者需注意。

xf_hal_dac_config_t

typedef struct _xf_hal_dac_config_t xf_hal_dac_config_t

用于对接 dac 设置的参数。

注解

普通用户可忽略，移植者需注意。

枚举类型说明

_xf_hal_dac_cmd_t

enum _xf_hal_dac_cmd_t

用于对接 dac 设置的命令。

注解

普通用户可忽略，移植者需注意。

枚举值
XF_HAL_DAC_CMD_DEFAULT	默认参数命令，在创建设备时优先执行
XF_HAL_DAC_CMD_ENABLE	启用命令，见 xf_hal_dac_config_t::enable
XF_HAL_DAC_CMD_RESOLUTION	分辨率命令，见 xf_hal_dac_config_t::resolution
XF_HAL_DAC_CMD_SPEED	速度命令，见 xf_hal_dac_config_t::speed
XF_HAL_DAC_CMD_VALUE_MAX	数值最大值命令，见 xf_hal_dac_config_t::value_max
XF_HAL_DAC_CMD_VERF	参考电压命令，见 xf_hal_dac_config_t::verf_mv
XF_HAL_DAC_CMD_ALL	默认设置命令，在创建设备时其次执行

在文件 xf_hal_dac.h 第 48 行定义.

函数说明

xf_hal_dac_init()

xf_err_t xf_hal_dac_init

(

xf_dac_num_t

dac_num

)

dac 初始化。

使用 dac 之前必须要进行初始化

参数

dac_num

dac 的序号

返回

xf_err_t

• XF_OK 成功初始化
• other 初始化失败

在文件 xf_hal_dac.c 第 50 行定义.

xf_hal_dac_deinit()

xf_err_t xf_hal_dac_deinit

(

xf_dac_num_t

dac_num

)

dac 反初始化。

恢复到未初始化状态且回收相关资源

参数

dac_num

dac 的序号

返回

xf_err_t

• XF_OK 成功反初始化
• other 反初始化失败

在文件 xf_hal_dac.c 第 58 行定义.

xf_hal_dac_enable()

xf_err_t xf_hal_dac_enable

(

xf_dac_num_t

dac_num

)

dac 启用函数。

dac 配置好功能后，可以调用 dac 进行激活。

注解

激活后，方可使用 xf_hal_dac_write 等函数。激活之前的配置 是静态配置。激活之后的配置属于动态配置，

注意

不一定所有的芯片都支持动态配置

参数

dac_num

dac 的序号

返回

xf_err_t

• XF_OK 成功启用 dac
• other dac 启用失败

在文件 xf_hal_dac.c 第 73 行定义.

xf_hal_dac_disable()

xf_err_t xf_hal_dac_disable

(

xf_dac_num_t

dac_num

)

dac 禁用函数。

注解

如果 dac 正在启用状态，且不支持动态配置。则需要该函数， 先将 dac 禁用，然后进行配置。再次进行启用。

参数

dac_num

dac 的序号

返回

xf_err_t

• XF_OK 成功禁用 dac
• other 禁用 DAC失败

在文件 xf_hal_dac.c 第 98 行定义.

xf_hal_dac_set_resolution()

xf_err_t xf_hal_dac_set_resolution	(	xf_dac_num_t	dac_num,
		uint8_t	resolution
	)

dac 设置分辨率。

注解

并不是所有芯片都支持分辨率设置。

参数

dac_num	dac 的序号
resolution	如果为 10，则输出的DAC值的范围为 0~2^10 之间

返回

xf_err_t

• XF_OK 成功设置
• other 设置失败

在文件 xf_hal_dac.c 第 123 行定义.

xf_hal_dac_set_speed()

xf_err_t xf_hal_dac_set_speed	(	xf_dac_num_t	dac_num,
		uint32_t	speed
	)

设置 dac 输出速度。

注解

并不是所有芯片都支持输出速度设置。

参数

dac_num	dac 的序号
speed	设置 dac 的速度，单位为 hz

返回

xf_err_t

• XF_OK 成功设置
• other 设置失败

在文件 xf_hal_dac.c 第 150 行定义.

xf_hal_dac_write()

xf_err_t xf_hal_dac_write	(	xf_dac_num_t	dac_num,
		uint32_t	value
	)

dac 输出电压

参数

dac_num	dac 的序号
value	设置 dac 原始的值，最大值由 resolution 决定

返回

xf_err_t

• XF_OK 成功输出电压
• other 输出电压失败

在文件 xf_hal_dac.c 第 177 行定义.

xf_hal_dac_write_mv()

xf_err_t xf_hal_dac_write_mv	(	xf_dac_num_t	dac_num,
		uint32_t	mv
	)

dac 输出电压 mv

参数

dac_num	dac 的序号
mv	设置 dac 输出的电压大小，最大不会超过 verf_mv

返回

xf_err_t

• XF_OK 成功输出电压
• other 输出电压失败

在文件 xf_hal_dac.c 第 203 行定义.