swtmr.md

# swtmr
## Command Function
This command is used to query information about system software timers.
## Syntax
swtmr \[_ID_\]
## Parameter Description
**Table 1** Parameters

Parameter	Description	Value Range
ID	Indicates the ID of a software timer.	[0, 0xFFFFFFFF]

## Usage
- If the parameter is not specified, information about all software timers is displayed.
- If the **ID** parameter is specified, information about the specified software timer is displayed.
## Example
Enter **swtmr** and **swtmr 1**.
## Output
**Figure 1** Querying information about all software timers
**Figure 2** Querying information about a specified software timer
**Table 2** Output description

Parameter	Description
SwTmrID	Indicates the ID of the software timer.
State	Indicates the status of the software timer. The value can be UnUsed, Created, or Ticking.
Mode	Indicates the mode of the software timer. The value can be Once, Period, or NSD (one-time timer that will not be automatically deleted after the timer expires).
Interval	Indicates the number of ticks used by the software timer.
Count	Indicates the number of times that the software timer has been working.
Arg	Indicates the input parameter.
handlerAddr	Indicates the callback address.

> **NOTE:**
>- The **ID** value can be in decimal or hexadecimal format.
>- If the **ID** value is within the range of \[0, _Number of current software timers - 1_\], the status of the specified software timer is returned. For other values, an error message is displayed.