Introduction¶

CircuitPython driver for the VEML6070 UV Index Sensor Breakout

Dependencies¶

This driver depends on:

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.

Installing from PyPI¶

On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally from PyPI. To install for current user:

pip3 install adafruit-circuitpython-veml6070

To install system-wide (this may be required in some cases):

sudo pip3 install adafruit-circuitpython-veml6070

To install in a virtual environment in your current project:

mkdir project-name && cd project-name
python3 -m venv .env
source .env/bin/activate
pip3 install adafruit-circuitpython-veml6070

Usage Example¶

import time
import board
import busio
from adafruit_veml6070 import VEML6070

with busio.I2C(board.SCL, board.SDA) as i2c:
    uv = VEML6070(i2c)
    # Alternative constructors with parameters
    #uv = VEML6070(i2c, 'VEML6070_1_T')
    #uv = VEML6070(i2c, 'VEML6070_HALF_T', True)

    # take 10 readings
    for j in range(10):
        uv_raw = uv.uv_raw
        risk_level = uv.get_index(uv_raw)
        print('Reading: {0} | Risk Level: {1}'.format(uv_raw, risk_level))
        time.sleep(1)

Contributing¶

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Documentation¶

For information on building library documentation, please check out this guide.

Table of Contents¶

Simple test¶

Ensure your device works with this simple test.

examples/veml6070_simpletest.py¶

# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
# SPDX-License-Identifier: MIT

# VEML6070 Driver Example Code

import time
import busio
import board
import adafruit_veml6070

with busio.I2C(board.SCL, board.SDA) as i2c:
    uv = adafruit_veml6070.VEML6070(i2c)
    # Alternative constructors with parameters
    # uv = adafruit_veml6070.VEML6070(i2c, 'VEML6070_1_T')
    # uv = adafruit_veml6070.VEML6070(i2c, 'VEML6070_HALF_T', True)

    # take 10 readings
    for j in range(10):
        uv_raw = uv.uv_raw
        risk_level = uv.get_index(uv_raw)
        print("Reading: {0} | Risk Level: {1}".format(uv_raw, risk_level))
        time.sleep(1)

`adafruit_veml6070` - VEML6070 UV Sensor¶

CircuitPython library to support VEML6070 UV Index sensor.

Author(s): Limor Fried & Michael Schroeder

Implementation Notes¶

Hardware:

Adafruit VEML6070 UV Index Sensor Breakout (Product ID: 2899)

Software and Dependencies:

Adafruit CircuitPython firmware (2.2.0+) for the ESP8622 and M0-based boards: https://github.com/adafruit/circuitpython/releases
Adafruit’s Bus Device library: https://github.com/adafruit/Adafruit_CircuitPython_BusDevice

Notes:

Datasheet: https://cdn-learn.adafruit.com/assets/assets/000/032/482/original/veml6070.pdf

class adafruit_veml6070.VEML6070(i2c_bus, _veml6070_it='VEML6070_1_T', ack=False)[source]¶

Driver base for the VEML6070 UV Light Sensor

Parameters:

i2c_bus – The busio.I2C object to use. This is the only required parameter.
_veml6070_it (str) – The integration time you’d like to set initially. Availble options: VEML6070_HALF_T, VEML6070_1_T, VEML6070_2_T, and VEML6070_4_T. The higher the ‘_x_’ value, the more accurate the reading is (at the cost of less samples per reading). Defaults to VEML6070_1_T if parameter not passed. To change setting after intialization, use [veml6070].set_integration_time(new_it).
ack (bool) – The inital setting of ACKnowledge on alert. Defaults to False if parameter not passed. To change setting after intialization, use [veml6070].set_ack(new_ack).

Example:

from board import *
import busio, veml6070, time

with busio.I2C(SCL, SDA) as i2c:
    uv = veml6070.VEML6070(i2c, 'VEML6070_1_T', True)

    # take 10 readings
    for j in range(10):
        uv_raw = uv.uv_raw
        risk_level = uv.get_index(uv_raw)
        print('Reading: ', uv_raw, ' | Risk Level: ', risk_level)
        time.sleep(1)

ack¶: Turns on or off the ACKnowledge function of the sensor. The ACK function will send a signal to the host when the value of the sensed UV light changes beyond the programmed threshold.

ack_threshold¶: The ACKnowledge Threshold, which alerts the host controller to value changes greater than the threshold. Available settings are: 0 = 102 steps; 1 = 145 steps. 0 is the default setting.

get_index(_raw)[source]¶

Calculates the UV Risk Level based on the captured UV reading. Requres the _raw argument (from veml6070.uv_raw). Risk level is available for Integration Times (IT) 1, 2, & 4. The result is automatically scaled to the current IT setting.

LEVEL* UV Index ===== ======== LOW 0-2 MODERATE 3-5 HIGH 6-7 VERY HIGH 8-10 EXTREME >=11

Not to be considered as accurate condition reporting. Calculation is based on VEML6070 Application Notes: http://www.vishay.com/docs/84310/designingveml6070.pdf

integration_time¶: The Integration Time of the sensor, which is the refresh interval of the sensor. The higher the refresh interval, the more accurate the reading is (at the cost of less sampling). The available settings are: VEML6070_HALF_T, VEML6070_1_T, VEML6070_2_T, VEML6070_4_T.

sleep()[source]¶: Puts the VEML6070 into sleep (‘shutdown’) mode. Datasheet claims a current draw of 1uA while in shutdown.

uv_raw¶: Reads and returns the value of the UV intensity.

wake()[source]¶: Wakes the VEML6070 from sleep. [veml6070].uv_raw will also wake from sleep.