CBL-DV10

DigiView User's Guide © 2017 TechTools DigiView User's Guide © 2017 TechTools All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of TechTools except for the purpose of enhancing the operation of the product by the end user, informing other prospective users of the product's features or for instructional benefit by the US Government or an educational institution. While every precaution has been taken in the preparation of this document, TechTools assumes no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code or hardware that may accompany it. In no event shall TechTools be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Printed: May 2017 in Rowlett, Texas U.S.A. Publisher TechTools P.O. Box 2408 Rowlett, TX 75030-2408 U.S.A. Technical Sales (972) 272-9392 Fax (972) 494-5814 Email Sales@tech-tools.com Support@tech-tools.com On The Web www.tech-tools.com Contents I Table of Contents Foreword 0 2 Part I Getting Started 1 Installing the Software ................................................................................................................................... 3 2 Installing the USB ................................................................................................................................... Drivers 3 3 USB Connection ................................................................................................................................... 4 4 Menus, Tool Bars ................................................................................................................................... and Mouse basics 5 Top Tool Bar .......................................................................................................................................................... Bottom Tool Bar .......................................................................................................................................................... 7 9 5 Window Arrangement ................................................................................................................................... 9 Docking Windows .......................................................................................................................................................... Tabbing Windows .......................................................................................................................................................... Tab Window ......................................................................................................................................................... Options Alignment Management .......................................................................................................................................................... Part II Project Operations 10 12 14 18 20 1 Project Selections ................................................................................................................................... 22 2 Creating a New ................................................................................................................................... Project 23 3 Cloning Projects ................................................................................................................................... 26 4 Creating & Managing ................................................................................................................................... Templates 28 Part III Configuration 33 1 Connecting the ................................................................................................................................... Data Lines 33 2 Defining Signals ................................................................................................................................... and Triggers 35 Signals .......................................................................................................................................................... Signal Editors ......................................................................................................................................................... Boolean ......................................................................................................................................... Bus ......................................................................................................................................... CAN BUS ......................................................................................................................................... Asynchronous ......................................................................................................................................... I2C ......................................................................................................................................... I2S ......................................................................................................................................... State ......................................................................................................................................... Synchronous ......................................................................................................................................... SPI Signal Properties ......................................................................................................................................... Plotting Signal ......................................................................................................................................................... Data Triggers .......................................................................................................................................................... Simple Trigger ......................................................................................................................................................... Advanced......................................................................................................................................................... Trigger Trigger Match Types ......................................................................................................................................... Pattern Match ................................................................................................................................... Edge Match ................................................................................................................................... Stable Match ................................................................................................................................... Equal Match ................................................................................................................................... Not Equal Match ................................................................................................................................... 35 37 40 42 44 47 50 54 56 59 62 66 69 71 73 77 79 80 81 83 85 © 2017 TechTools I II DigiView User's Guide Greater Than Match ................................................................................................................................... Greater Than or................................................................................................................................... Equal Match Less Than Match ................................................................................................................................... Less Than or Equal ................................................................................................................................... Match Sequencer ......................................................................................................................................... 87 89 91 93 95 3 Analyzer Options ................................................................................................................................... 96 Buffer Settings .......................................................................................................................................................... 97 Voltage Threshold .......................................................................................................................................................... 99 Glitch Filter .......................................................................................................................................................... 109 4 Acquisition................................................................................................................................... Options 110 5 Color Themes ................................................................................................................................... 113 Theme Examples .......................................................................................................................................................... Custom Theme .......................................................................................................................................................... 116 123 6 Using the Color ................................................................................................................................... Selector 125 7 Environment ................................................................................................................................... Settings 127 Part IV Capturing Data 131 1 Hardware Status ................................................................................................................................... 132 2 Capture History ................................................................................................................................... 133 3 Status Window ................................................................................................................................... 135 Part V Navigating and Analyzing the Data 138 1 Waveform Views ................................................................................................................................... 138 Toolbar Buttons .......................................................................................................................................................... Mouse Functions .......................................................................................................................................................... Snap and Value .......................................................................................................................................................... Columns Bird’s-Eye Scrollbar .......................................................................................................................................................... Marquee Zoom .......................................................................................................................................................... Using Markers .......................................................................................................................................................... Key Functions .......................................................................................................................................................... 141 143 146 149 150 151 159 2 Measurements ................................................................................................................................... 161 Instant Measurements .......................................................................................................................................................... Quick Measurements .......................................................................................................................................................... Dynamic Measurement .......................................................................................................................................................... Window Marker Time/Delta .......................................................................................................................................................... 161 163 166 171 3 Table View ................................................................................................................................... Windows 173 4 Tabular Views ................................................................................................................................... 176 5 Using Link Groups ................................................................................................................................... 180 6 Searches ................................................................................................................................... 181 Define Searches .......................................................................................................................................................... 181 Search Types ......................................................................................................................................................... 183 Sequential Searches ......................................................................................................................................... 183 Pattern Searches ......................................................................................................................................... 187 Searching .......................................................................................................................................................... 188 Search Manager .......................................................................................................................................................... Window 188 Auto Search.......................................................................................................................................................... Windows 190 Capture History .......................................................................................................................................................... Searching 192 © 2017 TechTools Contents Part VI Exporting III 196 1 Exporting All ................................................................................................................................... Signal Data 198 2 Exporting from ................................................................................................................................... List Windows 200 3 Exporting from ................................................................................................................................... Table Windows 202 Part VII Printing and Saving Images Index 205 211 © 2017 TechTools III Getting Started Part I Getting Started 1 2 Getting Started DigiView User's Guide Version 9.2, Last Updated 05/24/2017 www.tech-tools.com (972) 272-9392 Email Support Email Sales Thank You for choosing TechTools for your development needs. DigiView is a highly productive, thoroughly integrated tool with many in-depth features when compared to other PC based Logic Analyzers. Each feature is deeply integrated and complete with options that might not be immediately apparent. To benefit from all of DigiView's features we suggest taking the time to briefly review our User's Guide. Some portions will cover obvious features or those you may already be aware of however, you may find one of those 'must have' features once you review this guide and start using the software. § Installing the Software 3 § Installing the USB Drivers § USB Connection 4 3 Launching the software can be done by any of the standard methods (Start Menu, Desktop Shortcut, selecting "Open" on a project file, etc). But the following sections provide much needed information on what to do when the software launches and some basic usage that will help you get the most benefit from our software such as using the Left or Right mouse buttons on many of our buttons to activate opposite or symmetrical functions (Dual Function Buttons). Some 'Must See' Basics The Section "Menus, Tool Bars and Mouse Basics" covers some fundamental basics used throughout the program such as using both Left and Right mouse clicks on many of our dual function buttons. See: Menus, Tool Bars and Mouse Basics 5 Some Layout and Window Placement DigiView's software has a very customizable user interface to adapt to your needs. Docking, Tabbing and aligning the various Feature Windows on the screen is covered in the Window Arrangement section. See: Window Arrangement © 2017 TechTools 9 3 DigiView User's Guide Getting a Project Started After installing the software and connecting the DigiView hardware we suggest opening some of the included project examples to experiment with, even if your Device Under Test is configured differently than the example. This will help you get familiar with the flexibility of DigiView's software. The section "Project Selections" covers the initial startup screen and selecting one of our example projects (that come complete with captured data). See: Project Selections 1.1 22 Installing the Software Chances are that you already know this part but ... Install first, then connect Always install our software before connecting the DigiView Logic Analyzer to the PC. The Operating System can become confused if it sees the device connected before the proper drivers have been installed. Installing from CD ROM Insert the CD ROM in your CD Drive. If the installation program does not auto-start, then go to the CD ROM drive and Double-Click on the only executable file in the root directory of the CD. If you are presented with a choice of products, select the DIGIVIEW software and follow the prompts to complete the installation. Installing from a WEB Download If you downloaded the software from our web site, double-click on the file you downloaded to launch the self-extracting install program. Follow the prompts to install the software. (see also: Installing USB Drivers 1.2 3 ) Installing the USB Drivers Our DigiView software and drivers are Authenticode signed. If Windows reports that the publisher is unknown or that the software is not signed, then the files are corrupt, infected or otherwise modified. Cancel the installation, delete the file and download an authentic copy from our web site: http://www.tech-tools.com. The Authenticode signature is timestamped to ensure the signature remains valid even if our Certificate eventually expires. In other words, it will not 'time-out.' You will be able to re-install the software and drivers, even if we go out of business or fail to renew our certificate. Run the application installer BEFORE plugging in the hardware. It installs the application software and pre-installs the drivers. You can accept the defaults or modify to suite your needs. Depending on your version of Windows and settings, the system might ask your permission when © 2017 TechTools Getting Started 4 installing the application and again when the drivers are installed. When the installation is complete, plug the DigiView into a USB 3.0 SuperSpeed (supported by DV5 series) or a USB 2.0 high-speed port. Preferably connect to a port directly mounted to the motherboard at the rear of the computer. Current versions of Windows will see the hardware, locate the pre-installed drivers and complete the driver installation. NOTE: The very first time DigiView is connected, the Operating System will complete the driver installation. If you receive the message "Driver Failed", then you may need to reboot the computer in order for the OS to finish the installation it started when you connected DigiView. This version is compatible with Win 7/8/10 (32bit and 64bit versions). Driver Framework If this is the first driver on your system to use the latest driver framework, Windows will take additional steps to update the system. Newer frameworks coexist with older frameworks, ensuring that existing drivers continue to operate as before. Unfortunately, this takes Windows several minutes and requires a system reboot to complete. Note that this update occurs (if required) when you connect DigiView to the PC – not during our application install. 1.3 USB Connection Power: § DV3100, DV3109, DV3200, DV3209, DV3409, DV509, DV518: Plug DigiView directly into a USB port on your PC or into a POWERED HUB. If using an external hub, you should use one with its own power supply. Most bus-powered hubs can not provide enough power to operate DigiView. § DV3400, DV3500: Powered by an external power supply, so USB power is of no concern. Speed: § DV3100, DV3109, DV3200, DV3209, DV3400, DV3409, DV3500: You will experience better performance on a 2.0 port (High Speed @ 480 Mbps), but a 1.1 port is sufficient. § DV509, DV518: You will experience the best streaming performance on a 3.0 port (SuperSpeed @ 5 Gbps). However, these units are compatible with 2.0 ports (High Speed @ 480 Mbps). You can still stream at most sample rates using a 2.0 port unless the data rates are too high. If the streaming terminates early the guaranteed minimum is still captured in the large Hardware buffer. Connection Quality: Preferably, use a high-speed USB port located directly on the motherboard at the rear of the computer or a port anywhere on the computer case that utilizes a high quality cable internally. If you use a different USB cable than the one provided with the unit, it should match the full rated speed of the USB connection to prevent communication errors or loss of data. © 2017 TechTools 5 1.4 DigiView User's Guide Menus, Tool Bars and Mouse basics This section covers some fundamental basics used throughout the program. Knowing this information will be a tremendous help if you have never used our software or are updating to the latest version. Menus Due to having numerous menus in the application, all menus have a Title Bar for identification. Clicking anywhere in the title of a menu will dismiss it. The Main Menu - Our application menu has changed to a single-button vertical menu located in the upper-left corner of the main application window's top tool bar. Local Menus - Each feature window has its own local menu on its tool bar. Some windows will have an additional menu accessible by a Right-Click in the body of the window or other objects that will display a menu when clicked. Common Local Menu "Window" Item - Menu items on the local menu are options or functions specific to the window's content. Local Menus also have a "Window" menu item with common general options such as Tool Bar visibility and placement, Font properties, undocking and so forth. Tool Bars The main application has two tool bars. One at the top and bottom of the application window. see Top Tool Bar 7 , Bottom Tool Bar 9 © 2017 TechTools Getting Started 6 Local Window Tool Bars - All docking windows have a configurable tool bar that auto-positions itself at the top or left side of the window depending on the height to width ratio and where the window is placed. This feature can be disabled and tool bar placement can be chosen by using the local menu's Window option. These tool bars can also be hidden by double clicking on any area not occupied by a button or by using the small triangle in the upper-left corner. Repeating the process will re-open the tool bar. Tool Bar Top Tool Bar Closed © 2017 TechTools Tool Bar Left 7 DigiView User's Guide Mouse Basics DigiView software uses the mouse position and mouse clicks to determine which window will respond to mouse wheel movement and keyboard actions. It also responds to Left and Right mouse clicks on the same item with different actions. The Middle mouse wheel (button) is also utilized when clicked. When moving the mouse over a docked window or clicking on its border or tool bar, its contents will appear to depress with a line drawn around it, meaning it will now respond to any key strokes or mouse wheel movements. Focus Example: If you position the mouse over a Waveform window, then press a cursor key, the window will scroll (see Waveform View Mouse Functions 143 ). Left/Right Click Example: A Left-Click on a Search Button 188 will search backwards from the point clicked, while a Right-Click on a Search Button will search forward from the point clicked. Most symmetrical or opposite functions utilize a Left and a Right click. Middle Mouse Button Example: Clicking the middle mouse button in a Waveform View will activate Quick Measurements 163 and the measurement starting point in Waveform Views. 1.4.1 Top Tool Bar The tool bar at the top of the main application window provides fast access to the main menu, several common project functions, analyzer control buttons and a hardware status message. The Main Menu - Opens the vertical application menu. Access all major features, project settings, search definitions, windows, configuration options, printing, saving images and exporting from a single menu format. Project Selections - Opens the Project Selections existing project or load an example. 22 window to start a new project, choose an Save Project - Saves the project including the currently loaded capture data. See Project Operations 20 . Project Settings - Opens the Project Configuration Options 33 window. Create Signal Definitions 35 , formulate an advanced Trigger 69 , set the Analyzer options 96 , control the Capture History 133 and set Acquisition options 110 . © 2017 TechTools Getting Started Add a New Signal - Opens a selection window for adding a Signal 35 8 to the project. Delete a Signal - Opens a selection menu of all Signal Definitions currently in the project. Selecting an item will remove it from the project and any other windows or configurations such as Trigger configurations, Search definitions, Tables and List views. Open a Feature Window - Select from several feature windows such as another Waveform View 138 , a Measurements 161 window, an Auto Search 190 window, a Marker Time/Delta 171 window, a Status 135 window or create a Tabular View 138 for any Signal Definition in the project. Search Manager - Opens the Search Manager 188 window or brings it into view if already open. Manage Search Definitions 181 and perform manual searches 188 directly from this window. Single or Split Waveform View - Two waveform views are always present in the center of the main application window. This button toggles the visibility of the secondary Waveform View 138 . Link and Unlink Waveforms - The Primary and Secondary Waveform views are permanently assigned to Link Groups 1 and 2 respectively. Use this button to temporarily cross-link the two groups so that all windows in both groups will stay time synchronized when any window of either group scrolls. Normally this would occur only within the same Link Group 180 . Analyzer Control and Status Message - Control buttons to activate the Analyzer's run modes (Preview, Auto Run, Run Once... for details see Capturing Data 131 ). A Status Message and trigger indicator are displayed immediately to the right of the Analyzer control buttons (for Details see Hardware Status 132 ). © 2017 TechTools 9 1.4.2 DigiView User's Guide Bottom Tool Bar The tool bar at the bottom of the main application window provides fast access to the Capture History, the Analyzer status indicators and the project's assigned analyzer configuration. The Project's assigned analyzer configuration - On the left of the bottom tool bar is displayed the Analyzer model and mode the project is configured to use. To configure the project for a different analyzer model or mode without starting from scratch, use the Clone Project option (see Cloning a Project 26 ). Capture History Buttons and Selection Bar - Buttons to access the Capture History menu, Capture History Acquisition Options, Browsing, Bookmarking and deletion. The Bar Graph also behaves similar to a scroll bar by providing a means to quickly load a capture and see it's relative position in the history. For complete details see Capture History 133 . Hardware Status - On the right of the bottom tool bar is the Hardware Status indicators. For complete details see Hardware Status 132 . 1.5 Window Arrangement DigiView makes extensive use of Docking and Tabbing to permit very flexible window arrangements. All window settings, positions and sizes are saved along with the captured data anytime you save a project file. If the Auto Save feature is enabled this will also occur when exiting the program or opening a different project. These settings are all restored when you start the software or load an existing '.DVDAT' file (see Project Operations 20 ). The main application can be referred to as the Primary or Main window. The feature windows created from the Feature Windows menu or from the 'Windows' item of the main menu can be referred to as "secondary" or "dockable" windows. To open a new window, select the "Feature Window" button (highlighted below) from the main tool bar or select Menu-> Window-> New. © 2017 TechTools Getting Started 10 After opening a new window you can choose to move it anywhere on any monitor (multiple monitors are supported) or dock it into one of the 6 docking areas of the primary window. You can also create a Tabbed set of windows by docking it into a secondary window, even if that window is already docked. § Docking Windows 10 § Tabbing Windows 12 § Alignment Management 1.5.1 18 Docking Windows Dock Sites The main application form has 6 docking sites that surround the two permanent Waveform Views that are in the center of the window; top, bottom, far top, far bottom, left and right. Any of the secondary windows can be 'docked' to one of these sites by dragging the window over the site. To prevent docking while dragging a window near a dock site, hold the Control key down while dragging. Docking sites are invisible until a window has been docked. After docking a window, the dock displays a "handle" that can be used to size the dock or even close it. When all docked windows are removed from a dock it will automatically close and become invisible again. The image below was taken after docking a window in each site and then closing the dock so their locations are visible. The visibility of a closed dock site depends on the chosen color theme. The default theme (Slate) is used for all images in our documentation. © 2017 TechTools 11 DigiView User's Guide Docking a Window When dragging a window over a docking site, a red rectangle appears to indicate that the dock site is willing to accept the window. Releasing the mouse button at this point docks the window to the main form at this spot. Multiple windows can be docked into each of the dock sites in a variety of positions. As you drag additional windows over a given dock site, a different red rectangle indicates where the window would split into the dock site. You can drag it near the upper, top, lower, bottom, left or right edges to control the placement. If you drag the window inward a bit more, the rectangle may change slightly to indicate a willingness to split the space occupied by an existing docked window rather than the dock site itself. Dragging the window further towards the center of a docked window will cause the rectangle to center in the window, which indicates the new window will "TAB" with the existing window (see: Tabbing Windows 12 ). This flexibility allows you to dock the windows in virtually any configuration. Floating a Window To 'undock' a window, simply drag it off of the dock site by its title bar or use the local menu item of Window-> undock. Tabbed windows can be undocked by clicking on the up arrow in its upper right corner, dragging its title bar or Right-Click on the tabs and select Undock. To remove a window from a group of tabs, simply drag its tab away from the group or use the local menu item of Window-> undock and it will become an independent window again. Any docking window can be undocked or removed from a Tab group by using the window's local menu. Docking Override If you wish to drag a window near a dock site but do not want it to actually dock, hold down the control key while dragging. This will disable the docking behavior, allowing you to drop the window without docking it. (also see: Tabbing Windows 12 ). © 2017 TechTools Getting Started 1.5.2 12 Tabbing Windows Secondary windows can be merged together by dragging one window over another. When you drag any secondary window over another secondary window, a centered rectangle line appears. Dragging one window over another Docking rectangle indicates the two windows will 'Tab' together This indicates that dropping the window at this point will merge them together into a single window. Each original window appears on a TAB in the new window. Dropping additional windows onto the tabbed window creates additional tabs. © 2017 TechTools 13 DigiView User's Guide Tabbed windows can be docked just like any normal window. Also, a secondary window can be tabbed with a secondary window that has already been docked. Simply drag the window over the center of the docked window until you see the centered red rectangle. This will TAB them together at the docked location rather than dock the new window next to the existing window. Floating a tabbed window You float a tabbed window by dragging it off the dock site using its title bar, click on the up arrow in its upper right corner or Right-Click on the tabs and select Undock. This will float the entire tabbed window, keeping all of its tabs intact. De-Tabbing a window To remove a window from a tab, simple grab the tab and drag it,double-click on the tab or use its local menu item of Window->undock. This extracts the window from the tabs and floats it. When only two windows are tabbed together and one of these is removed, the tabbed window will be disposed of and the remaining window will now occupy the position previously occupied by the tabbed window. If the tabbed window had been docked, then the remaining window is now docked in its place. See Docking Windows 10 for more information on docking. Tab Window Options After "Tabbing" windows together, several display options are available from a pop-up menu that is accessible by Right-Clicking on any of the Tabs. For details on these options, see Tab Window Options 14 . (also see: Docking Windows 10 , Tab Window Options 14 ). © 2017 TechTools Getting Started 1.5.2.1 14 Tab Window Options After "Tabbing" windows together, several display options are available from a pop-up menu that is accessible by Right-Clicking on any of the Tabs. Available options depend on the selected Tab Orientation. Tab Orientation Options are TOP, LEFT, BOTTOM, RIGHT. Choose one of these options to change the placement of the Tabs in a tabbed window. © 2017 TechTools 15 DigiView User's Guide Tab Rows Options are SINGLE, MULTIPLE. Choose multiple to have the tabs align in a single row with "scroll buttons" on the right. Choosing multiple will change the tabs to the default multiple row behavior and remove the "scroll buttons". Tab orientation must be set to Top or Bottom to select the Single option. © 2017 TechTools Getting Started 16 Tab Size Options are STRETCH to FIT, NORMAL. Choose "stretch to fit" to have the tabs "fill" the available space when multiple rows are present. Select "normal" to size the tab to the length of its text. © 2017 TechTools 17 DigiView User's Guide Tab Style Options are TABS, BUTTONS, FLAT BUTTONS. Tab orientation must be set to "TOP" to select the option of Buttons or Flat Buttons. © 2017 TechTools Getting Started 1.5.3 18 Alignment Management When not docked inside the main window, all windows have Alignment Management to assist positioning when near the main application or each other. The frame of the window being moved will become transparent for better visibility and highlight two of its edges (top or bottom and left or right) that align with the closest neighboring window. When within a few pixels of alignment to a neighboring window, it will assist placement by gently resisting an overlap which effectively helps to 'snap' it into position. This method is more user friendly than the strong "magnetic" placement used by other applications and is especially beneficial when near multiple windows. In the image below, the alignment of the left and top sides of the window being dragged is assisted for placement next to the tabbed window on the left. To override Alignment Management, hold the Control key while positioning a window. © 2017 TechTools Project Operations Part II Project Operations 2 20 Project Operations The DigiView software is project oriented in order to save and restore specific settings such as Analyzer Model, Signal Definitions, Search Definitions, Trigger Configurations, Window placement, Capture History and so forth. When launching the software, the Project Selections window will open first so you can create a new project, open an existing project or load an example project that includes captured data. Project Selections The Project Selections Window can be opened at any time using the "Open Project Selections" button from the main tool bar or by selecting Menu-> Project-> Project Selections. It will also open automatically when the software first launches. For Details see Project Selections 22 . Starting with a new Project If you want to create a new blank project, then select "New Project" from the Project Selections Window. For Details see Creating a New Project 23 . Saving a Project To save a project, select the "Save Project" button from the main tool bar or select Menu-> Project-> Save Project. When a project is saved, the capture being view will be embedded into the project file so it can be viewed the next time the project is opened, even if you manually delete the history folder or move the project file to a different location. This also makes it simple to share the project with a colleague since the history files and folder are not required to view the capture. Auto Save/Restore The "Auto Save" and "Restore last Project" options are found in the Environment settings. When both of these options are enabled, DigiView auto-saves the current data, settings and state of the project when you exit the program (or load a different project) and auto-loads the last opened project when you start the program. This allows you to pick-up where you left-off the next time you start the software without having to save/restore. You can still save the project manually anytime you need by selecting the "Save Project" button on the main tool bar. See Also: Environment settings © 2017 TechTools 127 21 DigiView User's Guide Saving the Project with a new name or to a different directory To save a project to a new location or with a different name, select Menu-> Project-> Save Project As. When saving this way, the entire Capture History can be copied to the new location and/or name as well. See Also: Capture History 133 . The Save Project As function will prompt you for a new name and location by opening a system folder window. After making your selections, the DigiView software will ask permission to make a copy of the capture history for the new project. If you select yes when prompted, the entire capture history for the current project will be copied to the new project's location and name. Since the Capture History is stored in a sub-folder using the project's name, it is safe to create projects in the same directory. The "Copy History" prompt also displays the amount of disk space being used by the history files and will copy as many files as free space allows, leaving a safety margin. The most recent captures are copied first (and kept in chronological order) in case you do not have enough space available or if you decide to cancel before the entire history is copied. Cloning a Project for a New Analyzer You may wish to open a Project configured for a different Analyzer model than the one currently attached to your PC and then want to capture new data with the new analyzer model without having to recreate the project and all its settings. To do this, you can can clone the project by selecting Menu-> Project-> Clone Settings... For Details see Cloning Projects 26 . © 2017 TechTools Project Operations 2.1 22 Project Selections When first launching the software you can choose from several common project options. To prevent the Project Selections window from opening first, simply uncheck the "Always Show on Startup" check box. This feature can be re-enabled at any time from Environment Options 127 . Select the New Project button to create an entirely new project by choosing the analyzer model and mode. The project is automatically named and temporarily stored until you save the project. If you close the software or load another project without saving, the project will be discarded. See Also: Creating a New Project 23 To see Analyzer specific DigiView projects that include a real-data capture, then Click on the Load Example Project button. Select the Open File button to explore your computer storage and find a previous project to open. DigiView software registers the DVDAT file extension with the operating system and filters the browsing to only show these files. If you are browsing from the operating system instead of first launching the DigiView software, you can "open" the file directly and the DigiView software will automatically launch and skip the Project Selections window. Moving the mouse over the Load Last Project button will highlight the previously opened project in the Recent Project list (it is always highlighted when the Project Selections window opens if it is available). Select this button to open it. © 2017 TechTools 23 DigiView User's Guide Recent Projects The recent projects list will display the file name of the last 24 projects opened. When a project is highlighted (by using the mouse or the cursor keys) the full file path is displayed just above the list. Double-Click on any filename to open the project. Press the Enter Key to open a project that is already highlighted. Always Show on Startup Uncheck the "Always Show on Startup" check box to prevent the Project Selections window from opening when launching the software. When unchecked, the last opened project will automatically load instead. This option can be configured at any time from Environment Options. See Also: Environment Options 127 Exit DigiView Press this button or use the Escape Key to exit the program without loading or creating a project. 2.2 Creating a New Project Steps to create a new project A. Select a Project Template. B. Select the Analyzer Model and Sample Mode. C. Define the Signals and associated channels as needed. To create a new project, open the the Project Selections Window and click on the "New Project" button. The Project Selections Window can be opened at any time using the "Open Project Selections" button from the main tool bar (highlighted above) or by selecting Menu-> Project-> Project Selections. This is the same window that opens when the software first launches. For Details see Project Selections 22 . Once opened, click on the New Project button to open the Project Template window. Note: If the Environment option of "Select from Templates" or the "always use this template" option had been selected previously, then the Analyzer Selection window will open, skipping this step (see Environment Options). A. Select a project template Templates are just a convenient starting point for your project. Once you learn the advanced features of our DigiView software, you may have your own starting point preferences and can use those as a starting template (see Creating and Managing Templates 28 ). Double-Click on any template description as a starting point for your project (or click once to highlight it and then click the "Create" button). © 2017 TechTools Project Operations 24 B. Select the Analyzer Model and Sample Mode When creating a new project file, you must select the proper analyzer model and preferred sampling mode. For this reason, the software will provide a selection window with information regarding any detected hardware as shown below. Simply select the Model and the Sampling Mode, then click on the "OK" button to create the new project. If you do not want to create a new project, then select cancel to continue with the currently loaded project. © 2017 TechTools 25 DigiView User's Guide C. Define the Signals After selecting OK above, a new untitled project is created. Since every project requires at least one signal definition, a reminder is displayed. Select OK to select and configure a signal definition. Select Ignore to defer adding a signal until later. To select a specific signal type and associate physical channels to a signal, see Defining Signals 35 . (also see: Capturing Data 131 and Waveform Views 138 ) © 2017 TechTools Project Operations 2.3 26 Cloning Projects You may wish to open a Project configured for a different Analyzer model than the one currently attached to your PC and use it with the new analyzer without having to recreate the project and all its settings. To do this, you can can clone the project by selecting Menu-> Project->Clone Settings... Note: Cloning will create a new project that retains all the settings of the current project. Cloning does not include the embedded data or Capture History. After selecting Clone Settings, the Analyzer selection window will open. Analyzer Models and OS Detection Count This area lists all models of DigiView that are compatible with this version of Software. The software automatically selects the attached device when this window first opens. Next to each model's name is the enumerated count as detected by the Operating System (OS). The count will refresh automatically if the number of attached devices changes while this dialog is open. Note: Hardware does not have to be present. You can clone the project for any model and mode. Sample Mode This area will change to the offer any modes available to the analyzer model selected on the left. As you choose a mode, its details will display in the Analyzer Specifications area. Refresh OS Detection If you do not see a detection count next to the model of an attached device, try pressing the Refresh OS Detection button. If the count is still missing, then the Operating System is having © 2017 TechTools 27 DigiView User's Guide difficulty identifying the analyzer and has not enumerated it on the USB bus. You may need to use a different USB port or verify that you are using a high bandwidth USB cable or the one supplied with the analyzer. If the unit is not detected properly when connected to a USB 2.0 port you may need an externally powered hub. Cancel You can still choose to stop the cloning at this point by pressing the Cancel button. The window will close and no action will be taken to clone the project. OK Proceed with the cloning as configured. Select a new name for the cloned project After selecting OK above, you will be prompted for a new name and location for the project before it is created and opened. Selecting Cancel will terminate the cloning, canceling the operation. NOTE: If you clone a project to an Analyzer or mode that has fewer channels than its Signal Definitions are configured to use or the definitions use a higher channel number than available, many configuration items will be incomplete or invalid. The software will disable invalid Signal definitions, Search definitions and all other uses of an invalid Signal definition. Visual indicators will be present after the cloning if any item has been disabled. © 2017 TechTools Project Operations 2.4 28 Creating & Managing Templates Creating a Template Templates are a convenient starting point for your project. When creating a project you can select from several built-in templates or any custom template created from any of your projects. Once you learn the advanced features of our DigiView software, you may have your own starting point preferences and can use those as a starting template. To create a template, open any project and select: Menu->Project->Save As Template ... and the following Template Editor will appear. Template Name Enter a short name that will reflects the main feature of this template. Template Description Enter descriptive text that will help you remember the main differences in this template. Thumbnail Image This is the image that will display in the Template Selection window. It is created automatically from the current project. Note 1: Although the image does not completely reflect the project's position relative to all monitors attached to the system, templates retain monitor specific information. Note 2: Templates do not include Analyzer model, Signal definitions or anything that relies on signal specific information (i.e. search definitions). If these items are needed, then use the Clone Project 26 feature instead. Managing Templates You may want to go back and remove some of the custom templates you have created. To do this select: Menu->Project->Manage Templates ... and the Template Manager will appear. © 2017 TechTools 29 DigiView User's Guide Notice the button in the lower left corner. This button's caption will change for different actions. This is the Action Button. The Action button is disabled and indicates "No Template Selected" if you have not selected a template. Selecting OK without selecting a template will close the window without making any changes (same as using Cancel). When a Built-in template is selected, the action button is disabled. Built-in templates can not be deleted. Clicking the Action Button after selecting a custom template will mark that template for deletion. You can select and mark as many custom templates as you want. Each template that is marked for deletion will have a large red X over it, indicating this template will be selected when you select the OK button. A marked template is shown below. © 2017 TechTools Project Operations 30 The action button changes to "un-Mark & Keep" when you select a marked template. Click the action button to un-mark the template if you decide to keep it instead of deleting it. Selecting a Default Template To skip the Template selection window when creating new projects, select the "Always use" option in the lower left corner and select a template. Any template not marked for deletion can be selected as the default template. The selected default template will have a large green check mark over it, indicating it will be used as the default for any new projects after you Click the OK button. An example of the default indicator is displayed below. © 2017 TechTools 31 DigiView User's Guide To disable the default and have the selection window appear when a new project is created, open the manager again, select the template (marked with a green check mark) and then un-check the "Always use" option. You can also accomplish this by enabling the "Select From Templates" environment option. Acquisition settings are always stored in the template but are ignored unless you choose to use them by selecting the Environment option "Use Template Acquisition settings". (see Environment Settings 127 , Acquisition Options 110 ) . © 2017 TechTools Configuration Part III 33 3 DigiView User's Guide Configuration The DigiView software is designed to make configuration an easy task and less time consuming than most PC based analyzer systems. The easier it is to configure and understand your Capture and Analysis tool, the easier it will be to achieve successful results. To access the Project Configuration Options window, click the Project Settings button on the tool bar (highlighted above) or select Menu-> Configure-> and the name of the configuration group (Color Themes and Environment options are not project specific and are only available from this menu). After the hardware is connected to the PC, the first step of configuration is to attach the physical channels to the circuit and create a Signal definition that uses those channels. The first topic in this section covers the physical channel connections and cable color scheme. The next section provides detailed information on defining trigger conditions and associating a signal type with the physical channels. The remaining sections deal with user preferences. You might want to review the USB Connection § § § § § § § § 3.1 Connecting Data Lines 33 Defining Signals and Triggers 35 Plotting Signal Data 66 Analyzer Options 96 Acquisition Options 110 Color Themes 113 Using the Color Selection Dialog Environment Options 127 4 topic before proceeding. 125 Connecting the Data Lines The DigiView data cable has either 18 data lines and 2 grounds or 9 data lines and 1 ground. The 18 channel cables are partitioned into 2 identical groups. Each group has a ground and 9 data signals. The leads are color-coded. Black is ground, brown is the first data signal, red is the second data signal and so on in standard resistor color-code order. Additional groups of signals follow the same pattern. The images below show the physical layout of the cable, channel numbers and color codes on various models. This figure is available by clicking the "Cable Connector Pinout" button in Project Configuration Options window or from any Signal Editor 37 window. This opens a non-modal window so you can leave it open while you work if desired. To access the Project Configuration Options window, click the Project Settings button on the tool bar (highlighted above). © 2017 TechTools Configuration 34 After the Project Configuration Options window opens, click the "Cable Connector Pinout" button to display the analyzer pin layout your project is configured for. The data cable is made of high quality, extremely flexible wire and high quality connectors. It is expensive, so please remember to pull on the connectors; not the wires. The connectors are designed to mate to .025 square posts and can be side-stacked on 100mil centers, making them ideal for direct connection to standard square post connectors. Additionally, they mate firmly with the included micro-grabber hooks for connecting to IC leads. DigiView Models DV3100, DV3109, DV3200, DV3209, DV3409, DV509 and DV518 are designed for signals in the -20 to 20V range. DigiView Models DV3400 and DV3500 are designed for signals in the -50 to 50V range. Standard overshoots and undershoots common to digital systems will not harm it. The data lines have extra static protection circuits, current limits and impulse suppression. However, mishandling could still damage them. Simply treat them like you (should) © 2017 TechTools 35 DigiView User's Guide treat your valuable one-of-a-kind target and DigiView will give you years of service. 3.2 Defining Signals and Triggers The hardware will ignore any data lines that are not defined as part of a waveform or part of a trigger. This prevents unused signals from eating up the sample buffer space, even if they are connected to active signals. Signal definitions that are disabled will not be displayed, but may still be captured if the definition includes a channel that is in use by another signal definition. To access Signal and Trigger configuration options, click the Project Settings button on the tool bar (highlighted above) then select the Signal Definitions tab or the Hardware Triggers tab. § Signals 35 § Triggers 69 3.2.1 Signals Current DigiView hardware has either 9, 18 or 36 physical channels. However, we like to think in terms of symbolic names representing individual signals (clock,ALE) or groups of signals (DataBus, Address) rather than channel numbers(0,1,2..). We start by defining SIGNALS in terms of CHANNELS. This is the only place we deal directly with physical channels. The remainder of the software deals in terms of signal names rather than channel numbers. When we define signals, we are mapping a signal NAME to one or more physical channels. This also makes it possible to share the same physical channel with multiple signal definitions (see: Signal Editors 37 ). Adding Signals to the Project To create a Signal, select the "Add Signal" button from Tool Bar (highlighted above, or use the "Create Signal" button in the Project Configuration Options window). Click on one of the selections to create a new signal. A new signal of the chosen type will be created and it's property editor will appear. You can rename the signal, select the physical channels to capture and set all associated options from the signal's editor. (For details on signal options, see the section: Signal Editors 37 ) Use the Escape Key or the red close button if you do not wish to add a signal. © 2017 TechTools Configuration 36 Summary of the Project's Signals Signals added to the project are listed in the Project Configuration Options window on the Signal Definitions tab. To access the Project Configuration Options window, click the Project Settings button on the tool bar (highlighted above) then select the "Signal Definitions" tab. The main purpose of the lower section of this tab is to provide an overview of all current signal definitions and their related channels. You can also Edit or Delete signals from this section, determine each signal's type, its basic colors and its enabled status.The Project Signals section is arranged in a grid with columns representing the physical channels and one row per defined signal. Notice that the same channel can be assigned to multiple signal definitions. In the image below, channel 8 has been assigned to several signal definitions (AD0-15, CODE, address, RD-DATA, WT-DATA). Channel 0 is in the farthest right column and the highest channel number is in the farthest left column (as marked in the header.) A line appears every 4th channel (or nibble) for clarification. In addition to the color references at the top of the window, you can click on the 'Cable Connector Pinout' button at the bottom of the window to see a physical layout of the attached analyzer's channel connector with channel numbers, ground connection locations and the color code of each channel. Note: It is important to enable only channels that are actually being connected to your circuit. The remaining, unconnected channels will be floating and will most likely pick up noise or power line hum. If enabled, these transitions will get stored, wasting storage space. It is also important to connect the black ground wires to your target's ground so that the analyzer and the target have a common ground reference. It is recommended to place the ground connections as close to the channel connections as possible. Changing the Signal order When adding a large number of signal definitions, you may want to change some of their positions to organize or group related signals. To change the display order, grab the small handle in the left margin with your mouse and drag the definition to a new position. © 2017 TechTools 37 DigiView User's Guide Signal Name The name of this signal definition. This value can be changed by editing the signal's properties. (see: Signal Editors 37 ) Signal Colors and Type , , , etc. You can see the color of a signal and determine the type by this graphical indicator (displayed to the right of the name assigned to the signal). Each signal type will display a unique graphic with representative colors. Delete Signal You can delete a signal definition by clicking on the 'X'. Edit Signal Properties You can change the properties of a signal definition by clicking this button. (see: Signal Editors 37 ) Enabled Status/Toggle Indicates the enabled state of the signal. When the lightbulb is ON, the signal is enabled. Click this button to toggle the "enabled" status of the signal. This value can also be changed by editing the signal's properties. (see: Signal Editors 37 ) Associated Channels All channels associated with this signal definition will be indicated in this display as a square blue "dot". Channel 0 is in the farthest right column and the highest channel number is in the farthest left column (as marked in the header.) Light lines appear every 4th channel and non associated channels appear as a short dash. Also, colored squares at the top show each channel's wire color. Notice that there are only 9 colors so the color sequence repeats using resistor color code order (the color Black is used for ground connections - channels 0, 9, 18 and 27 are brown). 3.2.1.1 Signal Editors DigiView provides several Signal type definitions which allow unique methods of interpreting and displaying the raw data captured on the logic channels. Each Signal type has a unique editor with relevant options for its type. From the editor you will also assign some of the physical logic channels to be used for this new signal definition. (see: Connecting Data Lines 33 ) You may choose to repeat the use of some channels in multiple Signal definitions in order to interpret the data differently and gain a perspective that is relative to your current point of interest. This can be done easily by creating a new Signal using the definition with the properties you require. Using the same channels in multiple definitions will not have any effect on the actual capture, but can greatly increase your ability to analyze the data and present visual representation to others. © 2017 TechTools Configuration 38 NOTE: The same channel can be assigned to as many signal definitions as you need. For instance, if you want to capture the Read and Write cycles of an SPI bus using separate signal definitions (instead of the combined read/write of the SPI signal type), you can create 2 Synchronous Serial signals and assign the same channel as the Clock for each definition. Signal Selection The signal selection can be expanded by adding Plug-ins which can be downloaded with the software (as available) or created by using our free Plug-in Development Kit (downloadable from our website). The current 'built-in' Signal Types are listed below. Details of each type's properties are described in the following sections. Asynchronous 47 Serial UART analysis, pre-selected and custom baud rates, channel inversion option, from 4 to 8 bit selectable, parity option, Framing options and Glitch filter. Boolean 40 Single channel viewing. Bus 42 Multi-channel viewing as a single value. Also suitable to display the capture of an Analog to Digital converter as an Analog Signal when the Plot Output option is selected (see: Plotting Signal Data 66 ) CAN BUS 44 Full featured Controller Area Network protocol decoder. I2C 50 Complete I2C protocol analysis. 7bit/10bit addressing, High Speed Mode Master Codes, General Call support, Glitch filter. I2S 54 Inter-IC Sound bus protocol decoder with word length selection from 4 to 32 bits. SPI 62 Master/Slave data from two Synchronous Serial data channels using the SPI protocol. State 56 Filters multi-channel data by state of a single channel, selectable CLK/DATA inversion, selectable transition state of Rising/Falling/Both, Framing and timeout options, additional Select and Sync channel for filtering. Synchronous 59 From 1 to 32 bit protocols, also suitable for SPI analysis, selectable CLK/DATA inversion, selectable Rising/Falling/Both clock edges, LSB/MSB selection, additional Select, Frame Sync and Field Sync channels for filtering and synchronizing. Signal Editor Preview All signal editors provide a preview that updates while making changes to the signal's options. The time position and zoom level of the preview can be changed to get a better view of the data if © 2017 TechTools 39 DigiView User's Guide needed. This area of the editor is explained below. The symmetrical function buttons below all use Left and Right mouse button clicks to perform opposite functions. © 2017 TechTools Configuration 40 3.2.1.1.1 Boolean The Boolean Signal is the most common method of viewing captured data. Boolean Signals provide viewing of the logic level of a single channel at any given point in time. Signal Name Change the text displayed here to help you identify this signal definition. If the name has already been used, it will automatically be appended with a numerical value in brackets (i.e. [2]). The name displayed here will be used in the Waveform Views, Searches, Tabular Views, Exports, Trigger Configurations and all menu references. Disable Signal Select (check) this item to completely disable the Signal Definition. It is recommended to disable any signals that use channels that are not connected to a physical device. When a capture takes place ("Run"), any channels that are assigned to disabled signals will be ignored instead of using valuable capture space. Invert Signal Check this item to have the value of the captured channels "inverted" before processing or displaying data for this signal definition. This setting will not effect any other signal definitions that may use the same channels. Color Selection & Examples An example of the signal is displayed in the current color scheme, followed by an example of © 2017 TechTools 41 DigiView User's Guide the current color selections for this signal and a color reset button. Clicking on one of the color squares will open the Color Selection 125 dialog to change the Signal line color and its background color if a color other than the theme color is desired. Above the example are controls to modify the portion of the waveform window being displayed. Reset Signal Colors This button will reset the colors for this signal so that they will match the currently selected color theme (see: Color Themes 113 ). Channel Options This is where you will associate a signal definition with the physical channels or connections to the outside world. Only one channel can be selected for the Boolean signal type. To select the channel, click on the " - " below the proper color (and channel number) that corresponds to the physical connection of the DigiView Cable (see: Connecting the Data Lines 33 ). The channel selected for this signal will replace the " - " with a blue square (as shown above). If any other channel is already selected it will be de-selected. The gray arrow beneath each channel color is an activity indicator that displays the activity of the channel as compared to the activity of all the other channels (relational, not real time). Decode Options No decode options are available for the Boolean signal type. © 2017 TechTools Configuration 42 3.2.1.1.2 Bus The Bus Signal is the second most common method of viewing captured data. Bus Signals provide viewing of multiple channels as a single value at any given point in time with additional features to Plot the data. A common use of Bus plotting is to see the captured output of an Analog to Digital converter as a single waveform (see: Plotting Signal Data 66 ). Signal Name Change the text displayed here to help you identify this signal definition. If the name has already been used, it will automatically be appended with a numerical value in brackets (i.e. [2]). The name displayed here will be used in the Waveform Views, Searches, Tabular Views, Exports, Trigger Configurations and all menu references. Disable Signal Select (check) this item to completely disable the Signal Definition. It is recommended to disable any signals that use channels that are not connected to a physical device. When a capture takes place ("Run"), any channels that are assigned to disabled signals will be ignored instead of using valuable capture space. Invert Signal Check this item to have the value of the captured channels "inverted" before processing or displaying data for this signal definition. This setting will not effect any other signal definitions that may use the same channels. © 2017 TechTools 43 DigiView User's Guide Plot Output Check this item to enable Plotting for this signal. If checked, all waveform views will display plotted data as defined by the Plot Series configurations. You must enable and configure at least one Plot Series before any plotted data is visible. Up to 4 individual plots can be configured for each signal. (see: Plotting Signal Data 66 ). Color Selection & Examples An example of the signal is displayed in the current color scheme, followed by an example of the current color selections for this signal and a color reset button. Clicking on one of the color squares will open the Color Selection 125 dialog to change the Signal line color and its background color if a color other than the theme color is desired. Above the example are controls to modify the portion of the waveform window being displayed. Reset Signal Colors This button will reset the colors for this signal so that they will match the currently selected color theme (see: Color Themes 113 ). Channel Options This is where you will associate a signal definition with the physical channels or connections to the outside world. To select a channel, click on the " - " below the proper color (and channel number) that corresponds to the physical connection of the DigiView Cable (see: Connecting the Data Lines 33 ). Channels that are selected for this signal will replace the " " with a blue square as shown above. The gray arrow beneath each channel color is an activity indicator that displays the activity of the channel as compared to the activity of all the other channels (relational, not real time). Decode Options No additional decode options are available for the BUS signal type. Plot Series 1 If "Plot Output" is selected, one plot can be defined. If enabled and Plot Series 1 is defined, all waveform views will display the data in a plotted format. (see: Plotting Signal Data 66 ). © 2017 TechTools Configuration 44 3.2.1.1.3 CAN BUS Use the CAN BUS Signal type to decode the Controller Area Network protocol. This full featured decoder will decode the entire CAN 2.0B specification. Signal Name Change the text displayed here to help you identify this signal definition. If the name has already been used, it will automatically be appended with a numerical value in brackets (i.e. [2]). The name displayed here will be used in the Waveform Views, Searches, Tabular Views, Exports, Trigger Configurations and all menu references. Disable Signal Check this item to completely disable the Signal Definition. It is recommended to disable any signals that use channels that are not connected to a physical device. When a capture takes place ("Run"), any channels that are assigned to disabled signals will be ignored instead of using valuable capture space. Plot Output Check this item to enable Plotting for this signal. If checked, all waveform views will display plotted data as defined by the Plot Series configurations. You must enable and configure at least one Plot Series before any plotted data is visible. Up to 4 individual plots can be configured for each signal. (see: Plotting Signal Data 66 ). © 2017 TechTools 45 DigiView User's Guide Color Selection & Examples An example of the signal is displayed in the current color scheme, followed by an example of the current color selections for this signal and a color reset button. Clicking on one of the color squares will open the Color Selection 125 dialog to change the Signal line color and its background color if a color other than the theme color is desired. Reset Signal Colors This button will reset the colors for this signal so that they will match the currently selected color theme (see: Color Themes 113 ). Channel Options This is where you will associate a signal definition with the physical channels or connections to the outside world. Each signal definition type will have one or more channel selection groups and will allow one or more channels to be selected for each group. Each channel selection group will be identified on its left if more than one group is available for the signal type. To select a channel, click on the " - " below the proper color (and channel number) that corresponds to the physical connection of the DigiView Cable (see: Connecting the Data Lines 33 ). Channels that are selected for this signal will replace the " - " with a blue square as shown above. The gray arrow beneath each channel color is an activity indicator that displays the activity of the channel as compared to the activity of all the other channels (relational, not real time). Data Channel Selection Selects which physical channel to assign to DATA. Invert Channels If selected, the captured data for DATA will be inverted before decoding and displaying (only affects this Signal Definition). Show Delimiters When selected, Delimiter fields will be visible in the output. Show CRC When selected, CRC fields will be visible in the output. Show Control Bits When selected, Control bits fields will be visible in the output. Bit Rate/Duration & Scale: Specify a value for the Bit Rate or the Bit Duration, then select a scale for the value entered. Scale selections include Nano seconds (ns), Micro seconds (us), Milli seconds (ms), Baud, KiloBaud (KBaud) and MegaBaud (MBaud). Note that the value must be an integer (no floating point.) To specify something with a decimal point, select the next lowest range and enter a whole number. For example, 115.2 KBaud would be entered as 115200 Baud and 12.31us would be entered as 12310ns. Sample Point (%bit) Specifies where we should sample the data within each bit cell as a percentage of the bit width. This defaults to mid-bit (50%) and can be adjusted to account for bus propagation delays, transceiver delays, bandwidth limitations, etc. This roughly corresponds to the combined settings of the SYNC_SEG, PROP_SEG and PHASE_SEG_1 mentioned in the CAN specification. Alternatively, it could be viewed as the total bit width - PHASE_SEG_2. © 2017 TechTools Configuration 46 Sync Jump Width (%bit) Specifies the percentage of a bit width to allow for resynchronization adjustments. This corresponds to the SJW parameter in the CAN specification. The CAN specification allows for a wide tolerance on node oscillators. This is accomplished by requiring that nodes resynchronize on passive->dominate edges. The receivers compare the actual timing of these edges with the ideal timing at the specified baud rate and then make adjustments to their internal timers to resynchronize with the incoming data. This parameter specifies the maximum adjustment we will make when resynchronizing. Increasing this number increases our ability to properly decode packets involving nodes with low accuracy oscillators at the expense of increased noise sensitivity. Lower numbers improve noise rejection but reduces our ability to work with nodes with low accuracy oscillators. You usually set this lower if all nodes use crystal oscillators for their baud rate reference, and higher if any of them use ceramic resonators or other low accuracy sources for their baud rate references. Be aware that the (SAMPLE-POINT + SJW) should be less than 100% and that (SAMPLE-POINT - SJW) should be greater than 0. Filter Glitches Configure->Triggers. To change modes, Click on the button to the right of the current mode indicator. The button's symbol also indicates the current mode and will change after you select a different mode. In the image above and below, the current mode is "Always" and the button has a T with continuous arrows circling it. Select the desired mode from the selection window. Always Configures the hardware to consider any change on any signal as being a matching condition so it will trigger on the first sign of activity. Never Configures the hardware to never trigger so it will continue to gather the newest data until manually stopped. Simple Simple triggers make it easy to configure trigger conditions directly from any signal in any waveform view. Patterns and Edge detections (changes) can be configured for all or any of the signals you have in the project. See the Simple Trigger 71 section for complete details. © 2017 TechTools 71 DigiView User's Guide Advanced Advanced triggers have many options to target those harder to find conditions. See the Advanced Triggers 73 section for complete details. 3.2.2.1 Simple Trigger Simple triggers make it easy to configure trigger conditions directly from any signal in any waveform view. Pattern matching and Edge detections (changes) can be configured for all or any of the signals you have in the project. Simple Trigger Symbols When you have changed the trigger mode to Simple (see Triggers 69 ), the trigger column in all waveform views will display a trigger condition symbol to the right of each signal's name. The symbol will reflect the condition set for that signal. Each symbol and its explanation is listed below. Multiple States, mixed mode indicator Rising Edge Don't care, Ignore Falling Edge Pattern of Logic 1 Either edge (any change) Pattern of Logic 0 Editing Simple Triggers Click on the symbol next to the signal's name to make changes. Editing the condition is slightly different for Boolean, Bus and Decoded signals. With Boolean signals you can choose one of 6 conditions (X,1,0,rise,fall,either). With Bus signals, you can choose one of these 6 conditions for each channel of the bus or select one condition for all of its channels. Decoded signals use a combination that reflects each of the channel groups it consists of (clock, data bus etc.). An Example of each is displayed below. © 2017 TechTools Configuration 72 Boolean signal example: The selected condition is highlighted in the selection group to the right and also displayed next to the signal's name. Move the mouse over any condition symbol in the selection group on the right then Click to make it the selected condition. BUS signal example: The currently selected condition of each channel is displayed beneath the channel number. To change the condition, move the mouse over a channel and the vertical selection group will move over that channel and highlight its current selection. In the image above channel 1's current condition is '0'. Clicking on any other condition symbol in the vertical selection group will change channel 1 to the new condition. Move the mouse left or right until you are over the channel you want to change, then select the new condition. To change ALL the channels to the same condition move the mouse over the "ALL" text. When the mouse is over the "all" text, the selection group will move to the right of it. Any condition selected will now apply to and update all the channels for that group. Typical Decoded signal examples: Each channel group of a Decoded Signal is edited in the same way as a Boolean or Bus signal. Move the mouse over each group to change the condition just like the Boolean and Bus examples above. © 2017 TechTools 73 DigiView User's Guide Editing the "Clock Channel" trigger condition Editing "Data Channels" and preparing to set a new trigger condition for all its channels Editing the "Data" channel trigger condition The decoded signal above consists of 3 Boolean channels. Move the mouse over each channel to select a new condition. 3.2.2.2 Advanced Trigger In our DigiView Software, Advanced Triggers are specified in terms of SIGNALS. After assigning channels to signal names, you can configure the advanced trigger condition based on the defined signals (see: Signals 35 ). Most engineers will find it easier to reference the condition as it relates to the circuit's function rather than remembering which channels of the analyzer were used to connect to specific signals in the circuit. © 2017 TechTools Configuration 74 DigiView's advanced trigger configuration screen centers the user's focus on function; making it much easier to quickly analyze and modify a very complex trigger condition. The following graphic is an example of an advanced trigger condition for the DV3500. (also see: Trigger Match Types 77 , Sequencer 95 ) To access Trigger configuration options, click the Project Settings button on the tool bar, then select the Hardware Triggers tab. Example of an Advanced Trigger Configuration for Model DV3500: The Advanced Trigger configuration screen implements a dual-mode (GUI and text), schematic-like approach to configuring the matches, sequencers and trigger output from a single window. A text window shows the 'formula' for the configuration while the 'schematic' shows the flow. These two sections update together to provide two distinct views of the configuration. Multiple trigger configurations can also be selected and created using the selection area in the upper left corner of this screen. © 2017 TechTools 75 DigiView User's Guide Trigger Configuration Selection Multiple trigger configurations can be created and stored in the DigiView Data File. Use the selection box to quickly chose another trigger configuration. After making a selection, click the "apply" button on the bottom of the screen to send the new configuration to the analyzer. To create, clone, delete or rename a configuration use the buttons above the selection box. Trigger Formula (left portion of screen) The formula presents a summary of the complete configuration. Since this summary can be quite involved with a complex trigger condition, each section will "highlight" as items in the graphical section are selected or the mouse moves over them. The formula will automatically scroll to bring the highlighted section into view while working in the graphical area of the configuration. In the image above, the summary of "MATCH 5" is brought into view as Match 5 is selected (shown with a red outline above). © 2017 TechTools Configuration 76 Schematic (right portion of screen) This area is where the actual configuration is accomplished. For clarification, the graphical area is divided by two major paths: Direct (non-sequenced) pathways and Sequenced pathways. Select viewing of each path by using the appropriate Tab at the top of this area. Note: The Match configuration and Term connections are common to both pathways and will always display. Every trigger configuration starts with a match condition and ends with Trigger Out, so the work flow is designed from left to right, starting with the Match Types (see: Trigger Match Types 77 ). Connections Auto Connect When the very first Match type is selected and the match condition has been specified, the match will automatically route graphically to the Trigger Out. For the DV3 series, this means it will route to TERMS 1, then the DIRECT (NON-Sequenced) option and then to Trigger Out. This automatic function is only performed if no other connections already exist. Once you have started making connections for your trigger configuration, the software will not try to "guess" your intentions, since this would hinder your work. The software allows you to manually connect or disconnect if the action is valid. Only the obvious connect and disconnects will be performed automatically. © 2017 TechTools 77 DigiView User's Guide Manual Connections Connection points will display a red square as the mouse moves over them. To Start a connection click on one of these points then move the mouse over another valid connection point and click to finish the connection. To Delete a connection, repeat the process or use the Delete Key or Double-Click when the connection highlights in the editing color (red). To Cancel a connection before the second point has been selected, click in the open area between valid connection points or use the Escape Key or the Delete Key. NOTE: The graphical connections in the trigger configuration directly correspond to the physical circuit connections in the hardware, making this screen an overview of the resulting logic in the analyzer's hardware. See the Following Sections: § Trigger Match Types § Sequencer 95 77 3.2.2.2.1 Trigger Match Types DigiView's Advanced Trigger configuration supports multiple types of Match conditions. The DV3 and DV5 series of DigiView analyzers each have a total of 8 configurable match circuits and each match circuit can be set to one of 9 different match types. Details of each match type can be found using the links below. © 2017 TechTools Configuration 78 Setting the Match Type A non-configured or "deleted" match will be identified by a "?" as seen above. To set the match type, simply click on the match (or Right-Click) and select the type from the menu that appears. If the match was configured previously (not cleared) then Right-Click to access this menu. Editing the Match Condition When selecting or changing the match type, the editor for the match condition will automatically appear. To edit the condition later, simply Double-Click on the match or Right-Click on the match and choose "Edit" from the menu that appears. Available Match Types: § § § § § § § § § Pattern 79 Edges 80 Stable 81 Equal 83 Not Equal 85 Greater Than 87 Greater Than or Equal Less Than 91 Less Than or Equal 93 (See: Advanced Trigger © 2017 TechTools 89 73 ) 79 DigiView User's Guide 3.2.2.2.1.1 Pattern Match The level trigger is a pattern match detector. You can configure it to match any combination of 0,1 or "don't cares" across all channels. The Pattern Match Editor is displayed below ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it to the Pattern Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as Enable above) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portions in the same manner as any other signal. For instance, if you have defined a State signal like the one above (Address) and you only want to add the Enable signal to the pattern match, then expand it and double-click on Enable. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Enable and the Frame Sync channel of the Address signal, indicates a channel state that is invalid for triggering. The Blue icon in the Edit area for Enable indicates the channel has been configured as 'Ignored' in the signal definition editor and is generally "Disabled" (Blue icon in the selection tree on the left). The Red outline in the edit area indicates an invalid signal has already been added to the definition, making it invalid. When moving the mouse over an invalid signal match, a hint will display with additional details of the error. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Pattern Match. © 2017 TechTools Configuration 80 Changing Bit Pattern - Each bit of the signal can be toggled between the 3 states of '0', '1' and 'x' (don't care) by simply clicking on the bit position in the pattern edit area. To set all bits for a signal to one of these 3 values, use the X, 0 and 1 buttons to the upper-right of the pattern edit area. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. Duration - Enter the stability duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the selected signals (and bits) match the pattern for the indicated duration period. 3.2.2.2.1.2 Edge Match The edge trigger circuit is a 36 (or 72) input OR of rising edge and falling edge detectors. You can specify a trigger on rising, falling or transition on any combination of channels (rising edge of ALE or falling edge of OE or falling edge of WT or transition on clock...). All '-' entries for a channel means "don't care". The Edges Match Editor is displayed below ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it to the Edges Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as :CLK above) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portions in the same manner as any other signal. © 2017 TechTools 81 DigiView User's Guide For instance, if you have defined a State signal like the one above (Address) and you only want to add the :Clock Channel signal to the Edges match, then expand it and double-click on :Clock Channel. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Edges Match. Changing Bit Pattern - Each bit of the signal can be toggled between the 4 states of '-' (don't care), 'rising', 'falling' and 'either' by simply clicking on the bit position in the Edges edit area. To set all bits for a signal to one of these 4 values, use the buttons to the upper-right of the Edges edit area. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. 3.2.2.2.1.3 Stable Match All '-' entries for a channel means "don't care". The Stable Match Editor is displayed below. ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" © 2017 TechTools Configuration 82 button to add it to the Stable Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as :Clock(SCL) above) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portions in the same manner as any other signal. For instance, if you have defined an I2C signal and you only want to add :Clock(SCL) to the Stable match, then expand it and double-click on :Clock(SCL). It would then appear on the right portion of the editor as "AND I2C:Clock(SCL)" like the ALE signal above. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Stable Match. Selecting Stable bits - Each bit of the signal can be toggled between the 2 states of '-' (don't care) and 'STABLE' by simply clicking on the bit position in the Stable edit area. To set all bits for a signal to one of these 2 values, use the buttons to the upper-right of the Stable edit area. Boolean signals, if added, do not offer a choice and should be removed when they are no longer needed as part of the Stable match. Duration - Enter the stability duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the selected signals (and bits) have been stable for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 83 DigiView User's Guide 3.2.2.2.1.4 Equal Match The Equal Match Editor: ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it as the Equal Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as the 'Data Channels' portion of a State Signal) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portion in the same manner as any other signal. For instance, if you have defined a State signal and you want to add the Data portion of the signal to the Equal match, then expand it and double-click on :Data Channels. It would then appear on the right portion of the editor as shown above. The Equal Match type only accepts one signal at a time. If you attempt to add a second signal, a dialog will appear asking if you want to replace the existing signal with the current one. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Equal Match. © 2017 TechTools Configuration 84 Match Value Format - The value for the Equal Match type can be entered in Decimal, HEX, Binary or ASCII format. The value will be limited to the maximum value allowed for the selected signal, which will depend on the number of bit positions assigned to the signal. The formats for entering each value type is described below. Decimal: Enter any valid decimal value. An Invalid value will be cleared to 0 or assumed to be HEX. HEX: Start the value with an "x" or a "0x". If too many digits are entered, the most significant nibble (leftmost) will be discarded. Any non-HEX digit will be ignored. Binary: Enter "b" followed by "1's" and "0's". If too many digits are typed, the MSb (leftmost bit) will be discarded. Any numerical value larger than a "1" or non-numerical character will be considered a "1". ASCII: Start the value with a single or double quote. Duration - Enter the match duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the entered value for the selected signal has been valid for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 85 DigiView User's Guide 3.2.2.2.1.5 Not Equal Match The NOT Equal Match Editor: ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it as the NOT Equal Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as the Data Channel portion of a State Signal) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portion in the same manner as any other signal. For instance, if you have defined a Synchronous Serial signal (i.e. SPI) and you want to add the :Enable portion of the signal to the NOT Equal match, then expand it and double-click on :Enable. It would then appear on the right portion of the editor. The NOT Equal Match type only accepts one signal at a time. If you attempt to add a second signal, a dialog will appear asking if you want to replace the existing signal with the current one. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the NOT Equal Match. © 2017 TechTools Configuration 86 Match Value Format - The value for the Not Equal Match type can be entered in Decimal, HEX, Binary or ASCII format. The value will be limited to the maximum value allowed for the selected signal, which will depend on the number of bit positions assigned to the signal. The formats for entering each value type is described below. Decimal: Enter any valid decimal value. An Invalid value will be cleared to 0 or assumed to be HEX. HEX: Start the value with an "x" or a "0x". If too many digits are entered, the most significant nibble (leftmost) will be discarded. Any non-HEX digit will be ignored. Binary: Enter "b" followed by "1's" and "0's". If too many digits are typed, the MSb (leftmost bit) will be discarded. Any numerical value larger than a "1" or non-numerical character will be considered a "1". ASCII: Start the value with a single or double quote. Duration - Enter the match duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the entered value for the selected signal has been valid for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 87 DigiView User's Guide 3.2.2.2.1.6 Greater Than Match The Greater Than Match Editor: ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it as the Greater Than Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as the Data Channel portion of a State Signal) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portion in the same manner as any other signal. For instance, if you have defined a Synchronous Serial signal (i.e. SPI) and you want to add the :Enable portion of the signal to the Greater Than match, then expand it and double-click on :Enable. It would then appear on the right portion of the editor. The Greater Than Match type only accepts one signal at a time. If you attempt to add a second signal, a dialog will appear asking if you want to replace the existing signal with the current one. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Greater Than Match. © 2017 TechTools Configuration 88 Match Value Format - The value for the Greater Than Match type can be entered in Decimal, HEX, Binary or ASCII format. The value will be limited to the maximum value allowed for the selected signal, which will depend on the number of bit positions assigned to the signal. The formats for entering each value type is described below. Decimal: Enter any valid decimal value. An Invalid value will be cleared to 0 or assumed to be HEX. HEX: Start the value with an "x" or a "0x". If too many digits are entered, the most significant nibble (leftmost) will be discarded. Any non-HEX digit will be ignored. Binary: Enter "b" followed by "1's" and "0's". If too many digits are typed, the MSb (leftmost bit) will be discarded. Any numerical value larger than a "1" or non-numerical character will be considered a "1". ASCII: Start the value with a single or double quote. Duration - Enter the match duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the entered value for the selected signal has been valid for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 89 DigiView User's Guide 3.2.2.2.1.7 Greater Than or Equal Match The Greater Than or Equal Match Editor: ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it as the Greater Than or Equal Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as the Data Channels portion of a State Signal) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portion in the same manner as any other signal. For instance, if you have defined a Synchronous Serial signal (i.e. SPI) and you want to add the :Enable portion of the signal to the Greater Than match, then expand it and double-click on :Enable. It would then appear on the right portion of the editor. The Greater Than or Equal Match type only accepts one signal at a time. If you attempt to add a second signal, a dialog will appear asking if you want to replace the existing signal with the current one. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Greater Than or Equal Match. © 2017 TechTools Configuration 90 Match Value Format - The value for the Greater Than or Equal Match type can be entered in Decimal, HEX, Binary or ASCII format. The value will be limited to the maximum value allowed for the selected signal, which will depend on the number of bit positions assigned to the signal. The formats for entering each value type is described below. Decimal: Enter any valid decimal value. An Invalid value will be cleared to 0 or assumed to be HEX. HEX: Start the value with an "x" or a "0x". If too many digits are entered, the most significant nibble (leftmost) will be discarded. Any non-HEX digit will be ignored. Binary: Enter "b" followed by "1's" and "0's". If too many digits are typed, the MSb (leftmost bit) will be discarded. Any numerical value larger than a "1" or non-numerical character will be considered a "1". ASCII: Start the value with a single or double quote. Duration - Enter the match duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the entered value for the selected signal has been valid for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 91 DigiView User's Guide 3.2.2.2.1.8 Less Than Match The Less Than Match Editor: ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it as the Less Than Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as the Data Channels portion of a State Signal) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portion in the same manner as any other signal. For instance, if you have defined a Synchronous Serial signal (i.e. SPI) and you want to add the :Enable portion of the signal to the Less Than match, then expand it and double-click on :Enable. It would then appear on the right portion of the editor. The Less Than Match type only accepts one signal at a time. If you attempt to add a second signal, a dialog will appear asking if you want to replace the existing signal with the current one. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Less Than Match. © 2017 TechTools Configuration 92 Match Value Format - The value for the Less Than Match type can be entered in Decimal, HEX, Binary or ASCII format. The value will be limited to the maximum value allowed for the selected signal, which will depend on the number of bit positions assigned to the signal. The formats for entering each value type is described below. Decimal: Enter any valid decimal value. An Invalid value will be cleared to 0 or assumed to be HEX. HEX: Start the value with an "x" or a "0x". If too many digits are entered, the most significant nibble (leftmost) will be discarded. Any non-HEX digit will be ignored. Binary: Enter "b" followed by "1's" and "0's". If too many digits are typed, the Msb (leftmost bit) will be discarded. Any numerical value larger than a "1" or non-numerical character will be considered a "1". ASCII: Start the value with a single or double quote. Duration - Enter the match duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the entered value for the selected signal has been valid for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 93 DigiView User's Guide 3.2.2.2.1.9 Less Than or Equal Match The Less Than or Equal Match Editor: ADD a Signal - Highlight a defined signal from the left portion of the window and click the "+" button to add it as the Less Than or Equal Match. You can also just "Double-Click" the defined signal to automatically add it. NOTE: High Level signal definitions (such as State, I2C, or etc) cannot be added directly as a complete signal. However, the individual portions of the signal (such as the DATA portion of a State Signal) can be added in the same manner. To see the sub-portions of a signal, click the "expand" button in the left column next to the signal's name, then add the sub portion in the same manner as any other signal. For instance, if you have defined a Synchronous Serial signal (i.e. SPI) and you want to add the :Enable portion of the signal to the Greater Than match, then expand it and double-click on :Enable. It would then appear on the right portion of the editor. The Less Than or Equal Match type only accepts one signal at a time. If you attempt to add a second signal, a dialog will appear asking if you want to replace the existing signal with the current one. Note: If a signal is valid for the trigger configuration, a green icon will be displayed next to it. Any other icon, such as the blue circle above on the Frame Sync channel of the Address signal, indicates a signal state that is invalid for triggering. This particular icon indicates that the signal is 'Disabled'. Selecting Ignore in the signal definition editor for a particular sub-signal will disable the sub-signal throughout the application. Delete a Signal - Highlight a signal in the right portion of the window (or mouse-over its bit selections) and click the "-" button to delete it from the Less Than or Equal Match. © 2017 TechTools Configuration 94 Match Value Format - The value for the Less Than or Equal Match type can be entered in Decimal, HEX, Binary or ASCII format. The value will be limited to the maximum value allowed for the selected signal, which will depend on the number of bit positions assigned to the signal. The formats for entering each value type is described below. Decimal: Enter any valid decimal value. An Invalid value will be cleared to 0 or assumed to be HEX. HEX: Start the value with an "x" or a "0x". If too many digits are entered, the most significant nibble (leftmost) will be discarded. Any non-HEX digit will be ignored. Binary: Enter "b" followed by "1's" and "0's". If too many digits are typed, the MSb (leftmost bit) will be discarded. Any numerical value larger than a "1" or non-numerical character will be considered a "1". ASCII: Start the value with a single or double quote. Duration - Enter the match duration by selecting the units then typing the value. The Maximum Duration period for Models DV3200, DV3209, DV3400, DV3409 and DV3500 is 5 ms; 10ms for Models DV3100 and DV3109. The Trigger condition will not be considered as "True" until the entered value for the selected signal has been valid for the indicated duration period. Identifier - Change the identifier to something meaningful for the match condition if you do not want the default "Match #" to be displayed in the formula and the graphical configuration area of the trigger screen. © 2017 TechTools 95 DigiView User's Guide 3.2.2.2.2 Sequencer The trigger circuit of the advanced trigger mode includes 4 cascadable, 4 stage sequencers. These can be chained in any combination to produce longer sequences ( 1@ 16 stages, 2 @ 8 stages...). Stage inputs are OR gates so that more than 1 term of match conditions can be connected to each stage. Each stage includes a 20 bit pass counter. Setting a Sequencer Counter Double-Click in the counter to edit its value. When finished editing, either use the "Tab" key or click on another item to assign the new value to the configuration. Anytime the configuration changes, use the "APPLY" button to activate the new settings in the analyzer. NOTE: "0" is an invalid value, so the counter editor will enforce a minimum count of "1". Editing of a sequencer counter can also be activated by a Double-Click on the counter item in the Formula View. In the example below, a Double-Click on either of the darker lines will activate editing for Sequencer 1, Counter 1. The counter's current value is shown as 243 (the second darker line) and will update after editing is complete. © 2017 TechTools Configuration 3.3 96 Analyzer Options Each model of DigiView has a different set of options that can be adjusted directly from the software. Options are grouped by category on the left side of the window. Select the category using the mouse to modify the options in that group. Some options update the hardware immediately (Threshold settings) while other options will not update the hardware until you click on the Apply button, leave the Analyzer Options tab or close the configuration window. Options that do not immediately update can be reset by selecting the Cancel button. To access Analyzer Options click the Project Settings button from the tool bar (highlighted above), then select the Analyzer Options tab. § Buffer Settings 97 § Voltage Thresholds § Glitch Filter 109 © 2017 TechTools 99 97 3.3.1 DigiView User's Guide Buffer Settings The settings below apply to all DV3xxx Models of DigiView (such as Models DV3200 or DV3500). Buffer Size - Adjust to change the size of the Analyzer's internal capture buffer (1% - 100%). Prefill - Adjust the amount of buffer to use for data captured before the trigger event. If no trigger event occurs, the analyzer will continuously refresh this portion of the buffer with the most recent data (circular queue). When the trigger condition is detected the remaining portion of the buffer will be filled with post-trigger data. The behavior of the prefill (or pre-trigger) portion of the buffer can be modified by the Enforce Prefill option. Enforce Prefill - Select this option to force the analyzer to fill the buffer to the Prefill setting before looking for a trigger condition. If you do not need the full prefill amount before the trigger condition occurs, then uncheck this option to allow early detection of the trigger. Capture Time Limit - Select a time-out in the event the capture takes too long to completely fill the assigned buffer size. If the timeout occurs and no trigger condition has been detected the trigger point is placed at the very end of the captured data (when the timeout occurs). Select from 1-99 in seconds, minutes, hours or days. Apply - When highlighted, a change has been made. Click to save the modified settings. Cancel - When highlighted, a change has been made. Click to discard any changes and reset to previous values. © 2017 TechTools Configuration 98 The settings above also apply to all DV5xx Models of DigiView (such as Models DV509 or DV518) with the exception of buffer sizing. Instead of a Buffer Size option the DV5xx series, which can also stream data directly to the PC, has a Buffer Allocation setting that combines a streaming buffer with the hardware buffer. This guarantees a large capture even with a slow PC or minimal USB bandwidth. Buffer Allocation - This new buffer configuration combines the Analyzer's hardware buffer with a streaming buffer on the PC. Regardless of the data rate, the capture is guaranteed to store at least enough data to fill the analyzer's internal buffer with compressed capture records. Our DV5xx series of Analyzers currently have 128Mbits of hardware memory that stores compressed data from the capture. Since the compression method is automatically switched while capturing to optimize storage space, this can be an enormous amount of data (a minimum of 6 to 10 million signal transitions). Stream Buffer Goal - Adjust this option to select the total amount of signal transitions you would like to capture. The range is from 1 Thousand to 100 Million. This is not to be confused with samples. This is the number of actual changes being stored with each storage location including all channels. Since the state of all channels are stored whenever any signal has a transition, this setting considers it a single storage transition even if multiple signals changed on that sample. So the result could be more transitions captured than the requested goal. Be aware that this is the Goal setting, which may not match the result. If the PC can not © 2017 TechTools 99 DigiView User's Guide allocate the memory or if you are using a USB 2.0 connection while capturing signals with a very high data rate, the result will be smaller. You will still capture the minimum in the analyzer's hardware buffer regardless of PC memory, performance, connection type or data rate. Current Buffer - This is an indicator of how many "transitions" or storage changes are in the current capture being viewed. This will update after a capture is completed or when loading a capture from the history buffer. It normally will not reflect the exact number requested and can be much smaller than the Goal if the capture was halted for any reason. If the Capture Limit timeout occurred, or the capture was manually stopped or if the PC could not allocate enough memory it will be smaller. In the graphic above the goal was set to 1 Million and the actual stored changes is 6 changes short of the goal. This would be normal due to estimating the required space for a variety of compression records that could hold this number of signal changes. If you are capturing multiple channels, then you are most likely to have more transitions than indicated since all channels are stored when any channel changes and multiple channels can change on the same sample. Apply - When highlighted, a change has been made. Click to save the modified settings. Cancel - When highlighted, a change has been made. Click to discard any changes and reset to previous values. 3.3.2 Voltage Threshold The voltage threshold is also known as the Trigger Threshold, Trigger Voltage or Transition voltage. When capturing the activity (voltage changes) on the channels, this is the voltage level that determines the difference between storing a 1 or storing a 0. For a typical circuit where the lowest voltage indicates a '0' and the highest voltage indicates a '1', you would set this value to the middle of those two voltages (i.e. for 5 Volt CMOS set the threshold to 2.50 volts). If too much noise activity is being captured, setting this level higher (away from ground bounce or noise) or lower (away from peak bounce or noise) will improve the quality of the capture and even extend the capture time by preventing the storage of phantom transitions or 'garbage'. When decoding serial protocols, capturing noise can cause poor decoding or no decoding at all. The number of thresholds, the number of channels and the voltage range varies between models. These variations are shown below. The cable(s) and channels affected by the threshold setting are displayed first. This area also displays the channel numbers, colors and the detected channel activity (relative to each other). Below the channel indicator area is the current threshold value. The selection box provides quick selection of standard values to use for common logic families and also indicates the current value in relation to these common settings. The slider bar beneath the selection box can be used to manually set a custom voltage. The mouse can be used to move the slider and once selected by the mouse, the cursor keys can be used for fine adjustment. If the selected voltage does not match a common selection, an indicator will be placed in the selection © 2017 TechTools Configuration box between the two closest values. Threshold adjustments update the hardware immediately. Threshold settings for Models DV509, DV518 (in 4 Channel Mode) © 2017 TechTools 100 101 DigiView User's Guide Threshold settings for Models DV509, DV518 (in 9 Channel Mode) © 2017 TechTools Configuration Threshold settings for Model 518 (in 18 Channel Mode) © 2017 TechTools 102 103 DigiView User's Guide Threshold settings for Models DV3109, DV3209, DV3409 and Models DV3100, DV3200 (in 9 Channel Mode) © 2017 TechTools Configuration Threshold settings for Models DV3100, DV3200 (in 18 Channel Mode) © 2017 TechTools 104 105 DigiView User's Guide Threshold settings for Model DV3400 (in 18 Channel Mode) © 2017 TechTools Configuration Threshold settings for Model DV3400 (in 36 Channel Mode) © 2017 TechTools 106 107 DigiView User's Guide Threshold settings for Model DV3500 (in 18 Channel Mode) © 2017 TechTools Configuration Threshold settings for Model DV3500 (in 36 Channel Mode) © 2017 TechTools 108 109 3.3.3 DigiView User's Guide Glitch Filter This digital filter is implemented directly in hardware. It will process all raw samples on all channels, suppressing any data changes with a duration shorter than the configured setting. The settings below apply to all DV5xx Models of DigiView (such as Models DV509 or DV518). Note: Enabling the Glitch Filter on current models will limit the sample rate to 250Ms/ps (4ns) Suppress Glitches - Select this option to enable the Glitch Filter. To disable this feature, simply uncheck the box. Filter Width - Use the slider bar to chose the duration. Transitions with a duration shorter than this setting will be suppressed. Our current models can be configured from 4ns to 32ns with a 1ns resolution (28 steps). Apply - When highlighted, a change has been made. Click to save the modified settings. Cancel - When highlighted, a change has been made. Click to discard any changes and reset to previous values. © 2017 TechTools Configuration 3.4 110 Acquisition Options To change Acquisition options, select the Project Configuration Options button from the main toolbar (highlighted above) then select the Acquisitions Tab. Auto Run Pause Selecting this option will add a pause between Auto Run captures instead of immediately beginning the next capture. Display Behavior after New Capture These options control the default behavior when a new capture is displayed. This includes newly captured data and data loaded from browsing through the Capture History. Do Not Change Position - When selected, the current time reference point remains the same. The Waveform Views will remain at their current time reference instead of scrolling to the trigger point or a selected marker position. NOTE: List windows always adjust to the time of the closest matching line of data, so they may change position slightly, based on the new data loaded. Scroll to Trigger - When selected, the waveform windows will scroll to the trigger point. Scroll to Marker - When selected, the waveform views will scroll to the chosen marker. After this option is selected, the Marker Selection options are available to make the marker selection. Capture History Options These options control when to save captures to the history, the amount of storage to use and determine what action to take if these settings are exceeded. Changes to most of the options below require pressing the "Apply" button in order to reconfigure the history buffer. If this is required, the buttons will highlight with a red border to notify you. Pressing the "Cancel" button or leaving the Acquisition option window (when the buttons are highlighted) will discard any changes and restore your previous settings. When the apply button is pressed, the history will be reconfigured to the new settings and the database rebuilt. If needed, some files will be deleted to © 2017 TechTools 111 DigiView User's Guide meet the new settings, starting with the oldest captures first. Save capture History - When selected, each capture is stored in the history unless overridden by a plug-in or Auto Search window. Do Not Save capture History - When selected, each capture is discarded when a new capture is acquired unless overridden by a plug-in or Auto Search window. When this feature is off, the Capture History bar provides a "Save This Capture" button for manually saving a capture to the history (see Capture History 133 ). Delete Capture History - When pressed, all capture history files for the current project will be deleted, including the one being viewed. When opening a project file that does not have any history, the data stored within the project file will be saved as a history file. If history files exist for the project, but the current data is not found in the history, the data will be added to the history at the proper chronological position. Delete Bookmarked Captures - When pressed, all Bookmarked capture history files will be deleted. All other files will be retained. Delete Displayed Capture - When pressed, only the current loaded capture will be deleted. All other files will be retained. Keep Bookmarked Captures, Delete the rest - When pressed, all capture history files will be deleted except the ones that have been Bookmarked. Keep Displayed Capture, Delete the rest - When pressed, all capture history files will be deleted except the current loaded capture. Limit by Number of Captures - Select this option to specify the exact number of captures to keep. Once selected, the number of captures can be specified in the Maximum Number of Captures to keep edit box. Limit by Size on Disk - Select this option to specify the size of the storage space to use for the capture history. Once selected, the size can be selected in the Maximum Disk Size for Capture History editor on the right. Limit by Disk Free Space - Select this option to specify the amount of free space to reserve on the Hard Drive. Once selected, the size can be selected in the Minimum Disk Size to preserve editor on the right. © 2017 TechTools Configuration 112 Halt when limitation reached - Select this option to halt the analyzer if any of the limitations specified above have been exceeded. A warning dialog will be displayed with information on which limit was exceeded. Overwrite when limitation reached - Select this option to automatically delete the oldest capture(s) to make room for the newest capture when any of the limitations specified above have been exceeded. The history will be maintained as a First in, First out (FIFO) buffer using the parameters specified above. When limitations are reached, no warning is presented as this configuration will automatically maintain the buffer using the specified limitations as new captures are added. History Monitor - For your convenience, the current Capture Count, Storage Size and Disk Free Space are displayed to the right of the editors. This display is updated as capture files are added or deleted and can be used as a History monitor while capturing. Apply - When highlighted, a change has been made. Click to save the modified settings. Cancel - When highlighted, a change has been made. Click to discard any changes and reset to previous values. (also see: Capture History © 2017 TechTools 133 ) 113 3.5 DigiView User's Guide Color Themes Several pre-defined color themes, a custom theme, marker color sets and Marker brightness can be selected from the Color Theme Selection window. This window is accessed from Menu-> Configuration-> Color Theme. § All changes occur live throughout the Application but are not saved until accepted by pressing the OK button. § All theme settings are Application wide and independent of the project. § The factory default theme is Slate. Theme Selection - Select "custom" if you would like to define your own colors, otherwise select from one of the pre-defined color schemes. The area to the right of the scheme selection displays © 2017 TechTools Configuration 114 a list of the items that are affected by theme changes along with the current theme color for that item. Due to the wide range of colors between themes, the Marker Options are saved for each theme independently and will refresh when changing the theme selection. Marker Options - When selecting a theme, Marker Options will be updated to the selections previously used for the newly selected theme. When selecting a marker color set, the Marker Color Level and Marker Text Level settings will update to the settings last used for the set when the current theme was last selected. Window Appearance - This setting will have a dramatic affect on the application's color appearance and brightness. This setting is independent of the selected color theme and marker options. 3D Satin Gradient - This selection paints most windows with a top to bottom transitional background color. The gradient begins with the Signal Background color and slowly transitions to the Frame color by the time the bottom of the window is reached. This gives a soft 3D look with a satin appearance if there is sufficient contrast between the two colors. This also has the affect of slightly darkening the application's appearance compared to using the Flat Tile selection. © 2017 TechTools 115 DigiView User's Guide Flat Tile - This selection will paint most windows with the color selected for Window Background. This results in a brighter, flat window appearance that resembles the newer 'Tile' themes implemented in mobile and desktop devices. Reset Signal Colors - Click this button to reset any Signal colors that do not match the current color theme. Normally, changing the theme will also change a signal's colors. However, if you have customized a signal's color, then it will not change with theme changes. To reset signal colors, click this button and select an option from the menu that appears. To reset a specific signal's colors without changing other signals, use that signal's editor instead. Cancel - Discards any selection changes, restores options to previous settings and closes the window. OK - Accepts all changes and closes the window. Related Topics: § Theme Examples 116 § Custom Theme 123 © 2017 TechTools Configuration 3.5.1 Theme Examples Slate Steel Blue © 2017 TechTools 116 117 DigiView User's Guide Dusk Moss © 2017 TechTools Configuration Green Gold © 2017 TechTools 118 119 DigiView User's Guide Turquoise Lime © 2017 TechTools Configuration Violet Neon Blue © 2017 TechTools 120 121 DigiView User's Guide Neon Green Flamingo © 2017 TechTools Configuration Peach Silver © 2017 TechTools 122 123 3.5.2 DigiView User's Guide Custom Theme To create a completely custom color theme or to slightly change an existing theme, select the "Custom" option in the Theme Selection list. When Custom is selected, the color for individual theme items can be changed to fit your preference. Click on the item to change after Custom has been selected. see (Using the Color Selector 125 ) © 2017 TechTools Configuration To start with colors from a particular theme click the "Copy Theme to Custom" button and select the theme to copy the settings from... All settings from the selected theme will be copied into the Custom Theme. This includes all marker configurations that were previously used in the theme. © 2017 TechTools 124 125 3.6 DigiView User's Guide Using the Color Selector DigiView's color selection dialog uses live updates while selecting colors so the results can be seen without closing the dialog. The original color can be restored at any time by canceling the operation. Additional features include selecting from a grayscale range from full black to full white, selecting from any of the colors used in the current theme, reselecting the original color for the item being modified or a complete custom color. RGB values are displayed for the original color, the color being previewed and the newly selected color. Color Preview will update while the mouse moves over a selectable color. A square will highlight the selected color if it is present in the RGB and/or Grayscale gradient swatches. Selecting an existing Theme color Clicking on any of the Theme color swatches will set the New color to match and update the color of all affected items in the application. Selecting from the Grayscale range Clicking anywhere in the grayscale gradient swatch will select the color value under the mouse and update the color of all affected items in the application. As the mouse is moved in this area the Color Preview will display the color under the mouse and its RGB values. Selecting a Custom Color from the RGB swatches Clicking anywhere in the Red, Green or Blue gradient swatches will select the color value under the mouse and update the color of all affected items in the application.. As the mouse is moved in this area the Color Preview will display the color under the mouse and its RGB values. Old color This is the original color for the item being edited. When the window first opens, a square will also indicate where this color is located in the RGB or Grayscale area. Clicking in the Old Color area will copy the original color to the New Color area. New color This is the most recent color selected since opening the window. Whenever a new color is © 2017 TechTools Configuration 126 selected, a square will also indicate where this color is located in the RGB or Grayscale area. Clicking in the New Color area will reset it by copying the original color. Color Preview This area will display whatever color is under the mouse as it is moved over any color selection area. Older Project Color Mismatches If a custom color from an older project is selected for modification and a reasonable match can not be found in the dialogs' color range, two color swatches will appear just below the New Color swatch. These two swatches represent the two closest matches to the original color that could be found in the current color range selections. Click on either of these swatches or choose a new color entirely. If the dialog is closed and the file is saved after making this change, the original color can not be restored. © 2017 TechTools 127 3.7 DigiView User's Guide Environment Settings Several Environment options are available and can be accessed from Main Menu-> Configure-> Environment. General Auto Save - Select this option to automatically save the current file. All current settings and data will be saved to the file when exiting the program or opening another file. The "Notify when Save Needed" option is disabled when this option is enabled. (see also: Project Operations 20 ) Notify when Save Needed - Select this option if you want to be notified of unsaved changes before exiting the program or opening another file. The "Auto save" option is disabled when this option is enabled. (see also: Project Operations 20 ) Show Projects on Startup - Selected by default, this option presents a Choice of items to load when the software is launched. De-select this option to skip the Project Selections 22 window on startup. If disabled, the "Restore Last File on Startup" option will be enabled. Restore Last File on Startup - Select this option to skip startup options and automatically load the last file used previously. If disabled, the "Show Projects on Startup" option will be enabled. If the last file used is missing when launching DigiView with this option enabled, then the Project Selections window will still open. A project must be opened or created for the software to operate. Play Trigger Sound - Selected by default, this option causes the software to present an audible indication of Trigger events. In continuous run mode, the alert will sound only once on repeated trigger conditions. De-select this option if you do not want the audible alert. The Audible sound can be customized by using the Operating systems "Sounds" control applet. © 2017 TechTools Configuration 128 Play Event Sounds - Selected by default, this option causes the software to present an audible indication of any Snap or Scroll events. De-select this option if you do not want the audible alert. The Audible sound can be customized by using the Operating systems "Sounds" control applet. Debug Plug-ins - Select this option to have the DigiView software pause when loading a custom plug-in. A message dialog will open and DigiView execution will wait until you close the dialog. This provides a means for the developer to attach the DigiView process to an external debugger before the plug-in module begins to execute. Clear Data Before Run - Select this option to clear the display of all captured data when the Run or Auto Run button is pressed. This will clear the captured data if it was NOT already saved to the Capture History. Enable Capture History on New Projects - Select this option to enable the Capture History when creating a new project. (see Creating a New Project 23 ) Select from Templates on New Projects - Select this option to show the Template Selection window when creating a new project. (see Creating a New Project 23 ) Use Template Acquisition Settings - Select this option to use the Acquisition settings of the template chosen for a New Project. Deselect to use the default settings instead. (see Acquisition Options 110 ) Hide Title Bar of Docked Windows - This option toggles the visibility of the title bar of all docked windows. This is useful to preserve space in the docking areas or to eliminate unneeded labels for a cleaner user interface. The title of the docked window is always available by moving the mouse over the window's menu button. Show Getting Started Slides - Select this option to see the getting started slides when launching the application. These are important hints that provide information necessary for getting the most out of using our software. Preview Signal Changes while editing - With very large captures (10 Million transitions or more), signal and display updates can be noticeably slow while editing a signal and previewing the changes. Deselect this option to disable the automatic preview. This option as well as a manual "Refresh" button is available in the editor. © 2017 TechTools 129 DigiView User's Guide Wave Form Views Vertical Lines - Check this option to display vertical lines at the time divisions in the Wave Form views. Reference Line for @ - Check this item to display a vertical line at the time reference marker (@) of the Wave Form views. Horizontal Lines - Check this option to display a horizontal line beneath each visible signal in the Wave Form views. This may be desired to help determine the state of multiple Boolean signals when zoomed in at maximum resolution. Snap to Frames - Check this option to snap to frames by default and use the shift key to snap to fields. If unchecked, the default is to snap to fields and use the shift key to snap to frames. This option affects all marker and signal snapping features of Signals with Frame information in the waveform view. Snap to Boolean Cycle - Check this option to snap to the next Cycle by default and use the shift key to snap to the next Edge. If unchecked, the default is to snap to the next Edge and use the shift key to snap to the next Cycle. This option affects all marker and signal snapping features of Boolean signals in the waveform view. Hide Marker Delta when off screen - When a marker is snapped or dragged to a new position, or when a marker is split into two markers (marker complement), a time measurement is displayed from the last position to the new position or between the marker pair. This is the Marker Delta. When the time points of the Marker Delta are off screen, the measurement is still visible on the edge of the Waveform View in the direction of the Marker's position. Check this option to hide this measurement when the Delta points are not in the viewing area of the Waveform View. Add Gutter Space for measurements - When selected, the height of each row will be increased to accommodate an empty space reserved just for measurements. This provides room above a signal's waveform to display any measurements (Instant, Quick, Marker), keeping the waveform visible at all times. This setting is ignored when a signal is configured for plotting. Click to Bring @ to Edge - When the mouse is clicked in a Waveform view it will scroll that point to the Center Time Reference location ( @ ). If near a change in a signal, it will scroll the time of the change to the Center Time Reference. If you select this option, the behavior changes to bring the Center Time Reference to the point clicked. Holding the Shift Key while clicking will perform the opposite of the selected function. Reset Row Height - Click the "Apply" button to reset the heights of all signals in the Wave Form displays to the value entered as the Current Default size. Edit the current value to enable the "Apply" button. © 2017 TechTools Capturing Data Part IV 131 4 DigiView User's Guide Capturing Data Once signals 35 and triggers 69 are defined, you can capture a new buffer of data at any time by pressing the 'Run' or 'Auto Run' buttons. If you tire of waiting on a trigger or the Analyzer triggers but you tire of waiting for its buffer to fill, you can manually STOP the capture to transfer the buffer. When transferred to the screen, the capture is also stored in the capture history for later analysis (based on Acquisition settings 110 ). If you have little or no activity after the trigger condition and find the need to manually halt the capture frequently, you may want to set a timeout period for automatic stopping the capture or reduce the Analyzer's buffer size (see Analyzer Buffer 97 ). Preview - This mode will automatically transfer data to the PC repeatedly even if a trigger condition has not been defined. This mode is very useful to Monitor signals while making connections and only utilizes a small portion of the hardware buffer. In this mode, the buffer size and duration of data collection is adjusted automatically to provide a "peek" of the logic activity and is not intended for normal data analysis. The result is a virtual "LIVE" mode that does not try to search the data (Auto Search windows) or store the data in the capture history. The data displayed will be discarded when the results of a normal Run (single shot) or Auto Run are displayed. Auto Run - This will "ARM" the hardware, wait for the trigger condition, automatically display the data and then re-arm to repeat the process until the Stop button is pressed. If you are waiting on a Trigger condition that you expected to occur, you can select the "Stop" button to view the data already collected (see Analyzer Options 96 ). Run - This will "ARM" the hardware and automatically display the data when the buffer is full or manually stopped. If you are waiting on a Trigger condition that you expected to occur, you can select the "Stop" button to view the data already collected (see Analyzer Options 96 ). When you click on 'Run' (or Auto Run), you are actually arming the trigger circuit. After detecting the trigger condition, the hardware allows the buffer to continue past the pre-fill point and continues to capture until all buffers are full. After the remaining data in the hardware the buffer has been transferred to the PC, the hardware immediately resets and halts if you selected RUN. If you selected Auto-Run, the next capture begins. Capture Status Window When capturing or previewing data, a window will open to display several statistics about the data, the buffer and anything involved with processing that data. The type of information displayed will depend on your project settings and the Capture mode. A few examples are displayed below. Stopping the Capture Press the Stop button to end the capture. If the button turns dark after selecting it without closing the window, the software is simply busy with a critical task. The request to stop has been seen and will be performed as soon as the time critical function is complete (such as Compressing the © 2017 TechTools Capturing Data 132 current capture or updating signals with the new data). You will only see this delay when capturing a very large amount of data (10 Million transitions or more). Capture related topics: § § § § Trigger Mode 69 Hardware Status 132 Capture History 133 Status Window 135 (see also: Acquisition Options 4.1 110 , Analyzer Options 96 ) Hardware Status The lower right corner and the upper right corner of the main window display Hardware Status information. This information will keep you informed of the hardware's buffer usage and capture state. Analyzer State The upper right corner of the Top Tool Bar © 2017 TechTools 7 will display the current state of the Analyzer 133 DigiView User's Guide using a "light Bulb" symbol and a short text message (next to the run buttons), while the lower right corner will display the state of the hardware as simple LED indicators with a letter abbreviation for a reminder. Message Example: The 'Light Bulb" is lit, indicating that a trigger event occurred. The current status is "Post-Filling", indicating that the remainder of the buffer is being filled with post-trigger data. Indicator Example: The Status LEDs above indicate that the unit is powered, a trigger event has occurred and the remainder of the buffer is being filled with post-trigger data. Descriptions of each LED are provided below. P H Powered - The analyzer has been detected and is powered. Halted - The analyzer is 'IDLE' or waiting for a RUN command. P Pre Filling - The analyzer is capturing data and filling the 'Pre-Fill' portion of the buffer. A Armed - The analyzer is Armed and actively looking for a trigger condition. T Triggered - The analyzer detected a trigger event. P Post Filling - The remaining portion of the buffer is being filled with post trigger data. F Full Buffer - The buffer is full (normally only active for a split second). X Transferring - The analyzer is transferring the remaining compression records to the PC (normally only active for a split second). The typical progression of the status indicators is from left to right. 4.2 Capture History If the "Save capture to History" option is selected (default is off), each capture is stored on the Hard Drive as a history buffer and maintained according to the settings configured in Acquisition Options. Each project maintains its own history buffer in a sub folder using the same name as the project file. However, the project file does not require the history buffer to be present when opened. This allows the project file to operate as a 'stand-alone' file for sharing or archival purposes. When saving the project file, the currently loaded capture is embedded in the project (see also: Acquisition Options 110 ). History Browsing The history buffer can be accessed utilizing the History Menu, the Browse button or the bar graph. These items are located at the bottom of the main window. When browsing the history, the data for that history item will be loaded and all Signals, Auto Searches, Lists, Tables, etc. will refresh as if the data had just been captured. © 2017 TechTools Capturing Data 134 Menu Button Click the Menu button (highlighted below) to display the Capture History Menu: Clicking "Options" will take you to the History options in Acquisition Options 110 . Browse Button A Left-Click or Right-Click on the browse button (highlighted above) will load the previous or next item in the history buffer. Holding the mouse down will repeat the action in the same direction, causing an "Animation" of the history. Search History Button Click this button (highlighted above) to open the Capture History Search 192 . This allows a search of the entire capture history using any normal search displayed in the Global search or the Search Manager. Bookmark Button Click the Bookmark button (highlighted above) to toggle a bookmark for the current capture. If already bookmarked, then the bookmark is cleared. Bar Graph Bar Graph Display Items: § The triangle in the bar graph indicates the current position in the buffer. © 2017 TechTools 135 DigiView User's Guide § The small squares represent a bookmarked item which are also listed in the history's menu for quick access. § The numbers in the top-left portion of the bar graph represent the Capture ID 135 Number, the Position of the current capture in the buffer and the Total number of captures stored (in that order). Bar Graph Functions: § Click on the bar graph to "jump" to different items in the history. § Click and drag the mouse in the bar graph to display the history item number to be loaded when the mouse is released. § Click on the "Delete This Capture" button to delete the currently loaded capture. Once deleted, a capture is completely removed from the history and can not be restored. § When a capture has not been saved to the Capture History (feature is off or the data is a Preview), the "Delete This Capture" button changes to "Save This Capture". Click on the button to save the capture. See Also: History Searching 4.3 192 Status Window To open a new Status Window, use the "Open Feature Window" button (highlighted above) and select "Status" from the menu. Status windows can be docked, tabbed with other dockable windows or placed on any monitor (see Window Arrangement 9 ). The Status Window displays key statistics of the current capture being viewed, the Capture History and the last Analyzer Run. These statistics will be displayed for any capture in the history (when loaded for viewing) and for any new captures (whether stored in the history or marked for discarding). The Status window displays the following: Captured Samples - Total number of samples stored in the loaded capture. Samples are always at the full configured resolution of the Analyzer. DigiView never down-samples or discards samples in a capture. © 2017 TechTools Capturing Data 136 Total Timespan - The total time covered by the stored samples in the loaded capture, from the first sample to the last sample. Capture History ID - A unique identifier is assigned to each capture and used for storage and bookmarking purposes. The ID of the loaded capture is displayed here. This ID is also used as the filename extension in the capture history sub folder. Data and Time of Capture - The date and time (in millisecond resolution) is always stored when a capture is transferred to the PC from the Anlayzer. This is the actual capture time and may not always match the file date and time. This data is stored in each capture and can not be modified. Note: When opening older projects that did not store the capture date and time, this will display the project's data instead. Files in History - The Capture History is stored in a sub folder using the Project's name. This is the total number of compatible captures located in this directory that have been indexed by the project. The history is re-indexed whenever the project opens, captures are deleted or an indexed capture file is missing (by manual deletion, drive corruption, etc). If a capture is discovered to be missing while browsing or jumping to its index, the closest chronological capture to the missing index will be loaded instead. Saves/Captures this run - This statistic is updated whenever a capture is transferred to the PC or the Analyzer is halted and tracks the number of captures saved in the Capture History compared to the number of captures retrieved from the Analyzer since the Analyzer was last armed. Acquisition settings, Auto Search Settings and Plug-ins can determine when to discard or save a capture. Note: Preview data is not stored in the capture history. © 2017 TechTools Navigating and Analyzing the Data Part V Navigating and Analyzing the Data 5 138 Navigating and Analyzing the Data This is where you spend most of your time; trying to make sense of what you captured. You will find DigiView software very intuitive and easy to use but it is important to realize that ZOOM operations occur about the CENTER of the screen (the "@" reference). The tools are all designed to take advantage of this fact to make you more productive. The general paradigm is to find points of interest, bring them to the center of the screen and then ZOOM. We provide several methods of finding edges and bringing them to the center of the screen so that you can zoom in and out without having to constantly scroll to 'zero-in' on the point of interest. Navigation, Markers & Buttons: Waveform Views 138 § Toolbar Buttons 141 § Mouse Functions 143 § Signal Snap Column 146 § Marker Snap and Value Column § Bird's-Eye Scrollbar 149 § Marquee Zoom 150 § Using Markers 151 § Key Functions 159 147 Measurements: § § § § Instant measurements 161 Quick measurements 163 Dynamic Measurement Window Marker Time/Delta Window 171 166 Viewing the Data in Time-Relative Columns (Tabular Views): § Table Windows 173 § List Windows 176 Linking Views into Time-Relative Groups: · Using Link Groups 180 Searching the Data: § § § § § 5.1 Search Overview 181 Define Searches 181 Searching 188 Search Manager Windows Search Types 183 188 Waveform Views Waveform views are the central focus of navigating and analyzing the huge amount of captured data. In a waveform view you can Zoom quickly to different resolutions, snap to edges or beginning of packets, drop markers, take measurements and more. © 2017 TechTools 139 DigiView User's Guide Waveform View Details § § § § § § § § Toolbar Buttons 141 Mouse Functions 143 Signal Snap Column 146 Marker Snap and Value Column Bird's-Eye Scrollbar 149 Marquee Zoom 150 Using Markers 151 Key Functions 159 147 Waveform Overview The main application window has two Waveform Views permanently placed in the center. Additional Waveform Windows can be added and docked or positioned independently on any monitor (multiple monitors are supported). The Primary and Secondary waveform views are shown below. The Center Time Bookmark (center time reference) is considered "Center" because all operations center around this point and the 'Center time' displayed at the top of the Time Division area refers to its position. In the top Graphic above the Center Time is 21.36us and the bookmark is seen directly beneath it. Although it designates the center of operations, the bookmark can be moved left or right of center to suit your preference. The '@' reference point can be repositioned by moving the mouse over it until the special cursor appears, then click and drag it. © 2017 TechTools Navigating and Analyzing the Data 140 To open an additional Waveform View, use the Open Feature Window button (highlighted above) and select "Waveform View" from the menu. Unlike the primary and secondary Waveform Views, these additional Waveform Views can be docked, tabbed with other dockable windows or placed on any monitor (see Window Arrangement 9 ). Waveform View Function Summary § View multiple signals in time correlation. § Expand Multi-Channel Signals to see individual channel waveforms by using the " + " symbol to the left of the signal name. § Individually reverse Expand Order of Multi-channel signals by menu. § Collapse expanded Multi-Channel Signals by using the " - " symbol to the left of the signal name. § Zoom in or out for more or less resolution. § Single button Zoom Max resolution or Zoom Min resolution. § Marque to Zoom function. § Scroll by a single division or Page multiple divisions. § Free Scroll vertically and horizontally by a Right-Click Drag. § Change the Trigger Mode by a Click above the Trigger Column. (see Triggers 69 ) § Configure Simple Triggers by a Click on the Trigger Condition symbol beside each signal's name. (see Simple Trigger 71 ) § See Instant Time measurement between signal changes. (see Instant Measurements 161 ) § Take Quick Measurements by Clicking the Middle Mouse Button and moving the mouse. (see Quick Measurements 163 , Dynamic Measurements 166 ) § Link both Waveform Views at the center time for Synchronous Scrolling regardless of each view's zoom level. (see: Using Link Groups 180 ) § Drop Marker arbitrarily by Ctl-Drag or Drag & drop in the topmost row. § Snap Markers to next or previous transition of a signal by Drag & drop. (see Using Markers 151 ) § Snap Markers to next or previous transition and Bring to Center by Shift-Drag. § Snap Signal to the next or previous transition by using the " " indicators to the left of the signal. § Arbitrary Snap to center and Edge Snap to center by a Left-Click anywhere on a signal. § Set, Clear or Jump to markers. § Signal Row Order can be re-arranged by dragging. § Signal Format can be set to ASCII, Binary, Decimal, HEX or Octal. § Independently select which signals to view in each Waveform View. § Edit Signal Properties by menu or Left-Click on the signal's name. (see: Signal Editors 37 ) § Print current Waveform View or Save as JPEG. (see: Printing 205 ) Waveform Menus To access the main waveform menu, click its menu button (highlighted above). To access a Signal's menu, Right-Click on a Signal name or click on its menu button. Examples of these menus are displayed below. © 2017 TechTools 141 DigiView User's Guide Waveform Menu: 5.1.1 Waveform Signal Menu: Toolbar Buttons We make extensive use of the right mouse button. Most functions have naturally paired operations. Most paired functions are natural opposites (like left/right, in/out, first/last, previous/next). We take advantage of this symmetry to double up the functions of most buttons and other clicks. This not only reduces desktop usage but also results in more natural, easier to remember functions. For example, rather than having both a SEARCH LEFT and SEARCH RIGHT button, we have a SEARCH button. Left clicking the button will SEARCH LEFT; right clicking will SEARCH RIGHT. After only a few minutes of use, this becomes much more natural than using separate buttons. Switching directions involves pressing different mouse buttons rather than moving the mouse to a new button in the application. All buttons in the tool bar above the Waveform View are dual-function except the Menu button and Link Group indicator. Additionally, you will find that left and right clicking in Waveform Views on the " < " and " > " symbols, Marker column and various other areas will perform similarly paired functions. Tool Bar Detail Menu Opens the Waveform View menu using either the Left or Right mouse button. Search Left Click - Search Left and scroll to previous match using selected Global Search Right Click - Search Right and scroll to next match using selected Global Search © 2017 TechTools Navigating and Analyzing the Data 142 Previous View / Next View Left Click - Navigate backward in the waveform view's Scroll & Zoom history. Right Click - Navigate forward in the waveform view's Scroll & Zoom history. Zoom In/Out Max Left Click - Zoom IN ALL the way (Highest Resolution) Right Click - Zoom OUT ALL the way (show ALL data) Zoom In/Out Left Click - Zoom IN one step (more detail, more resolution) (hold to repeat) Right Click - Zoom OUT one step (less detail, less resolution) (hold to repeat) Scroll Start/End Left Click - Scroll to START of capture data Right Click - Scroll to END of capture data Scroll by 5 Left Click - Scroll left by 5 divisions (1/2 screen) (hold to repeat) Right Click - Scroll right by 5 divisions (1/2 screen) (hold to repeat) Scroll by 1 Left Click - Scroll left by 1 division. LEFT means to scroll the view window to an earlier point in time. (hold to repeat) Right Click - Scroll right by 1 division. Right means to scroll the view window to a later point in time. (hold to repeat) Toggle Instant Measurements Left Click - Toggle the visibility of Instant Measurements. Link Group Indicator This indicates which link group the view is assigned to. The primary and secondary Waveform views are permanently assigned to Link Group 1 and 2 respectively. Any additional Waveform Views can be assigned to any link group. A small arrow will be present in the lower right corner of the indicator if assignment is available. Left-Click on this indicator to change the group assignment (see Using Link Groups 180 ). © 2017 TechTools 143 5.1.2 DigiView User's Guide Mouse Functions The mouse is used heavily in Waveform Views. Using the mouse In these views you can perform a wide variety of functions that are summarized below. Place markers Drag and place markers or auto-snap to the next Signal change (see Using Markers 151 ). Take Measurements Select from a variety of measurement methods. View instant measurements while moving the mouse. Perform quick measurements between two points by using the middle mouse button or see the time between a marker's current and last position after snapping or dragging it (see Measurements 161 ). Navigate Click anywhere in a waveform to bring that point of time to the center of the screen. If you are within a few pixels of a change in the signal it will scroll to the center of the screen instead (Edge Snapping). Hold the Control Key when clicking near an edge to override Edge Snapping. Scroll the the next or previous change of a signal to the center of the screen by using the button in the Snap Signal Column 146 to the left of the waveform. Drag Scrolling Right-Click and Drag the mouse on a waveform to perform a 1:1 scroll in the horizontal direction. Right-Click and Drag the mouse vertically to scroll additional waveforms into view. Hand scrolling will not scroll vertically and horizontally at the same time so it chooses the direction based on the initial drag and displays arrows indicating the chosen direction. If you do not drag after using the Right-Click, the Waveform Menu will appear. Free Scrolling Along the bottom of each Waveform View is the Bird's-Eye Scrollbar position, jumping to another position or scrolling freely in the data. 149 for seeing relative © 2017 TechTools Navigating and Analyzing the Data 144 ZOOM Use the Mouse Wheel to change the Time per Division. Scroll the wheel forward to Zoom In (less time per division). Scroll the wheel backward to Zoom Out (more time per division). Time division changes in 1,2,5 increments (10ns, 20ns, 50ns, 100ns, 200ns, 500ns, 1us, 2us, etc). Expand, Edit and Change Signal Radix Expand a signal to see its individual channels or sub-signals using the small arrow to the left of the Signal Name. Click on the name to Edit the signal (see Signal Editors 37 ) and use the Signal's menu button to change the Radix and Swap the order of the expanded signals. Plot Handle Set the gain and position of Plots by dragging the Plot Handle at the end of the waveform. To switch between plots use the Space Bar or click on the handle of the plot to switch to. © 2017 TechTools 145 DigiView User's Guide Functions Organized by Mouse Button or Action Click on the Mouse Help button to display a summary of the mouse functions available in the waveform views. © 2017 TechTools Navigating and Analyzing the Data 5.1.3 146 Snap and Value Columns At the end of each waveform are two additional columns: The Snap Signal column and the Value/Marker Snap column. Snap Signal Column Scroll the next or previous change of a signal to the center of the screen by using the button in the Snap Signal column at the end of the waveform. Use the Left mouse button (Left-Click) to snap the previous transition into view. Use the right mouse button (Right-Click) to snap the next transition into view. The transition will scroll to the Time Reference point in the center of the screen (labeled '@' and visible to the right of the red marker below). The Snap Signal column is the first column to the right of the waveform: © 2017 TechTools 147 DigiView User's Guide Signal Value and Marker Snap Column The Value/Marker Snap column has multiple functions and a local menu for configuration options. It is the last column in the Waveform view, just after the Signal Snap column. Column features: 1. Displays the value of each signal at the selected Time Reference (Time Source). 2. Displays which waveform is currently assigned to the selected marker (Active Marker) by using the marker's colors. 3. Is used to assign a different waveform to the Active Marker without changing the marker's position. 4. Is used to snap the Active Marker to the Next or Previous edge of the assigned waveform. 5. Indicates the position of the currently selected marker (Active Marker) relative to the screen's Center Time reference (marked by the movable '@' tag). This Delta measurement is displayed at the very top of the column using the same colors as the selected marker. 6. Indicates the Time Source selection (for the column's waveform values) on the Time Source button. Example of assigning a marker to another signal without moving the marker's position: Click once in the column to re-assign the marker to another waveform. Once assigned, any Left or Right click will move the marker to the previous or next edge of the waveform. Holding either mouse button down will repeat the function. If the marker's "scroll to @" function has been enabled, the waveform's new marker position will scroll to the Center Time reference point ( also see: Using Markers: Marker Quick Menu 153 ). © 2017 TechTools Navigating and Analyzing the Data 148 Time Reference Selections: 1. (@) - Center Time (the '@' indicator, live value update when jumping, snapping or scrolling). 2. (A) - Active Marker Position (live value update with marker movement). 3. (M) - Mouse Position (live value update with mouse movement). 4. (T) - Trigger Position (static, values of each waveform at time 0). Click the Time Source button at the top of the value column (above the waveforms) to change the Time Reference for the displayed values. This button also serves as an indicator to remind you of the current setting. In the images above, this button displays the letter "A", indicating the values displayed for each waveform are from the time corresponding to the Active Marker's position. In the images below, the button indicates a selection of "Center Time", which is the time corresponding to the screen's time reference (marked by the movable '@' tag). © 2017 TechTools 149 DigiView User's Guide Click on the Time Source button to open the selection menu and change the setting: 5.1.4 Bird’s-Eye Scrollbar The Bird's-Eye scrollbar gives you the really big picture. It shows the relative zoom and position of the waveform window to the total data. As you navigate through the data, you can look at the Bird's-Eye to see exactly where you are in the data and how fast you are progressing through it. You can also use it to scroll through the data, jump to another area or jump directly to a marker. The total data is shown as a transparent box with an outline. When zoomed out, the portion of the data being viewed in the waveform window ("screen" area) is indicated by a rounded rectangle with vertical dividing lines corresponding to the 10 time divisions of the window. © 2017 TechTools Navigating and Analyzing the Data 150 Dragging the screen area of the bird's-eye will scroll the window view. When the window is zoomed in on a small percentage of the data (usually the case) the waveform screen representation becomes a pointed tag with the point indicating the center of the screen in the total data ("you are here" indicator). Each of the markers (and its complement if split) are also shown with color-coordinated lines. If the currently selected marker has been Split, the area between the marker and its complement is indicated with slanted slash marks in the color of the marker (see Using Markers 151 ). You can click on the Bird's-Eye scrollbar to jump to any position in the data. If you hold the Control Key while clicking near one of the markers, the waveform will "snap" to that marker's position. However, since the amount of time captured is so large compared to the available pixels on a monitor, you may not notice when several markers are represented by the same pixel. When several markers are represented by the same pixel the first represented marker will be chosen. 5.1.5 Marquee Zoom You can use your mouse to marquee an area of data to zoom in on. Left-Click and drag to marquee a section. When you release the mouse button, the enclosed area will pan to the center of the screen and them zoom in as much as possible while keeping the entire area on the screen. While holding the mouse button down to marquee, the area to zoom will darken. To cancel the marquee simply drag back towards the starting point until the darkened area disappears and release the mouse or drag completely away from the waveform area and release the mouse. © 2017 TechTools 151 DigiView User's Guide Zoom History If you accidentally marquee, Left-Click on the "Previous/Next View" button to return to the previous zoom level and position. Hold the mouse button down to repeat the action and go to earlier zoom levels and positions. If you go too far, Right-Click on the button to go forward through the view history (hold to repeat). 5.1.6 Using Markers Six main markers (M1 - M6) are provided and each of these markers can be split to form a marker pair (Main Marker + Complement), making a total of 12 markers available for measurement, bookmarking and other purposes. Complement markers are always displayed in the reverse color of their main marker and may also display a lower case 'c' after the marker number. The benefits from using DigiView's markers start to become obvious when seeing the variety of available uses: § Measure time from an edge of a signal. § Measure time from the Trigger Point (also see Marker Time/Delta 171 ). § Measure time from its complement marker or from any other marker (also see Marker Time/Delta 171 ). § Bookmark specific spots in the capture and jump to those spots with a single click or keystroke (see Quick Select Flags 152 , Key Functions 159 ), . § Bookmark a time span in the capture to quickly scroll and zoom that period into view with a Double-Click or keystroke (see Marker Time/Delta 171 , Key Functions 159 ). § Snap to the Previous or Next change in a signal and scroll that point to the Center of the screen (@). § View the value of multiple signals at the marker's time in the Marker Column. § Scroll a waveform vertically into view when activating its assigned marker. § Mark a time span for exporting (see Exporting 196 ). § Automatically scroll to and mark the result of a Pattern Search 187 function or a specific stage of a Sequential Search 183 function (also see Auto Search Windows 190 ). The most convenient access to markers and their options is the Quick Select Flags 152 in Waveform Views. Perform single-click jumping, placement by dragging, splitting, clearing and activate marker menus from these flags. Markers are global to the application, so any changes will be reflected throughout the program. The only exception to this rule is the marker that is currently active in a particular Waveform View. Each Waveform View maintains its own status of which marker is the local "active marker". Each signal's value that corresponds to the active marker's position in a Waveform View is displayed in the marker column. The Active Marker The Active Marker is the marker currently being used or selected. Dragging a marker, jumping to a marker, changing its options or performing a search will automatically set the marker involved as the Active Marker. Items affected in Waveform Views when a marker becomes the Active Marker: § Quick Select marker flag highlights. § Marker Flag highlights and is brought in front of other flags. © 2017 TechTools Navigating and Analyzing the Data 152 § The Marker Column reflects each signal's value at the Active Marker's time. § The time displayed at the top of the Marker Column is the time from the Active Marker to the Center Time of the Waveform View (@). § The time displayed at the top of the Marker Column is highlighted using the color of the Active Marker. § The Snap Marker buttons at the top of the Snap Signal Column changes to the same color as the Active Marker. § A right or left click on the Snap Marker buttons will snap the active marker to a signal edge if the marker is assigned to a signal. § The static measurements will display for the active marker in full color and on top of any other visible marker measurements. § When the Active Marker is moved or snapped to an edge it will display the time from its last position to its new position. If split, it will display the time from the position of its complement instead. § If "Scroll-n-View" is enabled and the Active Marker is assigned to a signal, the assigned signal's waveform will scroll into view if not already visible. The Quick Select Flags The Quick Select flags are located in the upper left corner of all Waveform Views. From these flags you can jump to a marker's position with a single click, place a marker, split a marker to create a tethered pair (creates the "complement"), clear a marker and open the marker menus. These flags use the same colors as those defined for markers in the Color Theme. The active one is always highlighted as displayed for Marker number one above (referenced as 1 or M1). Dragging from these flags will bring the marker to the current screen position and make it visible if necessary. Clicking on one of these flags will automatically scroll the waveform view to the markers position and center it in the waveform window. This can also be referred to as "Jump to Marker ". The last flag (after the flag for M6) is a Global Flag that affects all markers. A Left-Click on this flag will clear all markers including marker complements. A Right-Click will open the Global Marker menu 154 . Quick Select Mouse and Key Functions § Left-Click - Scroll the position of the marker to the Center of the screen (@). § Click-n-Drag - Activates and brings the marker to the mouse when the drag begins. Position the marker for placement before releasing the mouse. § Right-Click - Opens the Menu for this marker. § Control Key + Click - Scrolls to the position of the main marker's complement. If not already split, the marker will be split and the complement placed at the Center of the screen. § Control Key + Click-n-Drag - Activates and brings the marker's complement to the mouse when the drag begins. Position the complement marker then release the mouse when ready. If the main marker was not already split into the main/complement pair, it will automatically split so the complement can be brought to the mouse position when the drag begins. © 2017 TechTools 153 DigiView User's Guide § Control Key + Right-Click - Opens the Menu for this marker's complement. If not already split, the marker will be split and the complement placed at the Center of the screen before the menu opens. § Mouse Move - When the mouse moves over a flag, the associated marker's flags will highlight and display on top of other marker flags. § Control Key + Mouse Move - Activates the associated marker as the "Active" marker, but does not scroll to its position. The marker's flags will highlight and display on top of other marker flags. Marker Quick Menu Activate a marker's menu by a Right-Click on the Marker Flag. You can also use the Quick Select flags to activate this menu, but to access the menu of a marker's complement from the Quick Select flags, use Control-Key + Right-Click. The menu for M2 and the menu for it's complement are displayed above. § Clear - Disables and removes the marker from view. If split, the complement is also cleared. § Scroll to @ on Snap - Toggles the marker "tack" or "sticky" state. When enabled, the marker will always bring the point of placement to the center of the screen (@). This will occur whenever the marker is placed on a signal, dropped in the Division tick area or snapped to a signal's edge. § Split - When enabled, the marker is split into a pair of tethered markers. We refer to the original marker as the Main Marker and the newly created marker as its Complement. When split, the static measurement for the marker will measure the time between the marker and it's complement instead of tracking it's last position. Quick select flags will have two "dots" above the marker number to indicate the split. The complement marker is always displayed in the inverted colors of it's main marker and has a lower case 'c' appended to its designator in many cases. Disable this option to clear the complement. § Lock with Complement / Main Marker - This option is available after splitting a marker. Enable this option to lock the distance between a main marker and it's complement. Dragging, snapping or placing either marker will also move the other but the distance and order will remain the same. When locked, the Quick Select flags will connect the two dots above the marker number to indicate the pair is locked. Disable this option to unlock the pair and allow each to move independently. § Goto Complement / Main Marker - This option is available after splitting a marker. Click this option to jump to the position of the other marker in the pair. If you opened the menu for the complement, you will jump to the location of the main marker. © 2017 TechTools Navigating and Analyzing the Data 154 § Zoom to Split Pair - This option is available after splitting a marker. Click on this option to bring both markers into view. First, the Waveform View will Zoom to a resolution that fits the time span of the marker pair, then it will scroll that time span to the center of the window (@). If the Center indicator (@) is not centered, drag it to the center to see both markers. Global Marker Menu The Global Marker Menu affects all markers. The first two items are global settings that involve markers and the remaining items change the settings of the actual markers. § Enable Scroll-n-View - Enable this feature to have a waveform scroll into view whenever you activate the marker last assigned to it. This can be beneficial if you are analyzing multiple waveforms that can not be viewed in the screen area at the same time and do not want to manually scroll each into view as you jump back and forth between them. If you are using the markers to jump to multiple time points, when you click on the marker the position will horizontally scroll to the marker and the waveform will vertically scroll to display the signal's waveform. § Show Static Measurements - When enabled, marker measurements are always visible on the screen based on Environment options. Disable this option to temporarily hide these measurements (see Environment Settings 127 ). § Clear All - Click on this item to clear all markers including their complement. When cleared, the markers are no longer visible and each marker's options are reset. § Set Scroll to @ on Snap - This will enable the "Sticky" function of all enabled markers. This can also be set independently for each marker by using the Marker Quick Menu. § Clear Scroll to @ on Snap - Clears this setting for all enabled markers. This can also be set independently for each marker by using the Marker Quick Menu. The remaining items are visible depending on the current settings of all enabled markers. § Clear Compliments - If any enabled marker is split into the Main/Complement pair, the complement will be removed. This can also be done for specific markers by using its Quick Menu. § Lock All Split Pairs - This will lock the distance between the Main/Complement pair of any split marker. This can also be done for specific markers by using its Quick Menu. § Unlock All Split Pairs - This will unlock the distance between the Main/Complement pair of any split marker so that each half can move independently. This can also be done for specific markers by using its Quick Menu. © 2017 TechTools 155 DigiView User's Guide Drag to Place Simply click on a marker and drag it to the area of interest. You can grab the marker itself (the vertical line in the waveform area) or its 'flag'. When your mouse is in the capture zone for a marker, the cursor changes to indicate that it is over a marker. The cursor also indicates which marker will be selected, making it easier to grab a specific marker when they are very close together (or even on top of each other). If the marker is off-screen or not visible, use the Quick Select flags to grab the marker and place it. Auto Snap 'Snapping' the markers to signal edges makes it easy to measure the time between them or to bring a specific edge to the center of the window. This operation is used so often that we optimized it by making it an automatic function. When you are dragging a marker and your mouse is over a waveform, the cursor changes to a 'snap-left' or 'snap-right' arrow. The direction of the arrow shows you which edge (previous or next) of this waveform the marker will 'snap' to if you were to drop it at that point. The arrow will point to the nearest edge or to the nearest edge in the direction of mouse movement, even if that edge is off-screen. © 2017 TechTools Navigating and Analyzing the Data 156 The time from the marker's last position is measured to the proposed drop point even if one or both points are off screen. In the graphic above, the marker's last position was off screen. Using the Quick Select flags we performed a marker drag on M3 and are moving it to the left over signal "CODE: Clock Channel". The snap indicator is drawn around the previous signal edge since we are moving to the left. The Marker column changes to the marker's color indicating the marker is now assigned to that signal. After releasing the mouse button, the marker snaps to the proposed edge and the time between the marker's current position and the center Time Reference point (@) is displayed in the upper left corner using the marker's color. Below, we see this measurement to be 900ns. We also see the measurement from the marker's last position to its current position just above the signal's waveform. Below, we see that measurement as 3.52 us. If you DO NOT want to SNAP, but rather wish to drop the marker exactly at the mouse position, you can either hold down the Control key or move your mouse above or below all waveforms before releasing the mouse button. © 2017 TechTools 157 DigiView User's Guide Snap and Measure 'Snapping' markers to signal edges makes it easy to measure time between them or to bring a specific edge to the center of the window (when "Scroll to @ on Snap" is enabled). When a marker is assigned to a signal, the marker column uses the same color as the marker. To snap to the previous or next edge, use the left or right mouse button respectively. In the graphic below we Right-Clicked in the marker column, causing the marker to snap to the next edge of the signal and measure the time from its last position (also see: Snap and Value columns 146 ). To assign the marker to another signal, Left-Click in the marker column of another signal. The first click assigns the marker. Any additional clicks will perform snap operations. If you drag a marker over a signal it automatically becomes the assigned signal. Split Marker All main markers (M1 - M6) can be split form a tethered marker pair (a Main Marker and its Complement). To split a marker, Right-Click on the marker's flag and select "Split". When splitting a marker, its complement is placed at the Center Time reference (@) and the Complement marker is activated as the "Active Marker", meaning all indicators that reference the active marker will now display in reverse colors since complements use the inverted color of their main marker. If we select the main marker all indicates will return to the main marker's colors. The time measurement now reflects the time between the pair. © 2017 TechTools Navigating and Analyzing the Data 158 If you look closely at the Quick Select flag for M3 you will see two small dots above it. This indicates the marker is split and each half can move independently. To lock the pair, move the markers to the desired position, Right-Click on the marker's flag and select the "Lock" item. The selection text will be "Lock with Complement" if you clicked on the main marker's flag, but will be "Lock with Main Marker" if you clicked on the Complement's flag. After selecting lock, the marker pair will always move together no matter which of the pair is the active marker. This includes dragging, snapping and placement by other means such as a search result (see Searches 181 ). The two dots above the Quick Select flag will be connected to indicate the split pair is locked. The graphic below shows how the distance between the two markers remains the same even after we snap the main marker several edges to the right. You can use this technique to readily compare a time span of multiple points in the captured data without having to mark or remember the precise period of each. © 2017 TechTools 159 DigiView User's Guide If you look closely at the Quick Select flag for M3 you will see a ^ symbol above it. This indicates the marker pair is locked and will move together. 5.1.7 Key Functions The HOT-KEYs are not expected to replace a mouse, but rather, supplement it. When analyzing lots of data, it can be useful to use the keyboard for say, ZOOMING and SCROLLING while using the mouse to drag a marker or as a snap modifier before dropping a marker. Hot Keys, Number Keys and Navigation Keys Click on the Key Help button to display a summary of the key functions available in the waveform views. © 2017 TechTools Navigating and Analyzing the Data © 2017 TechTools 160 161 5.2 DigiView User's Guide Measurements A wide range of measurement features are available from automatic instant measurements to user selected dynamic measurements. Dynamic measurements update based on which waveform the mouse moves over and changes its time span when a Quick measurement is being performed. Each section below covers a unique method of calculating and displaying measurements to assist your analysis of the captured data. The Marker Delta window has the added benefit of Zooming and Scrolling a measured pair of markers into view when Double-Clicked. Measurement Features § Instant Measurements 161 § Quick Measurements 163 § Dynamic Measurement Window 166 § Marker Delta Measurement Window 5.2.1 171 Instant Measurements While moving the mouse over any waveform a measurement is displayed directly above it (see Environment Settings: Waveform Views 129 ). The type of measurement is dependent upon the signal type and the mouse position in the waveform. Vertical lines and arrows are displayed to indicate which edges are being measured. The measurements are calculated even if the beginning and ending points of the measured item are off-screen. Use this toolbar button to toggle Instant Measurements On/Off in a waveform view. Boolean Example Mouse is between two edges so instant measurements calculates the time period between those edges. In the graphic below, the Period between the edges is 1.692 microseconds. When the Mouse is on an edge, instant measurements uses the previous and next edge to calculate the duty between the edge under the mouse and the previous one. If this is a low period then Low Duty is represented, otherwise High Duty will be represented. In the graphic below, the Low Duty is 51.30%. It also calculates the Period and Frequency from the previous edge to the next one as depicted by the arrows. In the graphic below, the Period is 3.3 microseconds and the Frequency is 303.030 KHz. © 2017 TechTools Navigating and Analyzing the Data 162 Example for Signals with Field and Frame data When the mouse is within the edges of a Field, the time period of the Field is calculated. In the graphic below, the Period for the Field under the mouse is 23.1 microseconds. When the Mouse is on the edge of a field, instant measurements calculates the Period and Field Count of the Frame the Field belongs to. In the graphic below, the Period for the entire Frame is 83.784 microseconds and the Frame contains 4 Fields. The period and count are calculated even though the frame begins or ends off-screen. Example for Signals with Plot Enabled When a signal is in plotting mode, Instant Measurements will function on the Plot data and display the value of the plot at the mouse point. If multiple plots are enabled for the signal, Instant Measurements will function on the selected plot. Pressing the Space Bar will toggle the plot selection without having to move the mouse. In the first graphic below, the bottom plot is being measured. This is identified by its plot handle being highlighted in the plot's color. The Signal Snap arrows in the next column are also the same color as the plot and the marker column displays the selected plot's identifier. These items will change to identify the active plot. In this case we used "Left_Channel" and "Right_Channel" to identify the two enabled plots for the Audio signal. After pressing the space bar once, the second plot becomes active and instant measurements will track its values as displayed in the second graphic ("Right_Channel" plot is active). © 2017 TechTools 163 DigiView User's Guide After pressing the space bar, the other plot value is displayed while moving the mouse. A dotted Vertical line is always drawn at the mouse point and a small square surrounds the point where this intersects with plotted data. The value at this intersection is displayed in the Instant Measurement. 5.2.2 Quick Measurements With Quick Measurements you can instantly perform multiple measurements in a waveform by using the Middle Mouse Button. Click the middle button and move the mouse to display measurements from any position (including over markers) to another position. These measurements are unique to the signal type and whether the Signal Definition has plotting enabled. You can also measure the period between two edges across multiple signals. A simple period measurement is always displayed above the waveform between the two points while performing the Quick Measurement. However, additional measurements will appear in a floating window that hovers near the mouse. To dismiss the Quick Measurement, simply click again using any mouse button or use the ESC Key. Note: While performing a Quick Measurement, any Dynamic Measurement 161 windows in the same link group will use the period measured as the time span. Note: Using the Control Key will override Signal Edge Snapping while measuring. (also see Environment Settings: Waveform Views 129 ) Measure across multiple signals Quick Measurements will snap to a transition edge (when near) and remember the Signal of the starting and ending measurement point. The measurement is always displayed for the signal currently under the mouse. However, if the starting signal is different than the ending signal, an additional arrow is displayed in the starting signal at the starting point. © 2017 TechTools Navigating and Analyzing the Data 164 In the graphic above, we are measuring the time between the falling edge of ALE and the falling edge of OE. We started the Quick Measurement on ALE so an additional arrow is displayed on the edge we started with. Any measurements displayed in the floating window will be measured from the signal currently under the mouse (OE in the graphic above). Boolean Example © 2017 TechTools 165 DigiView User's Guide Example for Signals with Field and Frame data Example for Signals with Plot Enabled When a signal is in plotting mode, Quick Measurements will calculate using the Plot data between the two mouse points. If multiple plots are enabled for the signal, Quick Measurements will function on the selected plot. Pressing the Space Bar will toggle the plot selection and refresh the measurements without having to move the mouse. © 2017 TechTools Navigating and Analyzing the Data 5.2.3 166 Dynamic Measurement Window Dynamic Measurement Windows offer a variety of measurements that can be selected for each type of Signal group. As the mouse moves over the waveform of a signal, the selected measurements for that signal type will recalculate and display in the window. To open a new Dynamic Measurement Window, use the Open Feature Window button (highlighted above) and select "Measurements" from the menu. Dynamic Measurement windows can be docked, tabbed with other dockable windows or placed on any monitor (see Window Arrangement 9 ). The images below are examples of how the measurements change based on the signal group (Boolean, Bus, Decoder/Parsed, Plot). © 2017 TechTools 167 DigiView User's Guide Signal: The name of the signal being measured. Group: The measurement group compatible with the signal. The selected measurements of this group will be calculated and displayed in the window. If the signal has plotting enabled, the Plot group of measurements are displayed for the currently active plot. The Plot Series number (S1, S2, S3, S4) will be prepended to the value as a reminder of which Plot Series is active for the signal. Span: This indicates which Time Span is being used for calculations; Waveform Window or Quick Measurement. By default, the time span of the waveform window that is responding to mouse movements is used. However, while performing a Quick Measurement 163 , this will automatically change to use the Quick Measurement's time span (and recalculate the measurements accordingly). When the Quick Measurement is no longer active (middle mouse button is released) the time span reverts back to the Waveform Window's time span. © 2017 TechTools Navigating and Analyzing the Data 168 Locking the Span & Signal: After moving the mouse over a signal you can Lock the Dynamic measurement and jump to specific measurement items such as the Lowest Value, or Longest Duration. Any measurement with this feature will have an outline indicating it is a clickable line item that will scroll any linked windows to the location of the result. You may not see any clickable line items or you may see several depending on the signal type and the selected measurements. In order to use the mouse to Click on one of these items, you must first "Lock" the measurements from the Waveform View your mouse is over. Simply use the Control+L Key or Right-Click and select "Lock/Unlock Dynamic Measurements" from the menu. As seen above, the lock indicator will change for any Dynamic Measurement windows in the same link Group. You can also unlock the window by clicking on the indicator. Jump to Measurement Result: Click on any measurement item with an outline to go to the location of the result. The outline indicates it is a clickable line item that will scroll any window in the same link group to the location of the measurement. When you mouse over these items, the location is displayed in a popup hint (as seen in the image below). Note: The window should be locked before clicking on any item to prevent the contents from changing. If left unlocked, the measured items will update while scrolling to the location clicked (see Locking the Span & Signal above). In the image above, clicking on the item under the mouse will scroll any waveform or tabular view in Link Group 1 to the time indicated in the hint ( -8.89428 ms, also see Link Groups 180 ) © 2017 TechTools 169 DigiView User's Guide Selecting Measurements Compatible measurements for each signal type are divided into individual selectable groups. You can choose whatever measurements you want to display for that type. Selection is optional, so do not select any if you you do not need a measurement for a particular signal type. The Dynamic Measurement window will only display the measurements you select and those will only display when the mouse is over a compatible signal type. Left-Click in the window or Click on the Select Measurements button (highlighted in blue above) in the toolbar to open the Dynamic Measurement Selections window. Boolean Measurements Bus Measurements © 2017 TechTools Navigating and Analyzing the Data 170 Decoder/Parsed Measurements Active Plot Measurements Select or Clear All The Select All and Clear All buttons will select or clear all items for the current measurement group. For example, if you are editing the selections for the Boolean group, pressing "Clear All" will not clear selections in the other groups. Toggle Selection A "selected" pointer will be displayed on the left of any selected item. Click on any item to toggle its selection state. If the item is already selected, a click will clear it. © 2017 TechTools 171 5.2.4 DigiView User's Guide Marker Time/Delta To open a new Marker Time/Delta Window, use the Open Feature Window button (highlighted above) and select "Marker Time/Delta" from the menu. Marker Time/Delta windows can be docked, tabbed with other dockable windows or placed on any monitor (see Window Arrangement 9 ). Select from pairs of markers or from markers and the Trigger point to track the time delta between the selected items. NOTE: Double-Click on a selected pair to scroll and zoom both into view. Selection is not limited to adjacent pairs. Any combination of markers and/or the Trigger Point can be selected. The time between a pair of selected items is displayed to their right. Tool Bar Buttons Menu Select the Menu button (highlighted above) to access Window options. © 2017 TechTools Navigating and Analyzing the Data 172 Menu Add New Time Item Select the Add New Time Item button (highlighted above) or the Add Marker Time/Delta menu item to open the Choose Marker Pair selector. Click on one item in each column to add a marker pair to the Marker Time/Delta window. As soon as the second item is clicked, the pair is added. When selecting, all duplicates are prevented and will not be added to the window. For example, adding M4 to M5 is the same as adding M5 to M4 so only the first set will be seen in the window. Invalid selections such as a duplicate pair or selecting the same marker in each column are cleared. When you have finished selecting pairs, press the Escape Key or click the red close button in the upper right corner of the selector (X). Delete the selected Item To Delete an item from the list, first select it by using a single Left-Click. After an item is selected, use the Delete button (highlighted above) or the "Delete Selected" menu item to remove it. Selected items are surrounded by a dotted rectangle similar to the last item in the top graphic or Marker 4 in the above graphic. To Delete all items, use the "Delete All" menu item. Link Group indicator and selector The last item on the tool bar is the Link Group assignment. Any actions performed in the window that affects the time or position of other windows will be performed only on those windows that belong to the same group. Click on the indicator to change the group assignment. © 2017 TechTools 173 DigiView User's Guide Zoom and Scroll Double-Click on an item in the list or use the "Jump to Marker Pair" menu item to Zoom and Scroll the pair of markers into view. The focused Waveform Window in the same Link Group will update to a zoom level where both markers are in view and centered on the "@" symbol. Any other windows in the same group will synchronize their center time to match. 5.3 Table View Windows Table views present the data as a list of numbers (tabular form). Table windows can be created by using the Feature Window button on the Top Toolbar 7 , or by using the Main Menu (Menu-> Window-> New-> Table View). Table creation selections in the Main Menu and Feature Window lists are only available after creating a Signal Definition 35 . Any signal type can be displayed in Tables. However, decoded signals will be displayed in their raw channel values. To see the decoded values of these signals in a tabular view see Tabular Views 176 . To create a new Table Window, select the Open Feature Window button (highlighted above) from the main toolbar, then select the name of a defined signal from the Table menu item. Only the Signal Definitions you create for the project will be listed on the Tabular View. © 2017 TechTools Navigating and Analyzing the Data 174 § Multiple tables can be created and viewed simultaneously. § Multiple signals can be viewed with each signal in a separate column. § Multi-Channel Signals can be "expanded" to multiple columns. § Expand order of Multi-channel signals can be reversed. § Signal column order can be re-arranged by dragging. § Bus Signals can be formatted as Binary, HEX or Decimal. § Time Display can be set to Auto, ns, us, ms, sec, min, hrs, days or weeks. § Time Format can be set to Delta or Absolute. § Time Column can be hidden. § Set, Clear or Jump to markers. (see Using Markers 151 ) § Assign Time Synchronized Link Group. (see: Using Link Groups 180 ) § Select which Signals to view in each Table. § Edit Signal Properties. (see: Signal Editors 37 ) § Print current Table View or Save as JPEG. (see: Printing 205 ) § Export data using Table's settings. (see: Exporting Tables 202 ) While most manufacturers provide table views, they generally are not too useful for anything other than STATE mode signals. Most logic analyzer demos will show data changing on every sample, making the table view look interesting in timing mode. However, in real usage, most signals do not change at anywhere near the sample rate, causing the table to show a small sample of stable data. You might have to scroll several screens before seeing the signal transition. We have added several enhancements to the basic table view to make them truly beneficial in real-world usage. Compressed View This mode compresses out the 'dead-time' between transitions, packing a lot more information into a screen of table data. Each line of data in the table contains the timestamp and the data. The time between lines varies and corresponds to the length of time the previous sample was stable. In this mode, a 40 line table contains 40 transitions. In linear (non-compressed) mode, it would contain 40 SAMPLES with perhaps NO transitions. If multiple signals are added to the table, the compression algorithm takes ALL signals in to account. A new line is shown any time ANY of the signals change state. Nothing is lost or thrown away. We simply compress out the redundant information, making the table hold more significant data. You can switch between compressed and linear views with a single click at any time. © 2017 TechTools 175 DigiView User's Guide Although compressed mode is the most efficient way to display a signal in tabular form, some people have trouble visualizing the non-linear, compressed time. You can Link a compressed table with other non-compressed tables or with waveform displays to correlate the data to a linear view. This allows BOTH an efficient table view and a linear 'in-context' view. The included '8051.dvdat' example demonstrates this well. The OE signal in that example is spread across about 1.4 Million samples but can be displayed in less than 20 table lines when compression is enabled. When this table is linked to a waveform view, scrolling through this small table quickly scrolls the waveform to each significant event in the OE signal. This is a real-world example captured from a real embedded system. Delta vs. Linear time Regardless of the display mode( normal, compressed or down-sampled), you can display the time field in absolute or delta time. Absolute is the actual timestamp of the sample (relative to trigger). DELTA mode shows the time between table lines. This is most useful in compressed mode where it tells you the time between transitions. In normal and down-sampled modes, it simply tells you the sample rate( since the time between each line is constant). Table Menu The table's menu offers several useful functions such as navigating to a reference point, adding additional signals, configuring the time and so forth. Example of this menu is displayed below. Table General Menu: © 2017 TechTools Navigating and Analyzing the Data 176 Signal Menu Each signal in the table has its own menu options. To activate the menu for a specific signal from within the table, right-click in the signals' column. Example of this menu is displayed below. Table Signal Menu: 5.4 Tabular Views Tabular views (also called List Views or Decoded List) present the decoded data of signals in a column form. Tabular views can be created after defining any signal. Tabular Views can be created by using the Feature Window button on the Top Toolbar 7 , by using the local menu of a signal in Waveform Views 138 or by using the Main Menu (Menu-> Window-> New-> Tabular View). Selections in the Main Menu and Feature Window lists are only available after creating a Signal Definition 35 . All signals, from Boolean and Bus to Protocol decoding or any Plug-in signal can be displayed in the List window. However, to see only the raw channel data of a Decoded signal in tabular format without any decoding, use a Table view instead. (see: Table Views 173 ) To create a new Tabular View, select the Open Feature Window button (highlighted above) from the main toolbar, then select the signal name from the Tabular View menu item. If you select a Boolean or Bus signal, a Table View 173 will be created instead. Only the Signal Definitions you create for the project will be listed on the Tabular View. © 2017 TechTools 177 DigiView User's Guide § § § § § § § § § § § § Multiple lists can be created and viewed simultaneously. Time Display can be set to Auto, ns, us, ms, sec, min, hrs, days or weeks. Time Format can be set to Delta or Absolute. Time Column can be hidden. Set, Clear or Jump to markers. (see Markers 151 ) Assign Time Synchronized Link Group. (see: Using Link Groups 180 ) Select which Signal to view in each List. Edit Signal Properties. (see: Signal Editors 37 ) Print current Tabular View or Save as JPEG. (see: Printing 205 ) Export data using view's settings. (see: Exporting Lists 200 ) The Radix can be set to Binary, Decimal, Hex, Octal or ASCII. Field widths can be set for "Auto Size" (width is content based) or manually sized with a zoom button (equal width for all fields). § Selecting a field in a List will scroll all windows of the same Link Group to the field's start time and vise-versa (as shown above, the selected field is the darkened "35" in the center row. § Navigate and scroll using the Cursor Keys and Mouse Wheel. Tabular Views have several options to change what data to display and how the data is displayed. These options are accessible from the top bar in the window and can be used in combination. Some examples of the display options are shown below using an I2C signal. © 2017 TechTools Navigating and Analyzing the Data Time Column: Time Column, Name: © 2017 TechTools 178 179 DigiView User's Guide Time Column, Name, Frames: Frames: © 2017 TechTools Navigating and Analyzing the Data 180 Menu: 5.5 Using Link Groups Link groups provide Synchronous Scrolling of a group of windows that display data. When several windows are part of the same Link Group, each window will automatically update and scroll when any member of the group changes its center time. The time reference and displayed data of each member will "center" on the time the changing member centers on. This feature keeps a group of windows synchronized to the same time in the captured data. DigiView provides five link options that include Link Groups 1 through 4 and a "no-link" option for windows that you want to keep independent. Default link groups: Link Group 1 this group. Link Group 2 Link Group 3 Link Group 4 - Waveform View 1 is always a member and all new windows initially belong to Waveform View 2 is always a member of Link Group 2. Empty Group, ready for members. Empty Group, ready for members. The link group of any window that displays data (such as Tables and Tabular Views), can be changed at any time. To change the group in these windows Click on the Link Group Indicator on the window's toolbar or select Link from its menu (Menu-> Window-> Link). Link options are displayed in the following graphic. © 2017 TechTools 181 DigiView User's Guide All windows or views that are assigned to a link group will have a visible indicator with the group number or an " * " (asterisk) displayed. The Primary and Secondary Waveform Views are permanently assigned to groups 1 and 2 respectively. All other windows can be assigned to any of the 4 link groups or set to be independent of link groups (*). A small arrow is displayed in the lower right corner of the link group indicator if the group assignment can be modified. Link Group indicator: NOTE: When Waveform View 1 is "cross-linked" to Waveform View 2, all members of Link Groups 1 and 2 will also be cross-linked. Waveform Views are cross-linked by using the Link button on the Top Tool Bar. (see Top Tool Bar 7 ) 5.6 Searches When analyzing the captured data, the ability to search forward and backward for specific pattern matches or packet values is indispensable. DigiView provides a general search type for pattern matches, a Sequential Frame and Sequential Field search for decoded/parsed/plug-in signals and a Search Manager to quickly perform multiple searches and change criteria. DigiView also provides a Capture History Search feature that utilizes any defined search to iterate through the entire history and load the capture that meets the match critera. The following sections provide details of DigiView's searching capabilities. § § § § § § 5.6.1 Defining Searches 181 DigiView's Search Types 183 Performing a Search 188 Using the Search Manager 188 Auto Search Windows 190 Searching Capture History 192 Define Searches New searches are defined by opening the Search Manager 188 window and clicking on the "New" button or using the main menu (Menu-> Search-> New Search) then selecting the signal to search from the selection list. Depending on the type of signal selected, a Pattern Search or Sequential Search will be created and its editor window will automatically open. For example, if you have selected a signal of type "I2C", then the Sequential search type will be created. (For details on each search types, see: Search Types 183 ). © 2017 TechTools Navigating and Analyzing the Data 182 After a search is created it will be available in the Search Manager 188 and all search selection windows, including selection for Auto Search 190 windows and searching the Capture History 133 files. All search types (and therefore all search editors) have the following common properties. Search Name - Description Use the Name field to describe the search. This descriptor will be displayed in the Search Manager Window and any search selection box. From - Where to begin Searching The 'search from' selection determines where the search starts from; the current center of screen or the current marker location. Since the marker is placed at the center of the screen after the first search match, these are often the same during consecutive searches. The main difference occurs during the first search or between searches if you scroll the screen. Set Marker - Mark the match point The marker selection determines which marker is used to show the search match. You must select one. Whenever the search matches, the selected marker is placed at the match point and then centered in the searched window. Delete Button - Deletes this search Use the Delete button to dispose of the search and remove it from all search managers. Close Button - Closes this search editor window Use the Close button when you are finished making changes and want to close the editor for this search. Search Button - Performs this search Use the Search button to test the settings you have just entered for this search. Right-Click to search forward from the current time of the marker. Left-Click to search backward from the current time of the marker. When you are satisfied with the search settings, you can close the search and use any search button in the application to continue searching. (see: Searching 188 ) © 2017 TechTools 183 5.6.1.1 DigiView User's Guide Search Types Searches are defined in terms of Signals matching specific criteria. Depending on the search type, one or more signals are selected and a match pattern, match value or other conditions are defined for each. All Boolean and Bus signals use the Pattern Search type and all other signals (including those derived from Plug-ins), use the Sequential Search type. Sequential searches allow a sequence of match conditions consisting of fields within frames among a sequence of frames. Each field match can have a specific value or a "don't care" (Any) value, and a specific skip count or a skip count of "Any". With the sequential search a very long sequence, consisting of multiple wildcards (any Field, any Frame, any Field Value) and specific frame or field skip counts and specific Fields and Field values, can be defined to locate the proverbial "needle" in a very long "hay stack". Sequential searches also have the option of placing the match marker at a specific point in the match sequence. Pattern searches match a pattern across multiple signals at a single point of time in the capture. When ALL specified signals and conditions match the search criteria, the time of the match condition (or Match Point) will be centered in the window that has "focus". Any other windows that are a member of the same Link Group, will also center on the match point. (see: Searching 188 , Link Groups 180 ) Details of each search type are explained in the following sections. § Sequential Searches § Pattern Searches 187 183 5.6.1.1.1 Sequential Searches The Sequential search type is used by all Plug-ins or Parsed (decoded) signal types. This includes all signals except Boolean and Bus signals (see: Define Searches 181 ). This search type has a group of search terms (or criteria) that is specific to the chosen signal type, and can perform a search sequence by adding additional terms. Terms can be added by using the Copy or More buttons. By changing the Mode (Field or Frame) to Fields, you can target the search to sequentially match while ignoring frame boundaries. To look for a sequence of multiple frames, each having their own field sequence match, select the Frame mode. If frame information is not present in the data, the Mode will be limited to Field sequences. © 2017 TechTools Navigating and Analyzing the Data 184 Field Mode The number of Field terms is unlimited and each term is labeled using ASCII characters. In the image above, three field terms are visible (a., b., c. ). Using term 'a.' as an example, each option is explained below. Push Pin button - This identifies which point in the sequence will be marked as the match time in the search results. When selected, the 'Push Pin' will appear blue, indicating the search marker will be placed at the beginning of this specific match term. When de-selected, it will appear white, meaning another term in the sequence has been selected for the marker position. The first term in the sequence will be selected automatically if none are selected. Skip and Skip Count - Skip options are "Any number of fields" or "Specified number of fields". When set to "Any number of Fields", the search will ignore the skip count and continue searching for the next field that matches the criteria. The search will continue to the end of the captured data if necessary before reporting a 'no match'. However, when set to "Specified number of Fields", the search will only ignore (and skip) the number of fields specified in the skip count editor before looking for the next match. If the next term after the skip count does not match, then the search reports a 'no match'. Setting the skip count to a value of "0" instructs the search to analyze the very next field in sequence (Do Not Skip). © 2017 TechTools 185 DigiView User's Guide Field - Some Signal types will have many field identifiers that can be used for targeted searching. The Field selection can be used to choose the specific field type to search. If the field to consider for the match is not the type specified, then the result is a 'no match', even if the value for the field matches the specified value. The field selection options for the built-in Async Signal type are shown below. Value to Match - Depending on the specific field type, 1 or more values can be specified for the match. Some fields do not have any additional values, so the search is a 'match' if the specified field is found (i.e. Parity Error above). Other fields may have several values within the field. Each value is referenced in the value editors with a preceding "%". As shown above, the 'DATA' field has 1 value, identified by "%1". Below is an example of the editor for the DATA field. The value to search for can be specified in Decimal, HEX, Binary or ASCII format as demonstrated below. Decimal - 77 HEX - 0x4D Binary - b1001101 ASCII - 'M' An example of a Field with more than 1 value (from the SPI signal type): Buttons - The three buttons on the bottom left of a field term are for deleting the current term (-), adding a new term below the current one (+) or creating and adding a duplicate of the current term (Copy). © 2017 TechTools Navigating and Analyzing the Data 186 Frame Mode Frame mode uses the same logic as field mode but adds an additional layer of grouping if frame information is present in the data. The number of frame terms is not limited and each frame is labeled numerically, starting with "1". Skip and Skip Count - The Skip and Skip Count parameters apply to Frames (a group of fields) instead of fields. The Field match sequence within each frame is limited to the fields bounded by framing data of the signal type. We do not limit the number of Field terms or skips within a frame. However, If you specify a sequence that involves a a greater number of fields than the number of fields available in the framed data, the search will fail. Buttons - In frames, the Delete, Add and copy buttons are located at the upper right corner of the frame term and have the same functions as those described for fields, but apply to the frame. If you copy a frame, the new frame will be identical to the one copied, including all field terms and their individual settings. © 2017 TechTools 187 DigiView User's Guide 5.6.1.1.2 Pattern Searches The Pattern search type is used for Boolean or Bus signal types (see: Define Searches Boolean Signals 40 , Bus Signals 42 ). 181 , This search type can be used to find a value of one signal or a pattern of values in multiple signals, that lasts for a specified time period. You can see in the "Fetch from 094D" search displayed above, that it will search for a pattern consisting of values from three signals (ALE, PSEN, AD14-0) that lasts for a duration of more than 50 nanoseconds. If this condition is found in the captured data, the specified marker will be set to the time when the match occurs. In the above example, this would be 50ns after the matching pattern begins. Match Duration: Determines whether to skip all packets until a match is found, or to skip the number of packets specified in "Skip Count" and then see if the next packet is a match. Duration Units The duration qualifiers can be in ns,us,ms or sec and can use REAL numbers (1.23 us). Signals: Select a signal from this list to "add" them to the search. Signals added to the search are displayed below the signal selection box where the pattern to match can be edited. Match Pattern Format The match patterns can be specified in decimal, hex or binary. To indicate a HEX specification, precede the number with '0x'. To indicate BINARY, precede the number with 'b'. Binary specifications allow '0','1' and 'X' (don't care) characters. HEX specifications allow HEX digits (0-1,A-F) or 'X' for a nibble of don't care bits. Decimal specifications must use only 0-9. © 2017 TechTools Navigating and Analyzing the Data 5.6.2 188 Searching Search Button Left clicking on a search button searches back in time (previous match.) Right clicking on a search button searches forward in time (next match.) See 'Define Searches' 181 for details on creating searches. Invoking Searches There are several methods of invoking a search. Each presents a slightly different way of selecting the search and the target window, but they all perform the search in the same manner. If the search is configured to search 'from center time', then the search starts from the center time of the FOCUSED window (possibly the last match). Otherwise the search starts from the search's marker position (possibly the last match). In either case, the marker is positioned at the location of the search match and then the FOCUSED window is centered on the marker. If the window is part of a link group, then the entire link group is centered as well (see: Link Groups 180 ). The center time of the FOCUSED window does not change if the search fails. Regardless of how the search is invoked, we actually always run the DEFAULT search on the FOCUSED windowed. We simply CHANGE the DEFAULT search or the FOCUSED window before running the search in some cases. This creates a very consistent environment where you can jump from one search button to another without surprises. The last invoked search is always the current DEFAULT search and the window under the mouse is always the currently FOCUSED window. Local Search Each Data Table, List and Waveform window has a local search button. When you click on a window's local search button, that window becomes the FOCUSED window and then the search is applied to it as usual (using this newly FOCUSED window). Search Manger Searches When you click on a search button in the search manager, the DEFAULT search is changed to that button's search and then the search is performed as usual (using this new DEFAULT search). However, the search will be performed on the Waveform View of the currently focused Link Group. (see: Search Manager 188 ) 5.6.3 Search Manager Window The search manager window shows a list of all defined searches (see: Define Searches 181 ). It also provides an easy method of executing or editing any of the searches. This is particularly useful if you need to do a series of searches involving different search types. To open the search manager, select the Open Search Manager button (highlighted above) from the main toolbar. Only one search manager can be created. If it is already open, it will focus and appear in front of any other windows. The Search manager can be docked anywhere if desired. However, since it always displays a list of already defined searches, it can be closed and opened as needed without losing any data. © 2017 TechTools 189 DigiView User's Guide Use the mouse to see details without having to edit the search Search - Each entry in the list includes a Search button in the left column. Left-click or Right-click on the Search button to perform that search as described in the 'Searching 188 ' section. Edit Search - Each entry in the list includes an Edit button in the second column. Click on the Edit button to edit the parameters of a defined search. Set as the Active Search - Click on the search name itself or use either of its buttons in the search manager and the search will automatically become the Active (or Global) search. Any search button in the program will perform the Active search. New - Click the New button (highlighted above) to select a signal and create a new search. Copy - When the copy button (highlighted above) is clicked, a new search is created identical to the current search. The new search is added to the Search Manager, renamed by adding a sequential number to the search name, automatically selected as the Global Search and is opened for editing. This is a very convenient feature if you want to add another search with similar criteria while retaining the original search or you need similar criteria for more than one signal. Delete - Click the Delete button (highlighted above) to delete the selected search. © 2017 TechTools Navigating and Analyzing the Data 5.6.4 190 Auto Search Windows Auto Searches expand the normal search to a linked list of positions in the captured data that meet the search criteria. Click on any line of the resulting list to scroll the matching data into view. Auto Searches also have the ability to halt the analyzer, determine which captures to preserve and which captures to discard based on the search result. To create a new Auto Search window, select the Open Feature Window button (highlighted above) from the main toolbar, then select Auto Search. Main Auto Search Features 1. Automatically runs selected searches after each capture or capture history 133 load. 2. User settings allow for halting, saving or skip-saving the capture based on match counts. 3. Presents a list of matches and the count. 4. Clicking on a search match will scroll any Waveform View or Tabular view of the same Link Group to the time marked by the search match. © 2017 TechTools 191 DigiView User's Guide Save, No Save and Halt Options - Click the Options/Settings Button to set the Auto Search Options. Use Global Save Settings Select this option to let the default save settings determine when to save the capture. When selected, the Save Qualifier section is disabled. (see Acquisition Options 110 ) Save if Condition is True Select this option to have the capture saved if the Save Qualifier equates to true. If the Global setting is already set to "Save" then this selection will have no effect. (see Acquisition Options 110 ) Do Not Save if condition is true Select this option to mark the capture for "Discard" if the Save Qualifier equates to true. If the Global setting is already set to "Do Not Save" then this selection will have no effect. (see Acquisition Options 110 ) Halt Analyzer if Condition is True Select this option to stop the analyzer from continuing to capture if the Halt Qualifier equates to true. © 2017 TechTools Navigating and Analyzing the Data 5.6.5 192 Capture History Searching The entire Capture History 133 can be searched forward and backward to find a capture with a search result that matches the halt qualifier specified. Selected Search Any search that you have defined for this project will be listed in the search selection drop-down box. Choose the search you want to use from this selection (see Searches 181 ,Searching 188 ). Halt Qualifier Select the Logic (>, Export->UnDecoded Capture) and provides a means of exporting the raw data of all defined signals. The available options let you chose which signals to export, time format, numerical format, field separator, inclusion of line numbers, inclusion of a timestamp and whether to use compression. (see: Exporting 196 ) The Exported Data Example area will be updated automatically to reflect any changes in export options. Timestamp If the "Include Time Stamp" option is selected, the time field will be formatted as the absolute time or (if set to Delta) as the time since the previous sample (or the last known sample after the starting time). If the "Data Compression" option is set to OFF and this option is set to Delta, then the time field will show the sample rate. Numerical Format This option determines the formatting for each signal that uses more than one channel (Boolean © 2017 TechTools 199 DigiView User's Guide signals will always be formatted as a '1' or '0'). This option will display the format setting of a signal when a signal is selected. To change the format for a signal, first select the signal in the Signal Selection area. If changes are allowed for the selected signal, then the format options will "enable". Select the desired option. Field Separator Chose the character for separating each item on a line of exported data. Include Line Numbers Select this option to include a consecutive line number at the beginning of each line. Include Time Stamp Select this option to include the time of each exported sample. Signal Selection Check each signal to include in the export. The order of export is determined by the order in which each signal is checked. To have the export order match the listed order, use the Clear All button to clear all selections, then use the Select All button to select all the signals in the order shown. To move a signal to the end of the export line, uncheck and then recheck the signal. When a signal is highlighted with the mouse, its export format setting will be shown in the Numerical Format option. This option can be changed by selecting the desired format (excluding Boolean signals). Data Compression Setting this option to ON will greatly reduce the size of the export file. With compression on, the redundant or "dead" periods of data will be excluded and only changes in the data will be exported. If this option is set to OFF, then no data will be eliminated and all samples at the maximum resolution will be exported. This could lead to very long exports with sizes up in the Terabyte range. Clear All Button Use this button to "uncheck" all signals in the Signal Selection Area. Unchecked signals will be excluded from the export. Select All Button Use this button to "check" all signals in the Signal Selection Area. All checked signals will be included in the export. Exported Data Example This area provides an instant "preview" of the data to export and is updated when any option or signal selection is changed. © 2017 TechTools Exporting 6.2 200 Exporting from List Windows This export method can be selected from the Main menu (Menu->Export->Table/Decoded List) or directly from a Tabular View's menu. List Exports export the decoded data of higher level signals (such as I2C), and will have a slightly different set of options that are specific to each signal type. (see: Exporting 196 , Signal Types 35 , Tabular Views 176 ) The Exported Data Example area will be updated automatically to reflect any changes in export options. Numerical Format (Radix) This option determines the formatting for each signal that uses more than one channel (Boolean signals will always be formatted as a '1' or '0'). This option will display the format setting of the signal in the list view being exported. To change the format for exporting, select the desired option. Field Separator Chose the character for separating each item on a line of exported data. Field Mode Select this option to force each field to a new line when framing data is present. Uncheck this option to output a frame of fields per line. Include Field Names Select this option to include the Field name in the export. © 2017 TechTools 201 DigiView User's Guide Include Line Numbers Select this option to include the line number at the beginning of each line. Include Time Stamp Select this option to include the time of each exported sample. Exported Data Example This area provides an instant "preview" of the data to export and is updated when any option or signal format is changed. © 2017 TechTools Exporting 6.3 202 Exporting from Table Windows This export method can be selected from the Main menu (Menu->Export->Table/List-> choose a Table) or directly from a Table Window's menu. Table Exports provide all the same options as the "Export All" function, but will automatically include all columns of the table. This means you will not have to select which signals to export, plus all channels of any signals that are "expanded" will also be included in the export. This is the only export method that will export expanded channels. (see: Exporting 196 , Export All 198 , Table Windows 173 ) Tables display and export signals in their "raw" data format. If you need to export the decoded data of higher level signals (such as I2C), then the List Export should be used instead. (see: List Export 200 , I2C Signals 50 ) The Exported Data Example area will be updated automatically to reflect any changes in export options. Timestamp If the "Include Time Stamp" option is selected, the time field will be formatted as the absolute time or (if set to Delta) as the time since the previous sample (or the last known sample after the starting time). If the "Data Compression" option is set to OFF and this option is set to Delta, then the time field will show the sample rate. © 2017 TechTools 203 DigiView User's Guide Numerical Format This option determines the formatting for each signal that uses more than one channel (Boolean signals will always be formatted as a '1' or '0'). This option will display the format setting of a signal when a signal is selected. To change the format for a signal, first select the signal in the Signal Selection area. If changes are allowed for the selected signal, then the format options will "enable". Select the desired option. Field Separator Chose the character for separating each item on a line of exported data. Include Line Numbers Select this option to include a consecutive line number at the beginning of each line. Include Time Stamp Select this option to include the time of each exported sample. Signal Selection All Signals in the Table are automatically displayed in this area and "checked" for export. To exclude a signal from the export, cancel the export, remove the signal from the Table, then select export again. Optionally you could use the Export All function if you do not need to export the channels of "Expanded" signals. (see: Export All 198 ) When a signal is highlighted with the mouse, its export format setting will be shown in the Numerical Format option. This option can be changed by selecting the desired format (excluding Boolean signals). Data Compression Setting this option to ON will greatly reduce the size of the export file. With compression on, the redundant or "dead" periods of data will be excluded and only changes in the data will be exported. If this option is set to OFF, then no data will be eliminated and all samples at the maximum resolution will be exported. This could lead to very long exports with sizes up in the Terabyte range. Exported Data Example This area provides an instant "preview" of the data to export and is updated when any option or signal format is changed. © 2017 TechTools Printing and Saving Images Part VII 205 7 DigiView User's Guide Printing and Saving Images While analyzing the data, you may want to save a specific view to a graphic file or send it to a printer. Both of these functions can be done from DigiView's Print Preview window. To open the Print Preview window, select the "Print" or "Save Image" option from the menu of any window you want to print. To Print using the main menu select Main Menu-> Print and then select the window from the list. To Save an Image using the main menu select Main Menu-> Save Image and then select the window from the list. Both lists include a selection for the Main Window and any feature window you have added to the project. To print or save an image of just a waveform view, use the Waveform View's local menu. After selecting what you want to print and opening the Print Preview window, you can switch between printing and saving an image by clicking on the tabs at the top of the window. Most of the options are the same between the two methods of output with the differences being the output size, resolution and orientation. Print Example © 2017 TechTools Printing and Saving Images 206 Print Specific Options Output Device A pull down selection list of all available print devices. Use this option to select the Printer, Fax or PDF print driver. After making a selection, the Page Size information and the preview will update to match the properties of the print device. The size of the printable area (followed by the print resolution) is displayed in the lower left corner. To change the properties of the selected print device use the "Printer Options" button beside the selection list which will open the Print Setup window. Orientation Print devices allow you to change the orientation of the output switching between Landscape (horizontal) and Portrait (vertical). You can do this in the Print Setup window by selecting the "Printer Options" button or use the orientation buttons. If you change this setting in the Setup window the orientation buttons will change to match. Advanced options for the print device can be accessed by using the "Properties" button in the Print Setup window. For print output, the actual printed image will adjust to fit within the printable area and orientation of the Print Device and allows for spacing needed by the border, header and comments if selected. Send to Printer Press this button to send the preview to the print device. © 2017 TechTools 207 DigiView User's Guide Image Example Image Specific Options Orientation The orientation of the Image is fixed to its screen orientation and "Size by Content" is permanently selected. The content of the image remains fixed but the output is sized to include the border area, header and comments if selected. The final output size is displayed in pixels at the lower left corner of the window and followed by the resolution (pixels per inch). Save Image Press this button to save the preview as a JPEG image file. You can select the file name and destination or cancel the save using the Image selector window that appears. © 2017 TechTools Printing and Saving Images 208 General Preview Options Preview Size Adjusting the window size will automatically re-scale the preview unless the no-scale option is selected. Scale to Height and Width - The preview is scaled to completely fit in the window so no scroll bars are needed. Scale to Width - The preview is scaled to fit the width of the window. A vertical scrollbar will appear if the preview height is taller the the window display area. No Scale (actual size) - The preview is not scaled and the preview is displayed at 100%. For print output this could be very large depending on the properties of the selected print device. The vertical and horizontal scrollbars will appear if needed. © 2017 TechTools 209 DigiView User's Guide Items to Include Header - When selected a Header space is included at the top of the output with the Analyzer Model printed on the left. If no other header options are selected, the rest of the area will remain blank. Optional items to include in the header: Print Detail - Select this option to include the Print Date and Time in the header. Capture Detail - Select this option to include The Capture Date and Time and the Capture ID number in the header. Project Detail - Select this option to include the project file name in the header. The additional "Project Detail" option controls whether the project path is also included or if a custom caption is included. Comments - When selected the Comment Options and Editor will be visible and included in the output. Project Detail Option If you select Use "Project Location", the project path will be used for the project detail beneath the project name. To enter custom text for the detail option just uncheck the "Project Location" option and type your text in the edit box just below it. Your custom text (or blank text if desired) will appear in the header beneath the project's file name. If you re-select this option the path will appear in the edit box and the custom text is remembered. if you uncheck this option later, the custom text is restored. © 2017 TechTools Printing and Saving Images 210 Project Comment Options and Editor The comment editor and options will be visible if you selected to include comments in the include section. The default comment options (shown above) are set so you can type as many lines as you want and not worry about line spacing or formatting where each line ends. These are "Word Wrap Output" enabled and Reserve space set to "By Line Count". With these two options set, the output adjusts to accommodate the entire text in the output. For images the height grows by the needed (or selected) space. On print output (which has a fixed printable area) the content is reduced by the amount of space for the comment. If you only want to reserve a specific portion of the output for comments (even without typing a comment) set the "Reserve Space" option to the desired percentage (10% to 50%). Subject - Type anything here and it will appear above the comment section in the output. The example above has "Glitch Details" entered instead of the default of "Comments". © 2017 TechTools 211 DigiView User's Guide Asynchronous 37 Asynchronous Signal 47 Authenticode 3 Auto Run 131 Auto Run Pause 110 Auto Save 20, 127 Auto Save/Restore 127 Auto Search 110, 190 Auto-Snap 151 Auto-Snap & Bring to Center Index -%%1 183 -@@ 127, 138, 146, 151 -22's Compliment 66 -33D Satin Gradient 113 -AAcquisition Options 33, 110 Active Marker 146, 151 Active Marker Position 146 Active Plot Measurements 166 Active Search 188 Add Gutter Space for measurements 127 Add Marker Time/Delta 171 Add New Signal 7 Adding Signals 35 Advanced Trigger 69, 73 Alignment Management 18 Alt Key + Number Key 159 Always Show on Startup 22 Always Trigger 69 always use this template 28 Analyzer Control and Status Message 7 Analyzer Models and OS Detection Count 26 Analyzer Options 33, 96 Analyzer Selection 23 Analyzer State 132 Arbitrary Snap 138 Arbitrary Snap to center 138 Armed 132 Associated Channels 35 151 -BBar Graph 133 baud rate 47 Bird’s-Eye scrollbar 149 bookmark 138 Bookmark Button 133 Boolean 37 Boolean Measurements 166 Boolean Signal 40 Bottom Tool Bar 5, 9 bounce noise 99 Bring to Center 138, 151 Browse Button 133 Buffer Settings 96, 97 Buffer Size 97 Bus 37 Bus Measurements 166 Bus plotting 42 Bus Signal 42 Bus Signal Format 138 bus-powered 4 BUTTONS 14 By Line Count 205 -CCable Connector Pinout 33 CAN 2.0B 44 CAN BUS 37 CAN BUS Signal 44 Cancel a connection 73 capture buffer 97, 133 Capture Detail 205 Capture History Buttons and Selection Bar Capture History ID 135 9 © 2017 TechTools Index Capture History Menu 133 Capture History Options 110 Capture History Search 133, 181 Capture History Searching 192 Capture Status Window 131 Captured Samples 135 Capturing Data 7, 131 Center indicator 151 Center Line 127 Center Time 146 center time reference 138 Center Time Reference location 127 channel indicator 99 Channel Selection 40, 42, 47, 50, 56, 59 CHANNELS 35 circular queue 97 Clear 138, 151 Clear All Button 198 clear all markers 151 Clear Data Before Run 127 Click and drag to marquee 150 Click to Bring @ to Edge 127 Click-n-Drag 151 CLK 56, 59 Clock (SCL) 50 Clock Channel 62 Clock Edge 56, 59 Clone Settings 26 Cloning a Project 9, 26 Cloning a Project for a New Analyzer 20 Close Button 196 Collapse 138 Color Preview 125 Color Selection 62 Color Selection & Examples 40, 42, 47, 50, 56, 59 color sequence 35 Color Themes 33, 113 color-coded 33 Comments 205 communication errors 4 Communication Settings 47, 59 compression 198 Configuration options 33 Connecting Data Lines 33 Connecting the Data Lines 33 Control Key 10, 18, 143, 149, 151, 159, 163 Control+L Key 166 Controller Area Network protocol 44 © 2017 TechTools Copy Search 188 Copy Theme to Custom 123 Create Project 22 Create Signal 35 Creating a New Project 23 Creating a Template 28 cross-linked 180 CTRL Key 163 Ctrl Key + Click 151 Ctrl Key + Click-n-Drag 151 CTRL Key + L 159 Ctrl Key + Mouse Move 151 CTRL Key + Number Key 159 Ctrl Key + Right-Click 151 Current Buffer 97 Cursor Keys 176 Custom Baud 47 Custom Color Themes 113 Custom Theme 123 -DData 56, 59 Data (SDA) 50 Data and Time of Capture 135 Data Compression 198, 202 Data Lines 33 Data Selections 66 Debug Plug-ins 127 Decode 50 Decoder/Parsed Measurements 166 Default Template 28 Define Searches 181 Defining Signals and Triggers 33, 35 defining trigger conditions 33 Delete a connection 73 Delete a Signal 7 Delete History 110 Delete Signal 35 Delete This Capture 133 DELTA mode 173 De-Tabbing a window 12 Disable Signal Channels 47 Display Behavior 110 Display Gain 66 Division Grid Snapping 163 Do Not Change Position 110 Do Not Save capture History 110 212 213 DigiView User's Guide Do Not Save if condition is true 190 docable windows 9 Dock Sites 10 Docking a Window 10 Docking Override 10 Double-Click 22, 171 Drag & drop 138 Drag Scrolling 143 Drag to place 151 dragging a marker 151 Driver Failed 3 Driver Framework 3 Drop & Bring to Center 151 Drop Marker 138 Duration Units 181, 187 Dusk 116 Dynamic Measurement Window 166 -EEdge Match 80 Edge Snap 138 Edge Snap to center 138 Edit 143 Edit Search 188 Edit Signal 138 Edit Signal Properties 35, 138, 173, 176 Editing Simple Triggers 71 Enable 56, 59 Enable Capture History on New Projects 127 Enable Signal Channels 40, 42, 47, 50, 56, 59 Enable State 56, 59 Enabled Status/Toggle 35 End Key 159 Enforce Prefill 97 Enter Key 22 Environment options 33, 127 Equal Match 83 ESC Key 163 Escape Key 22, 35, 159, 171 Estimated Free Disk Space 196 Example Project 22 Expand 138, 143 Expand order 138, 173 expanded channels 202 Export 173, 176 Export All 202 Export Button 196 export expanded channels 202 export methods 196 export the entire Capture History 196 Export To 196 Export+ 196 Export++ 196 Exported Data Example 198, 200, 202 Exporting 196 Exporting All Signal Data 198 Exporting from List Windows 200 Exporting from Table Windows 202 external power supply 4 -FField Idle Timeout 59, 62 Field Length 59, 62 Field Mode 183 Field Separator 198, 200, 202 Field SYNC 59 Files in History 135 Filter Width 109 Flamingo 116 FLAT BUTTONS 14 Flat Tile 113 Floating a tabbed window 12 Floating a Window 10 Focus Example 5 Font properties 5 Frame Field Count 161 Frame Idle Timeout 47, 56, 59, 62 Frame Length 47, 59, 62 Frame Mode 183 Frame on 9bit Address flag 47 Frame on SS 62 Frame Period 161 Frame SYNC 56, 59 Frame SYNC Channel 56 Free Scroll 138 Free Scrolling 143 Frequency 161 Full Buffer 132 -GGlitch Filter Global Flag 47, 109 151 © 2017 TechTools Index Global Marker menu 151 Global Search 181 Gold 116 Goto 141 GOTO marker 151, 159 Graphical Configuration 73 Greater Than Match 87 Greater Than or Equal Match Green 116 ground 33 Grouping 66 Gutter Space 127 89 Include Status 200 Include Time Stamp 198, 200, 202 independent scrolling 141 Installing the Software 3 Installing the USB Drivers 3 Instant Measurements 161 Inter-IC Sound bus protocol 54 interpolation 66 Invert CLK/Data 56, 59 Invert SDA/CLK 50 Invert Signal Value 40, 42, 47 Invoking Searches 188 -H- -J- Halt Analyzer 190 Halt Analyzer if Condition is True 190 Halt Options 190 Halt Qualifier 190, 192 Halt when limitation reached 110 Halted 132 Hardware Status 9, 132 Hide Marker Delta when off screen 127 Hide Title Bar 127 High Duty 161 High Speed 4 highest voltage 99 History Browsing 133 history buffer 133 History Menu 133 History Monitor 110 History Searching 133 Home Key 159 Horizontal Lines 127 Hot Keys 159 Hot-Keys 138 JPEG 205 Jump 138 Jump to Marker 151 Jump to Marker Pair 171 Jump to markers 176 Jump to Measurement Result -II2C 37 I2C Signal 50, 176 I2S 37 I2S Signal 54 Include I/O Direction 200 Include Line Numbers 198, 202 Include Packet Type 200 Include Start Position 192 © 2017 TechTools -KKey Alt 159 Key [ 159 Key ] 159 Key < 159 Key > 159 Key 1 159 Key 2 159 Key 3 159 Key 4 159 Key 5 159 Key 6 159 Key A 159 Key C 159 Key Control 159 Key Control+L 166 Key End 159 Key Escape 159 Key Home 159 Key I 159 Key O 159 Key P 159 Key R 159 Key S 159 166 214 215 DigiView User's Guide Key Shift 159 Key Space Bar Key T 159 Key Z 159 159 -LLeft/Right Click Example 5 Left-Click 151 Less Than Match 91 Less Than or Equal Match 93 Lime 116 Limit by Disk Free 110 Limit by Number 110 Limit by Size 110 line numbers 198 Link 138 Link and Unlink Waveforms 7 Link Group 173 Link Group indicator 141, 180 Link Group indicators 180 Link groups 138, 180 Linking Views into Time-Relative Groups 138 List Exports 200 List View 176 Load Last Project 22 Local Menus 5 Local Search 188 Local Window Tool Bars 5 Lock with Complement 151 Lock/Unlock Dynamic Measurements 166 Locking the Span & Signal 166 Low Duty 161 lowest voltage 99 LSB first 59 -MMain Menu 5, 7 Managing Templates 28 Manual Connections 73 Mark the match point 181 Marker brightness 113 Marker Color Level 113 marker color sets 113 Marker Column 151 Marker Delta 127 Marker Flag 151 Marker Options 113 Marker Selection 113 Marker Tack 151 Marker Text Level 113 Marker Time/Delta 171 Markers 151 Marque to Zoom 138 Marquee Zoom 138, 150 Match 183 match circuits 77 Match Duration 187 Match found Example 192 Match Pattern Format 181, 187 Match Point 183 match sequence 183 Match Type 77 Match Types 77 Maximum Disk Size for Capture History Maximum Number of Captures to keep Measurement 161 Measurements 138, 166 Menus 5 Middle Mouse Button 163 Middle Mouse Button Example 5 Minimum Disk Size 110 MISO Channel 62 Monitor signals 131 MOSI Channel 62 Moss 116 Mouse Basics 5 Mouse Button 143 Mouse Functions 143 Mouse Move 151 Mouse Position 146 Mouse Wheel 176 MSB First 47 Multi-channel signals 173 multiple channels 42 multiple monitors 9 110 110 -NNavigate 143 Navigating and Analyzing the Data 138 Navigation Keys 159 Navigation, Markers & Buttons 138 Neon Blue 116 © 2017 TechTools Index Neon Green 116 Never Trigger 69 New color 125 New List 176 New Project 22, 23 New Search Manager 188 New Table 173 Next View 141 no decoding 99 Noise Filter 50 Not Equal Match 85 Notify when Save Needed 127 Number Keys 159 Numerical Format 198, 200, 202 -OOld color 125 Open a Feature Window 7 Open File 22 Orientation 205 Overwrite when limitation reached -Ppacket values 181 Page 138 pairs of markers 171 Parity 47 Parity/9bit Address flag 47 Partial(P) Fields 62 PAT 132 Pattern Match 79 pattern matches 181 Pattern Searches 183, 187 Peach 116 Period 161 PFX 132 PH 132 physical channels 33 physical layout of the cable 33 physical logic channels 37 PINOUT 33 Place markers 143 Play Event Sounds 127 Play Trigger Sound 127 Plot and Skip sequences 66 © 2017 TechTools 110 Plot configuration example 66 Plot Example 66 Plot Handle 143 Plot Output 37, 42, 44 Plot Sequence Editor 66 Plug-ins 127 poor decoding 99 positioning of windows 18 Post Filling 132 Post-Filling 132 post-trigger data 97 Powered 132 powered hub 4, 26 Pre Filling 132 Prefill 97 pre-trigger 97 preview 131, 198 Preview Signal Changes while editing 127 Preview Size 205 Previous View 141 Previous/Next View 150 Print 138, 173, 176 Print Detail 205 Print Preview 205 Print Setup 205 Printing 205 Progress indicator 196 Project Configuration Options 33 Project Detail 205 Project Selections 7, 20, 22, 127 Project Settings 7 Project's assigned analyzer configuration 9 -QQualifier 56 Quick Measurements 163 Quick Select Flags 151 Quick Select Mouse and Key Functions -RRadix 143 Recent Projects 22 Reference Line for @ Re-Frame on BREAK Refresh OS Detection 127 47 26 151 216 217 DigiView User's Guide Required Disk Space 196 Reserve Space 205 Reset Colors 40, 42, 47, 50, 56, 59 Reset Row Height 127 Reset Row Heights 127 Reset Signal Colors 113 resistor color-code order 33 resolution 173 Restart Plot Sequence 66 Restore Last File on Startup 127 Restore last Project 20 RGB values 125 Right-Click 151 Run 131 -SSample Mode 26 sample rate 173 Save as JPEG 138, 173, 176 Save capture History 110 Save if Condition is True 190 Save Image 205 Save Project 7 Save Qualifier 190 Save This Capture 110, 133 Save, No Save and Halt Options 190 Saves/Captures this run 135 Saving a Project 20 Saving the Project with a new name or to a different directory 20 SCL 50 screen area 149 Scroll 138 Scroll by 1 141 Scroll by 5 141 Scroll Start/End 141 Scroll To 141 Scroll to @ on Snap 151 Scroll to Marker 110 Scroll to Trigger 110 Scroll-n-View 151 SDA 50 Search 141 Search Button 188 Search Description 181 Search History Button 133 Search Manager 7, 181, 188 Search Manager Windows 188 Search Manger Searches 188 Search Marker 181 Search Name 181 search selection 181 Search Types 183 Searches 181 Searching 188 Searching Capture History 192 Searching the Data 138 secondary windows 9 Select a project template 23 Select All Button 198 Select Data Slice 66 Select From Templates 23, 28 Select from Templates on New Projects 127 Selected Colors 113 Selecting a Custom Color from the RGB swatches 125 Selecting an existing Theme color 125 Selecting from the Grayscale range 125 Selecting Measurements 166 Selections on Startup 127 Send to Printer 205 sequence specifiers 66 Sequencer 95 sequencer counter 95 Sequential Field search 181 Sequential Frame search 181 Sequential search 183 Sequential Searches 183 serial packets 47 serial protocol 50 Set 138 SET marker 159 Setting a Sequencer Counter 95 Setting the Match Type 77 share with a colleague 20 Shift Key 159 Show Field Idles 47, 56 Show Field Names 176 Show Frame Idles 47, 56 Show Frames 176 Show Getting Started Slides 127 Show Projects on Startup 127 Show Selections on Startup 127 Show Time Column 176 Sign & Magnitude 66 © 2017 TechTools Index Signal 37 Signal Colors and Type 35 Signal Definitions 35 Signal Edge Snapping 163 Signal Editor Preview 37 Signal Editors 37 Signal Name 35, 40, 42, 47, 50, 56, 59, 62 Signal Properties 138 Signal Radix 143 Signal Row Order 138 Signal Selection 198, 202 Signal Types 37 Signal Value and Marker Snap Column 146 Signals 35 Silver 116 Simple Trigger 69, 71 Simple Trigger Symbols 71 Single or Split Waveform View 7 Skip 183 Skip and Skip Count 183 Skip Bits 59, 62 Skip Count 183 Slate 116 Snap 138 Snap and Value Columns 146 snap indicator 151 SNAP LEFT 151 Snap Marker buttons 151 Snap Markers 138 SNAP NEAREST 151 SNAP RIGHT 151 Snap Signal 138 Snap Signal Column 146, 151 snap the next transition into view 146 snap the previous transition into view 146 Snap to Boolean Cycle 127 Snap to Frames 127 Snapping 151 Space Bar 143 SPI 37 SPI Signal 62 Split 151 Split Marker 151 SS Channel 62 Stable Match 81 Standard-Mode I2C bus 50 Start a connection 73 Starting with a new Project 20 © 2017 TechTools State 37 state clock 56 State Signal 56 Status LEDs 132 Status Window 135 Steel Blue 116 Stop 131 Stop Button 196 Stopping the Capture 131 storage devices 196 Stream Buffer Goal 97 STRETCH to FIT 14 Subject 205 SuperSpeed 4 Suppress Glitches 109 Sync (skip transitions) 47 Sync Start of Packet 47, 59 Synchronized Scrolling 141 Synchronous 37 Synchronous Scrolling 138, 180 Synchronous Signal 59 -TTab Orientation 14 Tab Rows 14 Tab Size 14 Tab Style 14 Tab Window Options 12, 14 Tabbing windows 12 Table Exports 202 Table View Windows 173 Tabular Views 138, 176 Take Measurements 143 Templates 23, 28 Thank You 2 Theme Examples 116 Theme Selection 113 Theme Selection list 123 Threshold settings 99 threshold value 99 Time Column 173, 176 Time Display 173, 176 time divisions 149 time format 173, 176, 198 Time per Division 143 Time Range 196 Time Reference 146 218 219 DigiView User's Guide Time Source selection 146 Time Span 166 Time Synchronized 173, 176 timeout period 131 Time-Relative Columns 138 Time-Relative Groups 138 Timestamp 198, 202 Toggle Frames 176 toggle Instant Measurements 141, 161 Toggle Names 176 Toggle Time 176 Tool Bar 5 Tool Bar visibility 5 Toolbar Buttons 141 Top Tool Bar 5, 7 Total Timespan 135 Transferring 132 Transition voltage 99 Transitions 97 Trigger 131 Trigger condition 131 Trigger Configuration 73 trigger event 97 Trigger Formula 73 Trigger Match Types 77 Trigger Mode 69 Trigger Position 146 Trigger Threshold 99 Trigger Voltage 99 Triggered 132 Triggers 35, 69 Truncated fields 50 Turquoise 116 -VValue to Match 183 Vertical Lines 127 Vertical Position 66 Viewing the Data as Graphical Waveforms 138 Viewing the Data in Time-Relative Columns 138 Violet 116 voltage range 99 Voltage Threshold 99 Voltage Thresholds 96 -Wwaiting for Trigger 132 Wave Form Views 127 Waveform Association 151 Waveform Menu 138, 143 Waveform Menus 138 Waveform Signal Menu 138 Waveform View 141 Waveform Views 138 Where to begin Searching 181 Window Appearance 113 Window Arrangement 9 Window Background 113 Word Wrap Output 205 -Yyou are here 149 -U- -Z- Undock 12 Undock a Window 10 Unsigned 66 USB cable 4 USB connection 4 Use Global Save Settings 190 Use Project Location 205 Use Template Acquisition Settings 127 Using Link Groups 180 Using Markers 138, 151 Using the Color Selector 125 Using the same channels in multiple definitions Zero Offset 66 zoom 138, 143, 159 Zoom and Scroll 171 Zoom History 150 Zoom In 141 Zoom In Max 141 Zoom Max 138 Zoom Min 138 Zoom Out 141 Zoom Out Max 141 Zoom to Split Pair 151 37 © 2017 TechTools (972) 272-9392, www.tech-tools.com