# Timer Mode

Count the number of clicks at regular intervals.

The **Timer** mode counts the number of built-in button clicks or external I/O triggers and sends a message at regular intervals reporting the number of clicks and triggers detected during that interval.

## Configuration

To configure your button for **Timer** mode:

1. Follow the [Configuration](https://docs.soracom.io/en/devices/soracom-lte-m-button/configuration#configuring-a-group) instructions for configuring **Soracom LTE-M Button settings**.

2. Select the **Timer** mode option:

   ![Selecting the Timer mode](https://docs.soracom.io/_astro/01-group-button-settings-timer.qCymDoUM_orEgs.webp)

   You can configure the following options for **Timer** mode:

   - **Uplink frequency** - The frequency to send [Timer messages](https://docs.soracom.io/en/devices/soracom-lte-m-button/message-examples#timer-message).

   - **Auto sync** - For buttons with firmware version 3134 or later, automatically sync once a day.

   - **External I/O mode** - Configure the external I/O accessory port:

     - **Disabled**
     - [Edge Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/edge-detection)
     - [Pulse Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/pulse-detection)
     - [Temperature Sensor](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/temperature-sensor)

   - **Enable debounce** - Enables debouncing for Edge Detection and Pulse Detection external I/O modes to reduce false triggers.

After configuring **Soracom LTE-M Button settings**, follow the [instructions to sync your button](https://docs.soracom.io/en/devices/soracom-lte-m-button/configuration#syncing-button-settings).

## Messages

When the Soracom LTE-M Button operation mode is configured as **Timer**, the button will send the following types of messages:

- [Timer message](https://docs.soracom.io/en/devices/soracom-lte-m-button/message-examples#timer-message), reporting the number of built-in button clicks and external I/O triggers detected during the configured interval
- [Status message](https://docs.soracom.io/en/devices/soracom-lte-m-button/message-examples#status-message), reporting the current status and configuration of the button

### Timer and Summary Intervals

Timer messages are sent at regular intervals according to the configured **Uplink frequency**.

To provide additional granularity, each Timer message is subdivided into 5 summaries, with the duration of each summary equal to 1/5th the duration of the **Uplink frequency**:

![Timer summaries](https://docs.soracom.io/_astro/02-timer-summaries.CD_vHfvT_ZuHb1C.webp)

For example:

- If the **Uplink frequency** is 1 day (24 hours), each summary will be 4 hours and 48 minutes in duration
- If the **Uplink frequency** is 1 hour, each summary will be 12 minutes in duration

Each summary is labeled with a number from 1–5.

### Detected Events

The Timer message will consist of the following summaries, reporting the detected events:

- **short\_summary\__#_** - The number of single short clicks detected from the built-in button during the summary interval
- **double\_summary\__#_** - The number of double short clicks detected from the built-in button during the summary interval
- **long\_summary\__#_** - The number of single long clicks detected from the built-in button during the summary interval
- **edge\_summary\__#_** - The number of connections and disconnections detected from an external button or switch connected via the 2-wire accessory during the summary interval, when the external I/O mode is configured as [Edge Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/edge-detection)
- **temp\_summary\__#_** - The temperature measured from an attached temperature sensor at the end of the summary interval, when the external I/O mode is configured as [Temperature Sensor](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/temperature-sensor)

If the external I/O mode is configured as [Pulse Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/pulse-detection), events triggered from an external button or switch will also be counted in the **short\_summary\__#_**, **double\_summary\__#_**, and **long\_summary\__#_** sumamries.

## Behavior

**Firmware 3134**

| Input | Action | External I/O mode | External I/O mode | External I/O mode | External I/O mode |
| - | - | - | - | - | - |
| Input | Action | Disabled | [Edge Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/edge-detection) | [Pulse Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/pulse-detection) | [Temperature Sensor](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/temperature-sensor) |
| Built-in button | Single short click | - LED blinks one short green blink: :blink\[.] - Increments the **short\\\_summary\\\_\_#\_** counter | - LED blinks one short green blink: :blink\[.] - Increments the **short\\\_summary\\\_\_#\_** counter | - LED blinks one short green blink: :blink\[.] - Increments the **short\\\_summary\\\_\_#\_** counter | - LED blinks one short green blink: :blink\[.] - Increments the **short\\\_summary\\\_\_#\_** counter |
| Built-in button | Double short click | - LED blinks two short green blinks: :blink\[. .] - Increments the **double\\\_summary\\\_\_#\_** counter | - LED blinks two short green blinks: :blink\[. .] - Increments the **double\\\_summary\\\_\_#\_** counter | - LED blinks two short green blinks: :blink\[. .] - Increments the **double\\\_summary\\\_\_#\_** counter | - LED blinks two short green blinks: :blink\[. .] - Increments the **double\\\_summary\\\_\_#\_** counter |
| Built-in button | Single long click | - LED blinks one long green blink: :blink\[.---] - Increments the **long\\\_summary\\\_\_#\_** counter | - LED blinks one long green blink: :blink\[.---] - Increments the **long\\\_summary\\\_\_#\_** counter | - LED blinks one long green blink: :blink\[.---] - Increments the **long\\\_summary\\\_\_#\_** counter | - LED blinks one long green blink: :blink\[.---] - Increments the **long\\\_summary\\\_\_#\_** counter |
| Built-in button | Extra long click | - LED blinks three short green blinks: :blink\[. . .] - Sends a **Status message** to report the current status and configuration | - LED blinks three short green blinks: :blink\[. . .] - Sends a **Status message** to report the current status and configuration | - LED blinks three short green blinks: :blink\[. . .] - Sends a **Status message** to report the current status and configuration | - LED blinks three short green blinks: :blink\[. . .] - Sends a **Status message** to report the current status and configuration |
| 2-wire accessory | Connected | | - LED blinks one short green blink: :blink\[.] - Increments the **edge\\\_summary\\\_\_#\_** counter | - Starts a timer and waits for the wire to disconnect | |
| 2-wire accessory | Disconnected | | - LED blinks one short green blink: :blink\[.] - Increments the **edge\\\_summary\\\_\_#\_** counter | - Calculates the timer and performs the same action as the built-in button | |
| Internal timer | Uplink frequency | - Sends a **Timer message** | - Sends a **Timer message** | - Sends a **Timer message** | - Reads the temperature sensor\*1 - Sends a **Timer message** |
| Internal timer | Every 24 hours | - If Auto sync is enabled, sends a **Status message** to report the current status and configuration | - If Auto sync is enabled, sends a **Status message** to report the current status and configuration | - If Auto sync is enabled, sends a **Status message** to report the current status and configuration | - If Auto sync is enabled, sends a **Status message** to report the current status and configuration |

1. The temperature sensor is measured at the end of each summary interval.

**Firmware 2220**

| Input | Action | External I/O mode | External I/O mode | External I/O mode | External I/O mode |
| - | - | - | - | - | - |
| Input | Action | Disabled | [Edge Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/edge-detection) | [Pulse Detection](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/pulse-detection) | [Temperature Sensor](https://docs.soracom.io/en/devices/soracom-lte-m-button/io-modes/temperature-sensor) |
| Built-in button | Single short click | - Increments the **short\\\_summary\\\_\_#\_** counter | - Increments the **short\\\_summary\\\_\_#\_** counter | - Increments the **short\\\_summary\\\_\_#\_** counter | - Increments the **short\\\_summary\\\_\_#\_** counter |
| Built-in button | Double short click | - Increments the **double\\\_summary\\\_\_#\_** counter | - Increments the **double\\\_summary\\\_\_#\_** counter | - Increments the **double\\\_summary\\\_\_#\_** counter | - Increments the **double\\\_summary\\\_\_#\_** counter |
| Built-in button | Single long click | - Increments the **long\\\_summary\\\_\_#\_** counter | - Increments the **long\\\_summary\\\_\_#\_** counter | - Increments the **long\\\_summary\\\_\_#\_** counter | - Increments the **long\\\_summary\\\_\_#\_** counter |
| Built-in button | Extra long click | - LED blinks one short green blink: :blink\[.] - Sends a **Status message** to report the current status and configuration | - LED blinks one short green blink: :blink\[.] - Sends a **Status message** to report the current status and configuration | - LED blinks one short green blink: :blink\[.] - Sends a **Status message** to report the current status and configuration | - LED blinks one short green blink: :blink\[.] - Sends a **Status message** to report the current status and configuration |
| 2-wire accessory | Connected | | - Increments the **edge\\\_summary\\\_\_#\_** counter | - Starts a timer and waits for the wire to disconnect | |
| 2-wire accessory | Disconnected | | - Increments the **edge\\\_summary\\\_\_#\_** counter | - Calculates the timer and performs the same action as the built-in button | |
| Internal timer | Uplink frequency | - Sends a **Timer message** | - Sends a **Timer message** | - Sends a **Timer message** | - Reads the temperature sensor\*1 - Sends a **Timer message** |

1. The temperature sensor is measured at the end of each summary interval.

### LED Indicator

While the button is sending an **Timer message** or **Status message**, the LED will blink to indicate the progress:

| LED blink pattern | Description | Progress |
| - | - | - |
| ☀──☀──☀── (repeating) | Slow green blinking | The button is connecting to a network |
| ☀☀☀☀ (repeating) | Fast green blinking | The button has connected and is sending the message |
| ☀──────── | Extra long green blink | The button successfully sent the message |
| ☀──────── | Extra long red blink | An error occurred |

If the button has trouble sending a message, it will try one more time before giving up. For more information, refer to the [Troubleshooting](https://docs.soracom.io/en/devices/soracom-lte-m-button/troubleshooting) section.

Refer to the [LED Reference](https://docs.soracom.io/en/devices/soracom-lte-m-button/led-reference) for descriptions of additional indicators.

### Canceling a Message

If you want to cancel a **Status message**, simply click the built-in button once while the button is connecting to a network.

> [!NOTE]
>
> The **Timer message** cannot be canceled.