---
layout: page
title: "gc100"
description: "Instructions on how to integrate gc100 with Home Assistant."
date: 2017-10-26 17:20
sidebar: true
comments: false
sharing: true
footer: true
ha_category:
  - Hub
  - Binary Sensor
  - Switch
ha_release: 0.57
ha_iot_class: Local Polling
redirect_from:
  - /components/binary_sensor.gc100/
  - /components/switch.gc100/
---

The Global Caché [GC-100](https://www.globalcache.com/products/gc-100/) can be integrated into Home Assistant. GC-100 is a TCP-controllable
hardware device which has an array of relays, RS232 serial ports, and flexible ports which can be programmed to be either digital inputs or IR blaster outputs. There are a variety of submodels of the GC-100 which have different amounts of each I/O type.

There is currently support for the following device types within Home Assistant:

- [Binary Sensor](binary-sensor)
- [Switch](#switch)

Currently, only relays and ports configured to be digital inputs are supported in Home Assistant. For IR support, please use the [iTach remote platform](/components/remote.itach/), but note that it will likely not function concurrently on the same GC100 due to limitations in the TCP socket server implementation used by Global Caché.

## {% linkable_title Configuration %}

To enable this device, add the following lines to your `configuration.yaml`:

```yaml
# Example configuration.yaml entry
gc100:
  host: IP_ADDRESS
```

{% configuration %}
host:
  description: The hostname or IP address of your GC100 device.
  required: true
  type: string
port:
  description: The port on which the GC100 is listening.
  required: false
  default: 4998
  type: integer
{% endconfiguration %}

## {% linkable_title Binary Sensor %}

To enable this sensor, you first have to set up [gc100](#configuration), and add the following lines to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
binary_sensor:
  - platform: gc100
    ports:
      - '3:1': Doorchime
      - '3:2': Garage Obstruction
```

{% configuration %}
ports:
  description: >
    A list of module-address to name mappings in the format `'x:y': name`,
    where x is module #, y is address.
  required: true
  type: list
{% endconfiguration %}

## {% linkable_title Switch %}

This allows you to control and monitor the relay state on your GC100.

To enable this switch, you first have to set up [gc100](#configuration), and add the following lines to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
switch:
  - platform: gc100
    ports:
      - '4:1': Siren
      - '4:2': Sprinkler
```

{% configuration %}
ports:
  description: "A list of module-address to name mappings in the format 'x:y': name, where x is module #, y is address."
  required: true
  type: list
{% endconfiguration %}