Linux Library for low speed IO Communication in C with bindings for C++, Python, Node.js & Java. Supports generic io platforms, as well as Intel Edison, Intel Joule, Raspberry Pi and many more.

License: MIT

Language: C

Keywords: board, communication, galileo, gpio, i2c, intel-joule, io, libmraa, linux, mraa, raspberry-pi, spi

libmraa - Low Level Skeleton Library for Communication on GNU/Linux platforms

Libmraa is a C/C++ library with bindings to Java, Python and JavaScript to interface with the IO on Galileo, Edison & other platforms, with a structured and sane API where port names/numbering matches the board that you are on. Use of libmraa does not tie you to specific hardware with board detection done at runtime 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 map their sensors & actuators on top of supported hardware and to allow control of low level communication protocol by high level languages & constructs.

Build Status Quality Gate

Supported Boards








JSON platform

Installing on your board

Installing on Ubuntu

Here is a PPA for installing on Ubuntu Xenial or Bionic:

sudo add-apt-repository ppa:mraa/mraa
sudo apt-get update
sudo 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 with sudo).

Install on Arch Linux

There is an AUR package for mraa here:

Install on openSUSE

if test "$(arch)" == "aarch64"; then
sudo zypper ar$REPO/hardware.repo
sudo zypper in mraa

Install on Fedora Linux

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

sudo dnf install mraa nodejs-mraa python3-mraa

Installing for Node.js only

Note: Node.js 7.0.0+ is not currently supported unless compiling with a patched vesion of SWIG. See the corresponding section and document below.

You can also install just the node.js mraa module by using npm. You will need a C++ compiler and the node development headers, however it's not required to have SWIG installed. This works for node versions 6.x.x and prior.

npm install mraa

Note that installing mraa in this way builds mraa without json-c so you cannot use mraa_init_json_platform(). Also building this way means the mraa.node includes a static version of libmraa rather than relying on a dynamic library in /usr/lib.

Subplatforms (i.e. Firmata) have to be added manually with this kind of install from your application, as shown in this example.


See documentation on building


See the examples available for various languages


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

API Documentation

Contact Us

To ask questions either file issues in github or send emails on our mailing list. You might also catch us on the mraa channel on freenode IRC.

See the Contribution documentation for more details.


Version changelog here.

Project Statistics

Sourcerank 16
Repository Size 3.16 MB
Stars 1,145
Forks 518
Watchers 133
Open issues 129
Dependencies 4
Contributors 98
Tags 61
Last updated
Last pushed

Top Contributors See all

Brendan Le Foll Tom Ingleby Henry Bruce Alex T Mihai Tudor Panu Noel Eck Manivannan Sadhasivam MichaelRing Jon Trulson Houman Brinjcargorabi Nicolas Oliver Tapani- Stefan Andritoiu laykuanloon petreeftime spitfire88 Nicola Lunghi Andrei Vasiliu xbolshe KurtE

Packages Referencing this Repo

IO library that helps you use I2c, SPI, gpio, uart, pwm, analog inputs (aio) and more on a number...
Latest release 1.9.0 - Updated - 1.15K stars
Low Level Skeleton Library for IO Communication on GNU/Linux platforms
Latest release 2.0.0 - Updated - 1.15K stars
Enables simulation of mraa interfaces for testing purposes
Latest release 0.0.1 - Published - 1.15K stars

Recent Tags See all

v2.0.0 September 06, 2018
v1.9.0 February 15, 2018
v1.8.0 September 15, 2017
v1.7.0 May 12, 2017
v1.6.1 April 06, 2017
v1.6.0 April 02, 2017
v1.5.1 November 04, 2016
v1.5.0 November 04, 2016
v1.4.0 October 11, 2016
v1.3.0 August 30, 2016
v1.2.3 August 10, 2016
v1.2.2 August 09, 2016
v1.2.1 August 03, 2016
v1.2.0 August 03, 2016
v1.1.2 July 12, 2016

Interesting Forks See all

IoT Library for MIPS Linux platforms
C - MIT - Last pushed - 2 stars - 1 forks
Low Level Skeleton Library for IO Communication on GNU/Linux platforms
C - Last pushed - 2 stars
Linux Library for low speed IO Communication in C with bindings for C++, Python, Node.js & Java. ...
C - Last pushed - 1 stars
Linux Library for low speed IO Communication in C with bindings for C++, Python, Node.js & Java. ...
C - Updated - 1 stars
Linux Library for low speed IO Communication in C with bindings for C++, Python, Node.js & Java. ...
This repository is no longer available - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-01-04 20:43:41 UTC

Login to resync this repository