CLIP sensor for light level. More...

#include <hueplusplus/CLIPSensors.h>

Inheritance diagram for hueplusplus::sensors::CLIPLightLevel:

Collaboration diagram for hueplusplus::sensors::CLIPLightLevel:

Public Member Functions
	CLIPLightLevel (Sensor sensor)
	Construct from generic sensor.

int	getDarkThreshold () const
	Get threshold to detect darkness.

void	setDarkThreshold (int threshold)
	Set threshold to detect darkness.

int	getThresholdOffset () const
	Get offset over dark threshold to detect daylight.

void	setThresholdOffset (int offset)
	Set offset to detect daylight.

int	getLightLevel () const
	Get measured light level.

void	setLightLevel (int level)
	Set measured light level.

bool	isDark () const
	Check whether light level is below dark threshold.

bool	isDaylight () const
	Check whether light level is above light threshold.

Public Member Functions inherited from hueplusplus::sensors::BaseCLIP
bool	isOn () const
	Check if sensor is on.

void	setOn (bool on)
	Enable or disable sensor.

bool	hasBatteryState () const
	Check whether the sensor has a battery state.

int	getBatteryState () const
	Get battery state.

void	setBatteryState (int percent)
	Set battery state.

bool	isReachable () const
	Check whether the sensor is reachable.

bool	hasURL () const
	Check whether the sensor has a URL.

std::string	getURL () const
	Get sensor URL.

void	setURL (const std::string &url)
	Set sensor URL.

time::AbsoluteTime	getLastUpdated () const
	Get time of last status update.

Public Member Functions inherited from hueplusplus::BaseDevice
virtual	~BaseDevice ()=default
	Virtual destructor.

virtual int	getId () const
	Const function that returns the id of this device.

virtual std::string	getType () const
	Const function that returns the device type.

virtual std::string	getName ()
	Function that returns the name of the device.

virtual std::string	getName () const
	Const function that returns the name of the device.

virtual std::string	getModelId () const
	Const function that returns the modelid of the device.

virtual std::string	getUId () const
	Const function that returns the uniqueid of the device.

virtual std::string	getManufacturername () const
	Const function that returns the manufacturername of the device.

virtual std::string	getProductname () const
	Const function that returns the productname of the device.

virtual std::string	getSwVersion ()
	Function that returns the software version of the device.

virtual std::string	getSwVersion () const
	Const function that returns the software version of the device.

virtual bool	setName (const std::string &name)
	Function that sets the name of the device.

virtual void	refresh (bool force=false)
	Refreshes internal cached state.

virtual void	setRefreshDuration (std::chrono::steady_clock::duration refreshDuration)
	Sets custom refresh interval for this device.

Static Public Attributes
static constexpr const char *	typeStr = "CLIPLightLevel"
	CLIPLightLevel sensor type name.

Additional Inherited Members
Protected Member Functions inherited from hueplusplus::sensors::BaseCLIP
	BaseCLIP (Sensor sensor)
	Protected constructor to be used by subclasses.

Protected Member Functions inherited from hueplusplus::BaseDevice
	BaseDevice (int id, const std::shared_ptr< APICache > &baseCache)
	Protected ctor that is used by subclasses, construct with shared cache.

	BaseDevice (int id, const HueCommandAPI &commands, const std::string &path, std::chrono::steady_clock::duration refreshDuration, const nlohmann::json &currentState)
	Protected ctor that is used by subclasses.

virtual nlohmann::json	sendPutRequest (const std::string &subPath, const nlohmann::json &request, FileInfo fileInfo)
	Utility function to send a put request to the device.

Protected Attributes inherited from hueplusplus::BaseDevice
int	id
	holds the id of the device

APICache	state
	holds the current state of the device

Detailed Description

CLIP sensor for light level.

Constructor & Destructor Documentation

◆ CLIPLightLevel()

hueplusplus::sensors::CLIPLightLevel::CLIPLightLevel ( Sensor sensor )

inlineexplicit

Construct from generic sensor.

Member Function Documentation

◆ getDarkThreshold()

int hueplusplus::sensors::CLIPLightLevel::getDarkThreshold ( ) const

Get threshold to detect darkness.

◆ getLightLevel()

int hueplusplus::sensors::CLIPLightLevel::getLightLevel ( ) const

Get measured light level.

Returns: Light level in 10000*log10(lux)+1 (logarithmic scale)

◆ getThresholdOffset()

int hueplusplus::sensors::CLIPLightLevel::getThresholdOffset ( ) const

Get offset over dark threshold to detect daylight.

◆ isDark()

bool hueplusplus::sensors::CLIPLightLevel::isDark ( ) const

Check whether light level is below dark threshold.

◆ isDaylight()

bool hueplusplus::sensors::CLIPLightLevel::isDaylight ( ) const

Check whether light level is above light threshold.

Light threshold is dark threshold + offset

◆ setDarkThreshold()

void hueplusplus::sensors::CLIPLightLevel::setDarkThreshold ( int threshold )

Set threshold to detect darkness.

Parameters

threshold Light level as reported by getLightLevel

Exceptions

std::system_error	when system or socket operations fail
HueException	when response contained no body
HueAPIResponseException	when response contains an error
nlohmann::json::parse_error	when response could not be parsed

◆ setLightLevel()

void hueplusplus::sensors::CLIPLightLevel::setLightLevel ( int level )

Set measured light level.

Parameters

level Light level in 10000*log10(lux)+1

Exceptions

std::system_error	when system or socket operations fail
HueException	when response contained no body
HueAPIResponseException	when response contains an error
nlohmann::json::parse_error	when response could not be parsed

◆ setThresholdOffset()

void hueplusplus::sensors::CLIPLightLevel::setThresholdOffset ( int offset )

Set offset to detect daylight.

Parameters

offset Offset to dark threshold to detect daylight. Must be greater than 1.

Exceptions

std::system_error	when system or socket operations fail
HueException	when response contained no body
HueAPIResponseException	when response contains an error
nlohmann::json::parse_error	when response could not be parsed

Member Data Documentation

◆ typeStr

constexpr const char * hueplusplus::sensors::CLIPLightLevel::typeStr = "CLIPLightLevel"

staticconstexpr

CLIPLightLevel sensor type name.

The documentation for this class was generated from the following files:

include/hueplusplus/CLIPSensors.h
src/CLIPSensors.cpp

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CLIPLightLevel()

Member Function Documentation

◆ getDarkThreshold()

◆ getLightLevel()

◆ getThresholdOffset()

◆ isDark()

◆ isDaylight()

◆ setDarkThreshold()

◆ setLightLevel()

◆ setThresholdOffset()

Member Data Documentation

◆ typeStr