Skip to content
Neviweb Custom Component for Home Assistant to manage devices connected via GT125
Python
Branch: master
Clone or download
Pull request Compare This branch is 338 commits ahead of dj21d:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
custom_components update version number Nov 16, 2019
www Delete test Feb 9, 2019
.gitignore typo fix Feb 23, 2019
LICENSE Initial commit Nov 5, 2017
README.md Update README.md Nov 30, 2019
custom_components.json added const.py Nov 30, 2019
customize.yaml Adjust to work with new component Feb 9, 2019
hacs.json update hacs.json Dec 1, 2019
icon_view2.png Icon customization with custom UI Feb 9, 2019

README.md

Update:

To support HACS, this repository has been broken up into two.

  • sinope-gt125 for devices management via direct conection to the gt125 web gateway
  • sinope-1 for devices management via Neviweb portal.

Home Assistant Neviweb Custom Components

Here is a custom components to suport Neviweb in Home Assistant. Neviweb is a platform created by Sinopé Technologies to interact with their smart devices like thermostats, light switches/dimmers and load controllers. It also supports some devices made by Ouellet.

Supported Devices

Here is a list of currently supported devices. Basically, it's everything that can be added in Neviweb.

  • Thermostats
    • Sinopé TH1120RF-3000 Line voltage thermostat
    • Sinopé TH1120RF-4000 Line voltage thermostat
    • Sinopé TH1121RF-3000 Thermostat for public areas
    • Sinopé TH1121RF-4000 Thermostat for public areas
    • Sinopé TH1300RF Floor heating thermostat
    • Sinopé TH1400RF Low voltage thermostat
    • Sinopé TH1500RF Double-pole thermostat
    • *Ouellet OTH2750-GT Line voltage thermostat
    • *Ouellet OTH3600-GA-GT Floor heating thermostat
  • Lighting
    • Sinopé SW2500RF Light switch
    • Sinopé DM2500RF Dimmer
  • Specialized Control
    • Sinopé RM3200RF Load controller 40A
    • Sinopé RM3250RF Load controller 50A

*Not tested, but should be working well. Your feedback is appreciated if a device doesn't work.

Prerequisite

You need to connect your devices to a GT125 web gateway and add them in your Neviweb portal before being able to interact with them within Home Assistant. Please refer to the instructions manual of your device or visit Neviweb support.

There are two custom component giving you the choice to manage your devices via the neviweb portal or directly via your GT125 gateway:

  • Neviweb custom component to manage your devices via neviweb portal
  • Sinope custom component to manage your devices directly via your GT125 web gateway

You need to install only one of them but both can be used at the same time on HA.

Neviweb custom component to manage your device via Neviweb portal:

Installation

There are two methods to install this custom component:

  • via HACS component:
    • This repository is compatible with the Home Assistant Community Store (HACS).
    • After installing HACS, install 'sinope-1' from the store, and use the configuration.yaml example below.
  • Manually via direct download:
    • Download the zip file of this repository using the top right, green download button.

    • Extract the zip file on your computer, then copy the entire custom_components folder inside your Home Assistant config directory (where you can find your configuration.yaml file).

    • Your config directory should look like this:

      config/
        configuration.yaml
        custom_components/
          neviweb/
            __init__.py
            light.py
            switch.py
            climate.py
        ...
      

Configuration

To enable Neviweb management in your installation, add the following to your configuration.yaml file, then restart Home Assistant.

# Example configuration.yaml entry
neviweb:
  username: '<your Neviweb username>'
  password: '<your Neviweb password>'

Configuration options:

key required default description
username yes Your email address used to log in Neviweb.
password yes Your Neviweb password.
network no 1st network found The name of the network you want to control.
scan_interval no 540 The number of seconds between access to Neviweb to update device state. Sinopé asked for a minimum of 5 minutes between polling now so you can reduce scan_interval to 300. Don't go over 600, the session will expire.

Troubleshooting

If you get a stack trace related to a Neviweb component in your home-assistant.log file, you can file an issue in this repository.

You can also post in one of those threads to get help:

Turning on Neviweb debug messages in home-assistant.log file

To have a maximum of information to help you, please provide a snippet of your home-assistant.log file. I've added some debug log messages that could help diagnose the problem.

Add thoses lines to your configuration.yaml file

logger:
  default: warning
  logs:
    custom_components.neviweb: debug

This will set default log level to warning for all your components, except for Neviweb which will display more detailed messages.

Customization

Install Custom UI and add the following in your code:

Icons for heat level: create folder www in the root folder .homeassistant/www copy the six icons there. You can find them under local/www feel free to improve my icons and let me know. (See icon_view2.png)

For each thermostat add this code in customize.yaml

climate.neviweb_climate_thermostat_name:
  templates:
    entity_picture: >
      if (attributes.heat_level < 1) return '/local/heat-0.png';
      if (attributes.heat_level < 21) return '/local/heat-1.png';
      if (attributes.heat_level < 41) return '/local/heat-2.png';
      if (attributes.heat_level < 61) return '/local/heat-3.png';
      if (attributes.heat_level < 81) return '/local/heat-4.png';
      return '/local/heat-5.png';

In configuration.yaml add this

customize: !include customize.yaml

Current Limitations

  • Home Assistant doesn't support operation mode selection for light and switch entities. So you won't see any dropdown list in the UI where you can switch between Auto and Manual mode. You can only see the current mode in the attributes. TODO: register a new service to change operation_mode and another one to set away mode.

  • If you're looking for the away mode in the Lovelace 'thermostat' card, you need to click on the three dots button on the top right corner of the card. That will pop a window were you'll find the away mode switch at the bottom.

TO DO

  • Document each available services for every platforms + available attributes.
  • Explore how to automatically setup sensors in HA that will report the states of a specific device attribute (i.e. the wattage of a switch device)

Contributing

You see something wrong or something that could be improved? Don't hesitate to fork me and send me pull requests.

You can’t perform that action at this time.