Dashboard
Peripherals status
This section shows the state of the peripherals (sensors, digital I/Os, watchdogs) in a customizable table format. The information shown gets updated in real time, to give an up-to-date overview of the system state.
Status and event table controller
To customize the table display, the controller bar features multiple features, which are all optional.
Choose which type of peripherals should be included in the table.
Only show rows, that represent a peripheral that is not in normal state.
If groups are defined, select one of the existing groups from the dropdown, to only show peripherals belonging to that group.
Choose the attribute to sort the rows by from the dropdown. The order (ascending/descending) can also be set.
To reset the filter and sorting settings to factory default, click on the reset button.
These settings will be saved in your browser.
In case of a problem, please refer to Troubleshooting.
Status and event table
Each row represents a peripheral device.
Refer to the table below, for an overview of the Status and Event Table heading and cell meanings.
If a peripheral is not within its normal range (abnormal condition), the row gets highlighted in orange.
| Peripheral Type | Name | Value | Condition or Output Control | Activity | Group |
|---|---|---|---|---|---|
| Sensor | Name of the Peripheral | Current sensor reading,--- in case of a failure | Abnormal condition e.g. Too high,or empty, if within normal range or error code | Time since the last change in state or value since page load or empty if no activity occurred since system startup | The group this peripheral belongs to |
| Digital Input | On or Off | empty | |||
| Digital Output | On or Off | A toggle button to control the output | |||
| Watchdog | empty | Last check result, or Deactivated |
Sensor errors
In case of a problem with a sensor, an error code might be displayed in the Condition or Output Control column. See Troubleshooting.
Peripherals history
This section shows the historical data of the peripherals (sensors, digital I/Os, watchdogs) in the form of highly customizable diagrams.
You can add (and remove) chart instances, each of which can display the data for one or more peripherals.
By default, one chart instance is already set up.
Like with the Status and Event Table, the historical data can get updated in real time.
The general procedure is as follows:
Chart setup
Add and configure one or multiple chart instances, each displaying one or multiple data sources (historical peripheral data).
After adding and/or configuring a chart instance, it will persist and be accessible in the future.
On a new device, no chart instances are configured by default. Add a first chart to get started.
Chart usage
Use the historical data controller to select the time frame you are interested in. All configured chart instances will react and display the data for the selected timespan.
Historical data controller
The settings of the controller are applied to all chart instances, if more than one is configured.
The data controller acts as a means to set the desired timeframe of historical data to show.
Click, to add a new chart instance, which will be appended below the existing chart instance(s). See Configuration and data selection for details on how to set up the new instance.
Choose a start and end date for the timespan you would like the chart(s) to display.
Choose from the provided periods.
On the left of this picker, the currently effective Time Step is displayed.
The date picker and period picker can not be used at the same time. Setting one disables the other.
When the site reloads, the 3h period from the period selector is active.
Next steps:
Proceed to Configuration and data selection to learn how to quickly configure the chart instance and select the data sources to display.
For further details on the chart elements, refer to the sections after that.
Historical data charts
A chart widget consists of a top bar, with buttons for Data Selection
depending on the settings made in the data selection panel.
General
A single chart instance can display multiple data sources (continuous or discrete).
While those data sources each render a time series representation (line chart or discrete event chart), they share certain elements.
Configuration and data selection
The data selection button
Click on the data selection button to open the data selection panel.
Here you can choose, which peripherals to include in the chart.
When adding a new chart instance, the data selection panel will open automatically.
The panel is composed of rows, where each row corresponds to a peripheral.
To include the historical data of a peripheral in the chart, tick the checkmark in the corresponding row. On the right side of the row you will find a color picker, that you can optionally use to define a custom color for the data row to use in the line chart or event chart.
On the bottom of the panel, there is a Groups section. If you have defined groups (see Peripherals), choosing a group from the dropdown menu will select all peripherals belonging to that group automatically.
Time axis & Time steps
The time axis spans the selected time interval of interest, that was selected via the Historical Data Controller, either by the Date, or the Period Picker.
Depending on the selected time interval and the browser window width, the time axis is divided into equal time steps.
The currently effective time step is displayed on the left side of the Period Picker in the Historical Data Controller.
Tooltip
A tooltip, that gets displayed when the chart is hovered with the mouse.
Depending on the horizontal cursor position,
the head of the tooltip shows the selected (hovered) time step, while underneath it displays a row with detailed information for each data source at the selected time step:
- For continuous data sources (sensors) the average value is displayed on the left, while minimum and maximum values are displayed on the right.
- For discrete data sources it shows
State at the beginning of the time stepNumber of changes within the time stepState at the end of the time step.
Reset markers
Reset markers on the top of the chart, that indicate a system reboot.
Line charts
Line charts display the time series of continuous sensor values.
Lines are rendered in the color that was selected in the data selection panel for the corresponding sensor.
- The main line (bold color) represents the average sensor value of the time step.
- The area underneath (light color) is spanned by the minimum and maximum values that occurred within the time step.
If multiple continuous data sources (sensors) within the same chart instance are configured to use the same unit, they share a common y-Axis. If they use different units, each gets its dedicated y-Axis.
Discrete event charts
Discrete event charts display the time series of discrete events (or state changes), like Digital Input or Output, as well as Watchdog state changes.
Each discrete data source renders its own event chart, along with a y-Axis with labels for the corresponding states (On and Off for Digital I/Os, OK and Failure for Watchdog states).
- The main line (bold color) represents the state of the peripheral throughout time steps.
Within a single time step
- Horizontal lines indicate that the state at the beginning and the end of the step were identical.
- Diagonal lines indicate that the state at the beginning and the end of the step differ.
In both cases, it is possible, that the state changed during or in the middle of the time step, while the start and end states are still identical.
In this case, the line gets drawn dashed.
If multiple state changes occurred during a time step, a rectangle (light color) underneath the main line represents the number of state changes in a bar chart manner. The height of these bars is proportional to the number of state changes that occurred during the time step, relative to the maximum number of state changes that occurred in any time step within the selected time interval.
The following table shows some possible line and bar variations for the discrete event charts, where the vertical grey bar indicates the relevant time step.
| Appearance | Meaning |
|---|---|
 | No state change during the step |
 | Multiple state changes during the step but start and end states are identical |
 | A single state change from off to on |
 | Multiple state changes during the step, while starting in the off state and ending in the on state |
 | A single state change from on to off |
 | Multiple state changes during the step, while starting in the on state and ending in the off state |
Chart menu
Click on the button on the top right of a chart widget
Here you can
- Enable the Fullscreen mode, to enlarge the chart
- Move up or Move Down the chart, relative to other charts
- Remove the chart instance
Troubleshooting
General
If you encounter a state, where the display of information on the dashboard is corrupted, you can reset the dashboard configuration on the General configuration page by clicking under Maintenance, as described here.
Problems with sensor readings
In case of a problem with a sensor, an error code might be displayed in the Condition or Output Control column.
A list of common error codes and their meanings can be found on the sensors docs page.