GP Timer
==========
概述
----------
通用定时器（ General Purpose Timer ， GP Timer 或 GTMR ），当内部计数器计数到指定值时会产生定时中断，指定值由软件配置。

.. image:: ../../../_static/GP_Timer.png
    :align: center

.. centered:: 系统中的 GP imer

WQ7036 每个子系统有一组 GP timer ，每组 GP timer 包含 4 个定时器，可以满足系统各种复杂的定时需求。

功能特性
--------------------
GP Timer 主要支持如下特性：

- 32bit 的计数数值。
- 向上计数。
- 设置溢出阈值。
- 通过 GPIO 输入将计数器锁存。
- 软件暂停计数和清零。
- 四路独立的定时器。
- 两路定时器级联以实现 64bit 计数。

工作模式
------------
调用 :cpp:func:`wq_timer_init` 函数时，则 TIMER 有以下工作特征：

- timer 默认支持级联模式，前两个计数器（ timer0 与 timer1 ）可以级联成一个 64bit 的计数器。
- timer0 与 timer1 被设置为计数到指定值后，计数器仍继续计数。
- 剩余 timer 控制器被设置为计数到指定值后，计数器保持当前数值并不再计数。
- 所有 timer 控制器禁用 div 模式，切换到 1M tick 模式。
- 开启 timer0 。

资源依赖
---------------
- GTIMER

用法流程
-------------

- 初始化 :cpp:func:`wq_timer_init`
- 获取现 timer0 计数值 （ 32bit ） :cpp:func:`wq_timer_get_time`
- 获取现 timer0 与 timer1 的组合计数值 （ 64bit ） :cpp:func:`wq_timer_get_time64`
- 利用 timer0 延迟微秒时间 :cpp:func:`wq_timer_delay_us`
- 利用 timer0 延迟毫秒时间 :cpp:func:`wq_timer_delay_ms`
- 创建 timer （ 从前两个计数器之后开始申请 ）处理句柄 :cpp:func:`wq_timer_create`
- 开启 timer :cpp:func:`wq_timer_start`
- 关闭 timer :cpp:func:`wq_timer_stop`
- 删除 timer :cpp:func:`wq_timer_delete`

参考示例
-----------

::

    /examples/timer_demo/

API 介绍
-----------

.. doxygenfile:: wq_timer.h