zephyr/samples/sensor/apds9960
Anas Nashif 3c50f7aa12 tests: samples: remove duplicate filtering
We have many testcases doing filtering both on the architecture level
and the platform level, which is redundant. Also many testcases are
running the same test twice on the same SoC for no good reason, cleanup
the tests and cleanup the filtering.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2017-06-27 17:44:23 -04:00
..
src
Makefile
prj.conf
README.rst
sample.yaml tests: samples: remove duplicate filtering 2017-06-27 17:44:23 -04:00

.. _apds9960-sample:

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