【入门到实战】OpenHarmony子系统外设驱动使用:Motion

OpenHarmony实战:拖拽动画的技术实现 功能将集中在拖拽框架 MSDP 子系统 DragDrawing 中实现。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


概述

功能简介

手势识别模块作为端侧设备不可或缺的一部分,为用户提供手势识别控制能力。当前支持的手势识别类型有拿起、翻转、摇一摇、旋转屏等。

基于HDF(Hardware Driver Foundation)驱动框架开发的Motion驱动,能够屏蔽硬件器件差异,为上层MSDP(Multimodal Sensor Data Platform)服务层提供稳定的手势识别控制能力接口,包括手势识别使能/去使能、手势识别订阅/取消订阅等。

Motion驱动框架如图1所示,上层为Framework层,提供MSDP服务,通过UHDF(User Hardware Driver Foundation)层的Motion Proxy与Motion Stub进行交互;而Motion Stub可调用Motion HDI实现类接口,从而实现上层服务的手势识别使能/去使能、手势识别订阅/取消订阅等能力。

图1 Motion驱动框架

1660105057660

运作机制

通过介绍Motion驱动模型的加载以及运行流程,对模型内部关键组件以及关联组件之间的关系进行了划分,整体加载流程如图2所示:

图 2 Motion驱动运行图

1660122293156

  1. MSDP:上层综合传感信息处理平台服务层,当HDI接口服务实例获取成功后可以直接调用Motion HDI接口。
  2. IDL:接口抽象层。MSDP服务层首先从Motion Proxy获取到Motion HDI接口服务实例。而Motion Proxy获取到的接口实例是由IService Manager进行分配。当MSDP服务层成功获取到Motion HDI接口服务实例后,MSDP服务层就可以直接调用Motion Proxy中的HDI接口,然后通过IPC(Inter-Process Communication)调用到Motion Stub,从而调用到Motion Service的接口。这部分是由工具自动生成的代码,不用器件厂商自己开发。
  3. HDI Service:HDI Service中包括Motion Interface Driver、Motion Service和Motion Impl三个部分。其中Motion Interface Driver为手势识别接口的驱动代码,在这部分驱动代码中通过定义一个struct HdfDriverEntry类型的结构体变量,实现此变量中的Init、Bind和Release函数描述驱动能力,函数内部通过HDF_INIT宏加载驱动。Motion Service为手势识别服务接口类,具体的实现在Motion Impl中描述。此部分代码需要器件厂商根据自己器件来开发。

开发指导

场景介绍

Motion驱动的主要工作是为上层MSDP服务提供稳定的使能/去使能手势识别服务,订阅/取消订阅手势识别数据回调函数的功能。可应用于拿起、翻转、摇一摇、旋转屏等手势识别场景。

接口说明

表1 接口功能介绍

注:以下接口列举的为IDL接口描述生成的对应C++语言函数接口,接口声明见idl文件/drivers/interface/motion/v1_0/ 。

接口名功能介绍
int32_t EnableMotion(int32_t motionType)使能一种手势识别类型,只有数据订阅者使能手势识别后,才能获取订阅的手势识别数据。
int32_t DisableMotion(int32_t motionType)去使能手势识别。
int32_t Register(const sptr<IMotionCallback> &callbackObj)订阅者成功注册手势识别数据回调函数,系统会将获取到的手势识别数据上报给订阅者。
int32_t Unregister(const sptr<IMotionCallback> &callbackObj)取消订阅手势识别数据回调函数。

开发步骤

开发步骤分为两个大步骤。

  1. 基于HDF驱动框架,完成手势识别用户态驱动开发。

  2. 厂商实现EnableMotion、DisableMotion、Register和Unregister接口功能。

手势识别目录结构及各部分功能简介。

/drivers/peripheral/motion           // 此目录具体实现需要厂商根据自己的器件进行开发
├── hdi_service              		 // motion模块对上层服务提供的驱动能力
├── test                             // motion模块测试代码
   └── unittest\hdi                  // motion模块hdi单元测试代码

下面结合DEMO实例,介绍如何基于HDF驱动框架,进行手势识别用户态驱动开发。具体实现请参考motion_if_driver.cpp。

手势识别用户态驱动开发, 主要完成Bind、Init、Release、Dispatch函数接口实现。其中Bind函数为驱动绑定对外提供的服务能力,Init函数为系统加载驱动前需要的一些初始化的操作,Release函数的主要作用为当系统加载驱动调用Init函数失败时对资源进行回收操作,Dispatch函数为服务能力的具体实现,在Bind函数中进行绑定。

/* 自定义的HdfMotionInterfaceHost对象 */
struct HdfMotionInterfaceHost {
    struct IDeviceIoService ioService;
    OHOS::sptr<OHOS::IRemoteObject> stub;
};

/* 服务接口调用响应接口 */
static int32_t MotionInterfaceDriverDispatch(struct HdfDeviceIoClient *client, int cmdId, struct HdfSBuf *data,
    struct HdfSBuf *reply)
{
    auto *hdfMotionInterfaceHost = CONTAINER_OF(client->device->service, struct HdfMotionInterfaceHost, ioService);

    OHOS::MessageParcel *dataParcel = nullptr;
    OHOS::MessageParcel *replyParcel = nullptr;
    OHOS::MessageOption option;

    if (SbufToParcel(data, &dataParcel) != HDF_SUCCESS) {
        HDF_LOGE("%{public}s: invalid data sbuf object to dispatch", __func__);
        return HDF_ERR_INVALID_PARAM;
    }
    if (SbufToParcel(reply, &replyParcel) != HDF_SUCCESS) {
        HDF_LOGE("%{public}s: invalid reply sbuf object to dispatch", __func__);
        return HDF_ERR_INVALID_PARAM;
    }

    return hdfMotionInterfaceHost->stub->SendRequest(cmdId, *dataParcel, *replyParcel, option);
}

/* 初始化接口 */
int HdfMotionInterfaceDriverInit(struct HdfDeviceObject *deviceObject)
{
    HDF_LOGI("HdfMotionInterfaceDriverInit enter");
    return HDF_SUCCESS;
}

/* Motion驱动对外提供的服务绑定到HDF框架 */
int HdfMotionInterfaceDriverBind(struct HdfDeviceObject *deviceObject)
{
    HDF_LOGI("HdfMotionInterfaceDriverBind enter");

    auto *hdfMotionInterfaceHost = new (std::nothrow) HdfMotionInterfaceHost;
    if (hdfMotionInterfaceHost == nullptr) {
        HDF_LOGE("%{public}s: failed to create HdfMotionInterfaceHost object", __func__);
        return HDF_FAILURE;
    }

    hdfMotionInterfaceHost->ioService.Dispatch = MotionInterfaceDriverDispatch;
    hdfMotionInterfaceHost->ioService.Open = NULL;
    hdfMotionInterfaceHost->ioService.Release = NULL;

    auto serviceImpl = IMotionInterface::Get(true);
    if (serviceImpl == nullptr) {
        HDF_LOGE("%{public}s: failed to get of implement service", __func__);
        return HDF_FAILURE;
    }

    hdfMotionInterfaceHost->stub = OHOS::HDI::ObjectCollector::GetInstance().GetOrNewObject(serviceImpl,
        IMotionInterface::GetDescriptor());
    if (hdfMotionInterfaceHost->stub == nullptr) {
        HDF_LOGE("%{public}s: failed to get stub object", __func__);
        return HDF_FAILURE;
    }

    deviceObject->service = &hdfMotionInterfaceHost->ioService;
    return HDF_SUCCESS;
}

/* 释放Motion驱动中的资源 */
void HdfMotionInterfaceDriverRelease(struct HdfDeviceObject *deviceObject)
{
    HDF_LOGI("HdfMotionInterfaceDriverRelease enter");
    auto *hdfMotionInterfaceHost = CONTAINER_OF(deviceObject->service, struct HdfMotionInterfaceHost, ioService);
    delete hdfMotionInterfaceHost;
    hdfMotionInterfaceHost = nullptr;
}

/* 注册Motion驱动入口数据结构体对象 */
struct HdfDriverEntry g_motioninterfaceDriverEntry = {
    .moduleVersion = 1,
    .moduleName = "motion_service",
    .Bind = HdfMotionInterfaceDriverBind,
    .Init = HdfMotionInterfaceDriverInit,
    .Release = HdfMotionInterfaceDriverRelease,
};

/* 调用HDF_INIT将驱动入口注册到HDF框架中,在加载驱动时HDF框架会先调用Bind函数,再调用Init函数加载该驱动,当Init调用异常时,HDF框架会调用Release释放驱动资源并退出 */
HDF_INIT(g_userAuthInterfaceDriverEntry);

调测验证

测试代码开发步骤:

  1. 通过调用IMotionInterface::Get()获取到手势识别实例,并赋给IMotionInterface类型的智能指针对象g_motionInterface。

  2. 通过g_motionInterface实例调用Register接口注册回调,回调函数需要根据自己的需求来设计。

  3. 通过g_motionInterface实例调用EnableMotion接口使能Motion类型,当前支持拿起(HDF_MOTION_TYPE_PICKUP)、翻转(HDF_MOTION_TYPE_FLIP)、摇一摇(HDF_MOTION_TYPE_SHAKE)、旋转(HDF_MOTION_TYPE_ROTATION)等手势识别类型。

  4. 通过g_motionInterface实例调用DisableMotion接口去使能手势识别类型。

  5. 通过g_motionInterface实例调用Unregister取消订阅Motion数据回调函数。注意取消订阅必须先调用Register接口注册回调,否则Unregister会返回失败。

    测试代码实例如下:

    using namespace OHOS::HDI::Motion::V1_0;
    using namespace testing::ext;
    
    namespace {
        sptr<IMotionInterface> g_motionInterface = nullptr;
        sptr<IMotionCallback> g_motionCallback = new MotionCallbackService();
        sptr<IMotionCallback> g_motionCallbackUnregistered = new MotionCallbackService();
    }
    
    class HdfMotionTest : public testing::Test {
    public:
        static void SetUpTestCase();
        static void TearDownTestCase();
        void SetUp();
        void TearDown();
    };
    
    void HdfMotionTest::SetUpTestCase()
    {
        // 1.获取手势识别实例
        g_motionInterface = IMotionInterface::Get();
    }
    
    void HdfMotionTest::TearDownTestCase()
    {
    }
    
    void HdfMotionTest::SetUp()
    {
    }
    
    void HdfMotionTest::TearDown()
    {
    }
    
    HWTEST_F(HdfMotionTest, EnableMotion_001, TestSize.Level1)
    {
        if (g_motionInterface == nullptr) {
            ASSERT_NE(nullptr, g_motionInterface);
            return;
        }
    
        vector<int> vec;
        vec.push_back(HDF_MOTION_TYPE_PICKUP);
        vec.push_back(HDF_MOTION_TYPE_FLIP);
        vec.push_back(HDF_MOTION_TYPE_SHAKE);
        vec.push_back(HDF_MOTION_TYPE_ROTATION);
    
        // 2.订阅手势识别数据回调函数
        int32_t ret = g_motionInterface->Register(g_motionCallback);
        EXPECT_EQ(HDF_SUCCESS, ret);
    
        for (int i = 0; i < vec.size(); i++) {
            // 3.使能手势识别
            ret = g_motionInterface->EnableMotion(vec[i]);
            if (ret == HDF_SUCCESS) {
                printf("Motion %d enabled successfully\n", vec[i]);
            } else {
                printf("Motion %d enable failed\n", vec[i]);
            }
            EXPECT_EQ(HDF_SUCCESS, ret);
            OsalSleep(15);
            // 4.去使能手势识别
            ret = g_motionInterface->DisableMotion(vec[i]);
            if (ret == HDF_SUCCESS) {
                printf("Motion %d disabled successfully\n", vec[i]);
            } else {
                printf("Motion %d disable failed\n", vec[i]);
            }
            EXPECT_EQ(HDF_SUCCESS, ret);
            OsalSleep(2);
        }
        // 5.取消订阅手势识别数据回调函数
        ret = g_motionInterface->Unregister(g_motionCallback);
        EXPECT_EQ(HDF_SUCCESS, ret);
    }

OpenHarmony中基于HDF框架的驱动开发和使用 代码版本:openharmony 3.2 release。 阅读详情

相关推荐

OpenHarmony南向设备开发:子系统外设驱动使用-Motion

手势识别模块作为端侧设备不可或缺的一部分,为用户提供手势识别控制能力。

初一十五的博客 931

【OpenHarmony】MSDP设备状态感知模块架构

MSDP设备状态感知模块架构摘要 MSDP设备状态感知模块是OpenHarmonyOS的核心感知服务,提供设备状态识别和多设备协作能力。主要功能包括绝对静止感知、设备姿态识别、皮套开合检测、跨设备拖拽和屏幕协作等。模块采用分层架构设计,包含算法层、服务层和接口层,基于MSDP算法库处理传感器数据。核心类包括DeviceStatusService(服务实现)、DeviceStatusManager(状态管理)、StationaryManager(静止状态)和InteractionManager(交互控制)。

fakerth的博客 1428

鸿蒙南向开发(OpenHarmony)Motion驱动模型

手势识别模块作为端侧设备不可或缺的一部分,为用户提供手势识别控制能力。当前支持的手势识别类型有拿起、翻转、摇一摇、旋转屏等。

WEZC156465的博客 815

STM32移植MPU6050/9250的DMP官方库(motion_driver_6.12)修改移植 DMP简单使用教程

DMP库(Motion Driver 6.12) 移植到STM32F1/F4平台。 MPL接口使用教程与简述 基于对官方库文件略作修改,方便移植,简化步骤

qq_30938259的博客 6万+

除了点灯,在STM32F407上跑OpenHarmony还能做什么?聊聊外设驱动与生态拓展

本文探讨了在STM32F407微控制器上运行OpenHarmony操作系统的深度应用,从基础外设驱动开发到构建物联网节点的实践方案。详细解析了SPI、I2C、ADC等通信接口的驱动实现,并展示了环境监测、智能控制、边缘计算三大应用场景。同时介绍了OpenHarmony带来的组件化开发、分布式能力和现代工具链等范式转变,为开发者解锁MCU生态的无限可能。

weixin_30140399的博客 294

【信息科学与工程学】计算机科学与自动化——第一百五十五篇 缓存系统设计06

字段详细内容编号​B1类型​PaaS + MaaS(基于微服务 + 事件溯源 + CQRS + 国产化组件:鲲鹏CPU + 昇腾GPU + TiDB + Ceph国产版 + Kafka国产版 + 东方通中间件 + 华为云CDN + WebSocket + QUIC)问题​微服务 + 事件溯源 + 鲲鹏920 + 昇腾910 + TiDB + Ceph(XSKY)+ 国产Kafka + WebSocket + QUIC 电-热-力耦合:如何支持单个超大客户(10亿注册用户,5亿日活),每秒1亿条消息 + 10

weixin_49199313的博客 843

华为鸿蒙系统HarmonyOS学习之六:鸿蒙OpenHarmony常用术语说明

A Ability: 应用的重要组成部分,是应用所具备能力的抽象。Ability分为两种类型,Feature Ability和Particle Ability。AbilityForm:表单,是Feature Ability的一种界面展示形式,用于嵌入到其他应用中并作为其界面的一部分显示,并支持基础的交互功能。AbilitySlice:切片,是单个可视化界面及其交互逻辑的总和,是Feature Ability的组成单元。一个Feature Ability可以包含一组业务关系密切的可视化界面,每一...

jyl_sh的专栏 8615

motion driver 6.1

最新运动驱动库,支持MPU6050,MPU6500,MPU9150,MPU9250。stm32单片机例程

OpenHarmony外设驱动使用 (八),Motion

Motion驱动的主要工作是为上层MSDP服务提供稳定的使能/去使能手势识别服务,订阅/取消订阅手势识别数据回调函数的功能。可应用于拿起、翻转、摇一摇、旋转屏等手势识别场景。

__Benco的博客 839

MotionDriver v6.12官方手册翻译中文

MotionDriver v6.12官方手册翻译中文,API描述,硬件连接,接口描述

motion_driver_6.12.rar_dmp_motion_driver_motion driver_motion dr

新版本的MPU6050DMP库,支持9轴解决方案。

Flutter 三方库 motion_photos 的鸿蒙化适配指南 - 掌控动态照片解析、HEIC 跨端实战、鸿蒙级精密媒体资产专家

是一套专注于解决“静态图与视频流复合封装解析”的工业级方案。它通过提供一套严密的二进制字节流劫持与 XMP 协议解析矩阵,将看似普通的图片文件拆解为“高清静帧”与“动态短视频”。在鸿蒙端项目中,利用它你可以构建出具备高沉浸感的交互架构。无论是管理鸿蒙分布式任务下的精密媒体资产同步,还是在构建摄影类鸿蒙应用时实现一套代码通过字节偏移精准提取动态信息,它都能提供极致的工程确定性。该包通过对文件二进制结构的精密探测与跨端协议解析,实现了媒体资产的“语义穿透”。

好代码自己会说话,烂代码才需要注释来圆谎 4336

Motion Driver 6.12-移植指南1

2、连接硬件  选择MCU后,您很可能会拥有一个MCU评估套件或您自己的PCB板 3、Motion Driver 6.12固件包 Motion Driver 6

HarmonyOS 6 React Native鸿蒙跨平台采用了函数式组件的形式,通过 props 接收分类数据,使用 TouchableOpacity实现了点击交互效果

在React Native中开发鸿组件(这里指的是鸿蒙(HarmonyOS)组件),你需要了解鸿蒙开发的基础以及如何在React Native项目中集成鸿蒙应用。鸿蒙OS是由华为开发的一个分布式操作系统,主要用于其智能设备,如手机、平板、智能手表等。首先,你需要熟悉鸿蒙OS的开发环境设置和基本开发流程。React Native本身主要用于Harmony和Harmony平台的开发,但你可以通过以下几种方式将鸿蒙应用集成到React Native项目中:A. 使用WebView。

czhm57的博客 2088

Unity Animancer插件(一)基本使用

Animancer是什么?资源商店主页我们来通过Animancer实现一个最基本的动画播放效果。首先创建一个脚本,编写如下代码 很容易理解,就是在时播放一个指定的动画片段。接下来为角色添加、和刚刚编写的,并为字段赋值 接下来运行游戏就可以看到效果了 此时角色身上的组件可以看到当前动画的各项参数 下面我们来实现通过按键控制角色在于之间转换。新创建一个脚本。在代码中监听Y轴上的输入。然后根据监听到的数值判断角色状态,并播放相应的动画 给对应字段赋值后,启动游戏看下效果 下面来实现一个开枪效果。在默认状态下,角色

夜槿笙歌的博客 1万+

不用敲命令!用宝塔面板可视化部署pbootCMS的保姆级教程(2024最新版)

本文提供2024年最新版pbootCMS可视化部署教程,全程使用宝塔面板操作,无需任何命令行知识。从服务器初始化、LNMP环境配置到源码上传、安装向导,手把手指导用户通过图形化界面快速搭建专业网站,适合零基础新手和追求高效建站的用户。

weixin_42509507的博客 494

最新OpenHarmony系统一二级目录整理

由于Master分支代码更新迭代速度很快,部分目录结构可能在后面会发生变化。特别是高层次的部分代码。

坚果的博客 2871

更新3ds时和用读卡器读取传输文件操作不当导致的tf卡损坏无法读取需要格式化时出现的问题以及不想丢失文件并且修复的详细解决方法

前言: 不小心按了同意更新而且tf/sd卡损坏导致了3ds打开后都是出现 Anerror has occurred:(红色的) Failed to apply 1 FIRM patch(es). Press any button to shotdown 这样的画面,按了任意键后就关机,我找了很多资料和大佬的回答解决了这些问题,现在记录一下。 一.不小心按了更新导致上述的画面 原因:是因为系统升级了,但是里面的Luma3DS还没有更新,属于是更新了但没有完全更新的状态。 **修复方法** 1.首先请按

give_me_fish的博客 1万+

OpenHarmony 3.1 Release版本特性讲解

OpenHarmony 3.1 Release版本特性讲解

Havi 2168

DEA-Malmquist指数模型实战:从理论到应用的全流程解析

本文全面解析了DEA-Malmquist指数模型从理论到应用的全流程。文章详细阐述了该模型如何动态衡量效率随时间的变化,并将其分解为技术效率变化与技术进步,从而精准定位效率变动的根源。通过实战步骤演示了数据准备、软件操作(如DEAP 2.1)及结果解读,并结合水资源环境效率等案例,展示了其在包含非期望产出时的应用价值,为研究者进行动态效率分析提供了清晰指南。

b0c1d2的博客 223

我用 GPT-5.5 十分钟搞定一篇文献综述!附全流程指南

每一个框架中提出的逻辑链接,都必须至少有一篇提供文本中的文献作为支撑、严格禁止虚构变量、逻辑关系或研究结果、如果某些变量或关系在文本中未提及,必须明确声明“在提供的文本中未找到相关信息”、引用格式必须严格遵循原文提供的“作者/年份”格式,例如:[Smith, 2022]。各位同仁好,我是七哥。扫描提供的文献摘要,识别存在冲突的结果或理论、分析这些文献之间的差异,并总结可能导致差异的原因、输出一个结构化的学术争论段落,清楚呈现文献间的分歧和潜在影响因素、对于缺失或不明确的信息,按约束条件如实标注。

智能AI让学术科研更容易 372

MPU9250的Motion Driver

简述Motion Driver是Invensense的针对其Motion传感器的软件包,即Motion传感器的驱动,目前已支持MPU6050/MPU6500/MPU9150/MPU9250这些传感器。 Motion Driver并非全部开源,核心的算法部分是针对ARM处理器和MSP430处理器编译成了静态链接库提供的。Motion Driver文件结构 arm\STM32F4_MD6 do

suxiang198的博客 1万+

【考研高数-高等数学-基础】第一章 函数、极限、连续

第一章 函数、极限、连续 第二章 导数与微分 第三章 微分中值定理及导数应用 第四章 不定积分 第五章 定积分与反常积分 第六章 定积分的应用 第七章 微分方程 第八章 多元函数微分学 第九章 二重积分 第十章 无穷级数 第十一章 向量代数与空间解析几何及多元微分学在几何上的应用 第十二章 多元积分学及其应用 难题: 极限的递推 微分中值定理的证明题 定积分的不等式和等式的证明 重积分的不等式和等式的证明 线面积分的不等式和等...

刘鑫磊 2036
上一篇: 【入门到实战】OpenHarmony子系统外设驱动使用:Light
下一篇: 【入门到实战】OpenHarmony子系统外设驱动使用:Pin_auth
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值