Contemporary Control Systems BAScontrol20 User Manual

BASC20

20-point BACnet/IP Sedona Field Controller

BAScontrol20

User Manual

# TD100700-0MB

Trademarks

Contemporary Control Systems, Inc.

Tel:

[phone]

2431 Curtiss Street

Fax:

[phone]

Downers Grove, Illinois 60515 USA

E-mail:

[e-mail]

Web:

http://www.ccontrols.com

Contemporary Controls Ltd

Tel:

[phone]

14 Bow Court

Fax:

[phone]

Fletchworth Gate

E-mail:

[e-mail]

Coventry CV5 6SP UK

Web:

http://www.ccontrols.co.uk

Contemporary Controls (Suzhou) Co. Ltd

Tel:

[phone]

11 Huoju Road

Fax:

[phone]

Industrial Park — Science & Technology

E-mail:

[e-mail]

New District, Suzhou
PR China 215009

Web:

http://www.ccontrols.eu

Contemporary Controls GmbH

Tel:

[phone]

Fuggerstraße 1 B

Fax:

[phone]

D-04158 Leipzig Deutschland

E-mail:

[e-mail]

Web:

http://www.ccontrols.eu

WARNING — This is a Class A product as defined in EN55022.

In a domestic environment this product may cause radio interference

in which case the user may be required to take adequate measures.

BASautomation, Contemporary Controls and CTRLink are registered trademarks of
Contemporary Control Systems, Inc. BACnet is a registered trademark of the
American Society of Heating, Refrigerating and Air-Conditioning Engineers, Inc.
Powered by Sedona Framework is a trademark of Tridium, Inc. Other product
names may be trademarks or registered trademarks of their respective companies.

Copyright

© Copyright 2014, by Contemporary Control Systems, Inc. All rights reserved. No
part of this publication may be reproduced, transmitted, transcribed, stored in a
retrieval system, or translated into any language or computer language, in any form
or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or
otherwise, without the prior written permission of:

Disclaimer

Contemporary Control Systems, Inc. reserves the right to make changes in the
specifications of the product described within this manual at any time without notice
and without obligation of Contemporary Control Systems, Inc. to notify any person of
such revision or change.

TD100700-0MB

2

Contents

1 Introduction ......................................................................................................... 5

1.1 Features and Benefits ................................................................................... 5

1.2 Product Image and Main Features ................................................................ 6

2 Specifications ...................................................................................................... 7

2.1 Universal Input (Channels UI1–UI8) ....................................................... 7

2.2 Binary Inputs (Channels BI1–BI4) ........................................................... 7

2.3 Analog Outputs (Channels AO1–AO4) .................................................... 7

2.4 Binary Outputs (Channels BO1–BO4) ..................................................... 7

2.5 Communications ........................................................................................... 7

2.6 Protocol Compliance ..................................................................................... 7

2.7 Power Requirements ..................................................................................... 8

2.8 General Specifications .................................................................................. 8

2.9 LED Indicators ............................................................................................... 8

2.10 Electromagnetic Compatibility .................................................................... 8

2.11 Field Connections ...................................................................................... 9

2.12 Power Connection ...................................................................................... 9

2.13 Ordering Information .................................................................................. 9

2.14 Dimensional Drawing ............................................................................... 10

2.15 PICS Statement ....................................................................................... 11

3 Installation ......................................................................................................... 12

3.1 Power Supply .............................................................................................. 12

3.2 Cabling Considerations ............................................................................... 13

4 Field Connections ............................................................................................. 14

4.1 Sample BASC20 Wiring Diagram ................................................................ 14

4.2 Universal Input — Configured as Analog Input ........................................... 15

4.3 Universal Input — Configured as Temperature Input .................................. 16

4.4 Universal Input — Configured as a Binary Input ......................................... 17

4.5 Universal Input — Configured as Pulse Input ............................................. 18

4.6 Analog Outputs ........................................................................................... 19

4.7 Binary Outputs ............................................................................................ 20

4.8 Binary Inputs ............................................................................................... 21

4.9 LEDs ........................................................................................................... 22

5 Configuration via a Web Browser ...................................................................... 23

5.1 General Considerations .............................................................................. 23

5.2 Channel Configuration ................................................................................ 32

TD100700-0MB

3

6 Configuration via the Workbench Tool .............................................................. 41

6.1 Introduction to Sedona Framework ............................................................. 41

6.2 Location of Kits, Manifests and Platform ..................................................... 43

6.3 Creating an Application Program ................................................................ 44

6.4 Getting Started with a Workbench Tool ....................................................... 45

6.5 Backing Up and Restoring a Sedona Project .............................................. 47

TD100700-0MB

4

1 Introduction

The BAScontrol20 (BASC20) is a 20-point Powered by Sedona Framework™ field
controller with a direct connection to an Ethernet network. Ideally suited for
structured wiring systems, the BASC20 is BACnet/IP compliant with a B-ASC device
profile. Having a resident Sedona Virtual Machine (SVM), the unit is freely
programmable using tools such as Niagara Workbench or a similar tool. For remote
Ethernet I/O applications, the unit can be configured via web pages.

The BASC20 provides a convenient mix of universal inputs, binary inputs and
outputs as well as analog outputs. Models exist for both triac and relay binary
outputs. The unit is ideal for unitary control or for expanding I/O points in the field via
an Ethernet connection.

The BASC20 utilizes a powerful 32-bit ARM7 processor with 512 kB of flash memory
plus a 16 Mbit serial flash file system for storing configuration data and an
application program. By operating at the BACnet/IP level, the BASC20 can share
the same Ethernet network with supervisory controllers and operator workstations.
The unit can be configured for a fixed IP address or can operate as a DHCP client
receiving its IP address from a DHCP server. A real-time clock with a super-cap
backup allows for creating local schedules.

A 10/100 Mbps Ethernet port supports protocols such as BACnet/IP, Sedona Sox,
HTTP and FTP. Configuration of universal inputs and virtual points can be
accomplished using web pages. Type II and type III thermistors curves are resident in
the unit. Current inputs can be measured using external resistors. Contact closures
require a voltage-free source. Binary inputs and outputs as well as analog outputs
require no configuration. The unit is powered from either a 24VAC/VDC source.

1.1 Features and Benefits

Versatile Control Device — field controller or remote Ethernet I/O

 BACnet/IP compliant
 B-ASC device profile
 Configurable by Workbench or provided program
 Direct connection to an Ethernet network
 Powered by Sedona Framework™

Flexible Input/Output — 20-points of I/O

 Eight configurable universal inputs:

Thermistor, analog voltage, contact closure, pulse inputs (4 max)

 Four contact closure inputs
 Four analog voltage outputs
 Four relay or triac output (model specific)

TD100700-0MB

5

1.2 Product Image and Main Features

Figure 1 — BASC20 Main Features

TD100700-0MB

6

2 Specifications

Configured As

Limits

Analog Input

0–10 VDC or 0–20 mA (with external resistor).
12-bit resolution. Input impedance 1 MΩ on voltage.

Temperature Input

Type II: –10º to +190 ºF (–23.3º to +87.8ºC)
Type III thermistors: –15º to +200 ºF (–26.1º to +93.3ºC)

Contact Closure Input

Excitation current 0.25 mA. Open circuit voltage 12 VDC.
Sensing threshold 0.3 VDC. Response time 20 ms.

Pulse Input
(points UI1–UI4)

0–10 VDC for active output devices.
0–12 VDC for passive devices (configured for internal pull-up resistor).
40 Hz maximum input frequency with 50% duty cycle.

Limits

Contact Closure

Excitation current 0.25 mA. Open circuit voltage 12 VDC. Sensing
threshold 0.3 VDC. Response time 20 ms.

Limits

Analog Output

0–10 VDC. 12-bit resolution. 4 mA maximum.

Limits

Model BASC-20R

Normally Open contacts. 30 VAC/VDC 2 A.

Model BASC-20T

Isolated triac. 30 VAC 0.5 A.

Protocol

Data Link and Physical Layers

Ethernet

ANSI/IEEE 802.3 10/100 Mbps Ethernet. 10BASE-T, 100BASE-TX, auto­negotiation of speed and duplex. Auto-MDIX. 100 m maximum segment
length. Default IP address is 192.168.92.68/24.

Protocol

Compliance

BACnet/IP

ASHRAE 135-2008 annex J.
Application specific controller device profile B-ASC.

2.1 Universal Input (Channels UI1–UI8)

2.2 Binary Inputs (Channels BI1–BI4)

2.3 Analog Outputs (Channels AO1–AO4)

2.4 Binary Outputs (Channels BO1–BO4)

(Class 2 circuits only — requires external power source)

2.5 Communications

2.6 Protocol Compliance

TD100700-0MB

7

2.7 Power Requirements

Item

Limits

Input power

24 VAC/VDC ± 10%, 47–63 Hz, 6 VA

Item

Description

Protection

All inputs and outputs (except for relay outputs and communications ports)
are over-voltage protected up to 24 VAC and short-circuit protected.

Environmental

Operating temperature 0° to +60°C. Storage temperature –40°C to +85°C.
Relative humidity 10–95%, non-condensing.

Weight

0.6 lbs. (0.27 kg).

LED Indicator

Indication

UI1–UI8 Configured as Analog Input

Green: > 1% of range, otherwise off

UI1–UI8 Configured as Temperature Input

Green: sensor detected

UI1–UI8 Configured as Contact Input

Green: contact closed, otherwise off

UI1–UI8 Configured as Pulse Input

Green: pulse sensed, otherwise off

BI1–BI4 Contact Closure

Green: contact closed, otherwise off

AO1–AO4 Analog Output

Green: commanded output

BO1-BO4 Binary Output

Green: commanded output

Ethernet

Green: Link established; flashes with activity

Standard

Test Method

Description

Test Levels

EN 55024

EN 61000-4-2

Electrostatic Discharge

6 kV contact

EN 55024

EN 61000-4-3

Radiated Immunity

10 V/m, 80 MHz to 1 GHz

EN 55024

EN 61000-4-4

Fast Transient Burst

1 kV clamp & 2 kV direct

EN 55024

EN 61000-4-5

Voltage Surge

1 kV L-L & 2 kV L-Earth

EN 55024

EN 61000-4-6

Conducted Immunity

10 V (rms)

EN 55024

EN 61000-4-11

Voltage Dips & Interruptions

1 Line cycle, 1–5 s @100% dip

EN 55022

CISPR 22

Radiated Emissions

Class A

EN 55022

CISPR 22

Conducted Emissions

Class B

CFR 47, Part 15

ANSI C63.4

Radiated Emissions

Class A

2.8 General Specifications

2.9 LED Indicators

2.10 Electromagnetic Compatibility

TD100700-0MB

8

2.11 Field Connections

Terminal

Power

HI

High AC or DC +

COM

AC or DC common

Model

Description

BASC-20R

BAScontrol with 20 I/O points, includes 4 relay outputs

BASC-20T

BAScontrol with 20 I/O points, includes 4 triac outputs

Terminal

Universal Inputs 1–8

UI1 A

Universal Input Point 1 High

UI1 C

Universal Input Point 1 Common

UI2 A

Universal Input Point 2 High

UI2 C

Universal Input Point 2 Common

UI3 A

Universal Input Point 3 High

UI3 C

Universal Input Point 3 Common

UI4 A

Universal Input Point 4 High

UI4 C

Universal Input Point 4 Common

UI5 A

Universal Input Point 5 High

UI5 C

Universal Input Point 5 Common

UI6 A

Universal Input Point 6 High

UI6 C

Universal Input Point 6 Common

UI7 A

Universal Input Point 7 High

UI7 C

Universal Input Point 7 Common

UI8 A

Universal Input Point 8 High

UI8 C

Universal Input Point 8 Common

Terminal

Relay Outputs (BASC-20R)

BO1 A

Output 1 normally-open contact

BO1 B

Output 1 common contact

BO2 A

Output 2 normally-open contact

BO2 B

Output 2 common contact

BO3 A

Output 3 normally-open contact

BO3 B

Output 3 common contact

BO4 A

Output 4 normally-open contact

BO4 B

Output 4 common contact

Terminal

Analog Outputs 1–4

AO1 A

Output Point 1 High

AO1 C

Output Point 1 Common

AO2 A

Output Point 2 High

AO2 C

Output Point 2 Common

AO3 A

Output Point 3 High

AO3 C

Output Point 3 Common

AO4 A

Output Point 4 High

AO4 C

Output Point 4 Common

Terminal

Binary Inputs 1–4

BI1 A

Input Point 1 High

BI1 C

Input Point 1 Common

BI2 A

Input Point 2 High

BI2 C

Input Point 2 Common

BI3 A

Input Point 3 High

BI3 C

Input Point 3 Common

BI4 A

Input Point 4 High

BI4 C

Input Point 4 Common

Terminal

Triac Outputs (BASC-20T)

BO1 A

Output 1 Isolated Triac

BO1 B

Output 1 Isolated return

BO2 A

Output 2 Isolated Triac

BO2 B

Output 2 Isolated return

BO3 A

Output 3 Isolated Triac

BO3 B

Output 3 Isolated return

BO4 A

Output 4 Isolated Triac

BO4 B

Output 4 Isolated return

2.12 Power Connection

2.13 Ordering Information

TD100700-0MB

9

2.14 Dimensional Drawing

All units are in mm.

Figure 2 — BASC20 Dimensions

TD100700-0MB

10

2.15 PICS Statement

TD100700-0MB

11

3 Installation

The BASC20 is intended to panel-mounted with screws (not provided).

3.1 Power Supply

The power source for the internal supply is applied via the two terminals labelled HI
and COM. COM is for the power source return and also serves as the common
ground connection. Primary 24 VAC/VDC (± 10%) power is applied to HI and COM.
HI connects to a diode accomplishes half-wave rectified power — while providing
reverse input voltage protection. The recommended power conductor size s 16–18
AWG (solid or stranded). Ground is directly connected to zero volts. Input
connections are reverse-polarity protected.

WARNING: Powering devices can present hazards. Read the next two sections carefully.

3.1.1 Power Supply Precautions

Internally, the BASC20 utilizes a half-wave rectifier and therefore can share the
same AC power source with other half-wave rectified devices. Sharing a common
DC power source is also possible. Sharing AC power with full-wave rectified devices
is NOT recommended. Full-wave rectified devices usually require a dedicated AC
power source that has a secondary elevated above ground. Both secondary
connections are considered HOT. AC power sources that power several half-wave
devices have a common secondary connection called COMMON, LO, or GROUND.
This connection might be tied to earth. The other side of the secondary is
considered the HOT or HI side of the connection. Connect the HOT side of the
secondary to the HI input on the BASC20 and the LO side to COM on the BASC20.
All other half-wave devices sharing the same AC power source need to follow the
same convention. When using a DC power source, connect its positive terminal to
the HI input on the BASC20 and the negative terminal to COM on the BASC20.
Reversing polarity to the BASC20 will not damage the BASC20.

WARNING: Devices powered from a common AC source could be damaged if a mix

of half-wave and full-wave rectified devices exist. If you are not sure of the type of
rectifier used by another device, do not share the AC source with it.

3.1.2 Limited Power Sources

The BASC20 should be powered by a limited power source complying with the
requirements of the National Electric Code (NEC) article 725 or other international
codes meeting the same intent of limiting the amount of power of the source. Under
NEC article 725, a Class 2 circuit is that portion of the wiring system between the
load side of a Class 2 power source and the connected equipment. For AC or DC
voltages up to 30 volts, the power rating of a Class 2 power source is limited to 100
VA. The transformer or power supply complying with the Class 2 rating must carry a
corresponding listing from a regulatory agency such as Underwriters Laboratories (UL).

TD100700-0MB

12

3.2 Cabling Considerations

Function

Signalling and
Data Rate

Minimum Required Cable

Maximum Segment Distance

Ethernet

10BASE-T
10 Mbps

Category 3 UTP

100 m (328 ft)

Ethernet

100BASE-TX
100 Mbps

Category 5 UTP

100 m (328 ft)

I/O

Unspecified

Solid: 16–22 AWG
Stranded: 16–18 AWG

Unspecified

Table 1 — Cabling Considerations

* If using shielded cable, connect to chassis at only one point.

NOTE: Wire size may be dictated by electrical codes for the area where the
equipment is being installed. Consult local regulations.

Observe in Table 1 that 10BASE-T segments can successfully use Category 3, 4 or
5 cable — but 100BASE-TX segments must use Category 5 cable. Category 5e
cable is highly recommended as the minimum for new installations.

The Ethernet port of the BASC20 employs Auto-MDIX technology so that either
straight-through or crossover cables can be used to connect to the network.

TD100700-0MB

13

4 Field Connections

4.1 Sample BASC20 Wiring Diagram

Figure 3 — Sample BASC20 Wiring Diagram

TD100700-0MB

14

4.2 Universal Input — Configured as Analog Input

An analog input can measure voltage in the range of 0–10 VDC or it can measure
current in the range of 0–20 mA with a 500 Ω external resistor. Transmitters that
produce an elevated “zero” such as 2–10 VDC or 4–20 mA can be measured as
well. Using the web page, configure the input for voltage. When set as a voltage
input, the input impedance is 1 MΩ.

With voltage measurement, connect the more positive voltage to point A and the less
positive to common C as shown in Figure 4. On three-wire devices such as damper
actuators, the output signal is referenced to the damper’s power supply common.
That common must be at the same reference as the BASC20 common. Notice the
connections in the diagram. In this situation it is only necessary to attach the
transmitter output to point A on the BASC20 input.

Figure 4 — Analog Input Connections

When measuring current from two-wire transmitters, remember the BASC20 sinks
current to ground. A 500 Ω resistor is applied between points A and C on the input.
To measure current, it must be driven into point A with respect to point C.

Care should be exercised when connecting to a three-wire current transmitter.
These are usually non-isolated devices between the power source and signal output.
The BASC20 will sink current from its input to ground so the transmitter must source
current from a positive potential to ground. If the three-wire transmitter works in this
manner, it can be accommodated.

Four-wire transmitters usually have isolation between power supply and signal
output so their output stage can usually be treated as a two-wire transmitter.

TD100700-0MB

15

4.3 Universal Input — Configured as Temperature Input

The BASC20 has built-in calibration curves for 10 kΩ Type II or Type III thermistors.
These devices have a non-linear negative coefficient of resistance to temperature

and provide a nominal resistance of 10 kΩ at 25°C. With a web browser, configure

an input Channel Type for either Type II or Type III thermistor. As shown in Figure 5,
connect the two-wire thermistor to points A and C. Polarity is not an issue. If
averaging of temperature is desired, connect multiple thermistors in a series-parallel

combination so that the nominal resistance remains at 10 kΩ as shown. Make sure

that all devices are of the same type. The effective range of measurement varies by
type. Type II 10 kΩ thermistors range from –10º to +190 ºF (–23.3º to +87.8ºC).
Type III 10 kΩ thermistors range from –15º to +200 ºF (–26.1º to +93.3ºC). An open
input results in a fault condition and no LED indication for that point.

Figure 5 — Thermistor Connections

TD100700-0MB

16

4.4 Universal Input — Configured as a Binary Input

To sense the action of a push-button or relay, the contacts must have no applied
energy, and be rated for low-voltage, low-current switching. The BASC20 provides
the energy to be sensed. With a web browser, access the Main Screen, click the title
link of any channel UI1–UI8. Set the Channel Type to Binary Input and the Units to
NO_UNITS. As shown in Figure 6, connect the contacts between points A and C.
For common mechanical contacts, polarity is not an issue. The open-circuit voltage
is 12 VDC and the short-circuit current is 0.5 mA.

For solid-state switch sensing, we recommend that an attached solid-state device
have an opto-isolated open-collector NPN transistor output stage with a collector­emitter output voltage (Vce) of at least 30 V. Output sinking current should be greater
than 5 mA. The collector-emitter saturation voltage should be less than 0.2 V when
sinking 2 mA. The emitter must be connected to point C and the collector to point A
(the more positive point). The BASC20 sets the low-threshold to 3 V and the high­threshold to 6 V. When a contact is made or the solid-state switch is on (resulting in a
saturated output), the voltage at point A is close to zero volts. The corresponding LED
for that channel will be on. If the contact is opened or the solid-state switch is turned
off, the voltage at point C quickly rises towards 12 V. Once the voltage passes the 6 V
high-threshold, the “off” state is sensed. To return to the “on” state, this voltage must
fall below 3 V. The three-volt difference is called hysteresis. There is no need to
add an external pull-up resistor when using a contact closure input.

Contact closure inputs are sampled every 10 ms and for a change of state to be
recognized, the input state must be stable for two consecutive samples. Therefore,
contact closure response is 20 ms.

Figure 6 — Binary Input Connections

TD100700-0MB

17

4.5 Universal Input — Configured as Pulse Input

When an input is configured for Pulse Input, a pulse rate up to 40 Hz can be measured,
assuming a 50% duty cycle. The pulse device could have an active output or a
passive output requiring a pull-up resistor. Both situations can be accommodated.

The input voltage range is 0–10 VDC and the installer can set both the low-threshold
and high-threshold on the Pulse Input web page. The difference in the two
thresholds is the hysteresis. You can detect a sinusoidal input by setting the high
threshold below the positive peak and the low threshold above the negative peak.
Setting both thresholds well away from the sinusoidal waveform peaks offers some
noise immunity. It is not necessary for the input to swing from zero to 10 V. Any
substantial swing within this range can be detected. The input impedance using
Pulse Input is 100 kΩ when using active sensors. Connect the output of the pulse
device to point A and the common to point C as shown in Figure 7.

If the pulse device has a passive output requiring a pull-up resistor, the BASC20 can

provide a 10 kΩ resistor to +12 VDC by checking a box on the configuration page.

The two threshold values can still be set as needed.

Figure 7 — Pulse Input Connections

TD100700-0MB

18

4.6 Analog Outputs

Voltage in the range of 0–10 VDC can be outputted by assigning analog outputs
(AO1–AO4). For analog output DC voltage, the output voltage is applied to point A
with respect to C (common). There is no configuration necessary for analog outputs.

Figure 8 illustrates connections to a three-wire damper actuator. The damper

requires a 0–10 V command signal which can easily be accomplished by the
BASC20. If position feedback is to be measured, connect the actuator output signal
to UI1 and configure the universal input for analog input.

Figure 8 — Analog Output Connections

TD100700-0MB

19

4.7 Binary Outputs

As shown in Figure 9, four binary outputs (BO1 – BO4) are available. Each output
requires an external power source. Two types of binary devices can be controlled.
The BASC-20R provides four normally-open form “A” relay contacts that are rated at
30 VAC/VDC and 2 A. The BASC-20T provides isolated triac outputs that can drive
loads up to 30 VAC and 0.5 A.

Each output voltage is applied to point A with respect to point B and is intended for
Class 2 circuits only.

Figure 9 — Binary Output Connections

TD100700-0MB

20

4.8 Binary Inputs

To sense the action of a push-button or relay, the contacts must have no applied
energy, and be rated for low-voltage, low-current switching. The BASC20 provides
the energy to be sensed. With a web browser, access the Main Screen, click the title
link of any channel UI1–UI8. Set the Channel Type to Binary Input and the Units to
NO_UNITS. As shown in Figure 10, connect the contacts between points A and C.
For common mechanical contacts, polarity is not an issue. The open-circuit voltage
is 12 VDC and the short-circuit current is 0.5 mA.

For solid-state switch sensing, we recommend that an attached solid-state device
have an opto-isolated open-collector NPN transistor output stage with a collector­emitter output voltage (Vce) of at least 30 V. Output sinking current should be
greater than 5 mA. The collector-emitter saturation voltage should be less than 0.2
V when sinking 2 mA. The emitter must be connected to point C and the collector to
point A (the more positive point). The BASC20 sets the low-threshold to 3 V and the
high-threshold to 6 V. When a contact is made or the solid-state switch is on (resulting
in a saturated output), the voltage at point A is close to zero volts. The corresponding
LED for that channel will be on. If the contact is opened or the solid-state switch is
turned off, the voltage at point C quickly rises towards 12 V. Once the voltage
passes the 6 V high-threshold, the “off” state is sensed. To return to the “on” state,
this voltage must fall below 3 V. The three-volt difference is called hysteresis. There
is no need to add an external pull-up resistor when using a contact closure input.

Contact closure inputs are sampled every 10 ms and for a change of state to be
recognized, the input state must be stable for two consecutive samples. Therefore,
contact closure response is 20 ms.

Figure 10 — Binary Input Connection

TD100700-0MB

21

4.9 LEDs

If the I/O channel is …

Green indicates …

a Relay output

the coil or triac is energized.

an Analog output

the command is greater than zero.

a Contact input

the contact is made.

a Pulse input

the input state changed.

a Thermistor

thermistor is connected

an Analog input

the signal is greater than 1% of span.

To aid in troubleshooting, several LEDs have been provided.
The BASC20 has an Ethernet LED that glows green when properly linked to

equipment operating at 10/100 Mbps and indicates activity by flashing.
LEDs to indicate I/O status follow the behaviour described in Table 2 below :

Table 2 — LED Behaviour

TD100700-0MB

22

5 Configuration via a Web Browser

Figure 11 — Setup for Initial IP Address

Configuration by Web Browser

5.1 General Considerations

Some configuration of the BASC20 is required. This is accomplished while the unit
is connected to a computer running a web browser (Java-enabled) that accesses the
unit’s built-in web server.

5.1.1 Ethernet Port

Auto-Negotiation

The Ethernet port on the BASC20 offers
full auto-negotiation. A single cable
links two Ethernet devices. When these
devices auto-negotiate, the data rate will
be 100 Mbps only if both are capable of
that speed. Likewise, full-duplex will
only be selected if both can support it. If
only one device supports auto­negotiation, then it will default to half­duplex mode and match the data rate of
the non-auto-negotiating device.

Auto-MDIX (Auto-Crossover)

When interconnecting two Ethernet
devices, a straight-through cable or
crossover cable can be used — but if
one device uses Auto-MDIX, the cable wiring does not matter; Auto-MDIX adjusts for
either type.

Reset Switch

To reset the BASC20 to its default values of the IP address (192.168.92.68) and
netmask (/24 or 255.255.255.0), press the reset switch (see Figure 1 for location)
while the unit is powered. Follow the instructions under the section 5.1.2.

5.1.2 Secure Login and Reset (Recovery Mode)

To reset the unit to its default IP values and login credentials, press the reset switch
for over 4 seconds. (See Figure 1 for the switch location.) This forces the recovery
mode — confirmed by alternate flashing of UI1-UI4 and AO1-AO4 channel LEDs.
This action restores the default settings for the user ID (admin), password (admin), IP
address (192.168.92.68) and subnet mask (255.255.255.0). Access the main web
page (Figure 13 ), make any changes to the IP configuration and login credentials, and
then click Restart Controller to exit recovery mode.

TD100700-0MB

23

5.1.3 Web Server Initial Access

5.1.3.1 Web Server

The BASC20 contains an interactive web server, accessible from any Internet-compatible
PC on the local network. It is compatible with all recent browsers. It is factory
programmed with a default IP address of 192.168.92.68 and a Class C subnet mask
of 255.255.255.0. Once configured, changing its IP address is strongly encouraged.

5.1.3.2 Initial Access

The hardware arrangement for initially setting the BASC20 IP address appears in

Figure 11. The PC should be temporarily disconnected from the Ethernet LAN in

case the BASC20’s default address matches that of a device on the existing LAN.
The procedure for altering the IP address creates a temporary LAN composed of
nothing but the BASC20, the PC used to configure it and a CAT5 cable connecting
the two. Since the BASC20 supports Auto-MDIX, either straight-through or
crossover cable can be used.

For initial configuration, the PC chosen for the procedure should temporarily have its
IP address modified as shown in Figure 12 — which employs a Windows® 7 example.

Figure 12 — Steps for Changing the IP Address of the PC Used for Setup

Figure 12 uses an IP address for the PC of 192.168.92.69, but the final quad of the

address could be any value 1–254 except for 68 which is used by the BASC20.
After setting the IP address of the PC to the same LAN as the BASC20, a browser
can access the BASC20 default IP address.

When first accessing the BASC20, you must provide the default login credentials.
We strongly advise you to change these values as discussed in Section 5.1.4.4.

TD100700-0MB

24

Figure 13 displays the Main Page that appears after you first login to the BASC20.

Checkboxes Enable Forcing

This page displays channel data in five columns:

 Universal Inputs (Channels UI1–UI8)
 Binary Inputs (Channels BI1–BI4)
 Analog Outputs (Channels AO1–AO4)
 Binary Outputs (Channels BO1–BO4)
 Virtual Points (Channels VT1–VT8)

Each of the 28 channels has three features:

 title link — If clicked, it displays a configuration screen (see Figure 18).
 data field* — You can read a value or enter one if forced (see Section

5.1.10).

 checkbox* — If checked, you can force the channel value (see Section

5.1.10).

* You need to check the box before making a change.

Figure 13 — Main Page

Six buttons occupy the bottom of the Main Page. They function as follows:

 System Configuration described in Section 5.1.4
 System Status described in Section 5.1.5
 Set Time described in Section 5.1.6
 Web Components described in Section 5.1.7
 Restart Controller described in Section 5.1.8
 Auto Refresh (On/Off) described in Section 5.1.9

TD100700-0MB

25

5.1.4 System Configuration

Clicking the System Configuration button shown in the lower-left area of Figure 13
opens the window depicted in Figure 14 — where you can configure the settings
discussed in the next four sections.

Figure 14 — System Configuration Window

Four sections and two special buttons exist on the System Configuration screen:

 IP Configuration is discussed in Section 5.1.4.1.
 BACnet Device Configuration is discussed in Section 5.1.4.2.
 Enable Protocol is discussed in Section 5.1.4.3.
 Authentication is discussed in Section 5.1.4.4.
 Kit Update is discussed in Section 5.1.4.5

TD100700-0MB

26

5.1.4.1 IP Configuration

As shown on the left side of Figure 14, the following parameters can be adjusted,
followed by a Submit:

 IP Mode Choose either Static IP (the default) or DHCP.
 IP Address Changing the default value of 192.168.92.68 is recommended.
 Netmask The default value of 255.255.255.0 is adequate for most users.
 Gateway If your Ethernet LAN has a gateway (router) enter its IP address here.

After the BASC20 has been given its initial configuration, it will be ready for use in
the full original Ethernet network. The temporary network constructed in Figure 11
should be dismantled and the PC re-configured to restore its original IP address.

5.1.4.2 BACnet Configuration

As shown on the right side of Figure 14, the following parameters can be adjusted,
followed by a Submit:

 Device Object Name You must change the default name (BAScontrol System) to

be unique throughout the entire BACnet internetwork.

 Device Instance This 22-bit value (0–4,194,303) must be unique throughout the

entire BACnet internetwork. It defaults to 2749.

 UDP Port The default of 47808 should usually not be changed.
 BBMD IP Address Enter the address of the BBMD with which the BASC20 will

perform Foreign Device Registration (FDR) — if the BBMD is
not in the same subnet as the BASC20.

 BBMD Reg Time Specify the seconds between successive FDR registrations.

5.1.4.3 Enable Protocol

On the right side of Figure 14, three functions can be adjusted, followed by a
Submit:

 BACnet Disabling BACnet (on by default) will free more memory for Sedona.
 Sedona Disabling Sedona (on by default) will free more memory for BACnet.
 FTP If needed, enable FTP (which by default is unchecked). If you select

FTP, BACnet and Sedona are automatically de-selected.

5.1.4.4 Authentication

On the right side of Figure 14, you can use up to 63 characters to specify User
Name and Password, followed by Submit:

 User Name You can change the default admin to any User Name you wish.
 Password You can change the default admin to any Password you wish.

5.1.4.5 Kit Update

Consult the BASC20 support page for detailed instructions on using this feature:

www.ccontrols.com/support/bascontrol20.htm

TD100700-0MB

27

5.1.5 System Status

This read-only screen is displayed in Figure 15 and reports the three items:

 Firmware Revision Your firmware version is listed in the upper-left corner.
 MAC ID The Ethernet MAC address in the middle.

 Available Memory This value in the upper-right corner will vary often.
 System Message Log is discussed in Section 5.1.5.1.

Figure 15 — System Status Window

5.1.5.1 System Message Log

Various items are reported in Figure 15 after a power up cycle. Information is used by
technical support at Contemporary Controls.

TD100700-0MB

28

5.1.6 System Time

Clicking the Set Time button shown in the lower-right area of Figure 13 opens the
window depicted in Figure 16 — where you can configure these settings:

 System Time Here you can read the date and time or manually set

them — but only if you disable the NTP option.

 NTP Configuration is discussed in Section 5.1.6.1.
 DST Configuration is discussed in Section 5.1.6.2.

5.1.6.1 NTP (Network Time Protocol)

NTP is a protocol which synchronizes clocks to UTC (Coordinated Universal Time).
By default as shown in the upper-right portion of Figure 16, NTP is disabled, but an
NTP server IP address is shown. When NTP is enabled, the NTP server will be
queried and the BASC20 time will be synchronized at startup — and at midnight
during each refresh period.

 NTP Enable You can enable Network Time Protocol (disabled by default).
 NTP Server Change the default IP address (130.149.17.21), if needed.
 Time Zone Set the Time Zone to match that of your location.
 NTP Refresh (Days) Change the default value (1) if needed.

NTP does not support local time zone changes such as for DST (Daylight Saving
Time, aka Summer Time).

5.1.6.2 DST (Daylight Saving Time, aka Summer Time)

DST Configuration is provided as displayed in the lower-right portion of Figure 16,

because NTP cannot adjust them. Drop-down menus allow you to set the date and
the time after midnight for enabling and disabling DST. Be sure to click Update NTP

& DST after making changes.

Figure 16 — System Time Window

TD100700-0MB

29

5.1.7 Web Components (WC01–WC04)

Web components provide a means of interacting with the Sedona wire sheet via a web
browser versus using a Workbench tool. These are custom components developed
by Contemporary Controls which are provided in the Ccontrols_BASC20_Web kit.
Configuring the 48 web components is accomplished from eight web pages. Each
web component can be configured as a wire sheet input or a wire sheet output using
a drop-down box. For every web component (WC), a description and value can be
entered on the web page. If the component is configured as a wire sheet input (float,
integer or binary), limits can be assigned for the variable’s range. If the entered
value is within the limits, it will be applied to the web component on the wire sheet.
This eliminates the need to add limit logic on the wire sheet. For wire sheet outputs,
limits are ignored. The description field is only used as an aid to the systems integrator
in understanding the function of the component.

Figure 17 — Web Components Screen Showing Example Data

5.1.8 Restart Controller

Click this button to reboot the BASC20 that is currently targeted by your browser.
Extreme care should be exercised when resetting a commissioned controller.

5.1.9 Auto Refresh (On/Off)

Click this button to update the BASC20 values currently displayed by your browser.
With Auto Refresh ON, values periodically update. If OFF, there is no updating.

TD100700-0MB

30

5.1.10 Forcing I/O Points from the Main Web Page

There is one feature available on the main web page that could be useful for checkout
but must be done with great care. Both input and output points can be forced to states
and values different from program generated values. Looking at the main web page,
it is possible to both read and write values for the 20 real I/O points and eight virtual
points. There is no issue with reading points — only writing points. Just to the right of
the value field is a checkbox. If you hover your cursor over this checkbox, this tool
tip will display: Click to Force Channel. To change an input or output value, check
this box before making a value change. This override value will remain until the
checkbox is unchecked. The same can be done to outputs.

Caution: Use great care when forcing an input or output on a commissioned system

to avoid damage to equipment or process or injury to personnel.

TD100700-0MB

31

5.2 Channel Configuration

To configure a channel, access the Main Page (Figure 13), click on the title link for the
channel of interest and make adjustments in the new screen that appears (Figure 18).
The upper section of the new screen displays BAS Channel Configuration options; the
lower section displays BACnet Object Configuration options. Only the universal inputs
must be configured in the upper portion of the screen. The channel identity is confirmed
by the large channel tag near in the upper-right corner of the new screen. Clicking the
Submit button registers your changes which become effective immediately. If you close
the configuration screen without clicking the Submit button, your changes will be lost.

The BAS Channel Configuration (upper) section of each configuration screen displays:

 Channel Type — If more than one option is available, choose the desired type.
 Channel Number — This read-only value confirms the selected channel.
 Submit button — This will immediately apply your configuration.

 Close button — The window closes whether or not the configuration is saved.

The BACnet Object Configuration (lower) section of the screen displays:

 Object Instance — This is the read-only value automatically assigned for this channel.
 Object Name — Assign the channel a name, using up to 63 characters.
 Object Type — This will match the selected Channel Type (see above) except for

Virtual Points which must be either Analog Value or Binary Value.

 Object Description — Describe the device as you wish, using up to 63 characters.
 Units — Choose the appropriate unit from the list of standard BACnet units.
 COV Increment — Enter the amount of change (0 for any change) at which a COV

message will be sent to subscribers. (Ignored for binary objects.)
You can subscribe to 2 analog and 2 binary channels. Additional
subscription requests will be denied.

Figure 18 — Sample Configuration Screen

TD100700-0MB

32

5.2.1 Universal Input — Configured as Analog Input

(Channels UI1–UI8)

You can measure 0–10 V with UI1–UI8 as follows:

 Access the Main Page (Figure 13) and click a title link from among UI1–UI8.
 Under BAS Channel Configuration in the new page that appears, set the

Channel Type to Analog Input. An example appears in Figure 19.

 Under BACnet Object Configuration, the Units value defaults to VOLTS.
 Attach your device to the pair of BASC20 pins for the chosen channel — so

that the more positive connection is to pin A and the more negative to pin C.

Figure 19 — Universal Input Configured as Analog Input

TD100700-0MB

33

5.2.2 Universal Input — Configured as Binary Input

(Channels UI1–UI8)

You can accept a binary input with any channel UI1–UI8 as follows:

 On the Main Page (Figure 13), click a title link from among UI1–UI8.
 Under BAS Channel Configuration in the new page that appears (Figure 20),

set the Channel Type to Binary Input.

 In the BACnet Object Configuration (lower) section of the screen, all items

are as described in Section 5.2 above — but Units defaults to NO_UNITS.

 Attach your device to the pair of BASC20 pins for the chosen channel — so

that the more positive connection is to pin A and the more negative to pin C.

Figure 20 — Universal Input Configured as Binary Input

TD100700-0MB

34

5.2.3 Universal Input — Configured as Pulse Input

(Channels UI1–UI4)

Any channel UI1–UI4 can be a Pulse Input for pulse trains in the range of 0–40 Hz.
You can accept a pulse input with any channel UI1–UI8 as follows:

 On the Main Page (Figure 13), click a title link from among UI1–UI8.
 Under BAS Channel Configuration in the new page that appears (Figure 21),

set the Channel Type to Pulse Input. Additional fields then appear …

 In the Maximum Value field, set the desired limit for the accumulated pulse

count. It defaults to the absolute maximum of 16,777,215. To reset this
value, simply write a new value in this field. You can also reset this value via
BACnet by taking the channel out of service, writing a desired value — such
as 0 — and then putting the channel back in service to resume counting.

 Set the Pull Up Resistor parameter to Enabled, if used with a passive device.

Note: The BAS Channel Type is Pulse Input, but the BACnet Object Type is
Analog Input. This is because the BACnet object is an accumulator.

Figure 21 — Universal Input Configured as Pulse Input

TD100700-0MB

35

5.2.4 Universal Input — Configured as Thermistor Input

(Channels UI1–UI8)

Channels UI1–UI8 can be used as Type II or Type III Thermistor Inputs. The
channel BACnet type will be Analog Input.

You can accept a thermistor input with any channel UI1–UI8 as follows:

 On the Main Page (Figure 13), click a title link from among UI1–UI8.
 Under BAS Channel Configuration in the new page that appears (Figure 22 is

an example of a Type III screen), set the Channel Type to Therm 10kT2 or
Therm 10kT3. Additional fields then appear …

 The Temperature Offset parameter is only used as needed. If you determine

that your thermistor yields an inaccurate result, enter a positive or negative
offset value here to correct your thermistor reading.

 Temperature Units — the Fahrenheit default can be changed to Celsius.

Note that the Units parameter under BACnet Object Configuration near the
bottom of the screen automatically replicates your setting of the Temperature
Units parameter.

Figure 22 — Thermistor Input Configuration

TD100700-0MB

36

5.2.5 Binary Inputs (Channels BI1–BI4)

You can accept a binary input with any channel BI1–BI4 as follows:

 On the Main Page (Figure 13), click a title link from among BI1–BI4.
 Under BAS Channel Configuration in the new page that appears (Figure 23),

the Channel Type should be Binary Input by default.

 In the BACnet Object Configuration (lower) section of the screen, all items

are as described in Section 5.2 above — but Units defaults to NO_UNITS.

 Attach your device to the pair of BASC20 pins for the chosen channel — so

that the more positive connection is to pin A and the more negative to pin C.

Figure 23 — Binary Input Configuration

TD100700-0MB

37

5.2.6 Analog Outputs (Channels AO1–AO4)

Voltage in the range of 0–10 VDC (with up to 4 mA of current) can be outputted by
assigning analog outputs. Configure an output using a web browser. For DC
voltage, the output voltage is applied to point A with respect to C (common).

Any channel AO1–AO4 can be used to provide an analog voltage output. The
BACnet type will be Analog Output. To configure an analog output:

 On the Main Page (Figure 13), click a title link from among AO1–AO4.
 Under BAS Channel Configuration (lower) section of the new screen that

appears (Figure 24), the Channel Type will be Analog Output (read-only).

 In the BACnet Object Configuration (lower) section of the screen, all items

are as described in Section 5.2 above — but Units defaults to VOLTS.

 Attach your device to the pair of BASC20 pins for the chosen channel — so

that the more positive connection is to pin A and the more negative to pin C.

Figure 24 — Analog Output Configuration

TD100700-0MB

38

5.2.7 Binary Outputs (Channels BO1–BO4)

The BASC20 can provide four binary relay outputs (BASC-20R) or four triac outputs
(BASC-20T). The voltage and current limits for relay units are 30 VAC/VDC and 2 A.
For triac units the limits are 30 VAC and 0.5 A. Violating these limits could damage
the BASC20 and void the warranty.

Relay channels can be used as contact closures for other devices, but triac channels
can only be used to enable or restrict the flow of AC current. It is common for the
BASC20 binary outputs to enable the coil of interposing relays which can carry larger
currents and support switching higher voltages.

Any channel BO1–BO4 can be used to provide an binary output. The BACnet type
will be Analog Output. To configure an analog output:

 On the Main Page (Figure 13), click a title link from among BO1–BO4.
 Under BAS Channel Configuration (lower) section of the new screen that

appears (Figure 25), the Channel Type will be Binary Output (read-only).

 In the BACnet Object Configuration (lower) section of the screen, all items

are as described in Section 5.2 above. Units will default to NO_UNITS.

 Attach your device to the pair of BASC20 pins for the chosen channel — so

that the more positive connection is to pin A and the more negative to pin B.

Figure 25 — Binary Output Configuration

TD100700-0MB

39

5.2.8 Virtual Points (Channels VT1–VT8)

Figure 26 — Virtual Configuration Screen

In the CControls_BASC20_IO kit are eight virtual point components (VT1–VT8) that
are used by a BACnet client to send and receive intermediate data to and from the
BASC20. By intermediate data we mean that the data is neither input data nor output
data but something in between real inputs and real outputs. It could be set-point or reset
data intended for the wire sheet or calculated or status information generated by the wire
sheet. Although BACnet allows for the reading of the BASC20 real input and output
points — and under certain conditions the writing of real output points — virtual points
have no reading or writing restrictions. Virtual points are treated by BACnet as either a
binary variable (BV) or analog variable (AV) while real points appear as binary inputs
(BI), analog inputs (AI), binary outputs (BO) or analog outputs (AO). The BASC20 logic
engine reads the state of its inputs (AI and BI) and outputs (AO and BO), executes logic,
and then sets outputs (AO and BO) accordingly. In a similar manner, a BACnet client
can “read” the BASC20’s real inputs and will attempt to “write” to the BASC20’s real
outputs. AVs and BVs are a bit different in that they can be configured to be either an
input to the BACnet client (read) or an output from the BACnet client (write). Therefore,
we need to establish rules for the use of AVs and BVs.

If a BACnet client is to read intermediate data from the Sedona wire sheet, this is no
different from accessing data from an input component on the wire sheet. We would call

this “reading from the wire sheet” or Wire Sheet Read. The VT on the wire sheet would

have a channel type (Chn Type) of “float out” or “binary out.”
If a BACnet client is to write intermediate data to the Sedona wire sheet, this is no

different from logic on the wire sheet writing to an output component. We would call this
“writing to the wire sheet” or Wire Sheet Write. The VT on the wire sheet would have a
channel type (Chn Type) of “float in” or “binary in.”

Like universal inputs, virtual points are configured via web pages that are accessible from
the main web page. Click on the title link of a particular virtual point to gain access to its
configuration page. From the Object Type parameter under BACnet Object
Configuration, select either
Analog Variable or Binary Variable
and click the radio button called
Read from Wire Sheet — if your
intent is for the BACnet client to
read this point. If your intent is for
the BACnet client to write to this
point, click Write to Wire Sheet.
You will notice that the heading of
the virtual points will be either

Wire Sheet Read or Wire Sheet
Write depending on whether the

BACnet client is going to be
reading wire sheet data or writing
wire sheet data.

Upon power loss, all eight virtual
components are retentive up to
seven days. This allows a
BACnet client command to be
retained even if power is lost to
the controller. Backup is accomplished using a super-cap.

TD100700-0MB

40

6 Configuration via the Workbench Tool

Configuration of the BASC20 is first accomplished using web pages. To implement
a control scheme, Niagara Workbench or a similar tool is required. Either of these
programs is called a workbench tool.

6.1 Introduction to Sedona Framework

Developed by Tridium Inc., Sedona Framework is a software environment designed
to make it easy to build smart, networked, embedded devices which are well suited
for implementing control applications. The Sedona language is a component­oriented programming language similar to Java or C#. By utilizing this language,
custom components can be developed and assembled into applications. As a
developer, Contemporary Controls both develops custom components for its Sedona
products and uses components developed by Tridium.

For those familiar with Niagara Framework®, understanding Sedona Framework will

be easy. The system integrator’s role is to create an application by assembling

components onto a wire sheet and connecting and configuring these components
using a graphical programming tool such as Niagara Workbench. Applications can
be developed live on a target device, such as the BASC20, or offline and then saved
and uploaded via an IP connection. The Sedona Virtual Machine (SVM) resident in
the BASC20 executes the application.

Sedona is a component-oriented language meaning that it is used to create functions,
also called components, to that can be assembled into applications using a building-
block approach. Assembling components into applications is much easier than creating
programs — a non-programmer can do it. Components have properties, they provide
action and they can be linked into a tree-structure to form an application. Finally, they
can be executed by a virtual machine installed on a Sedona Device.

6.1.1 Kits

The Sedona components provided in a Sedona device are combined into several
kits. Each kit is a grouping of components that have some logical connection. The
kit file, for example func-821b7396-1.2.28.kit, contains executable code for each
component in the func kit, in binary form. The code in the kit is executed when the
SVM is executing code for the component in the kit on the wiresheet. A kit.scode file
is a binary file which contains all of the code for all kits for a Sedona device in one
file. You can think of the kit file or kits.scode file as a Windows DLL.

6.1.1.1 Kit Updating

Normally, BASC20 kit updating is unneeded. This ability is for individuals who are
developing their own kits and components or who have received new kits from
Contemporary Controls. To update kits in your BASC20, first enable kit updating via
Workbench by pressing the Kit Update button (in the lower left area of Figure 14 ).
Recycling BASC20 power disables kit updating since this function is disabled by default.
If you try to update the BASC20 kits while updates are disabled — Workbench will
seem to do a kit update, but the BASC20 will ignore the received kit file and the
update will not occur.

TD100700-0MB

41

6.1.2 Manifest

A Sedona manifest is an XML file which describes the code within a kit. For example
func-821b7396-1.2.28.xml describes the code within func-821b7396-1.2.28.kit. It lists
the components in the kit and their inputs/outputs (or slots). You can think of the
manifest as the API for the kits file. The manifest also contains version information to
help make ensure you have the proper version of files. Workbench uses the
manifests to learn how to draw the components described in the manifest file.

6.1.3 Platform Manifest

The Sedona platform manifest is an XML file which contains a list of services the
Sedona device provides to programs running on it and the minimum set of kits, and
their versions, it needs to operate properly.

6.1.4 SCode

Scode is block of compiled Sedona code designed to be executed by the SVM.
Kits.scode is all of the code for all of the kits for a Sedona device in a compiled,
executable form.

6.1.5 SAX and SAB files

A SAX file is a XML file that contains a textual description of your Sedona
application. It lists the components you are using and describes how they are
connected. It also contains any constant values used in your Sedona application. A
SAX file can be compiled into a binary form called a SAB file. The SAB file is a
smaller version of the SAX file and is used on the Sedona device to save space.
Workbench can compile the SAX file into the SAB format and upload this to the
Sedona device automatically for you.

TD100700-0MB

42

6.2 Location of Kits, Manifests and Platform

Both the kits.scode and the SVM have been pre-loaded on the BASC20 and are of
little concern to the systems integrator developing the application program.
However, the systems integrator must verify that the identical kits that were used to
develop the kits.scode are installed on the workbench tool otherwise an error
message will occur when connecting the tool with the Sedona Device.

When using Niagara Workbench, find the Niagara folder. Expand this to find a
Niagara sub-folder for version 3.7 or greater. Expand this folder to find the Sedona
folder. When this folder is opened you will find the kits, manifests and platform
folders. This is where the proper kits, manifests and platform are stored to match
those on the workbench tool. A similar process must be followed when using a
similar tool.

When you open up the kits and manifest folders you will notice additional folders with kit
names. Most are from Tridium but the following kits are from Contemporary Controls.

 CControls_BASC20_IO
 CControls_BASC20_Platform
 CControls_BASC20_Web

If you open up these folders you will find either a kit or manifest file with an identical
folder file name followed by a checksum which uniquely identifies the particular file.
These are the files that must uniquely match those in the BASC20. These folders
are not normally found in Niagara installations and must be installed by the user.

For more information on installing the proper kits, manifests and platform in the
workbench tool, view our video series on the BASC20 support page at:

www.ccontrols.com/support/bascontrol20.htm

TD100700-0MB

43

6.3 Creating an Application Program

Using the workbench tool, the systems integrator drags and drops components from
the various available kits found under the Sedona Palette onto a wire sheet. These

components are then linked together using “wires” to depict control flow from

sensors, to control logic and then to actuators. Most of the control logic components
come from the Tridium kits while input/output components are from the BASC20 kits.
Some components can be configured and all must be identified with a unique

reference name or by accepting the default name. The integrator’s role is much

easier than that of the developer in that he is graphically building an application on a
live target using a building-block approach without any concern about how the kits
were developed. He can make changes as he tests his logic until he is satisfied with
the result. However, his job is not complete until he saves his work because these
changes will not be retained if power is lost to the Sedona Device. Once the control
scheme is developed and tested on the BASC20 itself, an app.sab file is
automatically saved to flash memory in the Sedona Device for execution by the
device’s SVM after the user right clicks app and selects Action->Save in Workbench.

At this point the application program is properly retained in the Sedona Device and a
backup copy can be saved in the workbench tool using the Get utility.

TD100700-0MB

44

6.4 Getting Started with a Workbench Tool

Figure 28 — Workbench

Navigation Pane

Figure 27 — Navigation Pane

Expanded to App

Figure 29 — Open Sedona Screen

The best way to begin is to connect either Niagara
Workbench or a similar tool to a BASC20 using an
Ethernet connection. The BASC20 is shipped with
a pre-installed SVM, a kits.scode file and an
app.sab file that represents a default wire sheet. If
you are using Niagara Framework, you will need
version 3.7.xx or later.

Sedona Framework is IP-based so it is necessary
to access the BASC20 over the same IP-subnet
where the BASC20 resides. Using a web browser,
try to access the BASC20 main webpage to verify
you are communicating properly with the BASC20. In the example we used, the
BASC20 was located at private address 10.0.0.211. Pointing the browser to this
location brought up the BASC20 webpage. This verifies that our PC and the
BASC20 are properly communicating over the same subnet so you should be able to
reach the BASC20 with the workbench as well.

While on the BASC20 main web page, configure all
the resident input/outputs according to the application
needs and set the time as well. To use the Sedona
scheduling components, first set time-of day using
the Set Time configuration. Once all configuration is
accomplished, you can exit the BASC20 web page.

Launch Niagara Workbench or a similar tool. If the
BASC20 was accessed before, you should see its
IP address in the navigation pane. Expand the
computer icon with the BASC20 IP address and
click on the Sedona Sox icon. If this is the first
time the BASC20 is being accessed, go to the
menu bar and do the following:

File > Open > Open Device

If you see the Open Sedona when using
Niagara Workbench, you know that Sedona
has been installed in Niagara Workbench.

You should see an Open Sedona dialog box.
The Host setting should be IP and the Port
setting should be 1876. Next to IP enter the
IP address of the BASC20. In our case, it is

10.0.0.211. You must enter a Username and
Password for the tool. In our case, we

accepted the default username/password of
admin/admin. We asked that these
credentials be remembered.

TD100700-0MB

45

Figure 30 — App Properties Screen

If you are successful in connecting, there will be no error messages. On the left side

Figure 31 — Navigation Pane

Expanded to App Sheet

under the navigation pane, expand the Sedona directory to see the App (application)
directory. Click on App and you will see a property sheet. On the lower left side, the
Sedona Palette will be filled in. If there is no Sedona Palette, you can pull it down by
expanding the side bar icon on the task bar.

On the property sheet you can enter a
name for your application under App

Name. You will also notice a Scan
Period setting with a default time of 200
which is in milliseconds. The Scan
Period indicates how often the Sedona

logic is solved which is once every scan
period. During its sleep time, the
BASC20 CPU is allowed to do other
tasks. By increasing the Scan Period,
Sedona logic is solved less frequently
thereby allowing other tasks such as the
web server to perform its work.

On the navigation pane, expand the App directory
and you will notice two folders service and sheet.
Click on sheet to obtain the default Wire Sheet. This
is where components will be assembled into an
application. Under Sedona Palette, select one of the
kits. Now you can see all the components that are
included in that kit. To access the components,
simply drag one of the components onto the wire
sheet. You will be required to provide a unique
seven character ASCII name for the component.

More information about Sedona Programming can
be found on the BASC20 support page at:

www.ccontrols.com/support/bascontrol20.htm

TD100700-0MB

46

6.5 Backing Up and Restoring a Sedona Project

6.5.1 Introduction

The Sedona Project Backup and Restore utility program (BASbackup) provides a
convenient way to save a project to a desktop or laptop computer. A project consists
of the following files:

 Sedona Framework binary application file (app.sab.target)
 Sedona Framework source application file (app.sax)
 BAScontrol20 configuration file (bas_cfg.xml)
 BAScontrol20 web component file (webc.xml)

These files are sufficient to completely backup a project without the need of a
Workbench tool. Although Sedona files can be backed up and restored using the
Workbench tool using the Get and Put commands, the BAScontrol20 configuration
and web component configurations are ignored. Therefore, the Sedona Project
Backup and Restore utility is the best and simplest way to store projects. The
BASbackup program is applicable to firmware of 3.0.28 and later.

6.5.2 System Requirements

BASbackup is a Java program that runs on a Linux, Windows 7 or later computer. It
can be downloaded from our website. Double-click the icon to open a window with a
default IP address as shown in Figure 32. A configuration file will be created as well.

6.5.3 Backing up a Sedona Project

Enter the correct IP Address of the BAScontrol20 to be backed up — if it has changed
from its default value. This utility program will attempt to communicate with a device at
the address entered. The target controller must be powered with Sedona enabled and
accessible. Enter the location of the Sedona Home folder or browse for it using the
Choose Folder button. The Choose Folder button will launch a search window as
shown in Figure 33. The Sedona Home location should be something like:

C:\Niagara\Niagara 3.8.38\Sedona

Figure 32 — Enter the IP Address of the BAScontrol20

TD100700-0MB

47

Enter the location of the Backup File or browse for it using the Choose File button of

Figure 33. You must create a name for your backup zip file — if it does not already

exist. You do not need to add the zip extension since it will be done for you — as
shown in Figure 34. Choose a name that is meaningful to the application or to the
location of the equipment that has the target controller.

Figure 33 — Choose the Sedona Home Folder

With the correct BAScontrol IP Address entered, click on the Backup button and a
credentials window will appear from the targeted controller. Enter the Username and

Password of the Sedona Framework application in the BAScontrol20. The
Username and Password of the web pages are unnecessary and cannot be used.

Figure 34 — Specifying the Backup/Recovery File Name

TD100700-0MB

48

Figure 35 — The Authentication Screen

If you are successful, no error messages will appear. Once the Working… message
ceases on the main page, you can look at the content of your backup zip file by
double-clicking it. You should see the four files that were identified earlier — as
shown in Figure 36.

Figure 36 — Content of the RTU_1 Backup ZIP File

6.5.4 Restoring a Sedona Project

Restoring a Sedona Project is just as easy. Before you begin the restore process, set
the IP address on the main page to the location of the controller to be restored. The
controller must be powered up and accessible. Then click on the Restore button on
the main page to get you to the Restore Setup screen as shown in Figure 37. Notice
that the field values are dimmed. This indicates that these values are read-only. They
will remain read-only until the Change recovery data checkbox is checked.

Figure 37 — Restore Setup Screen (Read-Only Mode)

TD100700-0MB

49

First, notice the location specified as the New Backup/Recovery File. Is this the file
you want restored? Second, look at the top of the screen and you will see the
following parameters:

 IP Address
 Netmask
 Gateway
 BACnet Device Instance
 BACnet Device Name

These five parameters will be loaded into the controller being restored. Are these
five parameters that come from the saved zip file what you want? Is the IP address
of the target address the same as shown on this page? If so, click on Restore for a
simple restore process.

Once the Restore operation is completed, the application program in the target
controller continues to run the old program. To run the newly restored program, a
controller Restart is required. You will be prompted for an immediate restart. You
can do it now or later.

To restart the controller later, click the Restart BAScontrol button on the BASbackup
main page or restart from the controller’s web page. Regardless of what method is
used, care should be exercised when restarting the program on an active controller.
The controller and application should be in sight of the systems integrator initiating
the restart to confirm a safely functioning restart of the application.

TD100700-0MB

50

There are some options available before restoring a controller. Above the Restore
button there are three boxes:

 Wire Sheet
 Main Configuration
 Web Component Configuration

By un-checking boxes you can control what individual files are being restored.
Consider this an advanced feature because under normal conditions you want to
make sure that the three files you saved in the project zip file are going to be
reflected in the restored controller.

6.5.5 Cloning a Controller

It is also possible to direct a saved program to a different controller that needs to run
the identical saved program. However, the IP address, netmask and gateway address
stored in the master’s zip file need to reflect the target controller — otherwise there will
be an IP conflict. In addition, the BACnet Device Instance and BACnet Device Name
must be unique — so it must be changed from what is in the stored in the saved file.

On the BASbackup main page, set the IP address of the target controller and then
click Restore. On the Restore Setup screen that appears as in Figure 38, check the
box entitled Change Recovery Data. Now you are able to change the settings of the
five parameters. It is also a good idea to save the cloned controller settings to a new
zip folder for easy recovery. Enter the new zip file name to be meaningful to the
application or equipment location that has the target controller. Since we want all
types of files saved, we will leave the three Restore Options boxes checked.

There is one important issue to remember. The IP address on the Restore Setup
screen will become the controller’s IP address once the controller is restarted. So it
is possible to send the restore folder data to a different controller as instructed on the
BASbackup main page, restart the controller to change the IP address for you when
you restart the controller. This could be very handy when you have several
BAScontrol20 units at factory-default IP addresses that are to be commissioned in
the field set to the specified addresses.

Click Restore.
Once the Restore operation is completed, the application program in the target

controller continues to run the old program. To run the newly restored program, a
controller Restart is required. You will be prompted for an immediate restart. You
can do it now or later.

If you want to restart controller later, this can be accomplished by clicking the
Restart BAScontrol button on the BASbackup main page or by restarting from the
controller’s web page. Regardless of what method is used, care should be exercised
when restarting the program on an active controller. The controller and application
should be within sight of the systems integrator initiating the restart to confirm a
safely functioning restart of the application.

TD100700-0MB

51

Figure 38 — Restore Setup Screen (Restore Mode)

When you are finished as evidenced that the Working… message ceases, you will
have cloned a controller in the field but configured it appropriately in terms of IP address
and BACnet settings. You also have created a new zip file for project storage.

Figure 39 — Content of the RTU_2 Backup ZIP File

6.5.6 Getting SAX Data

There is a convenient feature on the BASbackup utility. By the utility recreating the
SAX file from the SAB file, we can learn the amount of memory being used in the saved
application or even from an active controller in the field with an unknown file. Make sure
you have the proper Sedona Home folder entered. Click on the Get SAX Data button to
reveal the SAX File Statistics screen displayed in Figure 40 .

TD100700-0MB

52

Figure 40 — SAX File Statistics Screen

The default selection gives you the data from the saved zip file indicated. If using
this option, make sure the saved location is what you want — otherwise browse from
the main page for the correct location. Click on Get Data to retrieve the data.

If instead you check the box that provides the SAX file from a controller in the field,
make sure the IP address indicated is the desired controller otherwise change the IP
address on the main page.

The final option is to uncheck both boxes and search for the SAX file location on
your computer. Usually, this is in this folder

C:\Niagara\Niagara-3.8.38\sedona\store\apps

Once you find the location click Get Data. The information will look like this:

Figure 41 — SAX File Statistics Screen

Notice that the SAX file does not contain the Device Name. This data is stored in the
bas_cfg.xml file which can be retrieved directly from the controller from the zip file.
However, all three methods will provide the wire sheet memory size, number of
components, number of links as well as the application name.

TD100700-0MB

53