diff --git a/README_zh.md b/README_zh.md index 215e03d55c84761f5a1a782d65930ff6898b9ba9..e483ecef21b76cb49e58b34447886cc61f2bd505 100644 --- a/README_zh.md +++ b/README_zh.md @@ -8,10 +8,9 @@ - [1.通过git clone方式下载(建议)](#section161941989591) - [2.通过网页形式下载](#section161941989592) - [3.支持环境](#section161941989593) - - [4.BUG上报](#section161941989594) - - [使用说明](#section129654513264) + - [命令帮助](#section129654513264) -- [相关仓](#section1371113476307) +- [使用问题自查说明](#section1371113476307) - [FAQ](#section1371113476308) ## 简介 @@ -73,14 +72,8 @@ git clone https://gitee.com/projectname/developtools_hdc_standard.git [3.支持环境](#section161941989593) linux版本建议ubuntu 16.04以上 64位,其他相近版本也可;libc++.so引用错误请使用ldd/readelf等命令检查库引用 windows版本建议windows10 64位,如果低版本windows winusb库缺失,请使用zadig更新库。 -[4.BUG上报](#section161941989594) -近期hdc刚开发完成,适配和调整变动较多,如果遇到异常情况,建议按照如下步骤进行排查: -1)首先核对server与daemon版本是否匹配,hdc_std -v, hdcd -v。 -2)更新工程最新的线上代码和预编译文件,是否在后续版本中已解决问题。 -3)规范的和详细的提出issue,我们将尽快跟进。 - -### 使用说明 +### 命令帮助 hdc当前常用命令如下,未尽命令使用hdc -h或者hdc --help查看: @@ -239,11 +232,18 @@ hdc当前常用命令如下,未尽命令使用hdc -h或者hdc --help查看: ``` -## 相关仓 - -研发工具链子系统 - +## 使用问题自查说明 -**developtools\_hdc\_standard** +工具使用过程中碰到问题,可以参考如下流程自助排查: +step1: 先检查pc(host)端hdc_std 和L2设备端hdcd版本是否一致(-v 查看版本); +step1a: 版本不一致请更新使用一致版本再验证; +step1b: 版本一致请继续下面排查step2步骤; +step2: 先检查pc(host)端设备管理器设备信息是否正常(设备是否正常加载显示、驱动、id是否正常); +step2a: 设备管理器设备异常或无设备, 请结合板测试设备端串口下确认下usb部分设备枚举上报是否异常; +step2b: 设备管理器设备正常时, 1)list targets 是否正常;2)hdc_std kill 后重试是否正常; -## FAQ \ No newline at end of file +## FAQ +1. list targets无设备: +请参考上面《使用问题自查说明》小节, 1)检查设备是否连接正常;2)host端设备管理器设备信息是否正常;3)两端工具版本是否一致;4)设备端hdcd是否启动正常; +2. 同样版本windows下正常,linux下无设备:同问题1同样排查步骤,另外注意在root权限下执行; +3. windows版本工具无法执行报错:1)确认git lfs正常并使用git clone下载本工具仓预制二进制文件;2)检查文件大小和版本; 3)友情提示:本工具是控制台命令行下执行即可,不需要安装,不要尝试双击方式运行; \ No newline at end of file