ComProbe User Manual - Frontline Test Equipment
Contents
1. f fte com tl e Onuine Debug Communications Faster ComProbe Protocol Analysis System Preliminary Preliminary Preliminary Preliminary Preliminary Preliminary ComProbe User Manual Revision Date 12 29 2014 frontline Debug Communications Faster Copyright 2000 2015 Frontline Test Equipment Inc FTS Frontline Frontline Test System ComProbe Protocol Analysis System and ComProbe are registered trade marks of Frontline Test Equipment Inc The following are trademarks of Frontline Test Equipment Inc e FTS4BT e BPA 500 e BPA 600 The Bluetooth SIG Inc owns the Bluetooth word mark and logos and any use of such marks by Frontline is under license All other trademarks and registered trademarks are property of their respective owners frontline Debug Communications Faster Contents Purpose O 1 BNE O CUCU ON 1 Computer Minimum System Requirements 2 02 2 2 22 c cece eee eee cee cee cee cece cess 1 Getting Started 2 000 000 0000 0000000000000000 eee eee cece eee ee cece eeeeeeeeeeeeeee 2 Control Window Toolbar 0 0 0002 o cee eee eee ee cee eee eee eee cece eee eeeeeees 2 Opening Selecting Data Capture Method sseesseselllllllllslllns 3 Analyzing Data soe Eres ive dedo me EBD t dai UE E MU EE n E MM eee 5 Control Window A 5 ECADICI OE iA 6 FPPOLOCOP ADS eee E2. if you select RFCOMM you will see the messaging between the RECOMM M Master and the RRCOMM S Slave 13 frontline Debug Communications Faster Channel Signaling Length 0 Channel Signaling Length HFCOMM signaling channel created Figure 13 Protocol Messaging Note The Non Message Summary tab displays all the non message items in the data and the Ctrl Summary tab dis plays the signaling packets for all layers in one window in the order in which they are received The information in the colored boxes displays general information about the messaging When you position the mouse over the message description you will see an expanded tool tip Figure 14 14 frontline Debug Communications Faster q 3 mam E FEN TH B mma meg 13 le Maste dress code LMP max slot inaction ID Initiated by master ix Slots 0x05 slots Figure 14 Protocol Message Expanded Tooltip How Dol Navigate in the Dialog You can use the navigation arrows at the bottom and the right side of the dialog to move vertically and horizontally You can also click and hold within the dialog which brings up a directional arrow that you can use to move left right and up down Search The Message Sequence Chart has a Search function that makes it easy to find a specific type message within the lay ers You access this dialog by selecting the Search icon or F3 the Searc
3. uuoiiuuuusuuuussslsslllsllllllllsss s se eee ee eeee 25 Coexistence View Throughput Graph 0 0 2 22 c eee ce eee cee cee cece eee eee ceeeee 26 Display Synchronization 0 0 2 22 c cece cece eee cee cee eee eee cee ee cee cece eee eeeeeeeeeeeees 2 frontline Debug Communications Faster Duplicate Displays ssousuuuuuullllllllllllllllmllmslIRmIIIIlmllllmlLl2lmlllllllll21l2l 2f EOOKInall a ceases kieran meses sees a hve MERERI RIDE RPM LH LUNES 2f Navigating and Search the Data ssssuessselslllssssss ss eee eee eens 27 gll T 27 zl x D 28 3 30 0 1 About Display Filters 00 000000 ee ee cee eee eee ees 28 3 30 0 2 Quick Filtering on a Protocol Layer 0 0 022 2 ccc cece cece cece cece eee e cee eeee 29 Printing and Exporting 0 0 0 02 2 occ cc cece eee cee cee eee cee cee cece eee eee eeeceeees 30 Printing from the Frame Display HTML Export 0 00 0000022 e ee eee 30 Printing from the Event Display 0 0 0 0222 e cece cece ce eee cee cee eee e cece eee eeeeee 32 Frame Display Export 00 000202 c cece cece eee eee ee ee ee eee ee eee eee eee ees 34 Expor FIRE OUL 34 3 31 Technical Support LLSS
4. E A os ae aot nce wo A E A E E E A T DAAE XTACUON ceesre oree EE E E EEEE E EE EE 9 Message Sequence Chart l 00a000000000000000 0000000000000000 0000000000000000 eee eee e cece eeeeeeeeeees 12 How DolAccess The Chart eccesso sic ori eus cs eripe ORE drer Das dedosOPcbogcedoiMbo esee 13 Waa DOT SOE REOR aE TOE Ee ee 13 How Do I Navigate in the Dialog _ 0 02 22 e cece eee cence ce cee cee eee e eee eee eeees 15 Soro KO p BN 15 PER NS aac ese E E eee elses E E E EEE 18 Bluetooth Timeline oon odes tncteseacdenstecucdesegesascacetectend asceueaceckebucsveaetdsaccieseeesees 20 Bluetooth Timeline Display 2000202 e cece eee cece eee cee ee cece eee eee ceeeeeees 22 Bluetooth Legend 2 22 coc e cece ccc cee eee ee ee cee eee e eee cece cece eee aonni 22 Bluetooth Indicators qOT 22 Bluetooth Throughput Graph 0 2 22022 cece cece eee eee cee cee eee e eee eee eeeeeees 23 Bluetooth low energy Timeline 0 20 2 0 2 cece eee cece ene eee eee cee eee e cece eeeeeceeeeee 23 Coexistence View 22 0 2 cece c cece cece eee c cree cece cece re cececscececsccuecscecarccccesaccceeaccceescs 23 Coexistence View Timeline 0 000002 c cece cece eee eee eee eee ce ee m eee eee cee cece eee 24 Coexistence View Legend 022 22 c cece eee e eee cee cee eee e cece e eee e cece eee eeeeeeeeeees 25 Coexistence View Indicators
5. Summary Pane for every protocol found in the in the data You can click on these tabs to filter on the protocol Protocols are also arranged by technology groups When the same pro tocol appears in multiple technologies the data will be displayed in separate groups For example if there are Clas sic low energy and or 802 11 data they will be displayed within a Classic low energy and 802 11 group Clicking on a protocol tab within a group shows all packets for that protocol and technology The groups are arranged from top to bottom as General Classic low energy and 802 11 They are also color coded General Gray Classic Light Blue low energy Light Green and Wi Fi Orange If a protocol appears in multiple technologies then a tab for that protocol will appear in the specific technology group and in the General group Select the Unfiltered tab to display all protocols The Unfiltered tab is automatically selected when multiple pro tocols are being filtered in using other filtering methods There are several special tabs that appear in the Summary Pane when certain conditions are met These include e Bookmarks appear when a bookmark is first seen e Errors appear when an error is first seen Errors include decode errors failure of Verify methods DRF error bits and PDA complaints about decoders The Errors tab is displayed in red e Info appears when a frame containing an Information field is first seen e Ashown technology has the
6. The application will assign a file name and file type for each profile you select in Step 1 above The file type varies depending on the original profile A separate file for each profile will be created but only for those profiles with available data 8 Select a location for the file s 9 Click Save The Data Extraction Status and Audio Extraction Status dialogs appear Figure 10 When the process is com plete the dialogs display what files have been created and where they are located 11 frontline Debug Communications Faster are V e Danaea ae mari rb Toe mad eni ae oe Pip data neato racha Fig dado esa Po Hat Fia SD 1 eed heir neon Dach Sop dale or quc hn Fe dadas mikt Pip daba eutectic pies Fir euri andi er ade p a o a Penra Fee A E o COP dara Eur bes andina Me TTH dali Fons panini Figure 10 Data Audio Extraction Status Dialog If you selected Open Files s After Extraction the files open automatically If you did not select this option you can open a file by simply double clicking on the name 10 When you are finished select Close to close the dialogs Message Sequence Chart Note Message Sequence Chart does not apply to these ComProbe Devices SD The Message Sequence Chart MSC displays a concise overview of a Bluetooth connection highlighting the essen tial elements of the connection At a glance you can see the flow of the data including
7. To Hide When you select the checkbox for a protocol in the Protocols To Hide data for that protocol will not appear in the Decode Binary Radix and Character panes The frames con taining that type data will still appear in the Summary pane but not in the Decode Binary Radix and Character panes The box on the right is the Named Filters It contains filters that you create using the Named Filter and Set Condition dialogs When you select the check Mamed Filters box for the Name Filters a tab appears on the Summary Pane that displays Filter the frame containing the specific data identified in the filter The named Fil Filter ter tab remains on the Frame Display Summary Pane unless Filter2 Filter3 you hide it using the Hide Show Display Filters dialog ua 3E link supported With low energy the Configured BT Low energy devices and Role Slave Exclude NULLS and POLLs are default named filters Contiqured BT low energy dewic Ezclude NULLs and POLL Check the small box next to the name of each protocol you want to filter in hide or Named Filter to display Then click OK Printing and Exporting Printing from the Frame Display HTML Export The Frame Display Print dialog and the Frame Display HTML Export are very similar This topic discusses both dialogs Frame Display Print The Frame Display Print feature provides the user with the option to print the capture buffer or the current selec t
8. control data cap ture and access the other windows used to view data While there are a number of dialogs you can use to analyze the data let s look quickly at some of the options you have Frame Display Click the Frame Display icon on the Control window toolbar to open Frame Display Figure 4 monsADOOOQ e le LLL HM Bue DA neo umm Li PLI nime P aai aia Fu M 1 A TRIB EDGE SIRIEI ET LAN 5 uem mpm l i Lope quy ae i ja ijh voee IP HE dec Bs b yh Jab E maa a m LII IIT Jo ET um aa Fa TR 7 F C m E eS oe om fo x d E E LI r LI E id oe a a ud EEnEZ EGXX dd EUUEEZGExi 2 Ds Se MEX el OE ee ee ee baja E in cd a d kd RETE aie noe Die ae Eo CEFE i FELT 2D THET AI gNESXTXXE kuHuuENENHHHENNMNH N TEE T JUD TRIS rt TRE LEER MIRAI I EAA Lee BE EEE i Ae T Le Vee Lae TROP CD TuS LT F pape MIRARI I A LAN ee 2 AL Le Ve eA a ee eee ee EAA d mss Ie nie BELLE Cee Ie ea SA 22 29 RIS ia Lae 7EFIZSEN EMINE Ses Nees E Er BS mi WR WE FUTT a ee mm mua qu tg toam DITS NEE QUE Fuge ly Deme tad o Ins Meese ETEITSET FETTE B m BE I E HLIHNNESGSENSES x is 4 x FERRERS ER TEEPE ES Ges EU m a LE F m ES EX Li Li Figure 4 Frame Display Ti Koch EERE Rca Cc DOC OCOICRODOO DOCOCOIOO kaa EOE DOXCRWOIERBO DOMWOGICRMOWE frontline Debug Communications Faster Protocol Tabs The Frame Display adds a tab to the top of the
9. icon to the left of the first row A hidden technology has the icon to the right of the first row of the general tab group The new tabs disappear when the capture buffer is cleared during live capture or when decoders are reloaded even if one of the new tabs is currently selected They subsequently reappear as the corresponding events are detected Panes Frame display allows you to see an amazing amount of information from your protocol The Frame Display is divided into panes where each pane shows a different view of the data e The Summary pane Figure 5 stretches across the top of the display Each line in the Summary Pane rep resents one frame except when running in one of the USB HCI Sniffing modes where each line represents one transaction frontline Debug Communications Faster DESL U e a o EP ul Pkw Sx san Udi xum imm Rake IMF LAF ics Li oe LE Put a ee Chas Jupe pm ril is ar Ld aan me Lm amie Duda pasig a L m Lu ui gere Rhea 75 H maja gepe e e STENT 1 HEE id i n Ait ab T d Gur RANT 75 E moe iot SL 1 da LT US LJ ua E dM Ha ki e 75 H EN T uH Te 44 ae amp 1 H Pu il gee Cena 73 H ih ae BS 1 de dug a i H aM pub Met 1 i HHA PIi i 2 11 H ADM Pars lge E Ona T5 H BO OE 2 CLE BTE 1 HUIA tl at abs T d Ow REEL T i moem den idee 44 LT m m dM Oa le Ri ESCAS 73 H Dt hae STEA 1 ea ee T E amp Niet i H meae PIPE 144 rE a if N aM ipu Or ha T6 a mE biii aa a H F L
10. 00 31 O0 13 aa d ba 89 Ge OO 13 OZ ad OO Tb OZ OD 73 4E 6d 4 amp 3 IO 41 64 76 44 41 74 41 22 O2 7 32 581555 595 S sometshdvDataz s 2 SERS PAJARRE HIA Ob Figure 7 Data Format Binary Hexidecimal ASCII Frame Errors Frame numbers in red indicate an error in the frame Select the frame and look at the top of the Decode pane to determine the type of error Scrolling versus Static View Click the Lock Resume icon a to have the Summary pane scroll to always show the latest frames captured Click the Lock Resume icon again to stop the Summary pane from scrolling Protocol Tabs The frame display has a series of Protocol Tabs that allow you to filter on a specific protocol quickly and easily For more advanced filtering option please consult the online help Data Extraction You use Data Audio Extraction to pull out data from various decoded Bluetooth protocols Once the data are extracted you can save them into different file types such as text files graphic files email files mp3 files and more 1 You access this dialog by selecting Extract Data Audio from the View menu or by clicking on the icon from the toolbar 2 2 Choose a checkbox or checkboxes on the left side of the dialog to identify those profile s from which you want to extract data Figure 8 frontline Debug Communications Faster Data Audio Extraction Settings Select v Open File s After Extraction SCOeSCO Options Writ
11. As a programmer you probably can not count the number of times that some simple business need turned into a major development effort The worst is when you are working on a project and you just know there is a way to do some simple thing and it takes forever to discover how Many times all you need is a well directed hint something to get you started The hint might be the name of the API needed to do a thing or a simple example One of the best hints is a simple hello world program that provides a needed development shell That s what we want to do here provide that shell By itself the shell is not going to be very useful As a framework for your own modifications however it could save you a lot of time This documentis divided into 4 sections e Introduction e Run the Wizard e Have alook around e Debug your methods Introduction The Frontline ComProbe Protocol Analysis System is a protocol analysis system that may be used with a variety of different ComProbes hardware interfaces for capturing different technologies available from Frontline The ComProbe software automatically detects the ComProbe hardware plugged into your PC and configures itself according to the requirements of your sniffing hardware This document assumes that you have already loaded the device drivers and installed the ComProbe software If our assumption is correct you can move to the next section and we will get started If however you have not installed
12. DIO Srafing optional O Bluetooth SDIO 5j USB HCI H2 Sniffing optiona USB ComProbe Il luetooth HE o USB ComProbe Il USB E Vetual Snir GD FTS Side frontline Debug Communications Faster Figure 2 Select Data Capture Methods Expanded As we mentioned earlier in the Introduction in this guide we are going to select one of the most commonly used options and explain how to analyze the results If you need to know how to configure your hardware or configure data capture settings please refer to the Quick Start Guide for your ComProbe hardware 2 Select Combined Connection Classic low energy 3 Select Run Analyzing Data Control Window First of all we have the Control window which appears as the small rectangular window at the top of your screen Figure 3 frontline Debug Communications Faster ee A EQFL LomProbe Frotocal Analysis System BFA JUL CE mem File View Live Options Window Help E35 e c pL 34 JAIN s LZ E s Lr i Configuration No Device Mo Device Capture file C sers PubliclDacuments Frontline Test EquipmentlMy Capture Files Capture 2013 05 23_075637 cfa Capture Status Paused Capture to Single File 19e used Packets on h w 0 Utilization 0 Slave 0 Master Events 1 For Help Press FL Packet Decoder 0 pps 0 100 Figure 3 Control Window ComProbe BPA 500 analyzer organized around this window The Control window allows you to
13. ar format If you select All layers in the Detail Section the Data Bytes option becomes available 3 In the Detail Section choose to exclude No decode section the decode from the Detail pane in the Frame Display or include All Layers or Selected Layers Only If you choose to include selected layers then select click on and highlight the layers from the list box 4 Click on selected layers in the list to de select or click the Reset Selected Layers button to de select all selected layers Frame Display Print Prowde informaten to export dala from the currently selected Tiber tab Include Detal Section Summary Ce Ho decode section CO AM layers CO Selected layers only az 11 AMP S02 1D STP Ce Selection BO 1x A2DP AMP Manager ADD Frame Flange v Delete File Note Browne pant options may affect whether any gray background is parted See Help foe mio oc J cance neo Figure 3 3 Frame Display Print Dialog 5 Selectthe range of frames to include All or Selection in the Frame Range section of the Frame Display Print dialog Choosing All prints up to 1000 frames from the buffer Choosing Selection prints only the frames you select in the Frame Display window 6 Selecting the Delete File deletes the temporary html file that was used during printing 7 Click the OK button 31 frontline Debug Communications Faster Frame Display Print Preview The Frame Display Print Preview feature p
14. ded if that layer is encountered in a capture session There are also three special purpose filters that are treated as protocol filters e All Frames with Errors e All Frames with Bookmarks e All Special Information Nodes 28 frontline Debug Communications Faster Named Filters e Named filters test for anything other than simple single layer existence Named filters can be constructed that test for the existence of multiple layers field values in layers frame sizes etc as well as combinations of those things Named filters are persistent across sessions e Named filters are user defined User defined filters persist in a template file User defined filters can be deleted Quick Filters e Quick Filters are combinations of Protocol Filters and or Named Filters that are displayed on the Quick Filter tab e Quick Filters cannot be saved and do not persist across sessions e Quick Filters are created on the Quick Filter Dialog 3 30 0 2 Quick Filtering on a Protocol Layer On the Frame Display click the Quick Filtering icon Ww or select Quick Filtering from the Filter menu This opens a dialog that lists all the protocols discovered so far The protocols displayed change depending on the data received Quick Filtering and Hiding Protocols Protocols To Filter In Protocols To Hide M armed Filters All Frames with Errors All But the Last Layer All Frames With Information All Frames With Informati
15. drivers and software you need to stop here and follow the Quick Start Guide for the ComProbe hardware you re planning to use Computer Minimum System Requirements Frontline supports the following computer systems configurations frontline Debug Communications Faster e Operating System Windows 7 and 8 e USB Port USB 2 0 or USB 3 0 High Speed The ComProbe software must operate on a computer with the following minimum characteristics e Processor Core i5 processor at 2 7 GHz e RAM 4 GB e Free Hard Disk Space 20 GB Getting Started In this chapter we introduce you to the ComProbe hardware and show how to start the ComProbe analyzer soft ware and explain the basic software controls and features for conducting the protocol analysis Control Window Toolbar Toolbar icon displays vary according to operating mode and or data displayed Available icons appear in color while unavailable icon are not visible Grayed out icons are available for the ComProbe hardware and software con figuration in use but are not active until certain operating conditions occur All toolbar icons have corresponding menu bar items or options Table 3 1 Control Window Toolbar Icon List Icon Description Ea Open File Opens a capture file ya I O Settings Opens settings Start Capture Begins data capture to disk Stop Capture Available after data capture has started Click to stop data capture Data can be reviewed and saved but no
16. e Streams as C Two Mono Files One Stereo File Convert 4 Law and plaw to Linear PEM CYSD ts always converted Add Silence packets Extract Cancel Figure 8 Data Audio Extraction Dialog It is important to note that if there is no data for the profile s you select no extracted file is created If you want the file s to open automatically after they are extracted select the Open File s After Extraction checkbox Note This does not work for SCO eSCO Click on a radio button to write the streams as Two Mono Files or as One Stereo File This option applies for SCO eSCO only Select the checkbox if you want to convert A Law and p law to Linear PCM CVSD are always converted to Linear PCM It s probably a good idea to convert to Linear PCM since more media players accept this format Select the Add Silence packets to insert the silence packets dummy packets for the reserved empty slots into the extracted file If this option is not selected the audio packets are extracted without inserting the silence packets for the reserved empty slots This option is active for SCO eSCO only Select Extract A Save As dialog appears Figure 9 10 frontline Debug Communications Faster Saver C AFH Db AFH Change Cfa Frm LJ GP AFH Change Cfa Fiecert 9 afticfa Desktop File name CUTE My Network Fils types ace determined automaticaly from the extracted data Figure 9 Save As Dialog
17. es ec ye Ime pac i f mmm Core AF ee a E E E eee rix sonans e eect eee ian ze COTM TT I 1 I H mtm pes I A ped I mo pane i i accen man dct e hight mc me TTT ocn k accenosd NW m MEER zn I 3 FEMK X FTENX mRBDG Dex PESK mco nexp i ET OOA n Pe U z aR fmnR socunscy pem font pte a channel clemxi csezen pe p aa m pto m a e aa a A p i mE t am pam pac Sess pen ex GL ENT Eaire pez sx Figure 21 Bluetooth Timeline Dialog 21 frontline Debug Communications Faster Bluetooth Timeline Display The timeline Figure 22 displays multiple rows of time from left to right top to bottom just like a book Inform ation for the Master and Slave are shown on separate lines Each packet type is a different color The packet and corresponding color are shown on the legend agagaaay E P HIE P I i f Tore rss ae TE im B E E i a Figure 22 Bluetooth Timeline Display Bluetooth Legend This legend identifies the color coding found in the timeline Figure 23 Figure 23 Bluetooth Timeline Legend Bluetooth Indicators There are three throughput indicators Figure 24 22 frontline Debug Communications Faster Aces IP inpr Thi ihi Y Sapp Pince Th agg fii Al Dewees J E Myin 2 718 n 544 Shirai 258 30 ud dey P nre Tecate a dent MDescer 206 8 Made 208 028 pee Figure 24 Bluetooth Timeline Indica
18. ever is just that a mass of information There has to be ways to manage the information ComProbe software provides a number of different methods for making the data more accessible One of these methods is Find 27 frontline Debug Communications Faster Decode Pottem Tim GoTo Special Events Bookmark Seach fee imestamp Yeu Da Hour Minute Second 171000000 Secor Go to the hmectemp On ot before the specdhed ime On oi alter the specified ime Figure 3 1 Find Dialog Find as the name suggests is a comprehensive search function that allows users to search for strings or patterns in the data or in the frame decode You can search for errors control signal changes bookmarks special events time and more Once the information is located you can easily move to every instance of the Find results Filter 3 30 0 1 About Display Filters A display filter looks at frames that have already been captured It looks at every frame in the capture buffer and displays those that match the filter criteria Frames that do not match the filter criteria are not displayed Display fil ters allow a user to look at a subset of captured data without affecting the capture content There are three general classes of display filters e Protocol Filters e Named Filters e Quick Filter Protocol Filters Protocol filters test for the existence of a specific single layer The system creates a protocol filter for each decoder that is loa
19. h dialog appears Figure 15 15 frontline Debug Communications Faster Select layer and message Figure 15 Message Sequence Chart Search Dialog From this dialog you can search for specific protocol messages or search for the first error frame To use the dialog 1 Select one of the protocol tabs at the top of the dialog 2 Open the Search dialog using one of the three methods Note If you select All Layers in Step 1 the Protocol Layers drop down list is active If you select any of the other single protocols the Protocol Layers drop down is grayed out 3 Select a specific Protocol Message from the drop down list Figure 16 16 frontline Debug Communications elect layer and message Protocol Layer 2 rotocol Message DMS Figure 16 Protocol Drop Down List 4 4 Once you select the Protocol Message click OK The Search dialog disappears and the first search result is highlight in the Message Sequence Chart Figure 17 frontline Debug Communications Faster JP RFCOMM OBEX BIP FTP OBEX connection for the BIP Basic Imaging Image Push profile created Profile BIP Typezx btfimg capabilities Figure 17 Message Sequence Chart Search Result Highlighted If there is no instance of the search value you see the following dialog Figure 18 BELLI A The massaga Abork vas not Found Figure 18 Search No Instance Found Dialog Once yo
20. ion The maximum file size however that can be exported is 1000 frames When Print Preview is selected the output displays in a browser print preview window where the user can select from the standard print options The output file format is in html and uses the Microsoft Web Browser Control print options for background colors and images Print Background Colors Using Internet Explorer 1 Open the Tools menu on the browser menu bar 2 Select Internet Options menu entry 3 Click Advanced tab 4 Check Print background colors and images under the Printing section 5 Click the Apply button then click OK 30 frontline Debug Communications Faster Configure the Print File Range in the Frame Display Print Dialog Selecting more than one frame in the Frame Display window defaults the radio button in the Frame Display Print dialog to Selection and allows the user to choose the All radio button When only one frame is selected the All radio button in the Frame Display Print dialog is selected How to Print Frame Display Data 1 Select Print or Print Preview from the File menu on the Frame Display window to display the Frame Dis play Print dialog Select Print if you just want to print your data to your default printer Select Print Preview if you want access to printer options 2 Choose to include the Summary pane check the box in the print output The Summary pane appears at the beginning of the printed output in tabul
21. matically update to highlight the bytes in the selected frame Select a byte in the Message Sequencing Chart and the Frame Display and Event Display updates to show the frame containing the byte Duplicate Displays The Duplicate icon creates a second window of the same type identical to the first The advantage of additional Displays is that you can look at two different groups of data at the same time For example you can look at the start of an interaction in one Frame Display and the end of that same interaction in the other and compare the two Bookmarks Bookmarks let you mark frames of interest so they can be easily found later Bookmarked frames appear with a magenta triangle icon next to them except in the Event Display where they appear as a dashed line around the start of frame marker You can navigate between bookmarks using the Find feature or by pressing F2 to go to the next bookmark To make a new bookmark right click on the frame and choose Add Bookmark from the Searching menu You can search for strings or patterns in your data or in the frame decode for errors control signal changes book marks special events and time Click the Find icon to open the Find window Click the Help button for more information on the different types of searches Navigating and Search the Data Find Capturing and decoding data within the ComProbe analyzer produces a wealth of information for analysis This mass of information by itself how
22. mp the contents of the Summary pane on the Frame Display into a Comma Separated File csv To access this feature 1 Right click on the Summary pane or open the Frame Display File menu 2 Selectthe Export menu item 3 Select a storage location and enter a File name 4 Select Save Export Filter Out You can filter out data you don t want or need in your text file This option is available only for serial data In the Filter Out box choose which side to filter out the DTE data the DCE data or neither side don t filter any data For example if you choose the radio button for DTE data the DTE data would be filtered out of your export file and the file would contain only the DCE data You can also filter out Special Events which is everything that is not a data byte such as control signal changes and Set I O events Non printable characters or both If you choose to filter out Special Events your export file would contain only the data bytes Filtering out the non printable characters means that your export file would contain only special events and data bytes classified as printable In ASCII printable characters are those with hex values between 20 and 7e 3 31 Technical Support Technical support is available in several ways The online help system provides answers to many user related ques tions Frontline s website has documentation on common problems as well as software upgrades and utilities to use with our product
23. new data can be captured Save Saves the file the capture file Clear Clears or saves the capture file Event Display framed data only Opens a Event Display with the currently selected bytes highlighted Frame Display framed data only Opens a Frame Display with the frame of the currently selected bytes highlighted Notes Opens the Notes dialog Statistics Window Opens up the Statistics window frontline Debug Communications Faster Table 3 1 Control Window Toolbar Icon List continued Description Cascade Arranges windows in a cascaded display Bluetooth Packet Timeline Opens the Packet Timeline dialog Coexistence View Opens the Coexistence View dialog Low energy Opens the low energy Timeline dialog Bluetooth low energy Packet Error Rate Statistics Opens the Packet Error Rate Statistics window Bluetooth Classic Packet Error Rate Statistics Opens the Packet Error Rate Statistics win dow Wi Fi Error Statistics Opens the Wi Fi Error Statistics dialog Bluetooth Protocol Expert System Opens Bluetooth Protocol Expert System window Audio Expert System Opens Audio Expert System window Opening Selecting Data Capture Method At this point your ComProbe s should be plugged in and the drivers configured The drivers should load auto matically when your ComProbe hardware is plugged in Run the Frontline ComProbe Protocol Analysis System shortcut from the Fron
24. o display the Event Dis play Print dialog Select Print if you just want to print your data to your default printer Select Print Preview if you want preview the print in your browser 2 Select the range of events to include from either All or Selection in the Event Range section Choosing All prints all of the events in the capture file or buffer Choosing Selection prints only the selected events in the Event Display window Note In order to prevent a Print crash you cannot select All if there are more than pf 100 000 events in the capture buffer Note See Configure the Print File Range in the Event Display Print Dialog above for an pf explanation of these selections Event Display Print E venit range QA 9 Selection Note Browser pent options may alfect whether any gray background e parted See Help for mio Figure 3 5 Event Display Print Dialog 3 Click the OK button If you chose Print Preview the system displays your data in a browser print preview display with options for print ing such as page orientation and paper size You can also use your Printer Preferences dialog to make some of these selections When printing your data the analyzer creates an html file and prints the path to the file at the bot tom of the page This file can be opened in your browser however it may appear different than the printed ver sion 33 frontline Debug Communications Faster Frame Display Export You can du
25. oge pagk a g H ETILESIL Helene ss 1 J kis d wer asc paak s Bad Packet B pit ed Fal ieee reall F5 Dii _ EER dee peek 4 M erosta asd Boe Ts dd ni id Fal 14 Ai JUA fps ee PRE T E E Chol ia ai baal dodi dcr in enable nssigascn Vicent Pacher Rangt 42 Packhetaj 5 TETTTI ch T Ws x m 128 Cors 0x DE Eit tege xe wa Due EE P Dee ra E le cod sn k su LE RIT a Date Dr Sc gm i uaa ug sl eis ug B nim Mgr d ow Marmi Es H M Far Hale Press Fl Figure 26 Coexistence View Dialog Coexistence View Timeline In the Timeline you can see what packets were being transmitted when they were transmitted and how they relate to each other Figure 27 24 frontline Debug Communications Faster Figure 27 Coexistence View Timeline Display Wi Fi and Bluetooth You can see Classic Bluetooth and Wi Fi together in the 2 4 gigahertz range the Bluetooth channels being blue and the Wi Fi being orange or you can view only Wi Fi in the 5 gigahertz range The packets are color coded which you can match up to the Legend to see the packet type Coexistence View Legend Any packet type that is seen in the current session is shown in bold in the Legend When you select a packet type the attributes for the packet are highlighted in the legend Blue is for Bluetooth and orange is for 802 11 Figure 28 selected FHE Retransmit LMF Bad Packet Filler Cant Dec
26. om the Event Display The Event Display Print feature provides the user with the option to print either the entire capture buffer or the current selection When Print Preview is selected the output displays in a browser print preview window where the user can select from the standard print options The output file format is in html and uses the Microsoft Web Browser Control print options for background colors and images see below Print Background Colors Using Internet Explorer 1 Open the Tools menu on the browser menu bar 2 Select Internet Options menu entry 3 Click Advanced tab 32 frontline Debug Communications Faster 4 Check Print background colors and images under the Printing section 5 Click the Apply button then click OK The Event Display Print feature uses the current format of the Event Display as specified by the user See About Event Display for an explanation on formatting the Event Display prior to initiating the print feature Configure the Print File Range in the Event Display Print dialog Selecting more than one event in the Event Display window defaults the radio button in the Event Display Print dialog to Selection and allows the user to choose the All radio button When only one event is selected the All radio button in the Event Display Print dialog is selected How to Print Event Display Data to a Browser 1 Select Print or Print Preview from the File menu on the Event Display window t
27. on AVDTP AVDTP amp VDTP Signaling AVDTP Signaling 8C link Supported Baseband Baseband Filter Bluetooth FHS Bluetooth FHS Role Slave Headset Headset Configured BT low energy devic La2CAP La2CAP F Exclude NULLs and POLL LMP LMP Non Captured Info Non Captured Info PreCannection FHS PreConnection FHS RFCOMM RFCOMM SDP 5DP Filtering shows only frames that contain the protocol desired but iE shows the entire frame Hiding removes any protocol layers from displaying in any Frame Figure 3 2 Frame Display Quick Filtering and Hiding Protocols Dialog 29 frontline Debug Communications Faster The box on the left is Protocols To Filter In When you select the checkbox for a protocol in the Protocols to Filter In the Summary pane will only display those frames that contain data from that protocol If you filter on more than one protocol the result are all frames that contain at least one of Quick Filter those protocols For example if you filter on IP and IPX NetBIOS you receive all frames that contain either IP or IPX NetBIOS or both A Quick Filter tab then appears on the Frame Display Changing the fil ter definition on the Quick Filter dialog changes the filter applied on the Quick Filter tab Quick filters are per sistent during the session but are discarded when the session is closed The box in the center is the Protocols
28. role switches connection requests and errors You can look at all the packets in the capture or filter by protocol profile The MSC is color coded for a clear and easy to use view of your data Figure 11 12 frontline Debug Communications Faster File Edt View Help ALAN SHS AB ESD All Layers Ctrl Summary Non Msg Summary BB LMP L2CAP SDP RFCOMM 3 535 11 57 15 345437 pen signaling channel 3 6410 11 57 15 348624 RFCOMM SABM Channel Signaling Length 0 AFCOMM channel s that are Open 3 640 11 57 15 348524 Slonallng P Parameter Negotiation Command 3 545 11 57 15 351747 3 650 11 57 15 354874 Po 5 S Channel Signaling Length 10 FC Responder Supports CF Baseband connection encryption started EM 3 7 3l 11 57 15 465497 Open OBEX channel x m i L For Help Press Fl 3 723 11 57 15 461124 Figure 11 Message Sequence Chart How Dol Access The Chart You access the Message Sequence Chart by selecting the icon or MSC Chart from the View menu from the Con H trol Window or Frame Display What Dol See Along the top of the dialog are a series of tabs which will vary depending on the protocols All Layers HB LMP L CAP AVDTP AVOTP Signaling AZDP Figure 12 Protocol Tabs Clicking on a tab displays the messaging between the master and slave for that protocol Figure 13 For example
29. rovides the user with the option to export the capture buffer to an html file The maximum file size however that can be exported is 1000 frames If you chose Print Preview the system displays your data in a browser print preview display with options for print ing such as page orientation and paper size You can also use your Printer Preferences dialog to make some of these selections When printing your data the analyzer creates an html file and prints the path to the file at the bot tom of the page This file can be opened in your browser however it may appear different than the printed ver sion 1 Select Print Preview from the File menu on the Frame Display window to display the Frame Display Print Preview Frame Display Print Preview Provide information to export data fram the currently selected filter tab Include Detail Section f Summary Ma decode section Data Bytes Co All layers Selected layers only Frame Hange SIM Application All SIP Selection SMB SMTP ChI ALD Delete File Reset The Selected Layer Note Browser print options may affect whether any gray background is printed See Help for infa OF Cancel Help Figure 3 4 Frame Display Print Preview Dialog 2 From this point the procedure is the same as steps 2 through 5 in How to Print Frame Display Data above 3 Click the OK button and after a brief wait a browser window will appear Printing fr
30. rypt MULL rit Invalid IFS Poll at Ctrl fe Discontinuity Unknown Click on any bold entry above to enable navigation Figure 28 Coexistence View Legend Coexistence View Indicators The throughput indicators show average throughput and one second throughput for both Bluetooth and Wi Fi For Bluetooth these indicators segregate the master and slave values Figure 29 25 frontline Debug Communications Faster Packets 99 All Selected Viewport Awg throughput 1 sec throughput bitz s bitz s width 1 sec p t Figure 29 Coexistence View Throughput Indicators Coexistence View Throughput Graph The throughput graph displays throughput over time Figure 30 View port synchronined wih Zoomed Throughput Graph and rimelines Classic Payload Throughput Throughput Figure 30 Coexistence View Throughput Graph You can see a line that displays the packet throughput for Bluetooth and Wi Fi You can also see a line that displays the payload throughput for both Bluetooth and Wi Fi Throughput Packet Pavload Both The data lines and y axis labels are color coded Blue Classic Bluetooth Green Bluetooth low energy Orange 802 11 26 frontline Debug Communications Faster Display Synchronization The system synchronizes the display in the Frame Display with the Event Display Select a frame in the Frame Dis play and the other windows auto
31. s Web http www fte com click Support Email tech_support fte com If you need to talk to a technical support representative support is available between 9am and 5pm U S Eastern time Monday through Friday Technical support is not available on U S national holidays Phone 1 434 984 4500 Fax 1 434 984 4505 34
32. s Clicking on a vertical bar left justifies the Viewport to that bar You can drag the sides of the Vlewport or the slider buttons to select multiple bars representing a greater time range e You can click and drag the Viewport within the Scroll Bar Bluetooth Timeline Note B uetooth Timeline does not apply to these ComProbe Devices 802 11 SD The Bluetooth Timeline displays packet information in a main timeline that can display data over different periods of time and also in graph and chart form Instead of just raw numbers and characters the Timeline displays when packets occur their speed type their payload errors retransmits and more Figure 21 20 frontline Debug Communications Faster mi You access the Bluetooth Timeline by selecting the icon from the Control Window or Frame Display toolbars or Bluetooth Timeline from the View menus Mote sent message cfa oughput Help JEN AA iughput bitas 1 Second Payload Throughput Bits Packet Type 447 EBD Payload Throughput Qver Time 1 328 Bici rir ihe sco Status SB Fesco 1 Retransmitted ELT ut bits s Selected ume P Decode Error ulti FHS E Header Error Ej Mull m Payload CRC Error Pol es Discontinuity TYPE DM1 Bluetooth Clock 0x00004f5e Timestamp 8 19 2013 4 24 42 3327 PM Duration 270 us warm pas Er Te arg Dri a aE al mona pas amc yam pa ag p wx cornwcen pes SOC oe concen mxqi yme z nm pan o
33. smitted packets in yellow e When you select a channel detailed information for that channel is displayed in the expanded channel chart on the upper right o The number of packets with no errors is displayed in light green in the bar chart o The number of packets that have header errors is displayed in red in the bar chart o The number of payload errors is displayed in dark red in the bar chart 19 frontline Debug Communications Faster o The number of re transmits is displayed in yellow in the bar chart o When you select the in the upper right corner the bar chart is replaced by a pie chart Figure 20 To return to the bar chart click on the channel again Figure 20 PER Stats All Channel Pie Chart e Inthe Scroll bar captured data begins to appear on the left and fills the width of the bar left to right e The vertical bars in the Scroll Bar each indicate a fixed duration When data first appears in the Scroll Bar as it is being captured each bar equals one second When the data fills the bar reaching the right side limit the last bar moves back to the center of the Scroll Bar The bars stay the same size but doubles in duration for example the first time the Scroll Bar fills the bars return to the middle but now each bar represent two seconds of time instead of one Each time the bars cycle to the middle the time they represent doubles e The Viewport is used to select single or multiple vertical bar
34. tline ComProbe Protocol Analysis System version folder or go to Start gt Programs Frontline ComProbe Protocol Analysis System version and click on Frontline ComProbe Protocol Analysis System shortcut The Select Data Capture Method dialog appears Figure 1 frontline Debug Communications Faster Select Data Capture Method E e O Classics energy Aa Sring Classic few energy Aur Sniffing E Clastic kow enecqu At 11 Ax Sring optional E High Speed Sena Srifing opisna 2 S000 Sring loptional E USB HO H2 Sting ophonal c Virtual Sarg Figure 1 Select Data Capture Method Dialog The selections offered to you will vary according to the hardware you have plugged in Only those data capture methods that may be performed with the attached hardware will appear For the purposes of this document we ll assume that the ComProbeBPA 500 Bluetooth Dual Mode analyzer is plugged in 1 Expand the tree for Classic low energy Air Sniffing Figure 2 Notice the options available for each method If you click on an option a short description appears on the right of the dialog Select Data Capture Method abes d Cla cic loe eret As Sraffing Cilissen energy Ar Siting LJ Combined Connection Clattic low eria 5 ClassicAow erag 802 11 Ax Sniffing optional Bul 11 JR 802117 Isi Ao energy Coesittence 3 5 High Speed Serial Sniffing optional KJ HO BCSP T HO H4 jJ HO H305 gt HO H5 j usu
35. tors e Average throughput is the total payload over the entire session divided by the total time e 1 Second Payload Throughput is the total payload over the most recent one second of duration e Average Throughput for a selected packet range displays the data for a single packet when you select that packet from the Timeline Bluetooth Throughput Graph Payload Throughput over Time shows throughput over a period of time in a graph Figure 25 Payload Throughput Over Time B pcm 6916 Amap i E amp 1B7 ne j 5 03458 ze Horang Aag Show slave LT_ADDR 200 00 Time 0 00 01 06 Figure 25 Bluetooth Timeline Payload Throughput Over Time Bluetooth low energy Timeline Note Bluetooth low energy Timeline does not apply to these ComProbe Devices 802 11 SD K There is also a Bluetooth low energy Timeline that is very similar to the Classic Bluetooth Timeline Coexistence View The Coexistence View displays Bluetooth and the 802 11 channels frequencies in one view or separately Figure 26 23 frontline Debug Communications Faster You access the Coexistence View by selecting the icon from the Control Window or Frame Display toolbars or Coexistence View from the View menus fl Caesistence View mew wifimulboha nne packets 525 thru TOC cfa Ia2alismiuIi de Forrest foc Meagate Help COo609e le2 le e e AR r P Fakie d Al Gekected C0 Vil Gros zac Wight a 1
36. u Path 1 Oen p T n BO OE DO OCC BTE 1 HUET ub j aee abs ede See TF a m o wer rr IEEE gha a Am a de PSC ign RO hia 75 H DEEEF DTE 1HE AMEY Ld Hn W dirt Ba r1 cS eee ee a Ji Hp E La Sea fd arra Figure 5 Summary Pane e The Decode pane Figure 6 contains a detailed decode of the frame transaction selected in the Summary pane and is located on the left side of the Frame Display window Channel Index 38 2426 MHz Meet Predehned Fiber Criena lo BT bow ener Decrypted by Analyrer Ho E venit Statur Everything wat ok PDU Length 21 LE FET Preamble 55 Apper Address ef bede CRC Wiari LE ADV POU Type ADW IND Aheste Audet a pube Faksid Length 19 Avera Adhere Cd Deb fuv D ata 03261745144 7654412065536173 gt Figure 6 Decode Pane e The three smaller panes on the bottom right of the Frame Display show the data in hex binary and ASCII Fig ure 7 The user can choose to have these panes show the data in other radixes or character sets Select any field in the Decode pane and the corresponding bit s or byte s will be selected in the data panes frontline Debug Communications Faster 00011000 00000000 00110001 00000000 00010101 10101010 11010110 10111110 10001001 10001110 00000000 00010011 00000010 10101101 00000000 01011011 00000010 00000000 01110011 01101111 01101101 01100101 00100000 01000001 P 01100100 01110110 01000100 01100001 01110100 01100001 00110010 00000910 11110111 09110010 A18
37. u have set the search value you can 1 use the Search Previous and Search Next buttons or 2 F2 and F3 to move to the next or previous frame in the chart PER Stats Note PER Stats does not apply to these ComProbe Devices SD The Packet Error Rate Stats PER Stats Plug in provides a dynamic graphical representation of the Packet Error Rate for each channel Figure 19 18 frontline Debug Communications Faster T Packort Orror Rale by Channel Pome 09 LIRE Eg Mu wit NN k amp 2 P aj Ls n xl a m SERI DT Figure 19 PER Stats Dialog Packet Error Rate Stats assist in detecting bad communication connections When a high percentage of re trans mits and or header payload errors occur careful analysis of the statistics indicate whether the two devices under test are experiencing trouble communicating or the packet sniffer is having difficulty listening Generally if the statistics display either a large number of re transmits with few errors or an equal number of errors and re transmits then the two devices are not communicating clearly However if the statistics display a large number of errors and a small number of re transmits then the packet sniffer is not receiving the trans missions clearly e Each channel contains a bar that displays the number of packets with no errors in green packets with Header Errors in red packets with Payload or CRC errors in dark red and Retran
38. uitiiiiissssssslllllsllsll e cece cece eee eeceeeeeeeeeeees 34 Figure 3 1 Find Dialog SRO 28 Figure 3 2 Frame Display Quick Filtering and Hiding Protocols Dialog suuuuuuuus 29 Figure 3 3 Frame Display Print Dialog _ 2 220 lle ccc eee eee ee eeee 31 Figure 3 4 Frame Display Print Preview Dialog _ 2 22 22 cece cee ee eee aoaaa nanana 32 Figure 3 5 Event Display Print Dialog _ 2 2 22 ieee cece ee ce eee cece cece cece eeeeeeeeeeee 33 frontline Debug Communications Faster Purpose This document is designed to get you started capturing and analyzing data with the ComProbe Protocol Analysis System CPAS We ll do this by going through one of the data capture methods available in CPAS What this document does not do is cover all methods of data capture or data analysis for CPAS We wanted to provide a solid foundation for early success in capturing data and using some of the tools to view and analyze what you capture This document is designed to get you started creating protocol decoders using Frontline s proprietary Decoder Script language DecoderScript can be a bit intimidating at first but once you understand some basic concepts it s remarkably simple In the most direct way this document and the accompanying wizard will walk you through the mechanics of creating a very simple protocol decoder When we say a simple decoder we mean it
Download Pdf Manuals
Related Search