CMSIS-RTOS2 文档翻译 之 参考(RTX5 特定的 API 之 事件功能(定时器函数))

定时器函数

事件功能

定时器函数生成的事件。更多...

函数

void EvrRtxTimerError (osTimerId_t timer_id, int32_t status)
 计时器错误事件(错误)更多...
 
void EvrRtxTimerCallback (osTimerFunc_t func, void *argument)
 定时器回调函数(Op)上的事件 更多...
 
void EvrRtxTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)
 计时器上的事件创建和初始化(API)更多...
 
void EvrRtxTimerCreated (osTimerId_t timer_id, const char *name)
 成功计时器创建活动(Op)更多...
 
void EvrRtxTimerGetName (osTimerId_t timer_id, const char *name)
 计时器名称检索(API)上的事件 更多...
 
void EvrRtxTimerStart (osTimerId_t timer_id, uint32_t ticks)
 计时器启动事件(API)更多...
 
void EvrRtxTimerStarted (osTimerId_t timer_id)
 成功定时器启动事件(Op)更多......
 
void EvrRtxTimerStop (osTimerId_t timer_id)
 计时器停止事件(API)更多...
 
void EvrRtxTimerStopped (osTimerId_t timer_id)
 成功定时器停止事件(Op)更多...
 
void EvrRtxTimerIsRunning (osTimerId_t timer_id, uint32_t running)
 计时器运行状态检查(API)上的事件 更多...
 
void EvrRtxTimerDelete (osTimerId_t timer_id)
 计时器删除事件(API)更多...
 
void EvrRtxTimerDestroyed (osTimerId_t timer_id)
 成功定时删除事件(Op)更多...
 

 

描述

函数文档

void EvrRtxTimerError(osTimerId_t timer_id,
  int32_t status 
 )  

参数

[in]timer_idosTimerNew 获取的计时器 ID,ID 未知时为 NULL。
[in]status扩展执行状态。

当定时器管理例程由于错误而完成执行时,会生成 TimerError 事件。

status 参数指示执行状态,可以是 osStatus_t 代码之一,也可以是下表中汇总的扩展执行状态代码之一。

扩展状态代码描述
osRtxErrorKernelNotReady内核调度程序未处于就绪状态。
osRtxErrorKernelNotRunning内核调度程序没有执行 - 没有正在运行的线程。
osRtxErrorInvalidControlBlock指定了具有无效对齐或大小的对象控制块。
osRtxErrorInvalidDataMemory指定了无效对齐或大小的对象数据存储器。
osRtxErrorInvalidThreadStack指定了无效对齐或大小的线程堆栈内存。
osRtxErrorInvalidPriority指定了无效的线程优先级。
osRtxErrorThreadNotJoinable指定的线程不可连接。
osRtxErrorMutexNotOwned指定的互斥锁不归当前运行的线程所有。
osRtxErrorMutexNotLocked指定的互斥锁未锁定。
osRtxErrorMutexLockLimit达到的最大递归互斥锁数。
osRtxErrorSemaphoreCountLimit达到了信号量计数限制。
osRtxErrorTZ_InitContext_S安全上下文内存系统初始化失败
osRtxErrorTZ_AllocContext_S安全上下文内存分配失败。
osRtxErrorTZ_FreeContext_S安全上下文内存释放失败。
osRtxErrorTZ_LoadContext_S安全上下文加载失败。
osRtxErrorTZ_SaveContext_S安全上下文保存失败。

事件记录器中的值显示:

  • timer_id : 计时器 ID。
  • status : 执行状态代码。

 

void EvrRtxTimerCallback(osTimerFunc_t func,
  void * argument 
 )  

参数

[in]func计时器回调函数的起始地址。
[in]argument定时器回调函数的参数。

调用定时器回调函数时会生成 TimerCallback 事件。

事件记录器中的值显示:

  • func : 计时器回调函数的起始地址。
  • argument : 定时器回调函数的参数的内存地址。

 

void EvrRtxTimerNew(osTimerFunc_t func,
  osTimerType_t type,
  void * argument,
  const osTimerAttr_tattr 
 )  

参数

[in]func计时器回调函数的起始地址。
[in]typeosTimerOnce 用于一次性或 osTimerPeriodic 用于定期行为。
[in]argument定时器回调函数的参数。
[in]attr计时器属性。

调用函数 osTimerNew 时会生成事件 TimerNew

事件记录器中的值显示:

  • func : 计时器回调函数的起始地址。
  • type : 计时器类型:用于一次性的 osTimerOnce 或用于周期性行为的 osTimerPeriodic。
  • argument : 定时器回调函数的参数的内存地址。
  • attr : 定时器属性的内存地址,如果未指定,则为 0。

如果在 API 调用中提供了计时器属性,则它们也会在事件记录器中详细说明。

 

void EvrRtxTimerCreated(osTimerId_t timer_id,
  const char * name 
 )  

参数

[in]timer_idosTimerNew 获取的计时器 ID。
[in]name指向计时器对象名称的指针

当函数 osTimerNew 成功创建计时器对象时,将生成事件 TimerCreated

事件记录器中的值显示:

  • timer_id : 计时器 ID。

 

void EvrRtxTimerGetName(osTimerId_t timer_id,
  const char * name 
 )  

参数

[in]timer_idosTimerNew 获取的计时器 ID。
[in]name指向计时器对象名称的指针

调用函数 osTimerGetName 并且其执行结果已知时,将生成事件 TimerGetName

事件记录器中的值显示:

  • timer_id : 计时器 ID。
  • name : 检索名称字符串的内存地址(如果发生故障,则为 0)。

 

void EvrRtxTimerStart(osTimerId_t timer_id,
  uint32_t ticks 
 )  

参数

[in]timer_idosTimerNew 获取的计时器 ID。
[in]ticks时间滴答计时器的值。

调用函数 osTimerStart 时会生成事件 TimerStart

事件记录器中的值显示:

  • timer_id : 计时器 ID。
  • ticks : 时间滴答计时器的值。

 

void EvrRtxTimerStarted(osTimerId_t timer_id) 

参数

[in]timer_idosTimerNew 获取的计时器 ID。

当函数 osTimerStart 成功启动或重新启动计时器操作时,将生成事件 TimerStarted

事件记录器中的值显示:

  • timer_id : 计时器 ID。

 

void EvrRtxTimerStop(osTimerId_t timer_id) 

参数

[in]timer_idosTimerNew 获取的计时器 ID。

调用函数 osTimerStop 时会生成 TimerStop 事件。

事件记录器中的值显示:

  • timer_id : 计时器 ID。

 

void EvrRtxTimerStopped(osTimerId_t timer_id) 

参数

[in]timer_idosTimerNew 获取的计时器 ID。

当函数 osTimerStop 成功停止计时器操作时,将生成 TimerStopped 事件。

事件记录器中的值显示:

  • timer_id : 计时器 ID。

 

void EvrRtxTimerIsRunning(osTimerId_t timer_id,
  uint32_t running 
 )  

参数

[in]timer_idosTimerNew 获取的计时器 ID。
[in]running运行状态:0 未运行,1 运行。

调用函数 osTimerIsRunning 并且其执行结果已知时,将生成事件 TimerIsRunning

事件记录器中的值显示:

  • timer_id : 计时器 ID。
  • running : 定时器运行状态:0 未运行,1 运行。

 

void EvrRtxTimerDelete(osTimerId_t timer_id) 

参数

[in]timer_idosTimerNew 获取的计时器 ID。

调用函数 osTimerDelete 时会生成事件 TimerDelete

事件记录器中的值显示:

  • timer_id : 计时器 ID。

 

void EvrRtxTimerDestroyed(osTimerId_t timer_id) 

参数

[in]timer_idosTimerNew 获取的计时器 ID。

当函数 osTimerDelete 成功删除计时器对象时,将生成 TimerDestroyed 事件。

事件记录器中的值显示:

  • timer_id : 计时器 ID。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值