LittleBits CloudBit with Python Requests - Part 2 Input and Output

In part 1 of the blog, I gave an example to get started on the LittleBits CloudBit and query the device status. In part 2, let's look at how to get input and output from the CloudBit. In its current iteration, there is only one physical input and one physical output.

In my setup I have an 'i3 button' as the input and 'o9 bargraph' as the output:

In the v2 documentation, there was no specific documentation on input, just output. 

https://api-http.littlebitscloud.cc/v3/devices/00e04c03755a/

http://developer.littlebitscloud.cc/#-devices-device-id-output

After opening a case with LittleBits, I was given the pre-release v3 API documentation (Thanks! Theodore from LittleBits): 

https://github.com/littlebits/cloud-api-lessons#lesson-2-read-from-cloudbit

Following the example on the page, the input and output sample are below (note the different v3 endpoint than v2): 

• Output

$ curl -i -XPOST -H "Authorization: Bearer <token>" https://api-http.littlebitscloud.cc/v3/devices/<id>/output -d percent=50 -d duration_ms=5000

HTTP/1.1 200 OK

access-control-allow-headers: Authorization, Content-Type, If-None-Match

access-control-allow-methods: GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS

access-control-allow-origin: *

access-control-expose-headers: WWW-Authenticate, Server-Authorization

access-control-max-age: 86400

cache-control: no-cache

content-type: application/json; charset=utf-8

Date: Mon, 20 Jul 2015 04:47:37 GMT

Content-Length: 16

Connection: keep-alive

{"success":true}

• Input (stream)

$ curl -i -H "Authorization: Bearer <token>" https://api-http.littlebitscloud.cc/v3/devices/<id>/input

HTTP/1.1 200 OK

access-control-allow-headers: Authorization, Content-Type, If-None-Match

access-control-allow-methods: GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS

access-control-allow-origin: *

access-control-expose-headers: WWW-Authenticate, Server-Authorization

access-control-max-age: 86400

cache-control: no-cache

content-encoding: identity

content-type: text/event-stream; charset=utf-8

Date: Mon, 20 Jul 2015 04:49:44 GMT

transfer-encoding: chunked

Connection: keep-alive

data:{"type":"input","timestamp":1437367785035,"from":{"socket":{"remotePort":<port>,"remoteAddress":"<id>","localAddress":"<addr>","localPort":<port>,"id":"<id>"},"server":{"id":"<id>"},"user":{"id":<id>},"device":{"id":"<id>","device":"littlebits-module-cloud","setup_version":"1.0.0","protocol_version":"1.1.0","firmware_version":"1.0.140820b","mac":"<mad>","hash":"<hash>","ap":{"ssid":"<ssid>","mac":"<mac>","strength":<strength>},"settings":{"label":"<label>","input_interval_ms":750}},"is_identified":true},"percent":0,"absolute":0,"name":"amplitude","payload":{"percent":0,"absolute":0}}

Of which, when press the button, the payload percent and absolute value changes accordingly. 

Converting the two Input and Output Curl to Python were not too difficult, thanks again to the awesome Request package: 

• Output Script

#!/usr/env/bin python

import json

import requests

deviceId = "<id>"

littleBitsOutputUrl = "https://api-http.littlebitscloud.cc/v3/devices/" + deviceId + "/output"

authToken = "<token>"

headers = {"Authorization": "Bearer "+authToken, "Content-type": "application/x-www-form-urlencoded"}

body = "percent=50&duration_ms=5000"

r = requests.post(littleBitsOutputUrl, headers=headers, data=body)

print r.status_code

- Execution

$ python CloudbitOputput.py

200

• Input Script

#!/usr/env/bin python

import json

import requests, time

deviceId = "<id>"

littleBitsInputUrl = "https://api-http.littlebitscloud.cc/v3/devices/" + deviceId + "/input"

authToken = "<token>"

headers = {"Authorization": "Bearer "+authToken}

r = requests.get(littleBitsInputUrl, headers=headers, stream=True)

for line in r.iter_lines():

    if line:

        result = json.loads(line.split('data:')[1])

        print result['payload']

- Execution

$ python CloudbitInput.py

{u'percent': 0, u'absolute': 0}

{u'percent': 0, u'absolute': 0}

{u'percent': 0, u'absolute': 0}

{u'percent': 100, u'absolute': 1023}

{u'percent': 100, u'absolute': 1023}

{u'percent': 100, u'absolute': 1023}

{u'percent': 100, u'absolute': 1023}

{u'percent': 100, u'absolute': 1023}

{u'percent': 100, u'absolute': 1023}

{u'percent': 0, u'absolute': 0}

{u'percent': 0, u'absolute': 0}

{u'percent': 0, u'absolute': 0}

Happy Coding!