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

, , and other HiSilicon icons are trademarks of HiSilicon Technologies Co., Ltd.

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:

http://www.hisilicon.com

Email:

support@hisilicon.com

 

 


About This Document

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

V100R001

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.


Contents

About This Document iii

1 Overview.. 1-1

1.1 Introduction to the HiProc. 1-1

1.2 Environment Preparations. 1-1

2 GUI and Functions. 2-1

2.1 Debug View Menu. 2-1

2.1.1 Analyzing the Proc Information. 2-1

2.1.2 Stop Analyzing the Proc Information. 2-4

2.1.3 Setting the Interval for Obtaining the Proc Information. 2-4

2.1.4 Obtaining the Binding Relationship. 2-5

2.1.5 Selecting the Binding Relationship. 2-5

2.1.6 Analyzing the Proc File in Offline Mode. 2-5

2.2 List View Menu. 2-6

2.2.1 Recording logmpp. 2-6

2.2.2 Saving the Diagnosis. 2-6

2.2.3 Clearing the Diagnosis. 2-7

2.3 Timeline Menu. 2-8

2.3.1 Running the Timeline. 2-8

2.3.2 Zooming-in the Timeline. 2-9

2.3.3 Zooming-out the Timeline. 2-10

2.3.4 Stopping the Timeline. 2-10

2.3.5 Saving the Timeline Information. 2-10

2.3.6 Displaying the Timeline Information in Offline Mode. 2-10

2.4 ProcInfo Menu. 2-12

2.4.1 Saving the Proc Information. 2-12

2.4.2 Clearing the Proc Information. 2-12

3 FAQ.. 3-13

 


Figures

Figure 1-1 Clicking HiProc. 1-2

Figure 1-2 Creating a Telnet connection. 1-2

Figure 2-1 Selecting the diagnostic level 2-1

Figure 2-2 Module file tree on the Debug View GUI. 2-2

Figure 2-3 Obtaining the binding relationship. 2-2

Figure 2-4 Analyzing the proc information. 2-3

Figure 2-5 Viewing history information. 2-3

Figure 2-6 Stop analyzing the proc information. 2-4

Figure 2-7 Setting the interval for obtaining the proc information. 2-4

Figure 2-8 Obtaining the binding relationship. 2-5

Figure 2-9 Selecting the binding relationship. 2-5

Figure 2-10 Selecting a proc file. 2-6

Figure 2-11 Recording logmpp. 2-6

Figure 2-12 Saving the diagnosis. 2-7

Figure 2-13 Clearing the diagnosis. 2-7

Figure 2-14 Running the timeline. 2-8

Figure 2-15 Configuring the timeline parameters. 2-9

Figure 2-16 Zooming-in the timeline. 2-10

Figure 2-17 Configuring the timeline parameters. 2-11

Figure 2-18 Offline timeline. 2-11

Figure 2-19 Saving the proc information. 2-12

Figure 2-20 Clearing the proc information. 2-12

 


1 Overview

1.1 Introduction to the HiProc

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.

1.2 Environment Preparations

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.

Figure 1-1 Clicking HiProc

 

                               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


2 GUI and Functions

2.1 Debug View Menu

2.1.1 Analyzing the Proc Information

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 Info level (in gray) indicates that the status or parameter is changed and the program is running normally.

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.

l   To select the module mode, click the Module tab, and select the module to be diagnosed, as shown in Figure 2-2.

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

2.1.2 Stop Analyzing the Proc Information

To stop analyzing the proc information, click the Stop button on the Debug View GUI, as shown in Figure 2-6.

Figure 2-6 Stop analyzing the proc information

 

2.1.3 Setting the Interval for Obtaining 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.

2.1.4 Obtaining the Binding Relationship

The current binding relationship is obtained by default.

To obtain the binding relationship, click the Binding Relationship tab, and then the Obtain Binding Relationship button, as shown in Figure 2-8.

Figure 2-8 Obtaining the binding relationship

 

2.1.5 Selecting 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

 

2.1.6 Analyzing the Proc File in Offline Mode

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

2.2 List View Menu

2.2.1 Recording logmpp

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.

Figure 2-11 Recording logmpp

 

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.

2.2.2 Saving the Diagnosis

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

 

2.2.3 Clearing 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

 

2.3 Timeline Menu

2.3.1 Running the Timeline

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

 

2.3.2 Zooming-in the Timeline

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

 

2.3.3 Zooming-out 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.

2.3.4 Stopping the Timeline

To stop running the timeline, click  on the Timeline GUI.

2.3.5 Saving the Timeline Information

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.

2.3.6 Displaying the Timeline Information in Offline Mode

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.

Figure 2-18 Offline timeline

 

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.

2.4 ProcInfo Menu

2.4.1 Saving the Proc 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.

2.4.2 Clearing 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

 

 


3 FAQ

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.