Simple test

Ensure your device works with this simple test.

examples/as7341_simpletest.py

# SPDX-FileCopyrightText: 2020 Bryan Siepert, written for Adafruit Industries
# SPDX-License-Identifier: MIT
from time import sleep

import board

import adafruit_as7341

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 = adafruit_as7341.AS7341(i2c)

sensor.gain = adafruit_as7341.Gain.GAIN_0_5X  # Update the gain of the sensor


def bar_graph(read_value):
    scaled = int(read_value / 1000)
    return f"[{read_value:5d}] " + (scaled * "*")


while True:
    print(f"F1 - 415nm/Violet  {bar_graph(sensor.channel_415nm)}")
    print(f"F2 - 445nm//Indigo {bar_graph(sensor.channel_445nm)}")
    print(f"F3 - 480nm//Blue   {bar_graph(sensor.channel_480nm)}")
    print(f"F4 - 515nm//Cyan   {bar_graph(sensor.channel_515nm)}")
    print(f"F5 - 555nm/Green   {bar_graph(sensor.channel_555nm)}")
    print(f"F6 - 590nm/Yellow  {bar_graph(sensor.channel_590nm)}")
    print(f"F7 - 630nm/Orange  {bar_graph(sensor.channel_630nm)}")
    print(f"F8 - 680nm/Red     {bar_graph(sensor.channel_680nm)}")
    print(f"Clear              {bar_graph(sensor.channel_clear)}")
    print(f"Near-IR (NIR)      {bar_graph(sensor.channel_nir)}")
    print("\n------------------------------------------------")
    sleep(1)

LED test

Testing the LED

examples/as7341_led_test.py

# SPDX-FileCopyrightText: 2020 Bryan Siepert, written for Adafruit Industries
#
# SPDX-License-Identifier: MIT
from time import sleep

import board

import adafruit_as7341

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 = adafruit_as7341.AS7341(i2c)

print("out of init!")
print("Current current is")
print(sensor.led_current)
print("Setting current")
sensor.led_current = 50
print("enabling led")
sensor.led = True
sleep(0.5)
print("disabling LED")
sensor.led = False

print("led status:", sensor.led)

Flicker Detection

Showing how to use flicker detection

examples/as7341_flicker_detection.py

# SPDX-FileCopyrightText: 2020 Bryan Siepert, written for Adafruit Industries
# SPDX-License-Identifier: MIT
from time import sleep

import board

from adafruit_as7341 import AS7341

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 = AS7341(i2c)
sensor.flicker_detection_enabled = True

while True:
    flicker_detected = sensor.flicker_detected
    if flicker_detected:
        print(f"Detected a {flicker_detected:d} Hz flicker")

    sleep(0.1)

Batched Readings Example

Example in how to get all the channel readings at the same time

examples/as7341_batched_readings.py

# SPDX-FileCopyrightText: 2020 Bryan Siepert, written for Adafruit Industries
# SPDX-License-Identifier: MIT
from time import sleep

import board

from adafruit_as7341 import AS7341

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 = AS7341(i2c)


def bar_graph(read_value):
    scaled = int(read_value / 1000)
    return f"[{read_value:5d}] " + (scaled * "*")


while True:
    sensor_channels = sensor.all_channels
    print(f"F1 - 415nm/Violet  {bar_graph(sensor_channels[0])}")
    print(f"F2 - 445nm//Indigo {bar_graph(sensor_channels[1])}")
    print(f"F3 - 480nm//Blue   {bar_graph(sensor_channels[2])}")
    print(f"F4 - 515nm//Cyan   {bar_graph(sensor_channels[3])}")
    print(f"F5 - 555nm/Green   {bar_graph(sensor_channels[4])}")
    print(f"F6 - 590nm/Yellow  {bar_graph(sensor_channels[5])}")
    print(f"F7 - 630nm/Orange  {bar_graph(sensor_channels[6])}")
    print(f"F8 - 680nm/Red     {bar_graph(sensor_channels[7])}")
    print("\n------------------------------------------------")

    sleep(1)

DisplayIO Simpletest

This is a simple test for boards with built-in display.

examples/as3741_displayio_simpletest.py

# SPDX-FileCopyrightText: 2024 Tim Cocks for Adafruit Industries
# SPDX-FileCopyrightText: 2024 Jose D. Montoya
#
# SPDX-License-Identifier: MIT

import time

import board
from adafruit_display_text.bitmap_label import Label
from displayio import Group
from terminalio import FONT

from adafruit_as7341 import AS7341

# Simple demo of using the built-in display.
# create a main_group to hold anything we want to show on the display.
main_group = Group()
# Initialize I2C bus and sensor.
i2c = board.I2C()  # uses board.SCL and board.SDA
sensor = AS7341(i2c)
sensor.flicker_detection_enabled = True

# Create Label(s) to show the readings. If you have a very small
# display you may need to change to scale=1.
display_output_label = Label(FONT, text="", scale=2)

# place the label(s) in the middle of the screen with anchored positioning
display_output_label.anchor_point = (0, 0)
display_output_label.anchored_position = (
    4,
    board.DISPLAY.height // 2 - 60,
)

# add the label(s) to the main_group
main_group.append(display_output_label)

# set the main_group as the root_group of the built-in DISPLAY
board.DISPLAY.root_group = main_group

# begin main loop
while True:
    # update the text of the label(s) to show the sensor readings
    flicker_detected = sensor.flicker_detected
    if flicker_detected:
        display_output_label.text = f"Detected a {flicker_detected} Hz flicker"
    else:
        display_output_label.text = "No flicker detected"
    # wait for a bit
    time.sleep(0.5)