Thinking Cleaner and Huisautomatisering

API (Application Programming Interface)

Uw huisautomatiseringssysteem koppelen met Thinking Cleaner

Beschikbare plugins/drivers voor huisautomatiserieng systemen (Domotica):
- IFTTT (mbv Maker kanaal)
- Homey
- Thermosmart (in ontwikkeling)
- HomeWizard
- Gira Homeserver (KNX)
- Fibaro
- SmartThings
- Pebble
- Vera Mios
- HomeSeer
- Indigo domotics (in ontwikkeling)
- Hubware SARAH
- PHEM
- Homekit
- Universele API. Er is ook een API voor alle andere systemen waar nog geen plugin/driver voor gemaakt is!
- Publieke server API



IFTTTIFTTT (mbv Maker channel)
U kunt IFTTT gebruiken om uw Thinking Cleaner te starten of naar zijn dock te sturen. Op dit moment hebben we alleen een engelstaling handleiding maar die zullen we zo snel mogelijk vertalen. Klik hier voor de IFTTT setup pagina.

IFTTT (we hebben nog steeds uw hulp nodig)

Op dit moment hebben we nog geen eigen IFTTT kanaal beschikbaar. We doen ons best maar helaas krijgen we weinig respons van IFTTT op onze aanvragen. Mocht u graag een IFTTT kanaal voor de Thinking Cleaner zien stuur dan een verzoek naar @IFTTT op twitter of IFTTT op facebook en vraag of ze de Thinking Cleaner willen toevoegen. Als genoeg mensen dit doen hopen we binnenkort een eigen IFTTT kanaal te hebben.


Scroll naar beneden voor meer informatie over de verschillende plugins...



Homey plugin/app:Homey
Voor Homey (http://www.athom.nl) is een plugin (Homey app) gemaakt. U kunt deze vinden in de app-store van homey.

Homey



Thermosmart:Thermosmart
Thermosmart (http://www.thermosmart.nl) heeft binnenkort ook Thinking Cleaner ondersteuning. Op basis van de thermostaat die uit of aan staat kunt u de Thinking Claner bedienen.





HomeWizard:HomeWizard
Thinking Cleaner zit als standaard component in HomeWizard. Om een Thinking Cleaner te koppelen met HomeWizard kunt u naar "Nieuwe Sensor" gaan en daar de Thinking Cleaner kiezen. Als hij eenmaal in Homewizard staat kunt u de Roomba in een Scene automatisch laten starten.

HomeWizard


Gira Homeserver (KNX):
Gira Homeserver heeft een eenvoudige interface om HTTP commando's te versturen. Voorbeeld van een HTTP commando om Roomba te starten: http://IP_ROOMBA/command.json?command=clean
Om gegevens uit de Thinking Cleaner te lezen is er een Gira Homeserver compatible XML file. Meer informatie over deze XML file en de commando's die naar de Thinking Cleaner gestuurd kunnen worden kunt u vinden in het Thinking Cleaner API document

Gira_HomeserverGira_Homeserver



Fibaro:Fibaro
Voor Fibaro is er een plugin beschikbaar. U kunt de bestanden vinden op de Fibaro forum website. Ook voor vragen over de installatie kunt u hier terecht: Fibaro forum link.




Fibaro plugin on Android




SmartThings plugin (pmjoen):SmartThings
De perfecte pluging om de Thinking Cleaner te koppelen aan uw Smartings systeem.

Dit is de link naar de SmartThings community.




Pebble app (gemaakt door Tim):Pebble
Zelfs voor de Pebble is er een app! Ga naar de Pebble app store om de app te downloaden: Pebble app store.






Pebble app screenshot 0   Pebble app screenshot 1   GPebble app screenshot 2




Vera Mios plugin (gemaakt door OtelConsulting):Vera

The Vera Mios plugin is hier te downloaden:

Vera Mios app store.






Vera screenshot 0   Vera screenshot 1




HomeSeer plugin (gemaakt door Rien):Homeseer

De HomeSeer plugin is beschikbaar via de Homeseer app store. Dank aan Rien du Pre voor het gratis beschikbaar stellen van deze plugin.

Hier de link naar de pdf documentatie.

Homeseer screenshot 1





Indigo Domotics:Indigo domotics
Klik hier voor de indigo plugin voor Thinking Cleaner.




Hubware: http://hubware.house/sarahHubware

Thinking Cleaner is standaard al geinstalleerd op elke SARAH Versie (SARAH basic, standard en pro). De gebruiker hoeft alleen de gateway te activeren en dan zal SARAH gaan zoeken naar Thinking Cleaners in hetzelfde netwerk.



FHEM Home automation:FHEM logo
Dankzij Julian is er nu voor het OpenSource home automation platform FHEM een Thinking Cleaner ondersteuning. Klik hier voor meer informatie.









Homekit:Homekit
De huidige Thinking Cleaner heeft geen Homekit ondersteuning omdat daar extra encryptie hardware voor nodig is. Maar er is wel een manier om toch Homekit te gebruiken voor de Thinking Cleaner, zie: https://github.com/nfarina/homebridge. Deze software draait op een lokale computer (of Raspberry Pi met NodeJS) en werkt dan met een Homekit app op je iPhone (zoals MyTouchHome, Insteon+ of andere apps) en dan is het mogelijk om met Siri Roomba te starten. Er is ook een voorbeeld van een Thinking Cleaner plugin, zie: Thinkingcleaner plugin voor Homebridge.





UNIVERSELE API

Voor alle andere Home automation systemen is er een API beschikbaarThinking Cleaner API

Er is een API beschikbaar voor directe communicatie met de Thinking Cleaner. De meeste communicatie gaat met behulp van json calls, maar omdat sommige huisautomatiserings systemen geen json kunnen lezen hebben we de status en schedules ook in xml gezet.


Webhook (in firmware V1.0.84 en hoger)
In de web-app zit ook de mogelijkheid om een webhook in te stellen. Meer hierover staat in het API document.
De documentatie van deze API kunt u hier
downloaden. De API is nog steeds in ontwikkeling en er kunnen aanpassingen of toevoegingen gemaakt worden zonder aankondiging. De huidige versie van het document is V1.8.




Publieke server API
De Thinking Cleaner server heeft een publieke API. Daarvoor gebruikt de server OAuth2 voor authorisatie (http://oauth.net). Als u gebruikt wilt maken van deze API stuur dan een verzoek naar support@thinkingbits.nl en u krijgt van ons dan een application key en secret key toegestuurd.

Op dit moment zijn de volgende queries beschikbaar:

get '/oapi/v1/devices'

Deze request geeft een lijst van alle Thinking Cleaners van de gebruiker. Ook Thinking Cleaners die offline zijn. Voor een lijst van actieve Thinking Cleaners, gebruik dan '/api/v1/discover/devices'.

get '/devices/'

Hiermee krijgt u de status van de Thinking Cleaners terug.

get '/devices//pending_commands'

Geeft een lijst van alle commando's die nog niet uitgevoerd zijn maar dus al wel klaarstaan op de server. Als een commando via de server wordt verstuurd kan het 1 minuut duren voor het commando wordt uitgevoerd door de Thinking Cleaner. Zodra de Thinking Cleaner het commando heeft uitgevoerd verdwijnt het commando uit de lijst. Als een Thinking Cleaner offline is blijven de commado's hier in staan.

post '/devices/:uuid/add_command'

Deze request heeft een commando nodig in de post body. De volgende commando's zijn geldig: clean, dock, find_me, max en stop.

clean: start cleaning
dock: start docking
find_me: speel het 'find me' deuntje op de Roomba
max: start een max cleaning (clean tot de accu bijna leeg is en ga dan naar laadstation)
stop: forceer stop de Roomba