06 ServiceProvider ¶ This folder provides the function block for the SNC service provider which combines the SNC service handler and the list of F-SPS registered for the SNC service. The service provider creates its own SNC logger, too. SncServiceProvider (FunctionBlock) NumOfHandledServices (Property) SimulateServiceRequest (Method)
SncServiceProvider (FB) ¶ FUNCTION_BLOCK FINAL SncServiceProvider EXTENDS SncServiceProviderBase Function block for a new service provider for handling the SNC services addressed to its connected F-SPS’s - extends the base class ‘SncServiceProviderBase’ - handles the F-SPS bus drivers which are registered for the SNC services, in a linked list adds drivers to the list (Register), removes drivers from the list (Unregister) and searches for certain members in this list (GetBusSpecifiDataHandler) does the registering of its linked SNC service handler to the RTS service handler and starts its own SNC logger Properties: NumOfHandledServices Methods: SimulateServiceRequest Structure: NumOfHandledServices (Property) SimulateServiceRequest (Method)
07 Logger ¶ This folder provides the function block for creating a new SNC logger and add log entries to this logger. The log messages are shown in the communication settings, folder ‘Log’ if the logger is selected to ‘SncLogger’ in the logger’s drop down menue. If additional log messages are wanted you have to set the compiler defines to ‘SNC_DEBUG_LOG’ (application properties, folder ‘Build’).
GlobalConstants ¶ GCL (GVL)
GCL (GVL) ¶ Global constants for the SubNode Communication Manager Attributes: qualified_only InOut: Scope Name Type Initial Comment Constant CMP_NAME STRING ‘CmpSubNodeCommMgr’ component name CMP_VERSION UDINT 16#3050400 component version LOGGER_NAME STRING ‘SncLogger’ name of the logger ETCBUS_NAME STRING ‘<ETC>’ string for logging messages SHMBUS_NAME STRING ‘<SHM>’ SERVICEGROUP WORD 16#1C service group number for registering to the RTS service handler SERVICEREPLY WORD 16#9C service reply to this group number CMD_INVALID WORD 16#0 Commands CMD_CHECKSUBNODE WORD 16#1 service to check if a connected F-SPS physically exists CMD_TRANSMITSVC WORD 16#2 service to transfer a service request to the given F-SPS GRT_ERROR WORD 16#FF7F tag for the service handler errors in the reply GRT_EXTERR_INFO WORD 16#FF7E not used GRT_USER_NOTIFY WORD 16#FF7D not used GRT_SVC_RESULT WORD 16#1 not used TAG_CHECKSUBNODE_ACK WORD 16#81 overall tag for the answer to the ‘CheckSubnode’ command TAG_TRANSMITSVC_ACK WORD 16#82 overall tag for the answer to the ‘TransmitSvc’ command TAG_BUSDRVID WORD 16#1 tag for the bus type of the connected F-SPS TAG_ALIVE WORD 16#2 tag for flag if the F-SPS is alive or not TAG_ADDRESS WORD 16#3 tag for the address of a scanned F-SPS or of the transfered safety service TAG_DRVERROR WORD 16#4 tag for the reply errors returned by the bus specific data handler TAG_SFSVC_LENGTH WORD 16#5 tag for the length of the transfered safety service TAG_SFSVC_DATA WORD 16#6 tag for the data of the transfered safety service TAG_ERROR WORD 16#7 tag for an error which occurred while handling a service ERR_OK WORD 16#0 success ERR_DRVNOTREGISTERED WORD 16#1 set if a given F-SPS bus driver is not registered to the SNC service provider ERR_SFSVC_SIZEMISMATCH WORD 16#2 set if the length of the transfered safety service doesn’t match with the received size ERR_BUFF_NOTSYNCD WORD 16#3 set if the buffer sizes of the standard SPS and the F-SPS are not synchronized yet
GlobalVariables ¶ GVL (GVL)
GVL (GVL) ¶ Global public variables for the SubNode Communication Manager Attributes: qualified_only InOut: Name Type Initial Comment SncServer SncServiceProvider global SNC service provider: includes service handler and registered bus drivers SncLogger SncLogger global SNC logger bRtsSupportsServiceHandlerWithRecall BOOL FALSE this is true for version 3.5.5.0 or higher
Interfaces ¶ IBusSpecificDataHandler (Interface) InitDeviceSpecificFSps (Method) ScanDeviceSpecificFSps (Method) SyncdWriterSize (Property) TransmitDeviceSpecificData (Method) ISncDevDesc (Interface) FSpsAddress (Property) FSpsDevAddress (Property) FSpsMasterIdx (Property) FSpsVendorID (Property)
IBusSpecificDataHandler (ITF) ¶ INTERFACE IBusSpecificDataHandler Interface for the bus specific data handler ability to initialize this bus data handler and its underlying components ability to scan a specific bus for a given F-SPS and to synchronize buffer sizes between CODESYS / Std-SPS and the F-SPS ability to transmit the content of a SNC service request to a specific F-SPS and to transform its reply as a SNC service reply Properties: SyncdWriterSize Methods: InitDeviceSpecificFSps ScanDeviceSpecificFSps TransmitDeviceSpecificData Structure: InitDeviceSpecificFSps (Method) ScanDeviceSpecificFSps (Method) SyncdWriterSize (Property) TransmitDeviceSpecificData (Method)
IBusSpecificDataHandler.InitDeviceSpecificFSps (METH) ¶ METHOD InitDeviceSpecificFSps : ERROR Method to do some specific bus initialization and its underlying components InOut: Scope Name Type Return InitDeviceSpecificFSps ERROR
