> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/perimeter-sensors/configuring-a-z20-disturbance-sensor.md).

# Configuring a Z20 Disturbance Sensor

### Introduction

This procedure describes how to configure a Z20 Disturbance Sensor.

### Procedure

1. Click **Configure** from the menu bar, then **Hardware**.

   The **Hardware** List Window opens (in [tree view](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/tree-view.md)).
2. **Right click** and select **New\...Sensor Devices** > **Z20 Disturbance Sensor**.

   By default the **General** tab displays.
3. Complete the fields as required.

   For further detail see [General tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/general-tab.md).
4. Click the **Event Response** tab, and configure as required.

   For further detail see [Event Response tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/event-response-tab.md).
5. Click the **Alarm Instructions** tab, and configure as required.

   For further detail see [Alarm Instructions tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/alarm-instructions-tab.md).
6. Click the **Connections** tab.

   The fields **Connected to** and **Device number** will only be populated once you assign the sensor to a Controller.
7. Click the **Configuration** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-29978e2a7f65587df2f5e90560c7abbf74a28e2a%2Fd21sensor_configurationtab.png?alt=media)
8. Configure the fields as required:

   <table><thead><tr><th width="166">Field</th><th>Description</th></tr></thead><tbody><tr><td>View live sensor data</td><td><p>When checked, <strong>Tilt Threshold</strong> and <strong>Dynamic Threshold</strong> graphs display, showing actual values generated by each sensor over the last two minutes. The <strong>Y</strong> axis represents the threshold and the yellow line indicates the actual setting. The <strong>X</strong> axis is time - 120 seconds.<br><img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-bea7fad5cf26085d495acc81fb94dfa3ed235aa7%2Fd21sensor_configurationtabgraphs.png?alt=media" alt=""><br>The data in the <strong>Tilt Threshold</strong> and <strong>Dynamic Threshold</strong> fields will display dynamically. This makes it possible to see changing values when the page is open. Data will continue to be updated and displayed until the tab is closed.</p><p><strong>Note:</strong> When checked, the Dynamic and Tilt values are displayed and updated on the <strong>Status and Overrides</strong> tab also.</p></td></tr><tr><td>Tilt Threshold</td><td><p>This number determines the rate that the device can be tilted, (i.e. its orientation changed) before it generates an alarm event.</p><p>(Default = 50. Range = 1 to 1000)</p></td></tr><tr><td>Dynamic Threshold</td><td><p>This number determines the degree of disturbance energy the device can sense before it registers a dynamic disturbance.</p><p>(Default = 300. Range = 1 to 5000)</p></td></tr><tr><td>Maximum Event Count</td><td><p>This is the maximum number of dynamic events that can be stored.</p><p>(Default = 10. Range = 1 to 100)</p></td></tr><tr><td>Alarm Latch Duration</td><td><p>This number determines how long an alarm condition is maintained after an alarm condition is reached.</p><p>(Default = 2.5 seconds. Range = 0.01 seconds to 600.00 seconds, i.e. 10 minutes)</p></td></tr><tr><td>Dynamic Count Threshold</td><td><p>This is the number of recurring disturbances that are treated as a single alarm event if they occur within a preset period (Dynamic Hold Time).</p><p>(Default = 2. Range = 1 to 100)</p></td></tr><tr><td>Dynamic Hold Time</td><td><p>This is the period within which recurring disturbances (as set by the Dynamic Count Threshold) are treated as a single alarm event.</p><p>(Default = 1 second. Range = 0.01 seconds to 600.00 seconds, i.e. 10 minutes)</p></td></tr><tr><td>Dynamic Memory length</td><td><p>This value indicates how long the device will remember a dynamic disturbance.</p><p>(Default = 10 seconds. Range = 0.01 seconds to 600.00 seconds, i.e. 10 minutes)</p><p><strong>Note:</strong> The Dynamic Memory length must be equal to or greater than the Dynamic Hold Time, multiplied by the Dynamic Count Threshold.</p></td></tr></tbody></table>
9. Click the **Cameras** tab if you want to associate a DVR Camera(s) with this Disturbance Sensor.

   For further details see [Cameras tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/cameras-tab.md).
10. Click the **Icons** tab if you want to change the Icon Set for this Disturbance Sensor.

    For further details regarding the **Icons** tab, see [Icons](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/icons.md).
11. Click the **Custom Fields** tab if you want to add and assign a custom field value to this Disturbance Sensor.

    For further details regarding the **Custom Fields** tab, see [Custom Fields](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/custom-fields.md).
12. Click the **Notes** tab if you want to add a note(s) about this Disturbance Sensor.

    For further details regarding the **Notes** tab, see [Notes](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/notes.md).
13. Click **OK** to exit and save your changes.

    Click **Cancel** to exit without saving your changes.

    Click **Apply** to save your changes and stay in this window.

### Result

A new Z20 Disturbance Sensor has been configured.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/perimeter-sensors/configuring-a-z20-disturbance-sensor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
