1 /* 2 * Place-holder Header for Documentation and future API change 3 * 4 * Copyright (c) 2014 Intel Corporation. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining 7 * a copy of this software and associated documentation files (the 8 * "Software"), to deal in the Software without restriction, including 9 * without limitation the rights to use, copy, modify, merge, publish, 10 * distribute, sublicense, and/or sell copies of the Software, and to 11 * permit persons to whom the Software is furnished to do so, subject to 12 * the following conditions: 13 * 14 * The above copyright notice and this permission notice shall be 15 * included in all copies or substantial portions of the Software. 16 * 17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 18 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 20 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 21 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 22 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 23 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 24 */ 25 26 /** 27 * @library grove 28 * @sensor grovelight 29 * @comname Grove Light Sensor 30 * @type light 31 * @man seeed 32 * @con analog 33 * @kit gsk 34 * 35 * @brief API for the Grove Light Sensor 36 * 37 * The Grove light sensor detects the intensity of the ambient light. 38 * As the light intensity of the environment increases, the resistance 39 * of the sensor decreases. This means the raw value from the 40 * analog pin is larger in bright light and smaller in the dark. 41 * An approximate lux value can also be returned. 42 * 43 * @image html grovelight.jpg 44 * @snippet grovelight.cxx Interesting 45 */ 46 47