Skip to content

Home

Jump to bottom
Elahd Bar-Shai edited this page Jul 10, 2021 · 20 revisions

Installing on Wyze Plug and Wyze Bulb

Requirements

  1. Wyze Plug (model WLPP1) or Wyze Bulb (model WLPA19). These are both the old, pre-2021 version of each device.
  2. Third party firmware. Either hosted online or downloaded onto your computer. I've only tested Tasmota 9.2's full build. esp2ino should work with ESPurna, esphome, and any other firmware package built using the ESP8266 Arduino framework.
  3. A computer that supports Python. esp2ino is confirmed to work in Windows, MacOS, and Linux (Ubuntu).

If you're brave enough to test a different device or a different third party firmware, please open a GitHub issue or submit a pull request with a change to this document.

Instructions

Setup your Wyze device using the Wyze app

Set up your Wyze Plug or Bulb using the official Wyze app. If you're setting up the device for the first time, don't update firmware when prompted.

Load esp2ino onto your Wyze device

  1. Download the WyzeUpdater package for your operating system from esp2ino's releases page. If you're running Linux or don't see a package for your operating system, see Running WyzeUpdater From Source.

    You can ignore your operating system's warning about these files being untrusted. If you're the paranoid type, you can always run WyzeUpdater from source.

  2. From the command prompt, use WyzeUpdater to get a list of your Wyze devices:

    • MacOS: ./wyze_updater_macos list
    • Windows: ./wyze_updater_win.exe list
    • Linux: python3 wyze_updater.py list

    When prompted, enter your username, password, and OTP to log in.

  3. Find the Wyze device you want to flash and copy its Device MAC.

  4. Use WyzeUpdater to load esp2ino on to the device, replacing DEVICEMAC with the MAC address obtained in the prior step:

    • MacOS:

      sudo ./wyze_updater_macos update -x remote -d DEVICEMAC -f https://ota.elahd.com/esp2ino.bin

    • Windows:

      Use a command prompt with administrator privileges.

      ./wyze_updater_win.exe update -x remote -d DEVICEMAC -f https://ota.elahd.com/esp2ino.bin

    • Linux:

      sudo python3 wyze_updater.py update -x remote -d DEVICEMAC -f https://ota.elahd.com/esp2ino.bin

  5. Wait a few minutes for esp2ino to load onto your Wyze device. You'll know that esp2ino is ready when you see the 'esp2ino' Wi-Fi network.

    esp2ino Wi-Fi network in MacOS

Use esp2ino to flash custom firmware

  1. Connect to to the esp2ino Wi-Fi network, then access esp2ino by going to http://esp2ino.local in a web browser.

    esp2ino in a Web Browser

    If you're having trouble accessing esp2ino, see Troubleshooting Wi-Fi.

  2. Connect esp2ino to your home Wi-Fi network using the "Connect to Wi-Fi" button in the yellow bar at the top of the page.

    This step is only necessary if you want esp2ino to download firmware over the internet. You can skip this step if you're uploading firmware from your computer.

  3. Use esp2ino's Download Backup button to download a backup of your factory firmware. Currently, there is no practical way to revert to factory firmware OTA, but keeping a backup is still a good idea.

  4. Use the Select Replacement Firmware dropdown to tell esp2ino which third party firmware you want to load.

    • Select Tasmota to have esp2ino download and install the latest version of Tasmota from ota.tasmota.com.

    • Select Custom URL and enter a firmware URL for esp2ino to download and install that firmware to your device.

    • Select Upload File and select a file from your computer to upload and flash to your device.

      Uploading firmware is really slow, running at around 3.3kbps. Expect the upload to run for 5-10 minutes.

    See Requirements for Third Party Firmware for notes on providing your own firmware.

    Installing ESPHome? Read this first!

  5. Click Install to push the new firmware onto the device. esp2ino will show progress as it works:
    esp2ino in Progress esp2ino Success

  6. Wait for your device to boot into its new firmware. Do not disconnect your computer from the esp2ino Wi-Fi network. (It'll disconnect on its own.) Your device will be unresponsive for a few minutes after its first boot while esp2ino rearranges files and deletes itself. If you're impatient, grab a coffee... walk the dog... take a shower... just DON'T. MESS. WITH. THE. DEVICE. Your device will be bricked if this step fails.

    Again, it's critical that the device be allowed to sit undisturbed after flashing. No button pushing, unplugging, reloading esp2ino's web page, etc.

  7. With some firmware (like Tasmota), you'll know that your device is ready for use when you can access the Tasmota Wi-Fi network. With other firmware, you'll know the device is ready when it connects to your router. If you don't see any signs of life after 15 minutes,try power cycling the device.

Tasmota Device Templates

Wyze Plug

{"NAME":"WyzePlugWLPP1","GPIO":[0,0,0,0,0,56,0,0,21,0,17,0,0],"FLAG":0,"BASE":18}

(via Tasmota Device Templates Repository)

Wyze Bulb

{"NAME":"Wyze Bulb","GPIO":[5728,0,0,0,0,0,0,0,0,416,417,0,0,0],"FLAG":0,"BASE":48}

(via Tasmota Device Templates Repository)

Clone this wiki locally