# BLE WB3S nebula galaxy projector

The goal of this project is to create a firmware and possibly an app to control a cheap "YESLUSY LED Star Light" over BLE. This device ships with the WB3S chip (BK7231T) and unfortunately the tuya firmware.

# Why?

Because we can ^^

I don't like the idea to connect to a cloud just to switch the lights of the galaxy. And I also don't like to use ESPHome or something similar for something which I want to control just locally.

# Alternative

There is a ESPHome version for these chips, if you want something which connects to your smart home this is a way better alternative.

# Project status

Currently, nothing to see :D

# Contributions

Are welcome, just create a PR :)

# How to build

Download and patch the beken SDK

```bash
make sdk_install
```

Build the BLE example:

```bash
make
```

# Flashing

I followed the original authors and used the outdated "hid_download_py".

The version I used is this one:

https://github.com/OpenBekenIOT/hid_download_py/tree/master

I sodered the TX and RX testpads and used the already evaluated GND and VCC (3,3) and connected it to a cheap TTL to USB adapter. You don't need to connect RST. It is possible to just disconnect VCC for a short period of time if the flashing tool waits for

```bash
Getting Bus...
```

First of all let's dump the current firmware

```bash
uartprogram -d /dev/ttyUSB0 -r ./dump-fw.bin
```

Afterwards we are able to flash our own firmware with

```bash
uartprogram -d /dev/ttyUSB0 -w ./build/images/ble_tst/0.0.2/ble_tst_UA_0.0.2.bin
```

## TODO:

Try to use ltchiptool.

# Acknowledging

The BLE reverse engineering and the initial stack are taken from this blog post. 

https//www.elektroda.com/rtvforum/topic3989434.html\#20742145

The doc/notes.pdf is from the original authors with the following note:

```
Finally, while all the code by the author(s) is licensed under GPLv3, other code used in building the final project
may be licensed under different terms and it is the responsibility of the reader to ensure compliance with
the terms of each license before proceeding."
```