Baseline's Central Control General Spec · Web viewTest devices and zones . ... The company admin...

Central Control Specification

Table of Contents

PART 1 - Application Framework..............................................................3

1.1 Application Framework Description...............................................................3

1.2 Application Framework Access.......................................................................3

1.3 Application Framework Compatibility...........................................................3

1.4 Application Framework Functionality...........................................................3

PART 2 - Irrigation Central Control App..................................................4

2.1 Irrigation Central Control App Description..................................................4

2.2 Irrigation Central Control Subscriptions.......................................................4

2.3 Irrigation Central Control Functionality.......................................................4

2.4 Virtual Irrigation Controller Access...............................................................6

2.5 Weather-based Watering.................................................................................7

2.6 Remote Control of the Irrigation Controller..................................................7

PART 3 - Hydraulic System Central Control App....................................8

3.1 Hydraulic System Central Control App Description....................................8

3.2 Hydraulic System Central Control App Functionality.................................8

PART 4 - Shared Flow Controller App.....................................................11

4.1 Shared Flow Controller App Description.....................................................11

4.2 Shared Flow Controller App Functionality..................................................11

PART 5 - Admin Tools...............................................................................12

5.1 Admin Tools Functionality.............................................................................12Baseline Support: 866-294-5847 1 www.baselinesystems.com

PART 6 - Security.......................................................................................13

6.1 Security Architecture......................................................................................13

Baseline Support: 866-294-5847 2 www.baselinesystems.com

Irrigation controllers shall have the following central control specifications and capabilities:

PART 1 - Application Framework

1.1 Application Framework Description

A. The cloud-based central control application framework shall provide access to central control applications from any location over an Internet connection

1.2 Application Framework Access

A. End users shall sign into their application framework account, and then they have access to the applications that they have subscribed to.

1. Irrigation Central Control App

a. Weather-based Watering

b. Virtual Irrigation Controller Access

c. Remote Control of the Irrigation Controller

2. Hydraulic System Central Control App

3. Shared Flow Controller App

B. End users shall log into application framework using a secure password and username.

1. The password must have at least eight characters that include:

a. At least one lower case letter

b. At least one upper case letter

c. At least one number

d. At least one special character

1.3 Application Framework Compatibility

A. The end user shall be able to access the application framework via a secure WebSocket over an Internet connection with the most current version of the following web browsers:

1. Mozilla Firefox

2. Google Chrome


3. Safari

1.4 Application Framework Functionality

A. The end user shall be able to select a company associated with a user.

B. The end user shall be able to see and select applications specific to a user’s application framework account.

C. The end user shall be able to see all messages populated by the user’s applications.

PART 2 - Irrigation Central Control App

2.1 Irrigation Central Control App Description

A. The cloud-based irrigation central control app shall give the user the ability to communicate with and control irrigation controllers from any location over an Internet connection.

2.2 Irrigation Central Control Subscriptions

A. Access to the irrigation central control app shall be by yearly subscription.

B. The subscription shall be associated with a controller and all controllers belonging to a company shall be set to the same subscription level.

C. The subscription shall determine what irrigation central control software and remote control features a user has access to.

1. The lowest access level shall be available at no charge for one user and one irrigation controller.

a. The lowest access level users shall have the ability to use Virtual Irrigation Controller Access and to manually turn zones on and off from any web-enabled mobile device.

2. The highest access level users shall have a yearly subscription fee and shall allow an unlimited number of users access to one irrigation controller.

a. At the highest access level, users shall have access to all irrigation central control software functions including weather-based watering.

b. At the highest access level, users shall have the ability to turn zones on and off, start and stop programs, initiate rain delays, perform valve diagnostics,


geo-locate all devices, and view real-time soil moisture and flow sensor readings from any web-enabled mobile device.

2.3 Irrigation Central Control Functionality

A. Irrigation Central Control shall include the following end user features:

1. Three levels of user access

a. Company Admin

b. Site Manager

c. Operator

2. A map-based interface that provides the following functionality:

a. Check the status of any controller, device, or zone

b. Find the location of your controllers, devices, and zones

c. Start/stop a zone

d. Test devices and zones

e. Display a graph for devices and zones

f. Set a rain delay

g. Zoom in/out and move the map view

h. Switch between a street map view, satellite view, and terrain view

i. Set geo-location for any controller, zone, or other device

3. A quick view of the status of all zones with color-coded statuses and descriptions, including:

a. Real-time color-coded status for all zones and programs

b. Complete list of current alarms and messages

c. Ability to delete/clear any current alarm or message

d. Current status and value for all sensing devices

4. Add and fully configure all zones and programs, including:

a. Enable/disable zones

b. Change zone type


c. Assign a program

d. Adjust water time

e. Adjust cycle and soak times

f. Program soil moisture sensors

g. Program master valves

h. Program flow sensors

i. Configure mainlines

j. Set all program schedules

k. Set all program configurations including per-program configuration of:

1) Program stop/start conditions

2) Smart watering based on soil moisture sensors

3) Water sources

4) Master valves

5) Water days

6) Water windows

5. Add textual descriptions for all controllers, zones, sensors, flow devices, master valves, points of connection, control points, and mainlines.

a. All descriptions that are set through Irrigation Central Control shall be saved and displayed in the controller.

b. These descriptions shall be visible in all appropriate displays and reports, including on the front panel of controllers.

6. Perform the following manual operations:

a. Learn flow

b. Calibrate soil moisture sensors

c. Run zones and programs

d. Test devices

7. View soil moisture and run-time graphs for any/all zones and soil moisture sensors


8. Schedule rain delays and pause events

9. Clear rain delays and pause conditions

10. Update controller firmware

B. Irrigation Central Control shall have a company administrator’s interface that provides the following functionality:

1. Add/edit/delete users, sites, and controllers

2. Configure users’ access levels

3. Assign users to controllers

4. Maintain company details

5. Configure alert, alarm, and report subscriptions for all users

6. Change or reset all company users’ passwords

C. Irrigation Central Control shall have a user administrator’s interface that provides the following functionality:

1. Edit user preferences

2. Change alert, alarm, and report subscriptions

3. View assigned controllers

4. Change password

D. Irrigation Central Control shall generate the following alerts/reports as an email or in PDF format for any date range:

1. Water Usage

2. Zones Activity

3. Zone Run Time

4. Moisture Levels

5. Flow Meter Totals

E. Irrigation Central Control shall be able to relay all alerts/alarms generated by the controller.

F. Irrigation Central Control shall enable users to subscribe to alerts, alarms, and reports.

1. Users shall be able to have alerts, alarms, and reports sent by text message, email, or both.

2. Users shall be able to subscribe on a priority basis.

3. Users shall be able to configure what time(s) of day the alerts are received.

4. The company admin shall be able to configure subscriptions for all users.Baseline Support: 866-294-5847 7 www.baselinesystems.com

G. Irrigation Central Control shall make alerts, alarms, and reports available on demand.

H. Irrigation Central Control shall include the following weather-based watering features:

1. Connect a weather station and assign it to a controller

2. Configure hydrozone properties

3. Enable zones on the irrigation controller to use weather-based watering

4. Configure programs on the irrigation controller to use weather-based watering

5. Check the calculated ETo amount in Quick View

6. Display weather station information from the map

2.4 Virtual Irrigation Controller Access

A. Virtual Irrigation Controller Access shall be available through the Irrigation Central Control app.

B. Virtual Irrigation Controller Access shall provide a virtual view of the irrigation controller and shall enable the user to operate the controller just as if he/she were standing in front of it.

1. Virtual Irrigation Controller Access shall match the controller’s display screen in real-time or near real-time as supported by the controller’s connection speed.

2. Virtual Irrigation Controller Access shall support all buttons and/or dial positions available at the controller.

3. Virtual Irrigation Controller Access shall honor controller PIN security as if the user were at the controller.

4. Multiple simultaneous Virtual Irrigation Controller Access users to the same controller shall be supported.

5. Virtual Irrigation Controller Access shall support access to any controller when authorized by the customer for customer support purposes.

2.5 Weather-based Watering

A. Weather-based Watering shall be available with the highest access level of the Irrigation Central Control app.

1. Weather-based Watering shall enable the user to connect a weather station in the area (available in Weather Underground's weather station network) to Irrigation Central Control.

2. Weather-based Watering shall enable the user to assign a connected weather station to an irrigation controller.


3. Weather-based Watering shall apply the real-time weather data from the weather station and the configurable zone properties to a standardized evapotranspiration (ET) equation.

4. Weather-based Watering shall calculate an estimated loss of moisture from the root zone, and then the irrigation controller shall use the calculated value to adjust the runtime in order to apply enough water to replace that lost moisture.

5. With the highest access level of the Irrigation Central Control app, users shall be able to configure irrigation controller programs to use Weather-based Watering.

6. With the highest access level of the Irrigation Central Control app, users shall be able to configure irrigation controller zones to use Weather-based Watering.

2.6 Remote Control of the Irrigation Controller

A. Remote Control shall allow any web-enabled mobile phone or other mobile device to function as a remote control.

1. Users shall have the ability to turn zones on and off, start and stop programs, initiate rain delays, perform valve diagnostics, geo-locate all devices, and view real-time soil moisture and flow sensor readings from any web-enabled mobile device.

PART 3 - Hydraulic System Central Control App

3.1 Hydraulic System Central Control App Description

A. The cloud-based hydraulic system central control app shall give the user the ability to view and manage their irrigation hydraulic system from any location over an Internet connection.

B. Hydraulic System Central Control App is compatible with irrigation controllers and shared flow groups that are managed by a shared flow controller.

3.2 Hydraulic System Central Control App Functionality

A. The end user shall have the ability to see all water sources, control points, mainlines, and zones in an irrigation system.

B. The end user shall have the ability to zoom in or out in the diagram using a mouse scroll for desktop users or a finger pinch for mobile device users.


C. Hydraulic System Central Control App shall display real-time, color-coded status details for the following hydraulic system components:

1. Water sources

a. Whether the water source is watering and which downstream control point or control points it is connected to

b. The water source status, such as watering, done, or waiting

c. The controller the water source is assigned to

d. The shared flow controller the water source is assigned to if applicable

e. The description of the water source

2. Control points

a. Whether the control point is watering and which downstream mainline or mainlines it is connected to

b. The control point status, such as watering, learning flow, or done

c. The controller that the control point is assigned to

d. The shared flow controller that the control point is assigned to if applicable

e. The description of the control point

f. Real-time values for:

1) Flow sensors measured in GPM

2) Pressure sensors measured in PSI

g. Real-time status for:

1) Master valves indicated by an open or closed value

2) Pumps indicated by on or off value

3. Mainlines

a. Whether the mainline is watering and which downstream control points, mainlines, or zones the mainline is assigned to

b. The mainline status, such as watering, done, or waiting

c. The controller that the mainline is assigned to

d. The shared flow controller that the mainline is assigned to if applicableBaseline Support: 866-294-5847 10 www.baselinesystems.com

e. The description of the mainline

4. Zones

a. Whether the zone is watering and which mainline the zone is assigned to.

b. The zone status, such as watering, learning flow, or done

D. Hydraulic System Central Control App shall display a slide-out pane when a user clicks on the box for the following hydraulic system components:

1. Water sources slide-out pane shall include:

a. Messages for that water source

b. A graph showing the monthly budget and the water used for that period

c. The description of the water source

d. The status of the water source

e. The controller the water sources is assigned to

f. Empty conditions that have been defined for the water source

g. Access to the water source details, which includes the ability to edit:

1) The description of the water source

2) Whether the water source is enabled or disabled

3) The water source priority level

4) The monthly water budget

5) Whether the water source will shut down if it meets or exceeds the water budget

6) Empty conditions for the water source

2. The control point slide-out pane shall include:

a. Messages for the control point

b. A graph showing how much water was used by that control point

1) The graph can show usage for specific time frames

c. A graph showing the flow rates for that control point

1) The graph can show flow rates for specific time frames


d. A graph showing the PSI values for that control point

1) The graph can show flow rates for specific time frames

e. The description of the control point

f. The status of the control point

g. The controller the control point is assigned to

h. The devices assigned to that control point, which can include:

1) Flow sensor

2) Pressure sensor

3) Master valve

4) Pump

i. The status for each device assigned to that control point.

j. Real-time values for:

1) Flow sensors measured in GPM

2) Pressure sensors measured in PSI

k. Real-time status for:

1) Master valves indicated by an open or closed value

2) Pumps indicated by on or off value

l. Access to the control point details which includes the ability to edit/define:

1) The control point description

2) Whether the control point is enabled or disabled

3) Enable and define the control point group for that control point which allows the shared flow controller to activate the control point with the smallest GPM in that group to supply water for downstream zones based on their requested GPM

4) The target flow of the control point

5) High flow limits

6) Whether or not to shut down if the high flow limit is exceeded


7) Unscheduled flow limits

8) Whether or not to shut down if the unscheduled flow limit is exceeded

9) High pressure limits

10) Whether or not to shut down if the high pressure limit is exceeded

11) Low pressure limits

12) Whether or not to shut down if the low pressure limit is exceeded

m. The ability to edit devices assigned to that control point, including:

1) Edit a flow sensor description

2) Enable or disable a flow sensor

3) Define the K-value for the flow sensor

4) Edit a master valve description

5) Enable or disable a master valve

6) Define whether the master valve is normally open

3. The mainline slide-out pane shall include:

a. Messages for that mainline

b. The mainline description

c. The status of that mainline

d. The controller the mainline is assigned to

e. Access to the mainline details, which includes the ability to edit/define:

1) The mainline description

2) Whether the mainline is enabled or disabled

3) The design flow value for that mainline

4) Either time or pressure as the type of flow stabilization management for that mainline

5) The flow stabilization value as either a unit of time or a measure of psi


6) Whether the mainline is managed by flow

7) The flow variance percentage

8) Whether or not to shut down if the flow variance percentage is exceeded

9) Either time or pressure as the type of mainline delay option for that mainline

10) The delay before the first zone either by time or psi

11) The delay between zones either by time or psi

12) The delay after the last zone either by time or psi

13) The number of zones to run between delays

14) Whether or not to enable or disable advanced flow variance

15) Define the values for each advanced flow variance range

16) Define whether or not to shut down if a flow variance is exceeded

4. The zone slide-out pane shall include:

a. Messages for that zone

b. The ability to see and edit the zone description

c. The ability to enable or disable the zone

d. The ability to see and edit the design flow for that zone

e. The mainline the zone is assigned to

PART 4 - Shared Flow Controller App

4.1 Shared Flow Controller App Description

A. The cloud-based shared flow central control app shall give the user the ability to view and manage their shared flow controller from any location over an Internet connection.

4.2 Shared Flow Controller App Functionality

A. The end user shall have the ability to see all shared flow controllers on a site.


B. The end user shall select a shared flow controller to display a slide-out pane, which gives the user the ability to:

1. See the shared flow controller general information, which includes the description as well as the MAC address and the IP Address which both automatically populate.

a. The user shall be able to view the controllers assigned to that shared flow controller.

b. The user shall be able to select a drop down menu for that controller to see the status of that controller’s water sources, control points, and mainlines.

2. See all water source-to-control point assignments, add a new assignment, and edit the existing assignments.

3. Select a water source to display a slide-out pane which includes the ability to see and edit:

a. The description of the water source

b. Whether the water source is enabled or disabled

c. The water source priority level

d. The monthly water budget

e. Whether the water source will shut down if it meets or exceeds the water budget

f. Empty conditions for the water source

4. See all control point-to-mainline assignments, add a new assignment, and edit the existing assignments.

5. Select a control point to display a slide-out pane which includes the ability to see and edit:

a. The control point description

b. Whether the control point is enabled or disabled

c. Enable and define the control point group for that control point which allows the shared flow controller to activate the control point with the smallest GPM in that group to supply water for downstream zones based on their requested GPM

d. The target flow of the control point

e. High flow limits


f. Whether or not to shut down if the high flow limit is exceeded

g. Unscheduled flow limits

h. Whether or not to shut down if the unscheduled flow limit is exceeded

i. High pressure limits

j. Whether or not to shut down if the high pressure limit is exceeded

k. Low pressure limits

l. Whether or not to shut down if the low pressure limit is exceeded

6. See all mainline-to-mainline assignments, add a new assignment, and edit the existing assignments

7. Select a mainline to display a slide-out pane which includes the ability to see and edit:

a. The mainline description

b. Whether the mainline is enabled or disabled

c. Define the design flow value for that mainline

d. Choose either time or pressure as the type of flow stabilization management for that mainline

e. Define the flow stabilization value as either a unit of time or a measure of psi

f. Define whether the mainline is managed by flow

g. Define the flow variance percentage

h. Define whether or not to shut down if the flow variance percentage is exceeded

i. Choose either time or pressure as the type of mainline delay option for that mainline

j. Define the delay before the first zone either by time or psi

k. Define the delay between zones either by time or psi

l. Define the delay after the last zone either by time or psi

m. Define the number of zones to run between delays

n. Whether or not to enable or disable advanced flow variance


1) Define the values for each advanced flow variance range

2) Define whether or not to shut down if a flow variance is exceeded

8. See all mainline-to-control point assignments, add a new assignment, and edit the existing assignments.

PART 5 - Admin Tools

5.1 Admin Tools Functionality

A. The end user shall have the ability to add irrigation controllers and shared flow controllers to the application framework

B. The end user shall have the ability to remove irrigation controllers and shared flow controllers from the application framework

C. The end user shall have the ability to remotely update the general information and geographical settings on irrigation controllers and shared flow controllers that are connected to the application framework

D. The end user shall have the ability to remotely update the firmware on irrigation controllers and shared flow controllers that are connected to the application framework

E. The end user shall have the ability to manage connections between irrigation controllers and shared flow controllers

PART 6 - Security

6.1 Security Architecture

A. All IP traffic between the web-browser client and the server shall be TLS-encrypted.

B. Controllers shall be able to connect to the IP address of a single assigned server (programmable).

C. All data shall be stored on a database server (mySQL) that is not externally accessible other than through activities and reports available through TLS-encrypted web access.

D. The server shall require controllers to be authorized in order to connect to the server.

E. The server shall generate authorization PINs for controllers that are attempting to connect.


1. The authorization PIN shall be displayed on the controller’s front panel.

2. Company admins shall use the authorization PIN to connect controllers to their company.

F. The server shall track and manage controller connections using the unique MAC address of each controller.

REV 5.14.2023


Baseline's Central Control General Spec · Web viewTest devices and zones . ... The company admin...

Documents

Transcript of Baseline's Central Control General Spec · Web viewTest devices and zones . ... The company admin...