Metadata-Version: 2.1
Name: senseair-s8
Version: 0.0.9
Summary: Python module for reading CO2 concentration from a Senseair S8 sensor connected to a Raspberry Pi
Home-page: https://github.com/ndoornekamp/senseair_s8
Author: Nick Doornekamp
Author-email: nddoornekamp@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: pyserial

# Introduction
Python module for reading CO2 concentration from a Senseair S8 sensor connected to a Raspberry Pi

# Connecting the Senseair S8 to your Raspberry Pi
Hook up the Senseair S8 to your Raspberry Pi using the following schematic: 

![Connection schematic](connection_schematic.PNG "Connection schematic")

Image source: http://co2meters.com/Documentation/AppNotes/AN168-S8-raspberry-pi-uart.pdf 

# Module installation
```
pip install senseair-s8
```

# Usage
As a module:
```
from senseair_s8 import SenseairS8

senseair_s8 = SenseairS8()    
print(senseair_s8.co2())
```

From the command line:
```
python -m senseair_s8
```

# Troubleshooting
- This module expects the sensor to be connected to port `/dev/ttyS0`. It was only tested using that port, but you can override this settings when initialising the sensor:
```
sensair_s8 = SenseairS8(port='/dev/ttyS0')
```
- Out of the box, `/dev/ttyS0` is disabled on a Raspberry Pi, resulting in a `permission denied`-error. You can enable it by:
    1. Run `sudo raspi-config`
    2. Select Interfacting options
    3. Select P6 Serial
    4. Select No for login console
    5. Select Yes for serial port hardware
    6. OK, Finish, Reboot - Yes

