1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# SPDX-FileCopyrightText: Copyright (c) 2025 Tim C for Adafruit Industries
# SPDX-License-Identifier: MIT
"""
A basic demo for using the OPT4048 tristimulus XYZ color sensor

This example reads the sensor values from all four channels (X, Y, Z, W),
demonstrates setting and getting threshold values, and displays the results.
"""

import time
from time import sleep

import board

from adafruit_opt4048 import OPT4048, ConversionTime, Mode, Range

i2c = board.I2C()  # uses board.SCL and board.SDA
# i2c = board.STEMMA_I2C()  # For using the built-in STEMMA QT connector on a microcontroller
sensor = OPT4048(i2c)

sensor.range = Range.AUTO
sensor.conversion_time = ConversionTime.TIME_100MS
sensor.mode = Mode.CONTINUOUS
while True:
    try:
        x, y, lux = sensor.cie
        print(f"CIE x:{x}, y:{y}, lux: {lux}", end=" ")
        print(f"K: {sensor.calculate_color_temperature(x, y)}")
        time.sleep(1)
    except RuntimeError:
        # CRC check failed while reading data
        pass

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

/*!
 * @file test_opt4048.ino
 *
 * A basic demo for using the OPT4048 tristimulus XYZ color sensor
 * 
 * This example reads the sensor values from all four channels (X, Y, Z, W),
 * demonstrates setting and getting threshold values, and displays the results.
 */

#include <Wire.h>
#include "Adafruit_OPT4048.h"

// Create sensor object
Adafruit_OPT4048 sensor;

void setup() {
  // Initialize serial communication
  Serial.begin(115200);
  
  // Wait for serial monitor to open
  while (!Serial) {
    delay(10);
  }

  Serial.println(F("Adafruit OPT4048 Tristimulus XYZ Color Sensor Test"));

  // Initialize the sensor
  if (!sensor.begin()) {
    Serial.println(F("Failed to find OPT4048 chip"));
    while (1) {
      delay(10);
    }
  }
  
  Serial.println(F("OPT4048 sensor found!"));

  sensor.setRange(OPT4048_RANGE_AUTO);  // Set range to auto
  sensor.setConversionTime(OPT4048_CONVERSION_TIME_100MS); // Set conversion time to 100ms
  sensor.setMode(OPT4048_MODE_CONTINUOUS);  // Set operating mode to continuous
}

void loop() {
  // Calculate and display CIE chromaticity coordinates and lux
  double CIEx, CIEy, lux;
  if (sensor.getCIE(&CIEx, &CIEy, &lux)) {
    Serial.println(F("\nCIE Coordinates:"));
    Serial.print(F("CIE x: ")); Serial.println(CIEx, 8);
    Serial.print(F("CIE y: ")); Serial.println(CIEy, 8);
    Serial.print(F("Lux: ")); Serial.println(lux, 4);

    // Calculate and display color temperature
    double colorTemp = sensor.calculateColorTemperature(CIEx, CIEy);
    Serial.print(F("Color Temperature: "));
    Serial.print(colorTemp, 2);
    Serial.println(F(" K"));
  } else {
    Serial.println(F("Error reading sensor data"));
  }

  delay(1000); // Read once per second
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# SPDX-FileCopyrightText: Copyright (c) 2025 Tim C for Adafruit Industries
# SPDX-License-Identifier: MIT
"""
This example reads color data from the OPT4048 sensor and outputs it
in a format suitable for displaying on a web page using Web Serial API.

It continuously measures CIE x,y coordinates, lux, and color temperature.

This example works with the web interface in the /webserial directory of the
gh-pages branch of the Arduino driver repo: https://github.com/adafruit/Adafruit_OPT4048/tree/gh-pages,
which can be accessed at: https://adafruit.github.io/Adafruit_OPT4048/webserial/
"""

import time
from time import sleep

import board

from adafruit_opt4048 import OPT4048, ConversionTime, Mode, Range

READ_INTERVAL = 0.1  # seconds

i2c = board.I2C()  # uses board.SCL and board.SDA
# i2c = board.STEMMA_I2C()  # For using the built-in STEMMA QT connector on a microcontroller
sensor = OPT4048(i2c)

sensor.range = Range.AUTO
sensor.conversion_time = ConversionTime.TIME_100MS
sensor.mode = Mode.CONTINUOUS

last_read_time = 0
while True:
    if time.monotonic() > last_read_time + READ_INTERVAL:
        try:
            last_read_time = time.monotonic()
            x, y, lux = sensor.cie
            print("---CIE Data---")
            print(f"CIE x: {x}")
            print(f"CIE y: {y}")
            print(f"Lux: {lux}")
            print(f"Color Temperature: {sensor.calculate_color_temperature(x, y)} K")
            print("-------------")
        except RuntimeError:
            # CRC check failed while reading data
            pass

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

/*!
 * @file opt4048_webserial.ino
 * 
 * This example reads color data from the OPT4048 sensor and outputs it
 * in a format suitable for displaying on a web page using Web Serial API.
 * 
 * It continuously measures CIE x,y coordinates, lux, and color temperature.
 * 
 * This sketch works with the web interface in the /webserial directory of the
 * gh-pages branch: https://github.com/adafruit/Adafruit_OPT4048/tree/gh-pages,
 * which can be accessed at: https://adafruit.github.io/Adafruit_OPT4048/webserial/
 */

#include <Wire.h>
#include "Adafruit_OPT4048.h"

// Create sensor object
Adafruit_OPT4048 sensor;

// Set how often to read data (in milliseconds)
const unsigned long READ_INTERVAL = 100;
unsigned long lastReadTime = 0;

void setup() {
  // Initialize serial communication at 115200 baud
  Serial.begin(115200);
  
  // Wait briefly for serial to connect (not needed for all boards)
  delay(100);

  Serial.println(F("Adafruit OPT4048 WebSerial Example"));
  Serial.println(F("This sketch works with the OPT4048 CIE Color Plotter web page"));

  // Initialize the sensor
  if (!sensor.begin()) {
    Serial.println(F("Failed to find OPT4048 chip"));
    while (1) {
      delay(10);
    }
  }
  
  Serial.println(F("OPT4048 sensor found!"));

  // Set sensor configuration
  sensor.setRange(OPT4048_RANGE_AUTO);           // Auto-range for best results across lighting conditions
  sensor.setConversionTime(OPT4048_CONVERSION_TIME_100MS); // 100ms conversion time
  sensor.setMode(OPT4048_MODE_CONTINUOUS);       // Continuous mode
}

void loop() {
  // Only read at the specified interval
  unsigned long currentTime = millis();
  if (currentTime - lastReadTime >= READ_INTERVAL) {
    lastReadTime = currentTime;
    
    // Calculate and display CIE chromaticity coordinates and lux
    double CIEx, CIEy, lux;
    if (sensor.getCIE(&CIEx, &CIEy, &lux)) {
      // Print the values in a format that can be easily parsed by the web page
      Serial.println(F("---CIE Data---"));
      Serial.print(F("CIE x: ")); Serial.println(CIEx, 8);
      Serial.print(F("CIE y: ")); Serial.println(CIEy, 8);
      Serial.print(F("Lux: ")); Serial.println(lux, 4);

      // Calculate and display color temperature
      double colorTemp = sensor.calculateColorTemperature(CIEx, CIEy);
      Serial.print(F("Color Temperature: "));
      Serial.print(colorTemp, 2);
      Serial.println(F(" K"));
      Serial.println(F("-------------"));
    } else {
      Serial.println(F("Error reading sensor data"));
    }
  }

  // Check for any incoming serial commands
  if (Serial.available() > 0) {
    String command = Serial.readStringUntil('\n');
    command.trim();
    
    // Process any commands here if needed
  }
}