• Home
Name
Date
Size
#Lines
LOC

..--

mini/12-May-2024-536387

BUILD.gnD12-May-20241,010 2623

LICENSED12-May-202410.1 KiB178150

README_zh.mdD12-May-20244.1 KiB15199

bundle.jsonD12-May-2024894 3635

hidumper.cD12-May-20247.3 KiB218180

README_zh.md

1# hiviewdfx_blackbox
2
3-   [简介](#简介)
4-   [目录](#目录)
5-   [hidumper_lite的使用](#hidumper_lite的使用)
6-   [系统调用接口定义](#系统调用接口定义)
7-   [重写接口](#重写接口)
8-   [相关仓](#相关仓)
9
10## 简介
11
12hidumper_lite提供liteOS_M系统下dump接口,帮助开发者提供故障日志、内存、CPU等信息的导出功能。
13
14## 目录
15
16Hiview源代码目录结构如下:
17
18```
19/base/hiviewdfx/hidumper_lite.
20├── hidumper.c                              #AT命令处理过程
21└── mini
22    ├── hidumper_adapter.c                  #hidumper功能函数适配层
23    ├── hidumper_core.c                     #hidumper核心层
24    └── interfaces                          #公共接口文件
25
26```
27
28## hidumper_lite的使用
29
30hidumper_lite在liteOS_M下面是通过AT命令进行数据查询的
31
32- 参数:
33  | 命令格式 | 命令含义 |
34  | -------- | -------- |
35  | AT+HIDUMPER= | 打印出CPU、内存和全部的task使用信息 |
36  | AT+HIDUMPER=-dc | 打印出CPU使用信息 |
37  | AT+HIDUMPER=-dm | 打印出内存使用信息 |
38  | AT+HIDUMPER=-df | 打印出最后的故障日志信息 |
39  | AT+HIDUMPER=-dt | 打印出全部task信息 |
40  | AT+HIDUMPER=-h | 打印出帮助信息 |
41  | AT+HIDUMPER=-ikc | 向内核注入故障 |
42  | AT+HIDUMPER=-m | 以16进制形式打印出全部内存数据 |
43  | AT+HIDUMPER=-m,memstart,memsize | 以16进制形式打印出特定内存区域数据。两个参数,memstart:内存起始地址,memsize:内存大小 |
44
45## 系统调用接口定义
46
47### at_hidumper
48
49```
50int at_hidumper(unsigned int argc, const char **argv)
51```
52
53注入到系统的AT指令处理函数
54
55- 参数:
56  | 成员 | 类型 | 必填 | 说明 |
57  | -------- | -------- | -------- | -------- |
58  | argc | unsigned int | 是 | 输入参数的个数。 |
59  | argv | const char** | 是 | 输入参数的内容 |
60
61
62## 重写接口
63
64实例可以参考hi3861芯片的重写,对应位置为device/soc/hisilicon/hi3861v100/sdk_liteos/components/at/src/hidumper_adapter_impl.c
65
66以下的函数都是需要在不同的芯片下重写的:
67
68### DumpSysInfo
69
70```
71int DumpSysInfo(void);
72```
73
74重写打印系统信息函数。该函数打印当前设备系统信息。
75
76### DumpCpuUsage
77
78```
79int DumpCpuUsage(void);
80```
81
82重写打印CPU使用信息函数。该函数打印当前设备CPU使用信息。
83
84### DumpMemUsage
85
86```
87int DumpMemUsage(void);
88```
89
90重写打印内存使用信息函数。该函数打印当前设备内存使用信息。
91
92### DumpTaskInfo
93
94```
95int DumpTaskInfo(void);
96```
97
98重写打印系统全部Task信息函数。该函数打印系统中全部的task信息。
99
100### DumpFaultLog
101
102```
103int DumpFaultLog(void);
104```
105
106重写打印异常日志信息函数。该函数打印最后保存的日志信息。
107
108### DumpMemRegion
109
110```
111int DumpMemRegion(unsigned long long addr, unsigned long long size)
112```
113
114重写打印指定区域内存数据函数。该函数打印从addr开始一共size这大小的内存区域的数据。
115
116- 参数:
117  | 参数名 | 类型 | 必填 | 说明 |
118  | -------- | -------- | -------- | -------- |
119  | addr | unsigned long long | 是 | 需要查询的内存起始地址 |
120  | size | unsigned long long | 是 | 需要查询的内大小 |
121
122### DumpAllMem
123
124```
125int DumpAllMem(void);
126```
127
128重写打印全部内存数据函数。该函数能打印全部内存数据。
129
130### PlatformHiDumperIinit
131
132```
133int PlatformHiDumperIinit(void);
134```
135
136重写平台hidumper初始化函数。该函数根据不同平台初始化HiDumper的at命令等特性。
137
138## 相关仓
139
140[DFX子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/DFX%E5%AD%90%E7%B3%BB%E7%BB%9F.md)
141
142**hiviewdfx\_hidumper\_lite**
143
144[hiviewdfx\_blackbox](https://gitee.com/openharmony/hiviewdfx_blackbox/blob/master/README_zh.md)
145
146[hiviewdfx\_hilog\_lite](https://gitee.com/openharmony/hiviewdfx_hilog_lite/blob/master/README_zh.md)
147
148[hiviewdfx\_hievent\_lite](https://gitee.com/openharmony/hiviewdfx_hievent_lite/blob/master/README_zh.md)
149
150[hiviewdfx\_hiview\_lite](https://gitee.com/openharmony/hiviewdfx_hiview_lite/blob/master/README_zh.md)
151