README.md

   1 MAA - Low Level Skeleton Library for Communication on Intel platforms
   2 ==============
   3
   4 Library in C/C++ to interface with Galileo & other Intel platforms over:
   5
   6 - I2C
   7 - SPI
   8 - GPIO
   9 - PWM
  10 - AIO
  11
  12 In a structured and sane API with port nanmes/numbering that match boards &
  13 with bindings to javascript & python.
  14
  15 The intent is to make it easier for developers and sensor manufacturers to map
  16 their sensors & actuators on top of supported hardware and to allow control of
  17 low level communication protocol by high level languages & constructs.
  18
  19 ### ENV RECOMENDATIONS
  20
  21 All of these are 'optional', however they are recommended. Only a C compiler,
  22 cmake and default system libraries are technically required to compile.
  23
  24 1. node.js 0.10.26
  25 2. python 3.3.x or 2.7.x
  26 3. swig-v8 3.0.1 (swig 2.x will work but you will not be able to build node.js
  27 module so comment out add_directories(javacsript) in src/CmakeLists.txt)
  28 4. doxygen (needed to generate even python doc)
  29 5. sphinx
  30 6. pygments
  31 7. pydoc
  32
  33 To install swig-v8 the swig-v8-git package from AUR is helpful.
  34
  35 ## COMPILING
  36
  37 NOTE: The **only** supported cmake build configuration is to have the build/ dir
  38 inside of the repo/tarball.
  39
  40 *if swig-v8 is not in your default path you can try run cmake with
  41 "-DCMAKE_PREFIX_PATH="/path/to/swig-v8"*
  42
  43 mkdir build/
  44 cmake ..
  45 make
  46
  47 ## DEVELOPMENT
  48
  49 Please fork the code on github and then send pull requests. Please avoid merges
  50 in your forks. I will also accept patches sent in git style with signoffs to
  51 brendan.le.foll@intel.com
  52
  53 ## USING
  54
  55 see examples/
  56
  57 *for node.js make sure that maajs.node is in the current dir and set export
  58 NODE_PATH=.*
  59
  60 Simple python html documentation can be generated with **make pydoc**, this
  61 does not require the full doxygen/sphinx setup.
  62
  63 ## API Changelog
  64
  65 When the API breaks in a small way there will be a changelog listed here
  66
  67 **0.2.5**
  68   * C++/Python/Node Enums/const names now do not contain MAA_GPIO
  69   * Enum type declaration for C++ changed
  70   * Python/Node get_version() -> GetVersion()
  71   * i2c read calls don't use const char* and i2c write calls do
  72
  73 **0.2.4**
  74   * All maa_ contexts now are pointers to the actual struct which is not
  75     delcared in the header. The only end user change is that instead of
  76     returning a type maa_gpio_context pointer maa_gpio_init() now returns a
  77     maa_gpio_context (which is actually a pointer to struct _gpio internally).
  78   * C++ API is available, use the .hpp headers and add stdc++  to the linker
  79     flags.
  80   * Initial SPI implementation is provided
  81
  82 **0.2.3**
  83   * maa_aio_read_u16() -> maa_aio_read()
  84   * maa_aio_read() now returns a uint16_t instead of an unsigned int
  85
  86 **0.2.2**
  87   * First version with API considered 'stable'