Repository files navigation

Eclipse Mraa (Libmraa) is a C/C++ library with bindings to Java, Python and JavaScriptto interface with the I/O pins and buses on various IoT and Edge platforms, with astructured and sane API where port names/numbering match the board that you are on.Use of libmraa does not tie you to specific hardware. Since board detection done atruntime you can create portable code that will work across the supported platforms.

The intent is to make it easier for developers and sensor manufacturers to maptheir sensors & actuators on top of supported hardware and to allow control oflow level communication protocol by high level languages & constructs.

The MRAA project is an Eclipse IoT project. A detailed project description can be foundhere.

• Galileo Gen 1 - Rev D
• Galileo Gen 2 - Rev H
• Edison
• Intel DE3815
• Minnowboard
• NUC 5th generation
• UP
• UP Squared
• Intel Joule
• IEI Tank
• ADLINK IPi-SMARC X86
• UP Xtreme

• Raspberry Pi
• Banana Pi
• Beaglebone Black
• phyBOARD-Wega
• 96Boards
• ADLINK IPi-SMARC ARM
• Radxa CM3
• Radxa CM5 IO
• Radxa E25
• Radxa ROCK 3A
• Radxa ROCK 3B
• Radxa ROCK 3C
• Radxa ROCK 5A
• Radxa ROCK 5B
• Radxa ZERO3
• Rock Pi 4
• Orange Pi Prime

• Linkit Smart 7688
• Onion Omega2

• DE10-Nano

• FT4222
• Firmata

• GrovePi

• Generic simulated board

• Platform loading

• VisionFive

Here is a PPA for installing on Ubuntu Xenial or Bionic:https://launchpad.net/~mraa/+archive/ubuntu/mraa

sudo add-apt-repository ppa:mraa/mraasudo apt-get updatesudo apt-get install libmraa2 libmraa-dev libmraa-java python-mraa python3-mraa node-mraa mraa-tools

Running MRAA tools or applications on Ubuntu systems requires elevated permissions(e.g. run withsudo).

There is an AUR package for mraa here:https://aur.archlinux.org/packages/mraa

For the latest versions of openSUSE and SLE the project is distributed vianative repositories and can be installed by developers with:

sudo zypper install mraa mraa-devel

For ARM boards use:

REPO="openSUSE_Tumbleweed"iftest"$(arch)" =="aarch64";then  REPO="openSUSE_Factory_ARM"fisudo zypper ar http://download.opensuse.org/repositories/hardware/$REPO/hardware.reposudo zypperin mraa

A full list of packages and instructions for installing MRAA for various openSUSE releasescan be foundhere.

There is an mraa package in the main Fedora repository so it can be dnf installedin all recent Fedora releases. The Node.js and Python 3 bindings are packaged asseparate packages.

sudo dnf install mraa nodejs-mraa python3-mraa

The MRAA project does not currently distribute official binaries for RHELor CentOS so developers will have to compile the project from sources asdescribed in the next section.

For testing and development purposes it may be possible to share and install.deb and .rpm packages across similar Linux builds.

See documentation onbuilding

See theexamples available for various languages

Sometimes it just doesn't want to work, let us try and help you, you can fileissues in github or join us in #mraa on freenode IRC, hang around for a littlewhile because we're not necessarily on 24/7, but we'll get back to you! Have aglance at ourdebugging page too.

To ask questions either file an issue on Github or send an email to ourmailing list.You must be subscribed to the list before you can post.You might also catch us on the mraa channel on freenode IRC.

See theContribution documentation for more details.

Version changeloghere.