# swtmr - [命令功能](#section166171064814) - [命令格式](#section424011111682) - [参数说明](#section1268410459465) - [使用指南](#section169806213815) - [使用实例](#section16676026389) - [输出说明](#section1541991614710) ## 命令功能 swtmr命令用于查询系统软件定时器相关信息。 ## 命令格式 swtmr \[_ID_\] ## 参数说明 **表 1** 参数说明

参数	参数说明	取值范围
ID	软件定时器ID号。	[0,0xFFFFFFFF]

## 使用指南 - 参数缺省时，默认显示所有软件定时器的相关信息。 - swtmr后加ID号时，显示ID对应的软件定时器相关信息。 ## 使用实例举例： - swtmr - swtmr 1 ## 输出说明 **示例 1** 查询所有软件定时器相关信息 ```shell OHOS # swtmr SwTmrID State Mode Interval Count Arg handlerAddr ---------- ------- ------- --------- ------- ---------- -------- 0x00000000 Ticking Period 100 77 0x40802a50 0x4037b8a0 SwTmrID State Mode Interval Count Arg handlerAddr ---------- ------- ------- --------- ------- ---------- -------- 0x00000001 Ticking Period 1000 876 0x00000000 0x4037fc04 SwTmrID State Mode Interval Count Arg handlerAddr ---------- ------- ------- --------- ------- ---------- -------- 0x00000002 Ticking Period 100 76 0x00000000 0x403727f4 SwTmrID State Mode Interval Count Arg handlerAddr ---------- ------- ------- --------- ------- ---------- -------- 0x00000016 Ticking NSD 10 6 0x8021e000 0x401fe7d8 SwTmrID State Mode Interval Count Arg handlerAddr ---------- ------- ------- --------- ------- ---------- -------- 0x00000079 Ticking NSD 30000 1749 0x406189d8 0x40160e1c ``` **示例 2** 查询对应 ID 的软件定时器信息 ```shell OHOS # swtmr 1 SwTmrID State Mode Interval Count Arg handlerAddr ---------- ------- ------- --------- ------- ---------- -------- 0x00000001 Ticking Period 1000 841 0x00000000 0x4037fc04 ``` **表 2** 输出说明

输出	说明
SwTmrID	软件定时器ID。
State	软件定时器状态。状态可能为："UnUsed", "Created", "Ticking"。
Mode	软件定时器模式。模式可能为："Once", "Period", "NSD（单次定时器，定时结束后不会自动删除）"。
Interval	软件定时器使用的Tick数。
Count	软件定时器已经工作的次数。
Arg	传入的参数。
handlerAddr	回调函数的地址。

>![](../public_sys-resources/icon-note.gif) **说明：** >- swtmr命令的ID参数输入形式以十进制形式表示或十六进制形式表示皆可。 >- swtmr命令的ID参数在\[0, 当前软件定时器个数 - 1\]范围内时，返回对应ID的软件定时器的状态；其他取值时返回错误提示。