Overview
Welcome to thin-edge.io's documentation!
thin-edge.io is an open-source development toolbox designed for rapid development of IoT agents. It is based on a versatile set of ready-to-use software components that can be easily combined with application-specific extensions into smart, secure, robust and efficient IoT agents which integrate cloud services, edge computing and operational technologies.
A typical agent uses as a foundation the building blocks provided by thin-edge.io for telemetry data processing and cloud connectivity as well as for device monitoring, configuration and updates. In combination with these blocks, the agent designer can provide application-specific extensions, which cooperate with thin-edge.io over MQTT and HTTP along a JSON API, to address any hardware, protocol or use-case specificity.
As such, thin-edge.io is good choice for implementing smart-equipment
that collect in-situ real-time data, perform analytics on the edge, forward key data to the cloud,
and need to be secured, configured and updated at scale.
How to start​
The easiest way to get started is either to install the docker based demo container that showcases thin-edge.io and all its features or with the beginner-friendly tutorial that introduces thin-edge.io and guides you on how to install it on a Raspberry Pi. After the installation you can directly connect your device to Cumulocity IoT, and then monitor it from the cloud.
You can also explore the main use-cases using these tutorials. You will learn to:
- install thin-edge.io on your specific hardware,
- connect your device to your cloud, whether Cumulocity IoT, Azure IoT or AWS IoT,
- send telemetry data, alarms and events,
- operate, configure, update, monitor your device.
The concepts​
Better understand how thin-edge.io works by reviewing the core Concepts.
How to operate a device​
thin-edge.io provides a set of building blocks to operate, configure, update, monitor your devices.
- Use the how-to guides on a daily basis
- Refer to the reference guides for any in-depth details
How to extend​
One of the core feature of thin-edge.io is to be extensible.
- Write a software-management plugin
- Build Operating System images with thin-edge.io setup to perform Over-the-Air (OTA) updates
How to contribute​
thin-edge.io is an open-source project released under the Apache License - Version 2.0.
All contributions are greatly appreciated. It can be by reporting issues, improving this documentation, adding new extensions or contributing to the main code base.
Please refer to the contribution guide and the contributor documentation.