hdc工具使用手册

1 hdc简介

hdc（OpenHarmony Device Connector）是为开发人员提供的用于设备连接调试的命令行工具，pc端开发机使用命令行工具hdc，该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备（或模拟器）进行连接调试通信。PC端hdc工具需要针对以上开发机操作系统平台分别发布相应的版本，设备端hdc daemon需跟随设备镜像发布包括对模拟器进行支持。hdc组成关系图如下图所示：

PC与设备侧，可以通过网络连接，也可以通过USB线连接。

2 连接设置

hdc主从设备之间的连接可以通过USB和网络的方式进行连接。

2.1 USB方式

2.1.1 windows环境下

windows下，连接usb线，查看设备管理器。如果能看到HDC Device的设备，说明设备识别正常，可以在命令行界面中输入HDC相关命令进行交互了。

2.1.2 linux环境下

• （1）linux下需要添加usb设备权限，连接usb线，执行lsusb命令，能识别到Phytium “HDC Device”的设备,说明枚举正常。打开cmd窗口，执行 hdc shell 就进入了命令交互界面。

• （2）运行HDC 命令报错问题解决
  当执行hdc命令，提示[Fail] ExecuteCommnand need connect-key的错误时，解决方法为：

  编辑规则脚本：
   $ sudo vi /etc/udev/rules.d/90-myusb.rules
  
  添加内容:
  SUBSYSTEM=="usb", ATTR{idVendor}=="1db7",ATTR{idProduct}=="dc27", MODE="0666"
  
  重启电脑或重新加载udev规则:
   $ sudo  udevadm  control   --reload
  

2.2 网络方式

如果使用网络方式，从机设备即Openharmony设备启动后需要优先开启hdc配置：

• 5.0 release版本之前的hdc配置

  配置hdc模式和端口
  $ param set persist.hdc.mode tcp #设置hdc以tcp的方式连接
  $ param set persist.hdc.port 8710 #port也可是其他的端口号
  
  重启hdc服务
  $ service_control stop hdcd #关闭hdc服务
  $ service_control start hdcd #开启hdc服务
  
  查看hdc状态
  $ param get | grep hdc
  

• 5.0 release版本及以后的hdc配置

  配置hdc模式和端口
  $ param set persist.hdc.mode tcp #设置hdc以tcp的方式连接
  $ param set persist.hdc.port 8710 #port也可是其他的端口号
  
  5.0release新增配置，必须设置：
  $ param set persist.hdc.mode.tcp enable 
  $ param set persist.hdc.root 1
  $ param set const.security.developermode.state true #开启开发者模式
  
  重启hdc服务
  $ service_control stop hdcd #关闭hdc服务
  $ service_control start hdcd #开启hdc服务
  
  查看hdc状态
  $ param get | grep hdc
  

  完成上述配置后，在主机工作台下执行以下命令连接openharmony设备，确保主机工作台ip和openharmony的ip在同一网段下，建议使用同一路由器自动分配ip。

  $ hdc tconn ip:port
  

  连接成功提示 Connect OK。

3 常用的hdc命令

$ hdc tconn ip:port

查看设备连接信息:
$ hdc list targets -v 

往设备中推送文件:
$ hdc target mount
$ hdc shell mount -0 rw,remount /
$ hdc file send E:\a.txt /data/local/tmp/a.txt 

从设备中拉取文件：
$ hdc file recv /data/local/tmp/a.txt ./a.txt

安装应用：
$ hdc install -r E:\***.hap

查看日志：
$ hdc hilog

进入命令行交互模式：
$ hdc shell