DAC类 – 数字模拟变换¶
DAC用于在引脚X5或X6上输出模拟值(一个特定电压)。电压介于0至3.3V之间。
此模块将会对API进行更改。
使用示例
from pyb import DAC
dac = DAC(1) # create DAC 1 on pin X5
dac.write(128) # write a value to the DAC (makes X5 1.65V)
dac = DAC(1, bits=12) # use 12 bit resolution
dac.write(4095) # output maximum value, 3.3V
输出连续正弦波:
import math
from pyb import DAC
# create a buffer containing a sine-wave
buf = bytearray(100)
for i in range(len(buf)):
buf[i] = 128 + int(127 * math.sin(2 * math.pi * i / len(buf)))
# output the sine-wave at 400Hz
dac = DAC(1)
dac.write_timed(buf, 400 * len(buf), mode=DAC.CIRCULAR)
To output a continuous sine-wave at 12-bit resolution:
import math
from array import array
from pyb import DAC
# create a buffer containing a sine-wave, using half-word samples
buf = array('H', 2048 + int(2047 * math.sin(2 * math.pi * i / 128)) for i in range(128))
# output the sine-wave at 400Hz
dac = DAC(1, bits=12)
dac.write_timed(buf, 400 * len(buf), mode=DAC.CIRCULAR)
构造函数¶
- class pyb.DAC(port, bits=8, *, buffering=None)¶
以12位分辨率输出连续正弦波:
port
可为一个引脚对象,或一个整数(1或2)。DAC(1)位于引脚X5上,DAC(2)位于引脚bits
为一个指定分辨率的整数,可为8或12。write和write_timed函数的最大值为 2**bits
-1.buffering 参数选择DAC运算放大器输出缓冲器的行为,其目的是降低输出阻抗。 可以使用
None
来选择默认值(buffering enabled forDAC.noise()
,DAC.triangle()
andDAC.write_timed()
, and disabled forDAC.write()
),False
来完全禁用缓冲,或使用True
来启用输出缓冲。启用缓冲后,DAC引脚可将负载降低至5KΩ。否则,它的最大输出阻抗为15KΩ: 因此,在没有缓冲的情况下达到1%的精度要求施加的负载小于1.5MΩ。 使用缓冲区会导致精度下降,尤其是在范围的极值附近。
方法¶
- DAC.init(bits=8, *, buffering=None)¶
重新启动DAC。 bits 可为8或12。 buffering 可以是
None
,False
或True
; 有关此参数的含义,请参见上面的构造函数。
- DAC.deinit()¶
取消DAC的初始化,使其引脚可用于其他用途。
- DAC.noise(freq)¶
生成一个伪随机噪声信号。以给定频率将一个新的随机样本写入DAC输出。
- DAC.triangle(freq)¶
生成一个三角形波。DAC输出值以给定频率变化。重复三角形波的频率为2048倍。
- DAC.write(value)¶
直接访问DAC输出。最小值为0。最大值为2**
bits` -1,当创建DAC对象或使用 ``init
方法时在此设定``bits` 。
- DAC.write_timed(data, freq, *, mode=DAC.NORMAL)¶
使用DMA传输启动RAM到DAC的突发。输入数据以8位模式的字节数组和12位模式下的无符号半字(类型编码“H”)数组形式处理。
freq
可为指定使用定时器(6)写入DAC样本的频率的整数。其也可为一个用来触发DAC样本的已初始化定时器对象。有效定时器为2、4、5、6、7和8。mode
可为DAC.NORMAL
或DAC.CIRCULAR
.用法示例:
dac1 = DAC(1) dac2 = DAC(2) dac1.write_timed(buf1, pyb.Timer(6, freq=100), mode=DAC.CIRCULAR) dac2.write_timed(buf2, pyb.Timer(7, freq=200), mode=DAC.CIRCULAR)