Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.

2011b

Automation Software Engineering

Configuration Instructions S7Droid Full V1.2

English translation by EM Research Unit, 2012-02-14

1/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

1 FIRST START 3

1.1 Update behaviour from version 1.1 3

2 POSSIBILITIES FOR NAVIGATION 4

3 SYSTEM CONFIGURATION 5

3.1 PLC device configuration 6

3.2 Data point configuration 7

3.3 Extended configuration 8

3.4 CSV-Export/Import 8

3.5 Device section [DEVICE] 9

3.6 Data point section [DATAPOINTS] 9

3.7 User interface controls 10

3.7.1 Momentary contact switch [1 – Tast Button – TASTER] 10
3.7.2 Maintained contact switch (rocker) [2 - Switch Button – SWITCH] 10
3.7.3 Numeric value display [3 – Analogvalue Displayfield – VALUEDISPLAY] 10
3.7.4 Numeric value input field [4 – Analogvalue Input – VALUEINPUT] 11
3.7.5 Horizontal slider [7 – Analogvalue Slider Horizontal – VALUESLIDERH] 11
3.7.6 Button array [9 - Multistate Tast Button – MSTASTER] 12
3.7.7 Multistate display [10 - Multistate Displayfield – MSVALUE] 12
3.7.8 Maintained contact switch (pushbutton) [11 – Toggle Button – TOGGLE] 12

4 HINTS FOR CONFIGURING THE TABS 12

2/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

1 First start
S7Droid Full is an Android Application for control and monitoring of Siemens control systems. In version 1.2,
which is now available, it is possible to define various groups of data points and show them in a so-called
Tab View. The database that ships with S7Droid Full already contains three demo devices and their data
points.

1.1 Update behaviour from version 1.1

Due to changes to the database structure, the entire database content is exported to the file
“S7DroidUpdate.csv” and then imported into the new database when updating from version 1.1. The file is
located in the root folder of the external memory (typically the SD card). If the V1.1 configuration does not
contain any group entries, all data points will be shown in one tab at the first start.

3/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

2 Possibilities for navigation

Upon pressing the menu button, a menu is shown that offers the following possibilities for navigation:

System Configuration (System Konfiguration): Show the system configuration screen

Saved DP (Gespeicherte DP): Show the operator screen from version 1.1
S7 Address Input (S7 Adress Eingabe): Show the S7Droid Lite screen
Info: Show application information

4/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3 System configuration
The screen “S7Droid Configuration” is shown when selecting system configuration as described above. In
the upper area, the tabs are configured:

Max nr of Tabs on page (Max Anzahl Tabs je Seite): Here, the number of tabs per page shown in the tab
view can be configured. In case more tabs have been configured altogether than the number specified here,
a navigation tab is defined and shown.

Poll Intervall: This defines how frequently the data points in the current tab should be read. The time set
here must expire after all values in the tab have been read before they will be read anew.

Using the colour controls, the appearance of the tabs can be modified as shown below:

5/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3.1 PLC device configuration

The section “Automation-Device” on the “S7Droid Configuration” screen allows defining, modifying, copying
and deleting the PLC devices that S7Droid should interact with. Upon selecting “New”, the dialog for setting
up a PLC connection opens:

Device Type: Using this field, the PLC device type is set. Depending on this type, the fields below (S7-IP-
Port, S7-MPI, S7-Rack, S7-Slot) are set. For S7-1200, S7-200 and Logo-0BA7 devices, these settings
should work with all devices. For S7-300 devices, these settings may vary from project to project.

Device Name: This entry defines a free-form name for the device. It must be unique for each device that is
defined.

Device Description(Device Beschreibung): Optional “friendly name” for the device.

IP-Adress/Hostname: Specifies the device address. Either the numeric IP address or a DNS name may be
used.

S7-IP-Port, S7-MPI, S7-Rack, S7-Slot are automatically completed as described above. If necessary for a
particular project, these fields can also be modified.

Upon pressing ”Save”, the device is saved to the database.

6/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3.2 Data point configuration

After a PLC has been selected in the section „Automation-Device” of the system configuration screen, a new
data point can be defined, modified, copied or deleted in the section „Datapoint“. Upon selecting “New” in
this section, the following dialog appears:

Tag Name (DP-Name): Specifies the data point name. This name must be unique throughout the entire
system.

Tag Description (DP-Beschreibung): Specifies a “friendly name” for the data point. This name is also
shown in the single data point tab view for this data point.

Tag Address (DP-Adresse): Specifies the data point address in the PLC. The question mark button brings
up an address wizard to help with this task.

Tag Type (DP-Type): The data point address often already defines the data point type implicitly. This field
allows modifying the type if necessary.

Poll Intervall: This polling interval only applies to the V1.1 screen (in the tab view, the polling interval
specified for the tab applies and the value set here is ignored).

Tag-Group (DP-Gruppe): This field specifies the name of the tab that shall contain this data point.

7/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

HMI-Type: Defines the user interface control to be used for the data point.

State-Text (Zustands-Texte): Status texts for the data point. For Bool values, two values separated by a
comma have to be defined. For analog values, the unit can be specified. For multistate values, a state label
for each state can be specified.

Low-Limit/High-Limit (Untere/Obere Grenze): These entries are required for the correct display of values
in the tab views. For Bool values, the lower limit is 0 and the upper limit is 1. For analog values, the
measurement limits should be specified here.

Access (Zugriff): Specifies access rights for this data point.

3.3 Extended configuration

Extended configuration settings are shown when pressing the menu button in the system configuration
screen:

Restore Database (Datenbank erneuern): This option replaces the system database with the default
database shipped withthe application. If database contents should be preserved, the database must be
exported beforehand (DB CSV-Export).

DB CSV-Export: Exports the system configuration into the CSV file “S7DroidExport.csv” in the root folder of
the external device memory.

DB CSV-Import: Imports the system configuration from “S7DroidImport.csv“. This file must also be located
in the root folder of the external device memory.

Info: Information about the application.

3.4 CSV-Export/Import

To create an import file, it is recommended to export the default database first and use the resulting CSV file
as a template. The file is made up of two sections, the device section and the data point section. The device
section should always come first to ensure that any data points to be imported will find the corresponding
PLC device in the database.

8/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3.5 Device section [DEVICE]

When displayed as a spreadsheet, the [DEVICE] section looks as follows:

An row in this table allows to define a device, update its data or delete it. On import, the entry in the first
column specifies the action:

„_id“ = export value: Device is updated according to data from table

„_id“ = “” (empty): Device is created according to data from table
„_id“ = „-1“ : Device with the name specified is deleted

The further columns of the import table correspond to the fields of the PLC device configuration screen.

3.6 Data point section [DATAPOINTS]

The [DATAPOINTS] section looks as follows:

An row in this table allows to define a data point, update its data or delete it. On import, the entry in the first
column specifies the action:

„_id“ = export value: Data point is updated according to data from table
„_id“ = “” (empty): Data point is created according to data from table
„_id“ = „-1“ : Data point with the name specified is deleted

The further columns of the import table correspond to the fields of the data point configuration screen.

The entries in the DPHMIType colum correspond to the available user interface controls as follows:

1 TASTER Momentary contact switch

2 SWITCH Maintained contact switch (rocker)
3 VALUEDISPLAY Numeric value display
4 VALUEINPUT Numeric value input field
7 VALUESLIDERH Horizontal slider
9 MSTASTER Button array
10 MSVALUE Multistate display
11 TOGGLE Maintained contact switch (pushbutton)

The next section contains detailed information about these controls.

9/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3.7 User interface controls

This chapter presents the user interface controls that are currently available. For each control, a sample
screenshot from an Android device and the corresponding line from an import file are shown.

3.7.1 Momentary contact switch [1 – Tast Button – TASTER]

This control sets a bit in the PLC for 200 ms, then resets it.

3.7.2 Maintained contact switch (rocker) [2 - Switch Button – SWITCH]

This control allows to modify a Bool value using two buttons. The background colour displays the current
status of this Bool value.

3.7.3 Numeric value display [3 – Analogvalue Displayfield – VALUEDISPLAY]

This control shows an input value together with the unit that has been configured for it.

10/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3.7.4 Numeric value input field [4 – Analogvalue Input – VALUEINPUT]

This control is used to pass a new value to the PLC. This is done by a long press on the value field. An input
dialog opens, where the new value can be entered (do not enter the unit). If the entered value is outside the
configured range, the data point is set to the configured minimum or maximum value.

3.7.5 Horizontal slider [7 – Analogvalue Slider Horizontal – VALUESLIDERH]

The Horizontal Slider allows changing a value within the range specified by moving a slider. Moreover, the
value can also be set directly. For this, the procedure is the same as for the numeric value input field.

11/12
Automation Software-Engineering – Configuration Instructions S7Droid V1.2 Version: 05.12.2011b

3.7.6 Button array [9 - Multistate Tast Button – MSTASTER]

The Button Array allows writing an integer value to the PLC. The button background color shows the current
state of the value.

3.7.7 Multistate display [10 - Multistate Displayfield – MSVALUE]

The Multistate display shows an integer value together with its state label.

3.7.8 Maintained contact switch (pushbutton) [11 – Toggle Button – TOGGLE]

This control first reads the state of the associated Bool value, then negates it and writes it back. The button
background colour shows the current state of the value.

4 Hints for configuring the Tabs

Currently, the order in which the user interface controls appear on a tab is defined by their database ID. This
means that the data points appear in the order they were created. In order to change this order with a
minimum of effort, the following procedure is recommended:

1. Export the current database to a CSV file.

2. Edit and sort the data points in the CSV file as desired.
3. Empty the colum „_id“ in both the Device and Datapoints section of the CSV file.
4. Delete the PLCs from the database.
5. Save the CSV file as “S7DroidImport.csv” in the root folder of the external memory.
6. Import this CSV file.
7. After importing, push the back button twice; then, push the button on the page that appears.

12/12