{ "info": { "author": "Ale\u0161 Kom\u00e1rek", "author_email": "ales.komarek@newt.cz", "bugtrack_url": null, "classifiers": [ "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Operating System :: POSIX :: Linux", "Programming Language :: Python" ], "description": "\n======================================\nRoboPhery: Robotic Peripherals Project\n======================================\n\n.. image:: https://readthedocs.org/projects/robophery/badge/?version=latest\n :target: http://robophery.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://badges.gitter.im/Join%20Chat.svg\n :target: https://gitter.im/robophery/Lobby\n :alt: Join Chat on Gitter.im\n\nDesign and implementation of Python library for interfacing low level hardware\nsensors and actuators with MQTT and TSDB bindings. The system architecture is\ndesigned to be so simple at hardware level to support sigle-board\nmicrocontrollers like ESP2866, ESP32 modules as well as sigle-board computers\nbased on ARM or x86 architectures. The communication among devices is handled\nby the standard MQTT message bus.\n\nInstallation\n============\n\nVirtualenv\n----------\n\nInstall required dependencies\n\n.. code-block:: bash\n\n apt-get install python-dev libyaml-dev git python-virtualenv\n\nPrepare clean virtualenv\n\n.. code-block:: bash\n\n virtualenv /opt/robophery\n\nClone this repository\n\n.. code-block:: bash\n\n git clone https://github.com/cznewt/robophery.git\n\nInstall dependencies and robophery\n\n.. code-block:: bash\n\n source /opt/robophery/bin/activate\n pip install -r requirements.txt\n python setup.py install\n\nService\n-------\n\nIf you are running systemd-enabled distribution, setup systemd unit file to\nstart robophery automatically:\n\n.. code-block:: bash\n\n cat << EOF >>/etc/systemd/system/robophery.service\n [Unit]\n Description=robophery manager\n Wants=mosquitto.service\n After=network.target mosquitto.service\n \n [Service]\n Type=simple\n User=root\n Group=root\n WorkingDirectory=/opt/robophery\n Environment=ROBOPHERY_CONF=/etc/robophery\n ExecStart=/opt/robophery/bin/rp_manager\n RestartSec=5\n Restart=on-failure\n \n [Install]\n WantedBy=multi-user.target\n EOF\n\nCreate ``/opt/robophery`` directory and config file\n``/opt/robophery/robophery_conf.py`` and start the service.\n\n.. code-block:: bash\n\n systemctl daemon-reload\n systemctl start robophery\n systemctl enable robophery\n\nTo check status of a service, use ``systemctl status -l robophery``.\nTo see logs, you can use systemd journal (eg. ``journalctl -u robophery -f``)\n\nConfiguration\n=============\n\nYou can use `salt-formula-robophery\n`_ to automate both installation and\nconfiguration or you can provide config file in any other way.\n\nExample\n-------\n\nFollowing example configuration will setup robophery running on Raspberry Pi\nand will collect data from DHT22 sensor attached to GPIO pin 3 and publish it\nto MQTT every 60 seconds.\n\n::\n\n CONF = {\n 'name': 'mylittleraspberry',\n 'log_level': 'debug',\n 'log_handlers': ['console', 'syslog'],\n 'read_interval': 10000,\n 'publish_interval': 60000,\n 'platform': 'raspberrypi',\n 'config': {\n 'comm': {\n 'default_mqtt': {\n 'host': 'mymqttserver',\n 'port': 1883,\n 'class': 'robophery.comm.linux.mqtt.PahoMqttComm'\n },\n },\n 'interface': {\n 'local_gpio': {\n 'engine': 'gpio',\n 'class': 'robophery.platform.rpi.gpio.RaspberryPiGpioInterface'\n }\n },\n 'module': {\n 'dht22': {\n 'data': {\n 'pin': 3,\n },\n 'class': 'robophery.module.gpio.dht22.Dht22Module'\n }\n }\n }\n }\n\nMore Information\n================\n\n* `Offical RoboPhery Documentation `_\n* `Sensor Markup Language (SenML) `_\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://www.github.cz/cznewt/robophery", "keywords": "", "license": "Apache Software License", "maintainer": "", "maintainer_email": "", "name": "robophery", "package_url": "https://pypi.org/project/robophery/", "platform": "", "project_url": "https://pypi.org/project/robophery/", "project_urls": { "Homepage": "http://www.github.cz/cznewt/robophery" }, "release_url": "https://pypi.org/project/robophery/0.2/", "requires_dist": null, "requires_python": "", "summary": "Python library for interfacing low level hardware sensors and actuators with MQTT bindings.", "version": "0.2" }, "last_serial": 3316053, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "a361038ed4e4aad51979016bbcf405b6", "sha256": "8c1a83468ce4b974c9cefa3332453ca6a63af8be031b6f7b650fc3175a1ad0da" }, "downloads": -1, "filename": "robophery-0.2.tar.gz", "has_sig": false, "md5_digest": "a361038ed4e4aad51979016bbcf405b6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 71469, "upload_time": "2017-11-08T12:40:10", "url": "https://files.pythonhosted.org/packages/97/b0/57f9f33849462bbe89251cda2b4093ab6b9eac1f8bc5f04b9be595188141/robophery-0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a361038ed4e4aad51979016bbcf405b6", "sha256": "8c1a83468ce4b974c9cefa3332453ca6a63af8be031b6f7b650fc3175a1ad0da" }, "downloads": -1, "filename": "robophery-0.2.tar.gz", "has_sig": false, "md5_digest": "a361038ed4e4aad51979016bbcf405b6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 71469, "upload_time": "2017-11-08T12:40:10", "url": "https://files.pythonhosted.org/packages/97/b0/57f9f33849462bbe89251cda2b4093ab6b9eac1f8bc5f04b9be595188141/robophery-0.2.tar.gz" } ] }