Pymate-Analog: Difference between revisions

From pymate.io wiki
Jump to navigation Jump to search
Line 51: Line 51:
Which displays values between 0 and 65535 in the REPL.
Which displays values between 0 and 65535 in the REPL.


=== Coding : voltage ===
== Getting  voltage ==


This second example return the ADC value in Volts.
This second example return the ADC value in Volts.

Revision as of 23:11, 30 April 2026



Important note

Charts and graphics are made to be easy to follow.

The Pymate boards are drawed without connectors to avoids parallax shift. The real board are fitted with the connectors.

About Analog Input

Any of the output pin can be switched from digital input to Analog Input.

Analog Input can read the value of the DC voltage applied to the analog Input pin.

The absolute maximum voltage is 10 Volts DC.

As the voltage is read through and Analog-to-Digital converter, the resulting value will be an unsigned integer.

As MicroPython defines the ADC.read_u16() method returning an unsigned 16 bits value (0 .. 65535).

About Upscaling:

Getting an uniform result encoded over 16bits makes the user script independent of the effective hardware resolution of the analog converter.

This means that read_u16() may returns an upscaled value when ADC converter offers lower resolution (below 16bits).

Keep in mind that code cannot create better resolution that hardware does!

Pymate ADCs have 12 bits resolution meaning that maximum accuracy is 2.44 mV (10 Volts / 4095).

Wiring

Pymate-adc.png

Coding

Getting raw value

The following example query the state if imput 3 and displays the results on the REPL session.

from pymate.pymateio import PymateIO
from machine import ADC
import time

a4 = PymateIO( "IN4", ADC )

while True:
    print( "Adc 4 RAW = %s" % a4.read_u16() )
    time.sleep( 0.2 )

Which displays values between 0 and 65535 in the REPL.

Getting voltage

This second example return the ADC value in Volts.

Note the "%.2f" formatting that limits the displayed value to 2 decimal digits (making the reading more comfortable).

from pymate.pymateio import PymateIO
from machine import ADC
import time

a4 = PymateIO( "IN4", ADC )

while True:
    v = a4.read_volts()
    print( "Adc 4 : %.2f volts" % v )
    time.sleep( 0.2 )



PymateIO all right reserved © 2026 - Written by MCHobby for PymateIO