weatherstation/firmware/libraries/APDS9930-master

APDS9930 Ambient Light and Proximity sensor

This is a fork of the library from Sparkfun for the APDS-9960 sensor. It has been adapted to read values from this other model.

Quick-start guide available here

Purchase an Avago APDS-9930 Breakout Board here

DO NOT EMAIL ME IF YOU HAVE AN ISSUE

It will be deleted without reading. If you have an issue, create an issue here on GitHub.

Unmaintained

I'm not going to maintain this library any more. I will merge pull requests, though. Contributions are welcome. Just don't expect anything from me.

Note: even though it says APDS-9960, it's an APDS-9930. That's how I ended up getting one of those. I wanted the RGB sensor. I found this crap in my mailbox. But I decided to write a library for it anyways ;)

Getting Started

• Download the Git repository as a ZIP ("Download ZIP" button)
• Unzip
• Copy the entire library directory (APDS-9930) to <Arduino installation directory>/libraries
• Open the Arduino program
• Select File -> Examples -> APDS9930 -> GestureTest
• Plug in your Arduino and APDS-9930 with the following connections

-OR-

• Use the library manager

Arduino Pin	APDS-9930 Board	Function
3.3V	VCC	Power
GND	GND	Ground
A4	SDA	I²C Data
A5	SCL	I²C Clock
2	INT	Interrupt

P.S.: you already know you can't use this purple little thing with your 5V Arduino without a level shifter, right? :) In case you don't have a level shifter, you can detach the microcontroller from an Arduino Uno, reconnect the oscillator pins, the RX and TX pins, the reset and the LED/SCK pins back to the board with some jumper wires. You can then power the microcontroller from a 3.3V source (the 3V3 output on the board should work) and connect the sensor directly to the MCU. Look up "Arduino on Breadboard".

• Go to Tools -> Board and select your Arduino board
• Go to Tools -> Serial Port and select the COM port of your Arduino board
• Click "Upload"
• Go to Tools -> Serial Monitor
• Ensure the baud rate is set at 9600 baud
• Swipe your hand over the sensor in various directions!

Repository Contents

• /examples - Example sketches for the library (.ino). Run these from the Arduino IDE.
• /extras - Additional documentation for the user. These files are ignored by the IDE.
• /src - Source files for the library (.cpp, .h).
• keywords.txt - Keywords from this library that will be highlighted in the Arduino IDE.
• library.properties - General library properties for the Arduino package manager.

Documentation

• Quickstart Guide - Basic hookup guide for the sensor.
• Product Repository - Main repository (including hardware files) for the APDS9930 ambient light and proximity sensor.
• Installing an Arduino Library Guide - Basic information on how to install an Arduino library.

Version History

• master - Adapted for use with APDS-9930
• V_1.4.0 - Updated to new library structure
• V_1.3.0 - Implemented disableProximitySensor(). Thanks to jmg5150 for catching that!
• V_1.2.0 - Added pinMode line to GestureTest demo to fix interrupt bug with some Arduinos
• V_1.1.0 - Updated GestureTest demo to not freeze with fast swipes
• V_1.0.0: Initial release
• Ambient and RGB light sensing implemented
• Ambient light interrupts working
• Proximity sensing implemented
• Proximity interrupts working

License Information

This product is open source!

Please use, reuse, and modify these files as you see fit. Please maintain attribution to SparkFun Electronics and release anything derivative under the same license.

Distributed as-is; no warranty is given.

• Your friends at SparkFun. And Davide Depau :*