Backlight.h

Go to the documentation of this file.

 
/*
 * Copyright (C) 2023 CrossControl AB
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; with
 * version 2.1 of the License.
 */
/*
 *  File description:
 *  Backlight settings
 *
 *  Use the function GetBacklight() to get a handle to pass on to the other functions.
 *  Use the method Backlight_release(BACKLIGHTHANDLE) to return the handle.
 *
 *  Example Usage:
 *  @include backlight_example.cpp
 *
 ************************************************/
 
#ifndef CC_BACKLIGHT_H_
#define CC_BACKLIGHT_H_
 
#include "CCAuxErrors.h"
#include "CCAuxTypes.h"
#include "CCPlatform.h"
 
#ifdef __cplusplus
namespace CrossControl
{
#endif
 
typedef void *BACKLIGHTHANDLE;
 
EXTERN_C
CCAUXDLL_API
BACKLIGHTHANDLE
CCAUXDLL_CALLING_CONV
GetBacklight(void);
 
EXTERN_C
CCAUXDLL_API
void CCAUXDLL_CALLING_CONV Backlight_release(BACKLIGHTHANDLE);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getIntensity(BACKLIGHTHANDLE, uint8_t *intensity);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_setIntensity(BACKLIGHTHANDLE, uint8_t intensity);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getStatus(BACKLIGHTHANDLE, uint8_t *status);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getHWStatus(BACKLIGHTHANDLE, bool *status);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_startAutomaticBL(BACKLIGHTHANDLE);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_stopAutomaticBL(BACKLIGHTHANDLE);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getAutomaticBLStatus(BACKLIGHTHANDLE, uint8_t *status);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_setAutomaticBLParams(BACKLIGHTHANDLE, bool bSoftTransitions);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getAutomaticBLParams(BACKLIGHTHANDLE, bool *bSoftTransitions, float64_t *k);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_setAutomaticBLFilter(BACKLIGHTHANDLE, uint32_t averageWndSize,
                                                          uint32_t rejectWndSize, uint32_t rejectDeltaInLux,
                                                          LightSensorSamplingMode mode);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getAutomaticBLFilter(BACKLIGHTHANDLE, uint32_t *averageWndSize,
                                                          uint32_t *rejectWndSize, uint32_t *rejectDeltaInLux,
                                                          LightSensorSamplingMode *mode);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getLedDimming(BACKLIGHTHANDLE, CCStatus *status);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_setLedDimming(BACKLIGHTHANDLE, CCStatus status);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_setActive(BACKLIGHTHANDLE, ComponentLocation location);
 
EXTERN_C
CCAUXDLL_API
eErr CCAUXDLL_CALLING_CONV Backlight_getActive(BACKLIGHTHANDLE, ComponentLocation *location);
 
#ifdef __cplusplus
} /* namespace CrossControl */
#endif
 
#endif /* CC_BACKLIGHT_H_ */