python-devicecloud¶
Documention Map¶
Introduction¶
Python-devicecloud is a library providing simple, intuitive access to the Digi Device Cloud for clients written in Python.
The library wraps Device Cloud REST API and hides the details of forming HTTP requests in order to gain access to device information, file data, streams, and other features of Device Cloud. The API wrapped can be found here.
The primary target audience for this library is individuals interfacing with Device Cloud from the server side or developers writing tools to aid device development. For efficient connectivity from devices, we suggest that you first look at using the Device Cloud Connector. That being said, this library could also be used on devices if deemed suitable.
The library provides access to a wide array of features, but here is a quick example of what the API looks like:
from devicecloud import DeviceCloud
dc = DeviceCloud('user', 'pass')
# show the MAC address of all devices that are currently connected
#
# This is done using Device Cloud DeviceCore functionality
print "== Connected Devices =="
for device in dc.devicecore.get_devices():
if device.is_connected():
print device.get_mac()
# get the name and current value of all data streams having values
# with a floating point type
#
# This is done using Device Cloud stream functionality
for stream in dc.streams.get_streams():
if stream.get_data_type().lower() in ('float', 'double'):
print "%s -> %s" % (stream.get_stream_id(), stream.get_current_value())