WatchDog 
===========
1. **简介**
--------------
    AIOT-3568A设有看门狗模块，可以设置和获取看门狗的开关状态，也可以实现开门狗喂狗。

2. **HDC相关指令**
--------------
   
    暂无


3. **标准API使用方法**
--------------

.. note::
    
        本模块提供shimeta所有自研API的调用，该接口持续更新。

+ **shimeta标准接口++**

     **@ohos.shimeta**

+ **API使用说明**

    使用WIFI相关API开发时候，需要先了解熟悉第一个open Harmony工程的创建，相关文档

.. seealso::
    :doc:`Hello World应用以及部署<../../Quick-Start/OpenHarmony/04-应用以及部署>`

在使用一个API时，需要注意以下几点：
  + API权限说明
  + API的参数与返回值
  + API调用错误的时候，参考API错误码和通用错误码
  + API示例的正确使用     

    看门狗相关API具体文档可跳转
    　
.. seealso::
    :doc:`看门狗相关API<../../ShiMetaOs/OpenHarmony系统/API文档/02-ShiMetaAPI接口>`

4. **社区Demo**
--------------
.. note::
    社区示例加快正在制作中，敬请等待！将会呈现更优质的内容给各位小伙伴！！

+ **导入模块**

    在使用看门狗API的时候，最重要的一步是导入shimeta的接口。通常模块导入是在文件头导入
    导入模块如下：

    **import shimeta from '@ohos.shimeta'**


+ **shimeta.sys_setWatchDog(设置开门狗开关状态)**

        + sys_setWatchDog(enable: boolean, poweroffTime: number): Promise<void>;


    参数说明：
       .. code-block:: c++
           
           enable:boolean 
                
                true:打开 false:关闭
            
            poweroff_time:number

                 不喂狗之后的关机时间，默认为60秒。单位:秒

   .. note::
    接口中的poweroff_time参数暂未支持，默认60秒


   API使用示例：
        .. code-block:: TypeScript
            :linenos:
     
                import shimeta from '@ohos.shimeta'
                import { BusinessError } from '@ohos.base';

                shimeta.sys_setWatchDog(true, 60).then(() => {
                promptAction.showToast({
                    message: `sys_setWatchDog result success`
                })
                }).catch((err: BusinessError) => {
                console.error("error message: " + err.message + ", error code: " + err.code);
                });


   2、shimeta.sys_getWatchDog(获取开门狗开关状态)

        + sys_getWatchDog(): Promise<number>;


   API使用示例：
        .. code-block:: TypeScript
            :linenos:
     
                import shimeta from '@ohos.shimeta'
                import { BusinessError } from '@ohos.base';

                shimeta.sys_getWatchDog().then((result: number) => {
                Logger.d(TAG, "getWatchDog result:" + result);
                this.watchDogEnable = result == 1 ? `true` : `false`
                promptAction.showToast({
                    message: `sys_getWatchDog result :${result}`
                })
                }).catch((err: BusinessError) => {
                console.error("error message: " + err.message + ", error code: " + err.code);
                });

   3、shimeta.sys_setWatchDogFeed(开门狗喂狗)

        + sys_setWatchDogFeed(): Promise<void>;


   API使用示例：
        .. code-block:: TypeScript
            :linenos:
     
                import shimeta from '@ohos.shimeta'
                import { BusinessError } from '@ohos.base';

                shimeta.sys_setWatchDogFeed().then(() => {
                promptAction.showToast({
                    message: `sys_setWatchDogFeed result success`
                })
                }).catch((err: BusinessError) => {
                console.error("error message: " + err.message + ", error code: " + err.code);
                });

5. **代码编译**
--------------
.. tip::
   代码编译详细流程可见，:doc:`Hello World应用以及部署<../../Quick-Start/OpenHarmony/04-应用以及部署>`  中的第二部分（构建第一个页面部分内容）

6. **代码运行效果**
--------------
.. note::
    社区示例加快正在制作中，敬请等待！将会呈现更优质的内容给各位小伙伴！！