Simple test

Ensure your device works with this simple test.

examples/as7343_simpletest.py

# SPDX-FileCopyrightText: Copyright (c) 2026 Tim Cocks for Adafruit Industries
#
# SPDX-License-Identifier: MIT
import time

import board

from adafruit_as7343 import AS7343

i2c = board.I2C()
sensor = AS7343(i2c)

CHANNEL_LABELS = [
    "FZ (450nm blue)",
    "FY (555nm yellow-green)",
    "FXL (600nm orange)",
    "NIR (855nm near-IR)",
    "VIS_TL_0 (clear top-left, cycle 1)",
    "VIS_BR_0 (clear btm-right, cycle 1)",
    "F2 (425nm violet-blue)",
    "F3 (475nm blue-cyan)",
    "F4 (515nm green)",
    "F6 (640nm red)",
    "VIS_TL_1 (clear top-left, cycle 2)",
    "VIS_BR_1 (clear btm-right, cycle 2)",
    "F1 (405nm violet)",
    "F7 (690nm deep red)",
    "F8 (745nm near-IR edge)",
    "F5 (550nm green-yellow)",
    "VIS_TL_2 (clear top-left, cycle 3)",
    "VIS_BR_2 (clear btm-right, cycle 3)",
]

while True:
    readings = sensor.all_channels
    print("--- AS7343 Channel Readings ---")
    for label, value in zip(CHANNEL_LABELS, readings):
        print(f"  {label}: {value}")
    print()
    time.sleep(1)

Full test

Displays chip information, configuration, and continuous spectral readings.

examples/as7343_fulltest.py

# SPDX-FileCopyrightText: Copyright (c) 2026 Tim Cocks for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
Full test example for AS7343 14-Channel Multi-Spectral Sensor.

Displays chip information, configuration, and continuous spectral readings.

Written by Tim Cocks with assistance from Claude Code for Adafruit Industries.
"""

import time

import board

from adafruit_as7343 import AS7343, Channel, Gain, SmuxMode

#  Initialise sensor
i2c = board.I2C()

print("AS7343 Full Test")
print("================")

try:
    sensor = AS7343(i2c)
except RuntimeError as e:
    print(f"Couldn't find AS7343 chip: {e}")
    raise SystemExit

print("AS7343 found!")

#  Chip information
print("\n--- Chip Information ---")
print(f"Part ID:     0x{sensor.part_id:02X}")
print(f"Revision ID: 0x{sensor.revision_id:02X}")
print(f"Aux ID:      0x{sensor.aux_id:02X}")

#  Spectral engine configuration
print("\n--- Spectral Configuration ---")

sensor.gain = Gain.X64
gain_names = {
    Gain.X0_5: "0.5x",
    Gain.X1: "1x",
    Gain.X2: "2x",
    Gain.X4: "4x",
    Gain.X8: "8x",
    Gain.X16: "16x",
    Gain.X32: "32x",
    Gain.X64: "64x",
    Gain.X128: "128x",
    Gain.X256: "256x",
    Gain.X512: "512x",
    Gain.X1024: "1024x",
    Gain.X2048: "2048x",
}
print(f"Gain: {gain_names.get(sensor.gain, 'Unknown')}")

sensor.atime = 29
print(f"ATIME: {sensor.atime}")

sensor.astep = 599
print(f"ASTEP: {sensor.astep}")

print(f"Integration Time: {sensor.integration_time_ms:.2f} ms")

#  SMUX configuration
print("\n--- SMUX Configuration ---")

sensor.smux_mode = SmuxMode.CH18
smux_names = {
    SmuxMode.CH6: "6 channels",
    SmuxMode.CH12: "12 channels (2 cycles)",
    SmuxMode.CH18: "18 channels (3 cycles)",
}
print(f"Mode: {smux_names.get(sensor.smux_mode, 'Unknown')}")

#  Wait time configuration
print("\n--- Wait Time Configuration ---")

sensor.wtime = 100
print(f"Wait Time: {sensor.wtime} (disabled by default)")

#  Interrupt configuration
print("\n--- Interrupt Configuration ---")

sensor.persistence = 4
print(f"Persistence: {sensor.persistence}")

# NOTE: Threshold channel register r/w works but has no observed effect
# on threshold comparison - comparison is always on CH0 regardless.
sensor.threshold_channel = 0
print(f"Threshold Channel: {sensor.threshold_channel}")

sensor.spectral_threshold_low = 100
print(f"Low Threshold: {sensor.spectral_threshold_low}")

sensor.spectral_threshold_high = 60000
print(f"High Threshold: {sensor.spectral_threshold_high}")

#  LED driver configuration
print("\n--- LED Driver Configuration ---")

sensor.led_current_ma = 20
print(f"LED Current: {sensor.led_current_ma} mA")
print("LED: Off (use sensor.led_enabled = True to turn on)")

#  Continuous spectral readings
print("\n--- Spectral Readings ---")
print("Channel wavelengths: F1=405nm, F2=425nm, FZ=450nm, F3=475nm, F4=515nm, F5=550nm,")
print("FY=555nm, FXL=600nm, F6=640nm, F7=690nm, F8=745nm, NIR=855nm\n")

time.sleep(0.2)  # Let sensor stabilise

while True:
    try:
        readings = sensor.all_channels
    except TimeoutError:
        print("Read failed!")
        time.sleep(0.5)
        continue

    # Print in wavelength order for easier reading
    print(
        f"F1:{readings[Channel.F1]}"
        f"\tF2:{readings[Channel.F2]}"
        f"\tFZ:{readings[Channel.FZ]}"
        f"\tF3:{readings[Channel.F3]}"
        f"\tF4:{readings[Channel.F4]}"
        f"\tF5:{readings[Channel.F5]}"
        f"\tFY:{readings[Channel.FY]}"
        f"\tFXL:{readings[Channel.FXL]}"
        f"\tF6:{readings[Channel.F6]}"
        f"\tF7:{readings[Channel.F7]}"
        f"\tF8:{readings[Channel.F8]}"
        f"\tNIR:{readings[Channel.NIR]}"
    )

    time.sleep(1.0)

Plotter Example

Plot spectral data with the CircuitPython web editor serial plotter.

examples/as7343_plotter.py

# SPDX-FileCopyrightText: Copyright (c) 2026 Tim Cocks for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
Serial Plotter example for AS7343 14-Channel Multi-Spectral Sensor.

Outputs spectral data in a CSV format suitable for CircuitPython
web-editor plotter. Channels are ordered by wavelength:
violet → blue → green → yellow → orange → red → NIR

# Plotter data index reference:
# 0: F1  (405nm)  | 1: F2  (425nm) - Violet/UV
# 2: FZ  (450nm)  | 3: F3  (475nm) - Blue
# 4: F4  (515nm)  | 5: F5  (550nm)  | 6: FY (555nm) - Green
# 7: FXL (600nm) - Yellow/Orange
# 8: F6  (640nm)  | 9: F7  (690nm) - Red
# 10: F8 (745nm)  | 11: NIR (855nm) - Near-IR
# 12: VIS_TL_0 (Clear/broadband)

Written by Tim Cocks with assistance from Claude Code for Adafruit Industries.
"""

import time

import board

from adafruit_as7343 import AS7343, Channel, Gain, SmuxMode

# Initialise sensor
i2c = board.I2C()

try:
    sensor = AS7343(i2c)
except RuntimeError as e:
    print(f"AS7343 not found: {e}")
    raise SystemExit

sensor.gain = Gain.X64
sensor.atime = 29
sensor.astep = 599
sensor.smux_mode = SmuxMode.CH18

# Continuous plotter output
while True:
    try:
        readings = sensor.all_channels
    except TimeoutError:
        time.sleep(0.5)
        continue

    # Output in wavelength order for spectrum visualisation.
    print(f"{readings[Channel.F1]}", end=",")
    print(f"{readings[Channel.F2]}", end=",")

    # Blue (450–475 nm)
    print(f"{readings[Channel.FZ]}", end=",")
    print(f"{readings[Channel.F3]}", end=",")

    # Green (515–555 nm)
    print(f"{readings[Channel.F4]}", end=",")
    print(f"{readings[Channel.F5]}", end=",")
    print(f"{readings[Channel.FY]}", end=",")

    # Yellow/Orange (600 nm)
    print(f"{readings[Channel.FXL]}", end=",")

    # Red (640–690 nm)
    print(f"{readings[Channel.F6]}", end=",")
    print(f"{readings[Channel.F7]}", end=",")

    # Near-IR (745–855 nm)
    print(f"{readings[Channel.F8]}", end=",")
    print(f"{readings[Channel.NIR]}", end=",")

    # Clear/broadband
    print(f"{readings[Channel.VIS_TL_0]}")

    time.sleep(1.0)

Flicker Detection

Demonstration of 100Mhz/120Mhz flicker detection.

examples/as7343_flicker_detection.py

# SPDX-FileCopyrightText: Copyright (c) 2026 Tim Cocks for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
Flicker Detection example for AS7343 14-Channel Multi-Spectral Sensor.

Enables the on-chip flicker detection engine and continuously reports
whether 100 Hz or 120 Hz mains flicker is detected in the ambient light.

Written by Tim Cocks with assistance from Claude Code for Adafruit Industries.
"""

import time

import board

from adafruit_as7343 import AS7343, FlickerFreq

#  Initialise sensor
i2c = board.I2C()

print("AS7343 Flicker Detection Demo")

try:
    sensor = AS7343(i2c)
except RuntimeError as e:
    print(f"AS7343 not found: {e}")
    raise SystemExit

# Enable flicker detection
sensor.flicker_detection_enabled = True
print("Flicker detection enabled")
print("Point sensor at light source...\n")

#  Continuous flicker polling
while True:
    flicker = sensor.flicker_frequency
    raw = sensor.flicker_status

    if flicker == FlickerFreq.HZ100:
        flicker_str = "100Hz"
    elif flicker == FlickerFreq.HZ120:
        flicker_str = "120Hz"
    else:
        flicker_str = "None"

    print(f"Flicker: {flicker_str} (raw status: 0x{raw:02X} {bin(raw)})")

    time.sleep(1.0)