controller_unscaled_power_mW()

fl::u32 controller_unscaled_power_mW

(

const fl::CLEDController &

controller

)

One controller's demand at full brightness, in mW, including idle draw – the quantity the limiter sums and scales.

A controller whose output runs through a colour pipeline is charged for the drives the pipeline solves, not for its source pixels: the two differ in either direction, by up to 4.45x on dim emitters (#4344, #4156 R3). Any other controller is charged through its RGBW conversion, as before.

Definition at line 485 of file power_mgt.cpp.hpp.

                                                                                    {
    const fl::span<const CRGB> leds(controller.leds(),
                                    static_cast<fl::size>(controller.size()));
#if FL_COLOR_PIPELINE_SHARED
    // Through the pipeline hook, which exists whenever a pipeline does; naming
    // the estimator directly would link the colour pipeline into sketches that
    // limit power but never bind a profile. `pipeline` is this estimate's own
    // reference, so reconfiguring the controller mid-pass cannot free the
    // pipeline it is walking (#4440).
    const fl::shared_ptr<fl::StreamingPipelineQ16> pipeline = fl::channelColorPipeline(controller);
    const fl::ColorPipelineHooks& hooks = fl::colorPipelineHooks();
    if (pipeline && hooks.unscaledPowerMilliwatts != nullptr) {
        // The callback charges already-solved physical emitter bytes. In
        // particular, the RGBW legacy estimator must not convert them again.
        const fl::u8 emitters = controller.getRgbww().active()
                                    ? 5 : (controller.getRgbw().active() ? 4 : 3);
        return hooks.unscaledPowerMilliwatts(
            *pipeline, leds, emitters, &calculate_unscaled_emitter_power_mW);
    }
#endif
    // Below the large-memory tier only this is compiled: a managed channel
    // there is charged for its source (FL_COLOR_PIPELINE_SHARED).
    // No stored Rgbw reads as RgbwInvalid, which the overload answers with the
    // RGB estimate; asking for it directly skips copying the Rgbw value.
    const fl::Rgbw* rgbw = controller.rgbwConfig();
    return rgbw && gRgbwPowerEstimate ? gRgbwPowerEstimate(leds, *rgbw)
                                      : calculate_unscaled_power_mW(leds);
}

References calculate_unscaled_emitter_power_mW(), calculate_unscaled_power_mW(), fl::colorPipelineHooks(), controller, FL_NO_EXCEPT, gRgbwPowerEstimate, leds, and rgbw.

Referenced by calculate_max_brightness_for_power_mW(), and CFastLED::getEstimatedPowerInMilliWatts().

Here is the call graph for this function:

Here is the caller graph for this function: