{"id":19738376,"url":"https://github.com/sensirion/python-uart-scc1","last_synced_at":"2025-02-27T22:24:56.195Z","repository":{"id":222512372,"uuid":"754655574","full_name":"Sensirion/python-uart-scc1","owner":"Sensirion","description":"Python driver for Sensirion SCC1-USB Cable","archived":false,"fork":false,"pushed_at":"2024-04-10T09:04:22.000Z","size":52,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-10T21:47:23.585Z","etag":null,"topics":["liquid-flow","scc1","sensirion","shdlc","uart","usb"],"latest_commit_sha":null,"homepage":"https://www.sensirion.com/products/catalog/SCC1-USB","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sensirion.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-08T14:11:38.000Z","updated_at":"2024-03-16T09:25:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"e97db8b0-10f5-41b2-b956-0d0362126285","html_url":"https://github.com/Sensirion/python-uart-scc1","commit_stats":null,"previous_names":["sensirion/python-uart-scc1"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sensirion%2Fpython-uart-scc1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sensirion%2Fpython-uart-scc1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sensirion%2Fpython-uart-scc1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sensirion%2Fpython-uart-scc1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sensirion","download_url":"https://codeload.github.com/Sensirion/python-uart-scc1/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241067946,"owners_count":19903923,"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":["liquid-flow","scc1","sensirion","shdlc","uart","usb"],"created_at":"2024-11-12T01:14:02.460Z","updated_at":"2025-02-27T22:24:56.166Z","avatar_url":"https://github.com/Sensirion.png","language":"Python","readme":"# python-uart-scc1\nThis repository provides a Python driver for [Sensirion SCC1-USB Cable](https://www.sensirion.com/products/catalog/SCC1-USB/).\nThe detailed technical description of the SCC1-USB cable is provided in the [datasheet](https://www.sensirion.com/media/documents/EE77392F/65290BF6/LQ_DS_SCC1-RS485-USB_Datasheet.pdf).\n\n## Feature overview\n\nOn one hand the SCC1-USB exposes an API to efficiently use the supported sensors. So far support is only added for the [SLF3x-Sensor family](https://sensirion.com/products/catalog/SLF3C-1300F).\n\nOn the other hand the cable can be used as USB to I2c bridge for any Sensirion I2c sensor that can be plugged to the cable.\n\nFor both scenarios an example is available in the example subfolder of this repository.\n\n**Note**: Using the cable as USB to I2c bridge will not allow to achieve the same throughput as with the embedded API.\n\nThe API of the driver is described on the [documentation page](https://sensirion.github.io/python-uart-scc1) of this repository\n\n## Getting started\n\n### Installation\n\nIt is recommended to use a virtual environment. In any case you can install the package via pip by typing:\n\n```bash\npip install sensirion-uart-scc1\n```\n\nIf you have cloned the repository you can install the package and all it dependencies using [poetry](https://python-poetry.org/).\n\n```bash\npoetry install\n```\n\n### Running the examples\n\nWe provide two examples to show two basic usage scenarios of the driver\n\n- **SLF3x Usage**\n  This example does not require any additional dependency. Once the package `sensirion-uart-scc1` is installed the example is run by typing:\n\n  ```bash\n    python ./examples/scc1_slf3x_example/slf3x_usage.py --serial-port \u003cyour-com-port\u003e\n  ```\n\n- **USB-I2c-Bridge**\n  This example shows how a public python driver can be used with the SCC1-USB cable. The example uses the public driver `sensirion_i2c_sf06_lf`. Before you run the example you need to install this driver.\n\n  ```bash\n    pip install sensirion_i2c_sf06_lf\n  ```\n\n  After having installed the driver the example is run by typing:\n\n  ```bash\n    python ./examples/scc1_usb_to_i2c/scc1_usb_2_i2c_usage.py --serial-port \u003cyour-com-port\u003e\n  ```\n\n## Contributing\n\nYou are very welcome to open issues and to create pull requests.\n\nNevertheless you need to understand that we cannot consider pull request that do not pass the CI-pipeline.\n\nThis section explains in short how you can make sure that your contribution passes all the checks of the CI pipeline.\n\nThe repository uses poetry for dependency management. It is used in the CI pipeline as well.\nThe easiest way to be conformant to our coding style will be to use poetry for your contributions as well. This will allow to test and check your contributions locally before creating pull requests.\n\n### Installing and running tests\n\nFor testing some extra dependencies are required that need to be installed.\n\n```bash\npoetry install --with test\n```\n\nThe tests (including those that are marked) can be executed by tying:\n\n```bash\npoetry run pytest\n```\n\n**Note**: On github no tests that require hardware can be run. Test cases that rely on attached hardware need to be decorated with `@pytest.mark.needs_hardware`\n\n### Checking code-formatting\n\nMake sure that you code is properly formatted. The CI pipeline will check and fail if this is not the case. To check the code-formatting before pushing to the repository type:\n\n```bash\npoetry run flake8\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsensirion%2Fpython-uart-scc1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsensirion%2Fpython-uart-scc1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsensirion%2Fpython-uart-scc1/lists"}