69e18e2508cc18366c8865f2277a1e2088b4dfd2
[contrib/mraa.git] / 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 C/C++ API Documentation
54 ===========
55
56 The C/C++ documentation is available [here](http://iotdk.intel.com/docs/master/mraa/)
57
58 Python API Documentation
59 ===========
60
61 The Python documentation is available [here](http://iotdk.intel.com/docs/master/mraa/python)
62
63 NodeJS API documentation
64 ===========
65
66 There is no explicit nodejs API documentation, see the examples. The API itself
67 is very similar to the python one but with a js syntax. If you know of an
68 autodoc tool for generating nodejs APIs from a native C++ nodejs extension
69 please get in touch!