Elektroda.com
Elektroda.com
X

Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

mitmit17 1662 7
  • I recently purchased a couple of Treatlife DS03 Smart Dimmer / Fan controller.
    Naturally, I had no desires to use the Tuya cloud services and wanted to connect it directly to my Home Assistant setup.

    There were many guides that one could find, but none of them was complete (using phrases like "do it in the usual way"). As someone new to both HA and OpenBeken world, I've had some trouble getting a definitive answer on how to get the process across. To make matters worse, I only have a Mac machine so all the windows flashing guides weren't very usable for me
    After some trial and error and time spent on research, I've decided to put down the following guide for prosperity. Hope someone finds in useful in the future.

    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    1. Disassemble the board
    Open the four screws connecting the face plate and carefully pry open the panel (which contains the WB3S board)
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    2. (Optional) Remove board with WB3S board from buttons
    Remove 3 small screws and disconnect main board from panel (marked above in red)
    You should end up with the following board (both sides shown below)
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac) Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    3.Soldering wiring and pins
    In order to flash OpenBeken on this chip we're going to need to use the UART interface of the WB3S board. However this interface is already used by the Tuya software to communicate with the Tuya MCU (Novton board on opposite side) that's actually controlling the leds and GPIOs.
    So we need to expose the UART wires and reset the MCU so that we can chat without interruption

    Solder pins / wires on the 3.3V, GND, nRESET, TX & RX lines, marked below
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)
    Solder the pins
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac) Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)
    Solder the wires
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    If you're not experienced in soldering, verify all the connectivity with a multimeter.

    4. Connect to USB-to-TTL board
    I'm using this board and use the following connections. Notice that RX on the board is TX on the USB-to-TTL and vice versa.




    DS03 MainboardUSB-to-TTL
    3.3vvcc
    GNDGND & NRESET
    TXDRXD
    RXDTXD



    Note, in order to connect the USB-to-TTL GND to both GND and NRESET, I used a small breakout board as seen below
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)
    And connect the USB-to-TTL to your computer (my MBP in my case)

    5. Install python and install the bk7231tools package so we can flash the firmware
    We're going to install the bk7231tools package to support flashing
    Code: bash
    Log in, to see the code


    6. Check connectivity and see if we're able to communicate with the board
    Code: bash
    Log in, to see the code


    7. What happens if the above fails (usually timeout)
    In some of the boards the above worked without issue, while in another board I could not get the above to work at all. The problem seems to have been that the Tuya app was trying to talk over the UART with the MCU (which is held at reset) and would only give a small time window at boot time to talk with the bootloader.
    The solution comes from reseting the board while the python script was already running (the bk7231tools script is internally flooding the serial).
    Reseting is done by shorting the CEN pin on the WB3S board to GND. However the USB-to-TTL board I've had didn't appreciate the" "short" here and reseted themselves (disconnecting the USB).
    The below describes what one can do if that happens:

    7.1 Use a separate 5V power source and connect it to the 5v connectors as marked below. Disconnect the 3.3V source from your USB-to-TTL converter. In my case I used another USB-to-TTL with the jumper set to 5V. Do not use TX/RX on this device as it may damage the WB3S.
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    7.2 Run the bk7231tools command as above and while it waits, tap connect the GND to the CEN pin as marked below (to reset the WB3S) board. See below on locations. I connected another connection to the breakout board connected to GND and used the other side of the wire to momentarily tap the wire on the CEN pin, quickly reseting the board.
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    7.3 The python script should work now as expected
    Code: bash
    Log in, to see the code


    8. (Optional) Create a backup of your existing firmware
    Code: bash
    Log in, to see the code


    9. Write new firmware on the device
    Download the relevant OpenBeken image from OpenBK7231T github page. Use the UA version (UART firmware). At the time of this writing the the file I used was OpenBK7231T_UA_1.17.147.bin

    Use the following commands to write (notice we're using the offset of 0x11000 which is after the bootloader)
    Code: bash
    Log in, to see the code


    Success! Our WB3S is now using OpenBeken!

    10. Disconnect all but the 5V power and 5V GND
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    [b]11. Configure the OpenBeken software to connect to your wifi

    Connect your computer to the OpenBeken SSID and browse to 192.168.4.1
    Configure the wifi details
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac) Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)
    Restart the WB3S and connect to it's IP address (use your router's interface to find it)

    12. Configure names and MQTT parameters
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)
    And it should connect to MQTT in your setup
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)

    13. Write an autoexec.bat file
    Click Launch Web Application and click on Filesystem
    Create a file called autoexec.bat and set it's content to
    Code: text
    Log in, to see the code


    Reboot
    The firmware should now look like this
    Treatlife DS03 Smart Dimmer / Fan controller - Absolute beginners guide to flashing (On a Mac)


    14. Connect to Home Assistant.
    You can either create an MQTT discovery through OpenBeken (Config->Home Assistant Configuartion) or use the following in HA
    Code: text
    Log in, to see the code


    15. Unsolder the wires and pins from the board
    And put everything back together

    Congrats.[/b]

    Cool? Ranking DIY
    About Author
    mitmit17
    Level 2  
    Offline 
    mitmit17 wrote 3 posts with rating 3, helped 1 times. Been with us since 2023 year.
  • #2
    p.kaczmarek2
    Moderator Smart Home
    Very good and detailed guide. Here are few more tips from me:
    - you can use SSDP driver to get your device discoverable by Windows (startDriver SSDP in autoexec.bat)
    - you can use power save to lessen the energy consumption without losing any features: PowerSave 1 (in autoexec.bat)
    - you can also use our Windows GUI flasher for programming BK7231 https://github.com/openshwprojects/OpenBK7231T_App
  • #3
    mitmit17
    Level 2  
    Awesome. Thanks!
  • #4
    mitmit17
    Level 2  
    I found that the OpenBeken heuristics for Home Assistant discovery isn't great for this device. It creates the fan switch as a light switch, ignores the fan speed setting. I wasn't happy with it.
    The following shell script publishes an MQTT discovery message that fits the DS03 device, and creates a device through MQTT (and not just the entities).

    In my particular setup, I use mosquitto as my mqtt broker running in a dockerized environment. Uses yq to format the embedded YAML as JSON for publishing for

    Code: bash
    Log in, to see the code
  • #5
    p.kaczmarek2
    Moderator Smart Home
    Very good job. I am planning to customization option for OBK hass automatic discovery, maybe that could also help in the future. It will be most likely possible through our Web App.
  • #6
    xSPARExSTEWx
    Level 2  
    Just as an FYI for any one else looking into these. I bought both a single and the 2 pack off of amazon. The single pack had the BK7231T chip, but the 2 pack had the BK7231N chip. Not sure how different they are, but when flashing make sure to use the correct one.

    Also all the ones I got were a bit different that the face plate board and the others were all soldered together. You will now need to take it completely out with the ground screw on the pack and another under the sticker by the other wires. Then you need to bend the transistor under the metal back plate so the boards can come out.