Skip to content

Setup your Shelly devices

PowerController requires at least one Shelly device to operate. You can run the application in simulation mode for testing, but to actually control and/or meter an electrical device, you'll need at least one Shelly device installed and configured. Shelly make a wide range of home automation products. PowerController supports the majority of Shelly's smart switches and energy meters that support WiFi or Ethernet connectivity.

  1. Install your device(s) according to Shelly's installation instructions.
    • Get help from a licensed electrician if you're uncomfortable doing this work yourself.
    • You must connect the device to your network via WiFi or Ethernet (PowerController doesn't support Bluetooth, Z-Wave or Zigbee only devices at this time)
  2. Use the Shelly app to make sure the device is working as intended.
  3. Please do not create any Actions for the device (these might conflict with the app's control of the device).
  4. In the app, go to Settings > Device Information and make a note of the following:
    • Device IP address (e.g. 192.168.86.21)
    • Device Type (e.g. Shelly Plus 2 PM)
  5. Lookup the device type in models library and make a note of the model identifier (e.g. ShellyPlus2PM). Here's the entry for our example:
    {
      "model": "ShellyPlus2PM",
      "name": "Shelly Plus 2PM",
      "url": "https://shelly-api-docs.shelly.cloud/gen2/Devices/Gen2/ShellyPlus2PM",
      "generation": 2,
      "protocol": "RPC",
      "inputs": 2,
      "outputs": 2,
      "meters": 2,
      "meters_seperate": false,
      "temperature_monitoring": true
    },

Digital Temperature Probes

If you have a Shelly Add-on installed on your Shelly switch, then you can connect up to 5 ds18b20 probes to the add-on. You must setup the probe(s) as follows before adding the probe's name to the ShellyDevices:Device:TempProbes section of your config file:

Once you have connected the Shelly Add-on to your Shelly smart switch and connected your DS18B20 temperature probes to the add on, you need to configure the probes in the mobile app:

  1. Go to the Shelly device you have installed the Add-on to and configure the add-on
    • Click Add-on peripherals section
    • Change to Sensor Addon and then reboot if prompted
  2. After reboot, go back to same tab and click Add Add-on Peripheral
    • Select Temperature (DS18B20)
    • Select a probe listed from the automatic scan and click Add Peripheral
    • Reboot when prompted
  3. After reboot, go back to same tab and click the settings gear icon next to the newly added probe
    • Give the probe a name (important) - for example "Roof Temp"
    • Optionally enable the 'extract peripheral as device' option (if you want it to appear as a seperate device on your dashboard
  4. Repeat steps 2 and 3 for any other connected probes

Now add these probe(s) to ShellyDevices:Device:TempProbes section of your config file, being sure to use exactly the same names as you used in the Shelly app.

ShellyDevices:
  ...
  Devices:
    - Name: Downstairs Lights
      Model: Shelly2PMG3
      Hostname: 192.168.1.23
      ...
      TempProbes:
        - Name: "Roof Temp"

Unsupported device

If you've bought a Shelly smart switch or energy meter and are having problems getting it to work, you can try modifying the shelly_models.json file included with the sc_utility library to add or update your devie. Alternatively, please contact Nick Elsey for support.

Next Step >> Install PowerController