Point Property Sheet
Any new point created in the FIN Framework - DB builder app is going to have about the same properties (with the exception of the type-specific ones):
- 1 navName & Type
- 2 disMacro
- 3 Point Kind
- 4 Scheduled
- 4.1 Enable Schedule
- 4.2 Schedule Level
- 5 Is Local/Connected Point
- 6 Read
- 7 Is Writable
- 8 History
- 8.1 Synchronized
- 8.2 Collected
- 8.3 Imported
- 8.4 Computed
- 9 Marker Tags
- 10 Property Tags
- 11 Essentials Icons
- 11.1 Property Editor
- 11.2 Tools
- 11.3 Point Debug Info
- 11.4 Show Trend
- 11.5 Actions
navName & Type
The navName is essentially the name of the Point and how it will appear in the Equip Tree. The navName will be set in the first field.
The next field, called Point-Type, will allow the user to choose if the point is a: sensor, softpoint (setpoint), or a command.
disMacro
The disMacro is used to tell the software how to create the dis. (short for display name) The display name of the point is a way to see the point as more than just the point name and could include the Site name and Equip name. Using special codes, the framework will build the dis based on how the user defines those codes, and it is set by default using this scheme: $equipRef $navName.
The default value can be changed by selecting on the text-field
Point Kind
The point kind property enables the user to choose the kind of point to add:
numeric
boolean
string
enumeration
To do so, the user will simply choose the desired option from the drop-down.
Scheduled
This property allows the user to set the point to be scheduled and choose at what level will the schedule write. Points have to be set to scheduled to be controlled by an internal FIN schedule.
Enable Schedule
To enable this, the user will:
Click on the toggle bar to make the schedule active
Once activated, select on the Save button located on the bottom right
Advanced View
Basic View
Schedule Level
If the user wants to change the schedule level, they will need to:
Advanced View
Make sure that the advanced view has been activated
The user will select on the text-box for Schedulable, where they can change the schedule level
Once changed, they will need to select on the Save button located on the bottom right
Basic View
Select on the information icon , this will open a pop-up window
The user will navigate to the property tag called schedulables
In there, they can change the level number by selecting on the text-field
Once changed, they will need to select on the Apply button on the bottom right of the pop-up window
Is Local/Connected Point
Depending on how we are creating the point, it can either be a local(doesn't get data from an actual device) or connected point(meaning from an actual device).
Usually, the connected points are created by dragging and dropping the points from the connector inside the DB builder and not by manually making a point and creating the references to the connector.
Local Point
If the point is local then it will display only:
site ref: this represents a reference to the site under which the point is located
equip ref: this represents a reference to the equip under which the point is located
Connected Point
If the point is connected beside the site and equip ref, there is going to be:
Connector Ref: this represents a reference to the connector under which the point is located (depending on protocol type, this tag could be
bacnetConnRef,modbusConnRef,haystackConnRef, etc.)Cur Path: this represents a reference to the point location from where the current value will be taken (depending on protocol type, this tag could be
bacnetCur,modbusCur,haystackCur, etc.)Write Path: (if writable) this represents a reference to the point location from where the current value will be written (depending on protocol type, this tag could be
bacnetWrite,modbusWrite,haystackWrite, etc.)
curTracksWrite marker tag
When configured on a point, curVal automatically tracks changes to writeVal and curStatus is set to "ok". Never use this tag on connected points, as this can bring to malfunctioning and read/write mismatches on “slow” connectors.
Read
The toggle bar is activated by default, and it enables the point to have a current value.
Advanced View
The curConvert would be activated if the point is a connected point and not a local point
Basic View
Is Writable
This option allows the user to make the point writable or not. By default, the write level is 17.
Advanced View
Basic View
Once this option is enabled, the actions menu in the top right corner will become enabled.
Enabling a Point Action
After an action is used, the writeLevel will be updated to the corresponding write level of the action selected (either manual or emergency).
For Example: The user is using the Manual Set, this will set the write level to 8.
Advanced View
If the user selected on the writeArray option, they are able to see more information in regard to the action the user selected. They will be displayed with the value, who set the action, and when the action expires
Basic View
History
For advanced use of axon functions for history manipulation, see https://finproducts.atlassian.net/wiki/spaces/FINFramework/pages/32727531695