Configuring domRemote

Configuring domRemote

This section describes all features of domRemote. For description how to start using the software please go to page “First steps…”.

1. General information

domRemote uses a background service to communicate with your Domintell installation over your LAN or even over 3G internet. That means communication can occure even if the application itself is not running. You can configure how long will the service maintain connection to your device before it closes itself.

The homescreen appwidget also uses this service to update its data and to control your devices. The weather information on the homescreen widget comes from google weather API, so in order to function you have to provide accurate location data.

2. Settings

2.1 Domintell device settings

Query modules: as soon as you set up your internet/LAN profile, and achieved a connection to your Domintell installation, with this menu item you can query for installed modules. This should be your second step after configuring Internet/LAN profiles, so you can add your devices to your control panel.

2.1.1 Internet/LAN profile

IP/Host: you should enter the matching IP address or host name for your Domintell device. In the Internet profile provide an IP/DNS name you can access your device from Internet (outside your home) with. In the LAN profile enter an IP/DNS name you can access your device from your WiFi network with.

Port: a port number where your Domintell device is listening for connections.

Profile change logic: with 2G/3G networks the software chooses the Internet Profile and tries to connect with it to the device. If WiFi connection is available, it uses the LAN profile for connection. From version 1.1.3 this logic has been changed, for details see section 6.6 of this document.

2.2 Localization

You can change the language of the software. To add more languages, see instructions in Support section.

2.3 Network service settings

Reconnect interval: here you can define the interval between connection attempts to your device (if the connection is broken, or can not connect to the device at first place).

Service idle time: if you close the application and remove all homescreen widget, after “idle time” minutes the service closes itself, and releases system resources.

Disconnect detection: if there is no traffic between your phone and the Domintell device for this given time, the service determines the connection to your device broken, and start reconnecting procedures with Reconnect interval settings.

2.4 Widget settings

Weather update: interval for fetching fresh weather data

City/State/Country: location information for weather data (where you live, etc)

Temperature sensor: you can choose one temperature sensor in your system wich data will be displayed on the homescreen widget.

2.5 Notification settings

You  can set up notification behaviour for Variable notifications. For details about notifications see section 6.2 of this document.

2.6 Export/Import schema

You can export / import controlles schemas, and even your settings. This is helpful moving the settings from one device to an other. All files are saved on the SD card in a domRemote folder, and import reads files also from that folder. There is no limit for exported schema or settings file number.

3. Using the software

3.1 Adding new controls

The small top-right icon represents the connection status to your Domintell device.If you press “Menu” button on your device on the main screen of the application a context menu appears. If you choose “Edit” you enter the Edit Mode, where you can edit your controls.
Once you entered into edit mode, you can add, reorganize and delete your controls. With the right red X you can delete a control, with the left arrows you can drag up/down the selected control, and so reorganize the order of your controls. With the bottom control (+ sign) you can add new components to your control panel. If you tap on an existing control, you can edit its data.
You have to define a label to your control. If you do not choose any device, you get a menu like control, so you can go below the control, and add subcontrols to your control. If you choose a device, than this item will control that particular device.With the choose icon button you can choose from various built in icons.
If you want to choose a device, first a category list appears, where you choose the category of your device, than receive a list with your actual devices for that category in your Domintell installation. (Remember to run Query modules first to query your device list!)

3.2 Using the controls

3.2.1 General controls

Switch controls can be switched on and off using the switch icon on the right of the control.Shutter controls have to switches. The left side switch controls the shutter down, the right side switch controls it up. Pressing the same control again, or pressing on the control bar stops the shutter movement.Dimmer control can be controlled with a slider. Left side is the 0%, right side is the 100%. Value changing in the Domintell device starts when you release the slider thumb on the new position.Push buttons can be pushed with the right side push icon. If you push it long, it simulates a long push in the Domintell device.

3.2.2 Temperature controls

In temperature controls you can see the currenct temperature, the current mode and the current setpoint for that controller. You can change the mode and the setpoint with the wheels. Changes take immediately effect.

3.2.3 Clock controls

In clock controls you can set various settings. You can set on main screen the hour:minute settings of your clock. The Period (wich date it should run) and the Recurrence (on wich weekdays it should run) can be accessed via the buttons. The clock can be enabled and disabled with the push button on the top-right corner. After setting everything, with the Menu button you can access the context menu, and with Save you can activate your clock settings! (Warning: settings do not take effect till you save it, except the enable/disable button)

3.2.4 Radio controls

With radio controls you can control an AMP module in your Domintell installation. You can control the volume, the input and case of Tuner you can set the Radio frequency. Volume and input changes are published instantly to the Domintell device, however frequency change must be saved with the context menu Save button!

From version 1.1.7 Radio Station names are supported for Radio Tuning. If you have Domintell software version 1.19.18, you can configure in your Domintell software radio stations. If you did so, you will see a different kind of Radio tuning panel.

Here you can use your predefined Radio Station names for tuning, and also you can still use Frequency tuning. If you use Station names for tuning you do not have to save your settings, as it will be applied immediately.

3.2.5 IP Camera View

Adding a control as IP Camera to your control panel shows up like the picture above. You must provide the URL in the Add/Edit control view to access the camera (eg. for an Axis IP cam: http://mycamera.dns.org/axis-cgi/mjpg/video.cgi?resolution=320×240) . Warning: only cameras are supported with MJPEG (Motion JPEG) support!The small top-right icon represents the connection status to the camera.

3.2.6 Temperature profiles

You can manage your temperature profiles with domRemote. You can decrease or increase with the control butons the temperature value for each time interval in the predefined temperature profile.

3.2.7 FAN controller

With the FAN controller you can control your FAN-Coil module. You can set the mode, temperature and FAN speed with the control buttons.

4. Full version

The free version you can obtain from Android Market has limitations. You can use only 2 levels of controls and on each level only 4 controls. You also can not use clock, fan, IP Camera, radio control, and also the homsecreen appwidget is disabled.

However you can buy an activation key to activate the full version right from the application via PayPal.

In the context menu of the free version you have an “Activate” button.

If you choose this button, you get the following dialog:

Here you have multiple choices.
You can buy an activation key, you can enter your activation key, and if you would like to request further activation key for this device, you find the Device ID at the bottom of the dialog box.

If you do not have an activation key, and would like to buy one, choose the “Buy Now” button. This will open your browser and redirect to the PayPal page, where you can pay with your PayPal account or if you do not have a PayPal account, you can pay with your debit / credit card (Visa, MasterCard, Amex, etc).

You can view the invoice details and you can choose payment method. You can log in with your PayPal account or just pay with your debit / credit card.

If you fulfill the payment, you will receive an activation key to your e-mail address (used for PayPal login or entered on the credit card payment form). Now with this activation key you can go back to “Activate” section, and enter your activation key into the edit box, and then click Activate. The activation key is NOT case sensitive!

As you sure already know with one activation key purchase you are licenced to install domRemote Full on 4 other devices (5 devices together). To request additional activation key please send your Device ID (visible on Activation dialog) to domremote [at] gmail.com, and you will receive an activation key for your other devices.

Should you change your device (new phone, etc.), please send me your old device’s Device ID and the new device’s Device ID, and I will deactivate your old activation key for your old device, and you will receive a new activation key for your new device via e-mail.

5. Using multiple devices to connect to your Domintell installation

The DETH02 module supports only one connection at a time. So if you want to use multiple devices at the same time, you have to use as many DETH02 module, as many devices you want to use.

Well if you don’t want to buy for example 5 DETH02 module, you can still use domRemote with more than one device. But in that case please note, that only the latest connected device will have active connection. Also note, that in the settings the disconnect detection setting and reconnect intervall may affect your current connection from an other device.

If you use a tablet for main control with the appwidget, I suggest you set disconnect detection to the longest available option, so if you start a new connection from your phone, then you have for example 5 minutes before your tablet takes the connection back.

Also I suggest to set the service idle time on your phones to “none”, as it will close the background network service as soon as you exit the application. So you avoid a race condition between your devices.

Please note, that the appwidget will maintain connection and will maintain the background network service, so there is no reason to set service idle time to “none” on devices using appwidget.

6. New features

6.1. IP cameras with password

If you have an IP camera wich requires a password, domRemote now supports such cameras. You have to give your username and password into the camera URL, with following syntax:

http://%5Busername%5D:%5Bpassword%5D@cameraIP%5B:port%5D/urltomjpeg_stream

Example url for Axis IP camera:

6.2. Variable change notification

From version 1.0.11 you have the ability to get notification about various changes of your Variables. For example if you bind a sensor to one of your DISMx input line wich sensor is bound to a door, you can have notification about the door being opened!

If you choose a Variable (VAR) as device, you get a new option on the Edit Device dialog:

If you select the “Use notification for input status change”, you can give a notification message, and you have to select on wich status change should the notification be triggered. If you select OFF, then the notification is triggered when the status of the Variable goes from state ON to OFF, same rule applies to the ON selection.

Than when the event is triggered, you will receive a notification in the notification bar (with default notification settings, that means with vibration (if enabled), with your default notification sound (if enabled) and with default notification lights (if enabled)).

The notification bar always shows the latest event, but if you tap on the notification, you will receive a complete list of notifications with timestamp since the application is running (if you use the appwidget, or use service runtime in infinity mode the background service will receive notifications even if the application itself is not running!)

6.3 Payment method change

The payment method has been changed from in application payment to a browser supported payment. For details see section 4. (Full version) of this guide.

6.4 Custom images on controll bars

From version 1.1.0 you can use custom images / glyphs on controll bars. In the icon selection dialog you have a new option below the “No picture” button: “Custom image”.

If you choose this option, your phone/tablet gallery will be opened, where you can browse for an image. After the image has been selected, a picture editor activity is launched where you can crop a portion of the image, or even use the entire image. Please note, that you can crop only a square image piece!

If you selected the area you want to display on the controll bar, you click save, and will go back to domRemote. The image you selected is designed the same way as the application default icons (rounded corners, resized to 128×128, drops shadow, etc), and are saved on your SD card with a random generated name in the folder: /domRemote/glyphs/ . Important, that images saved to this folder are reusable, as they will be visible in the icon list at the end !!!

6.5 Read only controllers

From version 1.1.0 you can define a controller as read-only. This means that you will see the device on your controll bar, the state will be displayed and maintained, but you can not control it.

6.6 New Option: Home WIFI SSID

In previous versions there was a connection profile selection logic as using LAN profile if you were connected to a WiFi network, and Internet profile, if you were connected to a 3G/UMTS network (mobile network). So as not everyone has paid for mobile network and uses domRemote from many different WiFi hotspots, the profile selection method has been changed. Now at LAN profile settings you should select the SSID of your home WiFi network. If you set this option, then domRemote takes care wich Wifi network you are using. If you are connected to your Home Wifi network, it uses the LAN profile. If you are connected to a different network (eg. workplace, free hotspot, etc.) domRemote chooses the Internet profile, so you can access your system from the Internet also from a Wifi network.

6.7 Copy/Paste feature in Edit Mode

From version 1.1.4 you can copy/paste your controller into any other controller. To achieve this, simply go into edit mode where the controller is you want to copy. Long click the controller, than a small dialog appears. Select “Copy device” option to copy this controller. Then exit the edit mode, and browse your list for the place you want to insert this controller. Go into Edit Mode again, and long click the controller where you want to paste your previously copied device. The small dialog will appear again, select “Paste device“. It will be inserted !BEFORE! the controller. You can long click also the “Add new device” button, then the copied controller will be inserted before the “Add new device” button. As this operation is a “COPY” operation, you will have now your copied device twice, once in the new place, and once in the old place. Now you can delete from the old place your device.

I hope this helps you all to easily reorganize your lists.

6.8 Scrollable AppWidget on Android 3.0 and above

From version 1.1.4 AppWidgets on Android version 3.0 and above are scrollable vertically. Now you don’t have to page through your devices, you can scroll them!

6.9 Dropbox account usage for exporting/importing schema and settings

From version 1.1.7 you can use your Dropbox account to store your schema and settings file.

It the settings you can access in the full version the Dropbox export/import feature. First you have to set up your Dropbox account in order to use export/import. If you tap on “Dropbox account”, you will be redirected to the Dropbox web page, where you have to log in with your Dropbox account. Then you have to grant domRemote access to your dropbox account by tapping on “Allow” on the upcoming page.

This grants domRemote to access one folder (called domRemote) in your Dropbox account. Please note, that domRemote will have access only for this folder and subfolders, and will not have access to your whole Dropbox account!!!

After you set up, and granted domRemote access to your Dropbox account, you can use the export/import feature. When exporting, you have to enter the file name. Please note, that you can use additional folder names in the filename. For example you give a filename: home/my_schema.xml . This will be stored in your Dropbox account under /domRemote/home/my_schema.xml ! For domRemote the root directory in your Dropbox account is /domRemote !

Settings are stored under /domRemote/settings, so if you export a file with name: home/my_settings.xml, it will be saved under /domRemote/settings/home/my_settings.xml.

Using folder names in filename is optional, if you just give a filename, it will be saved under /domRemote and for settings under /domRemote/settings.

If importing from Dropbox a new activity is launched, and you will see a file/folder list about /domRemote folder (and /domRemote/settings for settings files).

If you tap on a folder, the content of the folder will be loaded. You can go one folder back with the “Back” image on the upper right corner. If you are importing schema, you can not access the Settings folder, as it contains your settings files, and if importing settings, your root folder will be /domRemote/settings!

If you select a file, a confirmation dialog appears, and if you choose OK, the selected file will be imported.

6.10 Improved MEMO handling

Memo handling has been improved in domRemote. Now you can control your memos according to their types, and for shutter memos from Domintell software verions 1.19.18 up and down directions are also supported.

In order to use your Memos you have to remove them, requery the module list, and then add your memos again to your controller panels. This is necessary to refresh the Memo type and reference from Master module.

6.11 AUX app selection

If you select an AMP module (sound module) you can define a distinct application to each AUX output. This means if you activate that AUX output on your device, the selected application will be started. For example you bound a DivX video player device to one of the AUX output, and you have installed some controller software on your phone for that DivX video player. Now with this option you can assign that video player controller software to eg. the AUX1 output. And if you activate the AUX1 output on your phone, the selected video player controller app will be automatically started, you do not have to search for it on your home screens or in the appdrawer and start it separately.

If you tap on the + button in any row, you can choose an app from the app list:

With the first button (Disable software launch) you can erase the previous app. If you choose a different one, the app will be stored and will be started every time you activate the AUX output.

Please note the “Internet” below the AUX1 software (I choose the browser as startup application).

Important: the software will only be started if you activate the AUX output from the device where you made the launch setup. It won’t start applications on different devices even when the AUX output has been selected!

6.12 Entry Phone controller

From version 1.1.12 you can define an input (ISMx or BUx) as an Entry Phone controller. This means the input you choose will function as “Door bell”, bringing up a notification window with an optional IP camera picture (see the second picture), and an optional output controller, to open the door (control magnet lock).  Also the ringtone can be selected. If someone triggers the input the ringtone will be played for 1 minute, then it will stop. If your phone was in a sleeping state (screen turned off), it will turn the screen on, it will dismiss the keyguard (as long as it is not protected by a gesture or a pin code) and will bring up the Entry Phone controller.

Above the configuration of the Entry Phone controller.

Important: the notification if somebody triggers the input will be brought up only if the NETWORK SERVICE is running. This can be assured by setting the NETWORK SERVICE lifetime to infinite. If you use multiple devices I suggest to use multiple DETH02 devices or the built in proxy feature.

The upper left button will trigger the output you selected as door opener controller. The button right of it will save a picture to the SD card. Important: if someone triggers the input, a picture is automatically saved to your SD card!

It is a good idea to have this type of controller on a tablet, which is usually at home, altough with proper configuration (firewall, IP camera and domRemote) you will be able to receive door bell events even via the Internet! Also you can define the same controller on multiple devices, in this case the input trigger event will bring up the Entry Phone controller on all devices!

6.13 New scrollable/resizeable AppWidget

I have separated the AppWidgets into static (paging) and scrollable versions. Now beside the three static version (4×4, 5×5 and 7×8) there is one new scrollable widget (size 4×3) and above Android 3.1 it is also resizeable, which means the AppWidget will display as 4×3, but you can freely resize it to any bigger size. The number of columns / rows in the gridview will adjust to the new size.

6.14 Saving Clock States

From version 1.1.14 you have the ability to save all the clock states in your Master to a file on the SD card. This is good, if you update your Master software, or do any changes to your program running on the Master, as in this case all clocks are resetted to the program values, even if you changed, disabled, etc. some of them.

With this feature you can save the states to a file, and the restore the clock states from it after the Master software or program change/update, avoiding to have set all your clocks again to their previous values.

The algorythm behind this features uses the clock NAME as a key, so if you reorder your clocks, deletes some, or adds new clocks and the ID-s change (but the NAME not), domRemote will find your clock. If it does not find a clock (because it has been removed, or has been renamed) it will do nothing (no update).

Also important, that it will save all the clock states to the file, regardless it is defined in your domRemote schema or not. If it is a defined clock in your Master, it will be saved to the file.

If some error occures during clock state saving, then it is important to know, NOTHING WILL BE SAVED TO THE FILE!

But if some error occures during clock state restore (except file not found error), then SOME OF THE CLOCK STATES MIGHT HAVE BEEN RESTORED! YOU HAVE TO CHECK WHICH WERE RESTORED OR SIMPLY RUN A RESTORE AGAIN!

To ensure an errorless save and restore, make sure you have an undisturben, good connection to the Master (no threat from any other devices to hijack your connection to the Master, good wifi signal, etc.). If there is a connection error while discovering the clock states, the process will be interrupted with a timeout after 60 seconds.

Hope this helps you to make a program change or Master software update easier!

6.15 Using VOICE commands

From version 1.1.23 you can use voice commands to control your home. I tried to translate to all the languages, however – since I do not speak most of them – it could be buggy. If you find some mistranslated text for the commands, please send me an e-mail, or write a short comment on the Support page. For this to work, you need Google Search from the Play Store, and a working Internet connection, as it uses the Google servers to recognize what you said. If it does not recognize what you said at all, it prints as Toast what it recognized. If it finds the controller, but does not find the command you will get a Dialog with available commands (with translated texts) there you can see if something is mistranslated.

Almost all controllers should work with voice commands: buttons (BUx), switches (BIR), shutters (TVR), VAR-s, Dimmer/D10V module, Temperature control, Audio module. Memos should also work for switches and shutters.
How to control them:
First make sure you do not have two controllers with the same name. Since you do not need to tell the full path (eg. if you have a similar hierarchy like: upstairs -> bedroom -> lights you do not need to say upstairs bedroom lights on, you need just to say ligths on. Therefore it is important, that the controllers have a unique name, if you have 10 controllers with name lights, it will randomly choose one! In this case you need some rework with your labels, and rename them to some meaningful name)
For switches: you can say [controller name] on/off or [controller name] up/down (eg. lights up or lights on you can choose your preference)
For push buttons and VARs: you can say push or where long push is supported then long push (eg. [controller name] push or [controller name] long push)
For dimmers: you can say after the controller name the number you want to set, like [controller name] 50 ([controller name] fifty) it should recognize as numbers
For shutters: [controller name] up/down/stop (like livingroom shutters up or livingroom shutters down or livingroom shutters stop to stop them)
For tempreature control: you can say two commands, one for setting the mode, and one for setting the temperature. For setting the mode say eg.[controller name] mode absense or frost or automatic. For setting temperature say:[controller name] temperature 23  (it does not handle/recognize the 23.5 well, so setting half degree is not possible)
For audio module: you can control the volume, and switch the input (tuner, aux1-4). To control the volume, say: [controller name] volume 50 (or you can also say on / off, on sets volume to 100, off sets to 0, but the keyword volume must be there, eg. whatever controller volume off ) to switch the input just say [controller name] tuner or [controller name] channel 1 or [controller name] channel 3.
It helps the Voice Recognition system a little bit, if you keep a very short pause between the words, so it will more recognize as standalone words, and not like a sentence.

 

7. Misc

For more information please visit FAQ or the Support page.

Advertisements
  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: