diff --git a/docs/examples.rst b/docs/examples.rst index 6fd9709..2a05d70 100644 --- a/docs/examples.rst +++ b/docs/examples.rst @@ -6,3 +6,22 @@ Ensure your device works with this simple test. .. literalinclude:: ../examples/ens160_simpletest.py :caption: examples/ens160_simpletest.py :linenos: + +Advanced test +-------------- + +Example showing more of the sensor capabilities. + +.. literalinclude:: ../examples/ens160_advancedtest.py + :caption: examples/ens160_advancedtest.py + :linenos: + + +DisplayIO Simpletest +--------------------- + +This is a simple test for boards with built-in display. + +.. literalinclude:: ../examples/ens160_displayio_simpletest.py + :caption: examples/ens160_displayio_simpletest.py + :linenos: diff --git a/examples/ens160_displayio_simpletest.py b/examples/ens160_displayio_simpletest.py new file mode 100644 index 0000000..b428360 --- /dev/null +++ b/examples/ens160_displayio_simpletest.py @@ -0,0 +1,48 @@ +# SPDX-FileCopyrightText: 2024 Tim Cocks for Adafruit Industries +# SPDX-FileCopyrightText: 2024 Jose D. Montoya +# +# SPDX-License-Identifier: MIT + +# Simple demo of the ENS160 air quality sensor using a built-in display. +import time +import board +from adafruit_display_text.bitmap_label import Label +from terminalio import FONT +from displayio import Group +import adafruit_ens160 + + +# 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 +ens = adafruit_ens160.ENS160(i2c) + +# Set the temperature compensation variable to the ambient temp +# for best sensor calibration +ens.temperature_compensation = 25 +# Same for ambient relative humidity +ens.humidity_compensation = 50 + +# Create a Label 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 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) + +# add the label 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 label.text property to change the text on the display + display_output_label.text = ( + f"AQI:{ens.AQI} (1-5), TVOC:{ens.TVOC} ppb, eCO2:{ens.eCO2} ppm" + ) + # wait for a bit + time.sleep(1.0)