File and Project Information ¶ Scope Name Type Content FileHeader creationDateTime date 25.10.2023, 14:09:27 companyName string 3S-Smart Software Solutions GmbH libraryFile Sense Hat.library primaryProject True productName CODESYS productProfile CODESYS V3.5 SP16 Patch 3 contentFile Sense Hat.clean.json version version 2.0.0.0 ProjectInformation IsEndUserLibrary bool False Released True LastModificationDateTime date 25.10.2023, 14:09:25 LibraryCategories library-category-list Target Author string CODESYS Development GmbH Company CODESYS CompiledLibraryCompatibilityVersion CODESYS V3.5 SP16 DefaultNamespace SenseHat Description See: Description DocFormat reStructuredText LanguageModelAttribute qualified-access-only Placeholder SenseHat Project Sense Hat Title Sense Hat Version version 4.10.0.0

Library Reference ¶ This is a dictionary of all referenced libraries and their name spaces. CAA Memory ¶ Library Identification ¶ Placeholder: CAA Memory Default Resolution: CAA Memory, * (CAA Technical Workgroup) Namespace: MEM Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA Memory CmpCharDevice ¶ Library Identification ¶ Placeholder: CmpCharDevice Default Resolution: CmpCharDevice, * (3S - Smart Software Solutions GmbH) Namespace: CmpCharDevice Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpCharDevice FloatingPointUtils ¶ Library Identification ¶ Placeholder: FloatingPointUtils Default Resolution: FloatingPointUtils, * (System) Namespace: FPU Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: FloatingPointUtils IoStandard ¶ Library Identification ¶ Placeholder: IoStandard Default Resolution: IoStandard, * (System) Namespace: IoStandard Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: IoStandard Raspberry Pi Peripherals ¶ Library Identification ¶ Placeholder: Raspberry Pi Peripherals Default Resolution: Raspberry Pi Peripherals, * (CODESYS) Namespace: RasPi Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Raspberry Pi Peripherals Standard ¶ Library Identification ¶ Placeholder: Standard Default Resolution: Standard, * (System) Namespace: Standard Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Standard 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)

Enums ¶ ERROR (Enum) FSPSBUSDRV (Enum) LOGDBGSTATE (Enum)

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)

ERROR (ENUM) ¶ TYPE ERROR : Enumeration for the various error types in the subnode communication manager (SNCM): Attributes: qualified_only InOut: Name Initial Comment ERR_OK 0 The action was successful. ERR_FAILED 1 The action failed due to a non specific reason. ERR_ADDRESS_INVALID 2 The given F-SPS bus address or F-SPS device address is not valid. ERR_SERVICEPROVIDER_NOTINITIALIZED 3 The SNC service provider was not fully initialized yet. ERR_SERVICEPROVIDER_START 4 The SNC service handler could not be registered at the RTS service handler and therefore not started. ERR_DRIVER_INVALID 5 The given F-SPS bus driver could not be registered in the SNC service provider because of an invalid driver handle. ERR_DRIVER_ALREADYREGISTERED 6 The given F-SPS bus driver is already registered in the SNC service provider. ERR_DRIVER_MISMATCH 7 The given service is forwarded to the wrong F-SPS bus driver. ERR_BUSHANDLER_NOTINITIALIZED 8 The underlying bus handler was not fully initialized yet. ERR_READER_FAILED 9 Error while reading the service ERR_WRITER_FAILED 10 Error while writing the reply ERR_COMM_NOTOPEN 11 The communication channel to the F-SPS could not be opened. ERR_FSPS_SVC2BIG 12 The transferred safety service is larger than the F-SPS message buffer ERR_FSPS_SEND 13 Common error during sending the safety service data ERR_FSPS_SENDTIMEOUT 14 Timeout during sending the safety service data (block timeout) ERR_FSPS_SENDANDREOPEN 15 The sending of the safety service data is pending and the reopen of the channel failed ERR_FSPS_REPLY 16 Common error while receiving the safety service reply ERR_FSPS_REPLYTIMEOUT 17 Timeout during reply (block timeout and message timeout) ERR_FSPS_STATE 18 Undefined state in the communication loop of the bus handler ERR_FSPS_PENDING 19 The F-SPS is busy and couldn’t handle the service reply in time (access to flash, …) ERR_SCAN_FAILED 20 Common error in scan ERR_SCAN_TIMEOUT 21 Timeout during scan

FSPSBUSDRV (ENUM) ¶ TYPE FSPSBUSDRV : Enumeration for the various F-SPS bus driver types in the subnode communication manager: Attributes: qualified_only InOut: Name Initial Comment ETHERCAT 16#1 Bus driver is of type ‘ETHERCAT’ SINGLE_SHM 16#2 Bus driver is of type ‘Single FSps’ on base of a shared memory communication

LOGDBGSTATE (ENUM) ¶ TYPE LOGDBGSTATE : Enumeration for the various states of the SNC device driver as an alternative if there are no debugging / logging possibilities Attributes: qualified_only InOut: Name Initial Comment DBG_INITDOWNLOAD_ENTRY 0 entered InitOnDownload() method which is called by the device itself DBG_INITDOWNLOAD_NULLCONNECTOR 1 InitOnDownload() has a null connector as parameter DBG_INITDOWNLOAD_NULLCBEVENT 2 InitOnDownload() cannot register for EVT_BeforeWritingOutputs DBG_INITDOWNLOAD_CALLBACK 3 InitOnDownload() could register a callback for EVT_BeforeWritingOutputs DBG_INITEVTCB_ALREADYDONE 4 the initialization by the event callback is called twice DBG_INITEVTCB_NOIDENTITY 5 could not read the identity of the EtherCAT slave in the event callback DBG_INITEVTCB_NOSLAVEADDR 6 could not read the physical address of the EtherCAT slave in the event callback DBG_INITEVTCB_NOVENDORID 7 could not read the vendor ID of the EtherCAT slave in the event callback DBG_INITEVTCB_NOMASTERIDX 8 could not get master index of the EtherCAT slave in the event callback DBG_INITEVTCB_NOSLAVE 9 could not get the slave out of the parameter structure in the event callback DBG_INITEVTCB_NOTINOPSTATE 10 the slave is not in the operate state in the event callback DBG_INITEVTCB_NOTMYBUSINESS 11 the event callback was called although is was not the right IEC task or event DBG_INITDEV_ALREADYDONE 12 the initialization of the SNC device driver for this F-SPS is called twice DBG_INITDEV_INVALIDADDRESS 13 could not initialize the SNC device driver for this F-SPS because vendorID and address are 0 DBG_INITSRVPRV_FAILED 14 could not initialize the corresponding SNC service provider for this F-SPS DBG_INITSRVPRV_SUCCESS 15 successfully initialized the corresponding SNC service provider for this F-SPS DBG_INITDEVDESC_FAILED 16 could not initialize the corresponding SNC device description for this F-SPS DBG_INITDEVDESC_SUCCESS 17 successfully initialized the corresponding SNC device description for this F-SPS DBG_REGDEVDESC_FAILED 18 could not register this F-SPS to the SNC service provider DBG_REGDEVDESC_SUCCESS 19 successfully registered this F-SPS to the SNC service provider DBG_INITDEVSPEC_FAILED 20 could not initialize the bus specific part of the F-SPS DBG_INITDEVSPEC_SUCCESS 21 successfully initialized the bus specific part for this F-SPS

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

01  Snc Base FB ¶ This folder provides the basic function blocks for the subnode communication manager: “SncBusHandlerBase”: transmits the content of a SNC service to a specific F-SPS on base of its bus dependent communication driver (EtherCAT or SharedMemory) “SncCommDriverBase”: implements a certain communication driver (open / close comm, send, receive, …) “SncDeviceDriverBase”: represents one F-SPS which is registered at the “SNCServiceProvider” to handle SNC services “SncFSpsServiceProviderBase”: combines the SNC service handler with the registered F-SPS; registers the SNC service handler at the RTS service handler SncDeviceDriverBase (FunctionBlock) FSpsBusID (Property) FSpsDeviceAddress (Property) InitDeviceSpecificFSps (Method) InitOnDownload (Method) Initialize (Method) ScanDeviceSpecificFSps (Method) SyncdWriterSize (Property) TransmitDeviceSpecificData (Method) WasInitialized (Property) WriteScanReply (Method)

SncDeviceDriverBase (FB) ¶ FUNCTION_BLOCK SncDeviceDriverBase IMPLEMENTS ISncDeviceDriver, ICmpEventCallback Base class for a F-SPS device driver for handling the SNC services addressed to its connected F-SPS implements the interface ‘ISncDeviceDriver’ registers a given F-SPS to the SncServiceProvider handles the SNC service data on base of the bus specific communication (EtherCAT or SharedMemory) Properties: FSpsBusID FSpsDeviceAddress SyncdWriterSize WasInitialized Methods: InitDeviceSpecificFSps InitOnDownload Initialize ScanDeviceSpecificFSps TransmitDeviceSpecificData WriteScanReply Structure: FSpsBusID (Property) FSpsDeviceAddress (Property) InitDeviceSpecificFSps (Method) InitOnDownload (Method) Initialize (Method) ScanDeviceSpecificFSps (Method) SyncdWriterSize (Property) TransmitDeviceSpecificData (Method) WasInitialized (Property) WriteScanReply (Method)