feat(apds9960): Add pentatonic light theremin example.

Author: Kaan Ozen

lib/apds9960/examples/light_theremin.py

@@ -0,0 +1,69 @@
+"""Light theremin example using APDS9960 and the board buzzer.
+
+Changes the buzzer pitch based on ambient light level.
+Move your hand up and down over the sensor to play it!
+"""
+
+from time import sleep_ms
+
+from apds9960 import uAPDS9960 as APDS9960
+from machine import I2C, Pin
+from pyb import Timer
+
+# Calibration Constants
+# You may need to adjust MAX_LIGHT depending on your room's ambient lighting
+MIN_LIGHT = 45
+MAX_LIGHT = 920
+
+# Musical Frequency Range (Hz) - Auto-Tuned Pentatonic Scale
+PENTATONIC_NOTES = [
+    131, 147, 165, 196, 220,  # Octave 3
+    262, 294, 330, 392, 440,  # Octave 4
+    523, 587, 659, 784, 880   # Octave 5
+]
+TOTAL_NOTES = len(PENTATONIC_NOTES)
+
+# Hardware Initialization
+i2c = I2C(1)
+apds = APDS9960(i2c)
+apds.enable_light_sensor()
+
+# Hardware PWM on SPEAKER pin
+buzzer_tim = Timer(1, freq=1000)
+buzzer_ch = buzzer_tim.channel(4, Timer.PWM, pin=Pin("SPEAKER"))
+buzzer_ch.pulse_width_percent(0)
+
+print("=======================")
+print("    Light Theremin     ")
+print("=======================")
+print("Move your hand over the sensor.")
+print("Cover it completely to mute.")
+print("Press Ctrl+C to exit.")
+
+try:
+    while True:
+        light_level = apds.ambient_light()
+
+        if light_level < MIN_LIGHT:
+            buzzer_ch.pulse_width_percent(0)
+        else:
+            # Clamp the light reading to avoid exceeding the max frequency
+            clamped_light = min(light_level, MAX_LIGHT)
+
+            # Map the light range to an index in our note array (0 to 14)
+            note_index = (clamped_light - MIN_LIGHT) * (TOTAL_NOTES - 1) // (MAX_LIGHT - MIN_LIGHT)
+            print("Light Level: {}, Note Index: {}".format(light_level, note_index))
+
+            # Fetch the perfect harmonic frequency
+            freq = PENTATONIC_NOTES[note_index]
+
+            # Update the buzzer tone
+            buzzer_tim.freq(freq)
+            buzzer_ch.pulse_width_percent(50)
+
+        sleep_ms(20)
+
+except KeyboardInterrupt:
+    print("\nTheremin stopped.")
+finally:
+    buzzer_ch.pulse_width_percent(0)