Element name: GUID

Description: Unique GUID assigned to a configuration (be sure when creating new structure this filed to different every time).

Example:

<GUID>22e09c74-2785-4b53-b7db-83037cea6759</GUID>
<GUID>a7c951cc-d501-4ef6-844c-1f2aa8b405af</GUID>

Element name: TimeStampSize

Description: Size in bytes of timestamp used for storing data (default 4).

Example:

<TimeStampSize>4</TimeStampSize>

Element name: WAKEUP_SOURCE

Sub Elements: WakeupSourceType, WakeupParameter

Element name: VERSION

Description: The validation and conversion library uses the VERSION element. This document specifies version 1.0.1. Unknown elements are ignored.

Sub Element: None

<VERSION-TYPE>1.0.1</VERSION-TYPE>

Element name: TimeStampPrecision

Description: Defines precision of internal timestamp in microseconds.

Example: If the precision is 10, the smallest difference between 2 points will be 10 microseconds.

Example:

Element name: InterfaceCount

Description: Deprecated. Total number of interfaces (CANInterface, SDInterface etc.), the Default value is 0.

Example:

Element name: EncryptType

Description: The device can encrypt logs and lock communication from USB.

Example:

Element name: WAKEUP_SOURCE_LIST

Sub Elements: WAKEUP_SOURCE,

Example:

Element name: CONFIG_FTP UID

Sub Element: ServerName_IP_Connection_Option, ServerIP, ServerName, Mode, Type, Port, User, Pass, StatusSendTime, ConfigurationCheckTime, FirmwareCheckTime, AutomaticFirmwareUpdate, EncryptPass

Example:

Element name: EncryptKey

Description:

Example:

Element name: UsePIN

Description: Specifies if the PIN has been used or not. Can be true or false.

Example:

Element name: LockDevice

Description: Define is device locked for USB communication.

Example:

Element name: FirmwareCheckTime

Description: Defines the time to check for new firmware.

Example:

Element name: ConfigurationCheckTime

Description: Defines the time to check for the new configuration.

Example:

Element name: CONFIG

Description: UID (UID Should be unique for each element).

Sub Elements: GUID, InterfaceCount, Name, TimeStampSize, TimeStampPrecision, SleepMode, ConfigurationVersion, CANPositiveTimeout, CANSilentDelay, CANReceiveTimeout, EncryptType, EncryptKey, LockDevice, EncryptDataLog, WAKEUP_SOURCE_LIST

Element name: WakeupParameter

Description: Defines the parameter for alarm wake-up.

Example:

Element name: SleepMode

Description: Sleeping options of the device (logger), can be: NO_SLEEP, NORMAL_SLEEP, DEEP_SLEEP. Default value is NO_SLEEP

Example:

<SleepMode>NO_SLEEP</SleepMode>
<SleepMode>NORMAL_SLEEP</SleepMode>

Element name: CANPositiveTimeout

Description: The device will stop sending messages on CAN if do not receive positive response for a defined period.

Example:

<CANPositiveTimeout>0</CANPositiveTimeout>

Element name: ConfigurationVersion

Description: The version of the configuration

Example:

<ConfigurationVersion>2</ConfigurationVersion>

Element name: CANReceiveTimeout

Description: The device will go to sleep if do not receive a message for a defined amount of time.

Example:

<CANReceiveTimeout>120</CANReceiveTimeout>

Element name: AutomaticFirmwareUpdate

Description: Defines whether the device needs to update the firmware.

Example:

<AutomaticFirmwareUpdate>true</AutomaticFirmwareUpdate>
<AutomaticFirmwareUpdate>false</AutomaticFirmwareUpdate>

Element name: UseAPN

Description: Specifies if APN settings used for mobile connection if it is used or not. It can either be true or false.

Example:

<UseAPN>true </UseAPN>
<UseAPN>false</UseAPN>

Element name: ServerName

Description: Defines the server’s name/FTP IP. It can be any name assigned by the user.

Example:

<ServerName> ftp.test.com </ServerName>

Element name: ServerIP

Description: Defines FTP IP.

Example:

<ServerIP>227.160.221.26</ServerIP>

Element name: Pass

Description: Defines FTP Password.

Example:

<Pass>Pass1</Pass>

Element name: ServerName_IP_Connection_Option

Description: Specifies which option is used for connection, server name or FTP IP.

Example:

<ServerName_IP_Connection_Option>USE_SERVERNAME</ServerName_IP_Connection_Option>

Element name: Port

Description: Defines FTP Port.

Example:

<Port>21</Port>

Element name: StatusSendTime

Description: Defines the time to send the device status (in ms).

Example:

<StatusSendTime>300000</StatusSendTime>

Element name: MaxLogSize

Description: Specifies the maximum size for every log file in bytes. When it is reached, the device creates a new log.

Example:

 <MaxLogSize>104857600</MaxLogSize>

Element name: CANSilentDelay

Description: The device will not send any message on CAN for a defined period of time

Example:

<CANSilentDelay>0</CANSilentDelay>

Element name: PreLogTime

Description: (Pre-trigger time) defines the time duration in milliseconds to log as a Pre-trigger log or the time (in ms) the device will store before the actual trigger. 0= Don’t use pre-trigger. Check the Triggers section for details on how to set triggers.

Example:

<PreLogTime>10000</PreLogTime>

Element name: SDINTERFACE_LIST

Description: The SDINTERFACE_LIST element Contains list of all SDINTERFACE blocks. IF SD interface is not configured the logger will not write any data into the eMMC

Sub Element: SDINTERFACE

<SDINTERFACE_LIST>
<SDINTERFACE UID=" ">
<MaxLogSize>
<MaxLogTime>
<LogFormat>
<PreLogTime>
<PostLogTime>
<IsPostTimeFromEnableStart>
<NumberOfLogs>
<IsEnableCreateNewLog>
<InitialEnableState>
<EnableUID>
<DisableUID>
<PartitionID>
</SDINTERFACE>
</SDINTERFACE_LIST

Element name: EncryptDataLog

Description: All logs will be encrypted. The file type will be RXE.

Example:

<EncryptDataLog>false</EncryptDataLog>

Element name: APN

Description:

Example:

<APN></APN>

Element name: Mode

Description: specifies if the mode of FTP is active or passive.

Example:

<Mode>Passive</Mode>
<Mode>Active</Mode>

Element name: BLOCKS

Description:

Sub Elements: SDINTERFACE_LIST, USBINTERFACE_LIST, CANINTERFACE_LIST, CANMESSAGE_LIST, CANERROR_LIST, LININTERFACE_LIST, LINMESSAGE_LIST, DIGITAL_INPUT_LIST, ACCELEROMETER_LIST, GYRO_LIST, GNSSINTERFACE_LIST, GNSSMESSAGE_LIST, INTERNAL_PARAMETER_LIST, SDMESSAGE_LIST, USBMESSAGE_LIST.

Element name: SDINTERFACE

Attribute: UID (UID Should be unique for each element, this UID will be referenced in the SD Message element)

Sub Element: MaxLogSize, MaxLogTime, LogFormat, NumberOfLogs, PreLogTime, PostLogTime, IsPostTimeFromEnableStart, IsEnableCreateNewLog, InitialEnableState, EnableUID, DisableUID, PartitionID.

Example:

<SDINTERFACE UID="2">

Element name: User

Description: Defines the user settings for APN, such as, user’s name. Can be any name specified by the user for identification.

Example:

<User>abc</User>

Element name: NoCommunicationRestartTimeOut

Description: After a defined time when there is no activity, the device will try to reconnect.

Example:

<NoCommunicationRestartTimeOut>60000</NoCommunicationRestartTimeOut>

Element name: WakeupSourceType

Description: Defines list with the wake-up sources. It is either CAN0 or CAN1.

Example:

<WakeupSourceType>CAN0</WakeupSourceType>
<WakeupSourceType>CAN1</WakeupSourceType>

Element name: Pass

Description: Defines the Password settings for APN.

Example:

<Pass>PASSWORD</Pass>

Element name: EncryptPass

Description: This is the FTP password encrypted in the configuration.

Example:

<EncryptPass>true</EncryptPass>
<EncryptPass>false</EncryptPass>

Element name: GetRealTimeFromMobile

Description: Request time from mobile cell

Example:

<GetRealTimeFromMobile>false</GetRealTimeFromMobile>

Element name: CONFIG_MOBILE UID

Description: Define Mobile settings for the device.

Sub Element: UseAPN, APN, User, Pass, PIN, GetRealTimeFromMobile, NoCommunicationRestartTimeOut, UsePIN

Example:

<CONFIG_MOBILE UID="67">

Element name: MaxLogTime

Description: Specifies the maximum time for every log file in seconds. When it is reached, the device creates a new log.

Example:

Element name: PIN

Description: specifies the PIN for SIM card

Example:

Element name: User

Description: Specifies the user’s name. Can be any name specified by the user for identification.

Example:

Element name: USBINTERFACE UID

Attribute: UID (UID Should be unique for each element), this UID will be used in the USBMESSAGE Element.

Example:

Element name: PostLogTime

Description: (Post trigger time) How many milliseconds to log after a Start logging trigger occur or the time (in ms) that device will store before actual trigger. 0 = Continuous log Check Triggers section for details.

Example:

<PostLogTime>1000</PostLogTime>

Element name: EnableUID

Description: Unique input ID of a block that will enable (start logging) writing on the SD card (if it’s not writing). It can be a triggering event. The default value is 0.

Example:

<EnableUID>0</EnableUID>

Element name: USBINTERFACE_LIST

Description: The USBINTERFACE_LIST element enabled the USB live view interface.

Sub Element: USBINTERFACE

<USBINTERFACE_LIST>
<USBINTERFACE UID=" " />
</USBINTERFACE_LIST>

Element name: CANINTERFACE UID

Attribute: UID (UID Should be unique for each element); this UID will be referenced in the CANMESSAGE element.

Sub Element: Type, PhysicalNumber, CANBusSpeed, CANFDBusSpeed, CANFDNonISO, TSeg1, TSeg2, SJW, TSeg1FD, SJWFD, SilentMode, Autodetect, WakeUpOption, SleepOption, SleepNoActivityTime, Prescaler, PrescalerFD, UseBitTiming, FilterCount.

Example:

<CANINTERFACE UID="4">

Element name: CANBusSpeed

Description: Defines the Can Bus speed in bps.

Example:

<CANBusSpeed>500000</CANBusSpeed>

Element name: CANFDBusSpeed

Description: Defines CAN bus speed (bps) in data transmission phase. It is applicable if CAN is defined as CAN FD.

Example:

<CANFDBusSpeed>8000000</CANFDBusSpeed>

Element name: CANFDNonISO

Description: If the Can FD is Non-ISO

Example:

<CANFDNonISO>false</CANFDNonISO>

Element name: TSeg1

Description: CAN timing parameter. Must be filled if UseBitTiming is true

Example:

<TSeg1>39</TSeg1>

Element name: SJWFD

Description: CANFD timing parameter. It must be filled if UseBitTiming is true.

Example:

<SJWFD>0</SJWFD>

Element name: WakeUpOption

Description: To specify the WakeUpOption, by default logger is set to No Sleep mode, default value is NO_WAKE_UP.

Example:

<WakeUpOption>NO_WAKE_UP</WakeUpOption>

Element name: UseBitTiming

Description: Used to enable the use of CAN timing settings if true.

Example:

<UseBitTiming>false</UseBitTiming>

Element name: CANMESSAGE UID

Description: Used to define the properties of CAN Messages, there can be multiple definitions, and UID should be unique for each definition.

Attribute: UID (UID Should be unique for each element)

Sub Element: MessageIdentStart, MessageIdentEnd, Direction, DLC, IsExtended, InterfaceUID, Period, TriggeringMessageUniqueID, DefaultHex, CANFD_Option, InputMessageUID, Name, isJ1939, J1939Source, J1939Destination, Downsampling, Delay, NextOutputMessageID

Example:

<CANMESSAGE UID="5">

Element name: MessageIdentEnd

Description: End ident of CAN message. It is used for filtering. If used to LOG ALL messages, the default value should be 4294967295. If filters are defined, mention the END ID for the range. Value is specified in Decimal.

Example:

<MessageIdentEnd>4294967295</MessageIdentEnd>

Element name: Direction

Description: Defines the direction of the CAN message. It can be Input, OutputEvent and OutputPeriodic. The default direction is Input (Input is RX CAN, Output is TX CAN).

Example:

<Direction>Input</Direction>

Element name: IsExtended

Description: Specify if the CAN Message ID is extended or standard.

Example:

<IsExtended>false</IsExtended>

Element name: InterfaceUID

Description: it is a unique ID to the CAN interface block. Specify the CAN Interface UID to link to this CAN Message.

Example:

<InterfaceUID>4</InterfaceUID>

Element name: Period

Description: Defines the period for transmission time. The message must be OutputPeriodic. If the value is bigger than 0 and the direction is OutputPeriodic, the CAN message will be periodically transmitted.

Example:

<Period>0</Period>

Element name: TriggeringMessageUniqueID

Description: Unique input ID for the message that will process the block. Used if CAN message is Output Event.

Example:

<TriggeringMessageUniqueID>1</TriggeringMessageUniqueID>

Element name: DefaultHex

Description: Default HEX value of the CAN message that is going to be transmitted if the direction is OutputPeriodic.

Example:

<DefaultHex>0000000000000000</DefaultHex>

Element name: InputMessageUID

Description: Unique input ID for input block link to a CAN message. To be used if this message receives Input from another message. The default value is 0.

Example:

<InputMessageUID>0</InputMessageUID>

Element name: isJ1939

Description: Specifies if the CAN message is used for the J1939 filter (true, false).

Example:

<isJ1939>false</isJ1939>
<isJ1939>true</isJ1939>

Element name: Downsampling

Description: Use if the message is to be down-sample the CAN data, the value is specified in milliseconds. If down-sampling is not used default value should be 0.

Example:

<Downsampling>1000</Downsampling>

Element name: Type

Description: Defines FTP type.

Example:

<Type>FTP</Type>

Element name: REXGENCONFIG

Description: Root element should be REXGENCONFIG

Sub Element: VERSION-TYPE, CONFIG, SDINTERFACE_LIST, USBINTERFACE_LIST, CANINTERFACE_LIST, CANMESSAGE_LIST, SDMESSAGE_LIST, USBMESSAGE_LIST

Element name: IsPostTimeFormEnableStart

Description: Defines post time start from the start or end of the event. It can be true or false. Check the Triggers section for details.

Example:

Element name: IsEnableCreateNewLog

Description: If a new file has to be created on the EnableUID message, the default value is false. If it is true, this means every time that interface is enabled (from the trigger) a new log is created. It can be used for creating a new log on every event.

Example:

Element name: initiaEnableState

Description: If it is true, it means the device starts logging in from the moment it is powered on. It can be used to stop triggering. If it is false, the device does not log initially and needs to start logging (triggering) events.

Example:

Element name: DisableUID

Description: The UID of the block that disables the writing to the SD card (stop logging). If a message is passed from this ID the writing will stop. It can be triggering event. Default value is 0.

Example:

Element name: PartionID

Description: The ID of the partition to write to (used for multi-partitioning if bigger than 0). Define the number of partitions that the log will be stored on. The main partition is always 0. Internal storage must be formatted with partitions. The default value is 0.

Example:

Element name: CANINTERFACE_LIST

Description: The CANINTERFACE_LIST element Contains a list of all CANINTERFACE blocks; if 2 CAN bus is used, there should be two CAN interface sub-element with unique UID and Physical Numbers.

Sub Element: CANINTERFACE UID

Element name: Type

Description: Define type of CAN bus. It can be classic CAN or CAN FD.

Example:

Element name: PhysicalNumber

Description: Specifies the CAN Bus used for the interface i.e. the aActual physical bus of the device.

Example:

Element name: TSeg2

Description: CAN timing parameter. It must be filled if UseBitTiming is true.

Example:

Element name: SlientMode

Description: Enables or disables silent mode operation (device will not acknowledge the messages it receives). If is set to true device will go in listen mode and will not transmit CAN data and will not acknowledge CAN messages.

Example:

Element name: Prescaler

Description: CAN timing parameter. Must be filled if UseBitTiming is true.

Example:

Element name: PrescalerFD

Description: CAN FD timing parameter. Must be filled if UseBitTiming is true.

Example:

Element name: FilterCount

Description: Number of CAN hardware filters. The default value is 0.

Example:

Element name: MessageIdentStart

Description: Start ident of CAN message. It is used for filtering. If used to LOG ALL messages, the default value should be 0. If filters are defined, mention the start ID for the range. Value is specified in Decimal.

Example:

Element name: DLC

Description: The DLC of the CAN message.

Example:

Element name: CANFD_Option

Description: Specifies the type of CAN message, which can be NORMAL_CAN, FD_CAN, FD_FAST_CAN.

The default value is NORMAL_CAN.

Example:

Element name: Name

Description: Name of the CAN message. Used for reference post-processing.

Example:

Element name: J1939Destination

Description: defines the J1939 destination filtering address.

Example:

Element name: SJW

Description: CAN timing parameter. Must be filled if UseBitTiming is true.

Example:

Element name: TSeg1FD

Description: CANFD timing parameter. It must be filled if UseBitTiming is true.

Example:

<TSeg1FD>2</TSeg1FD>

Element name: Autodetect

Description: To enable or disable auto detection of CAN Bus speeds. If is set to true device will autodetect CAN bus speed. There must be CAN messages on CAN bus.

Example:

<Autodetect>false</Autodetect>

Element name: SleepOption

Description: NO_SLEEP, NORMAL_SLEEP, DEEP_SLEEP. Default value is NO_SLEEP.

Example:

<SleepOption>NO_SLEEP</SleepOption>

Element name: SleepNoActivityTime

Description: Go to sleep after time (in seconds) if the SleepOption is enabled.

Example:

<SleepNoActivityTime>0</SleepNoActivityTime>

Element name: NumberOfLogs

Description: Maximum number of logs that device will create. If is set as “0” it means maximum allowed for the device (No restrictions), 1= Only 1 log file

Example:

<NumberOfLogs>0</NumberOfLogs>
<NumberOfLogs>1</NumberOfLogs>

Element name: CANMESSAGE_LIST

Description: This element will be used for defining the CAN Messages that are to be handled by the logger. It can be Input messages or output messages.

Sub Element: CANMESSAGE

<CANMESSAGE_LIST>
<CANMESSAGE UID=" ">
<MessageIdentStart>
<MessageIdentEnd>
<Direction>
<DLC>
<IsExtended>
<InterfaceUID>
<Period>
<TriggeringMessageUniqueID>
<DefaultHex>
<CANFD_Option>
<InputMessageUID>
<Name>
<isJ1939>
<J1939Source>
<J1939Destination>
<Downsampling>
<Delay>
<NextOutputMessageID>
</CANMESSAGE>
</CANMESSAGE_LIST>

Element name: LogFormat

Description: Specifies the type of file created during the log process. It can be only InfluxGeneric1.

Example:

Element name: J1939Source

Description: Defines the J1939 source filtering address

Example:

<J1939Source>0</J1939Source>

Element name: Name

Description: Name of the configuration. The same name will be used in the beginning of the log file name in internal or cloud storage.

Example:

<Name>Demo1</Name>
<Name>Completelog</Name>