User Manual

for HAUS Gatekeeper Home Premium




Type: HAUS Gatekeeper Home Premium 12 V Rev. 0

Model code: GK-HP-12_R0

Greetings

Thank you for purchasing our product! We wish you a smooth installation and enjoyable use of our product, and hope we’ve done a good job on making this possible for you!

In case of any concern please consult this short version or the extended documentation available on our Document Store:
https://docs.liminaltechnology.com/en/GK-HP-12_R0

Before using our product please read through carefully this user manual, paying special attention on below section on safety.

Safety information

CAUTION:

To avoid damages and injuries always follow the instructions in this document!

Product identification

You can found product identification information on the printed circuit board of the device, on top side, close to the edges.

IT security and privacy

Consider IT security and privacy: please follow Security Hardening Guide for further information and suggestions.

Declaration of Conformity

Liminal Technology hereby declares that this product conforms to the applicable requirements stated in below EU directives:

You can download the original of the full declaration from below location:
https://docs.liminaltechnology.com/en/GK-HP-12_R0

Manufacturer:
Liminal Technology
H-1116 Budapest, Kondorosi street 12/A/B 5/14

This product incorporates Wi-Fi certified radio equipment, but the resulted product itself is not certified, however manufacturer declares conformity to Wi-Fi standards.

In accordance with the European defaults used electrical and electronics devices may no more be given to the unsorted waste. The symbol of the waste bin on wheels refers to the necessity of separate collection. Please help protecting the environment and make sure that this device is given to the designated systems of waste sorting if you do not use it any longer. Electrical and electronics devices contains valuable materials, worth to recycle instead of excavating new raw materials.

Liminal Technology also proudly announces its own waste collection system: Back4Bonus. At the end of the lifecycle of products we manufactured, please send them back to us and we honor your efforts with special benefits. Please find further information on our website: https://liminaltechnology.com/en/back4bonus
We’ve
designed our products in a modular way, which not only helps servicability, but at the end of the lifecycle we are able to recycle our products with higher efficiency.




Basic introduction of the device

Naming and purpose of parts of the device



Accessories

Please install the device with suggested accessories.

Name (and product code)

Description

Image

Voltage select jumpers

Shipped with the controller (3 pcs)


4k resistor block
(res-block-4k)

Converts a 12 V input to 24 V tolerant


Temperature sensor
(ds18b20-1m-nx)

Weather-proof sensor with NX connector


Gate state sensor
(fm-106)

Weather-proof magnetic reed-switch


IP 54 enclosure
(box-10x10-ip54)

Controller enclosure for indoor use


IP 65 enclosure
(box-10x10-ip65)

Controller enclosure for outdoor use


12 V power supply
(supply-12v-12w)

230 V AC to 12 V DC 12 W power supply


Installation guide

Connect the device to power supply, controlled devices, sensors and buttons according to the below diagram.




Power supply

Connect the positive and negative power supply terminals to a suitable DC power supply, able to provide at least 250 mA @ 12 V. Take care of correct polarity!

You might find a suitable power source terminal on the to be controlled device (gate motor control board) or you might need a separate power supply (see accessories).

Relays

The relays’ COM terminal are normally connected to the NC (Normally Closed) terminal. When the relay is activated the COM terminal separates from NC and engages with NO (Normally Open) terminal. Always refer to the documentation of the to be controlled device for proper wiring. In most cases you need to use the COM and NO terminals.

Digital inputs

The Digital inputs are normally pulled down to GND (0 V). They can be controlled by a signal voltage relative to the negative pole of the power source terminal of this device. The signal voltage levels are configurable by the jumpers associated with the input channels.

If the corresponding jumper terminal is open (jumper not placed), then input channel can be controlled by a 12 V signal.

If the corresponding jumper terminal is closed (jumper placed), then input channel can be controlled by a 5 V signal.

Important note: Never directly connect a higher voltage signal than configured, as it will damage the device!

You can connect a 24 V signal via a 4k resistor block (see accessories) to an input channel configured to 12 V signal.

Important note: If you connect a digital output of another device to a digital input of this device, make sure that the two devices share a common signal ground connection and that the voltage levels are compatible!
Please refer to the documentation of the other device for a suitable signal ground terminal!

Environmental / Temperature sensor

Please only use the temperature sensor listed amongst the accessories! It is shipped with an assymetric 3 pole connector, which can be connected only in the correct orientation. Later on multiple chainable temperature, humidity and barometric pressure sensors are planned to be offered. For further information please visit our website.

Gate state sensor

Gate state can be monitored with a simple switch. As a gate state sensor we offer a non-contact magnetic reed switch in weather-proof enclosure. Other switches or proximity sensors may be used, but we recommend our solution, as in average use-cases it is the simplest and most reliable solution.

Gate state sensor is configured to Digital input Channel 1 by default. This input is normally pulled to ground and sensor pulls it up to a positive voltage, when the sensor switch closes the circuit. Channel 1 is recommended to be left in its default 12 V mode, then the other wire of the gate sensor can be connected to the 12 V power supply of the device.

Whether open and closed state of the sensor switch represents the open or closed position of the gate is configurable. We suggest to use the default configuration of closed switch equals closed gate, as in this case a partially opened gate is also sensed as open.

Some gate motor controllers have a built-in gate sensor and offer a gate state output. You may use this by keeping in mind the regulations on Digital inputs described in previous chapter.

Please check warnings in Digital inputs chapter, if you use an active device as a gate state sensor!

Doorbell button

Doorbell button is configured to Digital input Channel 2 by default. This input is normally pulled to ground and button pulls it up to a positive voltage, when it closes the circuit. Channel 2 is recommended to be left in its default 12 V mode, then the other wire of the doorbell button can be connected to the 12 V power supply of the device.

Please check warnings in Digital inputs chapter, if you use an active device as a doorbell button!

Initial configuration guide

Configuring the device is similar to configuring a Wi-Fi router the first time.

HAUS IoT controllers provide two configuration interfaces:

For initial configuration you connect to the Wi-Fi hotspot provided by the device, then configure it via a web browser.

All details of the parameters (e.g. default value, possible characters, maximum length) are listed in the Parameter Description.

Connecting and logging in

After the device is powered, it creates a Wi-Fi hotspot with an SSID: Gatekeeper_XXXXXX

Configuration can be done via a desktop or mobile (phone) web browser.

Search for available Wi-Fi networks, then connect to the Gatekeeper_XXXXXX Wi-Fi AP (where the last part of the SSID is unique for your device).

Open http://192.168.4.1/ in your browser. (On most of the computers/phones http://Gatekeeper_XXXXXX.local/ also works (XXXXXX is same as for SSID).

The Login screen of WebUI is shown. Default credentials:

On successful login you’ll land on a status page.

Configuring Wi-Fi/Internet connection

Select “WiFi settings” menu, then:

Once your device connects to your home Wi-Fi network, you can reach the WebUI configuration interface via http://192.168.X.Y from your home Wi-Fi network. (The exact IP address of the device is shown on the Device status page.) This way you no longer need to directly connect to the Wi-Fi hotspot provided by this device.

Configuring Device identity

Select “Device identity” menu, then:



Configuring MQTT

Select “MQTT settings” menu, then:

Notes on MQTT brokers:

There are free or low-cost cloud based MQTT brokers on the Internet. Simply register to the service and use it. Such services are:

Use only secure solutions, where you can restrict access to your “own” broker. Never use public MQTT brokers with anonymous or public access!

We use CloudMQTT service, which is a perfect choice. It’s not for free anymore, but quite low-cost and worth the money. See CloudMQTT Integration Guide for details on setting up an MQTT broker.

Ready to use

Congratulations! Now your HAUS Gatekeeper is ready to use!

Configuring Location beacons

A unique feature of Gatekeeper is responding to your geolocation, while respecting your privacy. By tracking your movement events may be triggered, when you enter or leave regions.

Important to note that tracking your location is technically done by an open source application, called OwnTracks, not sharing your location with unwanted parties, and your location information is transferred via your own private MQTT infrastructure, so you have total control over your data.

Gatekeeper also supports an alternative way of detecting your presence (actually the presence of a Wi-Fi capable device of yours) by detecting if a device with a certain MAC address connects to the Wi-Fi hotspot provided by Gatekeeper. Actions may also be connected to such Wi-Fi attach/detach events.

For details let’s go through the configuration process step-by-step:

For OwnTracks beacons the presence of the beacon is detected, when OwnTracks reports that it is within the region of Gatekeeper (Region name reported by OwnTracks matches the Region name set in Device identity). When OwnTracks leaves region, it also reports it, and Gatekeeper recognizes that beacon is away.

For “Wi-Fi AP attach” beacons the presence of the beacon is detected, when the device connects to the Gatekeeper provided hotspot, and considered away, when it detaches.

This “in region” or “away” state of the beacons may be checked locally on the WebUI or remotely on the MQTT interface.

Currently there is a fix action connected to the “enter region” event of beacons. This action is: opening the gate. Currently there is no action connected to the “leave region” event. This will change soon and will be configurable on the WebUI interface.

Location beacons may also be configured/queried via the MQTT interface.

Check environmental sensors

If you’ve connected the digital temperature sensor correctly, it will be recognized automatically. You may check this on the “Environmental sensors” menu. You can enable/disable the feature, also you may clear the historical minimum and maximum measured values since the last startup of Gatekeeper. (Please note that Gatekeeper may restart automatically after an automatic firmware upgrade, if enabled).

Firmware update

Automatic firmware update is enabled by default, and Gatekeeper checks for new firmware once in every 24 hours on the configured update server. By default the Liminal Technology Software Gateway is configured.

You may disable it, but we suggest to leave it enabled. We’ll not release automatic updates, which may break or change expected behaviour of our products.

You may check for updates manually and make the decision of upgrading after reading on the changes after clicking on appearing “See what's new” link.

Further details

To get a fully detailed description of the software, please see our Software User Guide.

Technical specification

Supply voltage: 12 V DC

Power consumption:

Maximum load and voltages on relays:

Digital inputs electronic characteristics:

Sensor bus specification:

Dimensions:




FAQ and troubleshooting

CAUTION: Before any physical troubleshooting please read through the Safety information chapter in this document to avoid damages or injuries!

Q: Device doesn’t work, no LEDs lit.
A: If red LED is not lit, either there is no power, or the on-board fuse is burned. Please check power, all connections for possible short-circuits and replace fuse if necessary (a curved-tip tweezer will be handy to pop-off the fuse cap).

Q: I’ve forgot Wi-Fi AP/WebUI password and locked myself out of the device.
A: If the device’s MQTT connection is online, you can change passwords remotely. Please check MQTT Interface Description for details. Otherwise press factory reset button for at least 5 seconds (till blue LED lit), then factory defaults getting restored, all user settings get lost, then you can reconfigure your device.

Q: Device doesn’t work and blue LED is continuously blinking.
A: Essential data stored in flash memory is probably corrupted. Please submit a support request.

For Frequently Asked Questions please visit https://support.liminaltechnology.com/faq

If you are still struggling with the problem, feel free to Raise a support request:

References to online documentation

This User Manual is only a short excerpt of the product documentation.

Please visit the full product documentation in the Document Store on our website:


https://docs.liminaltechnology.com/en/GK-HP-12_R0