What is the zencontrol Touch Switch application for Android

Creation date: 9/3/2024 5:12 PM    Updated: 9/3/2024 5:12 PM    android app json touch switch touchscreen zencontrol
This article will provide a high level overview of the zencontrol Touch Switch application for Android tablets and mobile devices. This article does not go into depth on how to create a touchscreen project for the Touch Switch application, instead focusing on preparing for creating one.

The zencontrol Touch Switch application is a platform for hosting created touchscreen projects that are used to interface into zencontrol application controllers. The touchscreen projects are a JSON (JavaScript Object Notation) file which is created either via the templating tools available within the zencontrol cloud, or manually by creating the JSON by hand.

Note: Before specifying a dedicated touchscreen for a zencontrol project, reach out to your local Lumen Resources representative to discuss further

Prerequisites

Before proceeding to use the Touch Switch application, the following knowledge and tools will be useful:


In addition to this, A TPI licence will be required per zencontrol application controller that you wish to speak to via the Touch Switch application

Getting started with a template

With this information in mind, the best place to start from is to download the zencontrol Touch Switch application to the Android device and load a template onto it. This will give you an idea of a basic look and feel for the interface, and work as a place to start when creating your own user interface.

The easiest way to load a template onto an Android device is via Google Drive, as it is easy to access via PC through a web browser, and via the Android device. This will provide you with a wireless method of transferring project files over to the Android device, including via the internet. To load a configuration file into the Touch Switch app, swipe from the far right hand side of the display to the left. This will reveal the settings:



Select Load Configuration. This will provide you with the file explorer for the Android device where you can navigate to the Google Drive and select the template file. Make sure to press the save button in the bottom right hand corner of the user interface.

Understanding the files used by the Touch Switch App

There are 2 files that are used throughout the process of creating a touchscreen project. These are the .json file which is what the project file is created and edited from, and the .config file which is the compiled version of the .json file.

To learn how to convert the .json file to a .config file, see the following article: Touch Switch: Convert the .json file to a .config file

Note: There is no way to convert a .config file back to a .json file, so ensure that the .json file is stored safely. If the .json file is lost, there is no recovering this file and it will require to be rewritten again if the Touch Switch project needs modification

Templates

Available below are some templates created by Lumen Resources, which demonstrate certain functions. These are provided as is but are provided as open for modification. Loading the included .json files into a suitable text editor such as Notepad++ will show how these projects are created, and is a great way to understand how to create your own touchscreen projects.
Files