mirror of
https://github.com/micropython/micropython.git
synced 2026-01-04 11:10:14 +01:00
d5ad2cdcca
Some checks failed
JavaScript code lint and formatting with Biome / eslint (push) Has been cancelled
Check code formatting / code-formatting (push) Has been cancelled
Check spelling with codespell / codespell (push) Has been cancelled
Build docs / build (push) Has been cancelled
Check examples / embedding (push) Has been cancelled
Package mpremote / build (push) Has been cancelled
.mpy file format and tools / test (push) Has been cancelled
Build ports metadata / build (push) Has been cancelled
alif port / build_alif (alif_ae3_build) (push) Has been cancelled
cc3200 port / build (push) Has been cancelled
esp32 port / build_idf (esp32_build_c2_c5_c6) (push) Has been cancelled
esp32 port / build_idf (esp32_build_cmod_spiram_s2) (push) Has been cancelled
esp32 port / build_idf (esp32_build_s3_c3) (push) Has been cancelled
esp8266 port / build (push) Has been cancelled
mimxrt port / build (push) Has been cancelled
nrf port / build (push) Has been cancelled
powerpc port / build (push) Has been cancelled
qemu port / build_and_test_arm (bigendian) (push) Has been cancelled
qemu port / build_and_test_arm (sabrelite) (push) Has been cancelled
qemu port / build_and_test_arm (thumb_hardfp) (push) Has been cancelled
qemu port / build_and_test_arm (thumb_softfp) (push) Has been cancelled
qemu port / build_and_test_rv32 (push) Has been cancelled
qemu port / build_and_test_rv64 (push) Has been cancelled
renesas-ra port / build_renesas_ra_board (push) Has been cancelled
rp2 port / build (push) Has been cancelled
samd port / build (push) Has been cancelled
stm32 port / build_stm32 (stm32_misc_build) (push) Has been cancelled
stm32 port / build_stm32 (stm32_nucleo_build) (push) Has been cancelled
stm32 port / build_stm32 (stm32_pyb_build) (push) Has been cancelled
unix port / minimal (push) Has been cancelled
unix port / reproducible (push) Has been cancelled
unix port / standard (push) Has been cancelled
unix port / standard_v2 (push) Has been cancelled
unix port / coverage (push) Has been cancelled
unix port / coverage_32bit (push) Has been cancelled
unix port / nanbox (push) Has been cancelled
unix port / longlong (push) Has been cancelled
unix port / float (push) Has been cancelled
unix port / gil_enabled (push) Has been cancelled
unix port / stackless_clang (push) Has been cancelled
unix port / float_clang (push) Has been cancelled
unix port / settrace_stackless (push) Has been cancelled
unix port / repr_b (push) Has been cancelled
unix port / macos (push) Has been cancelled
unix port / qemu_mips (push) Has been cancelled
unix port / qemu_arm (push) Has been cancelled
unix port / qemu_riscv64 (push) Has been cancelled
unix port / sanitize_address (push) Has been cancelled
unix port / sanitize_undefined (push) Has been cancelled
webassembly port / build (push) Has been cancelled
windows port / build-vs (Debug, true, x64, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Debug, true, x86, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Debug, x64, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Debug, x86, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, dev, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, standard, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, standard, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, dev, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, standard, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, standard, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, x64, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, x64, standard, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, x86, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, x86, standard, 2022, [17, 18)) (push) Has been cancelled
windows port / build-mingw (i686, mingw32, dev) (push) Has been cancelled
windows port / build-mingw (i686, mingw32, standard) (push) Has been cancelled
windows port / build-mingw (x86_64, mingw64, dev) (push) Has been cancelled
windows port / build-mingw (x86_64, mingw64, standard) (push) Has been cancelled
windows port / cross-build-on-linux (push) Has been cancelled
zephyr port / build (push) Has been cancelled
Python code lint and formatting with ruff / ruff (push) Has been cancelled
Fixes issue #7915. Signed-off-by: Matt Trentini <matt.trentini@gmail.com>
69 lines
1.9 KiB
ReStructuredText
69 lines
1.9 KiB
ReStructuredText
.. currentmodule:: machine
|
|
.. _machine.DAC:
|
|
|
|
class DAC -- digital to analog conversion
|
|
=========================================
|
|
|
|
The DAC is used to output an analog voltage based on a digital value.
|
|
|
|
The output voltage will be between 0 and 3.3V.
|
|
|
|
DAC is currently supported on ESP32 [#esp32_dac]_, SAMD and Renesas RA.
|
|
|
|
.. note::
|
|
The STM32 port has similar functionality to ``machine.DAC``. See
|
|
:ref:`pyb.DAC <pyb.DAC>` for details.
|
|
|
|
Example usage (ESP32)::
|
|
|
|
from machine import DAC
|
|
|
|
dac = DAC(pin) # create a DAC object acting on a pin
|
|
dac.write(128) # write a value to the DAC
|
|
dac.write(255) # output maximum value, 3.3V
|
|
|
|
Constructors
|
|
------------
|
|
|
|
.. class:: DAC(id)
|
|
|
|
Construct a new DAC object.
|
|
|
|
``id`` is a pin object (ESP32 and Renesas RA) or an index to a DAC resource (SAMD).
|
|
|
|
.. note::
|
|
On the ESP32, DAC functionality is available on pins 25 and 26. On the
|
|
ESP32-S2, pins 17 and 18. See :ref:`ESP32 Quickref <esp32_quickref>`
|
|
for more details.
|
|
|
|
.. note::
|
|
SAMD21 has one DAC resource, SAMD51 has two. See :ref:`SAMD Quickref <samd_quickref>`
|
|
for more details.
|
|
|
|
Methods
|
|
-------
|
|
|
|
.. method:: DAC.write(value)
|
|
|
|
Output an analog voltage to the pin connected to the DAC.
|
|
|
|
``value`` is a representation of the desired output; a linear interpolation of
|
|
0-3.3V, though the range differs depending on the port and micro, see below:
|
|
|
|
+--------------+------+--------+
|
|
| *Port/micro* | Bits | Range |
|
|
+==============+======+========+
|
|
| ESP32 | 8 | 0-255 |
|
|
+--------------+------+--------+
|
|
| SAMD21 | 10 | 0-1023 |
|
|
+--------------+------+--------+
|
|
| SAMD51 | 12 | 0-4095 |
|
|
+--------------+------+--------+
|
|
| Renesas RA | 12 | 0-4095 |
|
|
+--------------+------+--------+
|
|
|
|
.. rubric:: Footnotes
|
|
|
|
.. [#esp32_dac] The original ESP32 and ESP32-S2 *only*, since DAC hardware is
|
|
not present on other microcontrollers in the family.
|