mirror of
https://github.com/openharmony/drivers_framework.git
synced 2026-08-27 10:51:15 -04:00
s00442234
101 lines
2.7 KiB
C
Executable File
101 lines
2.7 KiB
C
Executable File
/*
|
|
* Copyright (c) 2022 Huawei Device Co., Ltd.
|
|
*
|
|
* HDF is dual licensed: you can use it either under the terms of
|
|
* the GPL, or the BSD license, at your option.
|
|
* See the LICENSE file in the root of this repository for complete details.
|
|
*/
|
|
|
|
|
|
#ifndef TIMER_IF_H
|
|
#define TIMER_IF_H
|
|
|
|
#include "platform_if.h"
|
|
|
|
#ifdef __cplusplus
|
|
#if __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
#endif /* __cplusplus */
|
|
|
|
/**
|
|
* @brief Defines a callback that will be invoked when a timer's interrupt involved.
|
|
*/
|
|
typedef int32_t (*TimerHandleCb)(void);
|
|
|
|
/**
|
|
* @brief Gets a timer.
|
|
* This function must be called to get its device handle before operating the timer.
|
|
* @param number Indicates a timer id.
|
|
* @return If the operation is successful, a pointer to the timer device handle is returned.
|
|
* @since 1.0
|
|
*/
|
|
DevHandle TimerOpen(const uint32_t number);
|
|
|
|
/**
|
|
* @brief Close a timer.
|
|
* If you no longer need the timer, call this function to close it
|
|
* @param handle Represents a pointer to the timer device handle.
|
|
* @since 1.0
|
|
*/
|
|
void TimerClose(DevHandle handle);
|
|
|
|
/**
|
|
* @brief Start a timer.
|
|
* If you need the timer run, call this function to start it
|
|
* @param handle Represents a pointer to the timer device handle.
|
|
* @return success or fail
|
|
* @since 1.0
|
|
*/
|
|
int32_t TimerStart(DevHandle handle);
|
|
|
|
/**
|
|
* @brief Stop a timer.
|
|
* If you no longer need the timer run, call this function to stop it
|
|
* @param handle Represents a pointer to the timer device handle.
|
|
* @return success or fail
|
|
* @since 1.0
|
|
*/
|
|
int32_t TimerStop(DevHandle handle);
|
|
|
|
/**
|
|
* @brief Set a period timer.
|
|
* If you need the timer run, call this function to set timer info
|
|
* @param handle Represents a pointer to the timer device handle.
|
|
* @param useconds Represents the timer interval.
|
|
* @param cb Represents the timer callback function.
|
|
* @return success or fail
|
|
* @since 1.0
|
|
*/
|
|
int32_t TimerSet(DevHandle handle, uint32_t useconds, TimerHandleCb cb);
|
|
|
|
/**
|
|
* @brief Set a oneshot timer.
|
|
* If you need the timer run, call this function to set timer info
|
|
* @param useconds Represents the timer interval.
|
|
* @param cb Represents the timer callback function.
|
|
* @return success or fail
|
|
* @since 1.0
|
|
*/
|
|
int32_t TimerSetOnce(DevHandle handle, uint32_t useconds, TimerHandleCb cb);
|
|
|
|
/**
|
|
* @brief Get the timer info.
|
|
* If you need the timer info, call this function get
|
|
* @param handle Represents a pointer to the timer device handle.
|
|
* @param useconds Represents the timer interval.
|
|
* @param isPeriod Represents whether the timer call once
|
|
* @return success or fail
|
|
* @since 1.0
|
|
*/
|
|
int32_t TimerGet(DevHandle handle, uint32_t *useconds, bool *isPeriod);
|
|
|
|
#ifdef __cplusplus
|
|
#if __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* TIMER_IF_H */
|
|
/** @} */
|