Android Console Configuration

Pierre Kil edited this page Dec 20, 2016 · 8 revisions
Clone this wiki locally

The Android console has recently been updated to fix several key issues with the previous version that was in the Google Play Store; as well as improving general stability the controller list screen is more inline with the other consoles and also panel scaling control has been introduced.

In the previous release panels were stretched to fill the screen of the device providing no correlation between the designer panel size and the physical device size; the current version now respect the sizes defined in the designer but to replicate the stretching behaviour you can use the X & Y scaling factors within the add/edit controller screen.

The Android Console can be found at Google Play Store

Controller List

The console will start at the Controller List screen (unless you exited the application previously while a panel was loaded) and the controller auto discovery process will begin asynchronously, any controllers found on your LAN will automatically be added to the controller list. You can add additional controllers using the 'ADD CONTROLLER' button you can also edit existing ones using the arrow to the right of each controller. If you like to try out an example you can view the "Example Home", by selecting


Controller Status Indicator

Next to each controller is a status indicator, a swirling icon indicates that the app is trying to communicate with the controller, a red circle with a line through it indicates that the controller is unavailable and a green tick indicates that the controller is available. You will only be able to load a controller that has a green tick. To refresh the status pull down on the controller list and release.

To remove a controller from the list hold down on the one you wish to remove and wait for the delete popup.

Add/Edit Controller Screen


Here you can specify the following: -

  • Controller URL (required) - URL address of the controller to connect to, 'http://' prefix is optional *Default Panel Name (optional) - Name of the panel within this controller to load when this controller is chosen (if not entered the panel selection screen will be displayed)
  • Username & Password (optional) - Credentials to use to connect to the controller (requires security setup on the controller)
  • X & Y Scale (optional) - Used to scale the panel to fit different sized devices (if you designed a panel with a size of 320x480 but you were trying to display it on a device that is 640x720 then X Scale = 2 and Y Scale = 1.5)

When up scaling panels it is important that images used for widgets (switches, buttons, sliders, etc.) have a large enough size to fit the largest device you wish to use. For example if you have a 200px x 200px button and you want to use a scaling factor of X=2 & Y=2 then the image used for this button should be at least 400px x 400px. Try to avoid excessively large images as mobile devices have limited memory.

Settings Failsafe

If you happen to create a panel that prevents you getting back to the settings screen easily then you can hold down on the screen background for 2 seconds to be taken back.

See also