Owned and operated as a joint venture by a consortium of Canadian universities via a contribution through the National Research Council Canada Propriété d’un consortium d’universités canadiennes, géré en co-entreprise à partir d’une contribution administrée par le Conseil national de recherches Canada Canada’s National Laboratory for Particle and Nuclear Physics Laboratoire national canadien pour la recherche en physique nucléaire et en physique des particules BACnet for EPICS Database Configuration Tool Rod Nussbaumer | ISAC Controls | TRIUMF

January BACnet for EPICS Database Configuration Tool Introduction BACnet produces large datasets –Not easily managed as flat-file data Synchronization between discrete components required Dedicated tool good for special tasks Looks similar, but not part of bacnet4linux HTTP interface

January BACnet for EPICS Database Configuration Tool Purpose Trim large BACnet database to useful subset Build EPICS runtime Dbs Build EPICS Operator screens –EDM (.edl format files) All elements built from common database –Aids synchronization

January BACnet for EPICS Database Configuration Tool Components Postgresql database server Apache HTTP server –Perl CGI: bacnetDb.pl –Perl helper modules: EdlBuild library –bacnetDb.css stylesheet BacnetDbCreate SQL scripts –bacnetDbCreate1.sql –bacnetDbCreate2.sql

January BACnet for EPICS Database Configuration Tool Interface Views 3 Views, somewhat hierarchical –Device List view –Device Detail (Object List) view –Administrative Info BACnet Devices are Parents of BACnet Objects BACnet Devices may be Parents of other Devices Devices may be local (routers) or remote

January BACnet for EPICS Database Configuration Tool Device-List Summary View Provides drill-down to Device detail –Device detail is collection of Objects Provides Drill-down to Admin screen Provides Top-level functions –Create XML and DB –Create EPICS Screens and Menus

January BACnet for EPICS Database Configuration Tool

January BACnet for EPICS Database Configuration Tool Device Detail (Object List) View Per BACnet device summary All BACnet objects Allows 'subscription' per object –will/won't be included in EPICS interface Builds Device-level EDM panel –Grid of Analog and Binary objects –(slide to follow)

January BACnet for EPICS Database Configuration Tool

January BACnet for EPICS Database Configuration Tool Admin Page Configure file and filesystem details Import un-distilled BACnet XML database Setup EPICS Elements

January BACnet for EPICS Database Configuration Tool

January BACnet for EPICS Database Configuration Tool Using the Tool Understanding the hierarchy –BACnet devices are two-tiered Top-tier devices are parent to other devices –Second-tier devices are parent to BACnet Objects EPICS record per Object relationship Not all Object type are EPICS-supported Not all Objects are 'interesting'

January BACnet for EPICS Database Configuration Tool Using the Device-List Page Shows All top-tier Objects –'Local' Devices Select which top-tier Devices to monitor –Toggle the 'Activate/Remove' buttons –Unsubscribed Devices 'browned out' –Unsubscribed devices excluded from EPICS and bacnet4linux runtime Drill down to Second-tier Device Object lists –Click 'Modify' button per Device

January BACnet for EPICS Database Configuration Tool Using the Object-list Page (1 of 2) Page shows all BACnet Objects that are parented by one BACnet Device Individual objects can be subscribed or unsuscribed by clicking the respective 'Subscribe/Unsubscribe' buttons Group subscription/unsubscription by Object Type –Buttons at left of screen

January BACnet for EPICS Database Configuration Tool Using the Object-list Page (2 of 2) Build an EDM panel containing all subscribed Objects –1. Enter EDM filename in text entry box –2. Click 'Write OPI Page' button –File written to configured directory (Admin Page description explains, below) Navigate up to main Device List page –Click 'Show Devices' button at top left of page

January BACnet for EPICS Database Configuration Tool Using the Admin Page (1 of 4) OPI Output Dir –Where the tool will write EDM '.edl' files EPICS DB Output Dir –Where the tool will write the EPICS runtime database '.db' file XML Output Dir –Where the tool will write XML files for use by bacnet4linux XML Source Dir –Where the tool reads full discovery XML files

January BACnet for EPICS Database Configuration Tool Using the Admin Page (2 of 4) EPICS DB Scan period –How fast the EPICS database will scan –Applied universally to all records EPICS Record prefix –A prefix that will be applied to all EPICS record names, followed by a colon –Also used in lower case to prefix all EDM files and EPICS database filename

January BACnet for EPICS Database Configuration Tool Using the Admin Page (3 of 4) XML Import –Reads full-discovery XML database –Eligible files selected from pull-down –Takes some time set up Apache server to allow slow CGIs –In httpd.conf, Timeout 300 works at TRIUMF –Attempts to remember old settings per Object No configuration 're-do's

January BACnet for EPICS Database Configuration Tool Using the Admin Page (4 of 5) Button 'Use Config' –Accepts all Text entered in Text-input fields and stores to 'config' database table Button 'Dismiss' –Return to Device-List page without saving Button 'Reset' –Reloads original values into all fields IPCMSG/BACNET Device Support Index –Lowest Index number to use in the EPICS device support address fields (value positive, arbitrary)

January BACnet for EPICS Database Configuration Tool A Peek Under the Hood All implemented in Perl as CGI Postgresql backend database Uses TRIUMF supported EdlBuild Perl modules –Default TRIUMF Look&Feel –Easily locally configurable Old database tables copied to date- stamped backups

January BACnet for EPICS Database Configuration Tool Installation and Setup Install Apache webserver –Configure for long timeouts of CGI processes (3-5 minutes) –Note Apache user ID (for Postgresql access) # # Timeout: The number of seconds before # receives and sends time out. timeout 300 Copy Perl code to cgi-bin/ –bacnetDb.pl, BACnet/*.pm, Copy bacnetDb.css to html/

January BACnet for EPICS Database Configuration Tool Installation and Setup Install Postgresql –Use 'bacnetDbCreate1.sql' and 'bacnetDbCreate2.sql' to initialize database First, edit to create desired database name, and database user name (from apache setup) Start 'psql', and do – '\i bacnetDbCreate1.sql' – '\c yourdatabasename' – '\i bacnetDbCreate2.sql'

January BACnet for EPICS Database Configuration Tool Postgresql Setup Edit database name

January BACnet for EPICS Database Configuration Tool Postgresql Setup Edit user id

January BACnet for EPICS Database Configuration Tool Run Attach web browser to URL: –

January BACnet for EPICS Database Configuration Tool Using psql It is possible to use Postgresql console 'psql' tool to configure database –Faster than many point & click iterations –Requires some SQL knowledge –Requires some understanding of the underlying database 3 tables model BACnet hierarchy –devices, objects, properties 'config' table for Admin purposes

January BACnet for EPICS Database Configuration Tool Example psql session bacnet001=# bacnet001=# UPDATE devices SET use = 't' where id = 700; UPDATE 1 bacnet001=# UPDATE devices SET use = 't' where id = 600; UPDATE 1 bacnet001=# UPDATE objects SET subscribe = 't' where type = 0; UPDATE 429 bacnet001=# UPDATE objects SET subscribe = 't' where type = 1; UPDATE 72 bacnet001=# UPDATE objects SET subscribe = 't' where type = 3; UPDATE 51 bacnet001=# UPDATE objects SET subscribe = 't' where type = 4; UPDATE 301 bacnet001=# UPDATE objects SET subscribe = 't' where name like '%SETPOINT%'; UPDATE 0 bacnet001=# UPDATE objects SET subscribe = 't' where name like '%Setpoint%'; UPDATE 250 bacnet001=#

4004 Wesbrook Mall | Vancouver BC | Canada V6T 2A3 | Tel | Fax | Thank You! Merci!