Contemporary Control Systems BASview User Manual

A Small But Powerful Building Management System

User Manual

Version 1.42d

# TD110500-0MC

Table of Contents ....................................................................................................................................................... 2

Introduction ............................................................................................................................................................... 4

Getting Started .......................................................................................................................................................... 5

Advanced Colours .................................................................................................................................................... 12

Alarm Wizard ........................................................................................................................................................... 13

Alarm Log ................................................................................................................................................................. 13

Alarm Editor ............................................................................................................................................................. 14

Analog Point Wizard ................................................................................................................................................ 16

BACnet MS/TP Device .............................................................................................................................................. 17

BACnet MS/TP Driver ............................................................................................................................................... 18

BACnet Point Addressing ......................................................................................................................................... 19

BACnet/IP Device ..................................................................................................................................................... 21

BACnet/IP Driver ...................................................................................................................................................... 22

Calculations ............................................................................................................................................................. 23

Calculation Wizard ................................................................................................................................................... 23

Calculation Editor .................................................................................................................................................... 24

Control Points .......................................................................................................................................................... 25

Date/Time Point Wizard .......................................................................................................................................... 26

Devices ..................................................................................................................................................................... 26

Device Tree .............................................................................................................................................................. 27

Digital Point Wizard ................................................................................................................................................. 28

Drivers ...................................................................................................................................................................... 29

ESI Point Addressing ................................................................................................................................................ 29

Folders ..................................................................................................................................................................... 30

Graphics Wizard....................................................................................................................................................... 31

Graphic Components ............................................................................................................................................... 32

Graphic Screen Editing ............................................................................................................................................. 36

Graphic Screen Viewing ........................................................................................................................................... 37

Groups Database ..................................................................................................................................................... 38

HTML Help ............................................................................................................................................................... 39

Links ......................................................................................................................................................................... 41

Login Message ......................................................................................................................................................... 41

LonWorks Device ..................................................................................................................................................... 42

TD110500-0MC

LonWorks Driver ...................................................................................................................................................... 43

LonWorks Point Addressing ..................................................................................................................................... 44

Modbus Point Addressing ........................................................................................................................................ 48

Modbus Serial Device ............................................................................................................................................... 49

Modbus Serial Driver ............................................................................................................................................... 50

Modbus/TCP Device ................................................................................................................................................. 51

Modbus/TCP Driver .................................................................................................................................................. 52

Multi-State Point Wizard ......................................................................................................................................... 53

Network Settings ..................................................................................................................................................... 54

Node Manager ......................................................................................................................................................... 56

Point Addressing ...................................................................................................................................................... 57

Programs ................................................................................................................................................................. 57

Program Wizard ....................................................................................................................................................... 57

Program Editor ........................................................................................................................................................ 57

Programming Reference .......................................................................................................................................... 59

Revision History ....................................................................................................................................................... 65

Runtime Wizard ....................................................................................................................................................... 65

Runtime Editor ......................................................................................................................................................... 66

Runtime Report ........................................................................................................................................................ 67

Schedules ................................................................................................................................................................. 68

Schedule Wizard ...................................................................................................................................................... 70

Set Date/Time .......................................................................................................................................................... 70

Site Settings ............................................................................................................................................................. 71

String Point Wizard .................................................................................................................................................. 71

System Status........................................................................................................................................................... 72

Templates ................................................................................................................................................................ 72

Toolbar ..................................................................................................................................................................... 73

Trends ...................................................................................................................................................................... 74

Trends Wizard .......................................................................................................................................................... 75

Users Database ........................................................................................................................................................ 76

TD110500-0MC

Introduction

Contemporary Controls BASview is a stand-alone, embedded, web-based graphical interface for building automation and process/access control systems. Multiple protocols are supported including LonWorks, Modbus/485, Modbus/TCP, BACnet/IP and BACnet MS/TP.

Some of the features include animated graphic screens, scheduling, historical trending, runtime accumulation and alarm monitoring. All of these features are supported even with devices that do not natively support them. BASview will automatically toggle outputs and change setpoints on schedule, collect runtime and trend data, and monitor alarm conditions.

The BASview uses Flash memory for internal storage. It contains no hard disk or other moving parts. The Linux operating system is used for enhanced security and stability. The unit is totally self-contained. All set up and user interactions are performed via a web browser. No dedicated PC or external applications are required.

The user interface utilizes Adobe Flash to allow for advanced graphical features, platform-independence and drag and drop setup. No knowledge of HTML, XML, Flash, JavaScript or any other programming language is required to set up or use BASview (unless Program objects are used for control logic).

Features

 Animated graphics  Internally maintained schedules  Trend collection, display and export  Runtime accumulation with email notification  Alarm condition monitoring with email notification  Calculated point values (average, min, max, etc.)  Database of up to 100 users and 100 user groups  Multiple simultaneous users  Activity log for tracking important user actions  Template system for quickly cloning points, graphics, devices or entire networks  Support for OEM templates that include all points, graphics, schedules, etc. for any device  Flexible point addressing system allows access to most proprietary structures, bit fields and objects  Calculations may be performed on data points when read or written (e.g. Deg. F to Deg. C or scaling)  Support for custom OEM plug-in software device modules for more complex data access  Support for up to 2,000 tree nodes which can be any combination of points, graphics, trends, etc.

There are no hard limits on individual nodes. (Practical limits on control points will depend on communication speed and network bandwidth used.)

Supported Protocols:

 LonWorks  Modbus RTU/485  Modbus/TCP  BACnet/IP  BACnet MS/TP

TD110500-0MC

Getting Started

Figure 1 — Login Screen

Login Screen

By default, BASview uses a flash Interface — providing a rich user experience. Its login appears below.

 The default IP address of the BASview is 192.168.92.68, but yours may be set to a different address.  You will be prompted to login.  The default authentication strings are ...

o Username: admin o Password: pass

 At the top of the login dialog you can find ...

o Firmware Version Number o BASview Serial Number

 At the bottom of the login dialog is an option to login with the Mobile Interface which uses HTML

and no flash — otherwise, you must proceed with the normal flash Interface.

BASview Screen

 After your first login, you see the BASview webpage — which defaults to the Info screen below.

The three basic screen elements are the Toolbar, Device Tree and the Working Area.

 The Device Tree that you will build always starts with the Site icon.

Figure 2 — Main Screen

TD110500-0MC

Toolbar

Figure 3 — Admin Options

Figure 4 — Accessing Help Screens

The 10 icons in the Toolbar are:

 Home  Site Info  Logout  Users  User Groups  Admin  Alarms  Runtime  Tree View  Help

The Admin icon (the wrench symbol) is a drop-down where you can see logs and status, configure the IP address, reboot the unit and update the firmware. If running 1.42d or later, any update file containing ".Firmware" somewhere in name can be used for the update.

Help Screens

 When you hover over any button,

you see a popup that explains the button function.

 Pressing on the Toolbar displays the help system and opens a context-appropriate screen.

Figure 5 — Help Screens

TD110500-0MC

IP Address Setting

Figure 6 — Broadcast Setting in BACnet Systems

Figure 7 — Adding a Driver

 Enter your IP address settings — then reboot.  In BACnet systems the Broadcast setting must match the broadcast address in your subnet.

Add a Driver

 To communicate with devices, you must load a driver.  Right-click the Site icon in the Device Tree and select New Driver.  In the popup, select the appropriate driver and press Ok.

TD110500-0MC

Driver Configuration

Figure 8 — Driver Configuration

Figure 9 — Adding a Device

 Enter in your driver configuration.  For BACnet use a system-wide unique Device ID.  The standard BACnet port number is 47808.  Enter a label for the driver and press Finish.

Add a Device to a Driver

 In the Device Tree, right-click a driver and select New Device.  A Device Wizard appears so you can enter device parameters or, with BACnet, discover a device.  For BACnet, as shown below, press the Scan button to discover BACnet devices.  Press Finish on the next popup window.

TD110500-0MC

BACnet Device Scan

 If the NetworkID is 0, the device is on the same network as the BASview; otherwise it is

accessed through a router.

 For each device you want in your Device Tree, select it, add a label then press the Add button.

Figure 10 — BACnet Device Scan

TD110500-0MC

Add BACnet Points

Figure 11 — BACnet Point Wizard

Figure 12 — BACnet Point Scan

 Refresh the Device Tree to see your new BACnet devices.  Right-click a device and select New Point. A Point Wizard appears  Enter a point or discover points.  Press Scan to discover points.  Press Finish on next window.

 Select points of interest and press the Add button.  You can select multiple points.  Points will disappear from the list as they are added.

TD110500-0MC

Points To Be Written

Figure 13 — Allow a Point to Be Changed

Figure 14 — Manually Modifying a Point

 All points are read-only by default.  To modify a point you must mark it writeable.  Right-click the point and select Properties.  When the Point Wizard appears, press Next.  Press the Modifications tab (if displayed), check the “Allow this point to be manually changed by

users” box and press Finish.

Manually Writing/Reading Points

 Left-click a writeable point in the Device Tree. A Point Information/Control popup appears.  Modify its value and press the Apply button.  This can be used to simply view the status of a point.  The lock symbol can be used to view/modify the BACnet priorities for the point.

User Sessions Automatically Terminate after No Activity

A user session will automatically close if no user activity has occurred for one hour. Many BASview functions entail edit screens. Please realise that any edits you are performing are volatile until saved. Therefore, unsaved edits will be lost if not saved before the user session terminates.

TD110500-0MC

Advanced Colours

Advanced colours allow the colour and transparency of a component to change based on the value of the attached point. The component may also be set to flash to help draw attention to it.

Use Advanced Colours

This option must be selected to enable advanced colours.

Conditions

The list of conditions determines what the current settings for the component will be. Each condition will be tested, from the top of the list to the bottom of the list. The last condition that is true determines the settings. The default settings are used if no other conditions are true.

Each condition contains the following settings:

Use Custom Settings

This option must be selected, otherwise the condition is ignored.

Colour

The colour to use if this condition is true.

Alpha

This is the "Alpha" or transparency to use if the condition is true. Zero is fully transparent, 1 is fully opaque.

Flash

If selected, the component will flash if this condition is true.

Value

The value to test for this condition. The point value must be greater than (not less than or equal to) this value for the condition to be considered true.

Example — To change the colour of a label showing the state of an air filter:

Default - green (normal) Point value is greater than 0 - red and flashing (A digital value equates to 0 when OFF, 1 when ON.)

Example — To change the colour of text displaying a temperature to blue (too cold), green

(in range) or red (too hot):

Default - blue and flashing Point value is greater than 65 - green Point value is greater than 75 - red and flashing

Don't forget to save components with complicated settings as a template so they may be easily

recreated later.

TD110500-0MC

Alarm Wizard

An Alarm is invoked by right-clicking a device driver in the Device Tree. It monitors a set of user-defined conditions and sends email notifications when the conditions are met. Once an alarm has been added to the tree, left-click it to edit the conditions. See Alarm Editor for more information. Alarms are also stored for later viewing using the Alarm Log.

Settings Tab

Label

Label is the name of the item as displayed in the Device Tree.

All items in the Device Tree are sorted alphabetically by label. Folders can be used to organize items.

Description

Description is optional text that describes the item. It can be any descriptive text or be left blank.

Group Settings Tab

These determine which user groups can see this item in the tree. Unchecking the default “Allow Everyone”

enables selecting individual groups. If a group cannot see an item, items under it are also unseen. There are “Check All” and “Uncheck All” buttons in the upper-right corner to make major changes easier.

Advanced Tab

Name

Name is used for advanced features. If left blank, it will be assigned automatically. It is recommended that the default value not be changed. It can be up to 48 characters. Only A–Z, a–z, 0–9, period (.) and underscore (_) are allowed. Names are case sensitive.

Node ID

This internal reference ID of this node is read-only — and rarely needed by the user.

Alarm Log

Click this Toolbar button to view past alarm messages. Both active and optional clear messages are stored in the log. Several options are available to limit the messages seen:

 Filter — Type a word or phrase. Press “Enter” to activate the filter.  Month Selection — Select a month from the list to display only messages from that month.  All/Active/Clear — Choose to display all messages, only activation messages or only clear messages.  Refresh Button — Refresh the list of alarms from the server.  Reset Button — Reset all of the above search options.

Additionally, the “Time”, “Type” and “Message” headers may be clicked to sort the list by that field. Clicking the header a second time will reverse the sort order. Clicking the alarm message itself will display the Alarm Editor window if the users’ access permits it.

TD110500-0MC

Alarm Editor

Left-click an alarm icon in the tree to edit alarm conditions, messages and email recipients.

Status Tab

The status tab contains:

 The current active/inactive status of the alarm.  The date and time of the last change of state of the alarm.  The last message generated by the alarm.  A refresh button to update the status on the screen.  A disable selection to completely disable the alarm.

Conditions Tab

This is where the alarm conditions are specified. There are sub-tabs for active conditions and clear conditions. For backward compatibility, the logic used

for alarms is different depending on if clear conditions are present: If clear conditions are not present (old-style alarms) the original logic still applies:

 Alarm is active if active conditions are true for x minutes (x specified on active tab).  Alarm is inactive if active conditions are false for the same x minutes (x specified on active tab).

If clear conditions are present:

 Alarm is active if the active conditions are true for x minutes (x specified on the active tab).  Alarm is cleared if the active conditions are not true, and the clear conditions are true for x

minutes (x specified on the clear tab).

 Active conditions take precedence over clear conditions. If both are true, the alarm is active.  If neither active nor clear conditions are true, the alarm remains in its current state.

Example:

Conditions: Active if temp > 78 Clear if temp < 74 Behaviour: If temp goes up to 79, the alarm becomes active. If temp goes down to 75, the alarm remains active. If temp goes down to 73, the alarm is cleared.

There are two modes for the conditions:

 All conditions are true — The alarm will be active or cleared if every condition evaluates to true.  Any condition is true — The alarm will be active or cleared if any condition evaluates to true.

To be considered active or cleared, the condition(s) must be true for at least the number of minutes specified. If any/all of the conditions become false for the same number of minutes, the alarm will become active or cleared.

Up to six conditions may be entered. Click the "+" or "X" buttons to add or delete conditions. Each condition contains the following fields:

 Point — Drag a point from the device tree and drop it here. Its value is what will be tested.  Comparison — This is the comparison that will be performed.  Comparison Value — This is what the point value will be compared with.

TD110500-0MC

The comparison value can be any one of the following:

 Numerical Value — Type any valid numerical value.  Another Point — Drag a point from the tree to compare with its current value. For digital and

multi-state points, click the drop-down list to display the valid values.

 Value Range — For the in/out of range comparisons, type the low value and the high value

separated by a comma (e.g.: 50,100). For the is/is not in list comparisons, type a list of values separated by commas (e.g. 1,2,3,5,85,1000).

Floating point values (e.g. 72.5) are valid, but will not always give the desired results. What displays on the screen as 72.5 may actually be 72.499854 because of the way computers round numbers. Testing a point value for equality with 72.5 will most likely always be false. Use "greater than", "less than" or a value range instead.

Messages Tab

Active Message

This is the message that is saved to the database and emailed when the alarm becomes active. The following codes may be embedded in both the active or clear message:

 @Ax = point address  @Dx = point description  @Hx = point high limit  @Nx = point name  @Lx = point label  @Sx = point status  @Ox = point low limit  @Ux = point units

(x = condition number)

Clear Message

This optional message is saved to the database and emailed when the alarm is cleared (becomes inactive). Both messages may contain the following codes to embed information within the text:

 @Vx — The value of the point (the point on the left-side)  @Cx — The comparison value (the point or value on the right side)

"x" in both codes is the condition number (1–6)

Example:

"Temperature is too high (@V1)." will be recorded as "Temperature is too high (77.4)".

Example:

"Temperature (@V1) is greater than setpoint (@C1)." will be recorded as "Temperature (76.3) is greater than setpoint (74.5)."

"@" codes in the active message refer to the points and values on the "Active" tab. "@" codes in the clear message refer to the points and values on the "Clear" tab.

For old-style alarms with no clear conditions, all @ codes refer to the points and values on the "Active" tab.

Notifications Tab

Email to Groups

Select the list of user groups that should receive this alarms messages. Every person in the group that has an email address in the user database will receive both active and clear messages.

Additional Email Addresses

Any additional email addresses that should receive the messages may be typed here.

TD110500-0MC

Analog Point Wizard

Below are the settings for points with a point type of analog.

Analog Settings Tab

Engineering Units

The engineering units can be set to specify the units of measure or physical characteristics of the analog value. Common engineering units would include Degrees F, Amps and Volts.

Type any text or select from a list of common units by clicking the down arrow to the right of the edit area.

Precision

Precision controls how the value is displayed. A value of 2 displays 2 digits to the right of the decimal point (74.25). A value of 0 will truncate the decimal value and not display a decimal point at all (74).

Increment

Increment controls how the value can be changed by the user. It should normally be set to the increment supported by the point in the device. A value of 1 allows the value to be changed in steps of 1 (74, 75, 76, etc.). A value of 0.1 allows steps of 0.1 (74.1, 74.2, 74.3, etc.)

For user modification, check "Allow this point to be manually changed by users" on the "Modifications" tab.

Modifications Tab

The modification settings are used to determine if the value of this point may be modified by users, and how to handle or restrict the allowed values.

Allow this point to be manually changed by users

This checkbox must be selected for the point to be modifiable by the user.

Low Modify Limit

This is the lowest value to which the user will be allowed to modify the value. If left blank, any value valid for the data type of the point will be allowed.

High Modify Limit

This is the highest value to which the user will be allowed to modify the value. If left blank, any value valid for the data type of the point will be allowed.

In/Out Calculations

In and out calculations are optionally used to convert raw point values from a device in to more useable values. For example, it is fairly common for Modbus devices to represent a temperature as the actual temperature *10.

In this case, 75.5 degrees would be read from the device as 755. To this value treated properly, an In Calculation of @/10 would be used. The @ sign specifies where in

the calculation to insert the raw value from the device. So in this example, it would calculate 755 / 10 for a result of 75.5. This calculated value is then used

everywhere else in the system instead of the 755, including on graphics, trends and alarms. If the point is modifiable by the user, the Out Calculation should be the opposite of the In Calculation.

In this case it would be @*10. If the user then changes the value of the point to 76.2, the calculation 76.2 *10 would be executed and the value 762 sent to the device.

Several common calculation presets, including F to C and C to F conversions, are available by clicking the down arrow to the right of the edit area.

Two points with the same address can have different calculations (such as a temperature in both F and C.

TD110500-0MC