fc4b2a554d
Updates to make the FT4222 platform extender more usable.
Previous implementation opened libft4222.so and loaded symbols as
needed. This implementation removes dynamic loading of libft4222 in
favor of creating a new shared libary which links against libft4222.so.
The dynamic loading is now done in mraa.c. One C method is exposed in
libmraa-platform-ft4222.so for finding/initializing an FT4222:
mraa_platform_t mraa_usb_platform_extender(mraa_board_t* board);
Mraa.c attempts to open this platform library and calls the
mraa_usb_platform_extender method. If an ftdi4222 is connected, the
user gets added IO from the extender. If no FT4222 device is connected,
continue as normal.
* Create a new platform library for the FT4222
* Expose only 1 C method from the library -
mraa_usb_platform_extender
* libmraa-platform-ft4222.so contains CXX code (as well as previous
C code). All *allocs have been removed in favor of global
C++ stl containers.
* Previously, the FT4222 would only initialize correctly if 2 ftdi
devices existed. Now, initialize FT4222 devices based on the
device id.
* Many fixes for various problems with the FT4222
* Added unit test for platform extender (minimal functionality w/o hw)
* Updated to FindFtd4222.cmake module to handle standard arguments
* Removed CMAKE_C_FLAGS addition of -DFTDID2XX and -DFTDI4222 since
these are NOT used anywhere in source.
* Building the FTDI4222 shim requires libft4222.h which requires
ftd2xx.h. Updated CMakeLists.txt to require both when building
the shim.
Signed-off-by: Noel Eck <noel.eck@intel.com>
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.
Supported Boards
X86
- Galileo Gen 1 - Rev D
- Galileo Gen 2 - Rev H
- Edison
- Intel DE3815
- Minnowboard
- NUC 5th generation
- UP
- UP Squared
- Intel Joule
- IEI Tank
ARM
MIPS
FPGA
USB
I2C
Mock
JSON platform
Installing on your board
Installing on Ubuntu
Here is a PPA for installing on Ubuntu Xenial or Bionic: https://launchpad.net/~mraa/+archive/ubuntu/mraa
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: https://aur.archlinux.org/packages/mraa
Install on openSUSE
REPO="openSUSE_Tumbleweed"
if test "$(arch)" == "aarch64"; then
REPO="openSUSE_Factory_ARM"
fi
sudo zypper ar http://download.opensuse.org/repositories/hardware/$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.
Compiling
See documentation on building
Examples
See the examples available for various languages
Debugging
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.
Changelog
Version changelog here.