Harmony鸿蒙南向驱动开发-Watchdog接口使用

🕗 发布于 2024-04-13 12:20 harmonyos 华为鸿蒙鸿蒙系统驱动开发

功能简介

看门狗（Watchdog），又称看门狗计时器（Watchdog timer），是一种硬件计时设备。一般有一个输入、一个输出，输入叫做喂狗，输出连接到系统的复位端。当系统主程序发生错误导致未及时清除看门狗计时器的计时值时，看门狗计时器就会对系统发出复位信号，使系统从悬停状态恢复到正常运作状态。

Watchdog接口定义了看门狗操作的通用方法集合，包括：

打开/关闭看门狗设备
启动/停止看门狗设备
设置/获取看门狗设备超时时间
获取看门狗设备状态
喂狗

基本概念

系统正常工作的时候，每隔一段时间输出一个信号到喂狗端，给看门狗清零，这个操作就叫做喂狗。如果超过规定的时间不喂狗，看门狗定时超时，就会给出一个复位信号到系统，使系统复位。

运作机制

在HDF框架中，Watchdog模块接口适配模式采用独立服务模式，如图1所示。在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDF设备管理器的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用。

独立服务模式下，核心层不会统一发布一个服务供上层使用，因此这种模式下驱动要为每个控制器发布一个服务，具体表现为：

驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。
device_info.hcs文件中deviceNode的policy字段为1或2，不能为0。

Watchdog模块各分层作用：

接口层提供打开看门狗设备、获取看门狗设备状态、启动看门狗设备、设置看门狗设备超时时间、获取看门狗设备超时时间、喂狗、停止看门狗设备超时时间、关闭看门狗设备的接口。
核心层主要提供看门狗控制器的添加、移除以及管理的能力，通过钩子函数与适配层交互。
适配层主要是将钩子函数的功能实例化，实现具体的功能。

图 1 Watchdog独立服务模式结构图

Watchdog独立服务模式结构图

使用指导

场景介绍

对于无法直接观测到的软件异常，我们可以使用看门狗进行自动检测，并在异常产生时及时重置。

接口说明

Watchdog模块提供的主要接口如表1所示，具体API详见//drivers/hdf_core/framework/include/platform/watchdog_if.h。

表 1 看门狗API接口功能介绍

接口名	描述
int32_t WatchdogOpen(int16_t wdtId, DevHandle *handle)	打开看门狗
void WatchdogClose(DevHandle handle)	关闭看门狗
int32_t WatchdogStart(DevHandle handle)	启动看门狗
int32_t WatchdogStop(DevHandle handle)	停止看门狗
int32_t WatchdogSetTimeout(DevHandle handle, uint32_t seconds)	设置看门狗超时时间
int32_t WatchdogGetTimeout(DevHandle handle, uint32_t *seconds)	获取看门狗超时时间
int32_t WatchdogGetStatus(DevHandle handle, int32_t *status)	获取看门狗状态
int32_t WatchdogFeed(DevHandle handle)	清除看门狗定时器（喂狗）

说明：
本文涉及的看门狗的所有接口，支持内核态及用户态使用。

开发步骤

使用看门狗的一般流程如下图所示。

图 2 看门狗使用流程图

看门狗使用流程图

打开看门狗设备

在操作看门狗之前，需要调用WatchdogOpen打开看门狗设备，一个系统可能有多个看门狗，通过看门狗ID号来打开指定的看门狗设备：

DevHandle WatchdogOpen(int16_t wdtId, DevHandle *handle);

表 2 WatchdogOpen参数和返回值描述

参数	参数描述
wdtId	int16_t类型，看门狗设备号
handle	DevHandle类型，看门狗设备句柄
返回值	返回值描述
HDF_SUCCESS	打开看门狗设备成功
负数	打开看门狗设备失败

int16_t wdtId = 0;
int32_t ret;
DevHandle *handle = NULL;

ret = WatchdogOpen(wdtId, handle);    // 打开0号看门狗设备
if (ret != HDF_SUCCESS) {
    HDF_LOGE("WatchdogOpen: open watchdog_%hd failed, ret:%d\n", wdtId, ret);
    return ret;
}

获取看门狗状态

int32_t WatchdogGetStatus(DevHandle handle, int32_t *status);

表 3 WatchdogGetStatus参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄
status	int32_t类型指针，获取到的看门狗状态
返回值	返回值描述
HDF_SUCCESS	获取看门狗状态成功
负数	获取看门狗状态失败

int32_t ret;
int32_t status;

ret = WatchdogGetStatus(handle, &status);    // 获取Watchdog状态
if (ret != HDF_SUCCESS) {
    HDF_LOGE("WatchdogGetStatus: watchdog get status failed, ret:%d\n", ret);
    return ret;
}

设置超时时间

int32_t WatchdogSetTimeout(DevHandle *handle, uint32_t seconds);

表 4 WatchdogSetTimeout参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄
seconds	uint32_t类型，超时时间，单位为秒
返回值	返回值描述
HDF_SUCCESS	设置成功
负数	设置失败

int32_t ret;

ret = WatchdogSetTimeout(handle, 2);    // 设置超时时间2秒
if (ret != HDF_SUCCESS) {
    HDF_LOGE("WatchdogSetTimeout: watchdog set timeOut failed, ret:%d\n", ret);
    return ret;
}

获取超时时间

int32_t WatchdogGetTimeout(DevHandle *handle, uint32_t *seconds);

表 5 WatchdogGetTimeout参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄
seconds	uint32_t类型指针，获取的看门狗超时时间
返回值	返回值描述
HDF_SUCCESS	获取看门狗超时时间成功
负数	获取看门狗超时时间失败

 int32_t ret;
 uint32_t timeOut;

 ret = WatchdogGetTimeout(handle, &timeOut);     // 获取超时时间
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("WatchdogGetTimeout: watchdog get timeOut failed, ret:%d\n", ret);
     return ret;
 }

启动看门狗

int32_t WatchdogStart(DevHandle handle);

表 6 WatchdogStart参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄
返回值	返回值描述
HDF_SUCCESS	启动看门狗成功
负数	启动看门狗失败

int32_t ret;

ret = WatchdogStart(handle);    // 启动看门狗
if (ret != HDF_SUCCESS) {
    HDF_LOGE("WatchdogStart: start watchdog failed, ret:%d\n", ret);
    return ret;
}

喂狗

int32_t WatchdogFeed(DevHandle handle);

表 7 WatchdogFeed参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄
返回值	返回值描述
HDF_SUCCESS	喂狗成功
负数	喂狗失败

int32_t ret;

ret = WatchdogFeed(handle);    // 喂狗
if (ret != HDF_SUCCESS) {
    HDF_LOGE("WatchdogFeed: feed watchdog failed, ret:%d\n", ret);
    return ret;
}

停止看门狗

int32_t WatchdogStop(DevHandle handle);

表 8 WatchdogStop参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄
返回值	返回值描述
HDF_SUCCESS	停止看门狗成功
负数	停止看门狗失败

int32_t ret;

ret = WatchdogStop(handle);    // 停止看门狗
if (ret != HDF_SUCCESS) {
    HDF_LOGE("WatchdogStop: stop watchdog failed, ret:%d\n", ret);
    return ret;
}

关闭看门狗设备

当所有操作完毕后，调用WatchdogClose关闭打开的看门狗设备：

void WatchdogClose(DevHandle handle);

表 9 WatchdogClose参数和返回值描述

参数	参数描述
handle	DevHandle类型，看门狗设备句柄

WatchdogClose(handle);    // 关闭看门狗

使用实例

下面将基于Hi3516DV300开发板展示使用Watchdog完整操作，步骤主要如下：

传入看门狗ID号，及空的描述句柄，打开看门狗设备并获得看门狗设备句柄。
通过看门狗设备句柄及超时时间，设置看门狗设备超时时间。
通过看门狗设备句柄及待获取超时时间，获取看门狗设备超时时间。
通过看门狗设备句柄启动看门狗设备。
通过看门狗设备句柄喂狗。
通过看门狗设备句柄停止看门狗设备。
通过看门狗设备句柄关闭看门狗设备。

#include "watchdog_if.h"              // watchdog标准接口头文件
#include "hdf_log.h"                  // 标准日志打印头文件
#include "osal_time.h"                // 标准延迟&睡眠接口头文件

#define WATCHDOG_TEST_TIMEOUT     2
#define WATCHDOG_TEST_FEED_TIME   6

static int32_t TestCaseWatchdog(void)
{
    int32_t i;
    int32_t ret;
    int16_t wdtId = 0;
    int32_t status;
    uint32_t timeout;
    DevHandle *handle = NULL;

    // 打开0号看门狗设备
    ret = WatchdogOpen(wdtId, handle);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: open watchdog_%hd failed, ret:%d\n", wdtId, ret);
        return ret;
    }

    // 设置超时时间
    ret = WatchdogSetTimeout(handle, WATCHDOG_TEST_TIMEOUT);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: set timeout fail! ret:%d\n", ret);
        WatchdogClose(handle);
        return ret;
    }

    // 获取超时时间
    ret = WatchdogGetTimeout(handle, &timeout);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: get timeout fail! ret:%d\n", ret);
        WatchdogClose(handle);
        return ret;
    }
    // 比较设置与获取的超时时间是否一致
    if (timeout != WATCHDOG_TEST_TIMEOUT) {
        HDF_LOGE("TestCaseWatchdog: set:%u, but get:%u", WATCHDOG_TEST_TIMEOUT, timeout);
        WatchdogClose(handle);
        return HDF_FAILURE;
    }
    HDF_LOGI("TestCaseWatchdog: read timeout back:%u\n", timeout);

    // 启动看门狗，开始计时
    ret = WatchdogStart(handle);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: start fail! ret:%d\n", ret);
        WatchdogClose(handle);
        return ret;
    }
    // 获取看门狗状态，是否启动
    status = WATCHDOG_STOP;
    ret = WatchdogGetStatus(handle, &status);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: get status fail! ret:%d", ret);
        WatchdogClose(handle);
        return ret;
    }
    if (status != WATCHDOG_START) {
        HDF_LOGE("TestCaseWatchdog: status is:%d after start", status);
        WatchdogClose(handle);
        return HDF_FAILURE;
    }

    // 每隔1S喂狗一次
    for (i = 0; i < WATCHDOG_TEST_FEED_TIME; i++) {
        HDF_LOGI("TestCaseWatchdog: feeding watchdog %d times... \n", i);
        ret = WatchdogFeed(handle);
        if (ret != HDF_SUCCESS) {
            HDF_LOGE("TestCaseWatchdog: feed dog fail! ret:%d\n", ret);
            WatchdogClose(handle);
            return ret;
        }
        OsalSleep(1);
    }
    // 由于喂狗间隔小于超时时间，系统不会发生复位，此日志可以正常打印
    HDF_LOGI("TestCaseWatchdog: no reset ... feeding test OK!!!\n");

    ret = WatchdogStop(handle);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: stop fail! ret:%d", ret);
        WatchdogClose(handle);
        return ret;
    }
    // 获取看门狗状态，是否停止
    status = WATCHDOG_START;
    ret = WatchdogGetStatus(handle, &status);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseWatchdog: get status fail! ret:%d", ret);
        WatchdogClose(handle);
        return ret;
    }
    if (status != WATCHDOG_STOP) {
        HDF_LOGE("TestCaseWatchdog: status is:%d after stop", status);
        WatchdogClose(handle);
        return HDF_FAILURE;
    }
    WatchdogClose(handle);
    HDF_LOGD("TestCaseWatchdog: function tests end.");
    return HDF_SUCCESS;
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

ArkTS语言
安装DevEco Studio
运用你的第一个ArkTS应用
ArkUI声明式UI开发
.……

《鸿蒙开发进阶》

Stage模型入门
网络管理
数据管理
电话服务
分布式应用开发
通知与窗口管理
多媒体技术
安全技能
任务管理
WebGL
国际化开发
应用测试
DFX面向未来设计
鸿蒙系统移植和裁剪定制
……

《鸿蒙进阶实战》

ArkTS实践
UIAbility应用
网络案例
……

获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

原文地址：https://blog.csdn.net/m0_64420071/article/details/137687723

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：「代码之舞：选择成为程序员的兴趣与职业发展」
下一篇：国外站群服务器有哪几种?

vue3 + element-plus 的 upload + axios + django 文件上传并保存
之前在网上搜了好多教程，一直没有找到合适自己的，要么只有前端部分没有后端，要么就是写的不是很明白。所以还得靠自己摸索出来后，来此记录一下整个过程。环境安装什么的就不讲了，直接上代码好吧，这个是样式图。
阅读更多2024-11-06
Cuebric：用AI重新定义3D创作的未来
Cuebric 是一家成立于2022年夏天的好莱坞创新公司，致力于为电影、电视、游戏和时尚等行业提供先进的AI多模态SaaS平台。自2024年1月正式推出以来，Cuebric 已经在市场上获得了广泛的
阅读更多2024-11-06
easyui+vue 数据表更新问题的解决
数据的增删改查可以实时刷新出来,不建议在封装组件。nextTick 保证DOM 渲染完成。
阅读更多2024-11-06
软件测试基础：单元测试与集成测试
单元测试和集成测试是软件测试的基础，它们的重要性不言而喻。通过对软件的不同部分进行有序的测试，可以提高软件质量、减少后期维护成本，保证软件的可靠性和稳定性。软件开发者和测试人员应当重视并深入理解单元测
阅读更多2024-11-06
RxJS基本介绍以及与Promise的区别
Promise 适合处理单一的异步操作，具有更简单的 API，但缺乏灵活性和对多值的支持。RxJS (Observable) 适合处理复杂的异步流和多事件流，具有更多的操作符、错误处理机制和强大的组合
阅读更多2024-11-06
第三节 Vim编辑器与Shell命令脚本
这里的脚本主要使用 ping 命令来测试与对方主机的网络连通性，而 Linux 系统中的 ping 命令不像 Windows 一样尝试 4 次就结束，因此为了避免用户等待时间过长，需要通过-c 参数来
阅读更多2024-11-06
【JavaEE初阶 — 多线程】线程安全问题＆ synchronized
【JavaEE初阶 — 多线程】线程安全问题＆ Synchronized观察线程安全问题，分析了造成线程安全问题造成的三个原因：线程的随机调度，多个线程修改共享数据（修改同一个变量），以及原子性问题
阅读更多2024-11-06
十月末补充（？
【代码】十月末补充（？
阅读更多2024-11-06
13-鸿蒙开发中的综合实战：华为登录界面
通过本文，你已经学会了如何在鸿蒙开发中实现一个简单的登录界面，涵盖了输入框组件、按钮组件、文本组件和布局容器的使用。这个实战项目不仅帮助你巩固了基础知识，还提供了一个实际的应用场景。希望这篇文章对你有
阅读更多2024-11-06
python全栈开发《59.集合的增删改》
目录1.集合的add函数2.集合的update函数3.集合的remove函数4.集合的clear函数5.用del删除集合6.重要说明7.代码1.集合的add函数1.1add的功能用于集合中添加一个元素
阅读更多2024-11-06