Color Unit

支持以下产品：

MicroPython 应用示例

# SPDX-FileCopyrightText: 2024 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
from hardware import *
from unit import ColorUnit


title0 = None
label0 = None
label1 = None
label2 = None
i2c0 = None
color_0 = None


def setup():
    global title0, label0, label1, label2, i2c0, color_0

    M5.begin()
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title(
        "ColorUnit Core2 Example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu18
    )
    label0 = Widgets.Label("lux:", 2, 59, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label1 = Widgets.Label("color:", 2, 114, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label2 = Widgets.Label("saturation:", 2, 166, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    i2c0 = I2C(0, scl=Pin(33), sda=Pin(32), freq=100000)
    color_0 = ColorUnit(i2c0)


def loop():
    global title0, label0, label1, label2, i2c0, color_0
    M5.update()
    label0.setText(str((str("Iux:") + str((color_0.get_lux())))))
    label1.setText(str((str("color:") + str((color_0.get_color_rgb_bytes())))))
    label2.setText(str((str("saturation:") + str((color_0.get_color_s())))))


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

UiFlow2 应用示例：

color_core2_example.m5f2

class ColorUnit

Constructors

class ColorUnit(i2c, address=_TCS3472_DEFAULT_ADDR)

使用给定的 I2C 接口和地址初始化 ColorUnit 传感器。

参数:

i2c (I2C) – 用于通信的 I2C 总线实例。
address (int) – 传感器的 I2C 地址，默认为 _TCS3472_DEFAULT_ADDR(0x29)。

UIFLOW2:

Methods

ColorUnit.get_lux() → float

获取从各颜色通道计算得到的照度（lux）值。

返回:: 计算得到的 lux 值（float）。

UIFLOW2:

ColorUnit.get_color_temperature() → float

获取以开尔文（K）为单位的色温。

返回:: 颜色温度，单位为开尔文（float）。

UIFLOW2:

ColorUnit.get_color_rgb_bytes() → tuple

获取传感器检测到的 RGB 颜色。

返回:: 由红色、绿色和蓝色分量值（字节，0-255）组成的元组。

UIFLOW2:

ColorUnit.get_color_r() → int

获取 RGB 颜色的红色分量。

返回:: 红色分量的值（0-255）。

UIFLOW2:

ColorUnit.get_color_g() → int

获取 RGB 颜色的绿色分量。

返回:: 绿色分量值（0-255）。

UIFLOW2:

ColorUnit.get_color_b() → int

获取 RGB 颜色的蓝色分量。

返回:: 蓝色分量值（0-255）。

UIFLOW2:

ColorUnit.get_color_h() → int

获取颜色的色调（H）值，单位为度。

返回:: 色相值，整数，范围为 [0, 360]。

UIFLOW2:

ColorUnit.get_color_s() → float

获取颜色的饱和度（S）值。

返回:: 饱和度值，为一个取值范围在 [0, 1] 的 float。

UIFLOW2:

ColorUnit.get_color_v() → float

获取颜色（亮度）的值（V）。

返回:: 取值范围为 [0, 1] 的 float 值。

UIFLOW2:

ColorUnit.get_color() → int

获取 RGB 颜色的整数值。

返回:: 一个表示 RGB 颜色的整数，每个通道占 8 位。

UIFLOW2:

ColorUnit.get_color565() → int

以整数形式获取 5-6-5 格式的 RGB 颜色。:return: 一个整数，表示 5-6-5 格式的 RGB 颜色。

UIFLOW2:

ColorUnit.get_active() → bool

获取传感器的激活状态。

返回:: 如果传感器处于激活状态，则为 True；如果处于未激活状态，则为 False。

UIFLOW2:

ColorUnit.set_active(val)

设置传感器的激活状态。

参数:: val (bool) – ：True 用于激活传感器，False 用于停用传感器。

UIFLOW2:

ColorUnit.get_integration_time() → float

获取传感器的积分时间，单位为毫秒。

返回:: 作为 float 类型的积分时间。

UIFLOW2:

ColorUnit.set_integration_time(val)

设置传感器的积分时间。

参数:: val (float) – ：以毫秒为单位的所需积分时间。
抛出:: ValueError – 如果积分时间超出允许范围。

UIFLOW2:

ColorUnit.get_gain() → int

获取传感器的增益。

返回:: 增益值，应为 1、4、16 或 60 中的一个。

UIFLOW2:

ColorUnit.set_gain(val)

设置传感器的增益。

参数:: val (int) – ：期望的增益值（1、4、16 或 60）。
抛出:: ValueError – 如果增益不是允许的值之一。

UIFLOW2:

ColorUnit.read_interrupt() → bool

读取中断状态。

返回:: 如果中断已设置，则为 True；否则为 False。

UIFLOW2:

ColorUnit.clear_interrupt()

通过写入中断寄存器来清除传感器的中断状态。

UIFLOW2:

ColorUnit.get_color_raw()

读取传感器检测到的原始 RGBC 颜色值。

返回:: 一个包含原始红、绿、蓝和清除（Clear）颜色数据的元组。

UIFLOW2:

ColorUnit.get_cycles()

获取传感器的持久化周期。

返回:: 持久化周期数；如果中断被禁用，则为 -1。

UIFLOW2:

ColorUnit.set_cycles(val)

设置传感器的持久性周期。

参数:: val (int) – 持久化循环次数，或设置为 -1 以禁用中断。
抛出:: ValueError – 如果该值不是允许的 cycle 值之一。

UIFLOW2:

ColorUnit.get_min_value()

获取传感器的最小阈值（AILT 寄存器）值。

返回:: 最小阈值。

UIFLOW2:

ColorUnit.set_min_value(val)

设置传感器的最小阈值（AILT 寄存器）值。

参数:: val (int) – ：要设置的最小阈值。

UIFLOW2:

ColorUnit.get_max_value()

获取传感器的最大阈值（AIHT 寄存器）值。

返回:: 最大阈值。

UIFLOW2:

ColorUnit.set_max_value(val)

设置传感器的最大阈值（AIHT 寄存器）值。

参数:: val (int) – ：要设置的最大阈值。

UIFLOW2:

ColorUnit.get_glass_attenuation()

获取用于补偿因玻璃存在导致光照水平降低的玻璃衰减系数。

返回:: 玻璃衰减因子（ga）。

UIFLOW2:

ColorUnit.set_glass_attenuation(value)

设置用于补偿玻璃存在导致光照水平降低的 Glass Attenuation 系数。

参数:: value (float) – ：要设置的玻璃衰减系数。必须大于或等于 1。
抛出:: ValueError – 如果该值小于 1。

UIFLOW2: