mirror of
https://gitee.com/openharmony/developtools_hdc
synced 2024-11-23 07:02:43 +00:00
change name hdc_std to hdc
Signed-off-by: leiguangyu <leiguangyu@huawei.com> Change-Id: If61b48e20ff6f3dd05dcefae5aa6a79924f0f655
This commit is contained in:
leiguangyu
parent
5c4043658e
commit
bafe36ac5a
4
BUILD.gn
4
BUILD.gn
@ -144,7 +144,7 @@ ohos_executable("hdcd") {
|
||||
part_name = "hdc"
|
||||
}
|
||||
|
||||
ohos_executable("hdc_std") {
|
||||
ohos_executable("hdc") {
|
||||
use_exceptions = true
|
||||
ldflags = []
|
||||
libs = []
|
||||
@ -242,7 +242,7 @@ ohos_executable("hdc_std") {
|
||||
|
||||
group("hdc_target") {
|
||||
deps = [
|
||||
":hdc_std",
|
||||
":hdc",
|
||||
":hdcd",
|
||||
]
|
||||
}
|
||||
|
||||
@ -10,7 +10,7 @@
|
||||
|
||||
## Introduction<a name="section662115419449"></a>
|
||||
|
||||
HDC (OpenHarmony Device Connector) is a command-line tool for developers to connect and debug the device. The PC-side development machine uses the command-line tool hdc_std (for convenience, collectively referred to as hdc below). This tool needs to support deployment on Windows/Linux /Mac and other systems to connect and debug communication with OpenHarmony devices (or simulators). The PC-side hdc tool needs to release corresponding versions for the above development machine operating system platforms, and the device-side hdc daemon needs to follow the device image release including support for the simulator. The following will introduce the commonly used commands and usage examples of hdc.
|
||||
HDC (OpenHarmony Device Connector) is a command-line tool for developers to connect and debug the device. The PC-side development machine uses the command-line tool hdc (for convenience, collectively referred to as hdc below). This tool needs to support deployment on Windows/Linux /Mac and other systems to connect and debug communication with OpenHarmony devices (or simulators). The PC-side hdc tool needs to release corresponding versions for the above development machine operating system platforms, and the device-side hdc daemon needs to follow the device image release including support for the simulator. The following will introduce the commonly used commands and usage examples of hdc.
|
||||
|
||||
## Architecture<a name="section15908143623714"></a>
|
||||
|
||||
@ -41,7 +41,7 @@ Compilation steps of hdc pc executable file:
|
||||
|
||||
1. Compile command: Please refer to https://gitee.com/openharmony/build/blob/master/README_zh.md to compile the sdk instructions, execute the specified sdk compile command to compile the entire sdk, hdc will be compiled Pack it inside.
|
||||
|
||||
2. Compile: Run the sdk compilation command adjusted above on the target development machine, and the normal compilation of hdc_std will be output to the relevant directory of the sdk platform; Note: Only the windows/linux version tools can be compiled in the ubuntu environment, and the mac version needs to be on the macos development machine Compile.
|
||||
2. Compile: Run the sdk compilation command adjusted above on the target development machine, and the normal compilation of hdc will be output to the relevant directory of the sdk platform; Note: Only the windows/linux version tools can be compiled in the ubuntu environment, and the mac version needs to be on the macos development machine Compile.
|
||||
|
||||
|
||||
### Getting instructions on pc<a name="section129654513263"></a>
|
||||
@ -58,7 +58,7 @@ For compilation, please refer to the separate section above. Prebuilt is no long
|
||||
|
||||
[3. Support operating environment](#section161941989593)
|
||||
|
||||
The linux version is recommended to be 64-bit above ubuntu 16.04, and other similar versions are also available; libc++.so quotes errors, please use ldd/readelf and other commands to check the library. Windows version is recommended. Windows 10 64-bit is recommended. If the lower version of the windows winusb library is missing, please use zadig to update the library. .
|
||||
The linux version is recommended to be 64-bit above ubuntu 16.04, and other similar versions are also available; libc++.so quotes errors, please use ldd/readelf and other commands to check the library. Windows version is recommended. Windows 10 64-bit is recommended. If the lower version of the windows winusb library is missing, please use zadig to update the library. .
|
||||
|
||||
## More help and docs<a name="section129654513264"></a>
|
||||
|
||||
|
||||
92
README_zh.md
92
README_zh.md
@ -13,13 +13,13 @@
|
||||
|
||||
## 简介<a name="section662115419449"></a>
|
||||
|
||||
HDC（OpenHarmony Device Connector） 是为开发人员提供的用于设备连接调试的命令行工具，pc端开发机使用命令行工具hdc_std，该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备（或模拟器）进行连接调试通信。PC端hdc_std工具需要针对以上开发机操作系统平台分别发布相应的版本，设备端hdc daemon需跟随设备镜像发布包括对模拟器进行支持。下文将介绍hdc_std的常用命令及使用举例。
|
||||
HDC（OpenHarmony Device Connector） 是为开发人员提供的用于设备连接调试的命令行工具，pc端开发机使用命令行工具hdc，该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备（或模拟器）进行连接调试通信。PC端hdc工具需要针对以上开发机操作系统平台分别发布相应的版本，设备端hdc daemon需跟随设备镜像发布包括对模拟器进行支持。下文将介绍hdc的常用命令及使用举例。
|
||||
|
||||
## 架构<a name="section15908143623714"></a>
|
||||
|
||||
hdc主要有三部分组成：
|
||||
|
||||
1. hdc client部分：运行于开发机上的客户端，用户可以在开发机命令终端（windows cmd/linux shell）下请求执行相应的hdc_std命令，运行于开发机器，其它的终端调试IDE也包含hdc client。
|
||||
1. hdc client部分：运行于开发机上的客户端，用户可以在开发机命令终端（windows cmd/linux shell）下请求执行相应的hdc命令，运行于开发机器，其它的终端调试IDE也包含hdc client。
|
||||
|
||||
2. hdc server部分：作为后台进程也运行于开发机器，server管理client和设备端daemon之间通信包括连接的复用、数据通信包的收发，以及个别本地命令的直接处理。
|
||||
|
||||
@ -32,9 +32,9 @@ hdc主要有三部分组成：
|
||||
├── hdc # hdc代码目录
|
||||
│ └── src
|
||||
│ ├── common # 设备端和host端公用的代码目录
|
||||
│ ├── daemon # 设备端的代码目录
|
||||
│ ├── daemon # 设备端的代码目录
|
||||
│ ├── host # host端的代码目录
|
||||
│ └── test # 测试用例的代码目录
|
||||
│ └── test # 测试用例的代码目录
|
||||
```
|
||||
|
||||
### pc端编译说明<a name="section129654513262"></a>
|
||||
@ -42,9 +42,9 @@ hdc主要有三部分组成：
|
||||
|
||||
hdc pc端可执行文件编译步骤：
|
||||
|
||||
1. 编译命令：编译sdk命令 请参考https://gitee.com/openharmony/build/blob/master/README_zh.md 仓编译sdk说明， 执行其指定的sdk编译命令来编译整个sdk， hdc_std会被编译打包到里面。
|
||||
1. 编译命令：编译sdk命令 请参考https://gitee.com/openharmony/build/blob/master/README_zh.md 仓编译sdk说明， 执行其指定的sdk编译命令来编译整个sdk， hdc会被编译打包到里面。
|
||||
|
||||
2. 编译：在目标开发机上运行上面调整好的sdk编译命令， 正常编译hdc_std会输出到sdk平台相关目录下； 注意： ubuntu环境下只能编译windows/linux版本工具，mac版需要在macos开发机上编译。
|
||||
2. 编译：在目标开发机上运行上面调整好的sdk编译命令， 正常编译hdc会输出到sdk平台相关目录下； 注意： ubuntu环境下只能编译windows/linux版本工具，mac版需要在macos开发机上编译。
|
||||
|
||||
### pc端获取说明<a name="section129654513263"></a>
|
||||
|
||||
@ -66,7 +66,7 @@ linux版本建议ubuntu 18.04以上 64位，其他相近版本也可；libc++.so
|
||||
### Linux端USB设备权限说明<a name="section129654513264"></a>
|
||||
|
||||
|
||||
在Linux下在非root权限下使用hdc_std会出现无法找到设备的情况，此问题原因为用户USB操作权限问题，解决方法如下：
|
||||
在Linux下在非root权限下使用hdc会出现无法找到设备的情况，此问题原因为用户USB操作权限问题，解决方法如下：
|
||||
|
||||
1. 开启非root用户USB设备操作权限
|
||||
该操作方法简单易行，但是可能存在潜在安全问题，请根据使用场景自行评估
|
||||
@ -76,7 +76,7 @@ linux版本建议ubuntu 18.04以上 64位，其他相近版本也可；libc++.so
|
||||
2. 永久修改 USB 设备权限
|
||||
1）使用lsusb命令找出USB设备的vendorID和productID
|
||||
2）创建一个新的udev规则
|
||||
|
||||
|
||||
编辑UDEV加载规则，用设备的"idVendor"和"idProduct"来替换默认值。MODE="0666"表示USB设备的权限
|
||||
GROUP代表用户组，要确保此时登录的系统用户在该用户组中
|
||||
可用 "usermod -a -G username groupname" 将用户添加到用户组中
|
||||
@ -90,14 +90,14 @@ linux版本建议ubuntu 18.04以上 64位，其他相近版本也可；libc++.so
|
||||
```
|
||||
3. su 切换到root用户下运行测试程序
|
||||
```
|
||||
sudo hdc_std list targets
|
||||
sudo hdc list targets
|
||||
```
|
||||
|
||||
### 命令帮助<a name="section129654513265"></a>
|
||||
|
||||
hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --help查看：
|
||||
hdc当前常用命令如下，未尽命令使用hdc -h或者hdc --help查看：
|
||||
|
||||
**表 1** hdc_std常用命令列表
|
||||
**表 1** hdc常用命令列表
|
||||
|
||||
<table><thead align="left"><tr id="row149291357182511"><th class="cellrowborder" valign="top" width="50%" id="mcps1.2.3.1.1"><p id="p14423184344212"><a name="p14423184344212"></a><a name="p14423184344212"></a>Option</p>
|
||||
</th>
|
||||
@ -108,73 +108,73 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
<tbody><tr id="row139291857142520"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p1042344310428"><a name="p1042344310428"></a><a name="p1042344310428"></a>-t <em id="i198036018011"><a name="i198036018011"></a><a name="i198036018011"></a>key</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p19423174317428"><a name="p19423174317428"></a><a name="p19423174317428"></a>用于<span>指定连接该指定设备识Key</span></p>
|
||||
<p id="p2014511479313"><a name="p2014511479313"></a><a name="p2014511479313"></a>举例：hdc_std -t *****(设备id) shell</p>
|
||||
<p id="p2014511479313"><a name="p2014511479313"></a><a name="p2014511479313"></a>举例：hdc -t *****(设备id) shell</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row1092965782514"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p04231743194215"><a name="p04231743194215"></a><a name="p04231743194215"></a>-s <em id="i510618125015"><a name="i510618125015"></a><a name="i510618125015"></a>socket</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p5424134314429"><a name="p5424134314429"></a><a name="p5424134314429"></a>用于<span>指定服务监听的socket配置</span></p>
|
||||
<p id="p1599174953215"><a name="p1599174953215"></a><a name="p1599174953215"></a>举例：hdc_std -s ip:port</p>
|
||||
<p id="p1599174953215"><a name="p1599174953215"></a><a name="p1599174953215"></a>举例：hdc -s ip:port</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row4929185718255"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p17424204354216"><a name="p17424204354216"></a><a name="p17424204354216"></a>-h/help -v/version</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p742444364214"><a name="p742444364214"></a><a name="p742444364214"></a><span>用于显示hdc_std相关的帮助、版本信息</span></p>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p742444364214"><a name="p742444364214"></a><a name="p742444364214"></a><span>用于显示hdc相关的帮助、版本信息</span></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row4929185718355"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p17424204354316"><a name="p17424204354316"></a><a name="p17424204354316"></a>-l 0-5</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p742444364314"><a name="p742444364314"></a><a name="p742444364314"></a><span>用于指定运行时日志等级</span></p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc_std -l5 start</p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc -l5 start</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row4929185718335"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p17424204354336"><a name="p17424204354336"></a><a name="p17424204354336"></a>checkserver</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p742444364334"><a name="p742444364334"></a><a name="p742444364334"></a><span>用于获取client-server版本</span></p>
|
||||
<p id="p23801376341"><a name="p23801376341"></a><a name="p23801376341"></a>举例： hdc_std checkserver </p>
|
||||
<p id="p23801376341"><a name="p23801376341"></a><a name="p23801376341"></a>举例： hdc checkserver </p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row169301574251"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p13424743134216"><a name="p13424743134216"></a><a name="p13424743134216"></a>list targets[-v]</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p6424643164211"><a name="p6424643164211"></a><a name="p6424643164211"></a><span>显示所有已经连接的目标设备列表</span>，-v选项显示详细信息</p>
|
||||
<p id="p423202318349"><a name="p423202318349"></a><a name="p423202318349"></a>举例： hdc_std list targets</p>
|
||||
<p id="p423202318349"><a name="p423202318349"></a><a name="p423202318349"></a>举例： hdc list targets</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row139301957122519"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p8424164318423"><a name="p8424164318423"></a><a name="p8424164318423"></a>target mount</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p13424154324215"><a name="p13424154324215"></a><a name="p13424154324215"></a><span>以读写模式挂载/vendor、/data等分区，因为安全性问题，需要挂在根目录或者/system分区</br>请单独使用'hdc_std shell mount -o rw,remount /'等命令</span></p>
|
||||
<p id="p23801376351"><a name="p23801376351"></a><a name="p23801376351"></a>举例： hdc_std target mount</p>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p13424154324215"><a name="p13424154324215"></a><a name="p13424154324215"></a><span>以读写模式挂载/vendor、/data等分区，因为安全性问题，需要挂在根目录或者/system分区</br>请单独使用'hdc shell mount -o rw,remount /'等命令</span></p>
|
||||
<p id="p23801376351"><a name="p23801376351"></a><a name="p23801376351"></a>举例： hdc target mount</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row139301957122511"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p8424164318421"><a name="p8424164318421"></a><a name="p8424164318421"></a>target boot</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p13424154324211"><a name="p13424154324211"></a>重启设备</p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc_std target boot</p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc target boot</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row5930657142518"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p1642534318425"><a name="p1642534318425"></a><a name="p1642534318425"></a>smode [-r]</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p44253434422"><a name="p44253434422"></a><a name="p44253434422"></a>授予后台服务进程root权限， 使用-r参数取消授权</p>
|
||||
<p id="p9806102118436"><a name="p9806102118436"></a><a name="p9806102118436"></a>举例： hdc_std smode</p>
|
||||
<p id="p9806102118436"><a name="p9806102118436"></a><a name="p9806102118436"></a>举例： hdc smode</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row893010573254"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p1842544334210"><a name="p1842544334210"></a><a name="p1842544334210"></a>kill [-r]</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p11425543124210"><a name="p11425543124210"></a><a name="p11425543124210"></a><span>终止hdc服务进程</span>, -r选项会触发再次重启hdc server</p>
|
||||
<p id="p162862374437"><a name="p162862374437"></a><a name="p162862374437"></a>举例： hdc_std kill</p>
|
||||
<p id="p162862374437"><a name="p162862374437"></a><a name="p162862374437"></a>举例： hdc kill</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row865473444617"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p5655334184610"><a name="p5655334184610"></a><a name="p5655334184610"></a>start [-r]</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p819155019464"><a name="p819155019464"></a><a name="p819155019464"></a><span>启动hdc服务进程</span>, -r选项会触发重启hdc server</p>
|
||||
<p id="p219115074615"><a name="p219115074615"></a><a name="p219115074615"></a>举例： hdc_std start</p>
|
||||
<p id="p219115074615"><a name="p219115074615"></a><a name="p219115074615"></a>举例： hdc start</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row1493015702512"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p1542610433424"><a name="p1542610433424"></a><a name="p1542610433424"></a>tconn <em id="i82358142025"><a name="i82358142025"></a><a name="i82358142025"></a>host</em>[:<em id="i860817161021"><a name="i860817161021"></a><a name="i860817161021"></a>port</em>][-remove]</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p17426174384210"><a name="p17426174384210"></a><a name="p17426174384210"></a>通过【ip地址：端口号】来指定连接的设备</p>
|
||||
<p id="p15653482487"><a name="p15653482487"></a><a name="p15653482487"></a>使用TCP模式连接设备，需在USB模式工作下使用tmode tcp切换至TCP工作模式，或者在<br>系统属性值中设置persist.hdc.mode属性值为tcp，如果需要监听固定TCP端口需要再设置<br>persist.hdc.port的端口号，反之则TCP监听端口随机</p>
|
||||
<p id="p15653482488"><a name="p15653482488"></a><a name="p15653482488"></a>举例： hdc_std tconn 192.168.0.100:10178</p>
|
||||
<p id="p15653482488"><a name="p15653482488"></a><a name="p15653482488"></a>举例： hdc tconn 192.168.0.100:10178</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row193125772516"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p542613431429"><a name="p542613431429"></a><a name="p542613431429"></a>tmode usb</p>
|
||||
@ -190,25 +190,25 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
<tr id="row1157737165213"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p442704315428"><a name="p442704315428"></a><a name="p442704315428"></a>file send<em id="i34274438428"><a name="i34274438428"></a><a name="i34274438428"></a> </em><em id="i6958481309"><a name="i6958481309"></a><a name="i6958481309"></a>local remote</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p12427114316425"><a name="p12427114316425"></a><a name="p12427114316425"></a><span>从host端发送文件至设备</span>端</p>
|
||||
<p id="p292614408162"><a name="p292614408162"></a><a name="p292614408162"></a>举例： hdc_std file send E:\a.txt /data/local/tmp/a.txt</p>
|
||||
<p id="p292614408162"><a name="p292614408162"></a><a name="p292614408162"></a>举例： hdc file send E:\a.txt /data/local/tmp/a.txt</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row8748171465317"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p7427164310425"><a name="p7427164310425"></a><a name="p7427164310425"></a>file recv [-a] <em id="i1880435111020"><a name="i1880435111020"></a><a name="i1880435111020"></a>remote local</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p19427143174220"><a name="p19427143174220"></a><a name="p19427143174220"></a><span>从设备端拉出文件至本地</span>host端</p>
|
||||
<p id="p191761424101713"><a name="p191761424101713"></a><a name="p191761424101713"></a>举例： hdc_std file recv /data/local/tmp/a.txt ./a.txt</p>
|
||||
<p id="p191761424101713"><a name="p191761424101713"></a><a name="p191761424101713"></a>举例： hdc file recv /data/local/tmp/a.txt ./a.txt</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row1973583819559"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p20428943104259"><a name="p20428943104259"></a><a name="p20428943104259"></a>fport <em id="i84129581558"><a name="i84129581558"></a><a name="i84129581558"></a>localnode remotenode</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p0428144314459"><a name="p0428144314459"></a><a name="p0428144314459"></a><span>端口转发</span><span id="text442834344259"><a name="text442834344259"></a><a name="text442834344259"></a>主机端口 转发数据到 设备侧端口</span></p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc_std fport tcp:1234 tcp:1080</p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc fport tcp:1234 tcp:1080</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row1973583819359"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p20428943104359"><a name="p20428943104359"></a><a name="p20428943104359"></a>rport <em id="i84129581358"><a name="i84129581358"></a><a name="i84129581358"></a>remotenode localnode</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p0428144314359"><a name="p0428144314359"></a><a name="p0428144314359"></a><span>端口转发</span><span id="text442834344359"><a name="text442834344359"></a><a name="text442834344359"></a>设备侧端口 转发数据到 主机端口</span></p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc_std rport tcp:1234 tcp:1080</p>
|
||||
<p id="p23801376355"><a name="p23801376355"></a><a name="p23801376355"></a>举例： hdc rport tcp:1234 tcp:1080</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row193125772576"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p542613431479"><a name="p542613431479"></a><a name="p542613431479"></a>fport ls</p>
|
||||
@ -219,13 +219,13 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
<tr id="row139301957122511"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p8424164318428"><a name="p8424164318428"></a><a name="p8424164318428"></a>fport rm</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p13424154324211"><a name="p13424154324211"></a>删除指定转发任务</p>
|
||||
<p id="p23801376358"><a name="p23801376358"></a><a name="p23801376358"></a>举例： hdc_std fport rm tcp:1234 tcp:1080</p>
|
||||
<p id="p23801376358"><a name="p23801376358"></a><a name="p23801376358"></a>举例： hdc fport rm tcp:1234 tcp:1080</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row887171025420"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p204287432425"><a name="p204287432425"></a><a name="p204287432425"></a>install<em id="i242704315422"><a name="i242704315422"></a><a name="i242704315422"></a> </em>[-r/-d/-g]<em id="i642814310424"><a name="i642814310424"></a><a name="i642814310424"></a> </em><em id="i103610557016"><a name="i103610557016"></a><a name="i103610557016"></a>package</em></p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p12428194312421"><a name="p12428194312421"></a><a name="p12428194312421"></a><span>安装</span><span id="text242884314423"><a name="text242884314423"></a><a name="text242884314423"></a>OpenHarmony</span><span> package</span></p>
|
||||
<p id="p1419642611411"><a name="p1419642611411"></a><a name="p1419642611411"></a>举例： hdc_std install E:\***.hap</p>
|
||||
<p id="p1419642611411"><a name="p1419642611411"></a><a name="p1419642611411"></a>举例： hdc install E:\***.hap</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row1973583819549"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p20428943104214"><a name="p20428943104214"></a><a name="p20428943104214"></a>uninstall [-k] <em id="i84129581508"><a name="i84129581508"></a><a name="i84129581508"></a>package</em></p>
|
||||
@ -236,13 +236,13 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
<tr id="row1513010417560"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p84281143184214"><a name="p84281143184214"></a><a name="p84281143184214"></a>hilog</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p11428343144216"><a name="p11428343144216"></a><a name="p11428343144216"></a><span>支持查看抓取hilog调试信息</span></p>
|
||||
<p id="p555163671514"><a name="p555163671514"></a><a name="p555163671514"></a>举例： hdc_std hilog</p>
|
||||
<p id="p555163671514"><a name="p555163671514"></a><a name="p555163671514"></a>举例： hdc hilog</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row119311957172516"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p144297439423"><a name="p144297439423"></a><a name="p144297439423"></a>shell<em id="i15429144314210"><a name="i15429144314210"></a><a name="i15429144314210"></a> </em>[<em id="i04791261510"><a name="i04791261510"></a><a name="i04791261510"></a>command</em>]</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.2 "><p id="p16429843124213"><a name="p16429843124213"></a><a name="p16429843124213"></a><span>远程执行命令或进入交互命令环境</span></p>
|
||||
<p id="p1490692061519"><a name="p1490692061519"></a><a name="p1490692061519"></a>举例： hdc_std shell</p>
|
||||
<p id="p1490692061519"><a name="p1490692061519"></a><a name="p1490692061519"></a>举例： hdc shell</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="row193125772572"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.2.3.1.1 "><p id="p542613431472"><a name="p542613431479"></a><a name="p542613431472"></a>jpid</p>
|
||||
@ -253,48 +253,48 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
以下是常用hdc_std命令示例，供开发者参考：
|
||||
以下是常用hdc命令示例，供开发者参考：
|
||||
|
||||
- 查看设备连接信息
|
||||
|
||||
```
|
||||
hdc_std list targets
|
||||
hdc list targets
|
||||
```
|
||||
|
||||
- 往设备中推送文件
|
||||
|
||||
```
|
||||
hdc_std file send E:\a.txt /data/local/tmp/a.txt
|
||||
hdc file send E:\a.txt /data/local/tmp/a.txt
|
||||
```
|
||||
|
||||
- 从设备中拉取文件
|
||||
|
||||
```
|
||||
hdc_std file recv /data/local/tmp/a.txt ./a.txt
|
||||
hdc file recv /data/local/tmp/a.txt ./a.txt
|
||||
```
|
||||
|
||||
- 安装应用
|
||||
|
||||
```
|
||||
hdc_std install E:\***.hap
|
||||
hdc install E:\***.hap
|
||||
```
|
||||
|
||||
- 查看日志
|
||||
|
||||
```
|
||||
hdc_std hilog
|
||||
hdc hilog
|
||||
```
|
||||
|
||||
- 进入命令行交互模式
|
||||
|
||||
```
|
||||
hdc_std shell
|
||||
hdc shell
|
||||
```
|
||||
|
||||
- TCP网络连接。
|
||||
|
||||
```
|
||||
hdc_std tconn 192.168.0.100:10178
|
||||
hdc tconn 192.168.0.100:10178
|
||||
```
|
||||
|
||||
|
||||
@ -302,21 +302,21 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
|
||||
工具使用过程中碰到问题，可以参考如下流程自助排查：
|
||||
|
||||
* step1： 先检查pc(host)端hdc_std 和L2设备端hdcd版本是否一致(-v 查看版本):
|
||||
* step1： 先检查pc(host)端hdc 和L2设备端hdcd版本是否一致(-v 查看版本):
|
||||
- step1a： 版本不一致请更新使用一致版本再验证；
|
||||
- step1b： 版本一致请继续下面排查step2步骤；
|
||||
* step2： 检查pc(host)端设备管理器设备信息是否正常(设备是否正常加载显示、驱动、id是否正常):
|
||||
- step2a： 设备管理器设备异常或无设备， 请结合板测试设备端串口下确认下usb部分设备枚举上报是否异常；
|
||||
- step2b： 设备管理器设备正常时， 1）list targets 是否正常；2）hdc_std kill 后重试是否正常；
|
||||
- step2b： 设备管理器设备正常时， 1）list targets 是否正常；2）hdc kill 后重试是否正常；
|
||||
|
||||
**注意：客户端和设备端版本保持一致(hdc_std -v,hdcd -v参数查看版本)!**
|
||||
**注意：客户端和设备端版本保持一致(hdc -v,hdcd -v参数查看版本)!**
|
||||
|
||||
## FAQ<a name="section1371113476308"></a>
|
||||
- 1. list targets无设备：
|
||||
|
||||
```
|
||||
请参考上面《使用问题自查说明》小节 1）检查设备是否连接正常；2）host端设备管理器设备信息是否正常；3）两端工具版本是否一致；4）设备端hdcd是否启动正常；
|
||||
如果仍然无法解决问题，请尝试下面两种方法进行恢复 1）执行命令hdc_std kill来重启pc侧hdc服务；2）重启端侧设备；
|
||||
如果仍然无法解决问题，请尝试下面两种方法进行恢复 1）执行命令hdc kill来重启pc侧hdc服务；2）重启端侧设备；
|
||||
```
|
||||
- 2. 同样版本windows下正常，linux下无设备：
|
||||
|
||||
@ -333,6 +333,6 @@ hdc_std当前常用命令如下，未尽命令使用hdc_std -h或者hdc_std --he
|
||||
|
||||
```
|
||||
推送文件前参考执行如下命令:
|
||||
hdc_std smode
|
||||
hdc_std shell mount -o rw,remount /
|
||||
hdc smode
|
||||
hdc shell mount -o rw,remount /
|
||||
```
|
||||
|
||||
@ -85,11 +85,11 @@ function build_hdc ()
|
||||
export LDFLAGS="-Wl,--copy-dt-needed-entries"
|
||||
export CXXFLAGS="-std=c++17 -ggdb -O0"
|
||||
|
||||
g++ ${DEFINES} ${CXXFLAGS} ${INCLUDES} $(find src/common/ src/host/ \( -name "*.cpp" -or -name "*.c" \)) -lusb-1.0 -ldl -lpthread $STATICLIB -o hdc_std
|
||||
g++ ${DEFINES} ${CXXFLAGS} ${INCLUDES} $(find src/common/ src/host/ \( -name "*.cpp" -or -name "*.c" \)) -lusb-1.0 -ldl -lpthread $STATICLIB -o hdc
|
||||
|
||||
if [ -f hdc_std ]; then
|
||||
if [ -f hdc ]; then
|
||||
echo build success
|
||||
cp hdc_std $cwddir
|
||||
cp hdc $cwddir
|
||||
else
|
||||
echo build fail
|
||||
fi
|
||||
|
||||
@ -323,7 +323,7 @@ bool HdcForwardBase::DetechForwardType(HCtxForward ctxPoint)
|
||||
} else if (sFType == "localabstract") {
|
||||
// daemon shell: /system/bin/socat abstract-listen:linux-abstract -
|
||||
// daemon shell: /system/bin/socat - abstract-connect:linux-abstract
|
||||
// host: hdc_std fport tcp:8080 localabstract:linux-abstract
|
||||
// host: hdc fport tcp:8080 localabstract:linux-abstract
|
||||
ctxPoint->type = FORWARD_ABSTRACT;
|
||||
} else if (sFType == "localreserved") {
|
||||
sNodeCfg = harmonyReservedSocketPrefix + sNodeCfg;
|
||||
|
||||
Loading…
Reference in New Issue
Block a user