delcom904x


Namedelcom904x JSON
Version 0.4.0 PyPI version JSON
download
home_page
SummaryA python module to control Delcom USBLMP Products 904x multi-color, USB, visual signal indicators
upload_time2023-08-11 03:41:47
maintainer
docs_urlNone
author
requires_python>=3.9
licenseCopyright (c) 2021, Aaron Linville <aaron@linville.org> Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
keywords hidapi usb-hid iot-device
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            delcom904x
==========
delcom904x is a python class and command-line script to control the [Delcom Products 904x
series multi-color visual signal indicators](http://www.delcomproducts.com/products_USBLMP.asp).
These are USB HID devices that are easily controllable from most platforms.

It has been tested with the [904005-SB](http://www.delcomproducts.com/productdetails.asp?productnum=904005-SB)
but should work with any of the other models without any issues. The yellow in the green,
red and *yellow* indicators is wired the same as blue. There also doesn't appear to be a
method of detecting if the attached indicator supports blue or yellow, so blue and yellow
commands are synonyms.


Installation
------------

        $ pip install delcom904x
        $ control_delcom904x --green --red --flash --cycle


`control-delcom904x` usage
-----------------------------

        -h, --help        show this help message and exit
        --list            List all USB devices.
        --info            Returns info on the device.
        --red             Enable the red light.
        --green           Enable the green light.
        --blue            Enable the blue light.
        --yellow          Enable the yellow light (if equipped; synonym for blue).
        --flash           Turns on flashing.
        --cycle [100]     Turns on cycling.
        --intensity [80]  Sets brightness: 0-100.
        --buzzer          Buzzes three times.
        --reset           Resets the device.


Python Code Example
-------------------

```python
import delcom904x
light = delcom904x.DelcomMultiColorIndicator()
light.set_color(delcom904x.red, flashing=True)
```


udev Notes
----------

On Linux machines, the default udev rulesets may set the permissions on the device to only
be accessible to the root user. Add the following rule to `/etc/udev/rules.d/` and
re-plugin the indicator to allow all users to access the device (optionally, consider
changing `MODE="0666"` to `GROUP="dialout"` to allow only the dialout group access).

        SUBSYSTEMS=="usb", ATTRS{idVendor}=="0fc5", ATTRS{idProduct}=="b080", MODE="0666"


            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "delcom904x",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "",
    "keywords": "hidapi,usb-hid,iot-device",
    "author": "",
    "author_email": "Aaron Linville <aaron@linville.org>",
    "download_url": "",
    "platform": null,
    "description": "delcom904x\n==========\ndelcom904x is a python class and command-line script to control the [Delcom Products 904x\nseries multi-color visual signal indicators](http://www.delcomproducts.com/products_USBLMP.asp).\nThese are USB HID devices that are easily controllable from most platforms.\n\nIt has been tested with the [904005-SB](http://www.delcomproducts.com/productdetails.asp?productnum=904005-SB)\nbut should work with any of the other models without any issues. The yellow in the green,\nred and *yellow* indicators is wired the same as blue. There also doesn't appear to be a\nmethod of detecting if the attached indicator supports blue or yellow, so blue and yellow\ncommands are synonyms.\n\n\nInstallation\n------------\n\n        $ pip install delcom904x\n        $ control_delcom904x --green --red --flash --cycle\n\n\n`control-delcom904x` usage\n-----------------------------\n\n        -h, --help        show this help message and exit\n        --list            List all USB devices.\n        --info            Returns info on the device.\n        --red             Enable the red light.\n        --green           Enable the green light.\n        --blue            Enable the blue light.\n        --yellow          Enable the yellow light (if equipped; synonym for blue).\n        --flash           Turns on flashing.\n        --cycle [100]     Turns on cycling.\n        --intensity [80]  Sets brightness: 0-100.\n        --buzzer          Buzzes three times.\n        --reset           Resets the device.\n\n\nPython Code Example\n-------------------\n\n```python\nimport delcom904x\nlight = delcom904x.DelcomMultiColorIndicator()\nlight.set_color(delcom904x.red, flashing=True)\n```\n\n\nudev Notes\n----------\n\nOn Linux machines, the default udev rulesets may set the permissions on the device to only\nbe accessible to the root user. Add the following rule to `/etc/udev/rules.d/` and\nre-plugin the indicator to allow all users to access the device (optionally, consider\nchanging `MODE=\"0666\"` to `GROUP=\"dialout\"` to allow only the dialout group access).\n\n        SUBSYSTEMS==\"usb\", ATTRS{idVendor}==\"0fc5\", ATTRS{idProduct}==\"b080\", MODE=\"0666\"\n\n",
    "bugtrack_url": null,
    "license": "Copyright (c) 2021, Aaron Linville <aaron@linville.org>  Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.  THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ",
    "summary": "A python module to control Delcom USBLMP Products 904x multi-color, USB, visual signal indicators",
    "version": "0.4.0",
    "project_urls": {
        "Homepage": "https://github.com/linville/delcom904x/"
    },
    "split_keywords": [
        "hidapi",
        "usb-hid",
        "iot-device"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6a96e215b2f9e53f4d4d04a6d8fcd1654c95ee9b97db9cf0f97610cafe711707",
                "md5": "1a5bef93f5219cb88791309edd556fdb",
                "sha256": "736dae319af4ac55b108c1e5a649b2d3cde364e448be808f9e67d0e7e8069517"
            },
            "downloads": -1,
            "filename": "delcom904x-0.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1a5bef93f5219cb88791309edd556fdb",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 6657,
            "upload_time": "2023-08-11T03:41:47",
            "upload_time_iso_8601": "2023-08-11T03:41:47.109151Z",
            "url": "https://files.pythonhosted.org/packages/6a/96/e215b2f9e53f4d4d04a6d8fcd1654c95ee9b97db9cf0f97610cafe711707/delcom904x-0.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-11 03:41:47",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "linville",
    "github_project": "delcom904x",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "delcom904x"
}
        
Elapsed time: 0.12075s