|
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
HiProc User Guide
|
||
Issue |
02 |
|
Date |
2015-09-20 |
|
|
||
Copyright © HiSilicon Technologies Co., Ltd. 2015. All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means without prior written consent of HiSilicon Technologies Co., Ltd.
Trademarks and Permissions
All other trademarks and trade names mentioned in this document are the property of their respective holders.
Notice The purchased products, services and features are stipulated by the contract made between HiSilicon and the customer. All or part of the products, services and features described in this document may not be within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information, and recommendations in this document are provided "AS IS" without warranties, guarantees or representations of any kind, either express or implied. The information in this document is subject to change without notice. Every effort has been made in the preparation of this document to ensure accuracy of the contents, but all statements, information, and recommendations in this document do not constitute a warranty of any kind, express or implied. |
HiSilicon Technologies Co., Ltd. |
|
Address: |
Huawei Industrial Base Bantian, Longgang Shenzhen 518129 People's Republic of China |
Website: |
|
Email: |
Purpose
This document provides guidance on obtaining, displaying, and making intelligent analysis of the proc information, dynamically displaying system parameters on the timeline, and recording logmpp.
Related Versions
The following table lists the product versions related to this document.
Product Name |
Version |
Hi3535 |
|
Hi3521A |
V100R001 |
Intended Audience
This document is intended for:
l Technical support engineers
l Software development engineers
Change History
Changes between document issues are cumulative. Therefore, the latest document issue contains all changes made in previous issues.
Issue 02 (2015-09-20)
This issue is the second official release, which incorporates the following changes:
The contents related to the Hi3521A are added.
In section 2.3.1, the description of timeline parameter configuration is added.
In section 2.3.5, the description of saving the timeline information is added.
In section 2.3.6, the description of analyzing the timeline information in offline mode is added.
Issue 01 (2015-05-05)
This issue is the first official release.
1.1 Introduction to the HiProc
2.1.1 Analyzing the Proc Information
2.1.2 Stop Analyzing the Proc Information
2.1.3 Setting the Interval for Obtaining the Proc Information
2.1.4 Obtaining the Binding Relationship
2.1.5 Selecting the Binding Relationship
2.1.6 Analyzing the Proc File in Offline Mode
2.3.3 Zooming-out the Timeline
2.3.5 Saving the Timeline Information
2.3.6 Displaying the Timeline Information in Offline Mode
2.4.1 Saving the Proc Information
2.4.2 Clearing the Proc Information
Figures
Figure 1-2 Creating a Telnet connection
Figure 2-1 Selecting the diagnostic level
Figure 2-2 Module file tree on the Debug View GUI
Figure 2-3 Obtaining the binding relationship
Figure 2-4 Analyzing the proc information
Figure 2-5 Viewing history information
Figure 2-6 Stop analyzing the proc information
Figure 2-7 Setting the interval for obtaining the proc information
Figure 2-8 Obtaining the binding relationship
Figure 2-9 Selecting the binding relationship
Figure 2-10 Selecting a proc file
Figure 2-12 Saving the diagnosis
Figure 2-13 Clearing the diagnosis
Figure 2-14 Running the timeline
Figure 2-15 Configuring the timeline parameters
Figure 2-16 Zooming-in the timeline
Figure 2-17 Configuring the timeline parameters
Figure 2-19 Saving the proc information
Figure 2-20 Clearing the proc information
The HiProc is a tool for capturing logs, making intelligent analysis of logs, and displaying system parameters on the timeline. It provides the following functions:
l Obtains and displays the proc information.
l Makes intelligent analysis of the proc information.
l Records logmpp.
l Displays the CPU, USR, system, I/O, double data rate (DDR), video buffer (VB), video decoder (VDEC), video encoder (VENC), memory (MEM), and media_men information on the timeline.
Before you use the HiProc, perform the following steps:
Step 1 Copy HiTool-BVT-X.X.X.zip (in $SDK_DIR/tools/windows/HiTool) to a local hard disk drive on a PC that runs Windows 7 or Windows XP.
Step 2 Preinstall JRE 1.6 (jre-6u1-windows-i586-p); otherwise, the HiTool may fail to run properly. You can download JRE 1.6 from http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase6-419409.html.
Step 3 Decompress HiTool-BVT-X.X.X.zip, and double-click HiTool.exe.
Step 4 Configure the IP address of the board.
Step 5 Run the services that need to be debugged.
Step 6 Choose the Hi3535 chip, and click HiProc, as shown in Figure 1-1.
Step 7
Click (connection manager), select Telnet from the Connector Type drop-down list, set Host to the IP address of the board, and click
to
establish a connection, as shown in Figure 1-2.
Figure 1-2 Creating a Telnet connection
The 1280 x 1024 monitor resolution is recommended.
----End
To cyclically obtain and make intelligent analysis of the proc information on the board, perform the following steps:
Step 1 Select the diagnostic level on the Debug View GUI, as shown in Figure 2-1.
Figure 2-1 Selecting the diagnostic level
There are three error levels: Info, Warning, and Error.
l Information at the Warning level (in yellow) indicates that an alarm is reported when the program is running. In this case, the program may be abnormal or normal.
l Information at the Error level (in red) indicates that an error occurs when the program is running.
Information at the Info level contains all information at the Info, Warning, and Error levels. Information at the Warning level contains all information at the Warning and Error levels. Information at the Error level contains only information at the Error level.
Step 2 Select a diagnostic mode.
Figure 2-2 Module file tree on the Debug View GUI
If the Select All check box in Figure 2-3 is selected, all modules or binding relationships on the current page are selected.
l To select the binding relationship mode, click the Binding Relationship tab and then the Obtain Binding Relationship button, and select the pipelines to be diagnosed, as shown in Figure 2-3.
Figure 2-3 Obtaining the binding relationship
There are two diagnostic modes: module mode and binding relationship mode.
Step 3 Click the run button to start the analysis, as shown in Figure 2-4.
Figure 2-4 Analyzing the proc information
l Click the run button only after a connection is established and a module or binding relationship is selected.
l On the List View GUI, only the latest 20 pieces of information of a list item are displayed on the right. To view data before the 20 pieces of information, double-click the list item.
Figure 2-5 shows the history information before the 20 pieces of information.
Figure 2-5 Viewing history information
----End
Figure 2-6 Stop analyzing the proc information
The default interval for obtaining the proc information is 1000 ms. To set the interval, click the Set the refresh cycle button on the Debug View GUI, and set the interval in the displayed dialog box, as shown in Figure 2-7. Then the proc information is obtained based on the configured interval.
Figure 2-7 Setting the interval for obtaining the proc information
The minimum value of the interval is 200 ms, and the maximum value of the interval is 999,999 ms.
The current binding relationship is obtained by default.
Figure 2-8 Obtaining the binding relationship
Select the pipelines to be diagnosed on the Binding Relationship tab page, as shown in Figure 2-9.
Figure 2-9 Selecting the binding relationship
To analyze the proc file in offline mode, perform the following steps:
Step 1 Select Offline analysis, and click Browse to select a proc file, as shown in Figure 2-10.
Figure 2-10 Selecting a proc file
Step 2 Click Run on the Debug View GUI.
The offline analysis is performed only after the corresponding module is selected.
----End
To save the logmpp
error information, click on the List View GUI, select a file, and enter the file
name, as shown in Figure 2-11.
l The logmpp can be recorded only after a connection is established.
l
To view the recording result, click on
the List View GUI to stop recording logmpp.
This function is used to save the diagnosis of the proc information analysis in the CSV file.
To save the diagnosis, click on the List
View GUI, select a path, and enter the file name or directly select an
existing file, as shown in Figure 2-12.
Figure 2-12 Saving the diagnosis
To clear the
diagnosis of the proc information analysis, click on
the List View GUI, as shown in Figure 2-13.
Figure 2-13 Clearing the diagnosis
This function is used to display the CPU, USR, SYSTEM, I/O, DDR, VB, VDEC, VENC, and MEM information on the timeline.
Step 1
To run the timeline, click on the Timeline
GUI, as shown in Figure 2-14.
Figure 2-14 Running the timeline
Table 2-1 describes the parameters in Figure 2-14.
Table 2-1 Parameter description
Attribute |
Unit |
Description |
CPU, USR, SYSTEM, IO, DDR |
% |
Field values in the CPU information |
VB (MinFree Num) |
Number |
Value of the MinFree field in the VB proc information |
VDEC(fps) |
fps |
Value of the fps field in the VDEC proc information |
VENC(fps) |
fps |
Value of the FrameRate field in the VENC proc information |
MEM(MemFree KB) |
KB |
Value of the MemFree field in the MEMINFO information |
MEDIA_MEN(remain KB) |
KB |
Value of the remain field in the MEDIA-MEN information |
l Property indicates the attribute.
l Value indicates the value of the attribute.
l When the mouse cursor moves along the timeline, the property data on the right of the GUI changes accordingly. If the proper data corresponding to a specific point on the timeline exceeds the current page, you can click this point. Then the property data stops changing, and you can view all the property data by dragging the scroll bar. After finishing viewing the data, click the point again. Then the property data continues to change when the mouse cursor moves along the timeline.
Step 2 Configure the timeline parameters Duration and Timeline Chart, and click OK. The value range of Duration is 5−30 minutes. At most three timeline charts can be selected. See Figure 2-15.
Figure 2-15 Configuring the timeline parameters
Move the mouse cursor to the data graph, click to select the region that needs to be zoomed-in, and release the left button. Then the selected region is zoomed-in. See Figure 2-16.
Figure 2-16 Zooming-in the timeline
Move the mouse cursor to the data graph, hold down the left button and drag the mouse cursor to the left. Then the timeline is zoomed-out.
To stop running the timeline, click on
the Timeline GUI.
To save information about the running
timeline, click on the Timeline
GUI, and select a save path and input a file name, or directly select an
existing file.
This function is used to parse the timeline file saved by the HiProc tool and display the timeline information in the file.
To display the timeline information in offline mode, perform the following steps:
Step 1
Click on the Timeline
GUI.
Step 2 Configure the timeline parameters, as shown in Figure 2-17.
1. Select Offline, and click Browse to select the timeline file saved by the HiProc tool.
2. Enter 10 in the Duration text box.
3. In the Timeline Chart area, select CPU, VB, and VDEC.
Figure 2-17 Configuring the timeline parameters
Step 3 Click OK after the timeline parameters are configured. Then the timeline information is displayed in offline mode, as shown in Figure 2-18.
l The offline timeline can be used when the telnet connection is not established.
l If the length of the offline timeline information is greater than the display time on the GUI, you can click Next or Last to view more information.
To save the proc
information, click on the ProcInfo GUI, select a file path, and enter the
file name, as shown in Figure 2-19.
Figure 2-19 Saving the proc information
To view the saved
proc information, click on the ProcInfo GUI
to stop saving the proc information.
To clear the proc information, click on
the ProcInfo GUI, as shown in Figure 2-20.
Figure 2-20 Clearing the proc information
Q: What do I do if the displayed diagnosis information cannot be understood?
A: Check whether the parameter configuration of the related module is correct by referring to the HiMPP V3.0 Media Processing Software Development Reference.