feat: Added APDS9960 Gesture, Color, Proximity and Ambient Light Sensor

[AsCress]

Adds support for the APDS9960 Gesture, Color, Proximity and Ambient Light Sensor.

The APDS9960 is a versatile digital, RGB, ambient light, proximity, and gesture sensor.
Some of its features: -
1. RGB Color Sensing: It can accurately measure red, green, and blue (RGB) light levels, allowing it to detect and differentiate between different colors in the environment.
2. Ambient Light Sensing: It includes an ambient light sensor capable of measuring the intensity of ambient light.
3. Proximity Sensing: It can detect the presence of objects or obstacles in close proximity to the sensor. It emits infrared (IR) light and measures the reflection to determine the distance between the sensor and nearby objects.
4. Gesture Detection: One of its standout features is its ability to recognize a variety of hand gestures, such as swipe, flick, and circle motions.

Changes

• The UI for the sensor (sensor_apds9960.xml) is developed akin to the UI for the existing sensors, providing raw data and graphical plots in a clear and user-friendly manner.
• The sensor activity (SensorAPDS9960.java) follows on a similar pattern as the already present sensors.
• A dedicated communication library for the sensor (APDS9960.java) is developed by porting the adafruit library for the sensor to Java.

Screenshots / Recordings

Here is a screen recording demonstrating the functioning: -

Screen_recording_20240819_201444.mp4

Checklist:

• No hard coding: I have used resources from strings.xml, dimens.xml and colors.xml without hard coding any value.
• No end of file edits: No modifications done at end of resource files strings.xml, dimens.xml or colors.xml.
• Code reformatting: I have reformatted code and fixed indentation in every file included in this pull request.
• No extra space: My code does not contain any extra lines or extra spaces than the ones that are necessary.

Note:-
This has been tested with the sensor.
@marcnause Could you please also test this and confirm if this works fine ?

Summary by Sourcery

Introduce support for the APDS9960 sensor, including gesture, color, proximity, and ambient light sensing. Develop a new communication library and user interface for the sensor, enhancing the application's sensor capabilities.

New Features:

• Add support for the APDS9960 sensor, enabling gesture, color, proximity, and ambient light sensing capabilities.

Enhancements:

• Develop a dedicated communication library for the APDS9960 sensor by porting the Adafruit library to Java.
• Implement a user interface for the APDS9960 sensor, providing raw data and graphical plots in a user-friendly manner.

[sourcery-ai]

Build successful. APKs to test: https://github.com/fossasia/pslab-android/actions/runs/10488547203/artifacts/1836877047

[sourcery-ai]

Hey @AsCress - I've reviewed your changes and they look great!

Here's what I looked at during the review

• 🟡 General issues: 4 issues found
• 🟢 Security: all looks good
• 🟢 Testing: all looks good
• 🟢 Complexity: all looks good
• 🟢 Documentation: all looks good

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.}

[marcnause]

I successfully tested the sensor (proximity, color and light sensing) with the v5 board and the v3.0.2 firmware. We agreed that gestures will be added in a future PR.

[AsCress]

@CloudyPadmal @marcnause @bessman
This PR now adds support for gestures too using the APDS9960 !! 🥳🥳
Support for four basic (LEFT, RIGHT, UP, DOWN) gestures has been implemented as done in the adafruit driver for the sensor.
Since only one of the engines of the sensor, either the gesture engine or the proximity engine can work at a time, the features have been separated in the app.
Here is a screen recording demonstrating the complete functionality implemented for the sensor in the app: -

Screen_recording_20240821_160744.mp4

@marcnause Could you also please test these features with the sensor and confirm that they work fine?

P.S.- Please ignore the issues found out by static code analysis as they are complexity related and we can't do much to reduce the complexity when the driver functionality requires that (ported from the adafruit driver).

[github-actions]

Build successful. APKs to test: https://github.com/fossasia/pslab-android/actions/runs/10548067408/artifacts/1851922955

[marcnause]

Yay! 🥳 I tested the sensor again and I can confirm that the gesture detection is working fine with my sensor and is fun to use. 😉

I think that getGesture could be refactored to reduce the complexity (e.g. move block in the while-loop to an extra method), but I am nit sure that it would make the code more readable.

Would it be possible to increase the width of the Spinner for he mode selection? Also I think it would be easier for the user to understand the screen if the mode selection would be the first element of the screen. What do you think?

[AsCress]

@marcnause Thanks for testing! Your suggestions regarding the layout are nice ones! I've updated the layout accordingly. Even if we refactor the getGesture method, we won't be able to reduce the N-Path complexity (I've already done quite a few refactoring by moving the code into other methods).

[marcnause]

@AsCress Thumbs up for the changed layout! I think it looks really good.

[AsCress]

@marcnause Is there something that you would like to discuss regarding this PR or maybe give it a final review ? This is ready to be merged from my side.