Port Message Viewer v6+
Contents
1. FIGURE 3 3 MAIN WINDOW Collapse Expand Device Top of Main Window Setup Port Message Viewer V 5 9 HER Pott COM v Baud Rate 115200 No Ports Open Open Device Setup Fie 7 Enabled Search Protocol File Evatt 10_FCat_1vO xml Open Protocol File Device Setup File MTG_Eval32_ devices ami e Messages Input File Open Input File Save Raw Data Save Formatted Data v Time 2 Status Cmd M ICM v MCM v MDP v IOCM 7 12C Devices Hold Scroll Font Clear Message DS60001219A page 8 2013 Microchip Technology Inc Port Message Viewer v6 3 1 COM PORT AND BEAGLE l2C SPI CONTROL FIELD The Com Port and Beagle Control Field in the Port Message Viewer main window provides a drop down menu which shows all available PC serial ports and Total Phase Beagle I C SPI devices Figure 3 4 shows each part of the Com Port and Beagle Control Field The user must select the com port or Beagle device which is connected to the target INIC board The com port baud rate must also be selected and must match the target board baud rate The Beagle device must be connected to the INIC Control SDA SCL and Ground pins Once the appropriate com port and baud rate or Beagle device are selected connection to the target board is achieved by selecting the Open Port button Note To support communication between software and hardware the baud rate of the t2. MICROCHIP Port Message Viewer v6 User s Guide for Microchip Evaluation Boards Supporting MOST Media Oriented Systems Transport 2013 Microchip Technology Inc DS60001219A page 1 JULY 2013 Note the following details of the code protection feature on Microchip devices Microchip products meet the specification contained in their particular Microchip Data Sheet Microchip believes that its family of products is one of the most secure families of its kind on the market today when used in the intended manner and under normal conditions There are dishonest and possibly illegal methods used to breach the code protection feature All of these methods to our knowledge require using the Microchip products in a manner outside the operating specifications contained in Microchip s Data Sheets Most likely the person doing so is engaged in theft of intellectual property Microchip is willing to work with the customer who is concerned about the integrity of their code Neither Microchip nor any other semiconductor manufacturer can guarantee the security of their code Code protection does not mean that we are guaranteeing the product as unbreakable Code protection is constantly evolving We at Microchip are committed to continuously improving the code protection features of our products Attempts to break Microchip s code protection feature may be a violation of the Digital Millennium Copyright Act If such acts
3. lt registers gt lt registers gt lt device gt lt devices gt 2013 Microchip Technology Inc DS60001219A page 15 Port Message Viewer v6 3 1 5 Search Messages The Search Messages dialog box as shown in Figure 3 12 allows the user of Port Message Viewer v6 to search the messages shown in the display window When text is input into Look Forfield criteria is selected from the drop down list box then the Find button is selected the Message column will be searched The following lists the options under the pull down criteria menu e Partial Match any portion of the value in the Message column matching the Look For text box text will be found e Regular Expression the value in the Message column will be searched for the pattern specified in the Look For text box e Match Whole Line the entire value in the Message column must match the Look For text box text Searches are not case sensitive Patterns for regular expressions are those used by the Microsoft Net Framework Select the Find button again to look for the next entry FIGURE 3 12 SEARCH MESSAGES DIALOG 1 Search Messages Look For Partial Match Partial Match Match Whole Line Et DS60001219A page 16 2013 Microchip Technology Inc Port Message Viewer v6 NOTES 2013 Microchip Technology Inc DS60001219A page 17 MICROCHIP Worldwide Sales and Service AMERICAS Corporate Office 2355
4. 12 44 p EHCK lt ICM Status Success s41 00 07 01 14 40 3C 00 01 00 p EHCK INIC 00 CreateS ocket Result SocketHandle 00 s40 00 03 02 12 44 p EHC gt ICM Status Success Socket successfully created Socket Handle is 0x00 Creating Network IN socket for DAC 01 03 098 01 03 098 01 03 108 01 03 108 01 03 12 01 03 12 01 03 117 01 03 117 s41 00 03 02 12 44 p EHC lt ICM Status Success s41 00 07 01 14 40 3C 00 01 01 p EHC lt INIC 00 CreateSocket Result SocketHandle 01 s40 00 03 02 12 44 p EHC gt ICM Status Success Socket successfully created Socket Handle is 0x01 Creating INIC MediaLB socket OUT to DAC MediaLB channel 0x0004 IOCM EHC lt INIC 00 Bandwidth Status AssignBWnit FF AssignBW 00 T otalBw 0F AssignBwFree 001C s41 00 21 06 04 01 02 F0 22 01 11 12 00 16 01 00 00 01 02 03 04 05 06 07 08 09 08 0B 0C 0D 0E 0F 10 11 12 13 p EHC lt 02F0 Audio mp 01 Connect StartResult 01 000001 0203040506070809040B OCOD OE OF 10111213 EHC gt INIC 00 CreateSocket StartResult PortlD MediaL BPort CfgParam Direction Out D ataT ype SyncData SocketBlockwidth 0014 CigParamMediaLB s40 00 20 01 14 40 32 00 18 02 00 00 00 14 02 00 01 02 03 04 05 06 07 08 09 08 0B 0C 00 0E 0F 10 11 12 13 p EHC gt INIC 00 CreateS ocket StartResult Port D NetworkPort CfgParam Direction In DataT ype SyncD ata SocketBlackwidth 001 4 CigParamN W Preall Font Clear Type Raw ICM Raw Status Cmd Raw MCM
5. allow unauthorized access to your software or other copyrighted work you may have a right to sue for relief under that Act Information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates It is your responsibility to ensure that your application meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORY OR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITS CONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSE Microchip disclaims all liability arising from this information and its use Use of Microchip devices in life support and or safety applications is entirely at the buyer s risk and the buyer agrees to defend indemnify and hold harmless Microchip from any and all damages claims suits or expenses resulting from such use No licenses are conveyed implic itly or otherwise under any Microchip intellectual property rights Trademarks The Microchip name and logo the Microchip logo dsPIC FlashFlex KEELOQ KEELOQ logo MPLAB PIC PlCmicro PICSTART PIC32 logo rfPIC SST SST Logo SuperFlash and UNI O are registered trademarks of Microchip Technology Incorporated in the U S A and other countries FilterLab Hampshire HI TECH C Linear Active Thermistor MTP SEEVAL and The Embedded Control Solutions Company are register
6. level drivers and are useful for debugging Once the low level drivers are working correctly these messages become noise in the out put stream as they don t convey any application information Thus it is useful to be able to disable these translated messages in the display ICM ICMs or INIC Control Messages are messages between the EHC and INIC specifically messages to or from the local FBlock INIC IOC IO Control Messages are messages to or from an IO Companion device specifically its IOC FBlock MCM MOST Control Messages MCMs are messages to or from other FBlocks on the network Most of these messages are sent across the net work but could also be to application FBlocks on the local device as well MDP MOST Data Packets MDPs are asynchronous data packets such as those sent by MOST High Protocol on the single asynchronous channel on the network Time When selected timestamps will be displayed with the captured mes sages if timestamps are available PC Devices Allows user to call out and view other IZC devices on the same IZC bus as INIC such as the Codec Power Management Control or EEPROM I2C device descriptions are described in Section 3 1 4 For example in Figure 3 8 only ICM and MCM Port Messages will be displayed in the window All other Port Messages will be filtered from view For I2C write messages shown e g s40 the window displays the decoded mes sages Figure 3 9 with a right arrow to indic
7. 8502 7355 Fax 86 532 8502 7205 China Shanghai Tel 86 21 5407 5533 Fax 86 21 5407 5066 China Shenyang Tel 86 24 2334 2829 Fax 86 24 2334 2393 China Shenzhen Tel 86 755 8864 2200 Fax 86 755 8203 1760 China Wuhan Tel 86 27 5980 5300 Fax 86 27 5980 5118 China Xian Tel 86 29 8833 7252 Fax 86 29 8833 7256 China Xiamen Tel 86 592 2388138 Fax 86 592 2388130 China Zhuhai Tel 86 756 3210040 Fax 86 756 3210049 ASIA PACIFIC India Bangalore Tel 91 80 3090 4444 Fax 91 80 3090 4123 India New Delhi Tel 91 11 4160 8631 Fax 91 11 4160 8632 India Pune Tel 91 20 2566 1512 Fax 91 20 2566 1513 Japan Osaka Tel 81 6 6152 7160 Fax 81 6 6152 9310 Japan Tokyo Tel 81 3 6880 3770 Fax 81 3 6880 3771 Korea Daegu Tel 82 53 744 4301 Fax 82 53 744 4302 Korea Seoul Tel 82 2 554 7200 Fax 82 2 558 5932 or 82 2 558 5934 Malaysia Kuala Lumpur Tel 60 3 6201 9857 Fax 60 3 6201 9859 Malaysia Penang Tel 60 4 227 8870 Fax 60 4 227 4068 Philippines Manila Tel 63 2 634 9065 Fax 63 2 634 9069 Singapore Tel 65 6334 8870 Fax 65 6334 8850 Taiwan Hsin Chu Tel 886 3 5778 366 Fax 886 3 5770 955 Taiwan Kaohsiung Tel 886 7 213 7828 Fax 886 7 330 9305 Taiwan Taipei Tel 886 2 2508 8600 Fax 886 2 2508 0102 Thailand Bangkok Tel 66 2 694 1351 Fax 66 2 694 1350 EUROPE Austria Wels Tel 43 7242 2244 39 Fax 43 7242 2244 393 Den
8. NIC Decoded when corresponding filter is checked Po m Port COM1 v Baud Rate 115200 v No Ports Opel Open Device Setup Fis V Enabled Protocol File Eval 0_FCat_1v0 xml Device Setup File TG_Eval92_devices xml Input File Open Input File Save Raw DAta Save Formatted Data Raw Time Status Cmd ICM Z MCM MDP IDCM Hold Scroll Mesage Type 01 00 288 C 00 Bandwidth Status AssignBWlnit FF AssignBW 0C T ofalB W 0F AssignBWFree 001C ICM 01 03 049 EHC lt 412F0 AudioAmp 01 Connect StartResult 01 000001 0203040906070809040B OCOD OE OF 10111213 MCM 01 03 071 SINIC 00 CreateSocket StartResult PortID MediaLB Port CfgParam Direction Out DataType SyncData So ICM 01 03 081 NIC 00 CreateS ocket Result SocketHandle 00 ICM 01 03 098 EHC gt NIC 00 CreateS ocket StartR esult PortlD NetworkPort PaParam Direction in DataType SyncData Sock ICM 01 03 112 INIC 00 CreateS ocket Result SocketHandle 01 ICM 01 03 128 EHC 01 SocketHandleOutput 00 ICM Message 01 03 136 EHC INIC 00 ConnectSockets Result ConnectionHandle 00 ICM Timestamps 01 03 150 EHC m n rt 5 MCM 02 00 122 EHC lt 02F0 Audio mp 01 DisConnect StartResult 01 MCM 02 00 135 EHC gt INIC 00 DisconnectSockets StartResult ConnectionHandle 00 ICM 02 00 143 EHC lt INIC 00 DisconnectSockets Result ICM 02 00 154 EHC gt 02F0 Audiodmp 01 DisConnect Result 01 MCM 02 00 177 EHC gt INIC 00 DestroySocket StartResult SocketHandle 01 ICM 02 00 188 EHC lt INIC 00 Dest
9. Raw 000 00 00 904 40 00 03 02 12 44p Raw 000 00 00 906 s41 00 09 01 14 50 5C 00 03 03 00 00p Raw 000 00 00 908 TASK MOST NetServices Supervisor State MSVAL_S_ON Raw 000 00 00 911 TASK MOST Network has reached state NetOn Raw 000 00 00 914 TASK MOST Hardware Version is 0x10 Raw 000 00 00 916 TASK MOST Product Version is 1 6 4 Raw 000 00 00 919 s51 74 51 00p Raw 000 00 00 920 50 74 10p Raw 000 00 00 921 Opening the Codec Raw 000 00 00 924 530 00 0F 02p Raw 000 00 00 325 s30 01 00 00p Raw 000 00 00 326 30 02 45 DFp Raw 000 00 00 327 30 03 3F 3Fp Raw 000 00 00 929 30 04 02 02p Raw 000 00 00 330 30 10 00 00p Raw 000 00 00 331 30 11 00 00p Raw 000 00 00 333 30 12 00 00p Raw 000 00 00 334 30 13 00 00p Raw 000 00 00 335 30 14 00 00p Raw 000 00 00 337 30 20 00 00p Raw 000 00 00 938 30 21 00 00p Raw 000 00 00 333 30 22 00 00p Raw 000 00 00 940 330 23 00 00p Raw 0000000840 EHC gt CODECAGC Settings 2 Devie 000 00 00 942 Codec opened OK Raw Initializing amp Raw 000 00 00 944 31 13 31 00 00p Raw K 3 1 4 1 1 C DEVICE SETUP The device setup file is an XML file that can assign names to I2C devices at specific addresses At a minimum the INIC EC address needs to be specified Other IZC devices such as EEPROM and Codecs can be added to the file so their names show up in the translated output In addition many such devices have a register address as the first parameter These register
10. Raw Status Cmd Raw Raw ICM Raw Status Cmd Raw ICM Raw Status Cmd Raw Raw Raw ICM Raw Status Cmd Raw ICM Raw Status Cmd Raw MI 12C Devices Hold Scroll 2013 Microchip Technology Inc DS60001219A page 11 Port Message Viewer v6 3 1 3 Display Filter and Control As the ASCII data comes in to Port Message Viewer v6 each line is saved in an internal database If the line is a port message then the message is interpreted via the Function Catalog and saved in the database along with the raw text data In addition to translating the message Port Message Viewer v6 also categorizes the message according to its source destination FIFO based on data in the header of the message The filter section allows the user to select which data from the database is shown in the display section There are additional general controls here for controlling the display such as clearing or freezing the screen In order to capture new Port Messages the Enabled check box must be selected Filter and viewer options include see Figure 3 8 for image of selectable filters e Raw When selected all of the ASCII data coming in the Serial port will be shown If not selected the raw data is not shown and only the enabled trans lated Port Messages will be seen Status Cmd When selected the FIFO Status and Command messages between the EHC and INIC will be shown These messages are used for flow control by the low
11. West Chandler Blvd Chandler AZ 85224 6199 Tel 480 792 7200 Fax 480 792 7277 Technical Support http Awww microchip com support Web Address www microchip com Atlanta Duluth GA Tel 678 957 9614 Fax 678 957 1455 Boston Westborough MA Tel 774 760 0087 Fax 774 760 0088 Chicago Itasca IL Tel 630 285 0071 Fax 630 285 0075 Cleveland Independence OH Tel 216 447 0464 Fax 216 447 0643 Dallas Addison TX Tel 972 818 7423 Fax 972 818 2924 Detroit Farmington Hills MI Tel 248 538 2250 Fax 248 538 2260 Indianapolis Noblesville IN Tel 317 773 8323 Fax 317 773 5453 Los Angeles Mission Viejo CA Tel 949 462 9523 Fax 949 462 9608 Santa Clara Santa Clara CA Tel 408 961 6444 Fax 408 961 6445 Toronto Mississauga Ontario Canada Tel 905 673 0699 Fax 905 673 6509 ASIA PACIFIC Asia Pacific Office Suites 3707 14 37th Floor Tower 6 The Gateway Harbour City Kowloon Hong Kong Tel 852 2401 1200 Fax 852 2401 3431 Australia Sydney Tel 61 2 9868 6733 Fax 61 2 9868 6755 China Beijing Tel 86 10 8569 7000 Fax 86 10 8528 2104 China Chengdu Tel 86 28 8665 5511 Fax 86 28 8665 7889 China Chongqing Tel 86 23 8980 9588 Fax 86 23 8980 9500 China Hangzhou Tel 86 571 2819 3187 Fax 86 571 2819 3189 China Hong Kong SAR Tel 852 2943 5100 Fax 852 2401 3431 China Nanjing Tel 86 25 8473 2460 Fax 86 25 8473 2470 China Qingdao Tel 86 532
12. arget board and Port Message Viewer v6 must be the same With a Serial Port connection 115 kbaud is typically the high est rate supported using a direct RS232 com port For higher speeds a USB to RS232 converter is required FIGURE 3 4 COM PORT AND BEAGLE CONTROL FIELD Select the serial port Rescan for Select the Baud rate connected to the available com compatible with the Target board target board ports target board connect disconnect Pat come v BawdRate 11520 v 3 1 1 Protocol Syntax Field The Protocol Syntax field in the Port Message Viewer main window allows the user to select the desired protocol syntax file for the application These files are stan dard MOST Function Catalog XML formatted files and are used by Port Message Viewer v6 to translate the raw messages into readable output Select the Open Pro tocol File button to browse a directory for a particular protocol syntax file Figure 3 5 shows the Protocol Syntax Field FIGURE 3 5 PROTOCOL SYNTAX FILE File selected for decoding Browse directory for raw messages protocol syntax file Protocol File 9 Evall10_FCat_1v0 xml Open Protocol File Note Protocol syntax files are provided with Microchip boards and will be located in the application directory 3 1 2 File Save Retrieval Current contents of the display window can be saved at any time to a text file by clicking on either the Save Raw Data or Save Formatted Data
13. ate the message was sent to INIC from the EHC For I C read messages e g s41 the decoded message is displayed with a left arrow to indicate the message was sent from INIC to the EHC Current contents of the database can be saved at any time to a text file by clicking on either the Save Raw Data or Save Formatted Data buttons and specifying a filename The Save Raw Data option only saves the original ASCII data from the database These files can later be opened with the Input File function The Save Formatted Data option saves data according to the currently selected filters The Clear button is used to clear the display window of all Port Messages which clears the local data DS60001219A page 12 2013 Microchip Technology Inc Port Message Viewer v6 base as well In order to capture new Port Messages Enabled must be selected Selecting the Hold Scroll option keeps the display from moving as new data comes in and is added to the bottom of the screen Figure 3 10 shows when filters are set so only ICM and MCM Port Messages are decoded and displayed in the display window All other messages will be filtered from view FIGURE 3 10 EXAMPLE OF DECODED MESSAGE IN DISPLAY PC message payload Displayed in hexadecimal format lt Indicates message was gt Indicates message was when Raw is checked sent to the EHC from INIC sent from the EHC to I
14. ative or Field Application Engineer FAE for support Local sales offices are also available to help custom ers A listing of sales offices and locations is included in the back of this document Technical support is available through the web site at http microchip com support RECOMMENDED READING This user s guide describes how to use Port Message Viewer v6 Other useful documents are listed below The following Microchip documents are available and recommended as supplemental reference resources 1 OS81092 MOST ToGo Evaluation Board Hardware Data Sheet DS60001222A 2013 www microchip com DOCUMENT REVISION HISTORY Revision A DS60001219A 07 2013 Initial release of Port Message Viewer v6 User Guide for Microchip Automotive Infotainment Systems Evaluation Boards Revision d6 04 2007 Draft release D sssm rrrennneen nena eee eee wwwwww w 2013 Microchip Technology Inc DS60001219A page 5 PORT MESSAGE VIEWER V6 MICROCHIP Chapter 1 Introduction In a MOST device the communication between the INIC and the local controller the External Host Controller or EHC is done via a protocol called the Port Message Proto col This protocol is defined in the respective API User Manual for the INIC In Microchip evaluation boards the EHC firmware provides a spy functionality for Port Messages such that they are sent out a Serial Port either an RS232 port or a USB port running a CDC Class Seria
15. buttons and specifying a filename 2013 Microchip Technology Inc DS60001219A page 9 Port Message Viewer v6 Raw data captured from a target board and saved in a text file can be retrieved using Open Input File Once the file is opened the raw data is displayed and trans lated in this window using the selected protocol syntax file This feature allows Port Message Viewer v6 to be useful when offline not connected to a target board Figure 3 6 shows the Port Message display window The formatted data file is useful for cutting and pasting sections into email or documentation Other programs like HyperTerminal can be used to save raw format text files and those can be opened and interpreted with Port Message Viewer v6 but the following header must be added to the text file Device Raw Data Header Row Do Not Modify Delete FIGURE 3 6 PORT MESSAGE DISPLAY WINDOW Loads an existing Saves all the data i Saves the raw data in the in the database to a previously captured raw database to a text file text file text file for display Input File Open Input File Save Formatted Data Figure 3 7 shows an example of raw information output displayed in the display window from an Evaluation board with no interpretation This is the output that would be seen on a general purpose terminal program such as HyperTerminal This is also the format of the data saved to a file in Raw Data format This window is also whe
16. d gt Printed on recycled paper ISBN 978 1 62077 321 5 Q UAL I TY MA NAG E M E N T SYS TE M Microchip received ISO TS 16949 2009 certification for its worldwide headquarters design and wafer fabrication facilities in Chandler and CERTI FIE D BY DNV Tempe Arizona Gresham Oregon and design centers in California and India The Company s quality system processes and procedures a are for its PIC MCUs and dsPIC DSCs KEELO code hopping IS O TS 1 6 949 a devices Serial EEPROMs microperipherals nonvolatile memory and analog products In addition Microchip s quality system for the design and manufacture of development systems is ISO 9001 2000 certified DS60001219A page 2 2013 Microchip Technology Inc PORT MESSAGE VIEWER V6 MICROCHIP Preface NOTICE TO CUSTOMERS All documentation becomes dated and this manual is no exception Microchip tools and documentation are constantly evolving to meet customer needs so some actual dialogs and or tool descriptions may differ from those in this document Please refer to our web site www microchip com to obtain the latest documentation available Documenis are identified with a DS number This number is located on the bottom of each page in front of the page number The numbering convention for the DS number is DSXXXXXA where XXXXX is the document number and A is the revision level of the document For the most up to dat
17. e information on Microchip development tools please visit www microchip com INTRODUCTION This chapter contains general information that will be useful to know before using the Port Message Viewer v6 Items discussed in this chapter include Document Layout Conventions Used in this Guide Warranty Registration The Microchip Website Customer Change Notification Service Customer Support Recommended Reading Document Revision History DOCUMENT LAYOUT This user s guide describes how to use the Port Message Viewer v6 The document is organized as follows e Chapter 1 Introduction This chapter introduces the Port Message Viewer v6 and provides an overview of various features Chapter 2 Installation This chapter describes the installation process e Chapter 3 Navigation through the Main Window This chapter describes how to access and use the Port Message Viewer v6 and gives examples of the available functionality 2013 Microchip Technology Inc DS60001219A page 3 Port Message Viewer v6 CONVENTIONS USED IN THIS GUIDE Within this manual the following abbreviations and symbols are used to improve readability Example BIT FIELD BIT K Y BITS m n PIN SIGNAL msb Isb MSB LSB zzzzb Oxzzz zzh rsvd code Multi Word Name Section Name VAL x lt Parameter gt Parameter Parameter Description Name of a single bit within a field Na
18. ed trademarks of Microchip Technology Incorporated in the U S A Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries Analog for the Digital Age Application Maestro BodyCom chipKIT chipKIT logo CodeGuard dsPICDEM dsPICDEM net dsPICworks dsSPEAK ECAN ECONOMONITOR FanSense HI TIDE In Circuit Serial Programming ICSP Mindi MiWi MPASM MPF MPLAB Certified logo MPLIB MPLINK mTouch Omniscient Code Generation PICC PICC 18 PICDEM PICDEM net PICkit PICtail REAL ICE rfLAB Select Mode SQI Serial Quad I O Total Endurance TSHARC UniWinDriver WiperLock ZENA and Z Scale are trademarks of Microchip Technology Incorporated in the U S A and other countries SQTP is a service mark of Microchip Technology Incorporated in the U S A GestlC and ULPP are registered trademarks of Microchip Technology Germany II GmbH amp Co KG a subsidiary of Microchip Technology Inc in other countries A more complete list of registered trademarks and common law trademarks owned by Standard Microsystems Corporation SMSC is available at www smsc com The absence of a trademark name logo etc from the list does not constitute a waiver of any intellectual property rights that SMSC has established in any of its trademarks All other trademarks mentioned herein are property of their respective companies 2013 Microchip Technology Incorporated Printed in the U S A All Rights Reserve
19. er the web site contains the following information Product Support Data sheets and errata application notes and sample programs design resources user s guides and hardware support documents latest software releases and archived software e General Technical Support Frequently Asked Questions FAQ technical support requests online discussion groups Microchip consultant program member listing Business of Microchip Product selector and ordering guides latest Micro chip press releases listing of seminars and events listings of Microchip sales offices distributors and factory representatives DS60001219A page 4 2013 Microchip Technology Inc Port Message Viewer v6 CUSTOMER CHANGE NOTIFICATION SERVICE Microchip s customer notification service helps keep customers current on Micro chip products Subscribers will receive e mail notification whenever there are changes updates revisions or errata related to a specified product family or devel opment tool of interest To register access the Microchip web site at www microchip com Under Support click on Customer Change Notification and follow the registration instructions CUSTOMER SUPPORT Users of Microchip products can receive assistance through several channels e Distributor or Representative e Local Sales Office e Field Application Engineer FAE e Technical Support Customers should contact their distributor represent
20. etup exe then follow instruction to install as shown in shown in Figure 2 2 FIGURE 2 2 PORT MESSAGE VIEWER V6 SETUP i Port Message Viewer Welcome to the Port Message Viewer Setup Wizard The installer will guide you through the steps required to install Port Message Viewer on your computer WARNING This computer program is protected by copyright law and international treaties Unauthorized duplication or distribution of this program or any portion of it may result in severe civil or criminal penalties and will be prosecuted to the maximum extent possible under the law 2013 Microchip Technology Inc DS60001219A page 7 PORT MESSAGE VIEWER V6 MICROCHIP Chapter 3 Navigation through the Main Window The main window of the Port Message Viewer v6 is divided into seven primary sec tions including Com Port and or Beagle selection e Protocol Syntax e File Save Retrieval e Display Filter Control e Raw Port Message Input and Translated Filtered Output e Device Setup e Search Messages Figure 3 3 illustrates the main window and outlines the primary sections of the Port Mes sage Viewer v6 The window may be stretched horizontally and or vertically to increase the visible portion of messages without the use of scroll bars Com Port and Beagle I2C SPI Control Protocol Syntax Field File Save Retrieval Display Filter Control Raw Port Message Input and Translated Filtered Output
21. l Port Emulation along with a time stamp in an ASCII format as shown below 000 00 00 717 gt s40 00 07 01 14 50 20 00 01 01p These messages along with other informative debug output text such as from the Net Services Trace Module error messages and general program flow messages are sent out the Serial Port of the Evaluation board Any terminal program such as HyperTermi nal or TeraTerm can be used to view the output Port Message Viewer v6 is a specialized terminal program that can interpret the port messages and show them in a more human readable format Port Message Viewer v6 uses an XML MOST function catalog to interpret the messages just like the Opto lyzer Suite software In fact it uses the same Optolyzer Suite component to interpret the messages Now the above message when interpreted is 000 00 00 717 gt s40 00 07 01 14 50 20 00 01 01p 000 00 00 717 gt EHC gt INIC 00 DeviceMode Set DeviceMode Master Now we can see that the above Port Message was a command to INIC to set its Devic eMode to Master In addition to just interpreting the Port Messages Port Message Viewer provides utilities to filter messages save the raw and or formatted interpreted output to a file Also a saved raw file can be reopened and played back as if it were coming from a live session The Port Message spy functionality of the Evaluation boards comes from the Microchip C driver itself Since customer s may choose not to impleme
22. mark Copenhagen Tel 45 4450 2828 Fax 45 4485 2829 France Paris Tel 33 1 69 53 63 20 Fax 33 1 69 30 90 79 Germany Munich Tel 49 89 627 144 0 Fax 49 89 627 144 44 Italy Milan Tel 39 0331 742611 Fax 39 0331 466781 Netherlands Drunen Tel 31 416 690399 Fax 31 416 690340 Spain Madrid Tel 34 91 708 08 90 Fax 34 91 708 08 91 UK Wokingham Tel 44 118 921 5869 Fax 44 118 921 5820 11 29 12 DS60001219A page 18 2013 Microchip Technology Inc
23. me of a single bit BIT in FIELD Range from x to y inclusive Groups of bits from m to n inclusive Pin Name Signal Name Most significant bit least significant bit Most significant byte least significant byte Binary number value zzzz Hexadecimal number value zzz Hexadecimal number value zz Reserved memory location Must write 0 read value indeterminate Instruction code or API function or parameter Used for multiple words that are considered a single unit such as Resource Allocate message or Connection Label or Decrement Stack Pointer instruction Emphasis Reference Section or Document name Over bar indicates active low pin or register bit Don t care lt gt indicate a Parameter is optional or is only used under some conditions Braces indicate Parameter s that repeat one or more times Brackets indicate a nested Parameter This Parameter is not real and actually decodes into one or more real parameters WARRANTY REGISTRATION Please complete and mail the Warranty Registration Card that was enclosed with the development board Sending in the registration card entitles you to receive new product updates Interim software releases are available at the Microchip web site THE MICROCHIP WEBSITE Microchip provides online support via our WWW site at www microchip com This web site is used as a means to make files and information easily available to cus tomers Accessible by using your favorite Internet brows
24. nc Port Message Viewer v6 The user can also filter Port Messages of interest in this window by selecting dese lecting the corresponding Port Message type as shown in Figure 3 8 FIGURE 3 8 DISPLAY WINDOW WITH ONLY ICM AND MCM FILTERS Selects which port messages are filtered from view Status Cmd M Hold Scroll O 12C Devices Font Clear Figure 3 9 shows the raw and interpreted output from an Evaluation board This output highlights each type of Port Message that has been selected as shown in Figure 3 8 above FIGURE 3 9 RAW AND INTERPRETED OUTPUT EXAMPLE i gt Port Message Viewer V 5 9 v Baud Rate 115200 Protocol File Evall10_FCat_1v0 xml Port COM1 input File Open Protocol File MSIE Enabled No Ports Open Open Device Setup File Device Setup File MTG_Eval92_devices xml Open Input File Save Raw Data Save Formatted Data Status Cmd Raw v MDP Time 01 00 288 01 00 288 01 00 293 01 00 293 01 03 049 01 03 049 01 03 060 01 03 060 Message 341 00 0B 01 14 40 EC 00 05 FF 0C 0F 00 1C p 340 00 03 02 12 44 p EHC gt ICM Status Success 40 00 03 02 02 44 p EHC gt MCM Status Success 01 03 071 01 03 071 01 03 077 01 03 077 01 03 081 01 03 08 01 03 085 01 03 085 s40 00 00 01 14 40 32 00 07 00 01 00 00 14 00 04 p s41 00 03 02
25. nt this functionality in their driver Port Message Viewer v6 can also interpret the output of a third party C spy tool that being the Beagle from TotalPhase www totalphase com This document provides Port Message Viewer v6 users with information about e Installation e Navigating through the main window e Reading decoded Port Messages e Filtering specific Port Messages e Loading a Protocol Syntax File Loading I C device setup file When starting Port Message Viewer v6 it is assumed the user has properly installed the software and an appropriate target board is connected to the PC DS60001219A page 6 2013 Microchip Technology Inc PORT MESSAGE VIEWER V6 MICROCHIP Chapter 2 Installation 1 Before using Port Message Viewer v6 The OptoLyzer Components software must be installed This software has been provided within the files directory Click here on Optolyzer Components V03 02 09 exe then follow instructions to install as shown in Figure 2 1 below FIGURE 2 1 OPTOLYZER FILE DOWNLOAD File Download Security Warning Do you want to run or save this file Name OptoLyzer_Components_V03_02_08 exe Type Application 238MB From www smsc com While files from the Internet can be useful this file type can potentially harm your computer If you do not trust the source do not tun or save this software What s the risk 2 Now install Port Message Viewer v6 by clicking here on s
26. re decoded messages are displayed The selected protocol syntax file in the Protocol Syntax Field is used to translate raw messages into readable text Port Message Viewer V 5 9 EER Print statements Port COMI v sauna 11520 v No Ports Open Open Device Setup File embedded in the Protocol File Evall10_FCat_1v0 xml Device Setup File MTG_Eval2_devices xml code for debugging ile Open Input File Save Raw Data Save Formatted Data purposes Status Cmd MDP IOCM 12C Devices Hold Scroll Type IT Raw ly created Socket Handle is 0x00 Raw Raw Message 01 0 Raw Timestamps 01 12 44 Raw S Raw s40 00 03 02 12 44 p 2 Raw Socket successfully created Socket Handle is 0x01 Start bie Read Message Raw ecting Sockets Raw 08 0114 2 Raw 1021244 Start of RC Write Message Hai 01 14 40 5C 00 01 00 p Raw 02 12 44 p Raw ocket connection status Connection Handle 0x00 Raw 0B 05 04 02 F0 22 01 11 1C 00 01 01 p Raw cipher frame size Raw 0D 01 2C D0 20 00 07 20 01 01 01 00 00 00 p Raw 03 02 24 44 p Raw cipher exchange key Raw s46 00 17 01 2C D0 20 00 11 20 01 07 06 00 00 01 02 03 04 05 06 07 08 09 084 08 p Raw s49 00 03 02 24 44 p Raw Setting cipher nonce Raw st 340 Got Vali Boo wo s40 Setti s48 349 Setti s58 8S 5 oo it DS60001219A page 10 2013 Microchip Technology I
27. roySocket Result ICM 02 03 649 EHC lt INIC 00 B andwidth Status AssignBWlnit FF_AssignBW 0C T otalB w 0F AssignB WFree 0028 ICM 02 03 688 EHC lt INIC 00 B andwidth Status AssignB W nit FF AssignBW 00C T otalB W 0F AssignB WFree 0030 ICM 02 29 133 EHC lt INIC 00 B andwidth Status 4ssignB winit FF 4ssignBw 0C T otalB W 0F AssignBwFree 001C ICM 02 32 690 EHC lt 02F0 AudioAmp 01 Connect StartR esult 01 000001 020304050607080904 0B 0C0D 0E OF 10111213 MCM 02 32 713 EHC gt INIC 00 CreateSocket StartResult PortlD MediaLBPort CfgParam Direction Out DataType SyncDataSo ICM 02 32 722 EHC lt INIC 00 CreateS ocket Result SocketHandle 00 ICM 02 32 740 EHC gt INIC 00 CreateS ocket StartR esult PortID NetworkPort CfgParam Direction In DataT ype SyncData Sock ICM 02 32 754 EHC lt INIC 00 CreateSocket Result SocketHandle 01 ICM 02 32 770 EHC gt INIC 00 ConnectSockets StartResult S ocketH andlelnput 01 SocketHandleOutput 00 ICM 02 32 777 EHC lt INIC 00 ConnectSockets Result ConnectionHandle 00 ICM 02 32 792 EHC gt 02F0 Audiodmp 01 Connect Result 01 MCM 2013 Microchip Technology Inc DS60001219A page 13 Port Message Viewer v6 3 1 4 BC Interpretation Figure 3 11 shows Codec traffic with I2C interpretation FIGURE 3 11 CODEC TRAFFIC WITH I7C INTERPRETATION Time Message Type N 000 00 00 898 898 MIS RX of Local INIC 00 NIState Status len 1 bytes Raw 000 00 00 302 NS CB Device Class is 0
28. s can also be named and will show up in the output An example of the XML device setup file shown in Example 3 1 provides a means for the user to specify the addresses and registers of the devices they are interested in decoding Messages containing the addresses of any devices listed in the device setup XML file in use will be decoded and in its place the device name and register name if any will be shown in the message display window DS60001219A page 14 2013 Microchip Technology Inc Port Message Viewer v6 EXAMPLE 3 1 XML DEVICE SETUP FILE lt devices gt lt device gt lt dev_addr gt 40 lt dev_addr gt lt dev_name gt INIC lt dev_name gt lt registers gt lt registers gt lt device gt lt device gt lt dev_addr gt 48 lt dev_addr gt lt dev_name gt IOC lt dev_name gt lt registers gt lt registers gt lt device gt lt device gt lt dev_addr gt 30 lt dev_addr gt lt dev_name gt CODEC lt dev_name gt lt registers gt lt reg_addr gt 00 lt reg_addr gt lt reg_name gt ClockSettings lt reg_name gt lt reg_addr gt 01 lt reg_addr gt lt reg_name gt I2S_Settings lt reg_name gt lt reg_addr gt 02 lt reg_addr gt lt reg_name gt Power_Settings lt reg_name gt lt reg_addr gt 7F lt reg_addr gt lt reg_name gt Reset lt reg_name gt lt registers gt lt device gt lt device gt lt dev_addr gt A0 lt dev_addr gt lt dev_name gt EEPROM lt dev_name gt
Download Pdf Manuals
Related Search