home Introduction

done Pycom Products
done Getting Started
done Tutorials & Examples
done Firmware & API Reference
- done Pycom Modules
  - done machine
    - done Pygate
    - done ADC
    - done DAC
    - done I2C
    - done Pin
    - done PWM
    - done RTC
    - done SPI
    - done UART
    - done WDT
    - done Timer
    - done Touch
    - done SD
    - done CAN
    - done RMT
  - done network
  - done AES
  - done Pycom
  - done Shields
- done MicroPython Modules
- done Interrupts
done Product Info, Datasheets
done Update Firmware
done Pybytes
done Cellular Services
done Pymesh
done Micropython Support
done Advanced topics
done License

Ask on the forum

Firmware & API Reference > Pycom Modules > machine > ADC

ADC

class ADC – Analog to Digital Conversion

Development version

Quick Usage Example

Development version

import machine

adc = machine.ADC()             # create an ADC object
apin = adc.channel(pin='P16')   # create an analog pin on P16
val = apin()                    # read an analog value

Constructors

class machine.ADC([id=0]
Development version hello
)

Create an ADC object; associate a channel with a pin. For more info check the hardware section.

Methods

adc.init([bits=12])

Enable the ADC block. This method is automatically called on object creation.

bits can take values between 9 and 12 and selects the number of bits of resolution of the ADC block.

adc.deinit()

Disable the ADC block.

adc.channel(pin, attn=ADC.ATTN_0DB)

Create an analog pin.

pin is a keyword-only string argument. Valid pins are P13 to P20.
attn is the attenuation level. The supported values are: ADC.ATTN_0DB, ADC.ATTN_2_5DB, ADC.ATTN_6DB, ADC.ATTN_11DB

Returns an instance of ADCChannel.

adc.vref(vref)

If called without any arguments, this function returns the current calibrated voltage (in millivolts) of the 1.1v reference. Otherwise it will update the calibrated value (in millivolts) of the internal 1.1v reference.

adc.vref_to_pin(pin)

Connects the internal 1.1v to external GPIO. It can only be connected to P22, P21 or P6. It is recommended to only use P6 on the WiPy, on other modules this pin is connected to the radio.

Constants

ADC channel attenuation values: (value references are approximations)
- ADC.ATTN_0DB: 0dB attenuation. 1V will be registered as 1V
- ADC.ATTN_2_5DB: 2.5dB attenuation. 1V will be registered as 0.75V
- ADC.ATTN_6DB: 6dB attenuation. 1V will be registered as 0.5V
- ADC.ATTN_11DB: 11dB attenuation. 1V will be registered as 0.3V

Note: The voltages will automatically be corrected by adcchannel.voltage()

Class ADCChannel - created upon initialisation of an ADC Channel

The following methods can be applied on the adcchannel() instance. ADC channels are created using the ADC.channel(...) method.

adcchannel()

Fast method to read the channel value.

adcchannel.value()

Read the channel value.

adcchannel.init()

(Re)init and enable the ADC channel. This method is automatically called on object creation.

adcchannel.deinit()

Disable the ADC channel.

adcchannel.voltage()

Reads the channels value and converts it into a voltage (in millivolts)

adcchannel.value_to_voltage(value)

Converts the provided value into a voltage (in millivolts) in the same way voltage does.

ADC pin input range is 0-1.1V. This maximum value can be increased up to 3.3V using the highest attenuation of 11dB. Do not exceed the maximum of 3.3V, to avoid damaging the device.

ADC