未验证 提交 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侧使用方式举例:
获取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相关的命令 ## option相关的命令
...@@ -45,12 +45,12 @@ 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** - **-l 0-5**
...@@ -70,7 +70,7 @@ option涉及以下命令: ...@@ -70,7 +70,7 @@ option涉及以下命令:
使用方法: 使用方法:
``` ```
hdc_std -l5 start hdc -l5 start
``` ```
- **-t key** - **-t key**
...@@ -88,9 +88,9 @@ option涉及以下命令: ...@@ -88,9 +88,9 @@ option涉及以下命令:
该option需要与具体的操作命令搭配使用,下面以shell命令举例: 该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) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 一台开发机可支持多个设备连接,每个设备有其唯一的设备标识,如果通过网络与设备连接,其标识为IP地址:port格式,如果通过USB连接则标识为设备sn号。该命令需要跟随具体操作命令。 > 一台开发机可支持多个设备连接,每个设备有其唯一的设备标识,如果通过网络与设备连接,其标识为IP地址:port格式,如果通过USB连接则标识为设备sn号。该命令需要跟随具体操作命令。
...@@ -107,7 +107,7 @@ option涉及以下命令: ...@@ -107,7 +107,7 @@ option涉及以下命令:
使用方法: 使用方法:
``` ```
hdc_std checkserver hdc checkserver
``` ```
...@@ -138,13 +138,13 @@ list targets[-v] ...@@ -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 ...@@ -168,7 +168,7 @@ hdc_std list targets -v
``` ```
hdc_std target mount hdc target mount
``` ```
- **target boot** - **target boot**
...@@ -178,7 +178,7 @@ hdc_std list targets -v ...@@ -178,7 +178,7 @@ hdc_std list targets -v
``` ```
hdc_std target boot hdc target boot
``` ```
- **smode [-r]** - **smode [-r]**
...@@ -188,12 +188,12 @@ hdc_std list targets -v ...@@ -188,12 +188,12 @@ hdc_std list targets -v
``` ```
hdc_std smode hdc smode
``` ```
``` ```
hdc_std smode -r hdc smode -r
``` ```
- **kill [-r]** - **kill [-r]**
...@@ -210,7 +210,7 @@ hdc_std list targets -v ...@@ -210,7 +210,7 @@ hdc_std list targets -v
使用方法: 使用方法:
``` ```
hdc_std kill hdc kill
``` ```
- **start [-r]** - **start [-r]**
...@@ -227,7 +227,7 @@ hdc_std list targets -v ...@@ -227,7 +227,7 @@ hdc_std list targets -v
使用方法: 使用方法:
``` ```
hdc_std start hdc start
``` ```
...@@ -252,7 +252,7 @@ hdc_std list targets -v ...@@ -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** - **tmode usb**
...@@ -270,7 +270,7 @@ hdc_std list targets -v ...@@ -270,7 +270,7 @@ hdc_std list targets -v
``` ```
hdc_std tmode usb hdc tmode usb
``` ```
- **tmode port port-number** - **tmode port port-number**
...@@ -288,7 +288,7 @@ hdc_std list targets -v ...@@ -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) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
...@@ -301,7 +301,7 @@ hdc_std list targets -v ...@@ -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** - **rport remotenode localnode**
...@@ -311,7 +311,7 @@ hdc_std list targets -v ...@@ -311,7 +311,7 @@ hdc_std list targets -v
``` ```
hdc_std rport tcp:2080 tcp:2345 hdc rport tcp:2080 tcp:2345
``` ```
- **fport ls** - **fport ls**
...@@ -330,7 +330,7 @@ hdc_std list targets -v ...@@ -330,7 +330,7 @@ hdc_std list targets -v
``` ```
hdc_std fport ls hdc fport ls
``` ```
- **fport rm** - **fport rm**
...@@ -340,7 +340,7 @@ hdc_std list targets -v ...@@ -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 ...@@ -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** - **file recv [-a] remote local**
...@@ -385,7 +385,7 @@ hdc_std list targets -v ...@@ -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 ...@@ -412,7 +412,7 @@ hdc_std list targets -v
``` ```
hdc_std install hwadmin.hap hdc install hwadmin.hap
``` ```
- **uninstall [-k] package** - **uninstall [-k] package**
...@@ -431,7 +431,7 @@ hdc_std list targets -v ...@@ -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 ...@@ -455,14 +455,14 @@ hdc_std list targets -v
``` ```
hdc_std hilog hdc hilog
``` ```
清理hilog缓存日志: 清理hilog缓存日志:
``` ```
hdc_std shell "hilog -r" hdc shell "hilog -r"
``` ```
- **shell [_command_]** - **shell [_command_]**
...@@ -480,7 +480,7 @@ hdc_std list targets -v ...@@ -480,7 +480,7 @@ hdc_std list targets -v
``` ```
hdc_std shell hdc shell
``` ```
- **jpid** - **jpid**
...@@ -490,34 +490,37 @@ hdc_std list targets -v ...@@ -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. 设备没有被识别: 1. 设备没有被识别:
在设备管理器中查看是否有hdc设备,在通用串行总线设备中会有“HDC Device”信息。如果没有,hdc无法连接。此时需要断开并重联PC和OpenHarmony设备之间的USB连接,或者烧写最新的镜像。 在设备管理器中查看是否有hdc设备,在通用串行总线设备中会有“HDC Device”信息。如果没有,hdc无法连接。此时需要断开并重联PC和OpenHarmony设备之间的USB连接,或者烧写最新的镜像。
2. hdc_std工作异常: 2. hdc工作异常:
可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务,然后再执行hdc list targets查看是否已经可以获取设备信息。 可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务,然后再执行hdc list targets查看是否已经可以获取设备信息。
3. hdc_std与设备不匹配: 3. hdc与设备不匹配:
如果设备烧写的是最新镜像,hdc_std也需要使用最新版本。 如果设备烧写的是最新镜像,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 ### hdc client如何远程访问hdc server
...@@ -529,13 +532,13 @@ hdc_std list targets -v ...@@ -529,13 +532,13 @@ hdc_std list targets -v
- **连接步骤** - **连接步骤**
1. 关闭本地sever: 1. 关闭本地sever:
``` ```
hdc_std kill hdc kill
``` ```
2. **-s [ip:]port -m** 启动远程server: 2. **-s [ip:]port -m** 启动远程server:
``` ```
hdc_std -s severIP:8710 -m hdc -s severIP:8710 -m
``` ```
3. **-s [ip:]port command** 指定server执行指令: 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.
先完成此消息的编辑!
想要评论请 注册