Skip to main content

cloud.iO endpoint library

Project description

cloudio-endpoint-python

python-version

version

Python endpoint (IoT device) library for cloud.iO.

The endpoint has been tested with python version 3.x. Support for python version 2.7.x has been removed since v1.0.0. If you still run python v2.x, please use version v0.2.15 of this library.

Introduction

This software allows to represent an IoT device in cloud.iO (the cloud).

To use this software library you need first to understand cloud.iO's network topology. If you don't know exactly the therms (or the difference between) endpoint and client you should first read the introduction to cloud.iO.

Next you need a server on which cloud.iO is running. It is necessary to connect your future IoT device to it. Then you have to get a certificate issued to your IoT device. The connection established between your IoT device and the cloud.iO server is secured. The certificate is needed to authenticate your device through the secure connection.

If the cloud.iO server is already set up you need to contact the system administrator to receive an endpoint certificate. In case you have to set up yourself a cloud.iO server you should jump to

How to set up a cloud.iO Server.

Download and Install

The library is available on python's package distribution system PyPi.

From the console you can download and install it using the following command:


   pip install cloudio-endpoint-python

Development Starting Point

This endpoint library provides you with classes allowing you to store variables or attributes of objects in the cloud. Of course, the other way round is also possible. Means you can change this values in the cloud and they are automatically send to your IoT device.

This library is not a framework - means there is not a part of the library which takes control and executes you code. It is up to you to provide the main function for your software and to instantiate the class objects needed.

The basic idea here is to allow the developer to integrate the cloudio-endpoint library in an existing project and hence allow to extend it with "cloud functionality".

So a good starting point to discover the content of this library is the CloudioEndpoint class. It represents "the door" to cloud.iO seen from within your software. The CloudioEndpoint class (or the instance created from it) establishes and maintains the connection to the cloud.iO server. It holds also the object (attribute) structure of the endpoint. This data structure needs to be set up by the endpoint developer accordingly. It is up to the developer to provide it hard coded or via a file containing the data model.

Endpoint Data Meta-Model

As described in the cloud.iO introduction the object meta-structure is given as follows:

  • An EndPoint can have CloudioNodes

  • CloudioNodes can have CloudObjects

  • CloudObjects can have CloudioObjects and/or CloudioAttributes

The CloudioAttribute objects represent the leafs in the data structure.

A CloudioAttribute is responsible to synchronize a variable or an attribute to the cloud. Hence it gets informed if the attribute changes in the cloud.

To set up your endpoint data model you should first think about how you would like to show up your IoT device in the cloud, keeping in mind the EndPoint->Node->Object->Attribute meta-structure implied.

We encourage you to provide the data model using an XML or JSON based file. The file needs then to be parsed and the CloudioEndpoints object structure set up accordingly. Our course of action is to provide a Connector class which is responsible to do this job. You can find in the tests folder the VacuumCleanerConnector class as an example on how this job me be done.

Links to Internal Documentation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudio-endpoint-python-2.0.0.tar.gz (28.6 kB view details)

Uploaded Source

Built Distribution

cloudio_endpoint_python-2.0.0-py3-none-any.whl (38.5 kB view details)

Uploaded Python 3

File details

Details for the file cloudio-endpoint-python-2.0.0.tar.gz.

File metadata

  • Download URL: cloudio-endpoint-python-2.0.0.tar.gz
  • Upload date:
  • Size: 28.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.7

File hashes

Hashes for cloudio-endpoint-python-2.0.0.tar.gz
Algorithm Hash digest
SHA256 cc007ae6bbb8a6bc454c233d198a63d8dd879762bd7ee2823c3550a4735fd7cf
MD5 2ea36d75136b96787a0751400ff2cd28
BLAKE2b-256 7427b4794673d921ecb6ffa9ff7809f8f0bb9584296619540bbe72a5c666cea2

See more details on using hashes here.

File details

Details for the file cloudio_endpoint_python-2.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cloudio_endpoint_python-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 af5e11eb009ba420a8245bd90c1264117f63640bddc36dfd587493ed34950e2d
MD5 1a66b9bd0cccff0dfa774af26a368eeb
BLAKE2b-256 75e85e11b720f0c3c6eb79ba78114d0ae94bb6e01e1c98df86c32b910b9af6db

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page