Hardware Setup

From Domoticz
Jump to: navigation, search

Before you can use the application to control devices you must setup the communication to hardware device(s). Select Setup|Hardware to add hardware. Devices will not show up until the appropriate hardware is added.
Setup hardware

Supported Hardware

The latest stable Domoticz version 3.5877 supports the below mentioned hardware devices natively. Click on the hardware device link to see more details.

Currently the developers are working on a Python plugin framework which allow other developers to easily create an interface between a piece of Hardware (or Virtual Hardware) and Domoticz. If you are a developer and want to contribute have a look here:

The list below is not all, there are various ways to interact with other devices. It is highly recommended to check the forum and wiki pages, including the hardware overview page.

1-Wire (System) Kodi Media Server RFXCOM - RFXtrx shared over LAN Interface
AccuWeather (Weather Lookup) Limitless/AppLamp/Mi Light With LAN/WiFi interface RFXCOM - RFXtrx315 USB 315MHz Transceiver
Atag One Thermostat Local I2C sensors RFXCOM - RFXtrx433 USB 433.92MHz Transceiver
BleBox devices Logitech Harmony Hub RFXCOM - RFXtrx868 USB 868MHz Transceiver
Comm5 MA-4XXX/MI-XXXX Serial/USB interface Logitech Media Server Rainforest RAVEn USB
Comm5 MA-SXXX with LAN interface MQTT Client Gateway with LAN interface Raspberry's GPIO port
CurrentCost Meter USB Meteostick USB Razberry Z-Wave via LAN interface (HTTP)
CurrentCost Meter with LAN interface Mochad CM15Pro/CM19A bridge with LAN interface Rego 6XX USB/serial interface
Daikin Airconditioning with LAN (HTTP) interface Motherboard sensors S0 Meter USB
DarkSky (Weather Lookup) / Forecast.io Multifun LAN S0 Meter with LAN Interface
Davis Vantage Weather Station USB MyHome OpenWebNet SBFSpot (SMA)
Denkovi Smartden with LAN interface MySensors Gateway USB Satel Integra via LAN Interface
Domoticz - Remote Server MySensors Gateway with LAN Interface SolarEdge via LAN interface
Domoticz Internal interface Nefit Easy HTTP server over LAN Interface SolarEdge via Web API
Dummy (Does nothing, use for virtual switches only) Nest Thermostat/Protect SolarMax via LAN Interface
ETH8020 Relay board with LAN interface Netatmo Sterbox v2-3 PLC With LAN Interface
Eco Devices Via LAN Interface Open Weather Map System Alive Checker (Ping)
EnOcean USB (ESP2) OpenTherm Gateway USB TE923 USB Compatible Weather Station
EnOcean USB (ESP3) OpenTherm Gateway with LAN interface Teleinfo EDF USB
Energy Count 3000/ NETBSEM4/ La Crosse RT-10 LAN OpenZWave USB Tellstick
Evohome USB (for HGI/S80) P1 Smart Meter USB Thermosmat Thermostat
Evohome via script P1 Smart Meter with LAN interface Toon Thermostat
Fitbit PVOutput (Input) Volcraft CO-20 USB air qualty sensor
Fritzbox Callmonitor via LAN interface Panasonic TV Wake-on-LAN
Goodwe solar inverter via Web API Philips Hue Bridge Weather Underground
HEOS by DENON PiFace - Raspberry Pi IO expansion board Winddelen
HTTP/HTTPS poller Plugwise Anna Thermostat via LAN interface YeeLight LED
ICY Thermostat RFLink Gateway USB YouLess Meter with LAN Interface
KMTromc 433MHz Gateway USB RFLink Gateway with LAN interface ZiBlue RFPIayer USB
KMTromc Gateway USB ZiBlue RFPlayer with LAN Interface
KMTromc Gateway with LAN interface

Setting up a USB hardware

First make sure the device is recognized in the system. Domoticz automatically detects the USB port.
Add USB Hardware
By pressing the ADD button, the hardware is added to the system and will automatically start.

Setting up a LAN hardware

First make sure you know the IP address and port of the device.
Add LAN Hardware
By pressing the ADD button, the hardware is added to the system and will automatically start.

Shared Devices

It is possible to share your (Domoticz) sensors with your friends. For instance you can share your Rain Meter, but also lights/switches that other people can control. For this, you need to enter an Administrator username/password in the application settings. Then you can add users and assign sensors/switches to this user. An example how to set up sharing is detailed in Setting_up_Device_sharing.
To make your Domoticz server reachable when behind a NAT/Firewall router it's port forwarding needs to be configured. Consult the documentation of the router on how to setup a Firewall/NAT/Forward rule or check this howto.

Domoticz Remote Server

To receive sensors from other people, you have to add a ‘Domoticz – Remote Server’ hardware device, specify the IP Address/Port of the remote Domoticz server, the username and password.

Weather Underground

A special type of hardware is the possibility to retrieve weather data (temperature, wind, rainfall, pressure, sunshine) from thousands of weatherstations from all over the world. You need to obtain a personal API key from wunderground.com. A free subscription enables you to retrieve data 500 times a day. Domoticz requests data every 10 minutes so you can monitor a maximum of 3 stations per subscription. Fill in your API key and fill the location field with the station ID found at Wunderground. Note that personal weather stations need to have pws: before the station ID (e.g. pws:INOORDHO68). If you want to monitor more stations request additional API keys at Wunderground.
See Virtual_weather_devices for a tutorial on how to subscribe to and use this feature.
Weather Underground

Dummy Hardware

Another special hardware type is the Dummy Hardware. As the name implies this hardware does not communicate with the outside world. It's purpose is to be a placeholder for virtual switches and virtual sensors which can be used as variables in events and scripts. New virtual switches need to be added in the switches tab (Add manual light/switch). New virtual sensors can be created from the hardware overview list.
Dummy Hardware

Hardware list

When hardware is added the overview of all defined hardware will be shown. Hardware can be disabled or deleted. For the RFXCOM transceiver the different protocols can be selected by clicking the "Set Mode" button.
Hardware Overview

Debugging Hardware

You can see a debug console (windows) by pressing the right mouse button on the Domoticz icon in the system tray or check the Log window by selecting Setup|Log.
Log Option