Configuring the Wevolor device

Wevolor version: 5.2

The ‘Wevolor’ (referred to hereafter as ‘Wevolor’, or ‘device’) is software running on an ESP32 development board. It actions commands from 'If This Then That' (hereafter IFTTT). IFTTT can be triggered by many events including home automation such as Amazon Echo (hereafter 'Alexa') and Google Home. The Wevolor relays the actions to the Levolor Premium 6-Channel Remote Control (referred to hereafter as ‘remote’). If configured correctly the Wevolor can action commands from IFTTT. In turn IFTTT can take commands from Google Home or Alexa such as “Alexa, trigger close the blinds”, or timed commands like closing the blinds at sunset and opening them at 6am. Those commands are then relayed to the remote to execute the action.

Before you start:

  1. You should have an IFTTT Account and optionally a home automation hub such as Amazon Echo.

  2. You should have a Levolor 6-channel remote which is paired with one or more blinds so you can successfully open and close the blind(s) using the remote. Make sure the remote has good batteries and is physically close (within 10 feet) of your Wevolor.

Note: The Wevolor requires IFTTT, and the Levolor Premium 6-channel remote. Amazon Echo / Google Home etc. are optional. See IFTTT for home automation and other triggers supported.

Steps to configuring:

  1. Power the device on by connecting a USB power supply to the device micro-USB connector.

  2. Check the bright LED (blue or red) on the board is on. Note: some devices have a dim constantly flashing LED too - this one can be ignored. The bright LED being lit signifies the board is in ‘setup mode’. If this is your first time powering your Wevolor and the bright LED is not solidly lit, you may need to reset the device using the reset button on the device itself, or by removing and reconnecting power.

  3. A WiFi network ('access point') is 'served' by the Wevolor device to allow setup. On a phone or computer, connect to the 'Wevolor' WiFi network. Password is 'setupmode'. Note: It may takes a minute or so for the WiFi network to show up in the available networks list on your phone or computer, if it’s not there, wait a minute.

  4. Once connected to the Wevolor WiFi. Type '192.168.4.1' into the browser.

  5. A 'Configure your Wevolor' page should be presented.

    IMPORTANT The unique 16-character identifier for your Wevolor should be noted. It is needed when setting up IFTTT.

  6. Configure the following sections:

    1. WiFi - enter the SSID (name) and Password of your home WiFi. Both have a maximum length of 31 characters. The password is shown as you type it, but you are the only one who can see it. It's important you get the SSID and password correct, so double check.

    2. Levolor Remote

      1. Name - If you have only one remote you can leave this blank. If you have more than one you can specify which you want the Wevolor to connect to. The name should match exactly the name the remote was given in the Levolor phone App.

      2. Group - Set what blind group or groups you want to open and close. These are the same as the 6 numbered buttons on the remote. Default is Group 1.

      3. Note: The remote-key required in version 5.1.x is no longer required.

  7. 'Submit' the form with the green button. A red 'RESTART' button will appear. If you are happy with your settings, hit the RESTART button to apply your configuration.

  8. Close the browser window or tab, as configuration is now complete. The bright LED should now be off, and there should no longer be a 'Wevolor' WiFi network available.

Steps to connect IFTTT:

  1. Go to the IFTTT web site or Download the IFTTT app on your phone. If you don't already have an account, sign up for free.

  2. IFTTT has 'triggers' (this) and 'actions' (that). Using Alexa as the example, a voice command "Alexa open the blinds" is our trigger and the Wevolor activating the remote is the action.

  3. On the IFTTT web site, click the 'Create' menu item taking you to a 'Create Your Own' page. Click on 'This' and select the Amazon Alexa service or your preferred service such as Google Assistant etc. Follow the steps to configure IFTTT to access your account, and set your specific trigger. For example, with Alexa the trigger can be "Say a specific phrase".

  4. Next click on 'That'. Wevolor uses the 'Webhooks' action service. Click on it and select 'Make a web request'. This is where the unique 16-character identifier you noted earlier comes in. Let's assume it was '00112233AABBCCDD'. The URL field should be set to 'https://hghst.net:9443/set/00112233AABBCCDD/open' to open the blinds. 'https://hghst.net:9443/set/00112233AABBCCDD/close' would be the URL to close the blinds. Make sure you use your Wevolor's unique 16-character identifier and the correct action. Also note that alpha characters in the identifier are always upper case, and the actions lower case.

    Wevolor supports 'open', 'close', 'tiltopen', 'tiltclose' and 'favorite' actions. While 'stop' is also implemented, it will be of limited use given the delays in issuing and acting on commands.

    To override the default group(s) that commands are sent to. Simply add '/123' to the command to execute on groups 1,2 and 3. Adding '/123456' would execute the command on all six groups.

    Mutliple wevolors can be 'set' with a single command if required. Add additional 16-character identifiers to 'set' commands separated by a '+'.
    For example 'https://hghst.net:9443/set/00112233AABBCCDD+22446688AACCDDFF/open' would send the open command to two Wevolor's.

    As well as the actions listed above, one additional is 'toggle'. Sending toggle will open your blinds if previously closed and vice versa. Note: If toggle is used before an 'open' or 'close' command is set, it will initially open your blinds. Toggle allows a single IFTTT action to be set up which both opens and closes your blinds (handy since IFTTT recently changed to only allowing three applets to be configured without paying for a Pro account).

    No other fields need to be changed.

  5. Repeat for the other actions you wish Alexa to perform (close, tiltopen, etc.).

  6. Save. IFTTT should show you your new 'Applet' for example 'If you say "Alexa trigger open the blinds", then make a web request'. Note the 'trigger' word in there. If you prefer not to have that you can set a routine in the Alexa app to recognize "Alexa, open the blinds" without the 'trigger' word.

  7. Go ahead and say to Alexa "Alexa, trigger open the blinds" and your blinds should activate.

That's it! Leave the Wevolor plugged in and physically close (10 feet or so) to the remote, and it should work well.

If there is an issue, see ‘Troubleshooting’ below.

If the bright LED is solid-on at any time the device has not been able to connect to the WiFi and has gone back to setup mode. It will cycle between retrying the WiFi and setup. If the bright LED is on you can repeat the ‘Steps to configuring’ above, to make changes to the WiFi or other settings.

If the device is connected to the WiFi and operational you can make changes by using your Safari browser on Mac to connect to http://Wevolor.local. If using other browsers or on a PC/Android device etc, see 'Other Useful features' for how to access the configuration page.

Note: If the Wevolor device becomes disconnected from WiFi - for example your WiFi network goes down - the device might need manually restarting with the ‘reset’ button or by disconnecting and reconnecting power.

Other Useful Features:

As stated above, the ‘http://Wevolor.local’ web-page will display setup information and allow you to change the Remote or WiFi settings.

If Wevolor.local does not work on your PC/phone browser you can access the configuration page by going to http://hghst.net/myWevolor and entering the 16 character unique ID of your Wevolor. If you are on the same WiFi as your Wevolor, three panels display which can be expanded if needed, by clicking the title.

  1. Wevolor Setup - a link to the configuration page on your local WiFi network.

  2. Wevolor Status - the latest information about the state of your Wevolor. Some status is available for viewing even when away from your home WiFi. The remainder only displays if locally connected.

  3. Wevolor Commands - send commands directly to your Wevolor. This is good when you want quick response time - like when issuing a 'STOP' command - however commands sent this way will not be shown in the status section.

Troubleshooting:

If you believe the device is properly configured, yet is not performing as expected, try resetting the device with the ‘reset’ button.

If you still believe the device is not performing properly, please take a look at the 'Wevolor Status' panel at http://hghst.net/myWevolor . If the myWevolor page does not show the Wevolor Setup and Command panel, it may not be on the same WiFi network. Check whether the bright LED is solid-on on your Wevolor. If it is then the device has reentered setup mode. Retry the ‘Steps to configuring’ being especially careful about the spelling and capitalization of the WiFi settings.

If the myWevolor page connects to the local Wevolor, the Status Panel display the 'BLE State'. The ‘BLE State’ should be one of the following:

Any other problems, please contact me via e-mail at wevolor@hghst.net. Please send as much background information as you can, and a description of the error. Suggestions for features and changes are also welcomed.

Special Note:

The https://hghst.net:9443 website mentioned above sits between IFTTT and your Wevolor. Your Wevolor polls that site to see if new commands are available to execute. The advantage of this method is that your Wevolor stays on your local WiFi network and no special ports need to be opened which otherwise might be a security risk. If for whatever reason the hghst.net site is down, your Wevolor will not operate correctly. While every effort will be made to keep the website operational, occasional outages can't be ruled out. Also, your Wevolor sends information to the website for purposes of developing and improving the Wevolor code. That information is limited to the last boot time of your Wevolor (to understand how stable it is), and the remote key (to optimize the method of probing remotes). No confidential information (such as WiFi credentials) are ever sent or visible in any way to the developer. If you are interested to view the information sent, go to https://hghst.net:9443/status/your-unique-16-character-Wevolor-id. If you want to know what the time numbers mean http://hghst.net can help with that.

There's no membership or cost to running your Wevolor but if you feel inclined to help me pay for the website hosting etc. you can Buy me a coffeeBuy me a coffee

Thanks, Roger.

(©) Copyright 2020, Roger Hoggarth.