{ "info": { "author": "The Hiveeyes Developers", "author_email": "hello@hiveeyes.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: Science/Research", "License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)", "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)", "Natural Language :: English", "Operating System :: MacOS :: MacOS X", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Topic :: Communications", "Topic :: Internet", "Topic :: Scientific/Engineering", "Topic :: Software Development :: Libraries", "Topic :: System :: Archiving", "Topic :: Terminals :: Serial", "Topic :: Text Processing", "Topic :: Utilities" ], "description": "##############\nBERadio README\n##############\n\n.. tip::\n\n You might want to continue reading at the `official BERadio documentation`_,\n all inline links will be working there.\n\n*****\nAbout\n*****\n*BERadio* is an encoding specification and implementation for efficient communication in\nconstrained radio link environments.\nIt is conceived and used for over-the-air communication within the `Hiveeyes project`_.\n\nTogether with Kotori_, a multi-channel, multi-protocol data acquisition and graphing toolkit\nfor building flexible telemetry solutions, it powers the `Hiveeyes system`_\non the gateway side, which you can enjoy by visiting the `Hiveeyes platform`_.\n\n\n***********\nEnvironment\n***********\nThere are a number of Arduino sensor nodes in the field communicating unidirectionally\nvia radio link to a central Arduino acting as a gateway. The gateway Arduino receives\nmessage payloads and writes them verbatim to the serial port connected to a Raspberry Pi,\nwhich transforms and forwards the messages to a MQTT bus.\n\nThe data now being on the bus, arbitrary systems can consume information by subscribing\nto specific MQTT topics where measurement events are delivered.\n\nThe Kotori multichannel DAQ subscribes to topics on the MQTT bus, receives telemetry data\npayloads and stores the measurements into a contemporary timeseries database.\nAfter that, Grafana is used to display the measurement information.\n\n\n*******\nDetails\n*******\n\nFeatures\n========\n*BERadio* is a specification and also provides reference implementations for Arduino and Python.\n\n- Some details have been written down in the `BERadio specification`_ document.\n- It uses the ``Bencode`` format on the wire to provide space-efficient data encoding.\n- ``beradio forward`` processes data messages received over the air and forwards them to MQTT.\n- ``libberadio`` will be an appropriate C++ library for Arduino.\n\n\nThe main workhorse\n==================\n``beradio forward`` ingests message payloads from a serial interface, sanitizes and\ndecodes them from ``Bencode`` format and republishes the data to a MQTT topic.\n\nThe MQTT topic name used for publishing is derived from some parameters contained\nin the data of the message, the topic template used for this is currently programmed\nto ``{realm}/{network}/{gateway}/{node}/{field}``.\nThe actual values will get separated, mapped and formatted in different\nvariants before republishing them to MQTT.\n\n\n*******************\nProject information\n*******************\n\nContributing\n============\nWe are always happy to receive code contributions, ideas, suggestions\nand problem reports from the community.\nSpend some time taking a look around, locate a bug, design issue or\nspelling mistake and then send us a pull request or create an issue ticket.\n\nThanks in advance for your efforts, we really appreciate any help or feedback.\n\nLicense\n=======\nThis software is copyright \u00a9 2015-2018 The Hiveeyes developers. All rights reserved.\n\nUse of the source code included here is governed by the\n`GNU Affero General Public License `_ and the\n`European Union Public License `_.\nThe software is and will always be **free and open source software**.\n\n\n.. _GNU-AGPL-3.0: https://www.gnu.org/licenses/agpl-3.0-standalone.html\n.. _EUPL-1.2: https://opensource.org/licenses/EUPL-1.1\n\n\n\n.. _official BERadio documentation: https://hiveeyes.org/docs/beradio/\n.. _Kotori: https://getkotori.org/\n.. _Hiveeyes project: https://hiveeyes.org/\n.. _Hiveeyes system: https://hiveeyes.org/docs/system/\n.. _Hiveeyes platform: https://swarm.hiveeyes.org/\n.. _Bencode: https://en.wikipedia.org/wiki/Bencode\n.. _BERadio specification: https://hiveeyes.org/docs/beradio/beradio.html", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://hiveeyes.org/docs/beradio/", "keywords": "protocol rfm serial mqtt Bencode BERadio", "license": "AGPL 3, EUPL 1.2", "maintainer": "", "maintainer_email": "", "name": "beradio", "package_url": "https://pypi.org/project/beradio/", "platform": "", "project_url": "https://pypi.org/project/beradio/", "project_urls": { "Homepage": "https://hiveeyes.org/docs/beradio/" }, "release_url": "https://pypi.org/project/beradio/0.12.3/", "requires_dist": null, "requires_python": "", "summary": "BERadio is an encoding specification and implementation for efficient communication in constrained radio link environments. It is conceived and used for over-the-air communication within the Hiveeyes project.", "version": "0.12.3" }, "last_serial": 4049188, "releases": { "0.12.0": [ { "comment_text": "", "digests": { "md5": "e4a7efda6e4e47b4cd6d00fad4fa3281", "sha256": "5fe7112af6c5febeb9b0a05f26e62cedfa328c65776f5facb89976918b196d52" }, "downloads": -1, "filename": "beradio-0.12.0.tar.gz", "has_sig": false, "md5_digest": "e4a7efda6e4e47b4cd6d00fad4fa3281", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57414, "upload_time": "2018-07-10T23:21:43", "url": "https://files.pythonhosted.org/packages/bd/70/03a64e5327abf0ce84e74d9d9df73f5bc4a9dfe9a693cca023abe49679dd/beradio-0.12.0.tar.gz" } ], "0.12.1": [ { "comment_text": "", "digests": { "md5": "207a22bbceec8d74ff466911027d0c27", "sha256": "40a3d92bea7b3a17e4b494f8f83c9d2c806e4fa123c97dce69a85afc430ce296" }, "downloads": -1, "filename": "beradio-0.12.1.tar.gz", "has_sig": false, "md5_digest": "207a22bbceec8d74ff466911027d0c27", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57433, "upload_time": "2018-07-10T23:34:24", "url": "https://files.pythonhosted.org/packages/31/df/e1f8423944ef113050845e603bd9db8c9919e2c8cd271ab2b96a9d0e2cc0/beradio-0.12.1.tar.gz" } ], "0.12.2": [ { "comment_text": "", "digests": { "md5": "a5a6fd37dd10e0d31f306c67ff3c03fb", "sha256": "5683f64e4c2fcf486ed6e43d03a72ebd6e706147f9210bdaec6bb3535533261a" }, "downloads": -1, "filename": "beradio-0.12.2.tar.gz", "has_sig": false, "md5_digest": "a5a6fd37dd10e0d31f306c67ff3c03fb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57782, "upload_time": "2018-07-11T00:21:19", "url": "https://files.pythonhosted.org/packages/1c/d2/8d299ec773dc16c47a5e011133765f9411a1d85caef750e62016004756a9/beradio-0.12.2.tar.gz" } ], "0.12.3": [ { "comment_text": "", "digests": { "md5": "151e6318613ad8fbb7dd082e6930738f", "sha256": "938d7fa9f4395215cdd9601cecb3e02bb15db0221ebcbccd08ee2ff039b41619" }, "downloads": -1, "filename": "beradio-0.12.3.tar.gz", "has_sig": false, "md5_digest": "151e6318613ad8fbb7dd082e6930738f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57805, "upload_time": "2018-07-11T00:33:27", "url": "https://files.pythonhosted.org/packages/3c/04/c45989f5f077d51fe9bd865aebeb7cb54926bb2c488fd27ce457c960afc9/beradio-0.12.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "151e6318613ad8fbb7dd082e6930738f", "sha256": "938d7fa9f4395215cdd9601cecb3e02bb15db0221ebcbccd08ee2ff039b41619" }, "downloads": -1, "filename": "beradio-0.12.3.tar.gz", "has_sig": false, "md5_digest": "151e6318613ad8fbb7dd082e6930738f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57805, "upload_time": "2018-07-11T00:33:27", "url": "https://files.pythonhosted.org/packages/3c/04/c45989f5f077d51fe9bd865aebeb7cb54926bb2c488fd27ce457c960afc9/beradio-0.12.3.tar.gz" } ] }