This repo builds upon the IQT Labs EdgeTech-Core functionality to instantiate an MQTT client that subscribes to the telemetry topic and POST[s] it to an HTTP endpoint (currently we are using TagoIO). All of this functionality is wrapped in a Docker container for cross-platform compatibility.
Make Contribution
·
Report Bug
·
Request Feature
To run this repo, simply run:
docker-compose up
The HTTP uploader is containerized and dependencies are managed using poetry.
Running this repo requires that you have Docker installed.
Spinning up this system requires an MQTT server and this container to be included in your docker-compose.yml. You can find an example of this workflow in this repository's docker-compose.yml. Additionally, some editing of relevant environment variables will be required based upon your system's configuration of topics to subscribe to and MQTT configuration. Examples of these environment variables can be found in this repository's .env file.
Copying the http-uploader docker-compose statements into a master docker-compose.yml and .env files with your entire system of containers is the preferred workflow. Find an application architecture diagram example of how the usage of this module was envisioned below.
flowchart TD
telemetrydata(Telemetry Data) -- Telemetry Topic --> mqtt{MQTT}
mqtt{MQTT} -- Subscribed to Telemetry Topic --> http-uploader(HTTP Uploader)
style mqtt fill:#0072bc,color:#ffffff
style http-uploader fill:#F9D308,color:#ffffff
style telemetrydata fill:#80c342,color:#ffffff
- TBA
See the open issues for a full list of proposed features (and known issues).
- Fork the Project
- Create your Feature Branch (
git checkout -b dev) - Commit your Changes (
git commit -m 'adding some feature') - Run (and make sure they pass):
black --diff --check *.py
pylint --disable=all --enable=unused-import *.py
mypy --allow-untyped-decorators --ignore-missing-imports --no-warn-return-any --strict --allow-subclassing-any *.py
If you do not have them installed, you can install them with pip install "black<23" pylint==v3.0.0a3 mypy==v0.991.
- Push to the Branch (
git push origin dev) - Open a Pull Request
See CONTRIBUTING.md for more information.
Distributed under the Apache 2.0. See LICENSE.txt for more information.
- Twitter: @iqtlabs
- Email: info@iqtlabs.org
See our other projects: https://github.com/IQTLabs/