第 6 章 - Azure RTOS ThreadX 跟踪事件

本章介绍 Azure RTOS ThreadX 事件。

事件和图标列表

下面是由 TraceX 显示的 ThreadX 事件的列表:

图标 含义
“继续内部线程”图标 继续内部线程
“暂停内部线程”图标 暂停内部线程
“进入中断服务例程”图标 进入中断服务例程 (ISR)
“退出中断服务例程”图标 退出中断服务例程 (ISR)
“内部时间切片”图标 内部时间切片
“正在运行”图标 正在运行
“分配块池”图标 分配块池 (tx_block_allocate)
“创建块池”图标 创建块池 (tx_block_pool_create)
“删除块池”图标 删除块池 (tx_block_pool_delete)
“获取块池信息”图标 获取块池信息 (tx_block_pool_info_get)
“获取块池性能信息”图标 获取块池性能信息 (tx_block_pool_performance_info_get)
“获取块池系统性能信息”图标 获取块池系统性能信息 (tx_block_pool_performance_system_info_get)
“设置块池优先级”图标 设置块池优先级 (tx_block_pool_prioritize)
“块释放到池”图标 块释放到池 (tx_block_release)
“字节池分配内存”图标 字节池分配内存 (tx_byte_allocate)
“创建字节池”图标 创建字节池 (tx_byte_pool_create)
“删除字节池”图标 删除字节池 (tx_byte_pool_delete)
“获取字节池信息”图标 获取字节池信息 (tx_byte_pool_info_get)
“获取字节池性能信息”图标 获取字节池性能信息 (tx_byte_pool_performance_info_get)
“获取字节池系统性能信息”图标 获取字节池系统性能信息 (tx_byte_pool_performance_system_info_get)
“设置字节池优先级”图标 设置字节池优先级 (tx_byte_pool_prioritize)
“字节内存释放到池”图标 字节内存释放到池 (tx_byte_release)
“创建事件标志”图标 创建事件标志 (tx_event_flags_create)
“删除事件标志”图标 删除事件标志 (tx_event_flags_delete)
“获取事件标志”图标 获取事件标志 (tx_event_flags_get)
“获取事件标志信息”图标 获取事件标志信息 (tx_event_flags_info_get)
“获取事件标志性能信息”图标 获取事件标志性能信息 (tx_event_flags_performance_info_get)
“获取事件标志系统性能信息”图标 获取事件标志系统性能信息 (tx_event_flags_performance_system_info_get)
“设置事件标志”图标 设置事件标志 (tx_event_flags_set)
“事件标志设置通知”图标 事件标志设置通知 (tx_event_flags_set_notify)
“启用/禁用中断”图标 启用/禁用中断 (tx_interrupt_control)
“创建互斥体”图标 创建互斥体 (tx_mutex_create)
“删除互斥体”图标 删除互斥体 (tx_mutex_delete)
“获取互斥体”图标 获取互斥体 (tx_mutex_get)
“获取互斥体信息”图标 获取互斥体信息 (tx_mutex_info_get)
“获取互斥体性能信息”图标 获取互斥体性能信息 (tx_mutex_performance_info_get)
“获取互斥体系统性能信息”图标 获取互斥体系统性能信息 (tx_mutex_performance_system_info_get)
“设置互斥体优先级”图标 设置互斥体优先级 (tx_mutex_prioritize)
“放置互斥体”图标 放置互斥体 (tx_mutex_put)
“创建队列”图标 创建队列 (tx_queue_create)
“删除队列”图标 删除队列 (tx_queue_delete)
“刷新队列”图标 刷新队列 (tx_queue_flush)
“队列发送前端”图标 队列发送前端 (tx_queue_front_send)
“获取队列信息”图标 获取队列信息 (tx_queue_info_get)
“获取队列性能信息”图标 获取队列性能信息 (tx_queue_performance_info_get)
“获取队列系统性能信息”图标 获取队列系统性能信息 (tx_queue_performance_system_info_get)
“设置队列优先级”图标 设置队列优先级 (tx_queue_prioritize)
“队列接收消息”图标 队列接收消息 (tx_queue_receive)
“队列发送消息”图标 队列发送消息 (tx_queue_send)
“队列发送通知”图标 队列发送通知 (tx_queue_send_notify)
“设置信号灯上限”图标 设置信号灯上限 (tx_semaphore_ceiling_put)
“创建信号灯”图标 创建信号灯 (tx_semaphore_create)
“删除信号灯”图标 删除信号灯 (tx_semaphore_delete)
“获取信号灯”图标 获取信号灯 (tx_semaphore_get)
“获取信号灯信息”图标 获取信号灯信息 (tx_semaphore_info_get)
“获取信号灯性能信息”图标 获取信号灯性能信息 (tx_semaphroe_performance_info_get)
“获取信号灯系统性能信息”图标 获取信号灯系统性能信息 (tx_semaphore_performance_system_info_get)
“设置信号灯优先级”图标 设置信号灯优先级 (tx_semaphore_prioritize)
“放置信号灯”图标 放置信号灯 (tx_semaphore_put)
“信号灯放置通知”图标 信号灯推送通知 (tx_semaphore_put_notify)
“创建线程”图标 创建线程 (tx_thread_create)
“删除线程”图标 删除线程 (tx_thread_delete)
“线程退出/进入通知”图标 线程退出/进入通知 (tx_thread_entry_exit_notify)
“标识线程”图标 标识线程 (tx_thread_identify)
“获取线程信息”图标 获取线程信息 (tx_thread_info_get)
“获取线程性能信息”图标 获取线程性能信息 (tx_thread_performance_info_get)
“获取线程系统性能信息”图标 获取线程系统性能信息 (tx_thread_performance_system_info_get)
“更改线程抢占”图标 更改线程抢占 (tx_thread_preemption_change)
“线程优先级更改”图标 线程优先级更改 (tx_thread_priority_change)
“放弃线程”图标 放弃线程 (tx_thread_relinquish)
“重置线程”图标 重置线程 (tx_thread_reset)
“继续线程”图标 继续线程 (*tx_thread_resume)
“睡眠状态线程”图标 睡眠状态线程 (tx_thread_sleep)*
“线程堆栈错误通知”图标 线程堆栈错误通知 (tx_thread_stack_error_notify)
“暂停线程”图标 暂停线程 (tx_thread_suspend)
“终止线程”图标 终止线程 (tx_thread_terminate)
“更改线程时间切片”图标 更改线程时间切片 (tx_thread_time_slice_change)
“线程等待中止”图标 线程等待中止 (tx_thread_wait_abort)
“获取时间”图标 获取时间 (tx_time_get)
“设置时间”图标 设置时间 (tx_time_set)
“激活计时器”图标 激活计时器 (tx_timer_activate)
“更改计时器”图标 更改计时器 (tx_timer_change)
“创建计时器”图标 创建计时器 (tx_timer_create)
“停用计时器”图标 停用计时器 (tx_timer_deactivate)
“删除计时器”图标 删除计时器 (tx_timer_delete)
“获取计时器信息”图标 获取计时器信息 (tx_timer_info_get)
“获取计时器性能信息”图标 获取计时器性能信息 (tx_timer_performance_info_get)
“获取计时器系统性能信息”图标 获取计时器系统性能信息 (tx_timer_performance_system_info_get)
“用户定义的事件”图标 用户定义的事件(参见第 10 章)

事件说明

继续内部线程

继续内部线程

图标“继续内部线程”图标

说明

此事件表示 ThreadX 中恢复线程执行的内部处理。 如果指定的线程是最高优先级,并且抢占阈值不阻止其执行,则系统将开始执行这个新的就绪线程。

信息字段

  • 信息字段 1:指向要继续的线程的指针。

  • 信息字段 2:正在恢复的线程的先前状态,如下所示:

    线程状态
    TX_READY 0
    TX_COMPLETED 1
    TX_TERMINATED 2
    TX_SUSPENDED 3
    TX_SLEEP 4
    TX_QUEUE_SUSP 5
    TX_SEMAPHORE_SUSP 6
    TX_EVENT_FLAG 7
    TX_BLOCK_MEMORY 8
    TX_BYTE_MEMORY 9
    TX_TCP_IP 12
    TX_MUTEX_SUSP 13
  • 信息字段 3:调用期间的堆栈指针值。

  • 信息字段 4:指向要执行的下一个最高优先级线程的指针。

暂停内部线程

暂停内部线程

图标“暂停内部线程”图标

说明

此事件表示 ThreadX 中暂停线程执行的内部处理。 执行准备就绪的下一个优先级最高的线程放置在第四个信息字段中。 如果该值为 NULL,则表示没有其他可供执行的线程,系统处于空闲状态。

信息字段

  • 信息字段 1:指向处于暂停状态的线程的指针。

  • 信息字段 2:处于暂停状态的线程的新状态,如下所示:

    线程状态
    TX_COMPLETED 1
    TX_TERMINATED 2
    TX_SUSPENDED 3
    TX_SLEEP 4
    TX_QUEUE_SUSP 5
    TX_SEMAPHORE_SUSP 6
    TX_EVENT_FLAG 7
    TX_BLOCK_MEMORY 8
    TX_BYTE_MEMORY 9
    TX_TCP_IP 12
    TX_MUTEX_SUSP 13
  • 信息字段 3:调用期间的堆栈指针值。 信息字段 4:指向要执行的下一个最高优先级线程的指针。 如果为 NULL,则系统处于空闲状态。

进入中断服务例程 (ISR)

进入 ISR

图标“进入 ISR”图标

说明

此事件表示在应用程序中进入中断服务例程 (ISR)。 中断服务例程将继续执行,直到发生 ISR 退出事件。

信息字段

  • 信息字段 1:调用期间的堆栈指针值。
  • 信息字段 2:应用程序定义的 ISR 编号(可选)。
  • 信息字段 3:嵌套中断计数。
  • 信息字段 4:内部抢占禁用标志。

退出中断服务例程 (ISR)

退出 ISR

图标“退出 ISR”图标

说明

此事件表示在应用程序中退出中断服务例程 (ISR)。

信息字段

  • 信息字段 1:调用期间的堆栈指针值。
  • 信息字段 2:应用程序定义的 ISR 编号(可选)。
  • 信息字段 3:嵌套中断计数。
  • 信息字段 4:内部抢占禁用标志。

内部时间切片

内部时间切片

图标“内部时间切片”图标

说明

此事件表示 ThreadX 中执行时间切片操作的内部处理。 相同优先级的下一个线程放置在第一个信息字段中。 如果此值与当前线程相同,则不执行时间切片。

  • 信息字段 1:指向要执行的下一个线程的指针。
  • 信息字段 2:嵌套中断计数。
  • 信息字段 3:内部抢占禁用标志。
  • 信息字段 4:调用期间的堆栈指针值。

正在运行

在上下文中运行

图标“正在运行”图标

说明

此事件表示在线程上下文或空闲系统中运行。 它用于说明由于中断而在上下文中发生的后续更改。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

分配块

tx_block_allocate

图标“分配块”图标

说明

此事件表示通过 tx_block_allocate 分配内存块。 如果成功,则在第二个信息字段中返回所分配块的地址。

信息字段

  • 信息字段 1:指向相应块池的指针。
  • 信息字段 2:指向返回的内存块的指针(如果成功)。
  • 信息字段 3:提供给 tx_block_allocate 调用的等待选项。
  • 信息字段 4:此次分配后池中的剩余可用块。

创建块池

tx_block_pool_create

图标“创建块池”图标

说明

此事件表示通过 tx_block_pool_create 创建内存块池。

信息字段

  • 信息字段 1:指向相应块池控制块的指针。
  • 信息字段 2:指向池的起始内存区域的指针。
  • 信息字段 3:池中的块数。 信息字段 4:池中每个块的大小(以字节为单位)。

删除块池

tx_block_pool_delete

图标“删除块池”图标

说明

此事件表示通过 tx_block_pool_delete 删除内存块池。

信息字段

  • 信息字段 1:指向块池控制块的指针。
  • 信息字段 2:调用期间的堆栈指针值。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取块池信息

tx_block_pool_info_get

图标“获取块池信息”图标

说明

此事件表示通过 tx_block_pool_info_get 获取有关内存块池的信息。

信息字段

  • 信息字段 1:指向块池控制块的指针。
  • 信息字段 2:调用期间的堆栈指针值。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取块池性能信息

tx_block_pool_performance_info_get

图标“获取块池性能信息”图标

说明

此事件表示通过 tx_block_pool_performance_info_get 获取有关内存块池的性能信息。

信息字段

  • 信息字段 1:指向块池控制块的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取块池系统性能信息

tx_block_pool_performance_system_info_get

图标“获取块池系统性能信息”图标

说明

此事件表示通过 tx_block_pool_performance_system_info_get 获取有关所有内存块池的性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置块池优先级

tx_block_pool_prioritize

图标“设置块池优先级”图标

说明

此事件表示将最高优先级的已暂停线程放置在块池暂停列表的前面。 如果在调用 tx_block_release 之前执行此操作,则最高优先级的已暂停线程将接收已释放的块。

信息字段

  • 信息字段 1:内存块池指针。
  • 信息字段 2:在此块池上暂停的线程数。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

释放块

tx_block_release

图标“释放块”图标

说明

此事件表示将以前分配的块释放回块池。

信息字段

  • 信息字段 1:内存块池指针。
  • 信息字段 2:指向要释放的块的指针。
  • 信息字段 3:此块池上暂停的线程数。
  • 信息字段 4:调用时的堆栈指针。

字节分配

tx_byte_allocate

图标“字节分配”图标

说明

此事件表示通过 tx_byte_allocate 分配内存。 如果成功,则在第二个信息字段中返回分配的内存的地址。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:指向返回的内存的指针(如果成功)。
  • 信息字段 3:已请求的字节数。 信息字段 4:提供给 tx_byte_allocate 调用的等待选项。

创建字节池

tx_byte_pool_create

图标“创建字节池”图标

说明

此事件表示通过 tx_byte_pool_create 创建字节池。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:指向内存区开头的指针。 信息字段 3:字节池中的字节数。
  • 信息字段 4:调用时的堆栈指针。

删除字节池

tx_byte_pool_delete

图标“删除字节池”图标

说明

此事件表示通过 tx_byte_pool_delete 删除字节池。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取字节池信息

tx_byte_pool_info_get

图标“获取字节池信息”图标

说明

此事件表示通过 tx_byte_pool_info_get 获取字节池信息。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取字节池性能信息

tx_byte_pool_info_get

图标“获取字节池性能信息”图标

说明

此事件表示通过 tx_byte_pool_performance_info_get 获取字节池性能信息。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取字节池系统性能信息

tx_byte_pool_performance_system_info_get

图标“获取字节池系统性能信息”图标

说明

此事件表示通过 tx_byte_pool_performance_system_info_get 获取字节池系统性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置字节池优先级

tx_byte_pool_prioritize

图标“设置字节池优先级”图标

说明

此事件表示通过 tx_byte_pool_prioritize 设置字节池的暂停列表的优先级。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:当前在字节池上暂停的线程数。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

释放字节

tx_byte_release

图标“释放字节”图标

说明

此事件表示通过 tx_byte_release 从字节池释放分配的内存块。

信息字段

  • 信息字段 1:指向相应字节池的指针。
  • 信息字段 2:指向先前分配的字节池内存的指针。
  • 信息字段 3:此字节池上暂停的线程数。
  • 信息字段 4:内存的可用字节数。

创建事件标志

tx_event_flags_create

图标“创建事件标志”图标

说明

此事件表示通过 tx_event_flags_create 创建新的事件标志组。

信息字段

  • 信息字段 1:指向事件标志组控制块的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

删除事件标志

tx_event_flags_delete

图标“删除事件标志”图标

说明

此事件表示通过 tx_event_flags_delete 删除事件标志组。

信息字段

  • 信息字段 1:指向事件标志组的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取事件标志

tx_event_flags_get

图标“获取事件标志”图标

说明

此事件表示通过 tx_event_flags_get 从现有事件标志组中检索事件标志。

信息字段

  • 信息字段 1:指向事件标志组的指针。
  • 信息字段 2:请求的事件标志。
  • 信息字段 3:组中当前设置的事件标志。
  • 信息字段 4:获取事件标志上请求的选项。

获取事件标志信息

tx_event_flags_info_get

图标“获取事件标志信息”图标

说明

此事件表示通过 tx_event_flags_info_get 检索有关现有事件标志组的信息。

信息字段

  • 信息字段 1:指向事件标志组的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取事件标志性能信息

tx_event_flags_performance_info_get

图标“获取事件标志性能信息”图标

说明

此事件表示通过 tx_event_flags_performance_info_get 检索有关现有事件标志组的性能信息。

信息字段

  • 信息字段 1:指向事件标志组的指针。
  • 信息字段 2:未使用
  • 信息字段 3:未使用
  • 信息字段 4:未使用

获取事件标志系统性能信息

tx_event_flags_performance_system_info_get

图标“获取事件标志系统性能信息”图标

说明

此事件表示通过 tx_event_flags_performance_system_info_get 检索有关现有事件标志组的性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置事件标志

tx_event_flags_set

图标“设置事件标志”图标

说明

此事件表示通过 tx_event_flags_set 在现有事件标志组中设置(或清除)事件标志。

信息字段

  • 信息字段 1:指向事件标志组的指针。
  • 信息字段 2:要设置(或清除)的事件标志。
  • 信息字段 3:AND 或 OR 事件标志选项。
  • 信息字段 4:事件标志组上暂停的线程数。

事件标志设置通知

tx_event_flags_set_notify

图标“事件标志设置通知”图标

说明

此事件表示通过 tx_event_flags_set_notify 为现有事件标志组上的任何事件标志设置操作注册通知回叫。

信息字段

  • 信息字段 1:指向事件标志组的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

中断控制

tx_interrupt_control

图标“中断控制”图标

说明

此事件表示通过 tx_interrupt_control 更改处理器的中断锁定状态。

信息字段

  • 信息字段 1:新中断状态。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

创建互斥体

tx_mutex_create

图标“创建互斥体”图标

说明

此事件表示通过 tx_mutex_create 创建互斥体。

信息字段

  • 信息字段 1:指向互斥体控制块的指针。
  • 信息字段 2:优先级继承选项
  • (TX_INHERIT 或 TX_NO_INHERIT)。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

删除互斥体

tx_mutex_delete

图标“删除互斥体”图标

说明

此事件表示通过 tx_mutex_delete 删除互斥体。

信息字段

  • 信息字段 1:指向互斥体的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取互斥体

tx_mutex_get

图标“获取互斥体”图标

说明

此事件表示通过 tx_mutex_get 获取互斥体。

信息字段

  • 信息字段 1:指向互斥体的指针。
  • 信息字段 2:提供给 tx_mutex_get 调用的等待选项。
  • 信息字段 3:指向拥有互斥体的线程的指针(NULL 表示不具有互斥体)。
  • 信息字段 4:拥有线程调用 tx_mutex_get 的次数。

获取互斥体信息

tx_mutex_info_get

图标“获取互斥体信息”图标

说明

此事件表示通过 tx_mutex_info_get 检索互斥体信息。

信息字段

  • 信息字段 1:指向互斥体的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取互斥体性能信息

tx_mutex_performance_info_get

图标“获取互斥体性能信息”图标

说明

此事件表示通过 tx_mutex_performance_info_get 检索互斥体性能信息。

信息字段

  • 信息字段 1:指向互斥体的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取互斥体系统性能信息

tx_mutex_performance_system_info_get

图标“获取互斥体系统性能信息”图标

说明

此事件表示通过 tx_mutex_performance_system_info_get 检索互斥体系统性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置互斥体优先级

tx_mutex_prioritize

图标“设置互斥体优先级”图标

说明

此事件表示通过 tx_mutex_prioritize 设置互斥体挂起列表的优先级。

信息字段

  • 信息字段 1:指向相应互斥体的指针。
  • 信息字段 2:当前在互斥体上暂停的线程数。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

放置互斥体

tx_mutex_put

图标“放置互斥体”图标

说明

此事件表示通过 tx_mutex_put 释放以前拥有的互斥体。

信息字段

  • 信息字段 1:指向相应互斥体的指针。
  • 信息字段 2:拥有互斥体的线程的指针。
  • 信息字段 3:未完成的互斥体获取请求数。
  • 信息字段 4:调用时的堆栈指针。

创建队列

tx_queue_create

图标“创建队列”图标

说明

此事件表示通过 tx_queue_create 创建消息队列。

信息字段

  • 信息字段 1:指向队列控制块的指针。
  • 信息字段 2:消息大小(以 32 位字为单位。)。
  • 信息字段 3:指向队列内存区开头的指针。
  • 信息字段 4:队列内存区域中的字节数。

删除队列

tx_queue_delete

图标“删除队列”图标

说明

此事件表示通过 tx_queue_delete 删除队列。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

刷新队列

tx_queue_flush

图标“刷新队列”图标

说明

此事件表示通过 tx_queue_flush 刷新队列(清除所有队列内容)。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

队列发送前端

tx_queue_front_send

图标“队列发送前端”图标

说明

此事件表示通过 tx_queue_front_send 将消息发送到队列的前端。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:指向消息开头的指针。
  • 信息字段 3:提供给 tx_queue_front_send 调用
  • 的等待选项。
  • 信息字段 4:已排队的消息数。

获取队列信息

tx_queue_info_get

图标“获取队列信息”图标

说明

此事件表示通过 tx_queue_info_get 获取有关队列的信息。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取队列性能信息

tx_queue_performance_info_get

图标“获取队列性能信息”图标

说明

此事件表示通过 tx_queue_performance_info_get 获取有关队列的性能信息。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取队列系统性能信息

tx_queue_performance_system_info_get

图标“获取队列系统性能信息”图标

说明

此事件表示获取有关系统中所有队列的系统性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置队列优先级

tx_queue_prioritize

图标“设置队列优先级”图标

说明

此事件表示通过 tx_queue_prioritize 设置队列挂起列表的优先级。

信息字段

  • 信息字段 1:指向相应队列的指针。
  • 信息字段 2:当前在队列中暂停的线程数。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

队列接收

tx_queue_receive

图标“队列接收”图标

说明

此事件表示通过 tx_queue_receive 接收队列中的消息。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:指向消息目标的指针。 信息字段 3:提供给调用的等待选项。
  • 信息字段 4:当前排队的消息数。

队列发送

tx_queue_send

图标“队列发送”图标

说明

此事件表示通过 tx_queue_send 向队列发送消息。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:指向消息的指针。
  • 信息字段 3:提供给调用的等待选项。
  • 信息字段 4:当前排队的消息数。

队列发送通知

tx_queue_send_notify

图标“队列发送通知”图标

说明

此事件表示通过 tx_queue_send_notify 注册回叫,每当将消息发送到队列时都会调用该回叫。

信息字段

  • 信息字段 1:指向队列的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置信号灯上限

tx_semaphore_ceiling_put

图标“设置信号灯上限”图标

说明

此事件表示通过 tx_semaphore_ceiling_put 设置信号灯上限。 这与 tx_semaphore_put 不同之处在于,它检查信号灯的最大值,以使放置操作不得超过最大值或上限。

信息字段

  • 信息字段 1:指向信号灯的指针。
  • 信息字段 2:当前信号灯计数。
  • 信息字段 3:信号灯上暂停的线程数。
  • 信息字段 4:提供给调用的上限。

创建信号灯

tx_semaphore_create

图标“创建信号灯”图标

说明

此事件表示通过 tx_semaphore_create 创建信号灯。

信息字段

  • 信息字段 1:指向信号灯控制块的指针。
  • 信息字段 2:初始信号灯计数。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

删除信号灯

tx_semaphore_delete

图标“删除信号灯”图标

说明

此事件表示通过 tx_semaphore_delete 删除信号灯。

信息字段

  • 信息字段 1:指向信号灯的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取信号灯

tx_semaphore_get

图标“获取信号灯”图标

说明

此事件表示通过 tx_semaphore_get 获取信号灯。

信息字段

  • 信息字段 1:指向信号灯的指针。
  • 信息字段 2:提供给调用的等待选项。
  • 信息字段 3:当前信号灯计数。
  • 信息字段 4:调用时的堆栈指针。

获取信号灯信息

tx_semaphore_info_get

图标“获取信号灯信息”图标

说明

此事件表示通过 tx_semaphore_info_get 获取有关信号灯的信息。

信息字段

  • 信息字段 1:指向信号灯的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取信号灯性能信息

tx_semaphore_performance_info_get

图标“获取信号灯性能信息”图标

说明

此事件表示通过 tx_semaphore_performance_info_get 获取有关信号灯的性能信息。

信息字段

  • 信息字段 1:指向信号灯的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

信号灯系统性能信息

tx_semaphore_performance_system_info_get

图标“信号灯系统性能信息”图标

说明

此事件表示通过 tx_semaphore_performance_system_info_get 获取有关系统中所有信号灯的性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置信号灯优先级

tx_semaphore_prioritize

图标“设置信号灯优先级”图标

说明

此事件表示通过 tx_semaphore_prioritize 设置信号灯挂起列表的优先级。

信息字段

  • 信息字段 1:指向相应信号灯的指针。
  • 信息字段 2:当前在信号灯上暂停的线程数。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

放置信号灯

tx_semaphore_put

图标“放置信号灯”图标

说明

此事件表示通过 tx_semaphore_put 释放信号灯实例。

信息字段

  • 信息字段 1:指向相应信号灯的指针。 信息字段 2:当前信号灯计数。
  • 信息字段 3:信号灯上暂停的线程数。
  • 信息字段 4:调用时的堆栈指针。

信号灯放置通知

tx_semaphore_put_notify

图标“信号灯放置通知”图标

说明

此事件表示通过 tx_semaphore_put_notify 注册回叫,每当放置信号灯实例时都会调用该回叫。

信息字段

  • 信息字段 1:指向信号灯的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

创建线程

tx_thread_create

图标“创建线程”图标

说明

此事件表示通过 tx_thread_create 创建线程。

信息字段

  • 信息字段 1:指向线程控制块的指针。
  • 信息字段 2:线程的优先级。
  • 信息字段 3:线程的堆栈指针。
  • 信息字段 4:堆栈的大小(以字节为单位)。

删除线程

tx_thread_delete

图标“删除线程”图标

说明

此事件表示通过 tx_thread_delete 删除线程。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

线程进入/退出通知

tx_thread_entry_exit_notify

图标“线程进入/退出通知”图标

说明

此事件表示通过 tx_thread_entry_exit_notify 注册回叫,每当进入或退出线程时都会调用该回叫。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:注册时的线程状态。
  • 信息字段 3:调用时指向堆栈的指针。
  • 信息字段 4:未使用。

标识线程

tx_thread_identify

图标“标识线程”图标

说明

此事件表示通过 tx_thread_identify 获取当前线程指针。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取线程信息

tx_thread_info_get

图标“获取线程信息”图标

说明

此事件表示通过 tx_thread_info_get 获取有关指定线程的信息。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取线程性能信息

tx_thread_performance_info_get

图标“获取线程性能信息”图标

说明

此事件表示通过 tx_thread_performance_info_get 获取有关指定线程的性能信息。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取线程系统性能信息

tx_thread_performance_system_info_get

图标“获取线程系统性能信息”图标

说明

此事件表示通过 tx_thread_performance_system_info_get 获取有关所有线程的性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

更改线程抢占

tx_thread_preemption_change

图标“更改线程抢占”图标

说明

此事件表示通过 tx_thread_preemption_change 更改线程的抢占阈值。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:新的抢占阈值。
  • 信息字段 3:以前的抢占阈值。
  • 信息字段 4:调用时线程的状态。

线程优先级更改

tx_thread_priority_change

图标“线程优先级更改”图标

说明

此事件表示通过 tx_thread_priority_change 更改线程的优先级。

  • 信息字段
  • 信息字段 1:指向线程的指针。
  • 信息字段 2:新优先级。
  • 信息字段 3:以前的优先级。
  • 信息字段 4:调用时线程的状态。

放弃线程

tx_thread_relinquish

图标“放弃线程”图标

说明

此事件表示通过 tx_thread_relinquish 从线程放弃处理器。

信息字段

  • 信息字段 1:调用时的堆栈指针。
  • 信息字段 2:指向要执行的下一个线程的指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

重置线程

tx_thread_reset

图标“重置线程”图标

说明

此事件表示通过 tx_thread_reset 重置已完成或已终止的线程。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

继续线程

tx_thread_resume

图标“继续线程”图标

说明

此事件表示通过 tx_thread_resume 恢复挂起的线程。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

睡眠状态线程

tx_thread_sleep

图标“睡眠状态线程”图标

说明

此事件表示通过 tx_thread_sleep 暂停当前线程至指定数量的计时器刻度。

信息字段

  • 信息字段 1:要挂起的刻度数。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

线程堆栈错误通知

tx_thread_stack_error_notify_event

图标“线程堆栈错误通知”图标

说明

此事件表示通过 tx_thread_stack_error_notify_event 注册线程堆栈错误通知例程。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

暂停线程

tx_thread_suspend

图标“暂停线程”图标

说明

此事件表示通过 tx_thread_suspend 暂停线程。

信息字段

  • 信息字段 1:指向要挂起的线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

终止线程

tx_thread_terminate

图标“终止线程”图标

说明

此事件表示通过 tx_thread_terminate 终止线程。

信息字段

  • 信息字段 1:指向要终止的线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

更改线程时间切片

tx_thread_time_slice_change

图标“更改线程时间切片”图标

说明

此事件表示通过 tx_thread_time_slice_change 更改线程的时间切片。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:新的时间切片。
  • 信息字段 3:以前的时间切片。
  • 信息字段 4:未使用。

线程等待中止

tx_thread_wait_abort

图标“线程等待中止”图标

说明

此事件表示通过 tx_thread_wait_abort 中止线程的挂起。

信息字段

  • 信息字段 1:指向线程的指针。
  • 信息字段 2:调用时线程的状态。
  • 信息字段 3:调用时的堆栈指针。
  • 信息字段 4:未使用。

获取计时器

tx_time_get

图标“获取时间”图标

说明

此事件表示通过 tx_time_get 获取当前的计时器刻度数。

信息字段

  • 信息字段 1:当前计时器刻度数。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

设置计时器

tx_time_set

图标“设置时间”图标

说明

此事件表示通过 tx_time_set 设置当前计时器刻度数。

信息字段

  • 信息字段 1:新的计时器刻度数。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

激活计时器

tx_timer_activate

图标“激活计时器”图标

说明

此事件表示通过 tx_timer_activate 激活指定的计时器。

信息字段

  • 信息字段 1:指向计时器的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

更改计时器

tx_timer_change

图标“更改计时器”图标

说明

此事件表示通过 tx_timer_change 更改指定的计时器。

信息字段

  • 信息字段 1:指向计时器的指针。
  • 信息字段 2:初始过期时间刻度。
  • 信息字段 3:重新计划的过期时间刻度。
  • 信息字段 4:未使用。

创建计时器

tx_timer_create

图标“创建计时器”图标

说明

此事件表示通过 tx_timer_create 创建计时器。

信息字段

  • 信息字段 1:指向计时器控制块的指针。
  • 信息字段 2:初始过期时间刻度。
  • 信息字段 3:重新计划的过期时间刻度。
  • 信息字段 4:自动启用值 - TX_AUTO_ACTIVATE (1) 或 TX_NO_ACTIVATE (0)。

停用计时器

tx_timer_deactivate

图标“停用计时器”图标

说明

此事件表示通过 tx_timer_deactivate 停用计时器。

信息字段

  • 信息字段 1:指向计时器的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

删除计时器

tx_timer_delete

图标“删除计时器”图标

说明

此事件表示通过 tx_timer_delete 删除计时器。

信息字段

  • 信息字段 1:指向计时器的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取计时器信息

tx_timer_info_get

图标“获取计时器信息”图标

说明

此事件表示通过 tx_timer_info_get 获取计时器信息。

信息字段

  • 信息字段 1:指向计时器的指针。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取计时器性能信息

tx_timer_performance_info_get

图标“获取计时器性能信息”图标

说明

此事件表示通过 tx_timer_performance_info_get 获取计时器性能信息。

信息字段

  • 信息字段 1:指向计时器的指针。
  • 信息字段 2:调用时的堆栈指针。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。

获取计时器系统性能信息

tx_timer_performance_system_info_get

图标“获取计时器系统性能信息”图标

说明

此事件表示通过 tx_timer_performance_system_info_get 获取所有计时器性能信息。

信息字段

  • 信息字段 1:未使用。
  • 信息字段 2:未使用。
  • 信息字段 3:未使用。
  • 信息字段 4:未使用。