README.md

   1 libmraa - Low Level Skeleton Library for Communication on GNU/Linux platforms
   2 ==============
   3
   4 Libmraa is a C/C++ library with bindings to javascript & python to interface
   5 with the IO on Galileo, Edison & other platforms, with a structured and sane
   6 API where port names/numbering matches the board that you are on. Use of
   7 libmraa does not tie you to specific hardware with board detection done at
   8 runtime you can create portable code that will work across the supported
   9 platforms.
  10
  11 The intent is to make it easier for developers and sensor manufacturers to map
  12 their sensors & actuators on top of supported hardware and to allow control of
  13 low level communication protocol by high level languages & constructs.
  14
  15 Supported Boards
  16 ================
  17
  18 X86
  19 ---
  20 * [Galileo Gen 1 - Rev D](../master/docs/galileorevd.md)
  21 * [Galileo Gen 2 - Rev H](../master/docs/galileorevh.md)
  22 * [Edison](../master/docs/edison.md)
  23 * [Intel DE3815](../master/docs/intel_de3815.md)
  24 * [Minnowboard Max](../master/docs/minnow_max.md)
  25
  26 ARM
  27 ---
  28 * [Raspberry Pi - Model B](../master/docs/raspberry_pi_b.md)
  29
  30 Installing on your board
  31 ========
  32
  33 See the section below on compiling or use our repository to install on an
  34 eglibc based yocto poky image that supports opkg. Adding this repository is as
  35 simple as:
  36
  37 ``` bash
  38 echo "src mraa-upm http://iotdk.intel.com/repos/1.1/intelgalactic" > /etc/opkg/mraa-upm.conf
  39 opkg update
  40 opkg install libmraa0
  41 ```
  42
  43 Compiling
  44 =========
  45
  46 See documentation on [building](../master/docs/building.md)
  47
  48 Examples
  49 ========
  50
  51 See the [examples](../../tree/master/examples) available for various languages
  52
  53 Debugging
  54 =========
  55
  56 Sometimes it just doesn't want to work, let us try and help you, you can file
  57 issues in github or join us in #mraa on freenode IRC, hang around for a little
  58 while because we're not necessarily on 24/7, but we'll get back to you! Have a
  59 glance at our [debugging](../master/docs/debugging.md) page too.
  60
  61 C/C++ API Documentation
  62 ===========
  63
  64 The C/C++ documentation is available [here](http://iotdk.intel.com/docs/master/mraa/)
  65
  66 Python API Documentation
  67 ===========
  68
  69 The Python documentation is available [here](http://iotdk.intel.com/docs/master/mraa/python)
  70
  71 NodeJS API documentation
  72 ===========
  73
  74 There is no explicit nodejs API documentation, see the examples. The API itself
  75 is very similar to the python one but with a js syntax. If you know of an
  76 autodoc tool for generating nodejs APIs from a native C++ nodejs extension
  77 please get in touch!