SmartHome XS1

This app is for controlling the smart home XS1 unit from EZcontrol

Sources available here: https://bitbucket.org/vmayer/smarthome-xs1

Android App for Smarthome XS1 device allows controlling hardware and using home automation. ONLY WORKS WITH XS1 FIRMWARE ABOVE 3.xx!!

manage all your actuators

add and remove objects

support for timers, sensors and scripts

abo service can be left running without app opened

support for own makros

support for communication through own apps with intents

learn mode for your new actuators

Positioning-tool for automatically executing makros when entering/leaving area

Timed Makros by Alarms

Speech recognition widget for execution via voice!

and much more!

#how to use speech recognition

Introduction

wih this widget it is possible to execute macros.. switch actuators and get sensor values directly by talking to the app. To get best effort it is neccessary to to use a specific pattern shown below

Details

for makros

['Makro'] + Makroname

for actuators

Aktuatorname + ['an'|'anschalten'|'aus'|'ausschalten'|Wert] + ['Prozent'|'Grad' -> Optional]

for sensors

Sensorname + ['abfragen']

How to use your own App and Intents to send commands to your XS1

Intents can be used in android to send commands through the smarthome app from your own app and receive status information

#How to use Intents from smarthome-xs1

Intents from the app can be used to send command to and get info from the app.

send a command

sending commands is done by sending an intent-object of type com.android.xs.controller.SEND_XS to the app with to lists of extras.

One is of type ArrayList and includes all names of the actuators to be changed or sensors to be read.

the other is of type ArrayList and includes all values of the actuators to be set and 0 values for sensors. The two list have to be of same length!

get the status

after sending a command the app will answer with an Intent with extra "Status" and a string with information if the action succeeded. Furthermore the answer will contain a StringArrayListExtra? named "Values". In there the names and values of the requested sensors will be stored in the pattern "[name];[value]".

get a list of all actuators & sensors

if the sent list of names is empty the app will return a list of all actuators and sensors in the Values Extra in the format

-from here actuators-

name1?

name2?

...

-from here sensors-

name4?

name5?

...

execute a makro

for executing a makro just leave the the lists names and vals null and add a list named makros with the makro names to be executed.

restrictions

both lists have to be of same length and the names of the actuators or sensors to be changed/read must be the same as defined in the xs-1, otherwise status intent will contain an error-message