Skip to content


Repository files navigation

pimatic-z-way plugin

This is a pimatic plugin which allows you to control Z-Wave devices using Z-Way.


You can load the plugin by editing your config.json to include:

   "plugin": "z-way",
   "hostname": "" // set hostname if necessary (localhost by default)
   "username": "admin", // Username for your z-way webinterface (default admin)
   "password": "P4$$w0Rd" // Password for your z-way webinterface

Devices can be defined by adding them to the devices section in the config file. Set the class attribute to one of the following classes. For example:

  "class": "ZWaySwitch",
  "id": "fibaro_plug",
  "name": "Wall Plug",
  "virtualDeviceId": "ZWayVDev_zway_2-0-42",
  "interval": 0
  "class": "ZWayDimmer",
  "id": "fibaro_dimmer",
  "name": "Dimmer",
  "virtualDeviceId": "ZWayVDev_zway_2-0-44",
  "interval": 0
  "class": "ZWayThermostat",
  "id": "danfoss_321",
  "name": "Heater 1",
  "virtualDeviceId": "ZWayVDev_zway_19-0-17-1",
  "interval": 20,
  "comfyTemp": 20,
  "ecoTemp": 17
  "class": "ZWayPowerSensor",
  "id": "fibaro_power_sensor",
  "name": "Power Sensor",
  "virtualDeviceId": "ZWayVDev_zway_2-0-43"
  "class": "ZWayLuminescenceSensor",
  "id": "fibaro_luminescence_sensor",
  "name": "Luminescence Sensor",
  "virtualDeviceId": "ZWayVDev_zway_2-0-49"
  "class": "ZWayHumiditySensor",
  "id": "fibaro_Humidity_sensor",
  "name": "Humidity Sensor",
  "virtualDeviceId": "ZWayVDev_zway_2-0-51"
  "class": "ZWayDoorWindowSensor",
  "id": "fibaro_window_sensor",
  "name": "Window Sensor",
  "virtualDeviceId": "ZWayVDev_zway_2-0-45"
  "class": "ZWayTemperatureSensor",
  "id": "fibaro_temp_sensor",
  "name": "Window Sensor",
  "virtualDeviceId": "ZWayVDev_zway_2-0-46"
  "class": "ZWayMotionSensor",
  "id": "fibaro_motion_sensor",
  "name": "Motion Sensor",
  "virtualDeviceId": "ZWayVDev_zway_2-0-47"
  "class": "ZWayShutterController",
  "id": "fibaro_roller_shutter",
  "name": "Roller Shutter",
  "virtualDeviceId": "ZWayVDev_zway_2-0-48"

Figure the virtualDeviceId out by calling curl http://HOSTNAME:8083/ZAutomation/api/v1/devices. If the interval option is greater than 0 then the state of the device is updated automatically after the defined seconds. Sensors always should have a value greater than 0.


Starting with Z-Way v2.0.1 authentication can become an issue for you. There must be a user that has access to your devices.

  1. Go to http://HOSTNAME:8083/smarthome/
  2. Assign your devices to room(s).
  3. In User management allow the 'Local User' to access your rooms.
  4. If you do not use the default 'localhost' as hostname, create a new anonymous user and allow him access to your rooms.


pimatic plugin for controlling devices using Z-Way







No packages published