Skip to content

macchina.io is a toolkit for building IoT edge and fog device applications in JavaScript and C++

License

Notifications You must be signed in to change notification settings

bas524/macchina.io

 
 

Repository files navigation

macchina.io

macchina.io Edge Device SDK is a powerful application software platform for IoT devices.

With macchina.io you can rapidly build and deploy device applications that communicate with devices, sensors, actuators, cloud services, and humans.

macchina.io provides a web-enabled, secure, modular and extensible C++ and JavaScript IoT application environment on top of Linux, consisting of middleware, protocols and rich APIs. macchina.io provides ready-to-use and industry proven software building blocks that enable applications to collect, process, filter, analyze and visualize sensor, machine and process data locally, directly where it originates, and where the action happens. macchina.io enables IoT edge and fog computing.

macchina.io runs on Linux-based devices, including IoT gateways, industrial computing devices, and prototyping platforms like the Raspberry Pi, Beaglebone and MangOH.

macchina.io is based on the POCO C++ Libraries and uses the V8 JavaScript engine.

For more information, including documentation, please see the macchina.io website. There are also a couple of useful articles and How-To's in the project wiki.

Build Status

  • Travis: Travis Build Status

Prerequisites

  • GNU Make 3.81 or newer
  • Linux: GNU C++ (g++) 4.9 or newer; alternatively Clang++ 3.4 or newer
  • macOS: Clang++ (Apple LLVM) 8.0 or newer
  • OpenSSL headers and libraries (on macOS, via Homebrew: brew install openssl)
  • Python 2.7 (for building V8)

Getting Started

For the impatient, using a Linux or macOS machine:

$ git clone https://github.com/macchina-io/macchina.io.git
$ cd macchina.io
$ git checkout master
$ make -s -j8 DEFAULT_TARGET=shared_release

Then, on Linux:

$ export LD_LIBRARY_PATH=`pwd`/platform/lib/Linux/x86_64
$ cd server
$ bin/Linux/x86_64/macchina

On macOS:

$ export DYLD_LIBRARY_PATH=`pwd`/platform/lib/Darwin/x86_64
$ cd server
$ bin/Darwin/x86_64/macchina

Then direct your favorite web browser to http://localhost:22080 and log in with username 'admin' and password 'admin'.

For more detailed instructions, including how to cross-compile for embedded Linux targets, as well as an introduction to writing JavaScript code for macchina.io, see the documentation, specifically Introduction and Overview and Getting Started with macchina.io.

Contributions

We welcome contributions! Specifically we're looking for new sensor and device implementations, as well as additional protocols. Please see our CONTRIBUTING document to get started.

About

macchina.io is a toolkit for building IoT edge and fog device applications in JavaScript and C++

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 63.2%
  • JavaScript 22.2%
  • C 11.7%
  • Python 2.4%
  • HTML 0.2%
  • Makefile 0.1%
  • Other 0.2%