{"id":14978045,"url":"https://github.com/ndoornekamp/senseair_s8","last_synced_at":"2025-10-28T07:31:15.758Z","repository":{"id":57465525,"uuid":"313040340","full_name":"ndoornekamp/senseair_s8","owner":"ndoornekamp","description":"Python module for reading CO2 concentration from a Senseair S8 sensor connected to a Raspberry Pi","archived":false,"fork":false,"pushed_at":"2023-11-28T18:54:41.000Z","size":237,"stargazers_count":13,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-01T12:44:13.518Z","etag":null,"topics":["co2","co2-sensor","python","python-3","raspberry-pi","senseair-s8"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ndoornekamp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-11-15T13:44:19.000Z","updated_at":"2025-01-24T13:16:38.000Z","dependencies_parsed_at":"2023-12-21T05:34:55.394Z","dependency_job_id":"5a9c95f5-7c41-4257-a029-d900fd13b456","html_url":"https://github.com/ndoornekamp/senseair_s8","commit_stats":{"total_commits":10,"total_committers":3,"mean_commits":"3.3333333333333335","dds":0.4,"last_synced_commit":"905f21137ad91389c6e06c2cbf8efb23fa66068f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndoornekamp%2Fsenseair_s8","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndoornekamp%2Fsenseair_s8/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndoornekamp%2Fsenseair_s8/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndoornekamp%2Fsenseair_s8/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ndoornekamp","download_url":"https://codeload.github.com/ndoornekamp/senseair_s8/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238614438,"owners_count":19501458,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["co2","co2-sensor","python","python-3","raspberry-pi","senseair-s8"],"created_at":"2024-09-24T13:56:46.369Z","updated_at":"2025-10-28T07:31:15.748Z","avatar_url":"https://github.com/ndoornekamp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Senseair S8 for Python\n\nPython module for reading CO2 concentration from a Senseair S8 sensor connected to a Raspberry Pi\n\n## Connecting the Senseair S8 to your Raspberry Pi\n\nHook up the Senseair S8 to your Raspberry Pi using the following schematic:\n\n![Connection schematic](connection_schematic.PNG \"Connection schematic\")\n\nImage source: \u003chttp://co2meters.com/Documentation/AppNotes/AN168-S8-raspberry-pi-uart.pdf\u003e\n\n## Module installation\n\n```bash\npip install senseair-s8\n```\n\n## Usage\n\nAs a module:\n\n```python\nfrom senseair_s8 import SenseairS8, SenseairS8Exception\n\nsensor = SenseairS8()\ntry:\n    co2 = sensor.co2()\n    print(f\"CO2 concentration: {co2} ppm\")\nexcept SenseairS8Exception as e:\n    print(f\"Failed to read CO2: {e}\")\n```\n\nFrom the command line (this logs the CO2 concentration at ~1 second intervals):\n\n```bash\npython -m senseair_s8\n```\n\n## Troubleshooting\n\n- This module expects the sensor to be connected to port `/dev/ttyS0`. It was only tested using that port, but you can override this setting when initializing the sensor:\n\n```python\nsensor = SenseairS8(port='/dev/ttyS0')\n```\n\n- Out of the box, `/dev/ttyS0` is disabled on a Raspberry Pi, resulting in a `permission denied` error. You can enable it by:\n    1. Run `sudo raspi-config`\n    2. Select Interfacing options\n    3. Select P6 Serial\n    4. Select No for login console\n    5. Select Yes for serial port hardware\n    6. OK, Finish, Reboot - Yes\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndoornekamp%2Fsenseair_s8","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fndoornekamp%2Fsenseair_s8","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndoornekamp%2Fsenseair_s8/lists"}