Histudio使用手册

HiStudio使用手册

安装

获取Histudio版本

在VMP上获取对应的版本，如下图：

若在VMP上没有权限，可以通过Hi3ms搜索Histudio软件或找海思接口人luzhejun 00266210获取。

安装说明

双击Histudio安装程序，弹出第一个安装欢迎界面：

单击“Next”按钮，即可完成安装。

注意：如果之前安装过，会有之前用户自定义的收藏加等信息，安装时会提示用户这些信息是否覆盖。

启动

主架构界面

Histudio第一次启动界面如下：

如果HiStudio所在的计算机中存在多块网卡或一块网卡绑定多个IP地址时，那么用户必须要通过Connection -> Settings菜单来设置与UE进行通信的IP地址。打开设置窗口后，(1)选择本机上的所有网卡上绑定的所有IP地址都会显示在IP Address列表中，对应的MAC地址显示在MAC Address中，用户选择与UE进行通信的IP地址，(2) 设置正确的UE的IP地址；（3）按OK完成设置。

备注：设置moderm端口

完成连接设之后，一定要断开与UE的连接，然后再重新连接一次，使设置生效。连接

分两种式：Ethernet和COM，如下图

上图为打开LV(Air&Layer)实例和SG(Stat.GUI)组件后的界面示意图。图中标示说明如下：

（1）菜单栏

（2）工具栏（连接功能部分）

（3）工具栏（组件部分）

（4）自定义命令工具栏部分

业务功能简介

业务功能划分

Histudio从业务上支持UE端LOG数据的显示和处理，统计信息的图形化显示和处理，以及各种控制命令的管理，同时支持与第三方程序的连接和数据处理。

LOG信息处理

Histudio支持的LOG数据包括Air Message(空口消息)、Layer Message(层间消息)，Print Message(打印信息)，Event （关键事件）和L1 Message(L1 消息)的处理。

统计可视化界面表现

Histudio对各种观测量进行可视化表现，通过表格和图形的方式，表现上报观测量的趋势信息，方便用户对观测量进行分析；

控制命令管理

Histudio对各种命令进行了统一管理，并根据用户的使用习惯给出两种命令的管理方式，分别是命令可视化组件(CG)和诊断命令行（DCL）两个组件方式。

同时提供了AT命令下发功能，对AT命令进行处理。

自动化测试支持和第三方程序支持

为了支持全系统的自动化测试功能，Histudio提供了GTR-TEST组件，用于管理GTR与Histudio直接的连接、数据转发和数据处理功能，支持自动化测试的各种需求。

为了支持第三方程序，Histudio提供了BAS路测代理功能，可以通过网络方式，支持各种第三方程序，完成数据的中转、处理等功能。

Histudio管理功能

Histudio提供了连接管理、诊断信息输出、上报信息统计等各种管理功能，方便用户使用。

LV (Logging Viewer)功能组件

Lv组件由五部分组成，分别提供五种不同的消息显示:

LTE Air&Layer:抓取PS(协议栈)上报的层间消息(Layer Msg)和空口消息(Air Msg)

检测log是否正在打印

根据需求选择需要记录的消息，勾选好消息后关闭此窗口，然后从新打开该窗口，显示如下图：

保存log，保持为.hlf的文件可以用histudio软件进行回放；

层间消息

HiStudio支持LTE和GU的层间消息上报显示。层间消息主要包括LTE层1，层2，层3及NAS各模块间的消息，GU层1，层2，层3及NAS各模块间的消息，及LTE与GU之间通讯的消息。用以实时查看当前业务运行情况。

层间消息上报是由协议栈业务触发，HiStudio只控制模块开发，控制某块的消息是否上报，不控制具体消息是否上报。

HiStudio可以显示上报消息的名称，发送模块，接收模块，时间戳及消息体中的数据。HiStudio可以根据对应的结构体解析消息体中的数据。并与数据结构一一对应显示。用户可能通过双击界面中的的消息记录，查看消息体中的内容。

HiStudio支持对消息的过滤，查找，导出，设置标签，设置背景色等操作。

空口消息

HiStudio支持LTE和GU的空口消息上报和显示。包括ATTACH,DETACH,TAU,SERVICE等。空口消息上报是由协议栈业务触发，HiStudio不控制具体消息是否上报，HiStudio只能过控制空口总开关来控制空口消息是否上报。

HiStudio可以显示上报消息的名称，发送模块，时间戳及消息体中的数据。HiStudio

可以根据对应的结构体解析消息体中的数据。并与数据结构一一对应显示。用户可以通过双击界面中的的消息记录，查看消息体中的内容。

HiStudio支持对消息的过滤，查找，导出，设置标签，设置背景色等操作。

LTE User Plane:用户面消息；

HiStudio目前只支持4个用户面消息上报显示，分别是：调度请求和回复，上行授权，定时提前信息的上报和显示。

HiStudio可以显示上报消息的名称，时间戳及消息体中的数据。HiStudio可以根据对应的结构体解析消息体中的数据。并与数据结构一一对应显示。用户可能通过双击界面中的消息记录，查看消息体中的内容。

用户面消息是由协议栈业务触发上报，但HiStudio可以控制每个消息是否可以上报到PC侧。

HiStudio支持对消息的过滤，查找，导出，设置标签，设置背景色等操作。

LTE Event：关键事件；

HiStudio支持LTE和GU的搜网，丢网等关键事件上报和显示。

关键事件上报是由协议栈业务触发，HiStudio不控制具体消息是否上报，HiStudio只能过控制关键事件总开关来控制关键事件消息是否上报到PC。

HiStudio可以显示上报消息的名称，时间戳。