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.
C C++ Python CMake Other
Mani-Sadhasivam mraa: fix mraa_gpio_lookup function
1. Extend the lookup count to phy_pin_count to cover all physical pins
   exposed on the board
2. Ignore the non GPIO pins by checking for GPIO capability

Signed-off-by: Manivannan Sadhasivam <>
Latest commit 77d4676 Aug 14, 2018
Failed to load latest commit information.
api Peripheralman: Remove IIO from ioinit for android Jul 24, 2018
cmake Platform_extender: FT4222 library refactor Jun 26, 2018
docs 96boards: Add Ultra-96 board support Jul 29, 2018
doxygen2jsdoc @ 67cad69 Travis CI and Documentation Generation improvements Aug 10, 2017
doxyport @ db3e1a6 Travis CI and Documentation Generation improvements Aug 10, 2017
examples String based IO initialization for MRAA Jul 24, 2018
imraa imraa: match version number in imraa.c with imraa.conf Apr 19, 2017
include String based IO initialization for MRAA Jul 24, 2018
jsstub Change messaging to indicate mraaStub is on npm Jun 29, 2016
scripts cmake: Remove all cpack options including IPK generation Mar 5, 2018
src mraa: fix mraa_gpio_lookup function Aug 15, 2018
tests ioinit: Update to build/test C++ ioinit Jul 30, 2018
tools tools: remove INSTALLGPIOTOOL flag Nov 2, 2017
.clang-format clang-format: run clang-format on C/C++ code Mar 23, 2015
.gitignore docs: improve android things docs Oct 11, 2017
.gitmodules Travis CI and Documentation Generation improvements Aug 10, 2017
.travis.yml travis-ci: Added minimal travis job Mar 13, 2018
CMakeLists.txt ioinit: Update to build/test C++ ioinit Jul 30, 2018 Add author rules and suggestion on filing issues for… Oct 24, 2016
COPYING docs: Update various references and texts Sep 21, 2017 examples: cleanup examples directory Jan 18, 2018 Travis CI and Documentation Generation improvements Aug 10, 2017
DoxygenLayout.xml DoxygenLayout.xml: move akward dep graph to the bottom Sep 7, 2014 aiotdevkit: add readme and link to it Jun 12, 2018
docker-compose.yaml gtest: Organized Gtest unit tests Jul 24, 2018

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 libmraa1 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

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.