apds9960 — Yakınlık, Hareket ve Renk Sensörü Sürücüsü

Bu modül, Broadcom/Avago APDS9960 dijital yakınlık, ortam ışığı, RGB renk ve hareket sensörü için I2C üzerinden bir sürücü sağlar. Sürücü; özellik bazında etkinleştirme/devre dışı bırakma denetimlerini, ham kanal okumalarını (clear, R, G, B, yakınlık) ve çip üzerindeki 4 fotodiyotlu FIFO’dan yukarı/aşağı/sola/sağa kaydırma ve yakın/uzak hareketlerini sınıflandıran bir yazılımsal hareket çözme durum makinesini açığa çıkarır.

Örnek kullanım:

import time
from machine import I2C, Pin
from apds9960 import uAPDS9960 as APDS9960

bus = I2C(1, scl=Pin("P15"), sda=Pin("P14"))
sensor = APDS9960(bus)

sensor.enableLightSensor()
sensor.enableProximitySensor()

while True:
    r = sensor.readRedLight()
    g = sensor.readGreenLight()
    b = sensor.readBlueLight()
    c = sensor.readAmbientLight()
    p = sensor.readProximity()
    print(r, g, b, c, p)
    time.sleep_ms(100)

Sınıflar

class apds9960.APDS9960(bus: machine.I2C, address: int = 0x39, valid_id: list = [0xAB, 0x9C, 0xA8, -0x55])

Bir APDS9960 sürücü örneği oluşturur.

• bus, sensörle iletişim kurmak için kullanılan, yapılandırılmış bir I2C veri yolu nesnesidir. Temel sınıf, SMBus tarzı read_byte_data, write_byte_data ve read_i2c_block_data çağrıları yapar; MicroPython’ın machine.I2C sınıfı için bunun yerine uAPDS9960 kullanın.

• address, aygıtın 7 bitlik I2C adresidir. Varsayılan olarak APDS9960_I2C_ADDR (0x39) değerine sahiptir.

• valid_id, çipin ID yazmacının döndürdüğü kabul edilebilir değerlerin bir listesidir. Varsayılan olarak APDS9960_DEV_ID değerine sahiptir.

Yapıcı, aygıt ID’sini okur ve değer valid_id içinde yoksa ADPS9960InvalidDevId yükseltir. Ardından her özelliği devre dışı bırakır, varsayılan ATIME/WTIME/PPULSE değerlerini programlar ve varsayılan LED sürüş akımını, yakınlık kazancını, ALS kazancını, yakınlık eşiklerini, ortam ışığı eşiklerini, kalıcılığı ve hareket motoru yapılandırmasını (giriş/çıkış eşikleri, GCONF1, hareket kazancı, hareket LED sürüş akımı, hareket bekleme süresi, hareket ofsetleri, GPULSE, GCONF3 ve hareket kesmesi etkinleştirme) uygular.

Mod ve güç denetimi

getMode() → int

Hangi özelliklerin şu anda etkin olduğunu (güç, ALS, yakınlık, bekleme, ALS kesmesi, yakınlık kesmesi, hareket) kodlayan ENABLE yazmacının ham değerini döndürür.

setMode(mode: int, enable: bool = True) → None

ENABLE yazmacındaki tek bir özelliği etkinleştirir veya devre dışı bırakır. mode, APDS9960_MODE_* değerlerinden biri olmalıdır (APDS9960_MODE_POWER ..\ APDS9960_MODE_ALL). mode APDS9960_MODE_ALL olduğunda, tüm bitler aynı anda açılır veya kapatılır. Aralık dışı değerler için ADPS9960InvalidMode yükseltir.

enablePower() → None

APDS9960’ı açar (ENABLE içindeki PON bitini ayarlar).

disablePower() → None

APDS9960’ı kapatır (ENABLE içindeki PON bitini temizler).

Ortam ışığı / RGB sensörü

enableLightSensor(interrupts: bool = True) → None

Varsayılan ALS kazancını geri yükler, ALS kesmesi etkinleştirme bitini yapılandırır, aygıtı açar ve ortam ışığı/renk motorunu etkinleştirir.

disableLightSensor() → None

ALS kesmesini devre dışı bırakır ve ortam ışığı/renk motorunu durdurur.

readAmbientLight() → int

Clear kanalı ortam ışığı seviyesini 16 bitlik işaretsiz bir değer olarak okur.

readRedLight() → int

Kırmızı kanal seviyesini 16 bitlik işaretsiz bir değer olarak okur.

readGreenLight() → int

Yeşil kanal seviyesini 16 bitlik işaretsiz bir değer olarak okur.

readBlueLight() → int

Mavi kanal seviyesini 16 bitlik işaretsiz bir değer olarak okur.

Yakınlık sensörü

enableProximitySensor(interrupts: bool = True) → None

Varsayılan yakınlık kazancını ve LED sürüş akımını geri yükler, yakınlık kesmesi etkinleştirme bitini yapılandırır, aygıtı açar ve yakınlık motorunu etkinleştirir.

disableProximitySensor() → None

Yakınlık kesmesini devre dışı bırakır ve yakınlık motorunu durdurur.

readProximity() → int

Yakınlık seviyesini 8 bitlik işaretsiz bir değer olarak okur.

Hareket motoru

enableGestureSensor(interrupts: bool = True) → None

Hareket durumunu sıfırlar, WTIME ve hareket darbe sayısını ayarlar, LED’i %300’e yükseltir, hareket kesmesi etkinleştirme bitini yapılandırır, hareket durum makinesine girer, aygıtı açar ve bekleme, yakınlık ve hareket modlarını etkinleştirir.

disableGestureSensor() → None

Hareket durumunu sıfırlar, hareket kesmesini ve durum makinesini devre dışı bırakır ve hareket motorunu durdurur.

isGestureAvailable() → bool

Hareket durum yazmacının GVALID biti ayarlıysa True döndürür; bu, hareket FIFO verisinin okunmaya hazır olduğunu gösterir.

readGesture() → int

Hareket FIFO’sunu boşaltır, yerleşik hareket çözücüyü çalıştırır ve APDS9960_DIR_* yön sabitlerinden birini döndürür. Motor çalışmıyorsa, geçerli veri yoksa veya veri tanınan bir harekete çözümlenmediyse APDS9960_DIR_NONE döndürür.

resetGestureParameters() → None

Dahili hareket FIFO arabelleğini, farkları (delta), sayımları, yakın/uzak sayaçlarını, durumu ve son çözülen hareketi temizler.

processGestureData() → bool

U/D ve L/R farklarını (delta) ve yakın/uzak sayaçlarını güncellemek için şu anda arabelleğe alınmış ham U/D/L/R FIFO örneklerini işler. Yakın veya uzak bir olay tespit edilirse True, aksi halde False döndürür.

decodeGesture() → bool

Geçerli U/D ve L/R sayımlarını ve biriken farkları (delta), dahili gesture_motion_ alanında saklanan bir yöne dönüştürür. Bir yön tanındığında True, aksi halde False döndürür.

Yakınlık eşikleri

getProxIntLowThresh() → int

Düşük yakınlık kesmesi eşiğini (PILT yazmacı) döndürür.

setProxIntLowThresh(threshold: int) → None

Düşük yakınlık kesmesi eşiğini ayarlar.

getProxIntHighThresh() → int

Yüksek yakınlık kesmesi eşiğini (PIHT yazmacı) döndürür.

setProxIntHighThresh(threshold: int) → None

Yüksek yakınlık kesmesi eşiğini ayarlar.

getProximityIntLowThreshold() → int

getProxIntLowThresh() için takma ad.

setProximityIntLowThreshold(threshold: int) → None

setProxIntLowThresh() için takma ad.

getProximityIntHighThreshold() → int

getProxIntHighThresh() için takma ad.

setProximityIntHighThreshold(threshold: int) → None

setProxIntHighThresh() için takma ad.

LED sürüş akımı, kazanç ve güçlendirme

getLEDDrive() → int

Yakınlık ve ALS için kullanılan LED sürüş gücünü döndürür. APDS9960_LED_DRIVE_* değerlerinden biri olarak kodlanır (0 = 100 mA, 1 = 50 mA, 2 = 25 mA, 3 = 12.5 mA).

setLEDDrive(drive: int) → None

Yakınlık ve ALS için kullanılan LED sürüş gücünü ayarlar. drive, APDS9960_LED_DRIVE_* değerlerinden biridir.

getProximityGain() → int

Yakınlık alıcısı kazancını döndürür. APDS9960_PGAIN_* değerlerinden biri olarak kodlanır (0 = 1x, 1 = 2x, 2 = 4x, 3 = 8x).

setProximityGain(drive: int) → None

Yakınlık alıcısı kazancını ayarlar. drive, APDS9960_PGAIN_* değerlerinden biridir.

getAmbientLightGain() → int

Ortam ışığı sensörü kazancını döndürür. APDS9960_AGAIN_* değerlerinden biri olarak kodlanır (0 = 1x, 1 = 4x, 2 = 16x, 3 = 64x).

setAmbientLightGain(drive: int) → None

Ortam ışığı sensörü kazancını ayarlar. drive, APDS9960_AGAIN_* değerlerinden biridir.

getLEDBoost() → int

LED akım güçlendirmesini döndürür. APDS9960_LED_BOOST_* değerlerinden biri olarak kodlanır (0 = %100, 1 = %150, 2 = %200, 3 = %300).

setLEDBoost(boost: int) → None

LED akım güçlendirmesini ayarlar. boost, APDS9960_LED_BOOST_* değerlerinden biridir.

Yakınlık kazanç telafisi ve fotodiyot maskesi

getProxGainCompEnable() → bool

Yakınlık kazanç telafisi etkinse True döndürür.

setProxGainCompEnable(enable: bool) → None

Yakınlık kazanç telafisini etkinleştirir veya devre dışı bırakır.

getProxPhotoMask() → int

Devre dışı bırakılmış yakınlık fotodiyotlarının 4 bitlik maskesini döndürür. Bitler şöyle eşlenir: 3=UP, 2=DOWN, 1=LEFT, 0=RIGHT; 1 bir fotodiyotu devre dışı bırakır ve 0 etkinleştirir.

setProxPhotoMask(mask: int) → None

Devre dışı bırakılmış yakınlık fotodiyotlarının 4 bitlik maskesini ayarlar (yukarıdaki kodlamaya bakın).

Hareket yapılandırması

getGestureEnterThresh() → int

Hareket moduna girmek için gereken yakınlık eşiğini döndürür.

setGestureEnterThresh(threshold: int) → None

Hareket moduna girmek için gereken yakınlık eşiğini ayarlar.

getGestureExitThresh() → int

Hareket modundan çıkmak için gereken yakınlık eşiğini döndürür.

setGestureExitThresh(threshold: int) → None

Hareket modundan çıkmak için gereken yakınlık eşiğini ayarlar.

getGestureGain() → int

Hareket modu sırasında kullanılan fotodiyot kazancını döndürür. APDS9960_GGAIN_* değerlerinden biri olarak kodlanır (0 = 1x, 1 = 2x, 2 = 4x, 3 = 8x).

setGestureGain(gain: int) → None

Hareket modu sırasında kullanılan fotodiyot kazancını ayarlar.

getGestureLEDDrive() → int

Hareket modu sırasında kullanılan LED sürüş akımını döndürür. APDS9960_LED_DRIVE_* değerlerinden biri olarak kodlanır.

setGestureLEDDrive(drive: int) → None

Hareket modu sırasında kullanılan LED sürüş akımını ayarlar.

getGestureWaitTime() → int

Hareket tespitleri arasındaki düşük güçlü bekleme süresini döndürür. APDS9960_GWTIME_* değerlerinden biri olarak kodlanır (0 = 0 ms .. 7 = 39.2 ms).

setGestureWaitTime(time: int) → None

Hareket tespitleri arasındaki düşük güçlü bekleme süresini ayarlar.

getGestureMode() → bool

Hareket durum makinesi şu anda çalışıyorsa True döndürür.

setGestureMode(enable: bool) → None

Hareket durum makinesine girer veya çıkar.

Ortam ışığı kesmesi eşikleri

getLightIntLowThreshold() → int

Ortam ışığı kesmesi için kullanılan 16 bitlik düşük eşiği döndürür.

setLightIntLowThreshold(threshold: int) → None

Ortam ışığı kesmesi için kullanılan 16 bitlik düşük eşiği ayarlar.

getLightIntHighThreshold() → int

Ortam ışığı kesmesi için kullanılan 16 bitlik yüksek eşiği döndürür.

setLightIntHighThreshold(threshold: int) → None

Ortam ışığı kesmesi için kullanılan 16 bitlik yüksek eşiği ayarlar.

Kesme etkinleştirmeleri ve temizlemeleri

getAmbientLightIntEnable() → bool

Ortam ışığı kesmeleri etkinse True döndürür.

setAmbientLightIntEnable(enable: bool) → None

Ortam ışığı kesmelerini etkinleştirir veya devre dışı bırakır.

getProximityIntEnable() → bool

Yakınlık kesmeleri etkinse True döndürür.

setProximityIntEnable(enable: bool) → None

Yakınlık kesmelerini etkinleştirir veya devre dışı bırakır.

getGestureIntEnable() → bool

Hareket kesmeleri etkinse True döndürür.

setGestureIntEnable(enable: bool) → None

Hareket kesmelerini etkinleştirir veya devre dışı bırakır.

clearAmbientLightInt() → None

Bekleyen bir ortam ışığı kesmesini temizler.

clearProximityInt() → None

Bekleyen bir yakınlık kesmesini temizler.

class apds9960.uAPDS9960(bus: machine.I2C, address: int = 0x39, valid_id: list = [0xAB, 0x9C, 0xA8, -0x55])

APDS9960 sınıfının MicroPython alt sınıfı. Genel API’si aynıdır, ancak alttaki yazmaç erişimi SMBus tarzı yöntemler yerine machine.I2C tarzı readfrom_mem ve writeto_mem çağrılarını kullanır. OpenMV / MicroPython hedeflerinde kullanılacak sınıf budur.

İstisnalar

exception apds9960.ADPS9960InvalidDevId(id: int, valid_ids: list)

ValueError alt sınıfı. Çipin ID yazmacından okunan değer valid_id listesinde bulunmadığında APDS9960 yapıcısı tarafından yükseltilir.

exception apds9960.ADPS9960InvalidMode(mode: int)

ValueError alt sınıfı. mode argümanı APDS9960_MODE_POWER..\ APDS9960_MODE_ALL aralığının dışında olduğunda APDS9960.setMode() tarafından yükseltilir.

Sabitler

I2C adresi ve aygıt ID’leri

apds9960.APDS9960_I2C_ADDR: int

APDS9960’ın varsayılan 7 bitlik I2C adresi (0x39).

apds9960.APDS9960_DEV_ID: list

Geçerli aygıt ID yazmacı değerlerinin varsayılan listesi ([0xAB, 0x9C, 0xA8, -0x55]).

Hareket ayarlaması

apds9960.APDS9960_GESTURE_THRESHOLD_OUT: int

Hareket çözücünün, aralık içindeki ilk/son FIFO örneklerini ararken kullandığı minimum örnek büyüklüğü (fotodiyot başına).

apds9960.APDS9960_GESTURE_SENSITIVITY_1: int

Çözücünün bir kaydırma yönüne karar verdiği, biriken U/D ve L/R farkları (delta) üzerindeki eşik.

apds9960.APDS9960_GESTURE_SENSITIVITY_2: int

Çözücünün bir örneği kaydırma yerine yakın/uzak adayı olarak değerlendirdiği, adım başına U/D ve L/R farkları (delta) altındaki eşik.

apds9960.APDS9960_TIME_FIFO_PAUSE: int

Hareket döngüsünün FIFO boşaltmaları arasında uyuduğu milisaniye.

Özellik modları

Bu değerler APDS9960.setMode() yöntemine aktarılır.

apds9960.APDS9960_MODE_POWER: int

Güç açma biti (0).

apds9960.APDS9960_MODE_AMBIENT_LIGHT: int

Ortam ışığı/renk motoru etkinleştirme biti (1).

apds9960.APDS9960_MODE_PROXIMITY: int

Yakınlık motoru etkinleştirme biti (2).

apds9960.APDS9960_MODE_WAIT: int

Bekleme durumu etkinleştirme biti (3).

apds9960.APDS9960_MODE_AMBIENT_LIGHT_INT: int

Ortam ışığı kesmesi etkinleştirme biti (4).

apds9960.APDS9960_MODE_PROXIMITY_INT: int

Yakınlık kesmesi etkinleştirme biti (5).

apds9960.APDS9960_MODE_GESTURE: int

Hareket motoru etkinleştirme biti (6).

apds9960.APDS9960_MODE_ALL: int

APDS9960.setMode() yöntemine ENABLE yazmacındaki her biti aynı anda etkinleştirmesini veya devre dışı bırakmasını söyleyen nöbetçi (sentinel) değer (7).

LED sürüş akımları

apds9960.APDS9960_LED_DRIVE_100MA: int

100 mA LED sürüş akımı (0).

apds9960.APDS9960_LED_DRIVE_50MA: int

50 mA LED sürüş akımı (1).

apds9960.APDS9960_LED_DRIVE_25MA: int

25 mA LED sürüş akımı (2).

apds9960.APDS9960_LED_DRIVE_12_5MA: int

12.5 mA LED sürüş akımı (3).

Yakınlık kazancı (PGAIN)

apds9960.APDS9960_PGAIN_1X: int

1x yakınlık kazancı (0).

apds9960.APDS9960_PGAIN_2X: int

2x yakınlık kazancı (1).

apds9960.APDS9960_PGAIN_4X: int

4x yakınlık kazancı (2). Yapıcı tarafından uygulanan varsayılan.

apds9960.APDS9960_PGAIN_8X: int

8x yakınlık kazancı (3).

Ortam ışığı kazancı (AGAIN)

apds9960.APDS9960_AGAIN_1X: int

1x ALS kazancı (0).

apds9960.APDS9960_AGAIN_4X: int

4x ALS kazancı (1). Yapıcı tarafından uygulanan varsayılan.

apds9960.APDS9960_AGAIN_16X: int

16x ALS kazancı (2).

apds9960.APDS9960_AGAIN_64X: int

64x ALS kazancı (3).

Hareket kazancı (GGAIN)

apds9960.APDS9960_GGAIN_1X: int

1x hareket kazancı (0).

apds9960.APDS9960_GGAIN_2X: int

2x hareket kazancı (1).

apds9960.APDS9960_GGAIN_4X: int

4x hareket kazancı (2). Yapıcı tarafından uygulanan varsayılan.

apds9960.APDS9960_GGAIN_8X: int

8x hareket kazancı (3).

LED güçlendirme

apds9960.APDS9960_LED_BOOST_100: int

%100 LED güçlendirme (0).

apds9960.APDS9960_LED_BOOST_150: int

%150 LED güçlendirme (1).

apds9960.APDS9960_LED_BOOST_200: int

%200 LED güçlendirme (2).

apds9960.APDS9960_LED_BOOST_300: int

%300 LED güçlendirme (3). APDS9960.enableGestureSensor() tarafından otomatik olarak uygulanır.

Hareket bekleme süreleri

apds9960.APDS9960_GWTIME_0MS: int

0 ms (0).

apds9960.APDS9960_GWTIME_2_8MS: int

2.8 ms (1). Yapıcı tarafından uygulanan varsayılan.

apds9960.APDS9960_GWTIME_5_6MS: int

5.6 ms (2).

apds9960.APDS9960_GWTIME_8_4MS: int

8.4 ms (3).

apds9960.APDS9960_GWTIME_14_0MS: int

14.0 ms (4).

apds9960.APDS9960_GWTIME_22_4MS: int

22.4 ms (5).

apds9960.APDS9960_GWTIME_30_8MS: int

30.8 ms (6).

apds9960.APDS9960_GWTIME_39_2MS: int

39.2 ms (7).

Hareket yönleri

Bu değerler APDS9960.readGesture() tarafından döndürülür.

apds9960.APDS9960_DIR_NONE: int

Hareket tespit edilmedi (0).

apds9960.APDS9960_DIR_LEFT: int

Sola kaydırma (1).

apds9960.APDS9960_DIR_RIGHT: int

Sağa kaydırma (2).

apds9960.APDS9960_DIR_UP: int

Yukarı kaydırma (3).

apds9960.APDS9960_DIR_DOWN: int

Aşağı kaydırma (4).

apds9960.APDS9960_DIR_NEAR: int

Yakın olayı (5).

apds9960.APDS9960_DIR_FAR: int

Uzak olayı (6).

apds9960.APDS9960_DIR_ALL: int

Dahili olarak “herhangi bir yön”ü temsil etmek için kullanılan nöbetçi (sentinel) değer (7).

Hareket durumları

Hareket durum makinesi aracılığıyla raporlanan dahili durum değerleri.

apds9960.APDS9960_STATE_NA: int

Durum yok (0).

apds9960.APDS9960_STATE_NEAR: int

Yakın durumu tespit edildi (1).

apds9960.APDS9960_STATE_FAR: int

Uzak durumu tespit edildi (2).

apds9960.APDS9960_STATE_ALL: int

Dahili olarak “herhangi bir durum”u temsil etmek için kullanılan nöbetçi (sentinel) değer (3).