EXTIO2 Unit

EXT.IO2 is an IO extended unit, based on STM32F030 main controller, using I2C communication interface and providing 8 IO expansion. Each IO supports independent configuration of digital I/O, ADC, SERVO control, RGB LED control modes. Supports configuration of device I2C address, which means that users can mount multiple EXT.IO2 UNITs on the same I2C BUS to extend more IO resources. Suitable for multiple digital/analog signal acquisition, with lighting/servo control applications.

Support the following products:

Micropython Example:

# SPDX-FileCopyrightText: 2024 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
from hardware import *
from unit import EXTIO2Unit


title0 = None
label0 = None
i2c0 = None
extio2_0 = None


def setup():
    global title0, label0, i2c0, extio2_0

    M5.begin()
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title(
        "ExtIO2Unit Core2 Example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu18
    )
    label0 = Widgets.Label("IO6 State:", 2, 116, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    i2c0 = I2C(0, scl=Pin(33), sda=Pin(32), freq=100000)
    extio2_0 = EXTIO2Unit(i2c0)
    extio2_0.set_config_mode(0, 1)
    extio2_0.set_config_mode(6, 2)
    extio2_0.set_config_mode(3, 4)
    extio2_0.write_rgb_led(3, 0xFF0000)


def loop():
    global title0, label0, i2c0, extio2_0
    M5.update()
    label0.setText(str((str("IO6 State:") + str((extio2_0.read_adc12_pin(0))))))


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

UIFLOW2 Example:

extio2_core2_example.m5f2

class EXTIO2Unit

Constructors

class EXTIO2Unit(i2c, address)

Initialize EXTIO2Unit with I2C or PAHUBUnit and address for communication.

Parameters:

i2c – The I2C or PAHUBUnit interface for communication with the EXTIO2Unit.
address (int) – The I2C address for the unit, default is _DEFAULT_ADDRESS.

UIFLOW2:

Methods

EXTIO2Unit.set_config_mode(id, mode)

Set the configuration mode for a specific channel.

Parameters:

id (int) – The channel ID to set the mode for.
mode – The mode to set, defined by the EXTIO2Unit. Can be 0, 1, 2, 3, or 4.

UIFLOW2:

EXTIO2Unit.write_output_pin(id, value)

Write a value to an output pin of the EXTIO2Unit.

Parameters:

id (int) – The pin ID to write the value to.
value – The value to write, either 0 or 1.

UIFLOW2:

EXTIO2Unit.write_servo_angle(id, angle)

Write an angle to a servo connected to the EXTIO2Unit.

Parameters:

id (int) – The servo ID to set the angle for.
angle (int) – The angle to set the servo to (0-255).

UIFLOW2:

EXTIO2Unit.write_servo_pulse(id, pulse)

Write a pulse width to a servo connected to the EXTIO2Unit.

Parameters:

id (int) – The servo ID to set the pulse for.
pulse (int) – The pulse width to set the servo to, in microseconds.

UIFLOW2:

EXTIO2Unit.write_rgb_led(id, value)

Write an RGB color value to a NeoPixel LED.

Parameters:

id (int) – The NeoPixel ID to set the color for.
value – The RGB value to set, represented as a 24-bit integer.

UIFLOW2:

EXTIO2Unit.set_address(address)

Set the I2C address for the EXTIO2Unit.

Parameters:: address (int) – The new I2C address to set for the unit.

UIFLOW2:

EXTIO2Unit.get_config_mode(id)

Get the current configuration mode of a specific channel.

Parameters:: id (int) – The channel ID to get the mode for.

UIFLOW2:

EXTIO2Unit.read_input_pin(id)

Read the value of an input pin.

Parameters:: id (int) – The pin ID to read the value from.

UIFLOW2:

EXTIO2Unit.read_adc8_pin(id)

Read the 8-bit ADC value of a pin.

Parameters:: id (int) – The pin ID to read the ADC value from.

UIFLOW2:

EXTIO2Unit.read_adc12_pin(id)

Read the 12-bit ADC value of a pin.

Parameters:: id (int) – The pin ID to read the ADC value from.

UIFLOW2:

EXTIO2Unit.read_servo_angle(id)

Read the angle of a servo.

Parameters:: id (int) – The servo ID to read the angle from.

UIFLOW2:

EXTIO2Unit.read_servo_pulse(id)

Read the pulse width of a servo.

Parameters:: id (int) – The servo ID to read the pulse width from.

UIFLOW2:

EXTIO2Unit.read_rgb_led(id)

Read the RGB color value of a NeoPixel LED.

Parameters:: id (int) – The NeoPixel ID to read the color from.

UIFLOW2:

EXTIO2Unit.pin(id, mode, value)

Create and return a Pin object with the specified mode and value.

Parameters:

id – The pin ID to create the Pin object for.
mode (int) – The mode to set for the pin (default is input).
value – The value to set for the pin, if applicable.