From Newsgroup: rec.sport.rowing

<div></div><div></div><div>Further information: Manual for the CAN Logger Utility in PDF format (includes a step-by-step introduction, printable) Description of the CAN Snooper Mode (a simple CAN-bus monitor, implemented as an add-on in the logger firmware) Manual for the CAN Terminal programming tool (link only works if you installed the tool in the default directory). How to invoke the System Menu in your terminal (and how to enter the unlock-code if necessary) Homepage of MKT Systemtechnik (Contact us if you need an unlock-code to enable the logger, or to check if an updated firmware is available) Direct link to the download on the MKT websiteHint: If you use a browser like Firefox, and open the help system from theutility, this document will automtically be scrolled to the right position.The same was possible with IE6. But with IE7, this didn't work anymore. Nowit's your decision which browser to use...Note: If you received this document as a Word- or Adobe Actobat file (pdf)on a CD-ROM, you will possibly read an outdated 'copy' in this moment. Theguaranteed latest revision is only the documentation in HTML format, whichcan be found in the subdirectory \help in the CAN Logger Configuration Utility! To make sure you are studying the latest version of this document, downloadthe CAN Logger Utility from the MKT website, install it, and read the manual in HTML-form with your favourite browser. (Hint: With a good HTML browser like Firefox, these pages can alsobe printed nicely, with properly formatted page borders ) 1. IntroductionThe CAN-Logger/Snooper is an extra software feature in certain terminalsby MKT Systemtechnik or their resellers. A special firmware is needed touse the features described in this document, and the terminal must have aCF- or SD- memory card drive, because the storage medium for the logged datais a Flash memory card with DOS-compatible file system (FAT16, for MKT-View III/IV also FAT32).At the time of this writing, the CAN-Logger/Snooper was supported by thefollowing devices (there may be more than listed below) : MKT-VIEW "plus" with 40 MHz clock, CompactFlash card interface (CF), and a special firmware (art11089.hex) .</div><div></div><div> Note: In this firmware, the CAN Snooper and CAN Logger functions must be enabled by entering a special unlock code. If you want to use one of these functions but haven't unlocked it yet, please contact the manufacturer. Only if you ordered the terminal with this functions already unlocked, you don't need to go through the unlock procedure. MKT-VIEW "II" with ARM-CPU, 72 MHz clock, 4.32 TFT, SD card, firmware #11314. MKT-VIEW "III" with ARM-Cortex M3, 96 MHz clock, 4.3" TFT, SD card, firmware #11392. MKT-VIEW "IV" with ARM-Cortex M4, 200 MHz clock, 7.0" TFT, SD card, firmware #11532.</div><div></div><div> In all devices listed above, the CAN logger feature must be unlocked before use.</div><div></div><div> Devices not listed here can be found in MKT's Device Feature Matrix (external link).Some definitions of terms which are frequently used throughout this document,to make sure we know what we are talking about.. The CAN-Logger is a piece of hard- and firmware inside the programmable terminal. It writes the received CAN traffic to a disk file, message-by-message. To reduce the file size, the CAN identifiers of the logged messages can be selected (from a CANdb file or "manually"). normal "terminal" function remains active in CAN Logger mode</div><div></div><div>(with reduced performance = lower page update rate if bus load is high) high-resolution timestamp for received messages no display from the CAN logger, it works silently in the background logfile must be analyzed on a windows PC later limited message rate due to memory card hardware restrictions (see chapter"Limitations") </div><div></div><div> The CAN-Snooper is a subroutine in the CAN-logger-firmware. When activated, it works like a simple CAN analyzer utility to monitor "unknown" CAN traffic. Received CAN messages are displayed on the terminal's screen. You don't need a PC to use the CAN-Snooper. The CAN-Snooper is a part of the firmware in all display terminals which also have the CAN-Logger functionality. There is no CAN-Snooper without CAN-Logger, and there is no CAN-Logger without CAN-Snooper - except for the possibility that one of these functions is unlocked while the other is not ! A more detailed description of the CAN-Snooper-mode can be found in the description of the programmable terminal, but not in this document (this link only works if you installed the tool in the default directory). This document only describes the CAN-Logger.</div><div></div><div> </div><div></div><div> </div><div></div><div> The CAN-Logger-Configuration / File-Conversion Tool (abbrev'd "CAN logger utility") is a PC program which helps you to configure the CAN logger, and to convert the logged data into a format which can be loaded in your analysis program. The CAN logger utility is *not* a CAN-Logger itself, but it... can read CANdb-files so you can select thesignals which you want to log, lets you modify the logger settings, liketrigger mode, FIFO settings, file size limits, recording interval and more, converts the logfile which is producedby the CAN logger into some format which can be post-processed with otherprograms, like spreadsheets, data visualization tools, statistic evaluationprograms, etc etc. </div><div></div><div>In principle you can use the CAN logger without the CAN logger utility.You can instead write the CAN logger configuration file yourself (with atext editor) and write your own import routine for the logfiles (with aprogramming language of your choice). If you really consider this, look intothe "file formats" section in the appendix ofthis document.The next chapters provide detailed information about the operation of theCAN-Logger Configuration and File Conversion Tool. More information aboutDisplay Terminals with CAN-Logger can be found in the manual of theterminals itself or in the help system of the terminal programming tool.The description of the programmable terminal is beyond the scope ofthis document ! The basic usage of the CANlogger is briefly explained in a later chapter.If you have installed the terminal programming tool in its defaultdirectory, you can follow this link to thedescription of some interpreter commands, which give you "extended" controlover the CAN logger. For normal applications, you don't need to control thelogger via interpreter commands. The only exceptions are the commandspower=1 (to inform the terminal that the powersupply is safe now, so files may be written) andpower=0 (to indicate that the power supply isnot safe anymore, and that ALL files with write-access must be closedIMMEDIATELY). More information is in the help system of the terminal programmingtool.back to top 2. Usage of the CAN Logger Configuration UtilityThis chapter explains how to use the CAN Logger Configuration Utility. Producinga logger configuration file is usually the first step. Theusage of the CAN logger itself is explainedin a later chapter, also how to convertlogfiles will be described later.2.1 Starting the CAN Logger UtilityThe simplest but most ineffective way to start the CAN Logger Configuration/ File Conversion Utility is to double-click its icon on the desktop, orin the task bar. It is easier (for every-day use) to associate the fileextensions "CLC" (CAN Logger Configuration) and "CLD" (CAN Logger Data) withthe utility. A detailed how-to can be found in theappendix.If you double-click on a CAN logger configuration file to start the utility,it automatically switches to the Logger Configuration tab.If you double-click on a CAN logfile (*.cld), the utility automatically switchesto the File Converter tab.To convert logfiles automatically, the program can be invoked with acommand line (use the \bm switch to enter"batch mode").</div><div></div><div>2.1.1 Selecting the target hardware</div><div></div><div>When launching the utility for the first time (after installation), the programwill ask for the target hardware. This is necessary (since February 2008),because some features and array sizes depend on the target. For example,the "MKT-View I" (terminal with C167 CPU) has less trigger signals than alogger built inside the newer "MKT-View II" (terminals with ARM-7 CPU) .The following dialog allows you to select the target hardware (its appearancemay have changed since the time this document was written) :This screen will also appear when you create a new logger configuration,with the option to restore everything to the default values.The properties of the used hardware can be checked in the tabsheet "Setup",on the "Options" panel. Some of the hardware/firmware properties of the selecteddevice are displayed on this panel, for example:When changing the logger device family, beware that they are not 100% compatible.For example, the CAN logger inside the "MKT-View I" can filter out a maximumof 48 different CAN messages from the stream, while the "MKT-View II" supportsa maximum of 128 (or even more). So when switching the device family from"MKT-View II" to "MKT-View I", some message- and/or signal definitions mayget lost.2.2 The CANdb Import / Signal List TabBecause the CAN logger was primarily intended to logCAN-SIGNALS(*), you must selectthese signals on a special tab of the utility:(screenshot CANdb tab)On the CANdb tab, you can Select messages or signals from CANdb files (which can be loaded via the File menu) Add or remove signals from the list of "logged" signals Rearrange the sequenze of logged signals (the buttons with blue arrows mean "move up" / "move down") See some information about a logged signal, including the CAN-ID and some mapping parametersTo import ("load") a CANdb file, use the file menu. If you have used a certainCANdb file earlier, you will find it in the "Most recent CANdb file" list- which is quite handy because this way you don't have to remember the fullpath name, and it may save a dozen mouseclicks in the file selector box.To select signals from a loaded CANdb file, you can use.. a tree view (as shown in the screenshot) a table view (which contains ALL information about the loaded signals) a group of three lists (NODES, MESSAGES, SIGNALS)To copy a signal from the treeview, you can drag it with the mouse and drop it into the list oflogged signals. The same is possible with entire messages (containing multiplesignals), nodes (containing multiple messages), or CAN buses (containingmultiple nodes). You may get a warning if duplicate signal names are alreadypresent in the list of logged signals (in the right part of the window).Avoid duplicate signal names in your CAN databases whereever possible.Alternatively, you can select an item in the table view and thenclick the "Add signal(s) to list" button.The list of logged signals will be saved as part of the logger configurationfile. The CANdb file will never be modified because the CAN logger configurationutility is not a CANdb-editor !You can use up to four of the logged signals astrigger signals. (*)footnote: Apart from selecting logged signals from a CANdb file, it is possible to.. define own messages for logging log "other data" which are not CAN-messages2.2.1 Searching for signal namesTo simplify the selection of signals from large databases, there is asearch function for signal names. You can enter a search patternin the edit field close to the "Search"-button, and press ENTER after that(or click the search button). The search pattern may contain the followingwildcard characters: ? Placeholder for "any single character (letter or digit) * Placeholder for a whole group of characters. Must not be used at the 1st position in the string !Search pattern examples: Thermo searches all signals named "Thermo", in all messages, on all CAN buses, sent by any node in the network. A* searches all signals beginning with 'A' ?bc* searches all signals with 2nd letter = 'b', 3rd letter = 'c', and an unknown number of letters afterwards</div><div></div><div>2.2.2 The "Signal Info" displayThe properties of any logged signal can be displayed in the "Signal Info"box. It is in the lower right corner of the signal definition tab. The contentsof this editor-like window may look like this:</div><div></div><div></div><div></div><div> Display (example) Explanation PrintedChars Signal name id=0x0000007B CAN id (+ explanation of the most significant bits 31..29 if set) node="Terminal" name of the sending node msg="MuxedMsg" name of message containing this signal mapping=(8,8,I,U) mapping info: position of LSBit, number of data bits, </div><div></div><div> byte order: Intel/Motorola, </div><div></div><div> data type: Signed/Unsigned/Float/Double MuxVal=#0, MuxMap=(0,8,I) Only if multiplexed : multiplexor value, multiplexor mapping (see above) To see the properties of the logged signal, select it in the list of loggedsignals. </div><div></div><div>Additionally, you can check the CAN message layout in graphical form as explainedin the next chapter .2.2.3 CAN-Message-Layout displayThe layout of a logged CAN message can be displayed in graphical form. Thismay be handy when problems with the interpretation of different bit-countingschemes occurr (for example, "Intel-format", "Motorola forward", "Motorolabackwards" and other oddities).The graphic shown on the left shows an example of a CAN-message which carriesvarious signals. The currently selected signal is marked with a bold arrow,and its name is displayed at the bottom of the window. The arrow always pointsfrom the least significant bit (LSB at the end) to the most significant bit(MSB at the arrow head).The bit numbers within a data byte are listed at the top of the display.Please note that -as usually for binary numbers- the most significant databitis on the left side; the numbers for 8 bits within a byte always runs from0 (=LSB, right) to 7 (=MSB, left).Within the 64 bit of a CAN data field, the bit count runs as shown in thediagram: The first byte [0] containts bits 7 to 0; the last byte [7] containsbits 63 to 56. It doesn't matter if the CAN message contains signals in Motorola-oder/and Intel-Format ! (Caution, some CANdb-editors count bits in a differentfashion, but of course this must not change the physical position of a bitwithin the CAN frame).If the selected signal is multiplexed (as shown here in the example), notonly the signal's data bits, but also the multiplexer forthis signal will be shown (using the same colour, but hatched). The valuesof the multiplexer-bits will also be displayed (since the multiplexer valueis a constant which identifies this signal). Note: The multiplexer/multiplexor is also called "mode signal" in other documents, but this name is rather meaningless so we avoid it. To select other signals in the displayed message, click into the diagramwith the left mouse button.</div><div></div><div>Contents 2.3 The Logged Messages TabThis tab of the Logger Configuration Tool contains a list of the CAN messageswhich shall be logged (and some other specialities too).The lower part of this tab contains a table for "other" logged values, whichwill be explained in one of the next chapters.But first look at the upper table. It contains a list of allmessages which shall be logged.There is one row in this table for every CAN-message. Thecolumns in this table are: Nr</div><div></div><div> This index references the message. It runs from zero to the maximum number of logged messages. Bus</div><div></div><div> 1 = "Message shall be received from Bus 1 (the first CAN interface)"</div><div></div><div> 2 = "Message shall be received from Bus 2 (the second CAN interface, if available)" CAN-ID</div><div></div><div> CAN message identifier in hexadecimal notation. "0x" is the prefix for a hex number. 11-bit ID's contain three hex digits, 29-bit-ID's eight digits. Message Name</div><div></div><div> Usually copied from the CANdb-file, in the moment when you added CAN signal(s) as explained in the previous chapter. For self-defined CAN messages, you may type short descriptive names, without space characters and other special characters (only letters and underscores). Sender (Node)</div><div></div><div> Identifies the sender (the sending "node") of this message. Remember, one node can send more than one message. Like the message name, this name originates from the CANdb-file. Intv.-Limit (write-interval limit)</div><div></div><div> In this column you can define a message-specific limitation for the write interval in the logger. For example, a message may be transmitted on the CAN bus every millisecond, but you only want the logger to write this message to the memory card every 200 milliseconds. In that case, type "200" into the Interval-Limit column for this particular message. Zero means "there is no individual writing interval limit for this message".</div><div></div><div> Note: There is also a common write-interval limit for all messages (and for logging 'other' data) on the logger configuration tab.Usually this table will be filled automatically when youselect signals for logging. To add entriesmanually (because you have no CANdb file to select signals from), lookhere.</div><div></div><div>Contents 2.4 The Logger Configuration TabSwitch to the "Logger Configuration" tab of the utility. You will see thecurrent settings in several edit fields, check boxes, combo lists etc. Modifythem for your needs and save the modified configuration (the tool will askyou upon exit if you want to save the changes, if any).</div><div></div><div>(screenshot "logger configuration" tab)The controls on this tab are: Info string</div><div></div><div> A string of up to 40 characters which can be displayed on the terminal screen, using the interpreter function "logger.info" .The upper part of the panel titled "What shall be logged ?" contains three radio buttons (only ONE option canbe selected at a time) : Only the selected messages/signals</div><div></div><div> The logger only writes the signals into the logfile, which you selected on the CANdb (or "No CANdb") tab. All signals received by the application</div><div></div><div> The logger only writes those signals into the logfile, which are received by the terminal application. The advantage is, you don't have to produce an extra configuration for every new application of the terminal. Instead, you log all messages which are handled (received) by the terminal. Receive and log ALL CAN messages</div><div></div><div> Useful to analyze the complete CAN bus traffic. This only makes sense if you export a message list later, not a signal list !</div><div></div><div> Caution #1 : This option cannot be used together with the option "Limit write interval for messages" ! Explanation: see appendix.</div><div></div><div> Caution #2 : As a matter of course, CAN logfiles can only be converted (decoded) into physical signals, if the required signal decoding- and scaling information is available to the logfile converter ! Setting the option "Receive and log ALL CAN messages" alone (without adding the required signal definitions from the CAN database) is not sufficient to export decoded signals (not messages) later. Also see the notes on the logfile converter, option "Ignore Signal Definitions from Logfile, use currently loaded signal definitions instead" .</div><div></div><div>The lower part of the "What shall be logged ?" panel allows to select some other data(which are not related with normal CAN messages): script variables declared with the 'logged:' attribute (details in chapter 'Logging other data (no CAN messages)'.) Data from an external GPS receiver CAN error frames (rarely used, not supported by older devices like MKT-View "Plus")</div><div></div><div>Group "Options": Use logfile as circular FIFO, overwrite old data</div><div></div><div> If this option is set, the opened logfile will work like a FIFO buffer, which wraps to the start of the file when the maximum file- or disk-space is exceeded. In other words, if the logfile is "full", the writing-position will jump back to the begin of the file, and the oldest entries are overwritten. When the logfile is closed, only the "newest" data are in it - how many, depends on the maximum fil</div>
--- Synchronet 3.21a-Linux NewsLink 1.2