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 takes 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 take (via IFTTT) 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 blue LED on the board is on. Note: some devices have a dim constantly flashing blue LED or a red LED - this shows the board is powered and can be ignored. The bright blue LED signifies the board is in ‘setup mode’. If this is your first time powering your Wevolor and the bright blue 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 and for accessing the myWevolor website.

  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 blue 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 Wevolors.

    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 blue 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 blue 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 navigating to https://wevolor.com/myWevolor and entering the unique ID of your Wevolor. See 'Other Useful Features' below for details.

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:

To access your Wevolor during normal operation, go to https://wevolor.com/myWevolor and enter the 16 character unique ID of your Wevolor. Once the correct Unique ID is entered, status of your Wevolor will be shown (this is accessible anywhere). If you are on the same WiFi as your Wevolor, a second panel has links to your Wevolor on your local WiFi:

  1. Wevolor Setup - a link to the configuration page for changing settings or resetting your Wevolor.

  2. Wevolor Command Interface - additional information about the state of your Wevolor and a way to send commands directly to it. 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 'myWevolor' status.

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 https://wevolor.com/myWevolor (if not previously entered, you'll need to enter the 16 character unique ID). On the lower panel, click one of the links. If setup is not shown, or the command interface panels remain grayed-out, make sure you are on the same local network as your Wevolor.

If you are on the same network, but your Wevolor is not being found, check whether the bright blue LED is solid-on (remove the lid of the box if it's in a box). 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 Command Interface 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 your Wevolor stays safely on your local WiFi network with no special ports needing 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 recording status, and developing/improving the Wevolor code. That information is limited to the last boot time of the Wevolor (to understand how stable it is). No confidential information (such as WiFi credentials) are ever sent or visible in any way to the developer. An encoded version of your Wevolor's local IP address is send (so the wevolor.com/myWevolor page knows where to find your Wevolor) but that is only readable by the Wevolor code and is secure. 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.