Repository files navigation

This package contains an API to connect to Arduino Modulinos, read their data and control them.

Supports the following Modulinos:

• 🔘Modulino Buttons: A three-button Modulino.
• 🎵Modulino Buzzer: A piezo speaker.
• 🌈Modulino Pixels: Control RGB LEDs on the Modulino Pixels.
• 📏Modulino Distance: Measure distance to an object.
• 🏃‍♂️Modulino Movement: Measure acceleration and positioning.
• 🎛️Modulino Knob: A rotating knob with a button.
• 🌡️Modulino Thermo: Read surrounding temperature and humidity.
• ⚡️Modulino Latch Relay: Control a latching relay to switch devices on and off.
• 🕹️Modulino Joystick: Read X/Y axis and button state from a joystick Modulino.
• 📳Modulino Vibro: Control a vibration motor.

For more information on the features of this library and how to use them please read the documentationhere.

Any board that has I2C and can run a modern version of MicroPython is supported. On non-Arduino boards you will have to specify the I2C interface to be used. e.g.pixels = ModulinoPixels(I2C(0)). On Arduino boards the correct I2C interface will be detected automatically.On boards that don't have a Qwiic connector you will need to buy a Qwiic to Dupont cable or make your own.

The easiest way is to usempremote and mip:

mpremote mip install github:arduino/arduino-modulino-mpy

The easiest way is to clone the repository and then run any example usingmpremote.The recommended way is to mount the root directory remotely on the board and then running an example script. e.g.

 mpremote connect mount src run ./examples/pixels.py

If your board cannot be detected automatically you can try to explicitely specify the board's serial number. For example:

mpremote connect id:387784598440 mount src run ./examples/board_control.py

The specified serial number passed to theid attribute can be retrieved usingmpremote connect list.The serial number is the value in the second column.

To select and run the desired example you can run:

python run_examples.py

If you encounter any issue, please open a bug reporthere.

• Take a look at the documentation of theArduino Plug and Make Kit which includes 7 selected Modulinos.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

For questions, comments, or feedback on this package, please create an issue on this repository.