File and Project Information ¶ Scope Name Type Content FileHeader creationDateTime date 20.04.2021, 15:10:29 companyName string 3S-Smart Software Solutions GmbH libraryFile SNCM_ECATSlave_Itfs.library primaryProject True productName CODESYS productProfile CODESYS V3.5 SP16 Patch 3 contentFile SNCM_ECATSlave_Itfs.clean.json version version 2.0.0.0 ProjectInformation IsInterfaceLibrary bool True Released True LastModificationDateTime date 20.04.2021, 15:10:28 LibraryCategories library-category-list Intern|Networking Author string 3S - Smart Software Solutions GmbH Company 3S - Smart Software Solutions GmbH CompiledLibraryCompatibilityVersion CODESYS V3.5 SP15 DefaultNamespace SNCM_ECATSLAVE_ITF Description See: Description DocFormat reStructuredText LanguageModelAttribute qualified-access-only Project SNCM_ECATSlave_Itfs Title SNCM ECATSlave Interfaces Version version 3.5.17.0
Library Reference ¶ This is a dictionary of all referenced libraries and their name spaces.
SNCM Manager Library Documentation ¶ Company 3S - Smart Software Solutions GmbH Title SNCM Manager Version 3.5.8.30 Categories Intern|Networking Namespace SNCM Author 3S - Smart Software Solutions GmbH Placeholder SNCM_Manager Description 1 ¶ Library for supporting subnode communication for several F-SPS with SRTS via a new service handler.This version uses a safety abstraction interface for EtherCAT fieldbus stacks. Contents: ¶ SNCM Manager Enums Function Blocks GlobalConstants GlobalVariables Interfaces Indices and tables ¶ 1 Based on SNCM_Manager.library, last modified 01.01.1601, 00:53:00. LibDoc 4.4.0.0-b.27 The content file SNCM_Manager.clean.json was generated with CODESYS V3.5 SP10 Patch 2 on 18.05.2017, 08:42:01.
SNCM Manager ¶ This library transfers safety online services to registered F-SPS’s (subnodes) via a new SNC service handler. So far the F-SPS can be EtherCAT slaves or they communicate via shared memory. The library has its own SNC logger for error messages. If additional log messages are wanted you have to set the compiler defines to ‘SNC_DEBUG_LOG’ (application properties, folder ‘Build’). 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. Enums ERROR (Enum) FSPSBUSDRV (Enum) LOGDBGSTATE (Enum) Function Blocks 01 Snc Base FB SncDeviceDriverBase (FunctionBlock) FSpsBusID (Property) FSpsDeviceAddress (Property) InitDeviceSpecificFSps (Method) InitOnDownload (Method) Initialize (Method) ScanDeviceSpecificFSps (Method) SyncdWriterSize (Property) TransmitDeviceSpecificData (Method) WasInitialized (Property) WriteScanReply (Method) 02 Device Drivers and Bus Datahandlers Bushandler EtherCAT DEVDRV_ETC (GVL) SncEtherCATDriver (FunctionBlock) BlockTimeoutMs (Property) BlockTimeoutMultiplier (Property) CommBufferSize (Property) CommTimeout (Property) FSpsBusID (Property) InitDeviceSpecificFSps (Method) MsgTimeoutMs (Property) ScanDeviceSpecificFSps (Method) ScanTimeoutMs (Property) Single FSps SncSingleDevDriver (FunctionBlock) BlockTimeoutMs (Property) CommBufferSize (Property) FSpsBusID (Property) InitDeviceSpecificFSps (Method) MsgTimeoutMs (Property) ScanDeviceSpecificFSps (Method) 03 Device Description SncDevDesc (FunctionBlock) FSpsAddress (Property) FSpsDevAddress (Property) FSpsMasterIdx (Property) FSpsVendorID (Property) 04 Comm Drivers BlkDriver Stuff EtherCAT based CommDriver SHM based CommDriver 05 ServiceHandler 06 ServiceProvider SncServiceProvider (FunctionBlock) NumOfHandledServices (Property) SimulateServiceRequest (Method) 07 Logger GlobalConstants GCL (GVL) GlobalVariables GVL (GVL) Interfaces IBusSpecificDataHandler (Interface) InitDeviceSpecificFSps (Method) ScanDeviceSpecificFSps (Method) SyncdWriterSize (Property) TransmitDeviceSpecificData (Method) ISncDevDesc (Interface) FSpsAddress (Property) FSpsDevAddress (Property) FSpsMasterIdx (Property) FSpsVendorID (Property)
Enums ¶ ERROR (Enum) FSPSBUSDRV (Enum) LOGDBGSTATE (Enum)
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)
