brakedancer Code
Status: Beta
Brought to you by:
bitwyze
brakedancer: This is an analog waveform viewer. Unique to most viewers, brakedancer allows you to overlay any signals by specifying the signals y origin point. BUILDING FROM SOURCE: You need 'gcc' and 'gtk+' development files. Use 'make install' USING: From your source directory, run 'brakedancer bd-test.csv'. Windows users: It is easiest to create a shortcut and drag-n-drop a *.csv file onto the shortcut. Opening brakedancer.exe by itself without an input file will simply close right away. ZOOMING: press 'e' or 'q' to zoom in/out. scroll your mouse wheel to zoom in/out. Shift+Click+Drag (from left to right) to zoom in to selected window. Shift+Click+Drag (from right to left) to zoom out to previous view. Shift+RightClick+Drag (from left to right) to zoom x only. Shift+RightClick+Drag (from right to left) to zoom out to previous view. ALTERNATE ZOOM IN: press [space bar] to start zoom selection window move mouse to the RIGHT press [space bar] to finish zoom selection and zoom in ALTERNATE ZOOM OUT: press [space bar] to start zoom out move mouse to the LEFT press [space bar] to zoom out ZOOM TO EXTENTS: press 'z' to zoom to the extents of the data. This is the same zoom level as when a file is first opened. PANNING: press 'w', 'a', 's', 'd' to pan. Think gaming. WheelClick+Drag to pan. Also, you can pan with 'h', 'j', 'k', 'l'. Think vim. SIGNAL NAME HINTS: press 'n' to toggle name hints. When hints are active, Click+Drag over a signal to see it's name TIME HINTS: press 't' to toggle time hint VALUE HINTS: press 'g' to toggle 'grab mode' on. select the signals of interest in the graph window. press 'g' to toggle 'grab mode' off. Click+Drag and see the value hints of the selected signals. press 'g' to toggle 'grab mode' on. select an area of the graph not containing a signal to de-select all signals. press 'g' to toggle 'grab mode' off. DATA FILES: brakedancer only works with CL, CSV, and VCD files. CSV NOTES: The first line of the files is assumed to be the signal names. The first column is assumed to be the x axis (usually time). VCD NOTES: Limited compliance to Verilog specification (mostly due to immature parser). CL NOTES: CL is a binary CAN format developed by the HLA Team at Eaton Corp. In order to decode it, you must have a CAN Database (dbc) file named "bd.dbc" in the default configuration file location (see below). CONFIGURATION FILE: This is also a CSV file. Play with it to change how/where/if signals are displayed (using Gnumeric or Excel). It is installed by default at GNU/Linux: $HOME/.brakedancer/bd-conf.csv Windows: C:\Documents and Settings\user\My Documents\_brakedancer\bd-conf.csv Press '1' to reload the configuration file from disk. This is helpful for trace layout/setup. Open the file you want with brakedancer. Open bd-conf.csv with your spreadsheet program. Tweak the configuration in bd-conf.csv. Save bd-conf.csv. Press '1' in brakedancer. Repeat.