> 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/integrated-systems/open-supervised-device-protocol-osdp-integration/configuring-an-osdp-reader.md).

# Configuring an OSDP Reader

### Introduction

This procedure describes how to configure an Open Supervised Device Protocol (OSDP) Reader in Gallagher Command Centre.

***

### Configuration

To configure an OSDP Reader, perform the following procedures in Gallagher Configuration Client:

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/glossary-of-terms.md#tree-view)).
2. **Right click** and select **New\...OSDP Devices** > **OSDP Reader.**

   By default the **General** tab displays.

   **Note:** Sites licensed for Personal Identity Verification (PIV) will also have an option for configuring OSDP Veridt Stealth PIV Readers.
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 each tab in turn to configure the reader:

<details>

<summary>Connections tab</summary>

1. Click the **Connections** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-8b93eb6e067236a1252c467dfa2da07065eaf302%2Fosdpreader_connectionstab.png?alt=media)

   The three fields, (i.e. **Connected to**, **RS-485 Bus** and **Device Number** ) will be populated once you assign this reader to a Controller 6000. See [Assigning an OSDP Reader to a Gallagher Controller 6000](https://help.security.gallagher.com/knowledge-hub/configuration-client/integrated-systems/open-supervised-device-protocol-osdp-integration/assigning-an-osdp-compliant-reader-to-a-gallagher-controller.md) for further detail.

</details>

<details>

<summary>Advanced tab</summary>

1. Click the **Advanced** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-810f16d7a8348befa7bab8124f11db182007bd1b%2Fosdpreader_advancedtab.png?alt=media)
2. Check the **PIN is user code** checkbox if required.

   With **PIN is user code** checked, the user code will be required in place of a PIN for any transactions at the reader which would normally require a PIN. This includes door access and overrides.
3. Depending on your sites license file, an additional field may display.

   <table><thead><tr><th width="330">If the...</th><th>then your site is licensed for...</th></tr></thead><tbody><tr><td><strong>Accept GovPass card reads</strong> checkbox displays,</td><td><p>GovPass, (i.e. the license file contains UKGovPASS=1).</p><p>Check this checkbox if you want this reader to be able to accept a GovPass credential card read.</p></td></tr><tr><td><strong>Accept CipherToken card reads</strong> checkbox displays,</td><td><p>CipherToken, (i.e. the license file contains CipherToken=1).</p><p>Check this checkbox if you want this reader to be able to accept a CipherToken credential card read.</p></td></tr></tbody></table>
4. If you want the double-card override feature to be available, click either the **Override access zone** or the **Arm alarm zone** radio button, depending on whether you want the double-card override to override the state of the Access Zone or arm the Alarm Zone associated with the Access Zone.
5. The **Secure Channel** setting allows you to turn encrypted communications on and off, (e.g. you may want to turn it off if it affects performance or the device does not support encryption).

   Does the device support encrypted communications?

   <table><thead><tr><th width="58">If...</th><th>then...</th></tr></thead><tbody><tr><td>yes,</td><td>check the <strong>Encrypt communications (supported devices only)</strong> checkbox to turn encryption on. If this is not done an alarm will be generated.</td></tr><tr><td>no,</td><td>leave the <strong>Encrypt communications (supported devices only)</strong> checkbox unchecked. If it is checked, an event will be generated and it will remain offline until encryption is turned off, (i.e. the <strong>Encrypt Communications</strong> checkbox is unchecked). The device’s status will indicate that it is offline and encryption is not supported, (i.e. <em>"Device not responding. Encryption not supported."</em>)</td></tr></tbody></table>
6. Do you want access and status messages to be displayed on this reader's screen?

   <table><thead><tr><th width="58">If...</th><th>then if the Server Properties are configured to...</th></tr></thead><tbody><tr><td>no,</td><td>NOT show reader messages, leave the <strong>Use site default settings</strong> checkbox checked; OR<br>if the Server Properties ARE configured to display reader messages, deselect the <strong>Use site default settings</strong> checkbox and ensure the <strong>Show reader display messages</strong> checkbox is unchecked.</td></tr><tr><td>yes,</td><td>show reader messages, leave the <strong>Use site default settings</strong> checkbox checked; OR<br>if the Server Properties are configured to NOT display reader messages, deselect the <strong>Use site default settings</strong> checkbox and select the <strong>Show reader display messages</strong> checkbox.</td></tr></tbody></table>

</details>

<details>

<summary>Card Read Output tab</summary>

1. Click the **Card Read Output** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-2a77eb590d8eead26ed5f1d9d72a090da54bda71%2Fosdpreader_cardreadoutputtab.png?alt=media)
2. From the **Card Read Output** drop-down list (which includes virtual outputs), select the output to switch on when a card is badged at the reader.

   **Notes:**

   * Badging a card at this reader will switch on the associated relay. The relay will then be immediately switched off unless the relay output is configured to pulse, in which case the relay will stay on for the pulse time and then be switched off. The card format does not have to be correct, nor does the card have to be assigned to a cardholder to trigger the relay.
   * It is recommended that the output be configured to pulse (via the **Advanced** tab of the Output's properties). If the Output is not configured as a pulse output then the relay will pulse for 1 second. The Output can be assigned to more than one reader at a time, each reader will cause the relay to pulse.

</details>

7. Click the **Cameras** tab if you want to associate a DVR Camera(s) with this OSDP Reader.

   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).
8. Click the **Icons** tab if you want to change the Icon Set for this OSDP Reader.

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

   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).
10. Click the **Notes** tab if you want to add a note(s) about this OSDP Reader.

    For further details regarding the **Notes** tab, see [Notes](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/notes.md).
11. 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.

#### Assigning the Reader

Once the configuration work is complete, you need to assign the Reader to a Gallagher Controller 6000 and a Door.

12. Assign this reader to a Controller. See [Assigning an OSDP Compliant Reader to a Gallagher Controller](https://help.security.gallagher.com/knowledge-hub/configuration-client/integrated-systems/open-supervised-device-protocol-osdp-integration/assigning-an-osdp-compliant-reader-to-a-gallagher-controller.md) for further detail.
13. From the Door List Window, highlight the door you want to assign this reader to.
14. **Right click** and select **Properties**.
15. Click the **Entry Zone** or **Exit Zone** tab as appropriate.
16. Assign the reader to the appropriate Reader Address by selecting it from the relevant **Reader(s)** drop-down list.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-bb8fd6df0b30e175f5d7f9fa0e3eda0b633c3865%2Fosdp_door_entryzonetab.png?alt=media)
17. 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.


---

# 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/integrated-systems/open-supervised-device-protocol-osdp-integration/configuring-an-osdp-reader.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.
