BACnetSetClientDeviceCommunication (FUN) ¶ FUNCTION BACnetSetClientDeviceCommunication : IEC_BACNET_STATUS Enables or disables communication in the advanced BACnet client API to devices. The user application can enable or disable communication to registered devices. If communication is disabled to one or ALL devices, the connection state change callback will be called for all customers which have registerd that callback for the device. If a new device is registered it’s communication state is initially enabled by default. InOut: Scope Name Type Comment Return BACnetSetClientDeviceCommunication IEC_BACNET_STATUS Input devId IEC_BACNET_INST_NUMBER The device instance number for which communication needs to be changed. A value of 0xFFFFFFFF will change the state of ALL registered devices including the global communication enable / disable state. dccValue IEC_BACNET_DCC_VALUE Specifies if communication should be enabled ( DCC_ENABLE ) or disabled ( DCC_DISABLE or DCC_OFFLINE )
BACnetSetClientDeviceFixAddress (FUN) ¶ FUNCTION BACnetSetClientDeviceFixAddress : IEC_BACNET_STATUS Registers a fix MAC address for communication with the advanced BACnet client API. The user application can register a fix MAC address for communication to an remote BACnet device instead of using dynamic address binding which is the default for this API. InOut: Scope Name Type Comment Return BACnetSetClientDeviceFixAddress IEC_BACNET_STATUS Input devId IEC_BACNET_INST_NUMBER The device instance number for which a fix MAC address shall be registered. pAddress POINTER TO IEC_BACNET_ADDRESS A pointer to a valid MAC address structure which contains the network address under which the given device instance number is reachable. To go back to dynamic address binding this parameter shall be NULL.
BACnetSetClientDeviceFixSubscribeCovTime (FUN) ¶ FUNCTION BACnetSetClientDeviceFixSubscribeCovTime : IEC_BACNET_STATUS Function sets or deletes an fix daily timepoint for sending resubscribes instead of using an configured intervall. This Function sets or deletes an fix daily timepoint for sending resubscribes instead of using an configured intervall. Main use of this function is to be able to separate resubscribe attempts for devices so that the will not be sent at the same time as this would happen if using the same intervall for many registered objects in different devices which could put heavy traffinc on the network. InOut: Scope Name Type Comment Return BACnetSetClientDeviceFixSubscribeCovTime IEC_BACNET_STATUS Input devId IEC_BACNET_INST_NUMBER The device instance number for which an fixed timepoint for sending COV/COVP resubscribe requests shall be set or deleted. pSubscribeTime POINTER TO IEC_BACNET_TIME A pointer to an BACnet time structure containing the timepoint for fixed sending of the COV/COVP resubscribe requests. A NULL pointer removes the fix timepoint and reverts using given intervalls configured with function BACnetRegisterClientDataPoint .
BACnetSetClientGlobalCommTimingParameters (FUN) ¶ FUNCTION BACnetSetClientGlobalCommTimingParameters : IEC_BACNET_STATUS Sets the global communication parameters of the advanced client API. This function gives a user application the ability to configure the used APDU timings for communication with remote BACnet devices. During connection establishment the APDU parameters are read from the remote BACnet devices and used. But in some cases it might be useful TO override those parameters. To remove the global timing parameters and use the dynamically assigned ones again set nTimeout, nSegmentTimeout AND nRetryCount TO -1. To disable the periodic alive check set nAliveCheckInterval to 0. InOut: Scope Name Type Comment Return BACnetSetClientGlobalCommTimingParameters IEC_BACNET_STATUS Input nTimeout IEC_BACNET_UNSIGNED This is the APDU timeout in milliseconds (see |BACNET_APDU_PROPERTIES| for further information to this paramter). nSegmentTimeout IEC_BACNET_UNSIGNED This is the APDU segment timeout in milliseconds (see |BACNET_APDU_PROPERTIES| for further information to this paramter). nRetryCount IEC_BACNET_UNSIGNED This is the APDU retry count (see | BACNET_APDU_PROPERTIES|for further information to this paramter). nAliveCheckInterval IEC_BACNET_UNSIGNED This is the alive check interval in milliseconds in which periodical requests are sent to devices to check if they are still alive. If this is set to 0 no alive check will be performed at all. nErrorAliveCheckInterval IEC_BACNET_UNSIGNED In case of an detected communication failure this value is used as the timer trying to establish communication again. bReportErrors IEC_BACNET_BOOLEAN If set to True special error checking will take place on reception of COV, COVP and event notifications. If the API receives an notification for an device object property reference which is not registered by any customer it will reply an error to the sender of the notification. If set to False those notifications will be positiv acknowledged. bExtendedDeviceInfo IEC_BACNET_BOOLEAN If set to True extended device information will be read on connection establishment and provided to the user application in the IEC_BACNET_REMOTE_DEVICE_CAPS structure. bNoUseOfRPM IEC_BACNET_BOOLEAN If set to True the polling of all registered object properties will be made using the ReadProperty service and not the ReadPropertyMultiple service event if the corresponding device supports this service.
BACnetSetClientGlobalMaxDeviceActions (FUN) ¶ FUNCTION BACnetSetClientGlobalMaxDeviceActions : IEC_BACNET_STATUS Sets the maximum pending requests per registered device. This function gives a user application the ability to restrict the maximum pending requests to one device. The advanced BACnet client API uses asynchronous requests for communication to devices. So it is able to send multiple requests to one device at the same time. As soon as the device responses, an new request will be sent as long as there are any requests in the queue for that device. InOut: Scope Name Type Comment Return BACnetSetClientGlobalMaxDeviceActions IEC_BACNET_STATUS Input nMaxActionsPerDevice IEC_BACNET_UNSIGNED Number of maximum pending requests per registered device. Valid ranges are values from 2 till 250. The default on registration is 40 for a new device. nMaxRpmItemCounts IEC_BACNET_UNSIGNED Number of maximum object items or property items in one ReadPropertyMultiple request sent to an device. The default is 100 items. Valid range values from 10 to 500 items.
BACnetUnregisterClientDataPoint (FUN) ¶ FUNCTION BACnetUnregisterClientDataPoint : IEC_BACNET_STATUS Releases an device object property reference from data acquisation. The user application can remove device object property references from data acquisation which it doesn’t need anymore. If the user application has registered an callback for unsubscribe completion, it will get notified about the successful or unsuccessful unsubscription asynchronously. Returns: BACNET_STATUS BACNET_STATUS_BUSY: if unsubscription is pending. The registered unsubscribe-complete callback will be called on completion to indicate that unregistration has been completed. BACNET_STATUS_OK: unsubscription completed. The registered unsubscribe-complete callback WILL NOT BE CALLED because other customers have an active registration on the same reference OR the data is retrieved by polling using read property or read property multiple. OTHER: some other failure in given parameters has been detected InOut: Scope Name Type Comment Return BACnetUnregisterClientDataPoint IEC_BACNET_STATUS Input hCustomer IEC_BACNET_HANDLE An handle to an created advanced BACnet client customer created by BACnetOpenClientCustomer . devId IEC_BACNET_INST_NUMBER The device instance number from the remote or local device from which the value shall not be acquired anymore. pObjId POINTER TO IEC_BACNET_OBJECT_ID A pointer to the object identifier from the remote or local object from which the value shall not be acquired anymore. propId IEC_BACNET_PROPERTY_ID The property identifier from which the value shall not be acquired anymore. index IEC_BACNET_ARRAY_INDEX The property array index from which the value shall not be acquired anymore. If the property is not an array the value shall be BACNET_VOID_INDEX (-1) If the property is an array and the whole array should be acquired the value BACNET_ENTIRE_ARRAY (-1) shall be used here. bClockAlignedPolling IEC_BACNET_BOOLEAN If set to True the acquisation will be stopped for the clock aligned registered reference. If set to False the NON clock aligned reference will be removed. bForceUnsubscribe IEC_BACNET_BOOLEAN If set to True the unsubscription will be executed with nininmal delay instead of waiting for the next device alive check or waiting for new registrations.
BACnetUnregisterClientEventNotification (FUN) ¶ FUNCTION BACnetUnregisterClientEventNotification : IEC_BACNET_STATUS Releases an device notification class reference from event acquisation. The user application can remove device notification class references from event acquisation which it doesn’t need anymore. If the user application has registered an callback for unsubscribe completion, it will get notified about the successful or unsuccessful unsubscription asynchronously. Returns BACNET_STATUS_BUSY: if unsubscription is pending. The registered unsubscribe-complete callback will be called on completion BACNET_STATUS_OK: unsubscription completed. The registered unsubscribe-complete callback WILL NOT BE CALLED OTHER: some other failure in given parameters has been detected InOut: Scope Name Type Comment Return BACnetUnregisterClientEventNotification IEC_BACNET_STATUS Input hCustomer IEC_BACNET_HANDLE An handle to an created advanced BACnet client customer created by BACnetOpenClientCustomer . devId IEC_BACNET_INST_NUMBER The device instance number from the remote or local device from which the events or alarms shall NOT be acquired anymore. notifClass IEC_BACNET_INST_NUMBER The notification class object instance number from the remote or local device from which the events or alarms shall NOT be acquired anymore.
File and Project Information ¶ Scope Name Type Content FileHeader creationDateTime date 01.04.2022, 08:11:46 companyName string 3S-Smart Software Solutions GmbH libraryFile CmpBACnet.library primaryProject True productName CODESYS productProfile CODESYS V3.5 SP16 Patch 3 contentFile CmpBACnet.clean.json version version 2.0.0.0 ProjectInformation Released bool True LastModificationDateTime date 01.04.2022, 08:11:46 LibraryCategories library-category-list System|SysLibs Author string 3S - Smart Software Solutions GmbH Company 3S - Smart Software Solutions GmbH CompiledLibraryCompatibilityVersion CODESYS V3.5 SP16 DefaultNamespace CmpBACnet Description See: Description DocFormat reStructuredText LanguageModelAttribute qualified-access-only Placeholder CmpBACnet Project CmpBACnet Title CmpBACnet Version version 3.5.18.0
Library Reference ¶ This is a dictionary of all referenced libraries and their name spaces. 3SLicense ¶ Library Identification ¶ Placeholder: 3SLicense Default Resolution: 3SLicense, * (3S - Smart Software Solutions GmbH) Namespace: _3S_LICENSE Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: 3SLicense CAA Ressource Manager Extern ¶ Library Identification ¶ Placeholder: CAA ResMan Default Resolution: CAA Ressource Manager Extern, * (CAA Technical Workgroup) Namespace: RSM Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA ResMan CAA Types Extern ¶ Library Identification ¶ Placeholder: CAA Types Default Resolution: CAA Types Extern, * (CAA Technical Workgroup) Namespace: CAA Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA Types CmpErrors2 Interfaces ¶ Library Identification ¶ Name: CmpErrors2 Interfaces Version: newest Company: System Namespace: CmpErrors Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpErrors2 Interfaces, * (System) CmpEventMgr ¶ Library Identification ¶ Placeholder: CmpEventMgr Default Resolution: CmpEventMgr, * (System) Namespace: CmpEventMgr Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpEventMgr CmpLog ¶ Library Identification ¶ Placeholder: CmpLog Default Resolution: CmpLog, * (System) Namespace: CmpLog Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpLog CmpSettings ¶ Library Identification ¶ Placeholder: CmpSettings Default Resolution: CmpSettings, * (System) Namespace: CmpSettings Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpSettings Component Manager ¶ Library Identification ¶ Placeholder: Component Manager Default Resolution: Component Manager, * (System) Namespace: Component_Manager Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Component Manager IoStandard ¶ Library Identification ¶ Placeholder: IoStandard Default Resolution: IoStandard, * (System) Namespace: IoStandard Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: IoStandard Standard ¶ Library Identification ¶ Placeholder: Standard Default Resolution: Standard, * (System) Namespace: Standard Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Standard SysMem ¶ Library Identification ¶ Placeholder: SysMem Default Resolution: SysMem, * (System) Namespace: SysMem Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysMem SysTarget ¶ Library Identification ¶ Placeholder: SysTarget Default Resolution: SysTarget, * (System) Namespace: SysTarget Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTarget SysTask ¶ Library Identification ¶ Placeholder: SysTask Default Resolution: SysTask, * (System) Namespace: SysTask Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTask SysTypes2 Interfaces ¶ Library Identification ¶ Name: SysTypes2 Interfaces Version: newest Company: System Namespace: SysTypes Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTypes2 Interfaces, * (System)
CmpBinTagUtilIec Library Documentation ¶ Company System Title CmpBinTagUtilIec Version 3.5.17.0 Categories System|SysLibs Author 3S - Smart Software Solutions GmbH Placeholder CmpBinTagUtilIec Description 1 ¶ This Library contains wrapper functions for the communication services on layer7. These functions can be used to create or read requests on layer7 of the Codesys protocol. Contents: ¶ BTagAlignment (Struct) BTagAlignments (GVL) BTagElementType (Enum) BTagSwapHeader (Function) Reader BTagReaderCreate (Function) BTagReaderCreateDynamic (Function) BTagReaderDestroy (Function) BTagReaderGetComplexContent (Function) BTagReaderGetContent (Function) BTagReaderGetString (Function) BTagReaderGetTagId (Function) BTagReaderGetTagLen (Function) BTagReaderInit (Function) BTagReaderIsDataTag (Function) BTagReaderMoveNext (Function) BTagReaderPeekNext (Function) BTagReaderSkipContent (Function) ReturnValues (GVL) Test Test_Prg (Program) Testcases (Enum) Writer BTagWriterAppendBlob (Function) BTagWriterAppendDummyBytes (Function) BTagWriterAppendFillBytes (Function) BTagWriterAppendRaw (Function) BTagWriterAppendWString (Function) BTagWriterCreate (Function) BTagWriterCreateDynamic (Function) BTagWriterCreateSavePoint (Function) BTagWriterCreateSavePointDynamic (Function) BTagWriterDestroy (Function) BTagWriterDestroySavePoint (Function) BTagWriterEndTag (Function) BTagWriterFinish (Function) BTagWriterInit (Function) BTagWriterInit2 (Function) BTagWriterRestoreSavePoint (Function) BTagWriterStartTag (Function) BTagWriterSwitchBuffer (Function) Indices and tables ¶ 1 Based on CmpBinTagUtilIec.library, last modified 20.04.2021, 15:36:27. LibDoc 4.4.0.0-b.27 The content file CmpBinTagUtilIec.clean.json was generated with CODESYS V3.5 SP16 Patch 3 on 20.04.2021, 15:36:27.