User Manual
for HAUS Gatekeeper Home Premium
Type: HAUS Gatekeeper Home Premium 12 V Rev. 0
Model code: GK-HP-12_R0
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.
To avoid damages and injuries always follow the instructions in this document!
Don’t expose the bare device to rain, moisture or other forms of water!
Device must be installed in some sort of appropriate enclosure, e.g.: in an electrical junction box.
When installed outdoor, place the device in an enclosure protected against dust and water splashing/jets (conforming to IP65 or better).
Don’t expose the device to heat sources! Install it in a way that the minimal heat generated by the device itself during normal operation can be conducted/radiated away.
Use only suggested accessories!
Use only with a well insulated power supply!
However the relays of the device are able to switch mains voltage levels, installing the device for such purpose is only allowed for trained electricians! In this case installing the device in an at least IP54 conform enclosure designed for mains circuitry is mandatory. Don’t use the device with voltage levels exceeding 30 V AC or DC for life protection reasons!
Never install, maintain, repair or decomission the device, when powered! Switch off electric supply first! Also power off the devices connected to the relays and inputs of this device!
Don’t try to repair the device on your own! Please send it to an electric repair shop or call for a trained electrician.
You can found product identification information on the printed circuit board of the device, on top side, close to the edges.
Consider IT security and privacy: please follow Security Hardening Guide for further information and suggestions.
Liminal Technology hereby declares that this product conforms to the applicable requirements stated in below EU directives:
2014/30/EU directive on electromagnetic compatibility
2014/35/EU directive on low voltage
2014/53/EU directive on radio equipment
2017/2102/EU RoHS 2 directive (extending 2011/65/EU)
2012/19/EU directive on waste electrical and electronic equipment (WEEE)
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.
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 |
Converts a 12 V input to 24 V tolerant |
|
Temperature
sensor |
Weather-proof sensor with NX connector |
|
Gate
state sensor |
Weather-proof magnetic reed-switch |
|
IP
54 enclosure |
Controller enclosure for indoor use |
|
IP
65 enclosure |
Controller enclosure for outdoor use |
|
12 V
power supply |
230 V AC to 12 V DC 12 W power supply |
|
Connect the device to power supply, controlled devices, sensors and buttons according to the below diagram.
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).
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.
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!
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 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 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!
Configuring the device is similar to configuring a Wi-Fi router the first time.
HAUS IoT controllers provide two configuration interfaces:
Web-based configuration interface, called WebUI
Remote configuration interface via MQTT
Simplified configuration with our mobile app comes in the near future
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.
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).
WPA2 Wi-Fi password: Magic123
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:
Username: admin
Password: Magic123
On successful login you’ll land on a status page.
Select “WiFi settings” menu, then:
Optionally edit the WiFi AP configuration of the device. (Don’t disable WiFi AP, till you’ve not configured your device to be accessible via your home Wi-Fi network!)
Configure the SSID and password of your home Wi-Fi network.
Save changes, then check connection status on the Device status page.
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.
Select “Device identity” menu, then:
Set a Device name of your choice. Later on you’ll use this name in remote controller mobile applications. Also this name is used, if you access WebUI with hostname in your browser: http://<deviceName>.local
Set a Region name of your choice. Later on you’ll use this name in OwnTracks for loaction based events.
Region location is not needed for default use-cases. Will be used later for an alternative mode for location based events.
Select “MQTT settings” menu, then:
Fill in the connection details for your MQTT broker. You can use any MQTT service of your choice, including free online services or setting up an own MQTT broker on a Raspberry Pi, etc.
Username used by location beacons may be the same as username above, but we suggest to set up a different user for that purpose due to security and privacy considerations. See Security Hardening Guide for details.
Save changes, then check connection status on the Device status page.
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:
MaQiaTTo (shared broker with private topic namespace)
flespi (shared broker with private topic namespace)
Amazon AWS IoT Core (only client certificate authentication, for later use)
Microsoft Azure IoT Hub (only client certificate authentication, for later use)
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.
Congratulations! Now your HAUS Gatekeeper is ready to use!
You can control it directly via the WebUI interface. See “Gate & Light control” and other menus for features provided. You can access this interface even if there is no Internet connection in your home.
You can control it remotely via MQTT. See MQTT Interface Description for technical details.
For your convenience we support a 3rd party Android dashboard/remote control application, which nicely controls your Gatekeeper via its MQTT interface. See MQTT Dash Integration Guide for details.
There are some iOS applications (listed in above document), possible to use, but we don’t support them officially.
We’ll come with an own mobile app in the near future.
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:
Select “Location beacons” menu and add a new beacon with the + button.
Give a name for the beacon (later use the same Device ID in OwnTracks app).
Created beacon is disabled by default. Change it to “OwnTracks region events”, then save changes. Follow OwnTracks Integration Guide to finish configuration.
Alternatively change Beacon type to “WiFi AP Attach”, fill in MAC address of your Wi-Fi capable device, optionally set a threshold on detected Wi-Fi signal strength, then save changes.
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.
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).
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.
To get a fully detailed description of the software, please see our Software User Guide.
Supply voltage: 12 V DC
Power consumption:
Idle: ~0.5 W
Maximum: ~3 W
Maximum load and voltages on relays:
Monostable relays (Relay 1 and 2): 10 A @ 250 V AC / 30 V DC
Bistable relay (Latching Relay): 8 A @ 250 V AC / 30 V DC
Digital inputs electronic characteristics:
Voltage levels: 5 / 12 V (configurable with corresponding jumper)
Normally pulled down to 0 V
Sensor bus specification:
Connector: 3 pin NX
Protocol: OneWire
Voltage level: 3.3 V
Dimensions:
Width/Height/Depth: 85 x 64 x 24 mm
Distance of mounting holes: 80 / 59 mm (hole size: 2 mm)
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:
Visit https://support.liminaltechnology.com/create
If you are able to login to WebUI, go to the Get support page and click “Raise a support ticket” button, so device specific fields are getting filled automatically.
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: