View source for Pymate-16ADI16DO-introduction

{{PYMATE-HEADER}}

== 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.

== Board_ID ==

It is essential to identify the '''Board_ID''' of the 16ADI16DO expansion.

Here a reminder of few tutorials around the "Board_ID".

{{ttuto-begin}}

{{ttuto
  |label=Board_ID
  |descr=Identification of expansion board
  |img=tlogo-board-id.png
  |link=PymateIO-about-board_id
}}

{{ttuto
  |label=CAN Scan
  |descr=Scanning the CAN bus for boards and check for CAN error.
  |img=tlogo-can-scan.png
  |link=PymateIO-CAN-Scan
}}

{{ttuto
  |label=Change Board_ID
  |descr=How to change the 16ADI16DO board identification on the CAN bus.
  |img=tlogo-board-id.png
  |link=Pymate-16ADI16DO-Tour#Configuration_procedure
}}

{{ttuto-end}}

== Input ==

Input are high when voltage on the Input is higher than 8V.

Input return to low state when the voltage drops under 5V

=== Wiring ===

[[File:pymate-input-2.png|960px]]

=== Coding ===

The following example query the state if imput 10 (on Board_ID 1) and displays the results on the REPL session. 

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import Pin
import time

EXT_BOARD = 1

i10 = PymateIO( "IN10", Pin.IN, EXT_BOARD )

while True:
    print( "i10= %s" % i10.read() )
    time.sleep( 0.5 ) # Wait 1/2 second
</syntaxhighlight>

Which would display the following in the REPL:

 <nowiki>1
1
1
0
0
1</nowiki>

Where:
* 0 is at LOW state, meaning that low voltage is applied on the input (< 5 Volts).
* 1 is at HIGH state, meaning that high voltage is applied on the input (> 8 Volts).

=== MicroPython alike call ===
MicroPython coder usually use {{fname|Pin.value()}} to read the state of an input.

Such method is also available on the PymateIO class to act like an usual `Pin` class.

The script above could also be written by using {{fname|value()}} instead of {{fname|read()}} as follow:

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import Pin
import time

EXT_BOARD = 1

i10 = PymateIO( "IN10", Pin.IN, EXT_BOARD )

while True:
    print( "i10= %s" % i10.value() )
    time.sleep( 0.5 ) # Wait 1/2 second
</syntaxhighlight>

== Output ==

Output will connect the high side of the load to Vin (250 mA per channel) with a PNP transistor. It can be used to control relays, pilot light, etc. 

=== Wiring ===

The following example controls a 24V relay connected to output 2 and a 24V Pilot Light to output 8.

[[File:pymate-output-2.png|960px]]

=== Coding ===

The following example change the state of the relay (OUT3) every minute while the Pilot Light (OUT12) is lit when the relay is off. 

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import Pin
import time

EXT_BOARD = 1

o3 = PymateIO( "OUT3", Pin.OUT, EXT_BOARD )
o12 = PymateIO( "OUT12", Pin.OUT, EXT_BOARD )
state = False
while True:
    # Invert the state
    state = not(state)

    # Set the relay
    print( "Relay is %s" % state )
    o3.write( state )

    # Set the Pilot Light
    o12.write( not(state) )

    # Wait a minute
    time.sleep( 60 ) 
</syntaxhighlight>

Which would display the following in the REPL:

 <nowiki>Relay is True
Relay is False
Relay is True
Relay is False
...</nowiki>

=== MicroPython alike call ===
MicroPython coder usually use `Pin.value( new_value )` to write the state of an output.

Such method is also available on the PymateIO class to act like an usual `Pin` class.

The script above could also be written by using:
* {{fname|'''value(new_state)'''}} instead of {{fname|write()}}
* {{fname|'''on()'''}} & {{fname|'''off()'''}} instead of {{fname|write()}}
* {{fname|'''high()'''}} & {{fname|'''low()'''}} as replacement of {{fname|on()}} and {{fname|off()}}.

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import Pin
import time

EXT_BOARD = 1

o3 = PymateIO( "OUT3", Pin.OUT, EXT_BOARD )
o12 = PymateIO( "OUT12", Pin.OUT, EXT_BOARD )
state = False
while True:
    # Invert the state
    state = not(state)

    # Set the relay
    print( "Relay is %s" % state )
    o3.value( state )

    # Set the Pilot Light
    o12.value( not(state) )

    # Wait a minute
    time.sleep( 60 ) 
</syntaxhighlight>

== Analog Input ==

Any of the Input 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.

{{rbox-red|The '''absolute maximum voltage''' is 10 Volts DC. }}

=== Wiring ===

[[File:pymate-adc-2.png|960px]]

=== Coding ===
==== Getting raw value ====

The following example query the state if input 7 on Board_ID 1 and displays the results on the REPL session. 

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import ADC
import time

EXT_BOARD

a7 = PymateIO( "IN7", ADC, EXT_BOARD )

while True:
    print( "Adc 7 RAW = %s" % a4.read_u16() )
    time.sleep( 0.2 )
</syntaxhighlight>

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).

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import ADC
import time

EXT_BOARD = 1

a7 = PymateIO( "IN7", ADC, EXT_BOARD )

while True:
    v = a7.read_volts()
    print( "Adc 7 : %.2f volts" % v )
    time.sleep( 0.2 )
</syntaxhighlight>

== Board LEDs ==

The 16ADI16DO expansion board also have two USER LEDs that can be controled remotely as if it were output pins.

<syntaxhighlight lang="python" line>from pymate.pymateio import PymateIO
from machine import Pin, ADC
from pymate.pymateio import PymateIO
import time

EXT_BOARD = 1

RemoteLedA = PymateIO( 'LED_1', Pin.OUT, board_id=EXT_BOARD )
RemoteLedB = PymateIO( 'LED_2', Pin.OUT, board_id=EXT_BOARD )

while True:
	RemoteLedA.on()
	time.sleep_ms(300)
	RemoteLedA.off()
	RemoteLedB.on()
	time.sleep_ms(300)
	RemoteLedB.off()
	time.sleep_ms(300)
</syntaxhighlight>

As any PymateIO pins, the methods {{fname|value( 1 )}},{{fname|value( 0 )}} or {{fname|write( 1 )}},{{fname|write( 0 )}} or {{fname|high()}},{{fname|low()}} could also be used to contrôle the LEDs.

{{PYMATE-TRAILER}}