Industrial IoT Messaging and Device Management Server
Clone or download
manuio and drasko MF-433 - Add method for reading messages from readers to SDK. (#511)
* MF-433 - Add method for reading messages from readers to SDK

Signed-off-by: Manuel Imperiale <manuel.imperiale@gmail.com>

* Add messages read command on CLI

Signed-off-by: Manuel Imperiale <manuel.imperiale@gmail.com>

* Fix review

Signed-off-by: Manuel Imperiale <manuel.imperiale@gmail.com>
Latest commit 655141e Dec 18, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github NOISSUE - Housekeeping. Update README. (#497) Dec 9, 2018
cli MF-433 - Add method for reading messages from readers to SDK. (#511) Dec 18, 2018
cmd MF-433 - Add method for reading messages from readers to SDK. (#511) Dec 18, 2018
coap MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
dashflux MF-325 - Add SPDX license and copyright headers (#362) Aug 26, 2018
docker NOISSUE - Add LoRa route map validation and fix LoRa messages URL (#491) Dec 5, 2018
docs MF-448 - Add option to connect to DB with verify-ca and verify-full (#… Dec 15, 2018
http MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
k8s Add nginx ingress config to k8s services (#472) Nov 27, 2018
load-test Add CHANGELOG. Bump version. (#494) Dec 8, 2018
logger Fixing level_test.go (#406) Sep 26, 2018
lora Fix lora-adapter event store handlers (#492) Dec 5, 2018
metrics NOISSUE - Add exported metrics visualization for grafana (#326) Jun 15, 2018
mqtt MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
normalizer MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
readers MF-506 - Fix influx & mongo readers queries to return most recent mes… Dec 18, 2018
scripts MF-486 - Add provisioning command to CLI (#487) Dec 8, 2018
sdk/go MF-433 - Add method for reading messages from readers to SDK. (#511) Dec 18, 2018
things MF-448 - Add option to connect to DB with verify-ca and verify-full (#… Dec 15, 2018
users MF-448 - Add option to connect to DB with verify-ca and verify-full (#… Dec 15, 2018
vendor MF-419 - Use JSON for CLI commands output (#504) Dec 16, 2018
writers Fix data scheme in cassandra writer (#514) Dec 17, 2018
ws MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
.dockerignore NOISSUE - Add .dockerignore to project root (#457) Nov 13, 2018
.gitignore MF-363 - Add compiled .proto files (#364) Aug 24, 2018
CHANGELOG.md NOISSUE - Fix CHANGELOG (#496) Dec 8, 2018
CONTRIBUTING.md NOISSUE - Housekeeping. Update README. (#497) Dec 9, 2018
Gopkg.lock MF-419 - Use JSON for CLI commands output (#504) Dec 16, 2018
Gopkg.toml MF-419 - Use JSON for CLI commands output (#504) Dec 16, 2018
LICENSE MF-199 - Create documentation skeleton (#218) Apr 8, 2018
MAINTAINERS Update MAINTAINERS Aug 28, 2018
Makefile NOISSUE - Add changelog target to Makefile (#493) Dec 8, 2018
README.md NOISSUE - Housekeeping. Update README. (#497) Dec 9, 2018
api.go MF-325 - Add SPDX license and copyright headers (#362) Aug 26, 2018
doc.go MF-325 - Add SPDX license and copyright headers (#362) Aug 26, 2018
env.go MF-325 - Add SPDX license and copyright headers (#362) Aug 26, 2018
internal.pb.go MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
internal.proto MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
message.pb.go MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
message.proto MF-475 - Replace increment ID with UUID (#490) Dec 5, 2018
mkdocs.yml NOISSUE - Move CLI documentation from getting started guide to separa… Nov 27, 2018
publisher.go MF-325 - Add SPDX license and copyright headers (#362) Aug 26, 2018
topics.go MF-325 - Add SPDX license and copyright headers (#362) Aug 26, 2018
version.go Add CHANGELOG. Bump version. (#494) Dec 8, 2018

README.md

Mainflux

build go report card coverage license chat

banner

Mainflux is modern, scalable, secure open source and patent-free IoT cloud platform written in Go.

It accepts user, device, and application connections over various network protocols (i.e. HTTP, MQTT, WebSocket, CoAP), thus making a seamless bridge between them. It is used as the IoT middleware for building complex IoT solutions.

For more details, check out the official documentation.

Mainflux is member of the Linux Foundation and an active contributor to the EdgeX Foundry project. It has been made with ❤️ by Mainflux company, which maintains the project and offers professional services around it.

Features

  • Multi-protocol connectivity and protocol bridging (HTTP, MQTT, WebSocket and CoAP)
  • Device management and provisioning
  • Fine-grained access control
  • Storage support (Cassandra, InfluxDB and MongoDB)
  • Platform logging and instrumentation support
  • Event sourcing
  • Container-based deployment using Docker and Kubernetes
  • LoRaWAN network integration
  • SDK
  • CLI
  • Small memory footprint and fast execution
  • Domain-driven design architecture, high-quality code and test coverage

Install

Before proceeding, install the following prerequisites:

Once everything is installed, execute the following commands from project root:

docker-compose -f docker/docker-compose.yml up -d

This will bring up all Mainflux dockers and inter-connect them in the composition.

Usage

Best way to quickstart using Mainflux is via CLI:

make cli
./build/mainflux-cli version

Mainflux CLI can also be downloaded as a tarball from offical release page

If this works, head to official documentation to understand Mainflux provisioning and messaging.

Documentation

Official documentation is hosted at Mainflux Read The Docs page.

Documentation is auto-generated from Markdown files in ./docs directory. If you spot an error or need for corrections, please let us know - or even better: send us a PR.

Additional practical information, news and tutorials can be found on the Mainflux blog.

Authors

Main architect and BDFL of Mainflux project is @drasko.

Additionally, @nmarcetic and @janko-isidorovic assured overall architecture and design, while @manuIO and @darkodraskovic helped with crafting initial implementation and continiusly work on the project evolutions.

Besides them, Mainflux is constantly improved and actively developed by @anovakovic01, @dusanb94, @srados, @gsaleh, @blokovi, @chombium and a large set of contributors.

Maintainers are listed in MAINTAINERS file.

Contributing

Thank you for your interest in Mainflux and wish to contribute!

  1. Take a look at our open issues.
  2. Checkout the contribution guide to learn more about our style and conventions.
  3. Make your changes compatible to our workflow.

We're Hiring

If you are interested in working professionally on Mainflux, please head to company's careers page or shoot us an e-mail at careers@mainflux.com.

Note that the best way to grab our attention is by sending PRs 😎.

Community

License

Apache-2.0