Usage

Dashboard screenshot

Top indicators

The dashboard has two indicators and a clock on the top row at the right site.

Status indicator

Online
Dashboard top indicators online screenshot
The first green round check mark shows that the interface is connected with the server and that it is working as expected.

Offline
Dashboard top indicators offline screenshot
When there is a connection problem, the first round check mark will turn to a red explanation mark which indicates that there is a problem.

History
Dashboard top indicators history screenshot
Click on the online/offline indicator to get some history. The history is cleared when the web interface is reloaded.

Door indicator

Door is closed
Dashboard top indicators online screenshot
The second indicator is a lock that shows the status of the door(s). It is green when all doors are closed.

Door is open
Dashboard top indicators online screenshot
When a door is opened, the indicator will change to a red open lock. This indicator is near real time, so when you open the door, the indicator will change.

History
Dashboard top indicators history screenshot
Click on the door indicator to see the last 6 notifications. During loading of the dashboard the door changes for the last 24 hours are loaded from history.

Date and time

Day
Dashboard top indicators online screenshot
The last indicator is the current time. When it is day time, a sun is shown.

Night
Dashboard top indicators online screenshot
When the sun sets, the icon of the date time indicator in a moon.

Top tiles

All tiles will be updated in real time. When a switch is toggled, either by hand or by the system, the tiles will update instantly.

Dashboard top indicators online screenshot

Uptime

The first tile shows the hardware uptime. And it shows three bars which indicates the load off the hardware. First bar is actual load, second is load during 5 minutes and last is load during 15 minutes.

Power usage in Watt

The second tile shows the current power usage in Watts. The amount is calculated based on the power switch settings and what the state is of the switches. The bar shows a percentage of the max usage.

Water flow in L/m

The third tile shows the current water flow in liters per minute. The amount is calculated based on the power switch settings and what the state is of the switches. The bar shows a percentage of the max usage.

Total power in kWh

The fourth tile shows the total power usage from the start of using this software. It will calculate the total power usage every 10 minutes based on all historical data. It is shown in kilo Watt per hour. When the power price is entered, it will show the costs of the power bill and the amount of days it is calculated on.

Total water in L

The fifth tile shows the total water usage from the start of using this software. It will calculate the total water usage every 10 minutes based on all historical data. It is shown in liters. When the water price is entered, it will show the costs of the water bill and the amount of days it is calculated on.

Environment

Dashboard top indicators online screenshot

The environment section shows the current state of the environment. The environment is divided in three parts. There is a lighting system, a spray system and a heating system.

When a part is active the title is in color. If the title is gray that part is than not running or configured.

Lights

The lights part give the basic information about how the light system is configured. It shows the chosen mode out of 'clock' or 'weather'. There are no triggers or warnings used by the light system.

The state indicator is either green or red. Green means that it is switched on. When it is red, the lights are switched off.

The on value is the time stamp when the lights are turned on.

The off value is the time stamp when the lights will be turned off.

The duration holds the amount of hours that the lights are on.

Sprayer

The sprayer part give the basic information about how the spray system is configured. The spray system uses humidity sensors to determine the current and minimum humidity value. When the current value is below the minimum value a warning sign () will be shown. There is no mode, the spray system just works on sensor data.
The state indicator is either green or red. Green means that it is switched on. When it is red, the sprayer is switched of
The current value shows the current humidity in percentage.
The alarm min value shows the lowest value that is valid. When the current value become less then the alarm min value, an alarm message will be shown and the trigger to spraying is activated.

Heater

The heater part give the basic information about how the heating system is configured. The heating system uses temperature sensors to determine the current, minimum and maximum temperature value. When the current value is outside the minimum or maximum value a warning sign () will be shown.
There are three modes available. 'Clock', 'Weather', 'Sensor'.
The state indicator is either green or red. Green means that it is switched on. When it is red, the heater is switched of
The current value shows the current temperature in degrees.
The alarm min value shows the lowest value that is valid. When the current value become less then the alarm min value, an alarm message will be shown and the trigger to heating is activated.
The alarm max value shows the highest value that is valid. When the current value become more then the alarm max value, an alarm message will be shown and the heating is deactivated.

Graphs

The graphs on the home are combined graphs from all temperature and humidity sensors. The gauge meters are real time and show the current value. The historical graphs shows also the minimum and maximum value and will be updated once every 5 minutes.

Every sensor has his own type and a minimum and maximum value. To get the graph data all the data is combined and divided by the amount of sensors. This way the average of the sensors is used.

Dashboard top indicators online screenshot

/ Type

There are multiple graph times. On the home there is a humidity and a temperature graph shown.

  • Humidity
  • Temperature

Last update

When there is new data, the gauge part of the graph is updated and will also update the last update time stamp.

warning warning

When the current value is outside the minimum of maximum value a red warning badge is shown.

Period

With the calendar icon you can select multiple periods for the historical graph. The valid periods are:

  • Day
  • Week
  • Month
  • Year

Options

With the wrench you will get an options menu.

Weather forecast screenshot

Weather Current

Current weather widget screenshot

The forecast widgets shows the forecast at current time and the location for which the forecast is valid. The data is loaded external from the external API source and is not measured by the software.

It shows the current day and time for which the forecast is valid. And what temperature indicator is used.

The forecast is based on the time of the day. During the day, a sun is used in the animation. During the night a moon is used.

The sun rise and sun set are shown on the right side. The line that is bold is indicating the current state.

The week forecast is shown at 13:00 hours of each day.

Day forecast

Weather day forecast screenshot

The day forecast shows the temperature per hour for 24 / 36 hours from now. The title holds the graph period.

Use the calendar icon in the title to select the period for the history graph.

Week forecast

Week forecast screenshot

The week forecast shows the temperature per hour for 10 days from now. The title holds the graph period.

Use the calendar icon in the title to select the period for the history graph.

Settings

Enter the full URL of the API weather server. For use with Weather.com you need to get a free API key from http://api.wunderground.com/. The temperature are read in Celsius degrees. It can be converted to Fahrenheit.

All fields with a * are required.



  • Location: Holds the external source URL. Supported sources are: YR.no, Openweathermap.org, Wunderground.com.
    • YR.no: https://www.yr.no/place/[COUNTRY]/[PROVANCE]/[CITY]
    • Openweathermap.org: https://api.openweathermap.org/data/2.5/weather?q=[CITY],[COUNTRY_2LETTER]&units=metric&appid=[YOUR_API_KEY]
    • Wunderground.com: https://api.wunderground.com/api/[YOUR_API_KEY]/geolookup/astronomy/hourly10day/q/[COUNTRY]/[CITY].json
    • YR.no: https://www.yr.no/place/[COUNTRY]/[PROVANCE]/[CITY]
    • Weather underground: http://api.wunderground.com/api/[YOUR_API_KEY]/geolookup/astronomy/hourly10day/q/[COUNTRY]/[CITY].json
  • Wind speed: Choose the wind speed indicator. The software will recalculate to the chosen indicator.
Sensors overview screenshot

On the sensors page you can find all the available sensors page grouped by type. Select temperature from the menu to get all the temperature sensors. Select humidity for all humidity sensors.

Per graph you have the following options and indicators.

Title

Per sensor the title shows some values and options.

Sensor 'Name' ... warning

Left side (values)

  • The sensor type
    • : Humidity sensor
    • : Temperature sensor
    • : Distance sensor
  • The configured name
  • The time stamp of the last measurement.
  • Warning badge when the sensor value is outside the defined save operating values.

Right side (Options)

  • : Show or hide the sensor
  • : Select history graph period
  • : Options menu
  • : Close

Current

The gauge graph shows the current temperature or humidity value. The color of the graph depends on the current value and the alarm values. When the value gets more to the minimum or maximum value, it will gets more red/orange.

The values are updated every 30 seconds and updated in real time on the page.

The current value is also written below the graph in degrees, percentage or distance.

History graph

Sensor history graph

The history graph will shows the measured value. The flat lines are the minimum and maximum values that are configured. When the measured value is outside this range an alarm will be given. Hover above the graph lines to get detailed information.

Use the calendar icon in the title to select the period for the history graph.

Settings

On the door settings page you can configure all needed doors. Click on button to add a new door. And empty form like below is shown and has to be filled in. Make sure the right values are filled in. All fields with a * are required.

*
*
  • Hardware: Holds the sensor hardware type. Supported hardware types are: owfs, remote, w1, dht11, dht22, am2302, sht2x, htu21d, si7021, bme280, chirp, veml6075, sht3x, ytxx-digital, hc-sr04, sku-sen0161, miflora.
  • Address: Holds the sensor address. Depending on hardware type, it is either a read only hex number, a GPIO pin, a GPIO pin combination of 'TRIG,ECHO' or a full HTTP(S) adress. Full url specification can be found on the 'Remote data' wiki page. For GPIO use physical GPIO pin numbering.
  • Type: Holds the sensor type. Supported sensor types are: temperature, humidity, moisture, conductivity, distance, ph, light, uva, uvb, fertility, co2, volume.
  • Name: Holds the name of the sensor.
  • Alarm min: Holds the sensor lower alarm value of the sensor. When below this value, alarms can be triggered.
  • Alarm max: Holds the sensor maximum alarm value of the sensor. When above this value, alarms can be triggered.
  • Limit min: Holds the sensor lowest value that should be used in the graphs.
  • Limit max: Holds the sensor maximum value that should be used in the graphs.
  • Current: Shows the sensor current value in temperature or humidity (read only).
Switches overview screenshot

Title

Per switch the title holds shows some values and options.

Switch 'Name' 50W, 0.2L/m Total power in kWh: 0.05, Total water in L: 0.0002

Left side (values)

  • The configured name
  • The power usage and/or water flow per minute when switched on
  • The total amount of power usage and/or water usage for the selected history period

Right side (Options)

  • : Show or hide the switch
  • : Select history graph period
  • : Options menu
  • : Close

Status and toggle

On the switch page there are power buttons that toggle the power switches. Every switch will be listed, and can be controlled from the status page. In order to toggle the switch, a request for a username and password is being made. Use here the username and password that are configured at the system configuration page.

The list is also updating when the environment toggles a switch. The state off the switch is shown here in real time.

Status

  • : Switch is on
  • : Switch is off

History graph

Switch history graph

The history graph will shows when a switch was powered on. It will show the power usage on the y-axis and time on the x-axis. When hovering over the graph it will also show the water usage.

Use the calendar icon in the title to select the period for the history graph.

Settings

On the switch settings page you can configure all needed switches. Click on button to add a new switch. And empty form like below is shown and has to be filled in. Make sure the right values are filled in. All fields with a * are required.

*
*
  • Hardware: Holds the switch hardware type. Supported hardware types are: ftdi, gpio, gpio-inverse, pwm-dimmer, remote, remote-dimmer, eg-pm-usb, eg-pm-lan, eg-pm-rf, dc-dimmer, wemo.
  • Address: Holds the switch address. Depending on hardware type, it is either a number or GPIO pin. For GPIO and PWM-Dimmer use physical GPIO pin numbering.
  • Name: Holds the switch name.
  • Power usage in Watt: Holds the switch power usage in Watt when switched on.
  • Water flow in L/m: Holds the switch water flow in liters per minute when switched on
Doors overview screenshot

Title

Per door the title holds shows some values and options.

Door 'Name' ... warning

Left side (values)

  • The configured name
  • The total time the door has been open
  • Warning badge when the door is open

Right side (Options)

  • : Show or hide the door
  • : Select history graph period
  • : Options menu
  • : Close

Status

On the door page there is a list of door sensors that show the current status of the doors. There can be as much doors added to the system as needed.

The list is also updating when a door is opened by hand. The state off the door is shown here in real time.

Status

  • : Door is open
  • : Door is closed

History graph

Door history graph

The history graph will shows when a door was opened.

Use the calendar icon in the title to select the period for the history graph.

Settings

On the door settings page you can configure all needed doors. Click on button to add a new door. And empty form like below is shown and has to be filled in. Make sure the right values are filled in. All fields with a * are required.

*
*
  • Hardware: Holds the door hardware type. Supported hardware types are: gpio, remote.
  • Address: Holds the door address. When using GPIO use physical GPIO pin numbering as address.
  • Name: Holds the door name.
Webcam overview screenshot

Title

Per webcam the title holds shows some values and options.

Webcam 'Name'

Left side (values)

  • The configured name

Right side (Options)

  • : Show or hide the door
  • : Select history graph period
  • : Options menu
  • : Close

Zoom

Use the zooming control to zoom in and out.

Controls

  • : Zooming control
  • : Zoom at minimum level
  • : Zoom at maximum level

Full screen

Use the full screen control to toggle full screen on or off.

Controls

  • : Full screen control

Settings

On the webcam settings page you can configure all needed webcams. Click on button to add a new webcam. And empty form like below is shown and has to be filled in. Make sure the right values are filled in. All fields with a * are required.

  • Location: Holds the webcam location source. Supported sources are: RPICam, V4L device, Remote URL
    • RPICam: rpicam
    • V4L: /dev/videoX
    • Remote source: http://source.web.cam/stream
  • Name: Holds the webcam name.
  • Picture rotation: Holds the webcam rotation of the image.
  • Preview: Shows the webcam preview image.
System environment screenshot

Lights

The light system always works on time. You can use the weather sun rise and sun set as time values or fixed time values. When selecting weather it can happen that the lights will be on for to long or to short. Use the desired values for the maximum and minimum hours. And the hours shift will shift the hours for on and off by the amount of hours entered here.

All fields with a * are required.















  • Status: No translation available for 'environment_field_lights_enable'
  • Light mode: No translation available for 'environment_field_lights_mode'
  • Lights on: No translation available for 'environment_field_lights_on'
  • Lights off: No translation available for 'environment_field_lights_off'
  • Maximum lights hours: Enter the maximum amount of time in hours. When the time between on and off is more then this maximum, the on and off time will be shifted more to each other.
  • Minimum light hours: Enter the minimum amount of time in hours. When the time between on and off is less then this amount of hours, the on and off time will be widened until the minimum amount of hours entered here.
  • Hours shift: Enter the amount of hours that the power on and off times should shift. Is only needed when running in the 'Weather' mode. Enter a positive number for adding hours to the start time. Use negative numbers for subtracting from the start time.
  • Power switches: No translation available for 'environment_field_lights_power_switches'

Sprayer

The sprayer is only working in sensor mode. This means it needs to have at least one humidity sensor and one switch to activate a spray system. When multiple humidity sensors are used, the averages of the minimum, maximum and current values are used.

The sprayer will not operate when a door is open.

All fields with a * are required.













  • Status: No translation available for 'environment_field_sprayer_enable'
  • Enabled when lights are off: No translation available for 'environment_field_sprayer_enable_during_night'
  • Sprayer mode: No translation available for 'environment_field_sprayer_mode'
  • Sprayer wait timeout (seconds): No translation available for 'environment_field_sprayer_delay'
  • Spray duration (seconds): No translation available for 'environment_field_sprayer_duration'
  • Power switches: No translation available for 'environment_field_sprayer_power_switches'
  • Humidity sensors: No translation available for 'environment_field_sprayer_humidity_sensors'

Heater

When the heater is used in sensor mode the system will toggle the switches based on the alarms of the sensors. When the temperature is to cold it will toggle on the switches. Until the temperature gets above the maximum value the switch stays on. When the maximum temperature is reached, the switches will be toggled off and stay out until the temperature hits the minimum value.

When used in Timer or Weather mode, the switches will be toggled on and of on the selected times regardless of the temperature.

But when there are sensors used in combination with Timer or Weather mode the switches will toggle on and off when there is an alarm based on the sensors and within the selected time frame.

All fields with a * are required.













  • Status: No translation available for 'environment_field_heater_enable'
  • Enabled when lights are on: No translation available for 'environment_field_heater_enable_during_day'
  • Heater mode: No translation available for 'environment_field_heater_mode'
  • Heater on: No translation available for 'environment_field_heater_on'
  • Heater off: No translation available for 'environment_field_heater_off'
  • Power switches: No translation available for 'environment_field_sprayer_power_switches'
  • Temperature sensors: No translation available for 'environment_field_heater_temperature_sensors'

Cooling

When the cooler is used in sensor mode the system will toggle the switches based on the alarms of the sensors. When the temperature is to hot it will toggle on the switches. Until the temperature drops below the minimum value the switch stays on. When the minimum temperature is reached, the switches will be toggled off and stay out until the temperature hits the maximum value.

When used in Timer or Weather mode, the switches will be toggled on and of on the selected times regardless of the temperature.

But when there are sensors used in combination with Timer or Weather mode the switches will toggle on and off when there is an alarm based on the sensors and within the selected time frame.

All fields with a * are required.













  • Status: No translation available for 'environment_field_cooler_enable'
  • Enabled when lights are on: No translation available for 'environment_field_cooler_enable_during_night'
  • Heater mode: No translation available for 'environment_field_cooler_mode'
  • Heater on: No translation available for 'environment_field_cooler_on'
  • Heater off: No translation available for 'environment_field_cooler_off'
  • Power switches: No translation available for 'environment_field_cooler_power_switches'
  • Temperature sensors: No translation available for 'environment_field_cooler_temperature_sensors'