RC: Read configuration extension

The Read configuration extension xFB supports reading a set of parameters defined by a Config-Extension. The Config-Extension is attached to a View-Node-Object of type functional, and RC allows access to the properties of the Config-Extension. (Each Functional Unit represents a specific functionality which requires a specific parameter set.)

XFB performs the read operation only if the corresponding trigger flag indicates, that any property of the BA-Object changed. The SFC returns an indication on each property if the read was successful or not.

There are many specific RC xFBs, one each for all room and room segment application functions that have a configuration extension. For example "RC_LgtDlgtCtl01" reads the Config-Extension belonging to the Functional Unit "LgtDlgtCtl01", (Daylight lighting control 01, daylight dependent). A list of examples follows at the end of this section.

Compatible data points:

View-Node-Object of type functional

Optional properties:

Present priority
Reliability

Support data types:

Data type
REAL
BOOLEAN
UNSIGNED
INT
TIME

Note
TIME format: On the property you see 60, but on xFB output pin you see « T#1M » . the property must be in seconds; entering "0.1" would be 100 milliseconds which is not correct.

Pin description (inputs)

BaObjRef
BA-Object reference Structure [BaObjRef] defines a bound connection between XFB and BACnet object. The binding occurs automatically. Manual configuration attempts are not necessary and can result in system errors.
DeviceId	Device identifier Double word (default value: 16#3FFFFF) [DeviceId] comprises object type and object instance in a single identifier. It is used to identify device object: local or remote. Local device object could also be identified by value 16#3FFFFF.
ObjectId	Object identifier Double word (default value: 16#3FFFFF) [ObjectId] comprises object type and object instance in a single identifier. It is used to identify object within a device.
ItemId	Item identifier Integer (default value: -1) [ItemId] represents an item index in the functional view node object, which references the BACnet object. [ObjectId] and [ItemId] together define an indirect access reference to the BACnet object. Value -1 indicates that direct binding is used.

CnfExtn
CnfExtn defines the Config Extension which belongs to this XFB. The ABT Tool uses the Config Extension Identification to attach the appropriate Config-Extension to the View-Node-Object CnfExtn is an enumerated data type. CnfExtn value will be set by the system during initiation runtime setup.

CnfExtn

CnfExtn defines the Config Extension which belongs to this XFB. The ABT Tool uses the Config Extension Identification to attach the appropriate Config-Extension to the View-Node-Object

CnfExtn is an enumerated data type.
CnfExtn value will be set by the system during initiation runtime setup.

CnfExtnVers
CnfExtnVers defines the version of the Config Extension CnfExtnVers will be changed (incremented) when the Config Extension changes e.g adding / removing properties

CnfExtnVers

CnfExtnVers defines the version of the Config Extension

CnfExtnVers will be changed (incremented) when the Config Extension changes e.g adding / removing properties

Pin description (outputs)

MyPar_x
MyPar_a indicates the actual value of the referenced property of the BA-View-Node-Object. The property is defined by the Config-Extension and MyPar_x will have the equal name as the property. For each property of the Config-Extension an appropriate MyPar_x output (up to four: MyPar_a, MyPar_b, etc.) will be provided. MyPar_a is initialized according data type on startup (0.0, 0, false, 0msec, …, and ReadVld will be set to false. Right after initialization the XFB tries to read the property of the Config-Extension. MyPar_a will be set to the value of the referenced property of the Config-Extension, if the property is accessible and could be read successfully. My_Par_a will deliver its last value, in case the property cannot be accessed anymore.

MyPar_x

MyPar_a indicates the actual value of the referenced property of the BA-View-Node-Object. The property is defined by the Config-Extension and MyPar_x will have the equal name as the property.

For each property of the Config-Extension an appropriate MyPar_x output (up to four: MyPar_a, MyPar_b, etc.) will be provided.

MyPar_a is initialized according data type on startup (0.0, 0, false, 0msec, …, and ReadVld will be set to false. Right after initialization the XFB tries to read the property of the Config-Extension.
MyPar_a will be set to the value of the referenced property of the Config-Extension, if the property is accessible and could be read successfully.
My_Par_a will deliver its last value, in case the property cannot be accessed anymore.

ReadVld
Rea ReadVld indicates whether MyPar_x is valid or not ReadVld will be set to true if all properties of the Config-Extension could be read successfully. If ReadVld is false, ErrCode will indicate the respective error reason

ReadVld

Rea ReadVld indicates whether MyPar_x is valid or not

ReadVld will be set to true if all properties of the Config-Extension could be read successfully.
If ReadVld is false, ErrCode will indicate the respective error reason

ErrCode
Error code indication Integer (default value: 20) The status of the last performance of the XFB read operation.
= 0	No error.
> 0	Error, see XFB error codes.

ErrCode

Error code indication

Integer (default value: 20)

The status of the last performance of the XFB read operation.

= 0

No error.

> 0

Error, see XFB error codes.

Workflow:

The Read-Config-Extension XFB will dictate which Config Extension must be assigned to the View Node functional object. Binding takes place automatically.

The ABT reads the Config-Extension-Identification and Config-Extension-Version information provided by the XFB and attaches the appropriate Version of the Config-Extension to the View-Node-Object.

In case the ABT will find more than one Read-Config-Extension XFB, no assignment of Config- Extension will be done and an error is indicated.

XFB Config-Extension examples list

RC_CcgChw11: Chilled ceiling with chilled water 11

RC_CclChw11: Chilled water cooling coil 11

RC_CclChw12: Chilled water cooling coil 12, casc.ctrl

RC_CenBrgtWths11: Central brightness from weather station 11

RC_CenEmgShd11: Central emergency shading products 11

RC_CenFcdShd11: Central facade shading for automatic 11

RC_CenFrPrtShd11: Central frost protection shading prod.11

RC_CenGlrPrt11: Central anti-glare protection 11

RC_CenManOpShd11: Central manual operation shading 11

RC_CenPcpPrt11: Central precipitation protection 11

RC_CenPrtShd11: Central frost protection shading prod.11

RC_CenSrvShd11: Central service shading products 11

RC_CenThPrt11: Central thermal protection 11

RC_CenWdPrt11: Central wind protection 11

RC_CenWdPrt12: Central wind protection 12

RC_FcuCoo11: Fan coil unit coordination 11

RC_FcuModDtr11: Fan coil unit mode determination 11

RC_FcuTCasCtlC11: Fan coil temp.casc.control cooling 11

RC_FcuTCasCtlH11: Fan coil temp.casc.control heating 11

RC_FcuTRCtlC11: Fan coil room temp.control cooling 11

RC_FcuTRCtlH11: Fan coil room temp.control heating 11

RC_HCcg2Pipe11: Ceiling heat./chilled ceiling 2-pipe 11

RC_HCcl2Pipe11: Heating/cooling coil 2-pipe system 11

RC_HCcl2Pipe12: Heat/cool.coil 2-pipe sys.12, sply.temp.

RC_HCcl4Pipe11: Heating/cooling coil 4-pipe system 11

RC_HCcl4Pipe13: Heating/cooling coil 4-pipe system 13

RC_HcgHw11: Ceiling heating with hot water 11

RC_HclEl11: Electric heating coil 11, mod.output

RC_HclEl12: Electric heating coil 12, sply.temp.ctrl

RC_HclHw11: Hot water heating coil 11

RC_HclHw12: Hot water heat.coil 12, sply.temp.ctrl.

RC_HvacPltMod11: HVAC plant operating mode 11

RC_HvacPscMod11: HVAC presence mode 11

RC_LampOph11: Lamp operating hours 11, lifetime phase

RC_LgtBrgtSwi11: Lighting brightness switch 11

RC_LgtConstCtl11: Lighting brightness constant control 11

RC_LgtCoo11: Lighting coordination 11

RC_LgtCtlChar11: Lighting brightness control charact. 11

RC_LgtCtlMst11: Lighting brightness manager control 11

RC_LgtCtlSlv11: Lighting brightness subordinate control 11

RC_LgtLocManOp11: Lighting local manual operation 11

RC_LgtOpStrgy11: Lighting operating strategy 11

RC_LgtPscMod11: Lighting presence mode 11

RC_LgtPscOp11: Lighting presence operating 11

RC_RadEl11: Electric radiator 11, modulating

RC_RadHw11: Hot water radiator 11, mod./2-pos.ctrl.

RC_RGrnLf11: Room green leaf 11, energy efficiency

RC_ROpMod11: Room operating mode 11, with comfort

RC_Shd11: Shading 11, venetian blinds or awnings

RC_ShdClsnDet11: Shading collision detection 11

RC_ShdCoo11: Shading coordination 11

RC_ShdEngyEffcy11: Shading energy effic.11, thermal prot.

RC_ShdGlrPrt11: Shading anti-glare protection 11

RC_ShdOpStrgy11: Shading operating strategy 11

RC_ShdPscMod11: Shading presence mode 11

RC_VavCoo11: VAV coordination 11

RC_VavModDtr11: VAV mode determination 11

RC_VavSu11: Supply air VAV 11, external air flow ctr

RC_VavSu12: Supply air VAV 12, press, duct area,ctr.

RC_VavSu13: Supply air VAV 13, press, flow conv, ctr

RC_VavSu14: Supply air VAV 14, velocity,air flow ctr

RC_VavTCasCtlC11: VAV temp.cascade control cooling 11

RC_VavTCasCtlH11: VAV temp.cascade control heating 11

RC_VavTRCtlC11: VAV room temp.control cooling 11

RC_VavTRCtlH11: VAV room temp.control heating 11