hyperion.ng/libsrc/leddevice/dev_spi/LedDeviceSK9822.h

84 lines
3.0 KiB
C
Raw Normal View History

#ifndef LEDEVICESK9822_H
#define LEDEVICESK9822_H
// hyperion includes
#include "ProviderSpi.h"
///
/// Implementation of the LedDevice interface for writing to SK9822 led device via SPI.
///
class LedDeviceSK9822 : public ProviderSpi
{
public:
///
/// @brief Constructs an SK9822 LED-device
///
/// @param deviceConfig Device's configuration as JSON-Object
///
explicit LedDeviceSK9822(const QJsonObject &deviceConfig);
///
/// @brief Constructs the LED-device
///
/// @param[in] deviceConfig Device's configuration as JSON-Object
/// @return LedDevice constructed
///
static LedDevice* construct(const QJsonObject &deviceConfig);
private:
///
/// @brief Writes the RGB-Color values to the SPI Tx buffer setting SK9822 current level to maximal value.
///
/// @param[in,out] txBuf The packed spi transfer buffer of the LED's color values
/// @param[in] ledValues The RGB-color per LED
/// @param[in] maxLevel The maximal current level 1 .. 31 to use
///
void bufferWithMaxCurrent(std::vector<uint8_t> &txBuf, const std::vector<ColorRgb> & ledValues, const int maxLevel);
///
/// @brief Writes the RGB-Color values to the SPI Tx buffer using an adjusted SK9822 current level for LED maximal rgb-grayscale values not exceeding the threshold, uses maximal level otherwise.
///
/// @param[in,out] txBuf The packed spi transfer buffer of the LED's color values
/// @param[in] ledValues The RGB-color per LED
/// @param[in] threshold The threshold 0 .. 255 that defines whether to use adjusted SK9822 current level per LED
/// @param[in] maxLevel The maximal current level 1 .. 31 to use
///
void bufferWithAdjustedCurrent(std::vector<uint8_t> &txBuf, const std::vector<ColorRgb> & ledValues, const int threshold, const int maxLevel);
/// The threshold that defines use of SK9822 global brightness control for maximal rgb grayscale values below.
/// i.e. global brightness control is used for rgb-values when max(r,g,b) < threshold.
int _globalBrightnessControlThreshold;
/// The maximal current level that is targeted. Possibile values 1 .. 31.
int _globalBrightnessControlMaxLevel;
///
/// @brief Scales the given value such that a given grayscale stimulus is reached for the targeted brightness and defined max current value.
///
/// @param[in] value The grayscale value to scale
/// @param[in] maxLevel The maximal current level 1 .. 31 to use
/// @param[in] brightness The target brightness
/// @return The scaled grayscale stimulus
///
inline __attribute__((always_inline)) unsigned scale(const uint8_t value, const int maxLevel, const uint16_t brightness);
///
/// @brief Initialise the device's configuration
///
/// @param[in] deviceConfig the JSON device configuration
/// @return True, if success
///
bool init(const QJsonObject &deviceConfig) override;
///
/// @brief Writes the RGB-Color values to the LEDs.
///
/// @param[in] ledValues The RGB-color per LED
/// @return Zero on success, else negative
///
int write(const std::vector<ColorRgb> & ledValues) override;
};
#endif // LEDEVICESK9822_H