未验证 提交 52f9079d 编写于 作者: O openharmony_ci 提交者: Gitee

!11066 rename hdc_std to hdc and add drive version

Merge pull request !11066 from liuguang/master
# hdc_std使用指导
# hdc使用指导
hdc_std(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。
hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。
下文将介绍hdc_std的环境准备和常用命令及使用举例。
下文将介绍hdc的环境准备和常用命令及使用举例。
## 环境准备
**hdc_std 工具获取方式:**
**hdc 工具获取方式:**
通过OpenHarmony sdk获取,hdc_std在sdk的toolchains目录下。
通过OpenHarmony sdk获取,hdc在sdk的toolchains目录下。
**使用举例:**
下面以windows侧使用方式举例:
获取windows的sdk,将hdc_std.exe放到磁盘某个位置即可使用。
获取windows的sdk,将hdc.exe放到磁盘某个位置即可使用。
## 注意事项
- 使用hdc_std,如果出现异常,可以尝试通过hdc_std kill命令杀掉hdc_std服务,或者通过hdc_std start -r命令重启服务进程进行解决。
- 使用hdc,如果出现异常,可以尝试通过hdc kill命令杀掉hdc服务,或者通过hdc start -r命令重启服务进程进行解决。
- 如果出现hdc_std list targets获取不到设备信息,通过任务管理器查看是否有hdc_std进程存在,如果进程存在,可以通过杀掉该进程进行解决。
- 如果出现hdc list targets获取不到设备信息,通过任务管理器查看是否有hdc进程存在,如果进程存在,可以通过杀掉该进程进行解决。
## option相关的命令
......@@ -45,12 +45,12 @@ option涉及以下命令:
```
hdc_std -h / hdc_std help
hdc -h / hdc help
```
```
hdc_std -v / hdc_std version
hdc -v / hdc version
```
- **-l 0-5**
......@@ -70,7 +70,7 @@ option涉及以下命令:
使用方法:
```
hdc_std -l5 start
hdc -l5 start
```
- **-t key**
......@@ -88,9 +88,9 @@ option涉及以下命令:
该option需要与具体的操作命令搭配使用,下面以shell命令举例:
hdc_std list targets (获取设备信息)
hdc list targets (获取设备信息)
hdc_std -t _key_ shell (-t后面添加的_key_ 需要替换为上面查询的设备信息)
hdc -t _key_ shell (-t后面添加的_key_ 需要替换为上面查询的设备信息)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 一台开发机可支持多个设备连接,每个设备有其唯一的设备标识,如果通过网络与设备连接,其标识为IP地址:port格式,如果通过USB连接则标识为设备sn号。该命令需要跟随具体操作命令。
......@@ -107,7 +107,7 @@ option涉及以下命令:
使用方法:
```
hdc_std checkserver
hdc checkserver
```
......@@ -138,13 +138,13 @@ list targets[-v]
```
hdc_std list targets
hdc list targets
```
```
hdc_std list targets -v
hdc list targets -v
```
......@@ -168,7 +168,7 @@ hdc_std list targets -v
```
hdc_std target mount
hdc target mount
```
- **target boot**
......@@ -178,7 +178,7 @@ hdc_std list targets -v
```
hdc_std target boot
hdc target boot
```
- **smode [-r]**
......@@ -188,12 +188,12 @@ hdc_std list targets -v
```
hdc_std smode
hdc smode
```
```
hdc_std smode -r
hdc smode -r
```
- **kill [-r]**
......@@ -210,7 +210,7 @@ hdc_std list targets -v
使用方法:
```
hdc_std kill
hdc kill
```
- **start [-r]**
......@@ -227,7 +227,7 @@ hdc_std list targets -v
使用方法:
```
hdc_std start
hdc start
```
......@@ -252,7 +252,7 @@ hdc_std list targets -v
```
hdc_std tconn 192.168.0.100:8710
hdc tconn 192.168.0.100:8710
```
- **tmode usb**
......@@ -270,7 +270,7 @@ hdc_std list targets -v
```
hdc_std tmode usb
hdc tmode usb
```
- **tmode port port-number**
......@@ -288,7 +288,7 @@ hdc_std list targets -v
```
hdc_std tmode port 8710
hdc tmode port 8710
```
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
......@@ -301,7 +301,7 @@ hdc_std list targets -v
```
hdc_std fport tcp:1234 tcp:1080
hdc fport tcp:1234 tcp:1080
```
- **rport remotenode localnode**
......@@ -311,7 +311,7 @@ hdc_std list targets -v
```
hdc_std rport tcp:2080 tcp:2345
hdc rport tcp:2080 tcp:2345
```
- **fport ls**
......@@ -330,7 +330,7 @@ hdc_std list targets -v
```
hdc_std fport ls
hdc fport ls
```
- **fport rm**
......@@ -340,7 +340,7 @@ hdc_std list targets -v
```
hdc_std fport rm tcp:1234 tcp:1080
hdc fport rm tcp:1234 tcp:1080
```
......@@ -365,7 +365,7 @@ hdc_std list targets -v
```
hdc_std file send E:\a.txt /data/local/tmp/a.txt
hdc file send E:\a.txt /data/local/tmp/a.txt
```
- **file recv [-a] remote local**
......@@ -385,7 +385,7 @@ hdc_std list targets -v
```
hdc_std file recv /data/local/tmp/a.txt ./a.txt
hdc file recv /data/local/tmp/a.txt ./a.txt
```
......@@ -412,7 +412,7 @@ hdc_std list targets -v
```
hdc_std install hwadmin.hap
hdc install hwadmin.hap
```
- **uninstall [-k] package**
......@@ -431,7 +431,7 @@ hdc_std list targets -v
```
hdc_std uninstall package
hdc uninstall package
```
......@@ -455,14 +455,14 @@ hdc_std list targets -v
```
hdc_std hilog
hdc hilog
```
清理hilog缓存日志:
```
hdc_std shell "hilog -r"
hdc shell "hilog -r"
```
- **shell [_command_]**
......@@ -480,7 +480,7 @@ hdc_std list targets -v
```
hdc_std shell
hdc shell
```
- **jpid**
......@@ -490,34 +490,37 @@ hdc_std list targets -v
```
hdc_std jpid
hdc jpid
```
## 常见问题
### hdc_std连接不到设备
### hdc连接不到设备
- **现象描述**
执行 "hdc_std list targets"命令后结果为:[Empty]
执行 "hdc list targets"命令后结果为:[Empty]
- **解决方法**
1. 设备没有被识别:
在设备管理器中查看是否有hdc设备,在通用串行总线设备中会有“HDC Device”信息。如果没有,hdc无法连接。此时需要断开并重联PC和OpenHarmony设备之间的USB连接,或者烧写最新的镜像。
2. hdc_std工作异常:
2. hdc工作异常:
可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务,然后再执行hdc list targets查看是否已经可以获取设备信息。
3. hdc_std与设备不匹配:
如果设备烧写的是最新镜像,hdc_std也需要使用最新版本。
3. hdc与设备不匹配:
如果设备烧写的是最新镜像,hdc也需要使用最新版本。
### hdc_std运行不了
### hdc运行不了
- **现象描述**
点击hdc_std.exe文件无法运行。
点击hdc.exe文件无法运行。
- **解决方法**
hdc_std.exe不需要安装,直接放到磁盘上就能使用,也可以添加到环境变量中。通过打开cmd执行hdc_std命令直接使用。
1. 运行环境异常:
linux版本建议ubuntu 18.04以上 64位,其他相近版本也可;libc++.so引用错误请使用ldd/readelf等命令检查库引用 windows版本建议windows10 64位,如果低版本windows winusb库缺失,请使用zadig更新库。对于复合设备,需要使用zadig工具安装libusb-win32驱动。
2. 如何运行hdc.exe:
hdc.exe不需要安装,直接放到磁盘上就能使用,也可以添加到环境变量中。通过打开cmd执行hdc命令直接使用。
### hdc client如何远程访问hdc server
......@@ -529,13 +532,13 @@ hdc_std list targets -v
- **连接步骤**
1. 关闭本地sever:
```
hdc_std kill
hdc kill
```
2. **-s [ip:]port -m** 启动远程server:
```
hdc_std -s severIP:8710 -m
hdc -s severIP:8710 -m
```
3. **-s [ip:]port command** 指定server执行指令:
```
hdc_std -s severIP:8710 list targets
hdc -s severIP:8710 list targets
```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册