background image

5. Configuring the Device

NOTE

In the configuration tree open Info to add information about the configuration in fields Author,
Configuration Name and Additional Info.

NOTE

It is possible to create and save a configuration without a connected device. Saved configurations can
be downloaded to connected CAN NT devices with Windows and Linux by using the Command Line
Tool (see 

Downloading the Configuration with Linux, p. 12

).

5.1. Basic Configuration Steps

5.1.1. CANbridge NT

1.

Make sure, that the device is connected and that the desired operational mode is selected (see 

Connecting

the Device in Use, p. 9

).

2.

In the configuration tree select General and define the general settings (see 

General Settings, p. 13

).

3.

Configure the baud rate settings for all ports in use (see 

CAN Ports, p. 16

).

4.

Configure the mapping table (see 

Mapping Table, p. 33

).

IMPORTANT

Only messages that are entered in the mapping table are forwarded. By default, no filter is set
and all messages are rejected.

5.

Configure further settings if desired (see respective chapter Action Rules, J1939 Mapping, Cyclic
Transmission etc.).

6.

After the configuration click button Write to   to write the configuration to the device.

7.

Click button Save   or Save as   to save the configuration.

5.1.2. CAN@net NT Interface Modes (ASCII, VCI, ECI)

IMPORTANT

The VCI interface mode and ECI interface mode can only be operated via Ethernet. Configuration is
possible via USB.

1.

Make sure, that the device is connected and that the desired operational mode is selected (see 

Connecting

the Device in Use, p. 9

).

2.

In the configuration tree select Interface.

3.

If checkbox Only for specified device is enabled, enter the serial number of the device to which the
configuration can be written.
If ASCII Gateway Mode is selected:

a.

Configure the protocol line ending.

b.

Define the transport protocol (default TCP).

c.

If UDP is selected, make sure that UDP is also used on the client side.

d.

Define the IP port.

e.

If checkbox Expert Mode is enabled, select the desired settings (see 

Expert Mode, p. 14

).

4.

After the configuration click button Write to   to write the configuration to the device.

Configuring the Device

CAN-Gateway Configurator V6 for CAN@net NT and CANbridge NT

4.02.0332.20001 Version 1.7

Page 11 of 56

Summary of Contents for Ixxat CAN-Gateway Configurator V6

Page 1: ...CAN Gateway Configurator V6 for CAN net NT and CANbridge NT USER MANUAL 4 02 0332 20001 Version 1 7 Publication date 2022 06 15 ENGLISH...

Page 2: ...and because of the many variables and requirements associated with any particular implementation HMS Networks cannot assume responsibility or liability for actual use based on the data examples or il...

Page 3: ...7 4 Connecting the Device in Use 9 5 Configuring the Device 11 5 1 Basic Configuration Steps 11 5 1 1 CANbridge NT 11 5 1 2 CAN net NT Interface Modes ASCII VCI ECI 11 5 1 3 CAN net NT Bridge Mode Lo...

Page 4: ...This page is intentionally left blank...

Page 5: ...mapping 1 3 March 2019 Layout changes 1 4 March 2020 Added service pack 2 functions 1 5 December 2020 Adjusted links 1 6 June 2021 Added UDP mapping table changes Tx Msg Format 1 7 May 2022 New layout...

Page 6: ...tential hazardous situation that if not avoided could result in death or serious injury CAUTION Instruction that must be followed to avoid a potential hazardous situation that if not avoided could res...

Page 7: ...e configured as Repeater and the CANbridge NT 420 as Star Coupler In the Repeater Star Coupler mode all messages are transmitted unchanged to the other ports in Classic CAN mode Filters CAN ID modific...

Page 8: ...m and to each CAN port of the device NT 420 devices additionally are capable of CAN FD The following settings and features are possible Use of Lua ADK Syslog MQTT Remote access Expert mode Communicati...

Page 9: ...l devices must be configured in one configuration file The configuration has to be set completely for all devices Master Slave 1 to 3 and then the complete configuration has to be downloaded to each d...

Page 10: ...ication in the ECI mode and commands that are used to exchange CAN messages see Software Design Guides in the ECI download package available on the product support pages on www ixxat com support bridg...

Page 11: ...cuments HMS Ixxat CAN Gateway Configurator Examples firmware and check if a newer firmware version is available on www ixxat com support bridges gateways 6 If newer firmware is available update the fi...

Page 12: ...drop down list Select device version select the current firmware version of the device V5 or V6 The device is only found if the selected firmware version matches the firmware version of the connected...

Page 13: ...to connect each device via Mini USB cable for the first configuration of the device 3 Make sure that the latest firmware is on the device see Checking and Updating the Firmware p 7 4 To start the Ixx...

Page 14: ...tegrated b For CAN Ethernet CAN bridge make sure that the IP addresses of all devices of the bridge are in the same IP range c For more information see User Manual CAN net NT 100 200 420 Changing IP A...

Page 15: ...e respective chapter Action Rules J1939 Mapping Cyclic Transmission etc 6 After the configuration click button Write to to write the configuration to the device 7 Click button Save or Save as to save...

Page 16: ...eneral Settings p 13 c In the configuration tree select CAN Ports and configure the baud rate settings for all ports in use see CAN Ports p 16 d Configure further settings if desired see respective ch...

Page 17: ...in use and the selected operational mode Setting Device Operational Mode Lua ADK CAN net NT 100 200 420 Local CAN Bridge CAN Eth CAN Bridge CANbridge NT 200 420 Bridge Syslog CAN net NT 100 200 420 L...

Page 18: ...simultaneously The CAN controller must be configured and started by the Bridge mode configuration in the CAN Gateway Configurator The CAN controller is controlled via the Bridge and all ASCII commands...

Page 19: ...ield Use of CAN tunnel CAN Tunnel is enabled in the configuration tree 2 In the configuration tree select CAN Tunnel Figure 6 CAN tunnel settings 3 In drop down list Tunnel Port select the transmittin...

Page 20: ...econd device 5 3 CAN Ports NOTE With the CAN net NT in the CAN Ethernet CAN Bridge mode each device can be configured differently But to build a Bridge configuration all devices must be configured in...

Page 21: ...it nor error frames are generated 2 To set a port to TX passive mode activate the check box TX passive mode 3 CAN Mode 5 The NT 420 supports CAN FD CAN 1 and CAN 2 are Classic CAN channels For CAN 3 a...

Page 22: ...IMPORTANT Observe that the CAN ports have different controllers and therefore different register values Make sure the correct CAN port is selected in the calculator 1 To open the calculator click but...

Page 23: ...tomatic baud rate detection active on both channels Orange flashing Orange flashing Green and orange flashing Baud rate detected on CAN 1 baud rate detection on CAN 2 active Off Orange flashing Green...

Page 24: ...til the monitoring is activated after the power on of the device Exception a bus off is directly handled CAN message lost defines which error state is set after an overload situation inside the device...

Page 25: ...address In Action Rules it has to be defined which syslog messages are transmitted from the CAN net NT Severity Level The severity levels are defined by the syslog standard The severity level of the...

Page 26: ...1 Enable the syslog configuration see Enabling the Syslog Configuration p 22 2 Define syslog messages via Action Rules a Configure an IF event to set the trigger for the transmission of a syslog mess...

Page 27: ...n MQTT messages are only possible with the CAN net NT via Ethernet Figure 12 MQTT Publisher and Subscriber MQTT Configuration CAN Gateway Configurator V6 for CAN net NT and CANbridge NT 4 02 0332 2000...

Page 28: ...no messages are transmitted and the keep alive time is exceeded the subscribing client has to transmit a ping request to ensure that the connection is still held MQTT Authorization If the broker in u...

Page 29: ...xtended T Frame Type D Data R RTR Remote frames RTR are only supported by Classic CAN ident Message identifier decimal data List of data bytes 0 64 values Defining MQTT Messages As publisher the CAN n...

Page 30: ...space characters add curly brackets for example ser_num 5 7 Action Rules NOTE With the CAN net NT in the CAN Ethernet CAN Bridge mode each device can be configured differently But to build a Bridge c...

Page 31: ...ssible Actions p 31 THEN action is entered in the table 3 Define how often the rule is executed in the column How often When the defined event occurs the action is executed and the counter is decrease...

Page 32: ...data of the last received event during the blocking time is used for the action Other events that occur during the blocking time are discarded The delay time defines the time span between the receptio...

Page 33: ...xpired starts the timer after Power on when the configured delay time is expired Timeout start delay time after power on of the device in milliseconds only if Timeout after is set to start delay expir...

Page 34: ...defined events see Communication Error Severity p 20 CAN status byte changed It is possible to monitor if the error state of the CAN ports changes A CAN status byte can be of the states Error Active 0...

Page 35: ...rity level of the message passes the severity level filter set in syslog configuration see Syslog Configuration p 21 Severity level INFO WARN ERR CRIT Message payload enter message in field Via the bu...

Page 36: ...curred 3 Module in state preoperational 4 Module in state configuring 5 Module in state operational 6 Module is not existent Testing IF Events To test if an IF event occurs the terminal window can be...

Page 37: ...ng CAN controller must be capable of CAN FD to be able to receive these messages IMPORTANT Risk of multiply transmitted messages Each message that is entered in the mapping table is transmitted If a m...

Page 38: ...x Example 0x55 4 To select a row left click on the left number column 5 To edit the cell content click on the cell Drop down list is opened 6 To add a row right click on the left number column and sel...

Page 39: ...ormat CAN for Classic CAN messages additionally with NT 420 CAN FD for CAN FD messages as received messages are transmitted in the same format as received CAN FD messages can only be transmitted on CA...

Page 40: ...700 0111 0000 0000 Result 0x1XX 0001 XXXX XXXX Any identifier between 0x100 and 0x1FF passes the filter as only the first 3 bits of the mask are marked as relevant Table 5 Example 29 Bit Identifier he...

Page 41: ...o CAN 4 and vice versa Figure 16 Example 1 mapping table Example 4 Mapping Table Star Coupler The following mapping table is an example of a CANbridge NT Star Coupler that allows all messages standard...

Page 42: ...sage is transmitted for each entry in the list i e the message is transmitted more than once Figure 18 J1939 Mapping example Line 0 is an example for a PDU2 format message no specific Rx destination a...

Page 43: ...numbers must be 0 If rx is entered the value in RxPGN is used Tx Dst Addr 0 255 or rx Destination address for the transmit PGN PDU1 deactivated if PDU 2 format is defined in RxPGN If rx is entered the...

Page 44: ...essage to be divided Rx pos Starting position in bytes 0 63 within source CAN FD message Tx length Number of data bytes of the Classic CAN message to be transmitted up to 8 data bytes Tx channel CAN1...

Page 45: ...ee configuration in Mapping Table p 33 Entry Limitations The size of the mapping table is limited Maximal 128 CAN FD messages are possible CAN CAN FD Multiplexing CAN Gateway Configurator V6 for CAN n...

Page 46: ...or the cycle time is violated the transmitting of the CAN FD message is cancelled after the number of transmit repetitions defined in Tx rep cnt is expired Tx channel CAN3 CAN4 Defines the transmit c...

Page 47: ...transmitted on the CAN bus the cycle time can be increased To increase the number of CAN messages that are transmitted on the CAN bus the cycle time can be reduced If no current CAN message is receiv...

Page 48: ...received messages are transmitted in the same format as received CAN FD messages can only be transmitted on CAN3 and CAN4 and if the ports CAN3 and CAN4 are configured as CAN FD ports If field Tx Msg...

Page 49: ...the respective module Tx counter counts all messages that are transmitted by the respective module Module memory displays the size of each memory pool and the available free entries Modules Master 1...

Page 50: ...Figure 23 Slave Figure 24 Local Bridge Segments of the surface CAN Gateway Configurator V6 for CAN net NT and CANbridge NT Dashboard Page 46 of 56 4 02 0332 20001 Version 1 7...

Page 51: ...tions masterStatus none No connection M S conf mismatch Ping timeout Operational Not existent M S conf mismatch means that the two configurations on master and slave side do not fit together taskStatu...

Page 52: ...h output the historical program calls Possible file types CONF ERR IPC CXML HFU LUA LCFG JSON In case of CXML the CONF file will be generated and additionally written Possible options p password devi...

Page 53: ...ions of possible options init restarting the device and activating the loaded configuration option for Lua scripts terminal after writing the configuration the program changes to terminal mode and dis...

Page 54: ...of the device Connection to the CAN Gateway Configurator is lost Reset to Factory Settings With Reset to Factory Settings 2 it is possible to reset the configuration of a connected device to factory s...

Page 55: ...he reset Configuration is reset to factory settings Connection to the CAN Gateway Configurator is lost Reset to Factory Settings CAN Gateway Configurator V6 for CAN net NT and CANbridge NT 4 02 0332 2...

Page 56: ...y with password Only with password Locked Locked Changing the runtime configuration and updating the firmware CODE FPGA via USB Permitted Only with password Only with password Locked Changing the runt...

Page 57: ...via Ethernet and the security level is set to 3 or 4 the access via Ethernet is locked For changes the device then has to be connected via USB Security Settings CAN Gateway Configurator V6 for CAN ne...

Page 58: ...opyright notice and this permission notice shall be included in all copies or substantial portions of the Software THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EXPRESS OR IMPLIED INCLUD...

Page 59: ...This page is intentionally left blank...

Page 60: ...This page is intentionally left blank...

Reviews: