Roller shutter Etersky WF-CS01 : CB3S and WB3S pin mapping and scripts

benjaminklamerek 2475 33

Report a violation of the law

Reply | New topic

#31 21769822 03 Dec 2025 09:58

p.kaczmarek2 p.kaczmarek2

Moderator Smart Home

Helpful post? (0)

Post #31
21769822 03 Dec 2025 09:58

added vars:
- $mqtt_client
- $shortName
- $name
They work for publish and publishFile. Self tests:
Code: C / C++
Log in, to see the code

I am creating multiplatform open source firmware (Tasmota replacement), right now supporting BK7231T, BK7231N, XR809, BL602, W800, W600, LN882H and soon supporting RTL and W701:
https://github.com/openshwprojects/OpenBK7231T
If you like my work, support me at: https://paypal.me/openshwprojects

Helpful post? Buy me a coffee.
ADVERTISEMENT

#32 21770619 03 Dec 2025 22:40

Acefx Acefx

Level 9

Post #32

21770619 03 Dec 2025 22:40

All done & Working

For anybody willing to use it here's the FS tar;
Just restore it from the web application menu
/!\ You need firmware version 1.18.223 or above /!\

Total integration with home assistant,
Diagnostic information
Build
IP
RSSI
SSID
Chip Temp
Uptime.

Shutter travel time in sec( need to time it manually and wrote it down )
Backlight of the touchpad
and of course, cover entity with feedback.

Also the 2 files already in the Filesystem
Autoexec.bat

// Autoexec file for Etersky WS01, CB3S , with new ha integration and autodiscovery
//Made by Acefx and Google Gemini  - Thx to  divadiow, benjaminklamerek for the initial source
// and of course p.kaczmarek2 for his wonderfull work, availability, and patience ( with me ) 



// Set up Aliases
alias Set_Stop backlog setChannel 3 0; setChannel 1 0; setChannel 2 0; setButtonColor 3 CornflowerBlue; setButtonColor 2 CornflowerBlue; setButtonColor 1 CornflowerBlue
alias UPmouv_Stop backlog  setChannel 1 0
alias DWmouv_Stop backlog setChannel 3 0
alias Set_Open backlog setChannel 1 1; setButtonColor 1 Coral 
alias Set_Close backlog setChannel 3 1; setButtonColor 3 Coral
alias Set_Finish backlog setChannel 2 1; setButtonColor 2 Coral
alias Start_Opening backlog stopAllScripts; startScript autoexec.bat openSkylight
alias Start_Closing backlog stopAllScripts; startScript autoexec.bat closeSkylight
alias Stop_All backlog stopAllScripts; startScript autoexec.bat stopSkylight
alias Stop_led_up backlog setButtonColor 1 Coral
alias Stop_led_finish backlog setButtonColor 2 Coral
alias Stop_led_dw backlog setButtonColor 3 Coral


// create GUI buttons for HTTP panel
startDriver httpButtons

// Define displayed text on button 4/5
setChannelLabel 4 "Shutter travel time (sec)"
setChannelLabel 5 "Backlight"

setButtonEnabled 1 1
setButtonLabel 1 "Open"
setButtonCommand 1 Start_Opening
setButtonColor 1 CornflowerBlue

setButtonEnabled 3 1
setButtonLabel 3 "Close"
setButtonCommand 3 Start_Closing
setButtonColor 3 CornflowerBlue
setButtonEnabled 2 1
setButtonLabel 2 "Stop"
setButtonCommand 2 Stop_All
setButtonColor 2 CornflowerBlue

// Hide the default GUI buttons
setChannelVisible 1 0
setChannelVisible 2 0
setChannelVisible 3 0

SetChannelPrivate 1 1
SetChannelPrivate 2 1
SetChannelPrivate 3 1

// Loading Event Handlers
addEventHandler OnClick 7 Start_Closing
addEventHandler OnClick 24 Start_Opening
addEventHandler OnClick 10 Stop_All

// --- HomeAssistant discovery  ---

addEventHandler OnDiscovery 0 publishFile homeassistant/cover/$mqtt_client_cover/config d.json 1
scheduleHADiscovery



// ----------Script part for interlock--------------------------------


// Stop Operation on power up
goto stopSkylight


// do not proceed
return

openSkylight:
DWmouv_Stop
delay_ms 100
Set_Open
publish shutterState opening
setChannel 2 0
setButtonColor 2 CornflowerBlue
delay_s $CH4
Set_Stop
Set_Finish
publish shutterState open
delay_s 2
Set_Stop
return

closeSkylight:
UPmouv_Stop
delay_ms 100
Set_Close
publish shutterState closing
setChannel 2 0
setButtonColor 2 CornflowerBlue
delay_s $CH4
Set_Stop
Set_Finish
publish shutterState closed
delay_s 2
Set_Stop
return

stopSkylight:
Set_Stop
Set_Finish
publish shutterState open
delay_s 6
Set_Stop
return

And the d.json ( discovery payload )

{
  "dev": {
    "ids": [
      "$mqtt_client"
    ],
    "name": "$mqtt_client"
  },
  "name": "$name",
  "~": "$mqtt_client",
  "avty_t": "~/connected",
  "uniq_id": "$mqtt_client_cover",
  "qos": 1,
  "unique_id": "$mqtt_client_id",
  "device_class": "shutter",
  "state_topic": "~/shutterState/get",
  "command_topic": "cmnd/$mqtt_client/backlog",
  "payload_open": "Start_Opening",
  "payload_close": "Start_Closing",
  "payload_stop": "Stop_All",
  "state_open": "open",
  "state_closed": "closed"
}

thx again to p.kaczmarek2 for his wonderfull work, availability, and patience ( with me )

Attachments:

LittleFS_WS01-Etersky_12-3-2025_10-31-48 PM.tar Download (10 KB)

ADVERTISEMENT
#33 21770648 03 Dec 2025 23:22

p.kaczmarek2 p.kaczmarek2

Moderator Smart Home

Helpful post? (0)

Post #33
21770648 03 Dec 2025 23:22

Thank you, so it's working now? How it looks in HA?

Would you like to improve it a bit more?

I am creating multiplatform open source firmware (Tasmota replacement), right now supporting BK7231T, BK7231N, XR809, BL602, W800, W600, LN882H and soon supporting RTL and W701:
https://github.com/openshwprojects/OpenBK7231T
If you like my work, support me at: https://paypal.me/openshwprojects

Helpful post? Buy me a coffee.
#34 21770855 04 Dec 2025 17:56

Acefx Acefx

Level 9

Helpful post? (0)

Post #34
21770855 04 Dec 2025 17:56

Totally working and integrated. Thanks to you!
Do you think it's possible to improve it more?

I think one major improvement could be to add a temperature probe on the I/O to get feedback for the domotics

Added after 8 [hours] 19 [minutes]:

Ok i have deeply tested the firmware & adaptation, i have 2 flaws
1. the backlight seems to have a wrongpin adress , ( easy to fix )
2. when you order the "stop" command, the device send "publish Shutterstate open"
Which is problematic because home assistant feels that the shutter is open, and disable the up button.

It could be better if we could publish a " stopped state" nor a shutter position 50% , but i'm not sure it exist...
Of course, a position prediction feature could be gold, but i think a C driver is needed for that...
Create an account, log in here. You will receive points by participating in discussions.
Join this discussion.

Install Elektroda application

Reply | New topic

Report a violation of the law

Topic summary

The discussion revolves around the Etersky WF-CS01 roller shutter device, focusing on the pin mapping and scripting for different versions, specifically CB3S and WB3S. The user shares their experience adapting the device using scripts based on information from various sources, including GitHub documentation. They highlight the variability in pin mapping across different versions of the device, which complicates setup. Responses include acknowledgments of the user's script contributions and suggestions for improving the autoexec.bat script for the WB3S model, emphasizing the need for clear documentation and setup guidance for users.
Summary generated by the language model.

Home page
/
Forum
/
Smart Home
/
Smart Home IoT
/
Roller shutter Etersky WF-CS01 : CB3S and WB3S pin mapping and scripts

FAQ

TL;DR: Etersky WF‑CS01 uses multiple Wi‑Fi boards; “the constructor used many different cards.” Pressing Stop 10 times triggers Safe Mode 3. Use the provided OpenBeken scripts, correct pin maps, and HA discovery to get a safe Cover entity. [Elektroda, benjaminklamerek, post #21006126]

Why it matters: Mixing pin maps or exposing raw relays in Home Assistant can short a shutter motor and destroy it.

CB3S vs WB3S pinouts differ: UP relay is P6 on both, but DOWN is P9 (CB3S) vs P7 (WB3S); LEDs and buttons differ too. [Elektroda, benjaminklamerek, post #21006126]
Default run-time (Channel 4): CB3S script sets 17 s; WB3S sets 40 s; adjust to your shutter. [Elektroda, benjaminklamerek, post #21006126]
Safe Mode: press the Stop button 10× in a row to enter AP SafeMode 3. [Elektroda, benjaminklamerek, post #21006126]
HA MQTT discovery: publish d.json via publishFile; later firmware adds $mqtt_client/$shortName/$name variables. [Elektroda, p.kaczmarek2, post #21769822]
Hide raw relays from HA with SetChannelPrivate 1 before rediscovery. [Elektroda, p.kaczmarek2, post #21768119]

Quick Facts

- CB3S: P6=UP, P9=DOWN; WB3S: P6=UP, P7=DOWN; other pins for LEDs/buttons vary—use matching script. [Elektroda, benjaminklamerek, post #21006126]
- Channel 4 controls travel time; examples: 17 s (CB3S) and 40 s (WB3S). [Elektroda, benjaminklamerek, post #21006126]
- Safety interlock scripted: never energize both relays; Stop 10× enters SafeMode 3. [Elektroda, benjaminklamerek, post #21006126]
- HA discovery stub publishes a Cover with OPEN/CLOSE/STOP and state_topic shutterState/get. [Elektroda, p.kaczmarek2, post #21767428]
- New firmware variables: $mqtt_client, $shortName, $name usable in publish/publishFile. [Elektroda, p.kaczmarek2, post #21769822]

What are CB3S and WB3S in the WF‑CS01?

They are different Wi‑Fi modules found in Etersky WF‑CS01 units across production runs. They expose different pin maps for relays, LEDs, and buttons. Using the wrong mapping causes inverted actions or dead buttons. Pick the matching autoexec.bat script and pin roles for your board. “The constructor used many different cards.” [Elektroda, benjaminklamerek, post #21006126]

How do I map pins for CB3S vs WB3S?

CB3S: P6=Relay UP, P9=Relay DOWN, P24/P10/P7 are Buttons 1/2/3, with LEDs on P14/P8/P23. WB3S: P6=Relay UP, P7=Relay DOWN, P24/P10/P8 are Buttons 1/2/3, with LEDs on P14/P26/P0. Apply setPinRole and setPinChannel exactly as in the posted scripts. [Elektroda, benjaminklamerek, post #21006126]

How do I keep Home Assistant from showing three raw relays instead of one Cover?

Use the HA discovery stub and hide raw channels. Steps: 1) publish d.json (or publishFile) for a Cover entity, 2) map OPEN/CLOSE/STOP to your scripted aliases, 3) SetChannelPrivate 1 on the relay channels before rediscovery. [Elektroda, p.kaczmarek2, post #21768119]

What commands does HA send, and how should I wire them to my script?

Home Assistant sends OPEN, CLOSE, and STOP. Map them to your safe routines, for example: alias open Start_Opening; alias close Start_Closing; alias stop Stop_All. Then publish shutterState updates after each action. “Commands must not change – that’s what HA sends.” [Elektroda, p.kaczmarek2, post #21767517]

How do I publish the Cover discovery to HA?

Publish a JSON config at homeassistant/cover//config and point command_topic to cmnd//backlog with payloads OPEN/CLOSE/STOP. State comes from ~/shutterState/get. Use addEventHandler OnDiscovery and scheduleHADiscovery to send it on boot. [Elektroda, p.kaczmarek2, post #21767428]

Can I avoid hardcoding MQTT names in d.json?

Yes, recent firmware adds variables $mqtt_client, $shortName, and $name. Use them in publish and publishFile for topics and payloads, simplifying multi‑device deployments. Self‑tests confirm variable expansion in topics and payloads. [Elektroda, p.kaczmarek2, post #21769822]

How do I set travel time and stop behavior?

Channel 4 holds run time; set it to your shutter’s measured travel (e.g., 17 s CB3S script, 40 s WB3S script). The scripts stop the active relay, pulse the Stop channel, then clear LEDs. Update shutterState to open/closed after the delay to keep HA in sync. [Elektroda, benjaminklamerek, post #21006126]

What is OpenBeken in this context?

OpenBeken (OpenBK) is the firmware and scripting environment used in the thread to replace Tuya binaries. It provides pin roles, channels, events, MQTT, and HA discovery hooks referenced in the sample autoexec.bat files and docs links. [Elektroda, p.kaczmarek2, post #21007064]

How do I enter AP Safe Mode if I lock myself out?

Use the built‑in counter: press the Stop button 10 times consecutively. The script calls SafeMode 3, enabling recovery without opening the device again. This is useful after a bad network or MQTT setup. [Elektroda, benjaminklamerek, post #21006126]

What’s the safest way to flash these boards?

Many units require desoldering the CB3S/WB3S and using an ESP/Beken burner. It’s a sensitive job; the author broke two devices while learning. If you’re new to SMD work, practice first or use a hot‑air station and shielding. [Elektroda, benjaminklamerek, post #21006126]

Do I really need to prevent both relays from turning on together?

Yes. Driving both directions at once can destroy shutter motors. One user showed HA exposing raw relays, which is unsafe. Always use scripted interlocks and hide raw channels to avoid simultaneous energizing. “Destruction!” was their warning. [Elektroda, Acefx, post #21762120]

My module freezes after opening the Flags page—what’s happening?

A user observed the Flags UI sometimes freezing the module for about 20–30 minutes before it recovers. Avoid that page during commissioning, and update firmware when fixes land. This is a diagnostic note, not normal behavior. [Elektroda, Acefx, post #21768614]

Is there a better long‑term solution than scripting?

A dedicated C driver would integrate cover logic and HA discovery cleanly. For now, the discovery stub plus scripts work and are testable. The maintainer notes a driver would give “best results.” [Elektroda, p.kaczmarek2, post #21767428]

Where can I get improved scripts for WB3S backlight and logic?

See the enhanced autoexec.bat posted later in the thread. It adds backlight toggling, clean aliases, and channel handling for HA. Adapt channel numbers to your wiring before deployment. [Elektroda, dennis3, post #21285677]

How do I quickly test HA discovery before wiring?

Use httpButtons in OpenBK to publish shutterState open/closed and verify HA updates. Then map the HA OPEN/CLOSE/STOP to your Start_Opening/Start_Closing/Stop_All aliases and retest. This isolates MQTT setup issues. [Elektroda, p.kaczmarek2, post #21767428]

Quick 3‑step: how do I flash and script a WF‑CS01 safely?

Desolder the CB3S/WB3S, connect to a compatible burner, and flash OpenBK. 2. Paste the matching autoexec.bat with correct pin roles and Channel 4 timing. 3. Power up, verify buttons/LEDs, then enable HA discovery and hide raw relays. [Elektroda, benjaminklamerek, post #21006126]