adafruit-circuitpython-apds9960 1.2.4

从pypi安装

在支持的gnu/linux系统（如raspberry pi）上，可以在本地安装驱动程序from PyPI。为当前用户安装：

pip3 install adafruit-circuitpython-apds9960

要在系统范围内安装（在某些情况下可能需要安装）：

sudo pip3 install adafruit-circuitpython-apds9960

在当前项目的虚拟环境中安装：

mkdir project-name &&cd project-name
python3 -m venv .env
source .env/bin/activate
pip3 install adafruit-circuitpython-apds9960

硬件设置

将车辆识别号连接到3.3伏或5伏电源，接地连接到接地，将SCL和SDA连接到相应的针脚。

基础知识

当然，您必须导入I2C总线设备、板插脚和库：

fromboardimportSCL,SDA,A1fromadafruit_apds9960.apds9960importAPDS9960importbusioimportdigitalio

要设置设备以收集数据，请使用SCL初始化I2C设备 和SDA管脚。然后初始化库。可选地提供中断 用于邻近检测的PIN。

int_pin=digitalio.DigitalInOut(A1)i2c=busio.I2C(SCL,SDA)apds=APDS9960(i2c,interrupt_pin=int_pin)

手势

要获取手势，请先查看手势是否可用，然后获取手势代码

gesture=apds.gesture()ifgesture==1:print("up")ifgesture==2:print("down")ifgesture==3:print("left")ifgesture==4:print("right")

颜色测量

要获取颜色度量，请启用颜色度量，等待颜色数据， 然后获取颜色数据。

apds.enable_color=Truewhilenotapds.color_data_ready:time.sleep(0.005)r,g,b,c=apds.color_dataprint("r: {}, g: {}, b: {}, c: {}".format(r,g,b,c))

邻近检测< EH3> 要检查接近的对象，先查看是否有可用的手势，然后获得手势代码< >

apds.enable_proximity=True# set the interrupt threshold to fire when proximity reading goes above 175apds.proximity_interrupt_threshold=(0,175)# enable the proximity interruptapds.enable_proximity_interrupt=TruewhileTrue:ifnotinterrupt_pin.value:print(apds.proximity())# clear the interruptapds.clear_interrupt()

斯芬克斯文件

sphinx用于根据代码中的rst文件和注释构建文档。第一， 安装依赖项（请随意重用上面的虚拟环境）：

python3 -m venv .env
source .env/bin/activate
pip install Sphinx sphinx-rtd-theme

现在，激活虚拟环境后：

cd docs
sphinx-build -E -W -b html . _build/html

这将把文档输出到docs/_build/html。在浏览器中打开index.html以 查看它们。它还将（由于-w）错误的任何警告，像特拉维斯将。这是个很好的方法 本地验证它将通过。