Mirabella Genio Bulbs¶
The Mirabella Genio is a Tuya-based smart bulb sold by Kmart in Australia.
Originally intended to be used with their companion app once flashed using tuya-convert ESPHome generated firmware can be uploaded allowing you to control the bulbs via Home Assistant.
Please note that the new version of this bulb that comes in a cardboard box are using the TYLC5 module which does not work via tuya-convert. These bulbs are also using the SM2135 chipset and not PWM anymore.
1. Create the ESPHome Firmware¶
Select a bulb configuration below based on the bulb/s you have and copy all of the text in the code block and paste into your
Compile the firmware, again depending on your chosen setup refer to the guides in the first point.
Before you begin you’ll need one of the following Linux machines running the latest copy of Raspbian Stretch Lite
Raspberry Pi 2B/B+ with USB WiFi Dongle.
Raspberry Pi 3B/B+.
As per the tuya-convert documentation:
Any Linux with a Wifi adapter which can act as an Access Point should also work. Please note that we have tested the Raspberry Pi with clean installations only. If you use your Raspberry Pi for anything else, we recommend using another SD card with a clean installation.
A microSD card (minimum 2GB, 8GB+ recommended).
Any WiFi device which can connect to the SSID generated by the Raspberry Pi and eventually the flashed Tuya device. This cannot be an iOS / Apple device. Android devices will work.
2.2 Installing the OS¶
It’s recommended to read the documentation provided by the Raspberry Pi Foundation on the best way to flash the OS to the microSD card depending on your platform - Installing operating system images.
After you’ve flashed the microSD card browse to the “boot” partition and add a blank file called “ssh” (without any extension) which will enable the SSH server upon first boot, extended information on this step can be found here.
Plug the microSD card into the Raspberry Pi, connect network cable and power, the Raspberry Pi will start to boot.
2.3 Connecting to the Pi via SSH¶
Download and install Putty.
Enter the IP of Raspberry Pi in the box that says “Host Name”, leaving the port set to 22 (default for SSH). A list of recommended ways can be found here, but the easiest is to download and use Fing (Android / iOS).
In the “Saved Sessions” input box, name the Raspberry Pi connection and then press “Save”.
Select your new saved session from the list.
2.4 Configuring the Pi¶
In the putty window login with the pi as the user and raspberry for the password.
sudo apt-get update && sudo apt-get dist-upgrade -yand wait for the upgrades to install.
sudo apt-get install gitand wait for it to install.
2.5 Setup and Install tuya-convert¶
In the putty window type
git clone https://github.com/ct-Open-Source/tuya-convertpress enter and wait while the repository is cloned.
cd tuya-convertand press enter.
./install_prereq.shpress enter and wait as the script gathers all the required components needed to function.
2.6 Upload ESPHome Firmware using SFTP¶
Depending on the program you need to connect to the Pi using the IP address as the hostname and the username and password the same as you used to connect via SSH and ensure your connection type is set to SFTP
Upload your compiled
firmware.binfile to this directory. For command line based installs you can access the file under
<CONFIG_DIR>/<NODE_NAME>/.pioenvs/<NODE_NAME>/firmware.binalternatively Home Assistant add-on users can download the file directly from the web ui.
2.7 Use tuya-convert to install ESPHome Firmware¶
yesto accept the warning.
Connect your alternative WiFi device (non iOS / Apple based) to the
flashmeifyoucanas the password. This is the network being broadcast by the Pi from the tuya flash script.
If you haven’t already install your bulb and flip the switch. It should automatically enter pairing mode represented by the bulb flashing on and off. If it doesn’t, switch your bulb, on-off-on-off-on as per the instructions here.
Press enter on your putty window to start the flash process and wait. The bulb will stop flashing followed by a large amount of scrolling text, this is the script backing up the factory shipped firmware.
Once the process is complete you can type
The bulb will restart and if everything is working correctly after a few seconds the light should be on.
3. Bulb Configurations¶
3.1 Monochromatic Bulbs¶
The brightness of the bulb can be controlled using the
esp8266_pwm output component connected to the light component using the id configuration
esphome: name: mirabella_genio_cw_1 esp8266: board: esp01_1m wifi: ssid: !secret wifi_ssid password: !secret wifi_password logger: api: ota: light: - platform: monochromatic name: "Mirabella Genio Smart Bulb" id: light output: output_component1 # Ensure the light turns on by default if the physical switch is actuated. restore_mode: ALWAYS_ON output: - platform: esp8266_pwm id: output_component1 # May need to use GPIO14 instead for certain globes pin: GPIO13
3.2 Cold + Warm White Bulbs¶
esphome: name: mirabella_genio_cwww_1 esp8266: board: esp01_1m wifi: ssid: !secret wifi_ssid password: !secret wifi_password logger: api: ota: output: - platform: esp8266_pwm id: output_warm_white pin: GPIO13 - platform: esp8266_pwm id: output_daylight pin: GPIO5 light: - platform: cwww name: "Mirabella Genio Smart Bulb" id: light cold_white: output_daylight warm_white: output_warm_white cold_white_color_temperature: 6500 K warm_white_color_temperature: 2700 K # Ensure the light turns on by default if the physical switch is actuated. restore_mode: ALWAYS_ON
3.3 RGBW Color Bulbs¶
esphome: name: rgbw_e27_01 esp8266: board: esp01_1m wifi: ssid: !secret wifi_ssid password: !secret wifi_password logger: api: ota: output: - platform: esp8266_pwm id: output_red pin: GPIO4 - platform: esp8266_pwm id: output_green pin: GPIO12 - platform: esp8266_pwm id: output_blue pin: GPIO14 - platform: esp8266_pwm id: output_white pin: GPIO5 light: - platform: rgbw name: "rgbw_e27_01" id: light red: output_red green: output_green blue: output_blue white: output_white # Ensure the light turns on by default if the physical switch is actuated. restore_mode: ALWAYS_ON
3.4 CWWW Mirabella Genio Downlights¶
Kmart also sell a downlight option, which works quite well however the PWM method that is used is different to the way the CWWW lights in ESPHome works.
A project by ssieb resolves this using a custom component.
esphome: name: rgbw_e27_01 esp8266: board: esp01_1m wifi: ssid: !secret wifi_ssid password: !secret wifi_password logger: api: ota: output: - platform: esp8266_pwm id: output1 pin: GPIO14 - platform: esp8266_pwm id: output2 pin: GPIO12 light: - platform: cwww2 id: LED name: "Downlight" color_temperature: output2 brightness: output1 cold_white_color_temperature: 6500 K warm_white_color_temperature: 2700 K # Ensure the light turns on by default if the physical switch is actuated. restore_mode: ALWAYS_ON
4. Adding to Home Assistant¶
You can now add your bulb to home assistant via the configurations page, look for ‘ESPHome’ under the Integrations option and click ‘Configure’.