Introduced a HUB component + front panel IRQ handling
A HUB component was introduced. This HUB component has all the knowledge
about the Yeelight Bedside Lamp 2 hardware. It known what pins are used,
that PWM frequencies to use, what pins to switch in binary mode, etc. etc.
No configuration is required for this HUB component. It's automatically
loaded when the light component is loaded. The light component will use the
HUB component to access the pins that are required for driving the LED
circuitry.
Note that this simplifies the configuration by A LOT. There's no need
anymore to configure the pinouts in the YAML file. This is a logical route
to take, since we're talking about a factory-produced PCB with a soldered on
ESP32 chip, which uses the same GPIO's and settings on all produced devices
(I presume). It would be quite redundant to force every user into
configuring these pinouts themselves.
** Beware to update your device yaml configuration **
There are a few pinouts left to move into the HUB. I will do that in the
next commit. Your device yaml configuration can be simplified along with
these changes. Some of the keys in the existing light configuration block
will no longer work and will have to be removed (red, green, blue, white).
** Further development **
The HUB will be extended make it the central component that also handles
the I2C communication. This way, there is a central place to regulate the
traffic to and from the front panel. We will be able to build upon this
by implementing extra, fully separated components that handle for example
the front panel light level, the power button, the color button and
the slider.
** Interrupt handler for the I2C IRQ trigger pin **
One requirement for the I2C communication has already been implemented: an
interrupt handler for the GPIO that is used by the front panel to signal the
ESP that a new touch or release event is avilable to be read.
It doens't do anything functionally right now, but if you watch the log
file, you will see that touch events are detected and that they trigger some
log messages.
3 years ago Introduced a HUB component + front panel IRQ handling
A HUB component was introduced. This HUB component has all the knowledge
about the Yeelight Bedside Lamp 2 hardware. It known what pins are used,
that PWM frequencies to use, what pins to switch in binary mode, etc. etc.
No configuration is required for this HUB component. It's automatically
loaded when the light component is loaded. The light component will use the
HUB component to access the pins that are required for driving the LED
circuitry.
Note that this simplifies the configuration by A LOT. There's no need
anymore to configure the pinouts in the YAML file. This is a logical route
to take, since we're talking about a factory-produced PCB with a soldered on
ESP32 chip, which uses the same GPIO's and settings on all produced devices
(I presume). It would be quite redundant to force every user into
configuring these pinouts themselves.
** Beware to update your device yaml configuration **
There are a few pinouts left to move into the HUB. I will do that in the
next commit. Your device yaml configuration can be simplified along with
these changes. Some of the keys in the existing light configuration block
will no longer work and will have to be removed (red, green, blue, white).
** Further development **
The HUB will be extended make it the central component that also handles
the I2C communication. This way, there is a central place to regulate the
traffic to and from the front panel. We will be able to build upon this
by implementing extra, fully separated components that handle for example
the front panel light level, the power button, the color button and
the slider.
** Interrupt handler for the I2C IRQ trigger pin **
One requirement for the I2C communication has already been implemented: an
interrupt handler for the GPIO that is used by the front panel to signal the
ESP that a new touch or release event is avilable to be read.
It doens't do anything functionally right now, but if you watch the log
file, you will see that touch events are detected and that they trigger some
log messages.
3 years ago |
|
- #pragma once
-
- #include "../common.h"
- #include "../light_hal.h"
- #include "color_handler_chain.h"
- #include "light_transformer.h"
- #include "esphome/core/component.h"
- #include "esphome/components/ledc/ledc_output.h"
-
- namespace esphome {
- namespace xiaomi {
- namespace bslamp2 {
-
- /**
- * A LightOutput class for the Xiaomi Mijia Bedside Lamp 2.
- *
- * The function of this class is to translate a required light state
- * into actual physicial GPIO output signals to drive the device's LED
- * circuitry. It forms the glue between the physical device and the
- * logical light color input.
- */
- class XiaomiBslamp2LightOutput : public Component, public light::LightOutput {
- public:
- void set_parent(LightHAL *light) { light_ = light; }
-
- /**
- * Returns a LightTraits object, which is used to explain to the outside
- * world (e.g. Home Assistant) what features are supported by this device.
- */
- light::LightTraits get_traits() override {
- auto traits = light::LightTraits();
- traits.set_supported_color_modes({light::ColorMode::RGB, light::ColorMode::COLOR_TEMPERATURE});
- traits.set_min_mireds(MIRED_MIN);
- traits.set_max_mireds(MIRED_MAX);
- return traits;
- }
-
- std::unique_ptr<light::LightTransformer> create_default_transition() override {
- return make_unique<XiaomiBslamp2LightTransitionTransformer>(
- light_, light_mode_callback_, state_callback_);
- }
-
- void add_on_light_mode_callback(std::function<void(std::string)> &&callback) {
- light_mode_callback_.add(std::move(callback));
- }
-
- void add_on_state_callback(std::function<void(light::LightColorValues)> &&callback) {
- state_callback_.add(std::move(callback));
- }
-
- /**
- * Applies a requested light state to the physicial GPIO outputs.
- */
- void write_state(light::LightState *state) {
- auto values = state->current_values;
-
- color_handler_chain->set_light_color_values(values);
- light_mode_callback_.call(color_handler_chain->light_mode);
- state_callback_.call(values);
-
- // Note: one might think that it is more logical to turn on the LED
- // circuitry master switch after setting the individual channels,
- // but this is the order that was used by the original firmware. I
- // tried to stay as close as possible to the original behavior, so
- // that's why these GPIOs are turned on at this point.
- if (values.get_state() != 0)
- light_->turn_on();
-
- // Apply the GPIO output levels as defined by the color handler.
- light_->set_state(color_handler_chain);
-
- if (values.get_state() == 0)
- light_->turn_off();
- }
-
- protected:
- LightHAL *light_;
- ColorHandler *color_handler_chain = new ColorHandlerChain();
- CallbackManager<void(std::string)> light_mode_callback_{};
- CallbackManager<void(light::LightColorValues)> state_callback_{};
- };
-
- } // namespace bslamp2
- } // namespace xiaomi
- } // namespace esphome
|