Name |
Date |
Size |
#Lines |
LOC |
||
---|---|---|---|---|---|---|
.. | - | - | ||||
mini/ | 12-May-2024 | - | 536 | 387 | ||
BUILD.gn | D | 12-May-2024 | 1,010 | 26 | 23 | |
LICENSE | D | 12-May-2024 | 10.1 KiB | 178 | 150 | |
README_zh.md | D | 12-May-2024 | 4.1 KiB | 151 | 99 | |
bundle.json | D | 12-May-2024 | 894 | 36 | 35 | |
hidumper.c | D | 12-May-2024 | 7.3 KiB | 218 | 180 |
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