grove: improve docstrings

Signed-off-by: Sarah Knepper <sarah.knepper@intel.com>
Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>
This commit is contained in:
Sarah Knepper 2014-12-04 10:41:32 +00:00 committed by Brendan Le Foll
parent a1abab8909
commit 751b0f1fe0
2 changed files with 6 additions and 5 deletions

View File

@ -105,7 +105,7 @@ GroveLight::~GroveLight()
mraa_aio_close(m_aio);
}
int GroveLight::value ()
int GroveLight::value()
{
// rough conversion to lux, using formula from Grove Starter Kit booklet
float a = (float) mraa_aio_read(m_aio);

View File

@ -1,6 +1,7 @@
/*
* Author: Brendan Le Foll <brendan.le.foll@intel.com>
* Contributions: Mihai Tudor Panu <mihai.t.panu@intel.com>
* Contributions: Sarah Knepper <sarah.knepper@intel.com>
* Copyright (c) 2014 Intel Corporation.
*
* Permission is hereby granted, free of charge, to any person obtaining
@ -103,7 +104,7 @@ class GroveTemp: public Grove {
/**
* @brief C++ API for Grove light sensor
*
* Very basic UPM module for grove Light sensor on analog
* Very basic UPM module for Grove light sensor on analog
*
* @ingroup grove analog
* @snippet grovelight.cxx Interesting
@ -113,7 +114,7 @@ class GroveLight: public Grove {
/**
* Grove analog light sensor constructor
*
* @param analog pin to use
* @param pin analog pin to use
*/
GroveLight(unsigned int pin);
/**
@ -127,9 +128,9 @@ class GroveLight: public Grove {
*/
float raw_value();
/**
* Get the light value from the sensor
* Get the approximate light value, in lux, from the sensor
*
* @return the normalised light reading
* @return the normalized light reading in lux
*/
int value();
private: