logo elektroda
logo elektroda
X
logo elektroda

Adding Tuya BL-XK01 Star Projector Light to OpenBeken: Configuring, Pin Values & Device Profile

specialistk 5388 12
ADVERTISEMENT
  • #1 20537193
    specialistk
    Level 3  
    Posts: 7
    Rate: 2
    Hello! I've just bought a generic Tuya BL-XK01 star projector light and used Tuya-cordcutter to flash OpenBeken to it successfully.

    I imagine it's close to the Genio projector shown here, but not enough. Using the pin config from that post allows for some RGB control using the 5 PWM sliders and the dimmer, but not predictably. The "LED RGB color" option does not react at all, and "toggle light" only adjusts PWM values.

    The device profile from cloudcutter is here: https://github.com/tuya-cloudcutter/tuya-clou...es/tuya-generic-bl-xk01-music-star-light.json

    What is the process for me to find the correct pin values and have this device added to the HCL? Thanks!

    Edit: using the "Nedis Smartlife LED strip" device profile via the webapp improves some settings. The LED dimmer works and the "toggle light" button turns PWM1 to PWM3 off, while keeping 4 and 5 manual. The LED RGB color picker also works if PWM4 and 5 are kept off. I'm not sure what PWM5 is, but 4 appears to be the white LED.
  • ADVERTISEMENT
  • Helpful post
    #2 20537420
    p.kaczmarek2
    Moderator Smart Home
    Posts: 14411
    Help: 650
    Rate: 12356
    Hello,
    please clear the current config first. Make sure there are no scripts in autoexec.bat and in the short startup command.
    Then try followng settings:
    - red - P9 - (channel 0)
    - green - P24 - (channel 1)
    - blue - P26 - (channel 2)
    - cool - P8 - (channel 3)
    I am not sure about white channel yet. It doesn't seem to be present in the JSON data. Maybe this device is somehow emulating it.

    Can you post some photos of the device, both from outside and the internals? I would like to see if warm white LEDs are there.
    Helpful post? Buy me a coffee.
  • #3 20538689
    specialistk
    Level 3  
    Posts: 7
    Rate: 2
    Here are some pictures of the insides. The black cable is the one that connects to the LED board and has color values marked. Hopefully that helps! I'll update this post with the pin values once I put it back together.

    Adding Tuya BL-XK01 Star Projector Light to OpenBeken: Configuring, Pin Values & Device Profile Adding Tuya BL-XK01 Star Projector Light to OpenBeken: Configuring, Pin Values & Device Profile Adding Tuya BL-XK01 Star Projector Light to OpenBeken: Configuring, Pin Values & Device Profile Adding Tuya BL-XK01 Star Projector Light to OpenBeken: Configuring, Pin Values & Device Profile
  • ADVERTISEMENT
  • #4 20538793
    p.kaczmarek2
    Moderator Smart Home
    Posts: 14411
    Help: 650
    Rate: 12356
    There are indeed two types of diode - RGB and cool white (I guess? YOu'd have to check if they are cool or warm). So 4 PWM channels for LED.

    What else features do this device have?
    Helpful post? Buy me a coffee.
  • #5 20538992
    specialistk
    Level 3  
    Posts: 7
    Rate: 2
    It has a separate mode ("on" vs "WiFi") that I think is powered by a completely separate microcontroller. It also acts as a Bluetooth speaker and maybe music-light synchronization. The Bluetooth must be a separate circuit, as the "Bluetooth on" sound plays on either WiFi or offline mode. There is a remote, but the manual says it does not work in WiFi mode.

    There is an identical model, same model number and manual (almost), that does not have WiFi. I also have one of those that I bought by mistake that I will tear down before returning. It may be the same product without the Tuya board. The manual does not mention the Smart Life app at all.
  • #6 20539002
    p.kaczmarek2
    Moderator Smart Home
    Posts: 14411
    Help: 650
    Rate: 12356
    Is the MCU connected to WB3S via RXD1/TXD1 port of WB3S, like in TuyaMCU product? So it uses UART for control...

    What abilities did Tuya application have for this product? What do we have to support?
    Helpful post? Buy me a coffee.
  • ADVERTISEMENT
  • #7 20540056
    specialistk
    Level 3  
    Posts: 7
    Rate: 2
    I haven't used the multimeter yet, and I never used the Tuya app (bought it to flash immediately) but the manual only shows RGBW lighting effects and dimming. The remote has a timer and color effects like transitions.
  • #8 20544830
    specialistk
    Level 3  
    Posts: 7
    Rate: 2
    p.kaczmarek2 wrote:
    - red - P9 - (channel 0)
    - green - P24 - (channel 1)
    - blue - P26 - (channel 2)
    - cool - P8 - (channel 3)


    With these settings, the toggles in the web GUI work (0 is red on/off, etc.) and they all turn on the laser projector. But "Toggle Light," "LED dimmer," and "LED RGB" do nothing.
  • #9 20545133
    p.kaczmarek2
    Moderator Smart Home
    Posts: 14411
    Help: 650
    Rate: 12356
    It is hard to tell more without direct access to the device.

    One of the things you can try is enabling the "show RAW PWM controllers" flag and then testing each slider (each PWM) and noting down what it does. I have no other way to figure out the GPIO roles of your device since I don't have it physically in front of me.

    You could also open the device case and sketch the GPIO connections, where each port of BK7231 connects, etc.
    Helpful post? Buy me a coffee.
  • #10 20545149
    specialistk
    Level 3  
    Posts: 7
    Rate: 2
    Thanks, I'll try that over the next few days. I have a multimeter and logic analyzer available if those would help.

    If I can't do more by myself, would it be possible to either send you this device or have one sent to you?
  • #11 20545173
    p.kaczmarek2
    Moderator Smart Home
    Posts: 14411
    Help: 650
    Rate: 12356
    Of course, you can sent me one device as a donation, and I will do my best to research it. We've already done that with Jennifer and other users:
    https://www.elektroda.com/rtvforum/topic3892160.html
    We are currently accepting devices as donations and featuring them on our YouTube channel:
    https://www.youtube.com/@elektrodacom
    Most of the devices on that YouTube channel are donated. If you want to see a movie about yours, we can make one. I am making video movies with the help of my assistant, so at least give a like or a sub for her.
    Helpful post? Buy me a coffee.
  • ADVERTISEMENT
  • #13 20545282
    p.kaczmarek2
    Moderator Smart Home
    Posts: 14411
    Help: 650
    Rate: 12356
    Thanks, I've sent you a DM here. Such a nice device would be an interesting addition to our youtube channel.
    Helpful post? Buy me a coffee.

Topic summary

✨ The discussion revolves around integrating the Tuya BL-XK01 star projector light with OpenBeken firmware. The user successfully flashed the device but encountered issues with RGB control and the functionality of various controls. Suggestions were made to clear the current configuration and use specific pin settings for RGB channels. The user provided internal images of the device, revealing RGB and cool white diodes. Further exploration of the device's features, including Bluetooth capabilities and remote control functions, was discussed. The community offered assistance in determining GPIO roles and suggested sending a device for further research and documentation on a YouTube channel.
Generated by the language model.

FAQ

TL;DR: 4 PWM channels identified; "There are indeed two types of diode - RGB and cool white." Start from RGB plus a cool‑white channel and verify behavior in OpenBeken. [Elektroda, p.kaczmarek2, post #20538793]

Why it matters: This FAQ helps OpenBeken users map pins and restore reliable RGBW control on Tuya BL-XK01 star projectors.

Quick facts:

Quick Facts

What OpenBeken pin map works for BL-XK01 RGBW?

Try: Red on P9 (channel 0), Green on P24 (channel 1), Blue on P26 (channel 2), Cool‑white on P8 (channel 3). Clear your config first and remove any autoexec or short‑startup scripts before applying. Then test behavior in the web UI. [Elektroda, p.kaczmarek2, post #20537420]

Why don’t Toggle Light, LED dimmer, or LED RGB work after mapping?

With the suggested mapping, users reported each per‑channel toggle works and also turns on the laser. However, Toggle Light, LED dimmer, and LED RGB did nothing. This indicates roles aren’t yet bound to OpenBeken’s composite light controls. Further channel testing and role assignment are needed. [Elektroda, specialistk, post #20544830]

How do I find the correct pin values myself?

Enable the "show RAW PWM controllers" flag in OpenBeken. Move each slider and note which LED or laser responds, then label channels accordingly. Sketch or document connections and results to build a reliable GPIO map. 3‑step How‑To: 1. Enable RAW PWM view. 2. Test sliders and record effects. 3. Assign roles per findings. [Elektroda, p.kaczmarek2, post #20545133]

Does this projector have warm white, or only cool white?

Photos and inspection indicate two diode types: RGB and a cool‑white LED set. That yields four LED PWM channels. Check the LED tint to confirm if the white is cool or warm on your unit. "There are indeed two types of diode - RGB and cool white." [Elektroda, p.kaczmarek2, post #20538793]

What features work outside Wi‑Fi, and is Bluetooth separate?

The projector has an "on" vs "WiFi" mode likely driven by a separate microcontroller. It also acts as a Bluetooth speaker, and the Bluetooth startup sound plays in both modes. The manual notes the remote does not work in Wi‑Fi mode. [Elektroda, specialistk, post #20538992]

Could it use a secondary MCU over UART like TuyaMCU?

The developer asked whether an MCU connects to the WB3S via RXD1/TXD1. That would imply UART‑based control, as in TuyaMCU devices. Inspect wiring to those pins to confirm. If present, map UART behavior before assigning roles. [Elektroda, p.kaczmarek2, post #20539002]

What did the original manual/app support on this model?

The manual shows RGBW lighting effects and dimming. The included remote supports a timer and color transitions. The app wasn’t tested by the user here, but these are the documented effects. This sets expectations for OpenBeken role coverage. [Elektroda, specialistk, post #20540056]

Will the included remote work when Wi‑Fi control is active?

No. The manual states the remote does not work in Wi‑Fi mode. Expect to control lighting via OpenBeken or the app when Wi‑Fi is enabled. Keep the remote for offline operation. [Elektroda, specialistk, post #20538992]

Can a different device profile help while mapping pins?

Yes. Using the "Nedis Smartlife LED strip" profile improved behavior. The LED dimmer worked, and Toggle Light turned PWM1–3 off while PWM4–5 stayed manual. The color picker worked if PWM4 and 5 were off. PWM4 looked like white; PWM5 was unknown. [Elektroda, specialistk, post #20537193]

Why does toggling any color also switch on the laser?

With the proposed RGBW mapping, users observed that all channel toggles also triggered the laser projector. This suggests the laser shares or follows the LED power control. Isolate its channel during RAW PWM testing to separate behaviors. [Elektroda, specialistk, post #20544830]

How can I get this device added to the OpenBeken HCL?

Share your final GPIO map and clear photos on the forum, or donate a unit for hands‑on research. "Of course, you can send me one device as a donation, and I will do my best to research it." They also feature donated devices on YouTube. [Elektroda, p.kaczmarek2, post #20545173]

What photos should I provide to speed up support?

Post exterior and internal photos, especially the LED board and wiring. The team wants to verify whether warm white LEDs exist and how the LED board connects to the module. Clear images accelerate mapping and validation. [Elektroda, p.kaczmarek2, post #20537420]

Why can’t the team finalize mapping without having the device?

Detailed mapping needs local testing. As the developer said, "It is hard to tell more without direct access to the device." Enable RAW PWM testing, then report repeatable results so roles can be merged confidently. [Elektroda, p.kaczmarek2, post #20545133]
Generated by the language model.
ADVERTISEMENT