【鸿蒙开发】OpenHarmony调测工具hdc使用教程(设备开发者)

00. 目录

文章目录

    • 00. 目录
    • 01. OpenHarmony概述
    • 02. hdc简介
    • 03. hdc获取
    • 04. option相关的命令
    • 05. 查询设备列表的命令
    • 06. 服务进程相关命令
    • 07. 网络相关的命令
    • 08. 文件相关的命令
    • 09. 应用相关的命令
    • 10. 调试相关的命令
    • 11. 常见问题
    • 12. 附录

01. OpenHarmony概述

OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及运营的开源项目,目标是面向全场景、全连接、全智能时代,基于开源的方式,搭建一个智能终端设备操作系统的框架和平台,促进万物互联产业的繁荣发展。

OpenHarmony整体遵从分层设计,从下向上依次为:内核层、系统服务层、框架层和应用层。系统功能按照“系统 > 子系统 > 组件”逐级展开,在多设备部署场景下,支持根据实际需求裁剪某些非必要的组件。OpenHarmony技术架构如下所示:
在这里插入图片描述

内核层

  • 内核子系统:采用多内核(Linux内核或者LiteOS)设计,支持针对不同资源受限设备选用适合的OS内核。内核抽象层(KAL,Kernel Abstract Layer)通过屏蔽多内核差异,对上层提供基础的内核能力,包括进程/线程管理、内存管理、文件系统、网络管理和外设管理等。
  • 驱动子系统:驱动框架(HDF)是系统硬件生态开放的基础,提供统一外设访问能力和驱动开发、管理框架。

系统服务层

系统服务层是OpenHarmony的核心能力集合,通过框架层对应用程序提供服务。该层包含以下几个部分:

  • 系统基本能力子系统集:为分布式应用在多设备上的运行、调度、迁移等操作提供了基础能力,由分布式软总线、分布式数据管理、分布式任务调度、公共基础库、多模输入、图形、安全、AI等子系统组成。
  • 基础软件服务子系统集:提供公共的、通用的软件服务,由事件通知、电话、多媒体、DFX(Design For X) 等子系统组成。
  • 增强软件服务子系统集:提供针对不同设备的、差异化的能力增强型软件服务,由智慧屏专有业务、穿戴专有业务、IoT专有业务等子系统组成。
  • 硬件服务子系统集:提供硬件服务,由位置服务、用户IAM、穿戴专有硬件服务、IoT专有硬件服务等子系统组成。

根据不同设备形态的部署环境,基础软件服务子系统集、增强软件服务子系统集、硬件服务子系统集内部可以按子系统粒度裁剪,每个子系统内部又可以按功能粒度裁剪。

框架层

框架层为应用开发提供了C/C++/JS等多语言的用户程序框架和Ability框架,适用于JS语言的ArkUI框架,以及各种软硬件服务对外开放的多语言框架API。根据系统的组件化裁剪程度,设备支持的API也会有所不同。

应用层

应用层包括系统应用和第三方非系统应用。应用由一个或多个FA(Feature Ability)或PA(Particle Ability)组成。其中,FA有UI界面,提供与用户交互的能力;而PA无UI界面,提供后台运行任务的能力以及统一的数据访问抽象。基于FA/PA开发的应用,能够实现特定的业务功能,支持跨设备调度与分发,为用户提供一致、高效的应用体验。

技术特性

硬件互助,资源共享

主要通过下列模块达成

  • 分布式软总线

    分布式软总线是多设备终端的统一基座,为设备间的无缝互联提供了统一的分布式通信能力,能够快速发现并连接设备,高效地传输任务和数据。

  • 分布式数据管理

    分布式数据管理基于分布式软总线,实现了应用程序数据和用户数据的分布式管理。用户数据不再与单一物理设备绑定,业务逻辑与数据存储分离,应用跨设备运行时数据无缝衔接,为打造一致、流畅的用户体验创造了基础条件

  • 分布式任务调度

    分布式任务调度基于分布式软总线、分布式数据管理、分布式Profile等技术特性,构建统一的分布式服务管理(发现、同步、注册、调用)机制,支持对跨设备的应用进行远程启动、远程调用、绑定/解绑、以及迁移等操作,能够根据不同设备的能力、位置、业务运行状态、资源使用情况并结合用户的习惯和意图,选择最合适的设备运行分布式任务

  • 设备虚拟化

    分布式设备虚拟化平台可以实现不同设备的资源融合、设备管理、数据处理,将周边设备作为手机能力的延伸,共同形成一个超级虚拟终端。

一次开发,多端部署

OpenHarmony提供用户程序框架、Ability框架以及UI框架,能够保证开发的应用在多终端运行时保证一致性。一次开发、多端部署。

多终端软件平台API具备一致性,确保用户程序的运行兼容性。

  • 支持在开发过程中预览终端的能力适配情况(CPU/内存/外设/软件资源等)。
  • 支持根据用户程序与软件平台的兼容性来调度用户呈现。

统一OS,弹性部署

OpenHarmony通过组件化和组件弹性化等设计方法,做到硬件资源的可大可小,在多种终端设备间,按需弹性部署,全面覆盖了ARM、RISC-V、x86等各种CPU,从百KiB到GiB级别的RAM。

02. hdc简介

hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。

03. hdc获取

hdc 工具获取方式:

通过OpenHarmony sdk获取,hdc在sdk的toolchains目录下。

使用举例:

下面以windows侧使用方式举例:

获取windows的sdk,将hdc.exe放到磁盘某个位置即可使用。

注意事项

  • 使用hdc,如果出现异常,可以尝试通过hdc kill命令杀掉hdc服务,或者通过hdc start -r命令重启服务进程进行解决。
  • 如果出现hdc list targets获取不到设备信息,通过任务管理器查看是否有hdc进程存在,如果进程存在,可以通过杀掉该进程进行解决。

04. option相关的命令

option涉及以下命令:

  • -h/help -v/version 用于显示hdc相关的帮助、版本信息。

命令说明

返回值返回值说明
返回对应信息帮助或者版本信息

示例

# 查看帮助信息
D:\tools>hdc -hD:\tools>hdc help# 查看版本信息
D:\tools>hdc -v
Ver: 1.1.1lD:\tools>hdc version
Ver: 1.1.1l
  • -l 0-5 用于指定运行时日志等级,默认为LOG_INFO。

命令说明

参数参数说明
0LOG_OFF
1LOG_FATAL
2LOG_WARN
3LOG_INFO
4LOG_DEBUG
5LOG_ALL

示例

D:\tools>hdc -l5 start
[D][2025-03-08 19:14:13.154][1228][channel.cpp:341] Mallocchannel:564292774
[D][2025-03-08 19:14:13.155][1228][base.cpp:761] File "HDCServer" locked. proc already exit!!![D][2025-03-08 19:14:13.156][1228][channel.cpp:424] Begin to free channel, channelid:564292774
[D][2025-03-08 19:14:13.156][1228][main.cpp:346] !!!!!!!!!Main finish mainD:\tools>
  • -t key 用于连接指定设备标识为key的设备。

命令说明

参数参数说明
key为 IP地址:port 格式,或者USB序列号
返回值返回值说明
①error: device ‘***’ not found
②Nothing to do…
①设备不存在
②附加的命令不存在

示例

该option需要与具体的操作命令搭配使用,下面以shell命令举例:

hdc list targets (获取设备信息)hdc -t key shell (-t后面添加的_key_ 需要替换为上面查询的设备信息)D:\tools>hdc list targets
2f011130375330303010b6204718ab00D:\tools>hdc -t 2f011130375330303010b6204718ab00 shell
#

说明

一台开发机可支持多个设备连接,每个设备有其唯一的设备标识,如果通过网络与设备连接,其标识为IP地址:port格式,如果通过USB连接则标识为设备sn号。该命令需要跟随具体操作命令。

  • checkserver 用于获取client-server版本。

命令说明

返回值返回值说明
Client version: server version:client-server版本号

示例

D:\tools>hdc checkserver

05. 查询设备列表的命令

查询设备列表涉及以下命令:

list targets[-v]

显示所有已经连接的目标设备列表

表5 命令说明

参数参数说明
-v添加-v选项,则会打印设备详细信息
返回值返回值说明
①返回设备信息
②[Empty]
①已经连接的设备列表信息
②没有查询到设备信息

示例

D:\tools>hdc list targets
2f011130375330303010b6204718ab00D:\tools>hdc list targets -v
2f011130375330303010b6204718ab00                USB     Connected       localhost
COM1            UART    Ready
COM3            UART    Ready
COM4            UART    ReadyD:\tools>

06. 服务进程相关命令

服务进程涉及以下命令:

  • target mount 以读写模式挂载系统分区。

    表6 命令说明

    参数参数说明
    返回值返回值说明
    ①Mount finish
    ②返回具体信息
    ①成功情况下返回的信息
    ②失败情况下的具体信息

示例

D:\tools>hdc target mount
Mount finish
  • target boot 设备重启。

示例

D:\tools>hdc target boot
  • smode [-r] 授予后台服务进程root权限, 使用-r参数取消授权。

示例

D:\tools>hdc smodeD:\tools>
D:\tools>hdc smode -r
  • kill [-r] 终止服务进程。

命令说明

参数参数说明
-r触发服务重启
返回值返回值说明
①Kill server finish
②返回具体信息
①成功情况下返回的信息
②失败情况下的具体信息

示例

D:\tools>hdc kill
Kill server finishD:\tools>
  • start [-r] 启动服务进程。

命令说明

参数参数说明
-r如果服务进程已经启动,-r选项会触发服务进程重新启动
返回值返回值说明

示例

D:\tools>hdc startD:\tools>

07. 网络相关的命令

网络部分涉及以下命令:

  • tconn host[:port][-remove] 通过【ip地址:端口号】来指定连接的设备

命令说明

参数参数说明
host[:port]为IP地址:port格式
-remove表示断开与指定设备的连接
返回值返回值说明
①返回具体信息
②无
①失败情况下的具体信息
②成功情况下无返回值

示例

D:\tools>hdc tconn 192.168.0.100:8710
  • tmode usb 执行后设备端对应daemon进程重启,并首先选用USB连接方式。

命令说明

参数参数说明
返回值返回值说明
①返回具体信息
②无
①失败情况下的具体信息
②成功情况下无返回值

示例

hdc tmode usb
  • tmode port port-number 执行后设备端对应daemon进程重启,并优先使用网络方式连接设备,如果连接设备失败,再选择USB连接。

命令说明

参数参数说明
port-numberlisten连接的网络端口号
返回值返回值说明
①返回具体信息
②无
①失败情况下的具体信息
②成功情况下无返回值

示例

hdc tmode port 8710

说明

执行完毕后,远端daemon将会退出并重启,默认启用TCP连接,如果不加上listen端口则listen随机端口。

  • fport localnode remotenode 端口转发,指定 主机端口 转发数据到 设备侧端口。

示例

hdc fport tcp:1234 tcp:1080
  • rport remotenode localnode 端口转发,指定 设备侧端口 转发数据到 主机端口。

示例

hdc rport tcp:2080 tcp:2345
  • fport ls 列出全部转发端口转发任务。

命令说明

参数参数说明
返回值返回值说明
‘tcp:1234 tcp:1080’ [Forward]正向端口转发任务
‘tcp:2080 tcp:2345’ [Reverse]反向端口转发任务

示例

hdc fport ls
  • fport rm 删除指定端口转发任务。

示例

hdc fport rm tcp:1234 tcp:1080

08. 文件相关的命令

文件部分涉及以下命令:

  • file send local remote 发送文件至远端设备。

命令说明

参数参数说明
local本地待发送文件路径
remote远程待接收文件路径
返回值返回值说明
①返回具体信息
②返回传输结果
①失败情况下的具体信息
②成功传输的结果信息

示例

D:\tools>hdc file send D:\tools/SN.txt /data/local/tmp/SN.txt
FileTransfer finish, Size:22, File count = 1, time:31ms rate:0.71kB/sD:\tools>
  • file recv [-a] remote local 从远端设备接收文件至本地。

命令说明

参数参数说明
-a文件保留时间戳模式
local本地待接收文件路径
remote远程待发送文件路径
返回值返回值说明
①返回具体信息
②无
①失败情况下的具体信息
②成功情况下无返回值

示例

D:\tools>hdc file recv /data/local/tmp/SN.txt ./a.txt
FileTransfer finish, Size:22 time:3ms rate:7.33kB/s

09. 应用相关的命令

应用部分涉及以下命令:

  • install [-r/-d/-g] package 安装OpenHarmony APP package。

命令说明

参数参数说明
packageOpenHarmony应用安装包文件名
-r替换已存在应用
-d允许降级安装
-g应用动态授权
返回值返回值说明
①返回具体信息
②无
①失败情况下的具体信息
②成功情况下无返回值

示例

hdc install hwadmin.hap
  • uninstall [-k] package 卸载OpenHarmony应用。

命令说明

参数参数说明
packageOpenHarmony应用安装包
-k保留/data/cache
返回值返回值说明
①返回具体信息
②无
①失败情况下的具体信息
②成功情况下无返回值

示例

hdc uninstall package

10. 调试相关的命令

调试涉及以下命令:

  • hilog 支持抓取log信息。

命令说明

参数参数说明
返回值返回值说明
返回具体信息抓取的日志信息

抓取hilog日志:

hdc hilog

清理hilog缓存日志:

hdc shell "hilog -r"
  • shell [command] 远程执行命令或进入交互命令环境。

命令说明

参数参数说明
command需要执行的单次命令
返回值返回值说明
返回具体信息shell后面执行命令的结果信息

示例

hdc shell
  • jpid 获取可调试进程列表。

示例

D:\tools>hdc jpid
1037
1061
1105
1117
1260
1653

11. 常见问题

11.1 hdc连接不到设备

  • 现象描述 执行 "hdc list targets"命令后结果为:[Empty]
  • 解决方法
    1. 设备没有被识别: 在设备管理器中查看是否有hdc设备,在通用串行总线设备中会有“HDC Device”信息。如果没有,hdc无法连接。此时需要断开并重联PC和OpenHarmony设备之间的USB连接,或者烧写最新的镜像。
    2. hdc工作异常: 可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务,然后再执行hdc list targets查看是否已经可以获取设备信息。
    3. hdc与设备不匹配: 如果设备烧写的是最新镜像,hdc也需要使用最新版本。

11.2 hdc运行不了

  • 现象描述 点击hdc.exe文件无法运行。
  • 解决方法
    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命令直接使用。

11.3 hdc client如何远程访问hdc server

  • 使用场景

    本地client指定远程server上的设备,执行hdc命令。

  • 连接步骤

    1. 关闭本地sever:

      hdc kill
      
    2. -s [ip:]port -m

      启动远程server:

      hdc -s severIP:8710 -m
      
    3. -s [ip:]port command

      指定server执行指令:

      hdc -s severIP:8710 list targets
      

12. 附录

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.pswp.cn/web/71972.shtml
繁体地址,请注明出处:http://hk.pswp.cn/web/71972.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

手写简易Tomcat核心实现:深入理解Servlet容器原理

目录 一、Tomcat概况 1. tomcat全局图 2.项目结构概览 二、实现步骤详解 2.1 基础工具包(com.qcby.util) 2.1.1 ResponseUtil:HTTP响应生成工具 2.1.2 SearchClassUtil:类扫描工具 2.1.3 WebServlet:自定义注解…

【Java开发指南 | 第三十四篇】IDEA没有Java Enterprise——解决方法

读者可订阅专栏:Java开发指南 |【CSDN秋说】 文章目录 1、新建Java项目2、单击项目名,并连续按两次shift键3、在搜索栏搜索"添加框架支持"4、勾选Web应用程序5、最终界面6、添加Tomcat 1、新建Java项目 2、单击项目名,并连续按两次…

在MATLAB中实现PID控制仿真

在MATLAB中实现PID控制仿真可以通过代码编程或Simulink图形化建模两种方式完成。以下是两种方法的详细操作步骤和示例: 方法1:使用MATLAB脚本编程(基于控制系统工具箱) 步骤1:定义被控对象的数学模型 假设被控对象是…

Conda常用命令汇总

Conda 是一个流行的包管理器和环境管理工具,广泛应用于数据科学、机器学习等领域。它可以帮助我们管理 Python 包以及不同版本的环境,避免包冲突,提升项目的可复现性。以下是一些常用的 Conda 命令,涵盖环境创建、管理、包安装等常…

大数据实时分析:ClickHouse、Doris、TiDB 对比分析

1. 引言 在大数据分析领域,实时分析需求越来越重要。ClickHouse、Doris 和 TiDB 作为当前流行的实时分析数据库,各自针对不同的应用场景和数据特性进行了优化。本文将对比它们的核心架构、适用场景以及查询优化方法,帮助数据开发人员选择合适的工具。 2. 核心架构对比 2.…

蓝桥杯历年真题题解

1.轨道炮&#xff08;数学模拟&#xff09; #include <iostream> #include <map> using namespace std; const int N1010; int x[N],y[N],v[N]; char d[N]; int main() {int n;int ans-100;cin>>n;for(int i1;i<n;i)cin>>x[i]>>y[i]>>v…

Pytorch的一小步,昇腾芯片的一大步

Pytorch的一小步&#xff0c;昇腾芯片的一大步 相信在AI圈的人多多少少都看到了最近的信息&#xff1a;PyTorch最新2.1版本宣布支持华为昇腾芯片&#xff01; 1、 发生了什么事儿&#xff1f; 在2023年10月4日PyTorch 2.1版本的发布博客上&#xff0c;PyTorch介绍的beta版本…

嵌入式硬件篇---手柄控制控制麦克纳姆轮子

文章目录 前言1. 变量定义2. 摇杆死区设置3. 模式检查4. 摇杆数据处理4.1 右摇杆垂直值&#xff08;psx_buf[7]&#xff09;4.2 右摇杆水平值&#xff08;psx_buf[8]&#xff09;4.3 左摇杆水平值&#xff08;psx_buf[5]&#xff09;4.4 左摇杆垂直值&#xff08;psx_buf[6]&am…

阿里千问大模型(Qwen2.5-VL-7B-Instruct)部署

参考链接 知乎帖子 B站视频 huggingface 镜像网站&#xff08;不太全&#xff0c;比如 Qwen/Qwen2.5-VL-7B-Instruct就没有&#xff09; huggingface 5种下载方式汇总 通过huggingface-cli下载模型 不一样的部分是预训练权重的下载和demo 首先安装huggingface_hub pip insta…

Jenkins在Windows上的使用(二):自动拉取、打包、部署

&#xff08;一&#xff09;Jenkins全局配置 访问部署好的Jenkins服务器网址localhost:8080&#xff0c;完成默认插件的安装后&#xff0c;接下来将使用SSH登录远程主机以实现自动化部署。 1. 配置插件 选择dashboard->Manage Jenkins->plugins 安装下面两个插件  …

群晖DS 223 Docker:开启私有云

群晖DS 223 Docker&#xff1a;开启私有云的无限可能 引言 在数据存储与管理的不断演进中&#xff0c;群晖 DS 223 凭借其出色的性能和丰富的功能&#xff0c;成为众多用户搭建私有云的热门选择。而当它与 Docker 技术相遇&#xff0c;犹如为数据管理的舞台添上了绚丽多彩的灯…

git切换版本

git brach 查看本地 刚从git上下载下来 的话 可以通过 git checkout xxxx进行切换 可能一段时间没有用 而服务器上新建了某些版本 那么需要用 git fetch origin 同步本地与git服务器的分支 然后 创建本地分支xxx 并从服务器拉取xxx git checkout -b xxx origin/xxx…

Three.js 进阶(灯光阴影关系和设置、平行光、阴影相机)

本篇主要学习内容 : 灯光与阴影聚光灯点光源平行光阴影相机和阴影计算投射阴影接受阴影 点赞 关注 收藏 学会了 1.灯光与阴影 1、材质要满足能够对光有反应 2、设置渲染器开启阴影计算 renderer.shadowMap.enabledtrue 3、设置光照投射阴影 directionalLight.castShadow …

【 <一> 炼丹初探:JavaWeb 的起源与基础】之 Tomcat 的工作原理:从启动到请求处理的流程

<前文回顾> 点击此处查看 合集 https://blog.csdn.net/foyodesigner/category_12907601.html?fromshareblogcolumn&sharetypeblogcolumn&sharerId12907601&sharereferPC&sharesourceFoyoDesigner&sharefromfrom_link <今日更新> 一、Tomcat…

【GPT入门】第11课 FunctionCall调用本地代码入门

【GPT入门】第11课 FunctionCall调用代码入门 1. 手撕FunctionCall2.代码3.functionCall的结果 1. 手撕FunctionCall 为了了解&#xff0c;funcationCall底层&#xff0c;手写一个functionCall多方法&#xff0c;并调用&#xff0c;体验 思路&#xff1a; 任务&#xff1a;让…

MySQL主从架构配合ShardingJdbc实现读写分离

文章目录 目录架构搭建读写分离pom.xmlfdy-live-user-provider 模块application.ymlfdy-db-sharding.yamlShardingJdbcDatasourceAutoInitConnectionConfig.java 目录 架构搭建 基于Docker去创建MySQL的主从架构 读写分离 pom.xml <dependency><groupId>mysql…

计网面试准备

正确理解网络数据传输过程 同一路由器的不同接口属于不同局域网&#xff0c;广播只能在同一个局域网

NLP常见任务专题介绍(1)-关系抽取(Relation Extraction, RE)任务训练模板

📌 关系抽取(Relation Extraction, RE)任务训练示例 本示例展示如何训练一个关系抽取模型,以识别两个实体之间的关系。 1️⃣ 任务描述 目标:从文本中提取两个实体之间的语义关系,例如 “人物 - 组织”、“药物 - 疾病”、“公司 - 创始人” 等。输入:句子 + 标注的实…

【技术白皮书】内功心法 | 第二部分 | Telnet远程登录的工作原理

远程登录的工作原理 背景介绍远程登录远程登录的服务模式远程登录服务的实现基础远程登录服务的运行模式Telnet服务为什么不被操作系统管理 Telnet协议的原理网络虚终端&#xff08;NVT&#xff09;结束标示NVT的原理NVT屏蔽差异 背景介绍 绝大多数计算机都是运行多用户操作系…

在 Spring Boot 中实现基于 TraceId 的日志链路追踪

1 前言 1.1 什么是 TraceId? TraceId 是一个唯一的标识符,用于跟踪分布式系统中的请求。每个请求从客户端发起到服务端处理,再到可能的多个微服务调用,都会携带这个 TraceId,以便在整个请求链路中进行追踪和调试。 1.2 日志链路追踪的意义 日志链路追踪可以帮助开发者…