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_id	osTimerNew 获取的计时器 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_t *	attr
	)

参数

[in]	func	计时器回调函数的起始地址。
[in]	type	osTimerOnce 用于一次性或 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_id	osTimerNew 获取的计时器 ID。
[in]	name	指向计时器对象名称的指针

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

事件记录器中的值显示：

• timer_id : 计时器 ID。

 

void EvrRtxTimerGetName	(	osTimerId_t	timer_id,
		const char *	name
	)

参数

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

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

事件记录器中的值显示：

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

 

void EvrRtxTimerStart	(	osTimerId_t	timer_id,
		uint32_t	ticks
	)

参数

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

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

事件记录器中的值显示：

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

 

void EvrRtxTimerStarted

(

osTimerId_t

timer_id

)

参数

[in]

timer_id

osTimerNew 获取的计时器 ID。

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

事件记录器中的值显示：

• timer_id : 计时器 ID。

 

void EvrRtxTimerStop

(

osTimerId_t

timer_id

)

参数

[in]

timer_id

osTimerNew 获取的计时器 ID。

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

事件记录器中的值显示：

• timer_id : 计时器 ID。

 

void EvrRtxTimerStopped

(

osTimerId_t

timer_id

)

参数

[in]

timer_id

osTimerNew 获取的计时器 ID。

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

事件记录器中的值显示：

• timer_id : 计时器 ID。

 

void EvrRtxTimerIsRunning	(	osTimerId_t	timer_id,
		uint32_t	running
	)

参数

[in]	timer_id	osTimerNew 获取的计时器 ID。
[in]	running	运行状态：0 未运行，1 运行。

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

事件记录器中的值显示：

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

 

void EvrRtxTimerDelete

(

osTimerId_t

timer_id

)

参数

[in]

timer_id

osTimerNew 获取的计时器 ID。

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

事件记录器中的值显示：

• timer_id : 计时器 ID。

 

void EvrRtxTimerDestroyed

(

osTimerId_t

timer_id

)

参数

[in]

timer_id

osTimerNew 获取的计时器 ID。

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

事件记录器中的值显示：

• timer_id : 计时器 ID。