Note: Make sure the tags are the right kind. I.e.. A numeric tag will not take a temperature & a dateTime tag is needed for a sunrise or sunset time. - User Guide
System Integrator Apps Desigo Optic User Guide
Product Family
Desigo Optic
Content Language
English
Content Type
,Technical Manual,Technical Manual,"Technical manual, complete" > User Guide
Document No
A6V11890771_en--_e
Download ID
A6V11890771
Access level
Internet
File Type
html
Edition notice
Copyright
Cybersecurity disclaimer
DB Builder
The DB Builder App (FIN)
Find the DB Builder App
DB Builder Features
A. Select Tree Menu
Edit the Select Tree View
B. Available Trees
C. Available Trees Tools Menu
Add an Item
Delete an Item
Edit an Item
Open the Available Trees Tools Menu
D. Grid Settings
Adjust the Grid View
E. Grid View Results
Display the Property Editor
F. Grid Tools Menu
DB Builder Trees (FIN) (identical)
DB Builder Trees
Equip Tree
Equip Tree
Equip Tree Navigation: Main View
Navigate to Sites, Floors, Equips, Points, Connectors, and Tuning Policy
Select Records
Add a Record
Edit a Record
Duplicate a Record
Delete a Record
Display Tools
Download a Record
Filter Data
Adjust Number of Records Per Page
Equip Tree Navigation: Available Trees View
Essentials Tab
Site Essentials and Equip Essentials
Point Essentials
Add Tags
Delete Tags
Edit Fields
Collect or Suspend Collection of Read, Write, Schedule, or History Data (Point Essentials only)
Grid View
Change Column Properties in the Grid View
Graphics Tree
Graphics Tree
Graphics Tree Window (List View)
Graphics Tree Window (Grid View)
Edit a Graphic
Delete a Graphic
Make Graphic a Default
Remove Default Status from a Graphic
Batch Tags
Copy Data From a Graphic
Delete Records
Edit GraphicOn
See Locations Where a Graphic is Used
Programs Tree
View a List of Programs
View a Program
View a Program's Variables
View Tasks
Add a Program
Edit a Program
Edit the Displayed Name
Edit the Description
Edit the programOn Filter of a Program
Delete a Program
Connectors Tree
BACnet Connector
Discover & Add BACnet Connector
Discover & Add Points
Sync Schedule Type
Discovery Filters
Time Stamp
Discover Settings
Connector Tools
Add
Edit
Delete
Clone
Ping
Debug
Enable/Disable
Write Level
BACnet Global Config
Foreign Device Setup
BBMD Setup
Point Types and Supported Objects and Properties
Other Details
Setting BBS Manually
Setting BBS Logging
BACnet Connector Details
Intro
Objects
Properties
Differences
BACnet Connector Client
BACnet Server
BACnet Protocol Revision 1.18 Update
Network Port
Register Optic as BBMD
Unregister Optic as BBMD
Register Optic as FD
Unregister Optic as FD
Read Network Port Properties
Write Network Port Properties
The Fallback mechanism
Write Network Port properties using any BACnet client
Apply Changes-Pending
Client Restart Query
Haystack Connector
Add Haystack Connector
Delete Haystack Connector
Modbus Connector
Modbus
Using Modbus
Create Modbus Connector
Create Register Map
Creating Register Map Manually
Uploading Register Map
Deleting Register Map
Adding New Registers
Editing Registers
Deleting Registers
Editing Register Maps via Edit Source
Viewing or Discovering Points
Adding Points to DB
Adding Points using Add Button
Backup Modbus Register Maps
Restoring Modbus Register Map
How to Read Modbus
Supported Protocols
Further information on Modbus RTU over RS-485
Example Register Map Formats for Uploading
History
Modbus on F200
KNX Connector
Overview
Current support
Importing an ETS project (*.knxproj)
Importing an ETS project (*.knxproj)
Creating a KNX connector
Learning data points from an imported *.knxproj
Translating KNX DPTs into Haystack types
Specifying the DPT
Units
Custom units
Add
Existing Unit
Custom Unit
Reading and Writing
Tuning
MQTT Connector
Overview
Prerequisites
Creating a MQTT connector
Adding data points
Examples
Schedules Tree
View List of Schedules in the Project
View Points Assigned to a Schedule
Reassign Points Between Schedules
Create a New Schedule
Edit Schedule
Delete Schedule
Find and Assign Unassigned Points
Unlink a Point from a Schedule
Change the Priority of the Schedule
Clones Tree
Clones Tree
Mass Edit Tags
Jobs Tree
Jobs
Using Jobs
New Job/Add
Delete
Edit
New Folder
Job Logs
Run
Enable
Disable
Grid View Results
Relationships Tree
Relationships Tree
Add Relationship
Find Unassigned Children
Edit Relationship
Saved Filters Tree
Saved Filters Tree
Display Saved Filter Results
Add Saved Filter
Delete Saved Filter
Edit Saved Filter
Tag Bundles Tree
Tag Bundles Tree
To View Tag Bundle Results
Add Tag Bundles
Delete Tag Bundles
Edit Tag Bundles
Templates Tree
Templates Tree
Add a Template
Edit a Template
Delete a Template
Restore a Template
Download a Template
Tuning Policy Tree
Tuning Policy Tree
Tuning Policy Tree
Create a Tuning Policy
Assigning Tuning Policy to a Connector
Editing a Tuning Policy
Deleting a Tuning Policy
Tuning Policy Tools
Create/Edit a Tuning Policy
Assigning Tuning Policy to a Connector
FIN Network Tree
FIN Network
Enabling FinNetwork extension
Adding a Haystack connector
Drag & Drop
Example - Copy
Example - Move
Example - archivedRefs
FIN Network Overview
Sync Users & Groups
Blacklisted items in FIN Network Tree
Settings Tree
Extension
Settings Tree
Location
Snapshots Tree
Snapshots Tree
Making a snapshot
Backing up a snapshot
Restoring a snapshot
Delete a snapshot
Convert to Local Snapshot
Uploading snapshot to the cloud manually (DB Builder)
Uploading snapshot to the cloud manually (Folio)
Automate snapshots to the cloud
Edge2Cloud Backups Location
Topics Tree
Create Alarm Topic
Create Alarm Topic
How to use Create Alarm Topic
How to view and/or edit an Alarm Topic manually
Create Note Topic
Create Note Topic
How to use Create Note Topic
Edit a Topic
Delete a Topic
Topics Tree Window (Grid View)
KNX IP Communication Types
KNX IP Com Configuration: Tunneling
KNX IP Com Configuration: Multicast
Property Editor
Functions
Adding tags
Removing Tags
Modifying Tags
Copy Tags
Point Property Sheet for DB Builder App
Basic Point Configuration
Display Settings and Identification
Point Characteristics
Connectivity and Data Source
Historical Data Management
Tools and Utilities
Action Management
Scheduling Level Adjustment
FIN Stack Specific Features
Visual Aids and References
Local Point
Connected Point
Scheduled (FIN)
Enable Schedule
Scheduled Level
Adding a BACnet Connector
CurConvert Options
Point Debug Info
Connector Default Write Level
Removing the write level
Recommended configurations
Graphics Builder
Getting to the Graphics Builder App
Launch
New
Graphics
Existing Graphics: Edit/Points/GraphicOn/Delete
Graphics Builder App
Graphics Builder Menus
Builder Edit Menu (Right)
Animation Editor
Magic Buttons
Virtual Points
Builder Pane Menus (Left)
Clean Virtual Points
Builder Right-Click Menu
Status BG Colors
Builder Tabs (Bottom)
Builder Tools Menu (Top)
Backup and Restore Graphic
Create a New Graphic
Creating an Equip Graphic
Creating a Floorplan Graphic
Floorplan Legend Tips
Floorplan Using Equip Description
Creating a Site Graphic
Creating a Template Graphic
FIN Chart Components (finAmChartComponents)
Configure Dashboard Component
Configure Dashboard Component Points
Configure Dashboard Component History
FIN Gauge Components (finSvgGaugesReact)
Bar Gauges
Circle Gauges
Half Circle Gauges
Icon Gauges
SVG Misc Category Gauges
Weather Gauges
Tag Type
Top Level Graphic
Logic Builder
Logic Builder App
Workspace
Tabs
Routine Settings
Macro Block Settings
Sidepanel
Title bar
Variables/Routines
Block Library
useUnits for numeric evaluations
User interface
Logic Builder Menu
New Program
View Programs
Add Variables
Logic Builder Blocks
Start Routine
Program Variable Blocks
Number Blocks
Boolean Blocks
String Blocks
Time/Date Blocks
Macro Blocks
Built in blocks
Commands
Control Flow
Expression
Language
Logical
Math
Others
Strings
Time
Weather
Macros
Threshold Block
AboveBy and BelowBy Blocks
CondDelay Block
Alarm Block Properties
Alarm block
Overview
Compare Blocks
Overview
Weather Block
Note: Make sure the tags are the right kind. I.e.. A numeric tag will not take a temperature & a dateTime tag is needed for a sunrise or sunset time.
Macro and Expression Blocks
Math Blocks
avg
div
isEven
isOdd
max
min
modulo
mult
Mult Block
Properties
How to use
Example
neg
sineWave
sineWave Block
sineWave Block
Using the sineWave Block
cosineWave Block
cosineWave Block
Using the cosineWave Block
sub
threshold
aboveBy
abs
belowBy
limit
pow
random
reset
sqrt
within
isType Block
isType Block
Using the isType Block
Date, Time, Day blocks
Date, Time, Time Add and Subtract, and Time Conversion Blocks
Date and Time Blocks
Time Add and Subtract Blocks
Time Conversion Blocks
Usage Examples
Parking Lot Lights
Email block
Overview
If Block
Overview
General
Overview
Link ports
Links
Logic links
Condition Links
Flow Gates
Comments
Sub Block
Sub Block
Properties
How to use
Example
LeadLag
LeadLag
Using the LeadLag block
Staging Block
Staging Block
Staging Block Properties
Staging Block Example
DewPoint Block
AmountOfHeat Block
DeltaAmountOfHeat Block
ThermalOutput Block
HistoryValue Block
UpAndDownCounter Block
RuntimeCounter Block
Enthalpy Block
AnalogToDigital and DigitalToAnalog Blocks
OnHolder Block
RecordMaxValue and RecordMinValue Blocks
PID Block
Examples
And Block
And Block
Getting the And Block
And Block Usage Example
State Machine
Workflow
Programming enum points
Logic Builder Examples
Basic Alarm - (Temp Overheat)
15 minutes delay
Alternate value weekly
Setting Point Value Before Schedule Time
Creating a Count Down
Compressor Staging
How to call a axon function via logicBuilder using invoke block
Executing an Axon query based on some value
Trigger alarm based on value change
Value mismatch
Find out if date is within date range period
Master Schedule
Delay and Advance Schedule Control
Days Passed
Unit Staging Type 1
Unit Staging Type 2
Option 1
Option 2
Option 3
Capturing Schedule Time
Heating and Cooling Degree Days with weatherRefs
Bundle
Bundle
How to create a Bundle
Using the bundle for result output
Quick rundown
Examples
Example of getting the average/min/max value
Example of getting the total count value
Example of getting the total value
Example of getting the count of a certain value
Example of getting the if any/all value
Re-usable Expression Blocks
Description
Example
Alarm Boolean Point Program
Alarm Numeric Point Program
Adjusting a Program Variable's 'Write Level'
Alarm Routine
Alarm Routine
Steps
Custom Email Format
Custom Email Format
Example
Html Editor
String Command
Email
Execute Logic Based on Time
Table of Contents
Description
Block Example
Code Block Example
Connector Status
Connector Status
ConnStatus via Custom Point
ConnStatus via Equip or Site
Haystack Device Status
Logic Builder Troubleshooting
Logic Builder Troubleshooting
How to find error
To find routine errors
To find program errors
To find variable errors
Issue 1: Routine Error
Issue 2: Program Error
Issue 3: Variable Error
controlExt::VarBindingErr
haystack::UnknownRecErr
folio::CommitErr: Cannot update persistent tag transiently
multipleBindingMatches
Error Parsing Program / Default Red 'Run' block missing
Summary Builder
Summary Builder
Using Summary Builder
Summaries
Template Wizard
Using Pre-Configured Siemens Templates
Creating connectors
Creating a database from templates
Deleting faulty points
Updating Bacnet Cur from Tag
Templates
Global DXR Template Notes
Pre-loaded Application Options
Additional Applications
Global PXC Template Notes
MD-xxHD Meter Template Notes
New FLN Applications and Device Support
RDY2000BN Thermostat Applications (Version 2.6.1.0)
DXR2.E / DXR2.M Applications
Chilled Beam Controller Apps (Version 2.6.1.0)
Heat Pump Controller Apps (Version 2.6.1.2)
VAV Controller Apps (Version 2.6.1.2)
FCU Controller Apps (Version 2.6.1.2)
List of Application Subpoints
Appendix: Siemens Specific Templates
List of Global Applications
Template Names
FIN Reports
Managing Tenants
Adding a new tenant
Selecting a trigger point
Editing a tenant
Managing Property Managers
Adding a new property manager
Editing a property manager
Note: Make sure the tags are the right kind. I.e.. A numeric tag will not take a temperature & a dateTime tag is needed for a sunrise or sunset time.