struct tsl2583_settings { int als_time; int als_gain; int als_gain_trim; int als_cal_target;
/* * This structure is intentionally large to accommodate updates via * sysfs. Sized to 11 = max 10 segments + 1 termination segment. * Assumption is that one and only one type of glass used.
*/ struct tsl2583_lux als_device_lux[TSL2583_MAX_LUX_TABLE_ENTRIES];
};
struct tsl2583_chip { struct mutex als_mutex; struct i2c_client *client; struct tsl2583_als_info als_cur_info; struct tsl2583_settings als_settings; int als_time_scale; int als_saturation;
};
struct gainadj {
s16 ch0;
s16 ch1;
s16 mean;
};
/* Index = (0 - 3) Used to validate the gain selection index */ staticconststruct gainadj gainadj[] = {
{ 1, 1, 1 },
{ 8, 8, 8 },
{ 16, 16, 16 },
{ 107, 115, 111 }
};
/* * Provides initial operational parameter defaults. * These defaults may be changed through the device's sysfs files.
*/ staticvoid tsl2583_defaults(struct tsl2583_chip *chip)
{ /* * The integration time must be a multiple of 50ms and within the * range [50, 600] ms.
*/
chip->als_settings.als_time = 100;
/* * This is an index into the gainadj table. Assume clear glass as the * default.
*/
chip->als_settings.als_gain = 0;
/* Default gain trim to account for aperture effects */
chip->als_settings.als_gain_trim = 1000;
/* Known external ALS reading used for calibration */
chip->als_settings.als_cal_target = 130;
/* * Reads and calculates current lux value. * The raw ch0 and ch1 values of the ambient light sensed in the last * integration cycle are read from the device. * Time scale factor array values are adjusted based on the integration time. * The raw values are multiplied by a scale factor, and device gain is obtained * using gain index. Limit checks are done next, then the ratio of a multiple * of ch1 value, to the ch0 value, is calculated. The array als_device_lux[] * declared above is then scanned to find the first ratio value that is just * above the ratio we just calculated. The ch0 and ch1 multiplier constants in * the array are then used along with the time scale factor array values, to * calculate the lux.
*/ staticint tsl2583_get_lux(struct iio_dev *indio_dev)
{
u16 ch0, ch1; /* separated ch0/ch1 data from device */
u32 lux; /* raw lux calculated from device data */
u64 lux64;
u32 ratio;
u8 buf[5]; struct tsl2583_lux *p; struct tsl2583_chip *chip = iio_priv(indio_dev); int i, ret;
ret = i2c_smbus_read_byte_data(chip->client, TSL2583_CMD_REG); if (ret < 0) {
dev_err(&chip->client->dev, "%s: failed to read CMD_REG register\n",
__func__); goto done;
}
/* is data new & valid */ if (!(ret & TSL2583_STA_ADC_INTR)) {
dev_err(&chip->client->dev, "%s: data not valid; returning last value\n",
__func__);
ret = chip->als_cur_info.lux; /* return LAST VALUE */ goto done;
}
for (i = 0; i < 4; i++) { int reg = TSL2583_CMD_REG | (TSL2583_ALS_CHAN0LO + i);
ret = i2c_smbus_read_byte_data(chip->client, reg); if (ret < 0) {
dev_err(&chip->client->dev, "%s: failed to read register %x\n",
__func__, reg); goto done;
}
buf[i] = ret;
}
/* * Clear the pending interrupt status bit on the chip to allow the next * integration cycle to start. This has to be done even though this * driver currently does not support interrupts.
*/
ret = i2c_smbus_write_byte(chip->client,
(TSL2583_CMD_REG | TSL2583_CMD_SPL_FN |
TSL2583_CMD_ALS_INT_CLR)); if (ret < 0) {
dev_err(&chip->client->dev, "%s: failed to clear the interrupt bit\n",
__func__); goto done; /* have no data, so return failure */
}
if ((ch0 >= chip->als_saturation) || (ch1 >= chip->als_saturation)) goto return_max;
if (!ch0) { /* * The sensor appears to be in total darkness so set the * calculated lux to 0 and return early to avoid a division by * zero below when calculating the ratio.
*/
ret = 0;
chip->als_cur_info.lux = 0; goto done;
}
/* calculate ratio */
ratio = (ch1 << 15) / ch0;
/* convert to unscaled lux using the pointer to the table */ for (p = (struct tsl2583_lux *)chip->als_settings.als_device_lux;
p->ratio != 0 && p->ratio < ratio; p++)
;
/* note: lux is 31 bit max at this point */ if (ch1lux > ch0lux) {
dev_dbg(&chip->client->dev, "%s: No Data - Returning 0\n",
__func__);
ret = 0;
chip->als_cur_info.lux = 0; goto done;
}
lux = ch0lux - ch1lux;
}
/* adjust for active time scale */ if (chip->als_time_scale == 0)
lux = 0; else
lux = (lux + (chip->als_time_scale >> 1)) /
chip->als_time_scale;
/* * Adjust for active gain scale. * The tsl2583_default_lux tables above have a factor of 8192 built in, * so we need to shift right. * User-specified gain provides a multiplier. * Apply user-specified gain before shifting right to retain precision. * Use 64 bits to avoid overflow on multiplication. * Then go back to 32 bits before division to avoid using div_u64().
*/
lux64 = lux;
lux64 = lux64 * chip->als_settings.als_gain_trim;
lux64 >>= 13;
lux = lux64;
lux = DIV_ROUND_CLOSEST(lux, 1000);
if (lux > TSL2583_LUX_CALC_OVER_FLOW) { /* check for overflow */
return_max:
lux = TSL2583_LUX_CALC_OVER_FLOW;
}
/* Update the structure with the latest VALID lux. */
chip->als_cur_info.lux = lux;
ret = lux;
done: return ret;
}
/* * Obtain single reading and calculate the als_gain_trim (later used * to derive actual lux). * Return updated gain_trim value.
*/ staticint tsl2583_als_calibrate(struct iio_dev *indio_dev)
{ struct tsl2583_chip *chip = iio_priv(indio_dev); unsignedint gain_trim_val; int ret; int lux_val;
ret = i2c_smbus_read_byte_data(chip->client,
TSL2583_CMD_REG | TSL2583_CNTRL); if (ret < 0) {
dev_err(&chip->client->dev, "%s: failed to read from the CNTRL register\n",
__func__); return ret;
}
if ((ret & (TSL2583_CNTL_ADC_ENBL | TSL2583_CNTL_PWR_ON))
!= (TSL2583_CNTL_ADC_ENBL | TSL2583_CNTL_PWR_ON)) {
dev_err(&chip->client->dev, "%s: Device is not powered on and/or ADC is not enabled\n",
__func__); return -EINVAL;
} elseif ((ret & TSL2583_STA_ADC_VALID) != TSL2583_STA_ADC_VALID) {
dev_err(&chip->client->dev, "%s: The two ADC channels have not completed an integration cycle\n",
__func__); return -ENODATA;
}
lux_val = tsl2583_get_lux(indio_dev); if (lux_val < 0) {
dev_err(&chip->client->dev, "%s: failed to get lux\n",
__func__); return lux_val;
}
/* Avoid division by zero of lux_value later on */ if (lux_val == 0) {
dev_err(&chip->client->dev, "%s: lux_val of 0 will produce out of range trim_value\n",
__func__); return -ENODATA;
}
gain_trim_val = (unsignedint)(((chip->als_settings.als_cal_target)
* chip->als_settings.als_gain_trim) / lux_val); if ((gain_trim_val < 250) || (gain_trim_val > 4000)) {
dev_err(&chip->client->dev, "%s: trim_val of %d is not within the range [250, 4000]\n",
__func__, gain_trim_val); return -ENODATA;
}
/* determine als integration register */
als_count = DIV_ROUND_CLOSEST(chip->als_settings.als_time * 100, 270); if (!als_count)
als_count = 1; /* ensure at least one cycle */
/* convert back to time (encompasses overrides) */
als_time = DIV_ROUND_CLOSEST(als_count * 27, 10);
val = 256 - als_count;
ret = i2c_smbus_write_byte_data(chip->client,
TSL2583_CMD_REG | TSL2583_ALS_TIME,
val); if (ret < 0) {
dev_err(&chip->client->dev, "%s: failed to set the als time to %d\n",
__func__, val); return ret;
}
/* set chip struct re scaling and saturation */
chip->als_saturation = als_count * 922; /* 90% of full scale */
chip->als_time_scale = DIV_ROUND_CLOSEST(als_time, 50);
return ret;
}
staticint tsl2583_set_als_gain(struct tsl2583_chip *chip)
{ int ret;
/* Set the gain based on als_settings struct */
ret = i2c_smbus_write_byte_data(chip->client,
TSL2583_CMD_REG | TSL2583_GAIN,
chip->als_settings.als_gain); if (ret < 0)
dev_err(&chip->client->dev, "%s: failed to set the gain to %d\n", __func__,
chip->als_settings.als_gain);
return ret;
}
staticint tsl2583_set_power_state(struct tsl2583_chip *chip, u8 state)
{ int ret;
ret = i2c_smbus_write_byte_data(chip->client,
TSL2583_CMD_REG | TSL2583_CNTRL, state); if (ret < 0)
dev_err(&chip->client->dev, "%s: failed to set the power state to %d\n", __func__,
state);
return ret;
}
/* * Turn the device on. * Configuration must be set before calling this function.
*/ staticint tsl2583_chip_init_and_power_on(struct iio_dev *indio_dev)
{ struct tsl2583_chip *chip = iio_priv(indio_dev); int ret;
/* Power on the device; ADC off. */
ret = tsl2583_set_power_state(chip, TSL2583_CNTL_PWR_ON); if (ret < 0) return ret;
ret = i2c_smbus_write_byte_data(chip->client,
TSL2583_CMD_REG | TSL2583_INTERRUPT,
TSL2583_INTERRUPT_DISABLED); if (ret < 0) {
dev_err(&chip->client->dev, "%s: failed to disable interrupts\n", __func__); return ret;
}
ret = tsl2583_set_als_time(chip); if (ret < 0) return ret;
ret = tsl2583_set_als_gain(chip); if (ret < 0) return ret;
usleep_range(3000, 3500);
ret = tsl2583_set_power_state(chip, TSL2583_CNTL_PWR_ON |
TSL2583_CNTL_ADC_ENBL); if (ret < 0) return ret;
for (i = 0; i < ARRAY_SIZE(chip->als_settings.als_device_lux); i++) {
offset += sprintf(buf + offset, "%u,%u,%u,",
chip->als_settings.als_device_lux[i].ratio,
chip->als_settings.als_device_lux[i].ch0,
chip->als_settings.als_device_lux[i].ch1); if (chip->als_settings.als_device_lux[i].ratio == 0) { /* * We just printed the first "0" entry. * Now get rid of the extra "," and break.
*/
offset--; break;
}
}
/* * We now have an array of ints starting at value[1], and * enumerated by value[0]. * We expect each group of three ints is one table entry, * and the last table entry is all 0.
*/
n = value[0]; if ((n % 3) || n < 6 || n > max_ints) {
dev_err(dev, "%s: The number of entries in the lux table must be a multiple of 3 and within the range [6, %d]\n",
__func__, max_ints); goto done;
} if ((value[n - 2] | value[n - 1] | value[n]) != 0) {
dev_err(dev, "%s: The last 3 entries in the lux table must be zeros.\n",
__func__); goto done;
}
staticint tsl2583_set_pm_runtime_busy(struct tsl2583_chip *chip, bool on)
{ int ret;
if (on) {
ret = pm_runtime_resume_and_get(&chip->client->dev);
} else {
pm_runtime_mark_last_busy(&chip->client->dev);
ret = pm_runtime_put_autosuspend(&chip->client->dev);
}
return ret;
}
staticint tsl2583_read_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int *val, int *val2, long mask)
{ struct tsl2583_chip *chip = iio_priv(indio_dev); int ret, pm_ret;
ret = tsl2583_set_pm_runtime_busy(chip, true); if (ret < 0) return ret;
mutex_lock(&chip->als_mutex);
ret = -EINVAL; switch (mask) { case IIO_CHAN_INFO_RAW: if (chan->type == IIO_LIGHT) {
ret = tsl2583_get_lux(indio_dev); if (ret < 0) goto read_done;
/* * From page 20 of the TSL2581, TSL2583 data * sheet (TAOS134 − MARCH 2011): * * One of the photodiodes (channel 0) is * sensitive to both visible and infrared light, * while the second photodiode (channel 1) is * sensitive primarily to infrared light.
*/ if (chan->channel2 == IIO_MOD_LIGHT_BOTH)
*val = chip->als_cur_info.als_ch0; else
*val = chip->als_cur_info.als_ch1;
ret = IIO_VAL_INT;
} break; case IIO_CHAN_INFO_PROCESSED: if (chan->type == IIO_LIGHT) {
ret = tsl2583_get_lux(indio_dev); if (ret < 0) goto read_done;
*val = ret;
ret = IIO_VAL_INT;
} break; case IIO_CHAN_INFO_CALIBBIAS: if (chan->type == IIO_LIGHT) {
*val = chip->als_settings.als_gain_trim;
ret = IIO_VAL_INT;
} break; case IIO_CHAN_INFO_CALIBSCALE: if (chan->type == IIO_LIGHT) {
*val = gainadj[chip->als_settings.als_gain].mean;
ret = IIO_VAL_INT;
} break; case IIO_CHAN_INFO_INT_TIME: if (chan->type == IIO_LIGHT) {
*val = 0;
*val2 = chip->als_settings.als_time;
ret = IIO_VAL_INT_PLUS_MICRO;
} break; default: break;
}
read_done:
mutex_unlock(&chip->als_mutex);
if (ret < 0) {
tsl2583_set_pm_runtime_busy(chip, false); return ret;
}
/* * Preserve the ret variable if the call to * tsl2583_set_pm_runtime_busy() is successful so the reading * (if applicable) is returned to user space.
*/
pm_ret = tsl2583_set_pm_runtime_busy(chip, false); if (pm_ret < 0) return pm_ret;
return ret;
}
staticint tsl2583_write_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int val, int val2, long mask)
{ struct tsl2583_chip *chip = iio_priv(indio_dev); int ret;
ret = tsl2583_set_pm_runtime_busy(chip, true); if (ret < 0) return ret;
mutex_lock(&chip->als_mutex);
ret = -EINVAL; switch (mask) { case IIO_CHAN_INFO_CALIBBIAS: if (chan->type == IIO_LIGHT) {
chip->als_settings.als_gain_trim = val;
ret = 0;
} break; case IIO_CHAN_INFO_CALIBSCALE: if (chan->type == IIO_LIGHT) { unsignedint i;
for (i = 0; i < ARRAY_SIZE(gainadj); i++) { if (gainadj[i].mean == val) {
chip->als_settings.als_gain = i;
ret = tsl2583_set_als_gain(chip); break;
}
}
} break; case IIO_CHAN_INFO_INT_TIME: if (chan->type == IIO_LIGHT && !val && val2 >= 50 &&
val2 <= 650 && !(val2 % 50)) {
chip->als_settings.als_time = val2;
ret = tsl2583_set_als_time(chip);
} break; default: break;
}
mutex_unlock(&chip->als_mutex);
if (ret < 0) {
tsl2583_set_pm_runtime_busy(chip, false); return ret;
}
ret = tsl2583_set_pm_runtime_busy(chip, false); if (ret < 0) return ret;
ret = i2c_smbus_read_byte_data(clientp,
TSL2583_CMD_REG | TSL2583_CHIPID); if (ret < 0) {
dev_err(&clientp->dev, "%s: failed to read the chip ID register\n", __func__); return ret;
}
if ((ret & TSL2583_CHIP_ID_MASK) != TSL2583_CHIP_ID) {
dev_err(&clientp->dev, "%s: received an unknown chip ID %x\n",
__func__, ret); return -EINVAL;
}
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.