Metadata-Version: 2.1
Name: sensirion-i2c-sts3x
Version: 1.0.0
Summary: I2C driver for the Sensirion STS3X sensor family
Home-page: UNKNOWN
Author: Sensirion
Author-email: info@sensirion.com
License: BSD
Project-URL: Documentation, https://sensirion.github.io/python-i2c-sts3x
Project-URL: Repository, https://github.com/Sensirion/python-i2c-sts3x
Project-URL: Changelog, https://github.com/Sensirion/python-i2c-sts3x/blob/master/CHANGELOG.rst
Keywords: Sensirion STS3X
        I2C
        STS30
        STS30A
        STS31A
        STS31
        STS32
        STS33
        STS35
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
Requires-Dist: sensirion-i2c-driver (<2.0,>=1.0.0)
Requires-Dist: sensirion-driver-adapters (<3.0,>=2.1.8)
Requires-Dist: sensirion-driver-support-types (~=0.2.0)
Requires-Dist: sensirion-shdlc-sensorbridge (~=0.1.1)
Provides-Extra: docs
Requires-Dist: click (==8.0.4) ; extra == 'docs'
Requires-Dist: jinja2 (==3.0.1) ; extra == 'docs'
Requires-Dist: sphinx (~=4.2.0) ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme (~=0.5.2) ; extra == 'docs'
Provides-Extra: test
Requires-Dist: flake8 (~=3.7.8) ; extra == 'test'
Requires-Dist: pytest (~=6.2.5) ; extra == 'test'
Requires-Dist: pytest-cov (~=3.0.0) ; extra == 'test'

# Python I2C Driver for Sensirion STS3X

This repository contains the Python driver to communicate with a Sensirion sensor of the STS3X family over I2C. 

<img src="https://raw.githubusercontent.com/Sensirion/python-i2c-sts3x/master/images/STS3x.png"
    width="300px" alt="STS3X picture">


Click [here](https://www.sensirion.com/search/products?q=STS3x) to learn more about the Sensirion STS3X sensor family.



## Supported sensor types

| Sensor name   | IÂ²C Addresses  |
| ------------- | -------------- |
|[STS30](https://sensirion.com/products/catalog/STS30-DIS)| **0x4A**, 0x4B|
|[STS30A](https://www.sensirion.com/products/catalog/STS30A-DIS)| **0x4A**, 0x4B|
|[STS31A](https://www.sensirion.com/products/catalog/STS31A-DIS)| **0x4A**, 0x4B|
|[STS31](https://www.sensirion.com/products/catalog/STS31-DIS)| **0x4A**, 0x4B|
|[STS32](https://www.sensirion.com/products/catalog/STS32-DIS)| **0x4A**, 0x4B|
|[STS33](https://www.sensirion.com/products/catalog/STS33-DIS)| **0x4A**, 0x4B|
|[STS35](https://www.sensirion.com/products/catalog/STS35-DIS)| **0x4A**, 0x4B|

The following instructions and examples use a *STS30*.



## Connect the sensor

You can connect your sensor over a [SEK-SensorBridge](https://developer.sensirion.com/sensirion-products/sek-sensorbridge/).
For special setups you find the sensor pinout in the section below.

<details><summary>Sensor pinout</summary>
<p>
<img src="https://raw.githubusercontent.com/Sensirion/python-i2c-sts3x/master/images/STS3x_pinout.png"
     width="300px" alt="sensor wiring picture">

| *Pin* | *Cable Color* | *Name* | *Description*  | *Comments* |
|-------|---------------|:------:|----------------|------------|
| 1 | green | SDA | I2C: Serial data input / output | 
| 2 | black | GND | Ground | 
| 3 | yellow | SCL | I2C: Serial clock input | 
| 4 | red | VDD | Supply Voltage | 2.15V to 5.5V


</p>
</details>


## Documentation & Quickstart

See the [documentation page](https://sensirion.github.io/python-i2c-sts3x) for an API description and a 
[quickstart](https://sensirion.github.io/python-i2c-sts3x/execute-measurements.html) example.


## Contributing

We develop and test this driver using our company internal tools (version
control, continuous integration, code review etc.) and automatically
synchronize the `master` branch with GitHub. But this doesn't mean that we
don't respond to issues or don't accept pull requests on GitHub. In fact,
you're very welcome to open issues or create pull requests :-)

### Check coding style

The coding style can be checked with [`flake8`](http://flake8.pycqa.org/):

```bash
pip install -e .[test]  # Install requirements
flake8                  # Run style check
```

In addition, we check the formatting of files with
[`editorconfig-checker`](https://editorconfig-checker.github.io/):

```bash
pip install editorconfig-checker==2.0.3   # Install requirements
editorconfig-checker                      # Run check
```

## License

See [LICENSE](LICENSE).


