tsl2561 - Driver for light-to-digital converter TSL2561¶

group tsl2561

ESP-IDF driver for TSL2561 light-to-digital converter.

Ported from esp-open-rtos

unclerus@gmail.com

BSD Licensed as described in the file LICENSE

Defines

TSL2561_I2C_ADDR_GND¶

TSL2561_I2C_ADDR_FLOAT¶: Default I2C address.

TSL2561_I2C_ADDR_VCC¶

Enums

enum tsl2561_integration_time_t¶

Integration time.

Values:

enumerator TSL2561_INTEGRATION_13MS¶: 13ms

enumerator TSL2561_INTEGRATION_101MS¶: 101ms

enumerator TSL2561_INTEGRATION_402MS¶: 402ms, default

enum tsl2561_gain_t¶

Gain.

Values:

enumerator TSL2561_GAIN_1X¶: Default.

enumerator TSL2561_GAIN_16X¶

enum tsl2561_package_t¶

Values:

enumerator TSL2561_PACKAGE_CS¶

enumerator TSL2561_PACKAGE_T_FN_CL¶

Functions

esp_err_t tsl2561_init_desc(tsl2561_t *dev, uint8_t addr, i2c_port_t port, gpio_num_t sda_gpio, gpio_num_t scl_gpio)¶

Initialize device descriptor.

Parameters

dev – Device descriptor
addr – I2C device address, TSL2561_I2C_ADDR_... const
port – I2C port
sda_gpio – SDA GPIO pin
scl_gpio – SCL GPIO pin

Returns

ESP_OK on success

esp_err_t tsl2561_free_desc(tsl2561_t *dev)¶

Free device descriptor.

Parameters: dev – Device descriptor
Returns: ESP_OK on success

esp_err_t tsl2561_init(tsl2561_t *dev)¶

Initialize device.

Parameters: dev – Device descriptor
Returns: ESP_OK on success

esp_err_t tsl2561_set_integration_time(tsl2561_t *dev, tsl2561_integration_time_t integration_time)¶

Set device integration time.

Parameters

dev – Device descriptor
integration_time – Integration time

Returns

ESP_OK on success

esp_err_t tsl2561_set_gain(tsl2561_t *dev, tsl2561_gain_t gain)¶

Set device gain.

Parameters

dev – Device descriptor
gain – Gain

Returns

ESP_OK on success

esp_err_t tsl2561_read_lux(tsl2561_t *dev, uint32_t *lux)¶

Read light intensity from device.

Parameters

dev – Device descriptor
[out] lux – Light intensity, lux

Returns

ESP_OK on success

struct tsl2561_t¶: #include <tsl2561.h>
Device descriptor.