DRIVER_CONFIG (STRUCT) ¶ TYPE DRIVER_CONFIG : STRUCT This data type describes the configuration of a CANbus Driver Attributes: qualified_only InOut: Name Type Comment uiBaudrate UINT Possible values for baud rate [kbit/s]: 10, 20, 50, 100, 125, 250, 500, 800 or 1000. usiNetwork USINT number of the interface (Network ID starts by 0) ctMessages USINT length of the message queue for outgoing messages
Unsafe_SDG_Receiver (FB) ¶ FUNCTION_BLOCK Unsafe_SDG_Receiver J1939-76 Safety SDG receiver. Unsafe_SDG_Receiver does receive J1939-76 SDG messages (SHM and SDM) for a configured SDG produced by a J1939SafetySafe.Safe_SDG_Producer and send by a Unsafe_SDG_Sender via CAN driver. Basics and data flow ¶ For an overview of general data flow see the J1939SafetySafe library main documentation and the J1939 Safety example.project function block J1939_example_CFC. Sequence of operation on update of SHM ¶ SHM_RecvCnt is incremented signaling the SHM data are updated and valid SHM data are updated Sequence of operation on update of SDM ¶ SDM_RecvCnt is incremented signaling the SDM data are updated and valid SDM data are updated InOut: Scope Name Type Initial Comment Input xEnable BOOL TRUE Enable the receiver. dwPGN DWORD Parameter Group Number (PGN). usiSrcAddr USINT 0 Source Address. itfCL2Driver ICL2Driver CAN driver to use. Output xBusy BOOL FALSE In operation. xError BOOL FALSE Error occured. eErrorID ERROR ERROR.NO_ERROR Error status SDGU J1939SafetyItf.SAFETY_DATA_GROUP_UNSAFE
Unsafe_SDG_Sender (FB) ¶ FUNCTION_BLOCK Unsafe_SDG_Sender J1939-76 Safety SDG sender. Unsafe_SDG_Sender does send J1939-76 SDG data (SHM and SDM) produced by a J1939SafetySafe.Safe_SDG_Producer via CAN driver. Basics and data flow ¶ For an overview of general data flow see the J1939SafetySafe library main documentation and the J1939 Safety example.project function block J1939_example_CFC. InOut: Scope Name Type Initial Comment Input xEnable BOOL TRUE Enable the sender. itfCL2Driver ICL2Driver CAN driver to use. SDGS J1939SafetyItf.SAFETY_DATA_GROUP_SAFE SDGS data to be send. Output xBusy BOOL FALSE In operation. xError BOOL FALSE Error occured. eErrorID ERROR ERROR.NO_ERROR Error status. udiSHMcnt UDINT 0 number of sent SHM udiSDMcnt UDINT 0 number of sent SDM udiSDGcnt UDINT 0 number of sent SDG udiLossCnt UDINT 0 number of lost SDG udiSndErrCnt UDINT 0 number of SDG send errors
ERROR (ENUM) ¶ TYPE ERROR : This data type describes errors which can occure using CODESYS J1939 Safety Standard. Attributes: qualified_only InOut: Name Initial Comment NO_ERROR 16#0 No error occurred CL2_INTERNAL 16#20 TODO NO_LICENSE 16#21 No license found. RECEIVER_OPEN 16#22 Receiver already open CAN_PARAMETER 16#30 A parameter has a wrong value CAN_BAUDRATE 16#31 Baudrate for CANDriver is not valid. CAN_29BIT_ID 16#32 CANDriver doesnt support 29bit CAN-ID’s. CAN_DRIVER_NOT_CREATED 16#33 NetID might be wrong or the driver is not registered in “GatewayPLC/CoDeSysControl.cfg”. Example 1: 1 CAN card with 2 channels, channel 1: NetId = 0, channel 2: NetId = 1; Example 2: 2 CAN cards: NetId depends on the order the drivers are loaded. CAN_NO_DRIVER 16#34 No CANDriver - create a valid CANBus Driver. CAN_MESSAGE_QUEUE 16#35 The CANDriver sending queue is full. SDG_TRANSMIT 16#40 error SDG transmission, a or more SDGs are not transmitted SHM_UNEXPECTED 16#50 error unexpected SDM received SDM_UNEXPECTED 16#51 error unexpected SHM received SHM_DATALEN 16#52 error unexpected SHM datareceived
Library Information ¶ GetLibVersion (Function) GetLibVersionNumber (Function) IsLibReleased (Function)
GetLibVersion (FUN) ¶ FUNCTION GetLibVersion : VERSION This function has been automatically generated from the project information. InOut: Scope Name Type Return GetLibVersion VERSION
GetLibVersionNumber (FUN) ¶ FUNCTION GetLibVersionNumber : DWORD This function has been automatically generated from the project information. InOut: Scope Name Type Return GetLibVersionNumber DWORD
Builder.GetNextSegment (METH) ¶ METHOD FINAL GetNextSegment : POINTER TO BYTE Returns the pointer to the next segment of the builder InOut: Scope Name Type Comment Return GetNextSegment POINTER TO BYTE Input pbyCurSegment POINTER TO BYTE Start pointer of the current segment Output udiSize UDINT Size in bytes of the next segment eErrorID ERROR
Builder.ValidateSegment (METH) ¶ METHOD FINAL ValidateSegment : ERROR This method validates the current segment of the builder To get a free segment out of the builder, method GetCurrentSegment can be called beforehand InOut: Scope Name Type Comment Return ValidateSegment ERROR Input pbyData POINTER TO BYTE Pointer to the first byte of the segment udiSize UDINT Size of the first segment Output udiCount UDINT The amount of validated bytes in builder