.. currentmodule:: pyb
.. _pyb.DAC:

DAC类 – 数字模拟变换
=========================================

    DAC用于在引脚X5或X6上输出模拟值（一个特定电压）。电压介于0至3.3V之间。

    *此模块将会对API进行更改。*

    用法示例::

        from pyb import DAC

        dac = DAC(pyb.Pin("P6"))             # dac = DAC(pyb.Pin("P6"))             #
        dac.write(128)          # write a value to the DAC (makes X5 1.65V) 将一个值写入DAC（使X5为1.65V）

        dac = DAC(pyb.Pin("P6"), bits=12)    # use 12 bit resolution
        dac.write(4095)         # output maximum value, 3.3V 输出最大值，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 以400Hz输出正弦波
        dac = DAC(pyb.Pin("P6"))
        dac.write_timed(buf, 400 * len(buf), mode=DAC.CIRCULAR)

    以12位分辨率输出连续正弦波::

        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 以400Hz输出正弦波
        dac = DAC(pyb.Pin("P6"), bits=12)
        dac.write_timed(buf, 400 * len(buf), mode=DAC.CIRCULAR)

.. only:: port_moxingstm32f4

    DAC用于在引脚A1或者A2上输出模拟值(一种特定的电压)。电压数值介于0-3.3v。

    *该模块将对API进行更改。*

    例::

        from pyb import DAC

        dac = DAC(pyb.Pin("A1"))             # create DAC on pin A1 在引脚A1上创建DAC
        dac.write(128)                       # write a value to the DAC (makes A1 1.65V) 为DAC写入一个值（使A1为1.65V）

        dac = DAC(pyb.Pin("A1"), bits=12)    # use 12 bit resolution 使用12位分辨率
        dac.write(4095)                      # output maximum value, 3.3V 输出最大值，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 输出400Hz的正弦波
        dac = DAC(pyb.Pin("A1"))
        dac.write_timed(buf, 400 * len(buf), mode=DAC.CIRCULAR)

    输出12位分辨率的正弦波::

        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 输出400Hz的正弦波
        dac = DAC(pyb.Pin("A1"), bits=12)
        dac.write_timed(buf, 400 * len(buf), mode=DAC.CIRCULAR)

构造函数
------------

.. class:: pyb.DAC(port, bits=8, \*, buffering=None)

       构造一个新的DAC对象。

       ``port`` 可为一个引脚对象，或一个整数（1或2）。DAC(1)位于引脚X5上，DAC(2)位于引脚X6。

       ``bits`` 为一个指定分辨率的整数，可为8或12。write和write_timed函数的最大值为
       2\*\*``bits``-1.

   *buffering* 参数选择DAC运算放大器输出缓冲器的行为，其目的是降低输出阻抗。
   可以使用``None``来选择默认值（buffering enabled for :meth:`DAC.noise`,
   :meth:`DAC.triangle` and :meth:`DAC.write_timed`，
   and disabled for :meth:`DAC.write`），``False`` 来完全禁用缓冲，或使用 ``True`` 来启用输出缓冲。

   启用缓冲后，DAC引脚可将负载降低至5KΩ。否则，它的最大输出阻抗为15KΩ：
   因此，在没有缓冲的情况下达到1％的精度要求施加的负载小于1.5MΩ。
   使用缓冲区会导致精度下降，尤其是在范围的极值附近。
   
方法
-------

.. method:: DAC.init(bits=8, \*, buffering=None)

   重新启动DAC。 ``bits`` 可为8或12。 *buffering* 可以是
   ``None``, ``False`` 或 ``True``; 有关此参数的含义，请参见上面的构造函数。

.. method:: DAC.deinit()

   取消DAC的初始化，使其引脚可用于其他用途。

.. method:: DAC.noise(freq)

   生成一个伪随机噪声信号。以给定频率将一个新的随机样本写入DAC输出。

.. method:: DAC.triangle(freq)

   生成一个三角形波。DAC输出值以给定频率变化。重复三角形波的频率为2048倍。

.. method:: DAC.write(value)

   直接访问DAC输出。最小值为0。最大值为2** ``bits`` -1，当创建DAC对象或使用 ``init`` 方法时在此设定bits。

.. method:: 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``.