+ All Categories
Home > Documents > TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer...

TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer...

Date post: 06-Feb-2018
Category:
Upload: truongkhanh
View: 290 times
Download: 8 times
Share this document with a friend
27
tcn-mvb-an_ms_en_105 TCN-MVB-AN SW for MVB Analyzer Programmer’s manual Version 1.05
Transcript
Page 1: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

tcn-mvb-an_ms_en_105

TCN-MVB-AN

SW for MVB Analyzer

Programmer’s manual

Version 1.05

Page 2: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 2/27

AMiT spol. s r.o. does not provide any warranty concerning the contents of this publication and reserves the right to change the documentation without obligation to inform any body or authority about it.

This document can be copied and redistributed under following conditions:

1. The whole text (all pages) must be copied without any changes. 2. All redistributed copies must retain the AMiT, spol. s r.o. copyright notice

and any other notices contained in the documentation. 3. This document may not be distributed for purpose making of profit. The names of products and companies used herein can be trademarks or registered trademarks of their respective owners.

AMiT is a registered trademark.

Copyright (c) 2016, AMiT, spol. s r. o. Producer: AMiT, spol. s r. o.

Naskové 1100/3, 150 00 Praha www.amit-transportation.com

Technical support: [email protected]

Page 3: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

3/27 tcn-mvb-an_ms_en_105

Table of contents

Revision history .............................................................................................. 4

Related documentation ................................................................................... 4

1. Definition of used abbreviations ........................................................ 5

2. AMiT MVB device classes ................................................................... 6

3. Definition of used terms ...................................................................... 7

4. Introduction .......................................................................................... 8

5. Technical parameters .......................................................................... 9

6. ATMA Protocol ................................................................................... 10

6.1. Description of ATMA datagram .................................................................... 10

7. Example tool for MVB frame analysis .............................................. 12

7.1. Dissector installation ..................................................................................... 12

7.2. Post processing and frame filtering .............................................................. 13

8. Loading domains into TCN-MVB-AN ................................................ 17

8.1. TCN-MVB-AN domains ................................................................................ 17

8.2. Loading of new device .................................................................................. 18

8.3. Domain upgrade ........................................................................................... 19

9. Command and Control ...................................................................... 20

9.1. Program description ..................................................................................... 20

9.2. Main window ................................................................................................. 20

9.3. File menu ...................................................................................................... 21

9.4. Status bar ..................................................................................................... 21

9.5. Options menu/Preferences ........................................................................... 21

9.6. Device selection ........................................................................................... 22

9.7. Information frame ......................................................................................... 22

9.8. Line triggers .................................................................................................. 22

9.9. Common triggers .......................................................................................... 23

9.10. Trigger output options ................................................................................... 23

9.11. Reply timeout delay ...................................................................................... 23

9.12. UDP output settings ...................................................................................... 23

9.13. Configuration save button ............................................................................. 23

9.14. MVB bus medium - Electrical mode .............................................................. 23

9.15. MVB master frame trigger ............................................................................ 23

9.16. Domain services ........................................................................................... 24

9.16.1 Operations over domains ............................................................................. 25

9.17. Ethernet settings .......................................................................................... 26

9.18. XML script .................................................................................................... 27

Page 4: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 4/27

Revision history

Document name: tcn-mvb-an_ms_en_105.pdf

Author: Ondřej Maštálka, Adam Dočekal, Michal Tomáš

Version Author Date Changes

100 Dočekal 01. 10. 2014

New document

101 Dočekal 05. 01. 2015

Add related documentation, AMiT MVB device classes and Technical parameters.

102 Dočekal 14. 07. 2015

Remove chapter 7, ADSmanager has independent documentation, change link to web.

103 Dočekal 30. 07. 2015

Corrections, chapter Command and Control added.

104 Tomáš 7. 12. 2015

New hardware RB-MVB/AN02, trigger output, support of EMD, ESD media.

105 Tomáš 20. 05. 2016

Corrections, chapter 6.1 – time resolution, Inserted chapter 7 – example tool, Chapter 9.2 – update figure, Add chapter 9.15 – MVB master frame trigger.

Related documentation

1. RB-MVB/AN02 – Operation manual file: rb-mvban02_g_en_xxx.pdf

2. IEC 61375-3-1 ed1.0:2012 – Multifunction Vehicle Bus (MVB)

3. ADSManager – Programmer’s manual file: ADSManager_ms_en_xxx.pdf

Page 5: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

5/27 tcn-mvb-an_ms_en_105

1. Definition of used abbreviations

AMiT Device Detection AMiT Domain Services Bus Administrator Electrical Middle Distance Electrical Short Distance Master Frame Multifunction Vehicle Bus Message Data Process Data Slave Frame Train Communication Network AMiT TCN MVB Analyzer

ADD

ADS

BA

EMD

ESD

MFR

MVB

MD

PD

SFR

TCN

ATMA

Page 6: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 6/27

2. AMiT MVB device classes

XXX – denotes customer modifications

Class SW identification Description

0 TCN-MVB-LG TCN-MVB-AN

Devices which do not participate in the application data exchange. These devices are invisible (transparent) for other MVB devices.

1 TCN-MVB11_XXX MVB slave devices with DS and PD capabilities.

2 TCN-MVB12_XXX MVB slave devices with DS, PD and MD capabilities.

3 TCN-MVB13_XXX MVB devices with BA, DS and PD capabilities.

4 TCN-MVB14_XXX MVB devices with BA, DS, PD and MD capabilities.

Page 7: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

7/27 tcn-mvb-an_ms_en_105

3. Definition of used terms

Bus Administrator MVB device with Bus Administrator functionality is able to work as an MVB bus Master. This function supposes the device is able to transfer the process data and messages as well as transmit and receive the device status information. Electrical Middle Distance (EMD) This is one type of physical interfaces (media) of MVB line defined in [2]. This medium uses a twisted pair of shielded wires for interconnection. The EMD bus driver is always galvanically separated, typically by the transformer coupling. EMD medium is used for up to 32 nodes and for distances up to 200 m. Electrical Short Distance (ESD) This is one type of physical interfaces (media) of MVB line defined in [2]. This medium uses a pair of wires with differential transmission according to the RS-485 standard, ESD medium is used for up to 32 nodes and for distances up to 20 m without need for galvanic separation. MVB Telegram Master fame and corresponding slave frame.

Page 8: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 8/27

4. Introduction

This manual describes the features of TCN-MVB-AN (MVB analyzer) software. The software is running on hardware from AMiT production which is referred in the following text as target device. List of compatible hardware can be found in chapter Technical parameters. TCN-MVB-AN resends information about frame exchange and events on MVB bus to Ethernet network. The TCN-MVB-AN is a MVB device class 0. TCN-MVB-AN listens to all frames on the MVB bus and forwards them to Ethernet network into UDP ATMA datagrams. The TCN-MVB-AN doesn't transmit any frames on MVB bus hence the TCN-MVB-AN is invisible for other MVB devices. TCN-MVB-AN also evaluates important events on MVB bus and sends information about them to Ethernet network into UDP ATMA datagrams. This document describes the format of ATMA datagrams and the procedure of downloading the firmware. A trigger output is supported by the MVB analyzer RB-MVB/AN02. The trigger can be arisen when an event occurs on the bus. More precisely the trigger is arisen in case of an event which is included in a group of triggered events. The group of triggered events is configured by a user using a PC tool TCN-MVB-AN-CFG, see chapter 9. MVB Analyzer supports EMD (Electrical Medium Distance) medium as well as ESD (Electrical Short Distance) medium. The used medium of the monitored MVB bus is selected using TCN-MVB-AN-CFG, see chapter 9.

Page 9: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

9/27 tcn-mvb-an_ms_en_105

5. Technical parameters

Compatibility IEC 61375-3-1 ed 1.0:2012

Process data No

Message data No

Class 0

Database No

Configuration download Yes

MVB bus monitoring Supported

Trigger output Supported

MVB analyzer RB-MVB/AN02,

RB-MVB/AN01 (obsolete, replaced by RB-MVB/AN02)

MVB

Configuration

Analyzer

Target device

Page 10: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 10/27

6. ATMA Protocol

ATMA Protocol encapsulates and concentrates MVB frames into flow of UDP datagrams. UDP datagrams are sent as broadcast on UDP destination port 56012.

6.1. Description of ATMA datagram

ATMA datagram is composed from 12-byte header and data. Minimum datagram length is 18 bytes, maximum datagram length is 1460 bytes. Datagram is structured as follows: Item Type Length Description

Identification U8[2] 16 bits Identification of the ATMA protocol (4Dh 41h = “MA”)

Version U16 16 bits Version of the ATMA datagram (200)

Seq_number U32 32 bits Sequential number of ATMA datagram

Time_resolution U16 16 bits Timestamp resolution [tick/ ųs]

Nr_records U16 16 bits Number of records

Record entry No. 1

Time_stamp U32 32 bits 32-bit HW record timestamp [ticks]

Control U16 16 bits Record control

Data U8 [2-32] 16-256 bits Frame data (frame record only)

ChkSeq U8 [1-4] 8-32 bits Check sequence (frame record only)

Reserved U8 [0-3] 0-24 bits Reserved for alignment

Record entry No. 2

Time_stamp U32 32 bits 32-bit HW record timestamp [ticks]

Control U16 16 bits Record control

Data U8 [2-32] 16-256 bits Frame data (frame record only)

ChkSeq U8 [1-4] 8-32 bits Check sequence (frame record only)

Reserved U8 [0-3] 0-24 bits Reserved for alignment

Record entry No. n

Time_stamp U32 32 bits 32-bit HW record timestamp [ticks]

Control U16 16 bits Record control

Data U8 [2-32] 16-256 bits Frame data (frame record only)

ChkSeq U8 [1-4] 8-32 bits Check sequence (frame record only)

Reserved U8 [0-3] 0-24 bits Reserved for alignment

The record control has following format:

Type Bit 15

Status Bit 0 – 14

0 = event 1 = frame

Status of record (depends on record type)

ATMA datagram

Page 11: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

11/27 tcn-mvb-an_ms_en_105

The status for the frame has following format:

MVB line Res CRC SQE ALO BNI MCV RFE Frame type Frame length

Bit 14 Bit 13 Bit 12 Bit 11 Bit 10 Bit 9 Bit8 Bit7 Bit6 Bit 0-5

0 = line B 1 = line A

Reserved Check sequence

error

Signal quality error

Active level overbalance

Bus not idle

Manchester code

violation

Receive frame error

0 = slave frame

1 = master frame

Length of the frame

The status for the event has following format:

Frame lost line A Frame lost line B Reply timeout Bus timeout Reserved

Bit 14 Bit 13 Bit 12 Bit 11 Bit 0-10

All multibyte numeric bytes are little endian ordered.

All datagram items are aligned to multiple of its length. Sequential number starts at 1 and it is incremented for each a new outgoing ATMA datagram. It provides possibility to detect a lost datagram. Little endian ordering relates to ATMA datagram items only. Contents of MVB frames are transmitted like byte-stream without endian conversion. It’s up to application to process MVB frames properly, in accordance with data type specification in TCN standard (TCN standard codes all multi-byte numerical types with big endian order).

Note:

Page 12: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 12/27

7. Example tool for MVB frame analysis

MVB frame analysis is done on PC using GNU Wireshark Ethernet frame analysis tool (http://www.wireshark.org)1. ATMA protocol plug-in dissectors were created. The dissectors are written as Lua scripts. The example codes for MVB frame analysis covers IEC 61375 and UIC 556 including E-telegram decoding.

This architecture facilitates the data analysis and user script adaptation for user specific purposes.

Following dissectors are supported: Script Functionality

tcn-mvb-an.lua MVB frame analysis acc. to TCN IEC 61375-3-1

tcn-an-msg.lua TCN message analysis acc. to TCN IEC 61375-2-1

tcn-an-uic.lua UIC message communication analysis acc. to UIC 556

7.1. Dissector installation

Scripts can be installed using the installation tool – TCN-AMiT-AN.exe. The installation tool performs following steps. These steps can be done just as in the case of manual installation.

1) In Wireshark installation directory create a subdirectory “amit”, e.g. “C:\Program Files\Wireshark\amit”.

2) Copy the dissector files tcn-mvb-an.lua, tcn-an-msg.lua, and tcn-an-uic.lua.

3) Edit the file “…\Wireshark\init.lua”

4) Check the attribute disable_lua = false

5) Add following code:

AMIT_SCRIPT_PATH=".\\amit\\"

dofile(AMIT_SCRIPT_PATH.." tcn-mvb-an.lua ")

dofile(AMIT_SCRIPT_PATH.." tcn-an-msg.lua ")

dofile(AMIT_SCRIPT_PATH.." tcn-an-uic.lua ")

6) Wireshark requires restart to apply the new dissectors. Then AWA dissector should appear among enabled protocols.

1 The tool is well introduced on http://wiki.wireshark.org.

Basic characteristic

Page 13: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

13/27 tcn-mvb-an_ms_en_105

7.2. Post processing and frame filtering

Each ATMA (TCN-MVB-AN) datagram displayed in Wireshark contains one or several records captured by the analyzer. One datagram can include several MVB records. These datagrams allow MVB frame analysis at the TCN level (IEC standard). More convenient analysis including record filtering and coloring rules requires a datagram post-processing. This post-processing splits the records in order to one ATMA datagram which contains one record or couple of master and slave records.

Event is logged by analyzer every time when a MVB frame is received or an erroneous event is announced.

To post-process the Wireshark records it is possible to use ATMAC utility. This utility works with “.pcapng” Wireshark record file. This record file can be created by Wireshark (File → Save As … and choose file type with extension “pcapng”). The parameters of ATMAC utility are subsequently the original pcapng file and the new pcapng split file.

ATMAC.exe [–i] <inputfile> [–o] <outputfile> [-m<mode>]

ATMAC.exe –i original_file.pcapng –o split_file.pcapng –m5

ATMAC supports 5 modes of converting ATMA datagrams into MVB records:

1 – single record,

2 – couple of master and slave or master and reply timeout records,

3 – couple of master and slave or single reply timeout records,

4 – couple of master and slave or master and reply timeout records, together lines A and B,

5 – couple of master and slave records, only one non-redundant line (recommended for message data processing).

In the new file the records are split so the coloring rules and records filters can be applied. In the post-processed file it is possible to provide communication analysis up to the layer of UIC 556 with tcn-an-uic.lua.

These filters enable to select a certain types of records which are inspected. Particular filtering keywords are accessed using the dot convention or using interactive help of Wireshark environment. For more information, please refer to Wireshark documentation.

Event

ATMAC

ATMAC modes

Event filtering

Page 14: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 14/27

The root keywords of filtering are

Keyword Functionality

tcn-mvb-an filtering according to TCN IEC 61375-3-1:2012

tmsg message filtering according to TCN IEC 61375-2-1:2012

uicmsg message filtering according to UIC 556:2010

Fig. 1 - Filter expression

Other most important keywords for the tcn-mvb-an filtering are:

Keyword Description

id Identification

ver Version

seq_nr Sequence number

tmps_res Timestamp resolution [ticks/us]

nr_recs Number of records

recs_data Records data

recs_data.rec recs_data.rec.timestamp recs_data.rec.ctrl recs_data.rec.ctrl.type recs_data.rec.ctrl.sts

Record Timestamp [ticks] Control Type Status

recs_data.frm recs_data.frm.data

MVB Frame Frame data

Page 15: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

15/27 tcn-mvb-an_ms_en_105

recs_data.frm.fcode recs_data.frm.addr

FCode Address

Other most important keywords for the tmsg filtering are:

Keyword Description

data Packet Message Data

cc Packet Connect Confirm

cr Packet Connect Request

dc Packet Disconnect Confirm

dr Packet Disconnect Request

dstaddr Destination Network Address

mtc MTC

srcaddr Source Network Address

Other most important keywords for the uicmsg filtering are:

Keyword Description

current_nadi Current NADI Items

national_application_code Application code

national_telegram_code Telegram code

rucode RU code

source_function Source function

source_vehicle Source vehicle

status E-telegrams status

target_function Target function

target_vehicle Target vehicle

uic_telegram_code UIC telegram code

ums UIC Mapping Server Status Information

Filtering for frames for fcode equals 15 (message data) and with address equals 1 can be defined for instance as:

Page 16: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 16/27

Fig. 2 - Example of FCode and Address frame filtering

Page 17: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

17/27 tcn-mvb-an_ms_en_105

8. Loading domains into TCN-MVB-AN

This chapter describes how to load the current domain version into a new device, or how to perform the domain upgrade for used device. Domain can be considered as contiguous memory block.

8.1. TCN-MVB-AN domains

TCN-MVB-AN on target device contains the following domains:

Domain Manufacturing status

Description / Upgrade

Loader Loaded Loader Upgrade: No

Executed application Free Information about running application Only informative

Application update Free Valid application Upgrade: Yes

Safe application Loaded Safe application, no analyzer functionality Upgrade: Yes

MVB controller Free FPGA data in device Upgrade: Yes

MVB controller safe Loaded FPGA safe data Upgrade: Yes

Journal Loaded Operating journal Upgrade: No

All domains are supplied by AMiT company. Current versions are available here:

http://imp.amit.cz/www/mvb/tcn-mvb-an/index.htm Only correct domain file can be loaded into appropriate domain. When loading, the data header is checked, therefore incorrect data cannot be loaded. Domain filenames:

Domain File

Loader mvb10_l_xxx.bin

Application update mvb1an02_1_a_xxx.dom

Safe application mvb1an02_1_s_xxx.dom

MVB controller mvb1an02_1_f_xxx.dom

MVB controller safe mvb1an02_1_e_xxx.dom

xxx – denotes version

Page 18: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 18/27

8.2. Loading of new device

Target device comes from production with station firmware loader (mark as Safe Application) and safe MVB controller copy. It is necessary to load the Application and MVB controller before the first use. To load files, it is necessary to download, from web address mentioned in chapter 8.1, the ADSManager program, actual versions of application program and MVB controller. For detailed usage of ADSManager software see related documentation on page 4. Most of the operations described below can also be accomplished using the Command and Control software (see chapter 9). Service mode is indicated by permanently lighting LED RUN.

Device is switched to service mode, if at least one of following cases is completed:

Device stays in service mode, when it is produced by manufacture, until application loaded.

RESTORE button is pressed.

Safe mode is activated using the ADSManager (see related documentation section on page 4) or Control and Control software (see chapter 9).

For loading new application to device via ADSManager, please follow procedure below: Connect device to Ethernet network with connected PC

Launch the ADSManager program

Set in the Menu – Options – Preferences

Communication channel to Ethernet

Port to value 75

Optionally you can select default folders with *.dom files

Power on target device.

In Device list, the target device will appear (if not, click Search again). Premature search termination can be done with Esc key.

Launch the Domain services by click on device (context menu is activated by right mouse button).

Click on “MVB controller” domain and start the Download domain service from the context menu. After loading, the device restarts itself.

Click on Application update domain and start the Download domain service from the context menu. After loading, the device restarts itself.

Now the device is completely operational.

Service mode

Procedure

Page 19: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

19/27 tcn-mvb-an_ms_en_105

8.3. Domain upgrade

When any domain needs to be upgraded on device in operation, follow the procedure below: Connect device to Ethernet network with connected PC.

Launch the ADSManager program.

Set in the Menu – Options – Preferences.

Communication channel to Ethernet,

Port to value 75,

Optionally you can select default folders with *.dom files.

Power on target device.

Start auto detection in main program window.

In the Device list, the target device will appear (if not, click Search again).

Launch the Domain services by click on device (context menu is activated by right mouse button).

Click on domain which is to be upgraded and start the Download domain service from the context menu. After loading domain, the device restarts itself.

Procedure

Page 20: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 20/27

9. Command and Control

The MVB analyzer is controlled and configured using a PC tool TCN-MVB-AN-CFG. The PC tools can be downloaded from website:

http://imp.amit.cz/www/mvb/tcn-mvb-an/index.htm The website is maintained by AMiT as the project website for the MVB Analyzer.

9.1. Program description

The software provides simple way to configure the behavior of the MVB analyzer e. g. setting up triggers for both lines and configuring the subsequent communication with Ethernet or the behavior of the analog output. Program also includes a domain manager for the analyzer. Usage of an external ADSManager is therefore unnecessary.

9.2. Main window

Fig. 3 - Main window

Page 21: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

21/27 tcn-mvb-an_ms_en_105

Number Description

1 Main menu

2 Device selection

3 Information frame

4 Status bar

5 Line triggers

6 MVB master frame trigger

7 Common triggers

8 UDP output settings

9 Medium of MVB bus

10 Trigger output options

11 Reply timeout delay

12 Configuration save button

9.3. File menu

Terminate the program. (Hotkey: Alt + F4). Initiate the search for compatible devices. The search can also be initiated by

pressing the button. (Hotkey: F5). Cancel a search in progress. (Hotkey: Esc).

9.4. Status bar

The text aligned to the left on the status bar indicates the result of the most recent operation. The text aligned to the right on the status bar indicates currently used port of the UDP communication. Unless changed the value should stay on a value of 75.

9.5. Options menu/Preferences

Fig. 4 - Preferences window

Preferences provide a way to change settings that are necessary for communication in the direction from the Command and Control software to the

Legend

Exit

Search

Search Cancel

Status

Ethernet

Page 22: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 22/27

connected analyzer. It is advised to not change these setting without a strong reason. Communication channel type, for Command and Control software only Ethernet. Ethernet port number. This field corresponds with the Ethernet field on status bar. The period of time to wait before connection times out. Serial port number – not used.

9.6. Device selection

After a search is completed all found devices can be found in a list in the Device selection frame. Basic information about any displayed device can be found here as well. Upon selecting a device by left mouse click more detailed information can be found in the Information pane below.

Upon right mouse click on a found device a context menu for such device is invoked. This context menu provides tools for in depth management of used devices. It consists of following items: Read the list of domain from a device (see chapter 9.16).

Switch the device in to the service mode; Safe application starts.

Reset a device. Display window for reading XML script. XML scripts serve, for example, for multiple domain update (see chapter 9.18). Change of IP address, mask or default IP gateway (see chapter 9.17).

9.7. Information frame

The information frame provides a detailed categorized view on available information for a device selected in the device selection frame. All shown information have purely informative character.

9.8. Line triggers

One of the main functions of the Command and Control software is customizing the triggers and subsequent reaction of a MVB analyzer. Which events trigger evoke a reaction of the MVB analyzer is set independently for master and slave frames separately for each line (A/B). The triggers are based on the IEC 61375-3-1 ed1.0:2012 norm.

Comm. channel

UDP port

Timeout

COM

Domain services

Switch to service mode

Reset device

Load XML

Ethernet settings

Page 23: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

23/27 tcn-mvb-an_ms_en_105

9.9. Common triggers

Common triggers are when active used for both lines. These triggers are also based on the IEC 61375-3-1 ed1.0:2012 norm.

9.10. Trigger output options

Trigger output options modify the behavior of the analog port. These options include the possibility of changing the polarity and setting the pulse length to be sent when triggered. Manual trigger controls are to simulate a trigger and evoke the reaction of the device without the need of such event happening on the MVB bus.

9.11. Reply timeout delay

This property sets length of time to wait before Reply timeout trigger is invoked.

9.12. UDP output settings

Configuration of how the MVB analyzer sends data to the Ethernet.

9.13. Configuration save button

Saves the current configuration and sends it into the MVB analyzer.

9.14. MVB bus medium - Electrical mode

This property enables configuration of the following media of the MVB bus according [2]:

EMD – Electrical Medium Distance medium,

ESD – Electrical Short Distance medium.

9.15. MVB master frame trigger

This property enables configuration of generation trigger on analog output according content of the MVB master frame. The following modes are supported:

only F-Code triggering,

only address triggering,

F-Code and address triggering.

The address can be masked hence it can be captured group of addresses. Configurable master frame content can be applied separately to MVB line A or to MVB line B or to both. The trigger is active on the analog output after master

Page 24: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 24/27

frame reception with a delay according to the active line (delay is approximately from 2 to 3 microseconds for line A and from 6 to 8 microseconds for line B).

9.16. Domain services

Fig. 5 - Domain list window

Number Description

1 Main table

2 Sub-table

The main table shows current list of domains.

If the domain is active, the line is blue, when damaged or free, the line is red. Otherwise the line is black.

ID – the domain ID.

Memory – type of used memory (ROM, Flash, …).

User rights – RE = reading, WR = writing, DW = download, SR = sequential reading, RU = rights to run, DI = dictionary with parameters.

Version – domain version.

Legend

Main table

Page 25: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

25/27 tcn-mvb-an_ms_en_105

Description – domain description.

The sub-table shows detail parameters of particular domain. Sub-table content varies according to line selected in main table.

File – file name specified by AMiT company.

DB name – database name specified by user in configurator tool (N/A).

MAC – network interface MAC address.

Offset – retrieved domain offset (0 to DMNS – 1).

DMNS – overall number of domains included in device.

Max Size – domain total size.

Current Size – occupied domain size.

Free Size – domain free size in %.

Time – time of domain creation/change.

Usage – domain occupation type (empty, debug, internal, release).

State – domain data status.

Appl ID – bottom Word = HWID, Upper Word = PID.

Hwid ID – station identifier.

PID – process/application identifier.

Cfg ID – station modification identifier.

Cfg Mask – Cfg ID mask for given domain.

Sig – domain signature (specifies meaning of domain content).

9.16.1 Operations over domains

Several operations over domains can be accessed from a context menu. The context menu for a particular domain can be invoked by first selecting the domain with a left mouse click on a domain line and the pressing the right mouse button. When invoking the context menu it is important to have right domain selected since the context menu is always opened for the selected domain.

Read Domain – domain contents retrieval. Provides retrieval of domain content from the device and it's storing to *.dom type file.

For Journal type domain – the text form *.log can be displayed.

Download Domain – loading the domain into device. Provides loading of selected domain into the device. After successful downloading, the user is prompted to activate data. When refused, the domain will be inactive up to next device restart.

Compute CRC – retrieving/calculating CRC. When user activates the item, program first tries to read CRC from the device, if available. If unavailable, calculation is made. User can also force the calculation by pressing the Compute button in window for calculation.

Compute SHA1 – retrieving/calculating SHA1. The process is similar to the CRC calculation.

Sub-table

Page 26: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

tcn-mvb-an_ms_en_105 26/27

Fig. 6 - Domain data flow scheme

9.17. Ethernet settings

Fig. 7 - Ethernet settings window

Number Description

1 PC network info

2 Device network info

Pc network info shows network parameters of currently used network PC network adapter.

IP – IP address of currently used network adapter.

Mask – Network mask of currently used network adapter.

Adapter – Name of currently used network adapter.

Legend

PC network info

PC

Target Device

READ

DOWNLOAD

Page 27: TCN-MVB/AN - SW MVB Analyzer - Programmer’s manual · PDF fileSW for MVB Analyzer Programmer’s manual ... MVB frame analysis is done on PC using GNU Wireshark Ethernet frame ...

TCN-MVB-AN

27/27 tcn-mvb-an_ms_en_105

Device network info shows network parameters of selected device.

IP – Current IP address of selected device.

Mask – Network mask of selected device.

Gateway – Gateway of selected device.

9.18. XML script

XML script contains list of domains for update. Scripts are provided by AMiT company.

Window for working with XML scripts can be invoked from context menu “Load XML” after the device is found.

Browse script – browse script.

Clear – clear the command line window.

Run script – run script.

Fig. 8 - GUI XML script – domain update

Device network info


Recommended