ldt0028.h File Reference

Include dependency graph for ldt0028.h:

API Description

/*
 * Author: Noel Eck <noel.eck@intel.com>
 * Copyright (c) 2016 Intel Corporation.
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

#include <unistd.h>
#include <signal.h>

#include "ldt0028.h"
#include "upm_utilities.h"

bool shouldRun = true;

void sig_handler(int signo)
{
    if (signo == SIGINT)
        shouldRun = false;
}

int main()
{
    signal(SIGINT, sig_handler);


    // Instantiate a ldt0028 sensor on analog pin A0
    ldt0028_context sensor = ldt0028_init(0);

    if (!sensor)
    {
        printf("ldt0028_init() failed.\n");
        return -1;
    }

    // Set the aref, scale, and offset
    ldt0028_set_aref(sensor, 5.0);
    ldt0028_set_scale(sensor, 1.0);
    ldt0028_set_offset(sensor, -.1);
    printf("aRef: %0.03f scale: %0.03f offset: %0.03f\n\n",
            ldt0028_get_aref(sensor),
            ldt0028_get_scale(sensor),
            ldt0028_get_offset(sensor));

    float normalized = 0.0;
    float raw_volts = 0.0;
    float volts = 0.0;

    float norm_base = 0.1;

    printf("Using normalized sensor output average == %f\n", norm_base);

    // Every half a second, sample the sensor output
    while (shouldRun)
    {

        ldt0028_get_normalized(sensor, &normalized);
        ldt0028_get_raw_volts(sensor, &raw_volts);
        ldt0028_get_volts(sensor, &volts);

        if (normalized > norm_base)
        {
            printf("Detected vibration!\n");
            printf("Normalized output: %0.03f, raw ldt0028 sensor output: %0.03f v "
                    "adjusted output: %0.03f v\n\n", normalized, raw_volts, volts);
        }

        upm_delay_ms(500);
    }


    printf("Exiting\n");

    ldt0028_close(sensor);

    return 0;
}

Go to the source code of this file.

Data Structures
struct	_ldt0028_context

Functions
ldt0028_context	ldt0028_init (int16_t pin)
void	ldt0028_close (ldt0028_context dev)
upm_result_t	ldt0028_set_aref (const ldt0028_context dev, float aref)
upm_result_t	ldt0028_set_scale (const ldt0028_context dev, float scale)
upm_result_t	ldt0028_set_offset (const ldt0028_context dev, float offset)
float	ldt0028_get_aref (const ldt0028_context dev)
float	ldt0028_get_scale (const ldt0028_context dev)
float	ldt0028_get_offset (const ldt0028_context dev)
upm_result_t	ldt0028_get_normalized (const ldt0028_context dev, float *value)
upm_result_t	ldt0028_get_raw_volts (const ldt0028_context dev, float *value)
upm_result_t	ldt0028_get_volts (const ldt0028_context dev, float *value)

Typedefs
typedef struct _ldt0028_context *	ldt0028_context

Function Documentation

ldt0028_context ldt0028_init

(

int16_t

pin

)

Initialize analog sensor

Parameters

pin	Analog pin

Returns

sensor context

void ldt0028_close

(

ldt0028_context

dev

)

Analog sensor destructor

Parameters

sensor

context pointer

upm_result_t ldt0028_set_aref	(	const ldt0028_context	dev,
		float	aref
	)

Set ADC reference voltage

Parameters

dev	sensor context pointer
aref	ADC reference voltage

Returns

Function result code

upm_result_t ldt0028_set_scale	(	const ldt0028_context	dev,
		float	scale
	)

Set sensor scale. This scale is applied to the return value: counts = counts * scale

Parameters

dev	sensor context pointer
scale	count scale value used

Returns

Function result code

upm_result_t ldt0028_set_offset	(	const ldt0028_context	dev,
		float	offset
	)

Set sensor offset. This offset is applied to the return value: value = value + offset

Parameters

dev	sensor context pointer
offset	count offset value used

Returns

Function result code

float ldt0028_get_aref

(

const ldt0028_context

dev

)

Get sensor aref

Parameters

dev	sensor context pointer

Returns

Sensor ADC reference voltage

float ldt0028_get_scale

(

const ldt0028_context

dev

)

Get sensor scale

Parameters

dev	sensor context pointer

Returns

Sensor scale

float ldt0028_get_offset

(

const ldt0028_context

dev

)

Get sensor offset

Parameters

dev	sensor context pointer

Returns

Sensor offset

upm_result_t ldt0028_get_normalized	(	const ldt0028_context	dev,
		float *	value
	)

Read normalized value for sensor

Parameters

dev	sensor context pointer
*value	Normalized value (0.0 -> 1.0)

Returns

Function result code

upm_result_t ldt0028_get_raw_volts	(	const ldt0028_context	dev,
		float *	value
	)

Read raw voltage from the sensor

Parameters

dev	sensor context pointer
*value	Raw sensor voltage

Returns

Function result code

upm_result_t ldt0028_get_volts	(	const ldt0028_context	dev,
		float *	value
	)

Read scaled/offset voltage from the sensor

Parameters

dev	sensor context pointer
*value	Adjusted sensor voltage

Returns

Function result code

Typedef Documentation

typedef struct _ldt0028_context * ldt0028_context

driver context