https://github.com/liske/python-apds9960
Python APDS-9960 Library
https://github.com/liske/python-apds9960
Last synced: 2 months ago
JSON representation
Python APDS-9960 Library
- Host: GitHub
- URL: https://github.com/liske/python-apds9960
- Owner: liske
- License: gpl-3.0
- Created: 2017-06-05T22:29:05.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-31T20:56:12.000Z (almost 3 years ago)
- Last Synced: 2024-03-14T22:53:06.300Z (about 1 year ago)
- Language: Python
- Size: 36.1 KB
- Stars: 76
- Watchers: 7
- Forks: 26
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
Awesome Lists containing this project
README
# Python (and MicroPython) APDS-9960 Library
Python library for the APDS-9960 gesture sensor developed while I was looking to get the APDS-9960 to work with a _Raspberry Pi_ to build a user interface feeling like in _Minority Report_.
This library is a port of the [APDS-9960 Raspberry Pi Library](https://bitbucket.org/justin_woodman/apds-9960-raspberry-pi-library) of [Justin Woodman](https://justinwoodman.wordpress.com/2014/11/15/using-the-apds-9960-rgb-proximity-and-gesture-sensor-with-the-raspberry-pi-2/). Sadly his library is coded in C++ and seems not to be maintained any more.
This library has been tested with [SparkFun RGB and Gesture Sensor - APDS-9960](https://www.sparkfun.com/products/12787) but should work with any other APDS-9960 based I²C device, too.
## Installation
This library is available from [PyPi](https://pypi.org/project/apds9960/). You may want to setup a `virtualenv` before installing the library using:
```
pip install apds9960
```
## Features of the APDS-9960
- operational voltage: 3.3V
- ambient light & RGB color sensing
- proximity sensing
- gesture detection
- operating range: 10 - 20cm
- I²C interface (hard wired I²C address: 0x39)
## Documentation & Examples
- [RPi](RPi.md) - connect and configure the APDS-9960 on Raspberry Pi
- Example scripts:
- simple ambient light level demo: [rpi](rpi/test_ambient.py), [micropython](micropython/test_ambient.py)
- simple gesture detection demo: [rpi](rpi/test_gesture.py), [micropython](micropython/test_gesture.py)
- simple proximity level demo: [rpi](rpi/test_prox.py), [micropython](micropython/test_prox.py)