samples: apds9960: move under sensors and update docs

Change-Id: I8e5735f15dbba5b9fead8f677104843a947b28ca
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
This commit is contained in:
Anas Nashif 2017-01-10 11:58:06 -05:00 committed by Anas Nashif
parent 2bc9d69981
commit eeb6a30f29
6 changed files with 50 additions and 25 deletions

View File

@ -0,0 +1,50 @@
RGB and Gesture Sensor
######################
Overview
========
This sample utilizes APDS-9960 Sensor and reads RGB values from the sensor
then displays the color through the APA102C LED.
.. note::
This sample does not use the Zephyr sensor APIs
Wiring
======
The SparkFun RGB and Gesture Sensor was being used:
- https://www.sparkfun.com/products/12787
- https://www.adafruit.com/product/2343
For APA102C, on the sensor subsystem (ARC) side of Arduino 101:
1. GPIO_SS_2 is on AD0 (for APA102C data)
2. GPIO_SS_3 is on AD1 (for APA102C clock)
The GPIO driver is being used for bit-banging to control the APA102C LED.
The APA102/C requires 5V data and clock signals, so logic level shifter
(preferred) or pull-up resistors are needed. Make sure the pins are 5V
tolerant if using pull-up resistors.
.. important::
The APA102C are very bright even at low settings. Protect your eyes
and do not look directly into those LEDs.
Building and Running
====================
This sample can be built for multiple boards, in this example we will build it
for the Arduino 101 board:
.. code-block:: console
$ cd samples/sensors/apds9960
$ make BOARD=arduino_101_sss
$ make BOARD=arduino_101_sss flash # with JTAG
.. or
$ dfu-util -a sensor_core -D outdir/arduino_101_sss/zephyr.bin # with DFU

View File

@ -14,31 +14,6 @@
* limitations under the License.
*/
/**
* @file Sample app to utilize APDS-9960 Sensor on Arduino 101 (ARC).
*
* The SparkFun RGB and Gesture Sensor was being used:
* https://www.sparkfun.com/products/12787
*
* This sample app is to read RGB value from the APDS-9960 sensor
* and to display the color through the APA102C LED.
*
* For APA102C, on ARC side of Arduino 101:
* 1. GPIO_SS_2 is on AD0 (for APA102C data)
* 2. GPIO_SS_3 is on AD1 (for APA102C clock)
*
* The gpio_dw driver is being used for bit-banging to control
* the APA102C LED..
*
* The APA102/C requires 5V data and clock signals, so logic
* level shifter (preferred) or pull-up resistors are needed.
* Make sure the pins are 5V tolerant if using pull-up
* resistors.
*
* WARNING: the APA102C are very bright even at low settings.
* Protect your eyes and do not look directly into those LEDs.
*/
#include <zephyr.h>
#include <stdio.h>
#include <device.h>