User manual CitySys

  1. Introduction

1.1. The goal

The aim of this guide is to acquaint users with the individual settings and possibilities of using the CitySys platform.

1.2. Track changes

VersionLast Change Date

1.3. Concepts, abbreviations and symbols

The conceptMeaning
EDBElectrical Distribution Box
PLPublic lighting

1.4. Advantages / principles of the platform

CitySys is an open platform integrating multiple applications that make up a smart city. The collection, transmission and evaluation of data is provided by the comprehensive CitySys control system based on the ThingsBoard IoT platform according to the OPC standard. Open Platform Communication (OPC) is a series of specifications from software vendors and developers that define the interface between clients and servers, including access to real-time data. Its hardware component provides direct connection via standard interfaces and protocols. Radio communication is used for communication between the luminaires. This means that the communication signal is not transmitted via a standard 230 V power supply network, but via wireless RF technology. When it comes to connecting to third-party systems, and therefore also to current systems, CitySys is open to communication. The collected data is stored on a cloud server. The CitySys IoT platform brings many interesting benefits that can help the customer to decide on the integration of intelligent technologies. The platform is horizontally scalable and is built using “open-source” technologies. It can fully tolerate errors because all nodes in the cluster are identical. Its really strong advantage is robustness and a high degree of efficiency. This means that every single node can control tens of thousands to hundreds of thousands of devices. The platform has customizable web tools (widgets), rule processing and a system for plug-ins (plugin), thanks to which it has really great extensibility options. We live in a world in which every system and every city has security integrated within its scope. The platform supports transport encryption and authentication of the credential management device. Big data is collected in Smart City through a number of sensors that monitor various parameters. These include many interesting sensors, such as motion sensors, traffic sensors, parking space occupancy sensors, weather stations, waste management sensors, noise sensors, shooting sensors, a camera system and emergency buttons. All of these devices can be implemented directly into the luminaire or can form part of a Smart Pole street lighting pole. The platform is horizontally scalable and is built using open source technologies.

2. Access to the system

Access to the server is performed via a web interface / application – CitySys at the URL:

The actual URL of the system may differ from the above based on customer requirements. Before logging into the system, it is necessary to make sure that access to the platform has been correctly established and set up (delivery of login data). On the home page, the user is prompted to authenticate with a username and password. The system allows you to define multiple users, each with different rights and permissions. User creation and management is provided by the system administrator. If you do not have access data, contact the solution provider.

Communication and transmission of information between the EDB and the platform are secured by encryption. The system is accessed and monitored via 128-bit encrypted communication from anywhere with a computer or tablet connected to the Internet.

2.1. User login

1.) Enter the appropriate URL of the CitySys control system into the search engine: 2.) Enter your own (assigned) email in the “Email” field. 3.) Enter the password in the “Password” field. 4.) Confirmation of login to the CitySys system.

5.) The user is logged in to the CitySys control system.

2.2. User logout

1.) Click on the logged in user in the upper right corner to open the menu with the menu. 2.) Option to log off the user.

3.) The user is logged out of the CitySys control system.

2.3. Access to support – Help Desk

1.) Clicking on the HELP DESK icon in the upper right corner will redirect you to the support page.

  • HELP DESK will redirect you to the support page.
  • After selecting it, the documentation will be redirected to the CitySys manual

2.) After opening the HELP DESK page, enter your login details needed to enter the system (if you do not have them, they will be provided by the system supplier).

2.4. Welcome display

2.4.1. Available icons and applications

Icons with available applications are located below the top bar on the home screen.

1.) City Dashboard – basic application with map overview and current information about devices. 2.) City Studio – application for creating / editing platform elements such as regions, zones and devices. 3.) Performance Dashboard – analytical tool for graphical monitoring of data from devices. 4.) Logs & Events – application for visualization of logs and notification of events from devices.

The display of icons is subject to user privileges and may not be visible to all users. Contact your system administrator if you need to change permissions. For a faster transition between applications, it is possible to use the drop-down menu, which is activated by clicking on the arrows next to the CitySys logo on the top bar (upper left corner):

2.4.2. Available icons

The logo and the mentioned navigation menu are accessible from all levels of the system. In the right part of the top bar there are system settings, which are also available from all levels of the system:

The “Application menu” icon allows you to quickly switch between available applications.
The “Language” icon allows you to select the preferred language for the user.
The ” Watcher ” icon displays the interface for setting the watcher message. City Dashboard – Watchers
The “HELP DESK” icon allows you to go to the user support page. Access to support – Help Desk
The “Active user” icon offers the option of user settings and logging out of the active user. User settings

3. City Dashboard user interface

The user interface application includes the visualization of platform elements (devices, zones, regions) on a map base. In addition to devices such as EDB and lighting, it is therefore possible to visualize areas such as regions or municipalities. The user interface consists of five parts:

  1. Elements on the top bar
  2. Map base
  3. Left menu (Tree of device types by individual areas)
  4. Right menu (Organizational structure of objects / Equipment tree / Equipment detail)
  5. Statistics and KPIs

3.1. City Dashboard – elements on the top bar

By activating the CitySys Dashboard application, additional icons will be added to the top bar, which are used to operate the application.

“KPI” icon – displays the Statistics and KPI window. City Dashboard – KPI
“Filter” icon – displays the Filter window. City Dashboard – Filter
“Maintenance Mode” Icon – Allows you to control the devices. City Dashboard – Maintenance mode
“Search for devices” icon – Allows you to search for devices by name for quick access.

3.2. City Dashboard – map base

The map base is used for basic visualization of the location of regions, zones and facilities. The position on the map base (using GPS coordinates) defines the position of the element. You can enter a position as a polygon (typically regions and zones) or as a single point (typically a device). However, it is also possible to enter the device itself as a polygon (area on the map). If the device is a location on the map as a point, it is displayed by its specific icon, which is defined within the device type (entity type, entity type). The icon cannot be changed by the user, but the user can specify the color of the icon (fill color) when creating the device. The list of icons is expanding dynamically and is therefore not part of this document. The display of elements on the map base is conditioned by filters:

  • filter of regions and zones (right menu)
  • device type filter (left menu)
  • combined filter (Filter menu)
  • conditional staining filter

By activating / deactivating individual filters, the current display of elements on the map is dynamically adjusted. Using the + / – buttons or the mouse wheel, the map base can be zoomed in and out. By simultaneously holding down the CTRL key and the left mouse button, it is possible to change the tilt of the map view by dragging on the map base. Clicking on a specific element on the map (region, zone, classification) will display its detail in the right menu and at the same time the icon of the selected device will start moving. If the map zoom setting causes the icons to overlap (the icons do not change their size when the zoom is changed), a cluster of devices will be created. Click on the grouping icon to display a window with a list of devices inside the grouping.

3.3. City Dashboard – left menu

The left menu or the Device type tree serves as a graphically controlled filter of devices displayed on the map base. At the top level (collapsed list), device categories are shown. Expand a category to see it below the category, and then specific device applications (such as Lighting). Each list item has a box to activate the filter. Activating / deactivating a higher-level item also activates / deactivates all of its nested items. At the top of the menu are switches that filter the list of categories itself:

When activated, it will also display categories of devices that have not been created in the list (thus all of them will be displayed).
When activated, it will also display on the map devices to which data has not yet been sent (they are virtual).
At the time of activation, the list of categories will be limited to the currently active items.

The current state of the filter directly affects the display of devices on the map. If no device category is active, no device is displayed on the map. The filter settings in the left menu are also dynamically transferred to the filter settings within the Filter window. When you expand the list of categories to the lowest level, each item has an eye pictogram. When clicked, the conditional color setting of the device type is displayed according to the value of the selected attribute (for example, device status or lamp brightness). Conditional coloring allows for quick visual inspection of device parameters. Attributes of devices that support conditional coloring are defined by the system administrator and are subject to change. Therefore, they are not part of this document.

3.4. City Dashboard – right menu

The right menu has several functions. When you open the City Dashboard application, it shows the Organizational structure of regions and zones. After selecting a specific zone, it displays the Device Tree in that zone. When selecting a specific device (on the map base, in the device tree or in the search), the detail of the given device is displayed in the right menu. The buttons at the top of the window are used for navigation within the right menu:

Return to the previous context.
Transition to the parent element in the tree structure.
Restore displayed values (last reported data is read from the device).
Close device detail. Return to the Organizational Structure of Regions and Zones.

3.5. City Dashboard – KPI

The KPI (Key Performance Indicators) window is used to quickly create a graphical representation of the recorded data for analysis over time or for comparison with other data. KPIs are personalized for a given user, so each user can have a different display of graphs in the KPI – according to his user settings. The KPI window is displayed by activating the corresponding icon on the top bar or the icon at the bottom of the screen (Show all). At the top of the window is a filter for displaying already created KPIs, which is useful if multiple graphs are created. Depending on its configuration, it may take more than half a minute to load the graph. On the right is the New KPI button to create a new chart.

Within the KPI, it is also possible to go directly to the panels from the Performance Dashboard application. By scrolling with the mouse wheel, it is then possible to scroll through the individual graphs.

3.6. City Dashboard – Filter

The Filter window is activated using the icon on the top bar. Represents a direct filter setting for displaying objects on a map base. If the filter is active, this is indicated by a blue dot next to the icon on the top bar:

The filter settings are also dynamically controlled by activating the graphic elements in the left and right menus as already described.

The filter setting consists of three parameters:
GroupsDevice category – contains all categories and under device categories (input from the left menu).
ZonesFilter to the location (zone) in which the device is located (input from the right menu).
Entity typesSetting a specific device type (entity type).

Within each parameter it is possible to combine several conditions (ie more groups, zones and types of devices). A special type of filter is conditional coloring, the setting of which is located in the right part of the window. Click the Add Conditional Color button to display the settings window.

To activate conditional coloring, it is necessary to select the device type (entity type) and the attribute according to which the coloring will be performed. The legend also displays the assignment of colors to the selected states or values. If the attribute has a value that is not in the legend, this device will be colored according to the device definition (as if the filter was not active). Conditional coloring can be set for each device according to only one attribute.

3.7. City Dashboard – Maintenance mode

The CitySys platform is in a default monitoring mode. This means that it is not possible to influence the status of the devices and their configuration. The Maintenance Modes radio button allows you to turn on the active mode for the selected device type. A typical example is lighting control CitySys application – Public Lighting. Maintenance mode access settings are controlled by the system administrator, and each user who wants to be able to use maintenance mode must have permission to do so (assigned to a specific user). Therefore, the display of maintenance modes is different for users with different permissions.

3.8. City Dashboard – Watchers

The Watchers menu is used to set an watcher that monitors the selected parameter of the selected entity (device) over time. If the conditions for triggering an watcher in the given time window are met, a window with information about the triggering of the watcher will be displayed. At the same time it is possible to set the sending of notifications by e-mail or via SMS (Chapter).

It is possible to see in the list of created watchers:

NameUser name for the watcher.
IntervalTime interval within which the watcher conditions are evaluated.
StatusInformation on whether the watcher is active.
Watcher triggeredInformation on whether the condition for triggering the watcher is currently met.
Last checkDate and time of the last watcher condition check.

Use the New watcher button to create a new watcher. After activating it, a dialog box for entering the parameters of the new watcher will open.

The table below describes the watcher parameters:

NameUser name for the watcher.
IntervalTime interval within which the watcher conditions are evaluated in minutes.
StatusThe switch that activates or pauses the watcher.
EntitiesThe device to which the watcher applies. You must select an entity name.
Entity typesThe type of devices to which the watcher applies.
Time windowA time interval that determines how long into the past the watcher condition will be evaluated. For example, a time window of 10 minutes means that the watcher will be triggered if the watcher conditions have been met within the last 10 minutes. Thus, up to 10 minutes after the watcher conditions are no longer met, the Watcher Status will change to not triggered.
Start/ End Time rangeThe start and end of the time period determine when the watcher will be active during the day. Only one period can be set.
AgregationThe aggregation function defines the method of data processing within the time window. Within numeric attributes, the functions: Average, Sum, Minimum and Maximum make sense. For example, the average function calculates the average value of an attribute within a time window and evaluates it against an watcher condition. For status attributes (text strings), only the Last Value function makes sense.
AtributeParameter which value is considered as an watcher condition.
ConditionOperator conditions. For non-numeric attributes, only the equal or unequal operator makes sense.
ValueParameter value type – value or date.
Value fieldPlace the value with which the selected attribute will be compared.
+Button to add another attribute. The results of the comparison of individual attributes are logically multiplied. Therefore, the conditions of all attributes must be met to trigger the watcher.

An already created Watcher can be edited using the Edit button in the watcher table.

4. City Studio editing interface

The City Studio editing interface is used to create and edit objects on the CitySys platform. As it is a configuration interface, its use is not intended for the average user, but for a trained person with a deeper knowledge of the CitySys platform. Therefore, only the basics will be described in this guide. Contact your system vendor for a more detailed description of the City Studio interface.

After opening City Studio, the icons associated with editing the environment will be displayed on the top bar:

Creating and editing regions (the highest level of structure).
Creating and editing zones.
Creating and editing devices.
A tool for inserting an image on a map base for better orientation on the map base (for example, the floor plan of buildings).

Regions and zones are defined as polygons on a map base. Within the right menu it is possible to see the tree structure of regions and zones. Within their definition, the title (also for various translations) and color are entered. For zones, you can also specify a level for multi-storey objects. When activating the interface for working with devices, the left menu is also displayed – a list of devices in a tree structure by category. In the right menu there is a complete list of objects in the tree structure for the selected region (selected region, zones and facilities). To create a new device, first select the zone or device to which it will belong (right menu), then its category and select the device type from the open list. Then you need to choose whether the device will be a polygon, a point, or will be without a position on the map, and finally place the device on the map base.

This is the device created in the database. For the correct function, it is still necessary to pair the created device (entity) to a specific real HW. This is done through the TB identifier parameter, which is located in the detail of each device (pencil icon in the right menu). The detailed description of pairing depends on the type of device and is beyond the scope of this manual. Contact your system vendor for more information.

5. Performance Dashboard analytical interface

The Performance Dashboard analytics interface is used to create graphs and statistics for the analysis of data collected from devices. The interface consists of individual boards that group graphs according to user preferences (typically they can be boards for different applications, different buildings, sections of the system). Boards can also be connected to the KPI statistics interface on the City Dashboard and shared with other users.

5.1. Create new board

Use the button with the same name to create a new board. The board is defined by the following parameters:

LanguageOption to select the language in which the name will be
NameUsername for the given board, it is possible to enter various translations.
GroupsAssign a board to a device category.
The panels you have in the Performance Dashboard in the left part of the menu.
DescriptionA place for a user description of the board, including possible translations.

Confirm with the Save board button to create a new board, which will then be displayed between the boards. You can display a specific board by clicking the Open button. Editing a given board is possible via the three dot icon in the upper right corner of the board object.

After creating the panel, it is possible to click on the three dots in the upper corner of the panel to select the Edit option in which you can edit the saved data but also share the chart with other platform users. When you select View option, users will only be able to see the graphs, and when you select Edit option, users will also be able to edit the graphs.

After opening the panel, there is an interface for working with the panel at the top of the window:

Unlocks editing options for graphs already created.
Create a new panel component (KPI).
Opens a dialog for printing the panel as a report.

5.2. Create new Component

To create a new panel component, you need to define it. The parameters of the component are:

NameUsername for the given component, it is possible to enter various translations.
DescriptionSpace for user panel description including possible translations (can be left blank).
TypeComponent type – KPI or static object (text, image, video).

When choosing the type of component, the most important type is KPI, which is the subject of the next chapter. In the KPI menu, it is possible to select already created KPIs by name, while in parentheses after the name you can see where the KPI was created (within the City Dashboard or Performance Dashboard application). You can create a new KPI by clicking the + button. Clicking on the arrow to open the left menu will display a tree of device categories for filtering panel components and individual KPIs according to the assigned group.

5.3. Create new component Type: KPI

Within the CitySys platform, KPIs can be considered as a separate object, with which it is possible to work in different places of the platform. Also, the creation of KPIs is possible from several places – within the City Dashboard or Performance Dashboard application. However, both sites lead to the same dialogue of creating a new KPI.

The basic parameters of each KPI are:
NameUsername for the given component, it is possible to enter various translations.
CategoryKPI category – status or other (time courses). You select the status in case you want to create a graph to check the status of the device / devices
GroupsAssign KPIs to device categories. It is advisable to determine the category as accurately as possible in order to always display the most accurate data.
Chart typeGraph type selection: between pie, alarm and time graph.

For the KPI category, it is important to select the other option if it is a display of an attribute with a numeric value. The figures below show different types of graphs for illustration. The pie and gauge graphs do not work with a time interval. Gauge chart:

Pie charts (left visualization cone – donut, right pie – pie):

Time scale chart (bar top, bar bottom):

At the top right of the chart, you have three icons:

Restore which returns the graph to its original settings
Exact selection
Allows you to move with the chart timeline


Allows you to select the data that will be displayed within the table
Allows you to export table data or a table as such

Table export:

Filenamethe name of the file under which the table will be saved
Save the typselecting the save type as either .csv or excel file (.xlsx) when selecting excel you will be able to set the sheet name in excel
Select dataselection of current data
Select fieldselect the parameters you want to export
Settingsthe file can be exported with a header or as source data

The next part of the settings are the visual options of the graph:

HeightGraph size – height.
WidthGraph size – width.
Show legendLegend display switch.
Legend vertical positionSelect the position of the legend in the vertical axis – up, center, bottom.
Legend horizontal positionSelect the position of the legend in the horizontal axis – left, center, right.
Legend orientationRotate the legend – horizontally, vertically.

Specific chart type options are also available for the time and alarm chart type. The specific options for the time scale chart are:

Aggregation intervalThis is the time period within which the data is processed into the graph. For example, aggregation functions are applied within a time interval, or bar graphs are plotted accordingly. Represents the time granularity of the graph. It is true that the shorter the time interval, the more time-consuming the processing of the graph.
Time windowRepresents the width of the graph in units of time. This is the range of data that the graph will display. The time window is dynamic – its end is always the current time. For example, a time window of 3 hours displays data for the last 3 hours.
Number of decimalsSetting the display of decimal places.
Visual mappingAdjust colors according to values.

Specific options for the Gauge chart are:

MinimumAlarm chart range – start.
MaximumAlarm chart range – end.
Number of decimalsSetting the display of decimal places.
Number of segments on axisSetting the number of parts on the alarm chart.
Gauge coloringAdjust colors according to values.

Specific options forTable:

kpi.pageSizeSpecifies the number of table values
Date rangeSelect a time range of values in the table
EntitiesDevice selection, data source. It is possible to select more subjects, but the aggregation function is applied to all subjects – for example, data from all subjects are averaged over a time interval. To select an entity, you need to know its name.
Entity typesDevice type selection (entity type). The entity type filters the attributes to display only for the options of that entity type.
kpi.fieldsSelection of the type of measured parameters to be displayed in the table
kpi.selectAllSelection of all possible measured parameters from the selected subject type that can be displayed in the table
kpi.clearAllClears all selected parameters in

After setting the visual options of the graph, it is possible to add the source data for the graph (series). Multiple data series can be added to one graph. Use the + button on the top right.

The parameters for the series are as follows:
Dynamic entitiesThey allow you to dynamically select the devices to which the graph applies – by selecting in the right menu (zones, regions). Can only be used within the City Dashboard application.
EntitiesSelection of the device to which the series relates – data source. It is possible to select more subjects, but the aggregation function is applied to all subjects – for example, data from all subjects are averaged over a time interval. To select an entity, it is necessary to know its name.
Entity typesDevice type selection (entity type). The subject type filters the attributes to display only for the options of that entity type.
DimensionA specific parameter that allows you to select the time unit for layering graphs.
VisualizationGraph subtype selection (line / bar for time graph, pie / cone for pie graph). Only the alarm clock type is available for the alarm chart.
StackedGraph layering activation switch
MeasureSelect the device parameter to be displayed in the graph
Only data changesThe switch activates the rendering of data that has been received without interpolation. (Takes only values from selected data that have been modified after the update)
Aggregation functionSelect a function to be performed with values within the selected time interval. Available are: average, minimum, maximum, sum, last value.
Legend unitSpecify the unit to display in the legend. Pre-filled based on device type definition.

At the bottom of the series settings, it is possible to define the conditions for plotting the graph. The parameters of the condition are:

AttributeA parameter that enters a condition and is compared to a value
Conditions operatorConditional operation: smaller / larger, smaller / larger or straight, straight, is part of the interval ..
ValueThe value to which the attribute is compared

It is possible to create more conditions – add via the + button at the bottom of the window.

In the upper right corner of the window for creating KPIs there are buttons for saving KPIs or cancelling changes, or deleting it (when editing).

If editing of panel components is enabled using the Edit button, it is possible to move and resize individual components within the panel (by dragging the edge of the component). In the upper right part of each component there is a menu enabling editing of the component and KPI, or deleting the component.

5.4. Create new component Type: Image

When creating a new component Type – image:

  1. You need to save the image to google drive first then
  2. Copy this part of the link to the URL first:

3. On google drive, click on the image you want to get to the platform, right-click and select get link

4. copy the name of the image, which is located in the area marked in the image below

5. You must then allow who the image will be able to watch for. Anyone with the link

6. Add the copied text to the URL of the previously pasted text and save the component

7. Then you just have to click to save the component

5.5. Create new component Type: Iframe

As with image creation, now that you select the Iframe Type, you need to specify the page from which the video will load. If you want to get video from youtube to your platform, you must select the Iframe type.

  1. On YouTube, select Share for the video you want to use

2. After opening the Share option, select the first embed window shown in the image below

3. After selecting it, a window with text similar to the one below will open, from which you must copy the part of the youtube page that is in quotation marks.

4. You then paste the page into the URL box in the options when creating the page Iframe in platform

5. As a final step, save the new component you created

5.6. Scheduler

When you open the Performance Dashboard, the Scheduler icon appears on the top bar. This tool allows you to schedule the setting of a selected device parameter to a specific value. A typical example might be resetting the counter. Scheduling can be one-time or periodic. In periodic scheduling, the recurrence period is set in the parameter format for Cron, known from Linux systems. The Scheduler window consists of two parts – on the left is a dialog for creating a new scheduler or editing an existing one, and on the right is an overview of created schedulers.

The scheduler parameters are:

NameUsername for the given scheduler.
StatusScheduler status setting (active / inactive).
EntitiesSelect the device to which the scheduler applies.
Entity typesDevice type selection (entity type). The entity type filters the attributes to display only for the options of that entity type.
RepetitionRecurrence switch – single / periodic event.
PeriodFor a periodic event, it is a recurrence period in the parameter format for Cron.
Next runIn the case of a one-time event, the definition of the execution time. For periodic shows the next execution.
AttributeSelect the device parameter to be set by the scheduler.
ValueThe value to which the parameter is to be set.

6. The Logs & Events application

The Logs & Events application is used to collect notifications from the platform and devices. The application includes a tabular overview of notifications with a filter. Displayed notifications can be filtered by date (range from / to) and it is also possible to search for text in notifications. Within the overview table, each notification has the following parameters:

DateDate of dispatch of the notification.
TypeRepresents the notification level: values are available – Debug, Info, Notice, Warning, Error, Alert, Emergency and Critical. It is possible to set the filter according to the type of notification. For the average user, types from the Warning value are essential.
StatusNotification processing status identifier – values new, seen and done.
SourceOrigin of notification – click to display a window with the sender’s details.
MessageThe content of the notification itself.
Message dataExtension data to the message – parameters.

7. User settings

7.1. Change password

Within the user settings, it is possible to change the login password for the currently logged in user. To change the password, you must enter the current password, and then enter the new password twice. The change is confirmed by the Save password button.

7.2. Notifications

The notification section allows you to set the sending of an alarm notification to a defined e-mail address or via SMS to a given telephone number. The introductory view shows an overview of the set notifications. A new notification can be added via the Add notification button.

Within the notification parameters, an email address or telephone number for the SMS message is defined. You can then indicate the type of messages from the Logs & Events application to be forwarded. It is also possible to add alarms to the notifications – it is necessary to select the Alarm model and then select a specific alarm name. The setting is confirmed with the Create new notification button.

8. CitySys application – Public Lighting

This chapter describes a specific application of the CitySys platform for the needs of monitoring and control of public lighting. As public lighting is one of the basic parts of the Smart City concept, the individual components of the application are described in detail.

8.1. Public lighting – Types of equipment

The concept of public lighting control assumes three basic types of equipment:

  • electrical distribution box – EDB
  • public lighting line (also referred as EDB Line in the platform)
  • street luminaire

8.2. Public Lighting – EDB

The public lighting switchboard (EDB) represents the logical core of the local public lighting system. Each city contains several EDBs, with several (usually 3) outlets (lines) on each EDB, and street lights on each line. This definition describes the tree structure of a public lighting system. EDB is a comprehensive device that contains elements for securing, monitoring and controlling the public lighting system. The native device for EDB is EDB CitySys, which consists of a power and control part. The power part of EDB CitySys contains:

  • Input phase terminals (L1; L2; L3)
  • Main switch
  • 3-phase fuse disconnector
  • Surge arrester
  • Electricity meter with Modbus communication module
  • Contactors of individual lines (resp. Phases: L1, L2, L3)
  • Circuit breakers
  • Circuit breakers and signal auxiliary contacts of individual lines.
  • Door contact
  • Door contact connection terminals
  • Bus “N” and protective “PE” conductor

The control part of EDB CitySys contains:

  • Communication unit disconnector
  • Circuit breakers for 24 VDC power supply and 230 VAC service socket
  • IoT MASTER RF communication unit
  • ADAC control unit
  • Heating thermostat
  • Service socket 230 VAC
  • Fuses 24 VDC
  • Relays – switching on contactors and sirens
  • Siren
  • 24 VDC backup control circuit batteries
  • 24 VDC power supply
  • Heating of the control unit

EDB CitySys is designed so that the rotary switch can be used to manually set the operating mode:

  • automatic – control by ADAC unit
  • off (0, OFF) – outputs are permanently disconnected
  • on (manual) – outputs are permanently on

On the platform, EDB CitySys is displayed under its icon and entity type Electrical Distribution Box:

These parameters can be found in the EDB detail:

StatusEDB status – values OK, NOK, OFFLINE (if it does not communicate for more than 10 minutes) or virtual (device without links to the real switchboard).
Power modeCurrent EDB mode – automatic, manual, maintenance or off values.
Maintenance modeMaintenance mode switch for EDB.
Door conditionCurrent status of the door contact – Open / Closed values.
State of main switchCurrent circuit breaker status – On / Off values.
Master node versionFW version of the communication unit for luminaires.
EDGE-Firmware VersionFW version in the control unit.
Electricity meter dataThe electrometer provides the following measurements: Total actual power [W], Consumed energy [kWh], for each phase: actual voltage [V], current [A], power [W], power factor [-].
Twilight sensorMeasured lighting value in lux.
Temperature in EDBTemperature measured inside the EDB in the control unit.
Number of lines, Breakers, Clamps and ContractorsEDB configuration parameters in terms of number of elements.

8.2.1. Public Lighting– EDB – operating modes

The EDB operating mode is determined by the EDB maintenance mode setting via the platform and also by the current status of the rotary switch in the EDB. The table below defines possible EDB operating modes:

Rotary switch statusMaintenance modeOperating mode
OffOn/Off *Off
ManualOn/Off *Manual
*the maintenance mode setting still affects the siren’s behavior when the EDB door is opened

The EDB operating mode defines its behavior and capabilities. The modes are explained in the table below:

Operating modeDescription
AutomaticEDB is controlled by the configuration of parameters from the platform. Lines are controlled either manually via line switches or using automatic time profiles. In this mode, the platform has an impact on the switching of the contactors, therefore in this mode no work may be done on the EDB or on the connected lines and luminaires. When the EDB door is opened, a warning siren is activated.
MaintenanceAutomatic processes are suspended, but the platform still has an impact on switching the contactors. When the EDB door is opened, the siren is not activated, and opening the door is not considered an error condition. By activating the maintenance mode, the status of the contactors does not change. EDB maintenance is possible in this mode, but Off mode is recommended when working on connected lines and luminaires.
OffEDB is manually (physically) switched off (shut down). The rotary switch ensures permanent disconnection of the contactors regardless of the status of the control signals from the platform. In this mode, full maintenance of the EDB and the connected cables and luminaires is possible. It is recommended to turn off all circuit breakers at the same time.
ManualEDB is manually (physically) turned on. All lines have contactors on regardless of the status of the control signals from the platform. At the same time, the IoT Master communication unit is disconnected – thus the luminaires go into the switched-on state even in the case of the set profiles. This mode is used to test the luminaires before installation and as an emergency switching on of the lighting in case of a fault on the control unit. When activated for more than 5 minutes, the luminaires will be logged out of the communication unit in the EDB.

Activating the maintenance mode will allow access to the EDB (door opening) without activating the siren.

8.2.2. Public lighting – EDB – conditional coloring

The EDB device allows to set the conditional coloring on the map base according to the following parameters: Status, Power mode and Door condition. The color schemes are as follows:

8.2.3. Public lighting – EDB – NOK status condition

Because EDB is a complex device containing many elements, the NOK condition can be triggered for a variety of reasons. In general, the NCA will arise in a situation where the EDB requires maintenance attention because an element is not working properly and could result in a malfunction of the public lighting or damage to the EDB. The table below documents the reasons for the NOK condition:

EventSeverity level
Door open out of maintenance modeWarning
Dropped main circuit breakerCritical
The IoT Master communication unit does not respondAlert
The Electrometer does not respondError
Power failure on one of the phasesCritical
Battery errorError
Power supply errorAlert
The thermometer does not respondWarning

To identify the specific cause of the NOK condition, it is recommended to look in the Logs & Events application, where there will be a notification about the event that caused the NOK condition, together with a description of the event. Another option is to decode the Status Code value, which directly identifies the causes of the NOK status.

Bit (0=LSB)ParameterStatus for 1Status for 0Status for 10Status for 11
0Main circuit breakerOffOn
1-2Power modeManualAutomaticallyTurned offMaintenance
3Door contactOpenClose
4Electricity meter conditionNOKOK
5Thermometer conditionNOKOK
6Battery levelNOKOK
7Power supply statusNOKOK
8Master Node StatusNOKOK
9Phase voltage failureNOKOK

8.3. Public lighting – Line

The line represents one EDB terminal, which is controlled by a specific contactor. In the real embodiment, it can be one single-phase terminal, but also a three-phase terminal, in the case of several terminals connected to the same contactor. In a tree structure, a line is nested into an EDB as an object and may or may not be located on a map. Among the parameters of the line are also the characteristics of the line of the given line. Within the parameters that determine the state of the line, the following are important:

StatusLine status – OK or NOK values.
State of breakerCurrent state of the line circuit breaker – values On / Off.
State of contactorCurrent status of the line contactor and at the same time its switch – values On / Off. It can be manually controlled from the platform.
Profile lineCurrently set line profile. Its course is graphically represented. It can also be set in maintenance mode.

The device of the line also allows to connect a secondary electricity meter and within the parameters it is therefore possible to monitor the electrical parameters of the line. In the basic form, however, the line does not contain an electricity meter. The state of the line is determined by only one condition – the state of the circuit breaker. If the circuit breaker is tripped, the state of the NOK line. Conditional coloring only supports coloring by status:

Line control from the platform is possible in two ways: manually or automatically. In both cases, it is necessary to activate the maintenance mode on the top bar. Subsequently, the Contactor Status and Line Profile elements are activated. Clicking the radio button will change its status. Sending the settings to the line must be confirmed by pressing the green button and then in the confirmation window. Similarly, for a line profile, by clicking in the profile field, it is possible to select from the list of created profiles Public lighting – Profiles. The sending is also confirmed by pressing the green button. Confirmation of order execution can also be found in the Logs & Events application.

8.4. Public lighting – Street Luminaire

A street luminaire is the terminal equipment of a public lighting system. In a real implementation, it can be any luminaire that contains a CitySys IoT Node with PLC, RF or Cellular technology. CitySys IoT Node is a control unit located inside the luminaire or via a NEMA / Zhaga socket on the luminaire. Schematically, the CitySys IoT Node is located between the power supply in the public lighting pole and the ballast in the luminaire. As it has an integrated relay, it allows the phase to be physically disconnected from the ballast. Using the DALI interface, the luminaire can be dimmed to control consumption and brightness. The CitySys IoT Node is also equipped with an integrated electricity meter and tilt sensor.

In the tree structure of the device, the luminaire is typically located below the line and below the EDB.

These parameters can be found in the detail of the luminaire:

StatusLamp status – OK, NOK or OFFLINE values.
SN(IoT Node – street luminaire)The address of the luminaire for communication purposes is located on the IoT node label.
Status of communicationCurrent status of the communication line.
BrightnessCurrent state of luminaire brightness – values 0 – 100%. It can be changed manually.
Correlated Color TemperatureCharacteristics of the light source. As standard, it is a constant, but it is possible to have a lamp with an adjustable color (tunable white).
Dimming ProfileCurrently set luminaire dimming profile. Its course is graphically represented. It can also be set in maintenance mode.
FW versionFW version in the IoT Node control unit.
Electricity meter dataThe Electricity meter provides the following measurements: energy consumed [kWh], actual voltage [V], current [A], power [W], power factor [-], frequency [Hz].
TemperatureCurrent temperature in the control unit [° C].
Inclination X, Y, Z-axisTilt measurement in individual axes.
Lifetime of lampThe total time the IoT Node was energized.
Actual time, Sunrise and Sunset timeTime parameters of internal clocks and astro-hours for profiles on the luminaire. Synchronization is provided by the control unit in the EDB.

The control of the street luminaire is similar to the line. You must first activate the maintenance mode for the lighting. Subsequently, the control elements for brightness and dimming profile are activated. For brightness, it is possible to set the value from 0 to 100%, where 0 represents the switched off luminaire and 100 represents the full power of the luminaire. The dimming profile is selected from the list of created dimming profiles. The setting is confirmed by the green button and then in the confirmation window. Confirmation of order execution can also be found in The Logs & Events application.

8.5. Public lighting – Street luminaire – coloring

The Street Luminaire device allows you to set the conditional coloration on the map base according to the following parameters: Status, Brightness and Communication status. The color schemes are as follows:

8.6. Public lighting – Profiles

The Profiles tool is used to create and manage switching and dimming profiles for automatic lighting control. Switching profiles are designed for lines – this means that only two states can be assigned to individual time points: on or off. According to the switching profiles, the line contactors are controlled and are therefore superior to the dimming profile. Dimming profiles are designed for luminaires (compatible with CitySys IoT Node) and allow automatic control of luminaire brightness according to time. It is possible to assign a brightness value from 0 to 100% to the individual time points. The profiles themselves are created without binding to the final EDBs. The same profile can therefore be assigned to different lines and luminaires on different EDBs. When using astro hours, the real times of twilight and dawn within the EDB are always recalculated according to its current GPS coordinates. The Profiles tool opens when you click the Profiles icon in the top bar. This icon is only available if maintenance mode for lighting has been activated. The Profiles window then pops up from the top bar.

The window is divided into two parts: on the left are dimming profiles (for luminaires) and on the right are switching profiles (for lines). The tables show an overview of already created profiles with a name and a sample of the course, where black represents the off state and shades of yellow and orange the on state. With the dimming profile, yellow represents 100% brightness and orange brightness 10%. You can create a new profile using the buttons at the top right, and you can edit an existing profile by clicking the pencil icon next to the profile. In both cases, the same profile editing window opens.

The upper part of the window is common for dimming and switching profiles. The profile parameters are as follows:

NameUser profile name. It is also possible to enter name translations.
Use astro clockAstro clock switch. When turned on, the profile is limited by the time of dusk and dawn.
Use a lux sensor for dusk / dawnLight sensor use switch for combined profile. Switches are only available when astro clock is activated at the same time.
Astro-clock shiftThe value by which the current twilight / dawn time is shifted. Negative values are also possible.
Lux sensor time windowThe size of the time window around the twilight / dawn time in which the light sensor has priority.
Lux sensor thresholdThe value from the light sensor, exceeding which triggers the switching on (twilight) or the switching off (dawn) of the profile.

At the bottom of the window is a graphical tool for creating profile points:

This part is already different for dimming and switching profiles. For switching profiles, only two values ??can be set in each interval using the on / off switch. For dimming profiles, you can adjust the brightness level in percent by dragging the top of the interval rectangle. At the same time, the color of the rectangle changes from yellow (100%) to dark orange (10%). The blue circle with the white + mark is used to create a new interval. You can adjust the position of the new interval by dragging the blue wheel and timeline connector. This is created by clicking on the blue wheel, in such a way that the existing interval is divided in the current position of the blue wheel. Subsequently, it is possible to change the time limits of the intervals by moving the sides of the intervals to the right / left. There can be a maximum of 16 intervals within one profile. Intervals can also be removed using the red wheel with the white cross below the timeline. The boundary between the intervals disappears in such a way that the interval to the left of the boundary “absorbs” the interval to the right of it. For dimming profiles, it is also possible to set the chromaticity temperature (CCT) level within the interval by clicking on the pencil icon within the interval rectangle. Using the scroll bar or the text box, you can enter the CCT, which is then indicated by highlighting the pencil icon. Only a special type of luminaire supports CCT change. For classic monochrome, this parameter is ignored. An important parameter is the astro clock switch. When turned off, the profile behaves exactly according to the graphic design and preview every day of the year. When activating the astro clock, the point at which the line turns on is added at twilight and the point at which the line turns off at dawn. This means that even if the profile interval starts at 19:00, for example, if it is twilight at 18:30, the line will start at 18:30. However, if the situation is the opposite and the profile interval starts at 18:30 with the on state, then this point is executed and the twilight point at 19:00 does not manifest itself in any way (transition from on to on state). Therefore, for the correct function of the astro clock (twilight on, dawn off), there should be no on point before dusk, and an off point for dawn – unless this function is required. Astro clocks work correctly even in the basic form, when a single interval with an off state is defined (from 13:00 to 13:00). The intervals between twilight and dawn are not affected by astro hours. The current time of dusk / dawn depends on the day of the year and the position of the EDB. Therefore, different EDBs have different switching times depending on the longitude of their position. Twilight / dawn time can be statically shifted statically (every day of the year) using the Astroclock Shift parameter. The parameter can be set in minutes as a positive or negative number. Another way to influence twilight on or dawn off on a line is to use a light sensor. Based on the values ??from its measurement, the EDB decides when within the time window of the light sensor it actually turns on or off the line. turns off. For example, at dusk, when the threshold value of the light sensor is set to 100 lx, if the measured value falls below 100 lx, the line will be switched on at a time other than the calculated twilight time. This only applies within the time window around the calculated twilight / dawn time. If in this example the measured value does not fall below 100 lx even after the time window has elapsed, the line will be switched on, because at that point the astro hours already have priority. The behavior at dawn is analogous with the difference that the measured value must be greater than the threshold and the line switches off. To save the profile, press the Save button. An existing profile can be deleted using the trash can icon next to the profile. After creating a profile, it is then possible to assign it to a line or luminaire via the detail of the device..

8.7. Public lighting – Logs & Events

EDB CitySys sends event notifications to the platform. These are various fault conditions, their elimination, but confirmation of commands from the platform. They are used to quickly check the status of the EDB or identify the error condition. The table below contains all messages with a description. Notifications highlighted in orange are associated with the invocation of the NOK state of the EDB, which represents a state where the EDB does not work correctly.

1Switching profile point applied to line no. xInformationalApplied point of the switching profile on line no. X.
2Dusk has occurred:InformationalTwilight has come, the value of twilight time.
3Dawn has occurred:InformationalDawn has occurred, dawn time value.
4Dimming profile was successfully received by node no. xNoticeThe dimming profile was successfully received by node no. X.
5Master node is responding againNoticeThe master node started responding again.
6A command was sent from terminal interfaceDebugA command was sent from the terminal. A command to the luminaire was sent from the EDB’s internal interface.
7Master node is not respondingAlertThe master node is not responding
8Configuration of dimming profile to node no. x has failedAlertDimming profile configuration for node no. X failed.
9Circuit breaker was turned on – line no. xNoticeSwitching on the circuit breaker on line no. X.
10Circuit breaker was turned off – line no. xErrorSwitching off the circuit breaker on line no. X.
11Dimming profile was processed for node no. xInformationalThe dimming profile was processed for node no. x.
12The dimming profile was successfully received by node no.NoticeNotification of successful receipt of the profile by the luminaire.
13Switching profile was processed for line no. xInformationalThe switching profile was processed for line no. x.
14Thermometer is not respondingWarningThe thermometer in the EDB does not respond.
15Thermometer is responding againNoticeThe thermometer in the EDB responds again.
16Main switch has been turned offCriticalThe main power switch has been turned off.
17Main switch has been turned onNoticeThe main power switch has been turned on.
18Power supply has disconnected inputAlertThe power supply has no input voltage.
19Power supply works correctlyNoticeThe power supply is working properly.
20Battery level is lowErrorThe battery has a low voltage level.
21Battery level is OKNoticeThe battery has the correct voltage level.
22Door has been openNoticeThe door was open.
23Door has been closedNoticeThe door was closed.
24Door has been open without permission – alarm is onWarningThe door was opened without permission – the siren was on.
25State of contactor for line no. X isInformationalContactor status for line no. X is.
26Electrometer is not respondingErrorThe Electrometer does not respond.
27Electrometer is responding againNoticeThe Electrometer answers again.
28No voltage detected on phase no. XCriticalFor phase no. X is not a voltage.
29Voltage on phase no. X has been restoredNoticeVoltage on phase no. X has been restored

Notification messages can be used directly to diagnose EDB. The table below describes and suggests the procedure for the occurrence of a given notification:

1Applied point of the switching profile on line no. x – used to check the course of the switching profile with a specific time stamp.
2Twilight has occurred, twilight time value – used to check the course of the switching profile with a specific time stamp.
3Dawn has occurred, the value of the dawn time – it is used to check the course of the switching profile with a specific time stamp
4The dimming profile was successfully received by node no. x – – is used to control the transmission of the profile towards the luminaire.
5Master node started responding again – notification of troubleshooting with Master node.
6A command was sent from the terminal. A command to the luminaire was sent from the EDB’s internal interface – a notification that someone had used this interface.
7Master node does not respond – unable to communicate with communication unit. Check the unit circuit breaker, the status of the LEDs and the communication wires between the Master node and the ADAC unit. If the problem persists, contact the service organization.
8Dimming profile configuration for node no. X failed – there was a problem sending the profile to the light. Make sure the light is on and communicating, or resend the profile. If the problem persists, contact the service organization.
9Switching on the circuit breaker on line no. X – information about line circuit breaker tripping.
10Switching off the circuit breaker on line no. X – check the condition of the circuit breakers and ensure that they are switched on. In case of repeated shutdown, eliminate the problem on the line (short circuit or high consumption).
11The dimming profile was processed for node no. x – information for checking the sending of the profile from the platform to the control unit.
12Notification of successful reception of the profile by the luminaire – information for checking the sending of the profile from the control unit to the luminaire.
13The switching profile was processed for line no. x – information for checking the sending of the profile from the platform to the control unit.
14The thermometer in the EDB does not respond – check the connection of the thermometer to the ADAC control unit. If the problem persists, contact the service organization.
15The thermometer in the EDB responds again – information that the problem with the thermometer has been eliminated.
16The main switch has been switched off – check the status of the main switch and make sure it is switched on. In case of repeated switch-off, eliminate the problem on the line (short circuit or high consumption).
17The main switch has been turned on – information about switching on.
18The power supply has no input voltage – check the power supply supply for the control unit. Either the circuit breaker is tripped, the cable is broken or there is a power failure (mains voltage). If the problem persists, contact the service organization.
19Power supply is working properly – Learn how to troubleshoot the power supply.
20The battery has a low voltage level – check the battery connection and the voltage at its terminals. If the problem persists, replace the battery or contact a service organization.
21The battery has the correct voltage level – battery troubleshooting information.
22The door was opened – information on the opening of the EDB door during maintenance mode.
23The door was closed – information on closing the door.
24The door was opened without permission – the siren was on – the door was opened out of maintenance mode. Close the door or activate maintenance mode.
25Contactor status for line no. X is – information about the change of contactor status for the line.
26The Electrometer does not respond – check the power supply of the electrometer (display light) and the connection of the RS485 bus cables to the control unit. If the problem persists, contact the service organization.
27Electrometer Responds – Information on how to troubleshoot the electrometer.
28For phase no. X is not voltage – check the phase supply to the electricity meter, or check the main circuit breaker of the consumption point. If the problem persists, contact the service organization or check the current status of electricity distribution at the given point of consumption.
29Voltage on phase no. X has been restored – – voltage troubleshooting information.

9. Reports

9.1. Reporting defects to users

The provider provides a guarantee for all services provided for a period of 24 months. The warranty period for the performed services begins on the day of signing the acceptance protocol. The warranty period will be extended by the time period during which the service or its part was claimed, by the time from the date of the justified complaint until the removal of the claimed defect. If the customer finds a defect in the service provided, he is obliged to notify the provider of this fact without undue delay in writing – in electronic form through HELP DESK. Such notification shall include the identification of the defect, its location and a description of the defect. The customer is obliged to provide all necessary cooperation, in particular to allow the provider access to the place of occurrence of the defect. The provider is obliged to eliminate the detected and claimed defects of the provided service free of charge within 7 days from the date of delivery of the notification of the defect by the customer, unless the parties agree in writing on a different period in a specific case. The provider is obliged to eliminate every claimed defect, ie. even one in which it is not possible to determine with certainty who is responsible for the defect. In the event that during the elimination of the defect or after the elimination of the defect, it is proven that the provider is not responsible for it, the provider is entitled to reimbursement of purposefully incurred costs in connection with the elimination of the defect. In the event that the provider does not rectify the claimed defects within the agreed period, despite the fact that the customer has created the conditions for their removal, the customer has the right to remove the defects at the provider’s expense or entrust a third party at the provider’s expense without the provider’s consent. The assertion of a claim for liability for defects by the customer does not preclude the assertion of a claim for compensation for damage caused to the customer by the defect.