Histudio使用手册

Histudio使用手册
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可以显示上报消息的名称,时间戳。

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

LTE Print:打印的消息;

HiStudio支持LTE和GU协议栈各模块的打印信息上报和显示。HiStudio可以解析打印信息,并显示打印信息中的文件名,行号及打印内容。

打印信息上报是由协议栈业务触发,HiStudio不控制具体消息是否上报。HiStudio可以控制单板按钮打印级别上报消息,打印级别包括Error,Worning,Normal,Information,也可以控制各模块开关,按模块上报打印消息。

HiStudio可以显示上报消息的时间戳,模块,打印内容。

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

LTE L1 Message:显示层1的消息(来自DSP)

HiStudio支持LTE和GU的L1消息上报和显示。HiStudio可以解析L1消息中的数据,显示L1消息中显示信噪比、误码率、传输功率等统计值。

消息开关可以通过CG组件下发,触发消息上报及关闭消息上报。同样可以通过CG组件配置消息上报的频率。

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

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

配置命令下发

通过LV组件左侧的Control Panel窗口对日志上报进行配置,勾选上相应的选项或者取消选择相应的选项,然后按下快捷键F5(或者鼠标单击窗口中工具栏图标),手动下发控制命令,达到控制信息上报或者取消上报的目的。

查看消息内容

层间,空口,及用户面数据,能过双击界面中某条消息记录来观察消息上报的具体内容。物理层消息(L1 Message Viewer)通过左键单击消息记录,查看Parse Panel窗口观察消息内容。注意:需要首先打开解析窗口,打开方法是在LV的“L1 Message Viewer”实例中,单击鼠标右键,选择View->Parse Panel,勾选”Show Panel”, “Structure Mode”选项,如下图所示:

显示DSP某条上报原语的内部信息:

按存储目的地打开回放文件

在配置对话框中(右键菜单中,选择Configure),去选择”Auto Save Reply File”选项,保存后关闭设置对话框。

左键拖动回放文件至LV组件,即可在LV组件显示回放文件记录的上报日志。

CG(Command GUI)功能组件

CG组件以图形化界面形式管理各种命令控制命令的下发。

CG组件的启动

可以点击工具栏上的CG按钮()或在菜单栏的Diagnostic下点击Command Viewer 组件即可启动。

CG组件命令打开

在左侧的命令树中,选择需要使用的命令,勾选节点前的即可打开相应的命令,勾选后,左侧节点变为,右侧将会显示相应的结构体视图。

CG的命令收发

以DIAG_INQ_DRX为例,点击DIAG_INQ_DRX左侧的选择框,此时右侧的窗口会显示命令下发时对应的数据结构。

发送

单击REQ窗口前的,可以展开或取消结构体的展开项,在Value 一栏,双击可以修改每个变量对应的值,输入方法支持十进制和十六进制。

在连接UE的情况下,单击对话框右上角的即可完成下发。

接收

发出去的命令如果收到回复,会在CNF窗口显示收到的数据,以数据结构的方式进行显示。如果一条命令执行超时,下发按钮会变为图标。此时可以再次点击该命令重新下发。

SG(Statistics GUI)功能组件

SG组件显示观测量说明

在LTE制式下,SG提供了部分常用观测量的显示功能,如信噪比、误码率、小区能量测量、流量测量等。

小区ID、两天线的RSRP、RSSI、RSRQ、两天线的信噪比、CQI、发送功率等观测量。

吞吐量

Throughput视图以表格方式对协议栈上报的上行、下行流量进行显示。

小区能量测量视图

小区能量测量视图中可以对服务小区、邻小区上报量进行显示,并且提供对服务小区的RSRP、RSRQ、RSSI这三个观测量的图形显示功能。同时可以在表格内显示最多4个List小区以及Detect小区上报的内容。

PCFICH/PDCCH/PHICH Demodulation视图

PCFICH/PDCCH/PHICH Demodulation视图以及PDSCH视图提供了对信道误码率的瞬时值进行观测的功能。而AACU PCFICH/PDCCH/PHICH Demodulation视图提供了累加方式上报的误码率观测功能。

功率控制视图

功率控制视图提供了提供了PUSCH/PUCCH/PRACH/SRS的发射功率及PUSCH和PUCCH的上行路损。还记录了PUSCH和SRS使用的RB数。

MCS

MCS视图分别对上、下行以及码字0和码字1的MCS、Rb值进行显示。同时提供Rb累加和的显示。

CQI/PMI/RI测量周期

CQI/PMI/RI测量周期分别对CQI和Ri的值进行显示。

MIMO模式视图

切换视图

切换视图分别对同频切换,异频切换和异系统切换的成功次数及失败次数进行统计,还记录了平均切换时延和最近一次的切换时延。

RB数视图

RB视图分别统计时隙0和时隙1上RB的使用情况;

NVI(NV Item Browser)NV操作功能组件

NVI组件的启动

可以点击工具栏上的CG按钮()或在菜单栏的Diagnostic下点击NV Browser组件即可启动。

NVI组件主要功能包括:回写操作、新建烧写和升级文件、打开NV 文件、导入和导出NV文件等功能。

NV组件主要功能说明

Nv项的读取

启动Nvi组件后,连接UE情况下,双击界面左边的命令树上任意的Nv节点即可打开该Nv项,此时,右侧会显示该Nv项对应结构体的详细信息。

以0xD100的Nv项为例,读取的信息如下:

Nv项的修改

双击右侧视图Value列中结构体对应的行即可使该单元格变为可编辑状态,编辑过的单元格变为红色。

Nv项的回写

修改完成后,点击工具栏的回写按钮或右键菜单的Write Back回写菜单命令,在弹出的对话框选择“YES“,就会将修改后的参数信息回写到单板中对应的NV项。

导出Nv文件功能

连接UE情况下,在右侧视图的右键菜单中选择Export NV From Ue菜单项,在弹出的对话框中指定导出文件的路径及名称,其他采用默认的设置即可将单板中的Nv文件导出。

AT命令收发功能

AT命令收发功能简介

HiStudio提供AT命令收发工具,供用户发布AT命令到UE及接收单板回返的AT命令执行结果。

AT命令收发功能界面简介

Histudio分析数据功能

保持回放log

导出.csv或.txt文件

RSRP,SINR在LPHY_SG_EMU_ENA_TEST文件中吞吐率在throughput_ind文件中。

相关主题
相关文档
最新文档