example_basic.md

Description

Once the Arduino library has been installed, the Example1_BasicReadings.ino example file can be accessed from the File > Examples > SparkFun STHS34PF80 Arduino Library > Example1_BasicReadings drop-down menu. This example reads the human presence detection values from the STHS34PF80 sensor through the I²C interface and displays them in the Serial Monitor.

??? code "Example1_BasicReadings.ino" ??? info "Code Verification" This code was last verified to be functional under the following parameters:

		--8<-- "https://raw.githubusercontent.com/sparkfun/SparkFun_STHS34PF80_Arduino_Library/main/examples/Example1_BasicReadings/Example1_BasicReadings.ino:15:18"

```  c++ linenums="1"
--8<-- "https://raw.githubusercontent.com/sparkfun/SparkFun_STHS34PF80_Arduino_Library/main/examples/Example1_BasicReadings/Example1_BasicReadings.ino"
```

Hardware Connections

For this example, users simply need to connect their Qwiic Human Presence/Motion Sensor board to their microcontroller, utilizing the I²C interface. With the recommended hardware, users can easily connect their boards with the Qwiic connection system.

[{ width="400" }](./assets/img/hookup_guide/example-basic-1x1.jpg "Click to enlarge")

[{ width="400" }](./assets/img/hookup_guide/example-basic-mini.jpg "Click to enlarge")

*The Qwiic Human Presence/Motion Sensor boards are connected to a RedBoard Plus, with a [Qwiic cable](https://www.sparkfun.com/products/15081).*

??? info "Pin Connections" For users with a development board without a Qwiic connector, the table below illustrates the required pin connections. Make sure that the logic-level of the sensor is compatible with the development board that is being connected.

<center>

| Sensor Pin | Microcontroller Pin | RedBoard/Uno |
| :--------: | :------------------ | :----------: |
| `SCL` | I<sup>2</sup>C - Serial Clock | `SCL`/`A5` |
| `SDA` | I<sup>2</sup>C - Serial Data  | `SDA`/`A4` |
| `3V3` | Power: **1.7 to 3.6V**        | `3.3V`     |
| `GND` | Ground                        | `GND`      |

</center>

Serial Monitor

This example reads the human presence detection values from the STHS34PF80 sensor and displays them in the Serial Monitor. It prints the raw IR presence (cm^-1), if the motion detection flag was triggered, and temperature (°C).

[{ width="400" }](./assets/img/hookup_guide/example-basic.gif "Click to enlarge") The human presence detection values being streamed from the STHS34PF80 sensor into the [Serial Monitor](https://learn.sparkfun.com/tutorials/112).

!!! tip For this example wave different objects in front of the sensor, with varying ranges. Objects that emit black body radiation work the best and should trigger the motion detected flag.