APDS9960传感器

从APDS9960 I2C传感器读取接近度、手势、环境光和RGB颜色数据

全部展开页面

库:
金宝appSimu金宝applink支持包Arduino硬件/传感器

描述

的APDS9960传感器块检测接近度，提供方向数据解码手势，并从与Arduino接口的APDS9960传感器测量环境和颜色(RGB)值^®硬件与中断驱动的I2C通信。您可以使用轮询或中断模式从APDS9960 I2C传感器获取数据。

请注意

为中断数据采集方式，将模块置于函数调用子系统中外部中断块。

请注意

如果您使用Arduino Nano 33 BLE Sense硬件(它总是包含一个嵌入式传感器)，则不支持从包含APDS9960传感器的接线板读取数据。金宝app

港口

输出

全部展开

接近

`接近`-距离数据
范围内的正标量[`0`，`255`］

该块输出的接近数据为范围内的正标量[0，255),0表示距离传感器和最远的对象255表示距离传感器最近的对象。

依赖关系

启用该端口。

集传感器模式来接近．
集传感器模式来接近，环境光和颜色．

数据类型:uint8

手势

`GFIFO_U`—向上检测手势数据
向量

该模块将传感器检测到的向上方向的手势数据输出为a1——- - - - - -N向量,N为向上手势数的阈值。

依赖关系

启用该端口。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

数据类型:uint8

`GFIFO_D`—向下检测手势数据
向量

该模块将传感器检测到的向下方向的手势数据输出为a1——- - - - - -N向量,N为向下手势数的阈值。

依赖关系

启用该端口。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

数据类型:uint8

`GFIFO_L`-手势数据检测向左
向量

该模块将传感器检测到的手势数据输出到左边的位置1——- - - - - -N向量,N是朝向左边的手势数的阈值。

依赖关系

启用该端口。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

数据类型:uint8

`GFIFO_R`-向右检测到手势数据
向量

该模块将传感器检测到的手势数据输出到右侧作为a1——- - - - - -N向量,N是向右的手势数的阈值。

依赖关系

启用该端口。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

数据类型:uint8

环境光和颜色

`环境`-环境光数据
范围内的正标量[`0`，`65535`］

块输出环境光强数据为范围内的正标量[0，65535),0表示最低环境光强和65535表示最高的环境光强。

依赖关系

启用该端口。

集传感器模式来环境光和颜色．
集传感器模式来接近，环境光和颜色．
集传感器模式来手势，环境光和颜色．

数据类型:uint16

`RGB`-色彩强度数据
向量

块输出颜色光强度数据为3 × 1向量。

依赖关系

启用该端口。

集传感器模式来环境光和颜色．
集传感器模式来接近，环境光和颜色．
集传感器模式来手势，环境光和颜色．

数据类型:uint16

状态

`状态`-输出端口是否有新数据
标量

块输出新数据可用性的状态取决于传感器模式作为标量或a1——- - - - - -2向量的值0和1．

0:自上次读周期以来，传感器输出端口无新数据可用。
1:表示从上次读周期开始，传感器输出端口有新的数据可用。

例如，如果您选择传感器模式作为接近时，块在端口输出标量值。类似地，如果您选择传感器模式作为接近，环境光和颜色时，块输出a1——- - - - - -2向量，其中第一个元素对应于接近传感器模式和后面的元素对应于环境光和颜色传感器模式。

这个表列出了输出端口上可用的状态输出，这取决于传感器模式你选择。

传感器模式	状态端口输出
`接近`	接近
`手势`	手势
`环境光和颜色`	环境光和颜色
`接近，环境光和颜色`	接近环境光和颜色
`手势，环境光和颜色`	手势环境光和颜色

依赖关系

要启用该端口，请选择启用状态输出．

数据类型:uint8

参数

全部展开

每个APDS9960 IMU传感器模式既有基本和先进的参数。页签中的参数都可以配置块的参数对话框的每个传感器模式，您选择以适合您的需求和功能区域。

例如，如果您选择传感器模式作为接近，环境光和颜色,基本和先进的标签的块的参数对话框将包含适用于两个接近，环境光和颜色传感器模式。您可以在这两个选项卡中配置参数。

基本

常见的

`传感器模式`—传感器模式类型
`接近`(默认)|`手势`|`环境光和颜色`|`接近，环境光和颜色`|`手势，环境光和颜色`

选择传感器的工作模式。

`数据采集模式`-数据采集方式
`轮询`(默认)|`中断`

选择数据采集方式。

请注意

在手势模式下，传感器可以在中断模式，与一个新的手势输入作为中断源。

`启用状态输出`-输出端口数据的可用性
关闭(默认)|开启

选择该参数启用状态输出端口。

`样品时间`—块读取数据的时间间隔
`０.１`(默认)|标量

输入块从APDS9960 IMU传感器读取值的秒间隔。

接近

`中断阈值[低，高]`-产生中断的接近阈值
`[0, 50]`(默认)|范围内的1 × 2向量`[0, 255)`

当接近值分别超过或低于高中断阈值和低中断阈值时，生成中断。

依赖关系

启用该参数。

集传感器模式来接近和数据采集模式来中断．
集传感器模式来接近，环境光和颜色和数据采集模式来中断．

`中断的持久性`-控制接近中断率
`2`(默认)|正整数

属性中指定的范围之外的连续接近值才断言接近中断中断阈值[低，高]参数。这可以防止块生成假中断。使用此参数指定在中断阈值之外有多少连续的接近值之后，块应该生成接近中断。例如，设置为2时，当两个连续的接近值超出您在中断阈值[低，高]参数。

依赖关系

启用该参数。

集传感器模式来接近和数据采集模式来中断．
集传感器模式来接近，环境光和颜色和数据采集模式来中断．

手势

`输入和退出阈值[Enter, exit]`—生成中断的手势阈值
`(40岁,30)`(默认)|范围内的1 × 2向量`[0, 255)`

设置阈值以确定手势的开始和结束点。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

`中断的FIFO阈值`—手势FIFO阈值
`4数据集`(默认)|`数据集1`|`8数据集`|`16个数据集`

在此参数中选择的值等于FIFO中可用的数据集的数量后，生成一个手势中断。例如，设置为4数据集，在FIFO中有四个数据集可用后，块生成一个手势中断。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

`退出的持久性`-手势退出控制速率
`1日的姿态结束`(默认)|`2日姿态结束`|`4日的姿态结束`|`7日的姿态结束`

属性中指定的连续手势值范围之外时，断言手势中断输入和退出阈值[Enter, exit]参数。这可以防止块生成假中断。使用此参数指定在中断阈值之外有多少个连续的手势值之后，块应该生成一个手势中断。例如，当您选择4日的姿态结束，当四个连续的手势值超出您在输入和退出阈值[Enter, exit]参数。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

环境光和颜色

`中断阈值[低，高]`-环境光阈值产生中断
`(65535 0)`(默认)|范围内的1 × 2向量`[0, 65535)`

当环境光和颜色强度数据分别超过或低于高中断阈值和低中断阈值时，生成中断。

依赖关系

启用该参数。

集传感器模式来环境光和颜色和数据采集模式来中断．
集传感器模式来接近，环境光和颜色和数据采集模式来中断,中断源来环境光和颜色．

`中断的持久性`-控制环境光和颜色中断率
`2`(默认)|正标量

断言环境光和颜色中断到传感器只有在连续出中断阈值[低，高]值等于或大于此参数中设置的值。这可以防止块生成假中断。例如，设置为2时，当两个连续的环境光和颜色值超出您在中设置的范围时，块产生中断中断阈值[低，高]参数。

依赖关系

启用该参数。

集传感器模式来环境光和颜色和数据采集模式来中断．
集传感器模式来接近，环境光和颜色和数据采集模式来中断,中断源作为环境光和颜色．

接近，环境光和颜色

`中断源`-中断源
`接近`(默认)|`环境光和颜色`

选择传感器的中断源。

依赖关系

要启用该参数，请设置传感器模式来接近，环境光和颜色,数据采集模式来中断．

先进的

接近

`获得`-接近增益控制
`4 x`(默认)|`1 x`|`2 x`|`8倍`

选择增益为接近数据值。

依赖关系

启用该参数。

集传感器模式来接近．
集传感器模式来接近，环境光和颜色．

`脉冲持续时间`-每个接近脉冲长度的时间周期
`16μs`(默认)|`4μs`|`8μs`|`32μs`

选择红外LED发射脉冲序列中每个脉冲的开启时间。

依赖关系

启用该参数。

集传感器模式来接近．
集传感器模式来接近，环境光和颜色．

`脉冲计数`- LDR产生的接近脉冲数
`8`(默认)|范围内的正标量[`1`来`64`］

指定光依赖电阻(LDR)应该产生的脉冲数。LDR产生的脉冲数是脉冲计数值加1。例如，如果您将脉冲计数值设置为8， LDR产生9个脉冲。

依赖关系

启用该参数。

集传感器模式来接近．
集传感器模式来接近，环境光和颜色．

`补偿(UR, DL)`-上-右和下-左光电二极管的接近偏移
`(0,0)`(默认)|范围内的1 × 2向量`(255、255)`

为上下左右光电二极管对设置可伸缩的内部偏移校正因子。

依赖关系

启用该参数。

集传感器模式来接近．
集传感器模式来接近，环境光和颜色．

接近，环境光和颜色

`领导的推动力量`-控制LED红外发射强度
`100毫安`(默认)|`马50`|`25马`|`12.5马`

选择LED IR发射的当前水平来控制强度水平。

依赖关系

启用该参数。

集传感器模式来接近．
集传感器模式来接近，环境光和颜色．

距离和姿态

`领导提高电流`-额外的强度增强LED红外发射
`100％`(默认)|`150％`|`200％`|`300％`

为LED IR发射指定额外的当前升压水平，以检测远程设备。

依赖关系

启用该参数。

集传感器模式来接近．
集传感器模式来手势．
集传感器模式来接近，环境光和颜色．

手势

`偏移量[U, D, L, R]`-上、下、左、右光电二极管的手势偏移
`[0, 0, 0, 0]`(默认)| 1 × 4向量`[255, 255, 255, 255]`

为上、下、左、右光电二极管设置一个可伸缩的内部偏移校正因子。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

`领导的推动力量`-控制LED红外发射强度
`100毫安`(默认)|`马50`|`25马`|`12.5马`

选择LED IR发射的当前水平来控制强度水平。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

`获得`-手势增益控制
`4 x`(默认)|`1 x`|`2 x`|`8倍`

选择手势数据值的增益。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

`脉冲持续时间`—每个手势脉冲长度的时间周期
`32μs`(默认)|`4μs`|`8μs`|`16μs`

选择红外LED发射脉冲序列中每个脉冲的开启时间。

依赖关系

若要启用该参数，

集传感器模式作为手势．
集传感器模式作为手势，环境光和颜色．

`脉冲计数`—LDR产生的手势脉冲数
`10`(默认)|正标量

指定光依赖电阻(LDR)应该产生的脉冲数。LDR产生的脉冲数是脉冲计数值加1。例如，如果您设置脉冲计数值10时，LDR生成11脉冲。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

`等待时间`-手势检测周期之间的时间
`2.8毫秒`(默认)|`0女士`|`5.6毫秒`|`8.4毫秒`|`14个女士`|`22.4毫秒`|`30.8毫秒`|`39.2毫秒`

通过选择手势等待时间来延迟脉冲序列重复。该参数控制传感器在手势检测周期之间的低功耗模式下花费的时间。包括一个等待时间，以减少传感器的功耗，并使数据采集更有效。

依赖关系

启用该参数。

集传感器模式来手势．
集传感器模式来手势，环境光和颜色．

环境光和颜色

`获得`-环境光和颜色增益控制
`4 x`(默认)|`1 x`|`16 x`|`64 x`

为环境光和颜色数据值选择增益。

依赖关系

启用该参数。

集传感器模式来环境光和颜色．
集传感器模式来接近，环境光和颜色．
集传感器模式来手势，环境光和颜色．

`ADC集成时间(ms)`-控制环境光和彩色模拟到数字转换器的集成时间
`219`(默认)|正标量

使用此参数指定来自颜色和环境光光电二极管的数据累积的时间。

依赖关系

启用该参数。

集传感器模式来环境光和颜色．
集传感器模式来接近，环境光和颜色．
集传感器模式来手势，环境光和颜色．

`在环境光传感之前启用等待`-激活等待功能，传感器开始读取环境光和颜色
关闭(默认)|开启

在传感器开始读取环境光和颜色之前，激活等待功能。

依赖关系

启用该参数。

集传感器模式来环境光和颜色．
集传感器模式来接近，环境光和颜色．
集传感器模式来手势，环境光和颜色．

`等待时间(毫秒)`-等待时间，传感器开始读取环境光和颜色
`246`(默认)|正标量

输入传感器开始读取环境光和颜色之前的等待时间。

依赖关系

要启用该参数，请选择在环境光传感之前启用等待．

`开启长时间等待(12x)`增加12倍的等待时间
关闭(默认)|开启

中设置的等待时间等待时间(毫秒)参数的倍数为12x。

依赖关系

启用该参数。

集传感器模式来环境光和颜色．
集传感器模式来接近，环境光和颜色．
集传感器模式来手势，环境光和颜色．

介绍了R2021a

APDS9960传感器

描述

港口

输出

接近-距离数据范围内的正标量[0，255］

依赖关系

GFIFO_U—向上检测手势数据向量

依赖关系

GFIFO_D—向下检测手势数据向量

依赖关系

GFIFO_L-手势数据检测向左向量

依赖关系

GFIFO_R-向右检测到手势数据向量

依赖关系

环境-环境光数据范围内的正标量[0，65535］

依赖关系

RGB-色彩强度数据向量

依赖关系

状态-输出端口是否有新数据标量

依赖关系

参数

基本

传感器模式—传感器模式类型接近(默认)|手势|环境光和颜色|接近，环境光和颜色|手势，环境光和颜色

数据采集模式-数据采集方式轮询(默认)|中断

启用状态输出-输出端口数据的可用性关闭(默认)|开启

样品时间—块读取数据的时间间隔０.１(默认)|标量

中断阈值[低，高]-产生中断的接近阈值[0, 50](默认)|范围内的1 × 2向量[0, 255)

依赖关系

中断的持久性-控制接近中断率2(默认)|正整数

依赖关系

输入和退出阈值[Enter, exit]—生成中断的手势阈值(40岁,30)(默认)|范围内的1 × 2向量[0, 255)

依赖关系

中断的FIFO阈值—手势FIFO阈值4数据集(默认)|数据集1|8数据集|16个数据集

依赖关系

退出的持久性-手势退出控制速率1日的姿态结束(默认)|2日姿态结束|4日的姿态结束|7日的姿态结束

依赖关系

中断阈值[低，高]-环境光阈值产生中断(65535 0)(默认)|范围内的1 × 2向量[0, 65535)

依赖关系

中断的持久性-控制环境光和颜色中断率2(默认)|正标量

依赖关系

中断源-中断源接近(默认)|环境光和颜色

依赖关系

先进的

获得-接近增益控制4 x(默认)|1 x|2 x|8倍

依赖关系

脉冲持续时间-每个接近脉冲长度的时间周期16μs(默认)|4μs|8μs|32μs

依赖关系

脉冲计数- LDR产生的接近脉冲数8(默认)|范围内的正标量[1来64］

依赖关系

补偿(UR, DL)-上-右和下-左光电二极管的接近偏移(0,0)(默认)|范围内的1 × 2向量(255、255)

依赖关系

领导的推动力量-控制LED红外发射强度100毫安(默认)|马50|25马|12.5马

依赖关系

领导提高电流-额外的强度增强LED红外发射100％(默认)|150％|200％|300％

依赖关系

偏移量[U, D, L, R]-上、下、左、右光电二极管的手势偏移[0, 0, 0, 0](默认)| 1 × 4向量[255, 255, 255, 255]

依赖关系

领导的推动力量-控制LED红外发射强度100毫安(默认)|马50|25马|12.5马

依赖关系

获得-手势增益控制4 x(默认)|1 x|2 x|8倍

依赖关系

脉冲持续时间—每个手势脉冲长度的时间周期32μs(默认)|4μs|8μs|16μs

依赖关系

脉冲计数—LDR产生的手势脉冲数10(默认)|正标量

依赖关系

等待时间-手势检测周期之间的时间2.8毫秒(默认)|0女士|5.6毫秒|8.4毫秒|14个女士|22.4毫秒|30.8毫秒|39.2毫秒

依赖关系

获得-环境光和颜色增益控制4 x(默认)|1 x|16 x|64 x

依赖关系

ADC集成时间(ms)-控制环境光和彩色模拟到数字转换器的集成时间219(默认)|正标量

依赖关系

在环境光传感之前启用等待-激活等待功能，传感器开始读取环境光和颜色关闭(默认)|开启

依赖关系

等待时间(毫秒)-等待时间，传感器开始读取环境光和颜色246(默认)|正标量

依赖关系

开启长时间等待(12x)增加12倍的等待时间关闭(默认)|开启

依赖关系

金宝appArdu金宝appino硬件文档的Simulink支持包

金宝app

基于模型的嵌入式控制系统设计

`接近`-距离数据
范围内的正标量[`0`，`255`］

`GFIFO_U`—向上检测手势数据
向量

`GFIFO_D`—向下检测手势数据
向量

`GFIFO_L`-手势数据检测向左
向量

`GFIFO_R`-向右检测到手势数据
向量

`环境`-环境光数据
范围内的正标量[`0`，`65535`］

`RGB`-色彩强度数据
向量

`状态`-输出端口是否有新数据
标量

`传感器模式`—传感器模式类型
`接近`(默认)|`手势`|`环境光和颜色`|`接近，环境光和颜色`|`手势，环境光和颜色`

`数据采集模式`-数据采集方式
`轮询`(默认)|`中断`

`启用状态输出`-输出端口数据的可用性
关闭(默认)|开启

`样品时间`—块读取数据的时间间隔
`０.１`(默认)|标量

`中断阈值[低，高]`-产生中断的接近阈值
`[0, 50]`(默认)|范围内的1 × 2向量`[0, 255)`

`中断的持久性`-控制接近中断率
`2`(默认)|正整数

`输入和退出阈值[Enter, exit]`—生成中断的手势阈值
`(40岁,30)`(默认)|范围内的1 × 2向量`[0, 255)`

`中断的FIFO阈值`—手势FIFO阈值
`4数据集`(默认)|`数据集1`|`8数据集`|`16个数据集`

`退出的持久性`-手势退出控制速率
`1日的姿态结束`(默认)|`2日姿态结束`|`4日的姿态结束`|`7日的姿态结束`

`中断阈值[低，高]`-环境光阈值产生中断
`(65535 0)`(默认)|范围内的1 × 2向量`[0, 65535)`

`中断的持久性`-控制环境光和颜色中断率
`2`(默认)|正标量

`中断源`-中断源
`接近`(默认)|`环境光和颜色`

`获得`-接近增益控制
`4 x`(默认)|`1 x`|`2 x`|`8倍`

`脉冲持续时间`-每个接近脉冲长度的时间周期
`16μs`(默认)|`4μs`|`8μs`|`32μs`

`脉冲计数`- LDR产生的接近脉冲数
`8`(默认)|范围内的正标量[`1`来`64`］

`补偿(UR, DL)`-上-右和下-左光电二极管的接近偏移
`(0,0)`(默认)|范围内的1 × 2向量`(255、255)`

`领导的推动力量`-控制LED红外发射强度
`100毫安`(默认)|`马50`|`25马`|`12.5马`

`领导提高电流`-额外的强度增强LED红外发射
`100％`(默认)|`150％`|`200％`|`300％`

`偏移量[U, D, L, R]`-上、下、左、右光电二极管的手势偏移
`[0, 0, 0, 0]`(默认)| 1 × 4向量`[255, 255, 255, 255]`

`领导的推动力量`-控制LED红外发射强度
`100毫安`(默认)|`马50`|`25马`|`12.5马`

`获得`-手势增益控制
`4 x`(默认)|`1 x`|`2 x`|`8倍`

`脉冲持续时间`—每个手势脉冲长度的时间周期
`32μs`(默认)|`4μs`|`8μs`|`16μs`

`脉冲计数`—LDR产生的手势脉冲数
`10`(默认)|正标量

`等待时间`-手势检测周期之间的时间
`2.8毫秒`(默认)|`0女士`|`5.6毫秒`|`8.4毫秒`|`14个女士`|`22.4毫秒`|`30.8毫秒`|`39.2毫秒`

`获得`-环境光和颜色增益控制
`4 x`(默认)|`1 x`|`16 x`|`64 x`

`ADC集成时间(ms)`-控制环境光和彩色模拟到数字转换器的集成时间
`219`(默认)|正标量

`在环境光传感之前启用等待`-激活等待功能，传感器开始读取环境光和颜色
关闭(默认)|开启

`等待时间(毫秒)`-等待时间，传感器开始读取环境光和颜色
`246`(默认)|正标量

`开启长时间等待(12x)`增加12倍的等待时间
关闭(默认)|开启