{ "info": { "author": "Sidney Kuyateh", "author_email": "sidneyjohn23@icloud.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# python-devoloDHC\n\n## python API for Devolo Home Control\n\nThis python API allows you to control your Devolo Home Control devices.\nThe following devices are currently supported:\n\n- Devolo Smart Metering Plug (get/set)\n- Devolo Wall Switch / Devolo Key Fob (get/set)\n- Devolo Siren (get/set)\n- Devolo Room Thermostat / Radiator Thermostat(valve) (get/set)\n- Devolo Flood Sensor (get)\n- Devolo Humidity Sensor (get)\n- Devolo Motion Sensor (get)\n- Devolo Door/Window Contact (get)\n- http devices (get/set)

\n- Scenes (get/set)\n- Groups (get/set)\n- Timers (get/set)\n- Rules (get/set)\n- Messages (get/set)

\n- Qubino \"Flush Shutter\" ZMNHCD1 (get/set)\n- Qubino \"Flush 1D Relay\" ZMNHND1 (get/set)\n- Qubino \"Flush 2 Relay\" ZMNHBD1 (get/set one or both contacts)\n- Qubino \"Flush Dimmer\" ZMNHDD1 (get/set/dim)

\n- Busch-Jaeger Duro 2000 - ZME_05461 (get/set) \n\nChanging settings will appear in Devolo web interface / Apps daily diary with your account as usual.\n\nFeel free to submit an issue or pull request to add more.\n\nNeed a php version of this API ? [php-devoloDHC](https://github.com/KiboOst/php-devoloDHC)\n\n*This isn't an official API | USE AT YOUR OWN RISK!
\nAnyway this API use exact same commands as your Devolo Home Control, which is based on ProSyst mBS SDK. When you ask bad stuff to the central, this one doesn't burn but just answer this isn't possible or allowed.
\nThis API is reverse-engineered, provided for research and development for interoperability.*\n\n---\n:exclamation: **WARNING** :exclamation:\n\nI'm sorry to say that I have switch to Jeedom and do not use anymore Devolo Home Control solution.\nThis API has work flawlessly since it's creation here, but in case of coming problems I won't be able to fix or extend it anymore.\n\nIf someone want to continue further development of this API, contact me.\n\n---\n\n[Requirements](#requirements)
\n[How-to](#how-to)
\n[Connection](#connection)
\n[Reading datas](#reading-operations)
\n[Changing datas](#changing-operations)
\n[Consumption](#consumption)
\n[Unsupported device](#unsupported-device)
\n[Version history](#version-history)
\n\n## Requirements\n- Python 2.7.11+ / Python 3+\n- The API require internet access (it will authenticate against Devolo servers).\n\n[⇑](#python-devolodhc)\n\n## How-to\n- Download module/pyDHC.py.\n- If you can, allow write permission for the API folder. It will support keeping DHC user session between consecutive executions of your script (also lot faster).\n- load pyDHC module.\n- Start it with your Devolo username/password.\n\n#### Connection\n\n```python\nimport sys\nsys.path.append(r'C:\\path\\to\\api')\nfrom pyDHC import pyDHC\n\nDHC = pyDHC('login', 'password')\nif DHC.error: print(DHC.error)\n```\n\nIf you have several Central Units, or keep the demo central on your *mydevolo* page, you can choose which to connect to:\n\n```python\n#(login | password | which central, default 0)\nDHC = pyDHC('login', 'password', 1)\nif DHC.error: print(DHC.error)\n```\n\nLet the fun begin:\n\n```python\n#for better looking print, we will use pprint:\nimport pprint\npp = pprint.PrettyPrinter(indent=4)\n\n#get some infos on your Devolo Home Control box:\ninfos = DHC.getInfos()\npp.pprint(infos)\n```\n[⇑](python-devolodhc)\n\n#### READING OPERATIONS
\n*Change devices names by yours!*\n\n```python\n#get all devices in a zone:\nzone = DHC.getDevicesByZone('living room')\npp.pprint(zone)\n\n#get rule or timer state:\nstate = DHC.isRuleActive(\"MyRule\")\npp.pprint(state)\nstate = DHC.isTimerActive(\"MyTimer\")\npp.pprint(state)\n\n#Check if a device is on (0=off, 1=on)\nstate = DHC.isDeviceOn(\"My Wall Plug\")\npp.pprint(state)\n\n#Check for devices with 2 relays (eg. Qubino Flush 2 Relay ZMNHBD1) is on (0=off, 1=on)\n#contact 1\nstate = DHC.isDeviceOn(\"myRelay\", 1)\npp.pprint(state['result'])\n#contact 2\nstate = DHC.isDeviceOn(\"myRelay\", 2)\npp.pprint(state['result'])\n#all contacts\nstate = DHC.isDeviceOn(\"myRelay\", all)\npp.pprint(state['result'])\n\n#check a device battery level:\nbatteryLevel = DHC.getDeviceBattery('My Motion Sensor')\npp.pprint(batteryLevel)\n\n#get all batteries level under 20% (ommit argument to have all batteries levels):\nBatLevels = DHC.getAllBatteries(20)\npp.pprint(BatLevels)\n\n#get daily diary, last number of events:\ndiary = DHC.getDailyDiary(10)\npp.pprint(diary)\n\n#get daily device stat:\n#0:today, 1:yesterday, 2:day before yesterday\nstats = DHC.getDailyStat('My MotionSensor', 0)\npp.pprint(stats)\n\n#get weather report:\nweather = DHC.getWeather()\npp.pprint(weather)\n\n#Get one device states (all sensors):\nstates = DHC.getDeviceStates('My Motion Sensor')\npp.pprint(states)\n\n#Get one sensor data for any device, like light from a Motion Sensor or energy from a Wall Plug:\ndata = DHC.getDeviceData('My Motion Sensor', 'light')\npp.pprint(data['result']['value'])\ndata = DHC.getDeviceData('Radiator', 'temperature')\npp.pprint(data['result']['value'])\n\n#You can first ask without data, it will return all available sensors datas for this device:\ndata = DHC.getDeviceData('My Wall Plug')\npp.pprint(data)\n\n#get url from http device:\nurl = DHC.getDeviceURL('myhttp device')\n\n#get message data:\nurl = DHC.getMessageData('MyAlert')\n```\n\n[⇑](#python-devolodhc)\n\n#### CHANGING OPERATIONS
\n*Change devices names by yours!*\n\n```python\n#TURN DEVICE ON(1) or OFF(0):\n#supported: all on/off devices and http devices\ndev = DHC.turnDeviceOnOff(\"My Room wallPlug\", 1)\npp.pprint(dev)\n\n#For devices with 2 relays as Qubino Flush 2 Relay ZMNHBD1 (device name, state, contact):\n#contact 1 on\nDHC.turnDeviceOnOff(\"myRelay\", 1, 1)\n#contact 2 on\nDHC.turnDeviceOnOff(\"myRelay\", 1, 2)\n#all contacts on\nDHC.turnDeviceOnOff(\"myRelay\", 1, \"All\")\n\n#TURN GROUP ON(1) or OFF(0):\nDHC.turnGroupOnOff(\"My Plugs Group\", 1)\n\n#RUN HTTP DEVICE:\nDHC.turnDeviceOnOff(\"My http device\", 1) #0 won't do anything of course.\n\n#START SCENE:\nDHC.startScene(\"We go out\")\n\n#SEND MESSAGE:\nDHC.sendMessage(\"Alert\")\n\n#CHANGE THERMOSTAT/VALVE VALUE:\ntargetValue = DHC.setDeviceValue('My radiator', 21)\nDHC.setDeviceValue('my thermostat', 19)\n#press thermostat button:\nDHC.pressDeviceKey('my thermostat', 1)\n\n#TURN SIREN ON: (last number is the indice of the tone in the interface list. For example, 1 is alarm and won't stop! 0 will!)\nDHC.setDeviceValue('My Devolo Siren', 5)\n\n#SET SHUTTER OPENING:\nDHC.setDeviceValue('qubShutter', 50)\n\n#SET DIMMER VALUE:\nDHC.setDeviceValue('qubDimmer', 50)\n\n#PRESS REMOTE SWITCH KEY OR KEY FOB KEY:\nDHC.pressDeviceKey('MySwitch', 3)\n\n#TURN RULE ACTIVE (1 or 0)\nDHC.turnRuleOnOff('MyRule', 1)\n\n#TURN TIMER ACTIVE (1 or 0)\nDHC.turnTimerOnOff('MyTimer', 1)\n\n#TURN OFF DAILY DIARY REPORT (true/false):\nDHC.setDeviceDiary('movekitchen', false)\n```\n\n[⇑](#python-devolodhc)\n\n#### Consumption\n\nSome people would like to have more than 3days consumption log for devices like Wall Plugs.\nHere are two functions to log consumptions, and read them between two dates of choice. So you can make a cron task to call this function everyday, it will log the yesterday total consumption of each Wall Plugs:\n\n```python\nDHC.logConsumption('log.json')\n```\nIf you don't provide a file path, or it can't write to, the api will return an error, but also provide the result (so you can write your own custom functions).
\nThen, to read the log and know consumption for a month, or along summer/winter etc:\n\n```python\nstats = DHC.getLogConsumption('log.json', '01.03.2017', '31.03.2017')\npp.pprint(stats)\n```\nOf course, it needs a valid previously saved log file by the api. You can provide no dates (full log), or only one (set first as null if needed). Just respect day.month.year (php 'd.m.Y').\n\nFor visual logs feedback with php script, have a look [here](https://github.com/KiboOst/php-devoloDHC/tree/master/ExtendedLogs)\n\n

\n\n[⇑](#python-devolodhc)\n#### Unsupported device\n\nIf you have unsupported device, you can call special function with this device and post the return in a new issue.\n\n[Request for unsupported device](../../issues/)\n\n```python\nhelp = DHC.debugDevice('MyStrangeDevice')\npp.pprint(help)\n```\n[⇑](#python-devolodhc)\n\n## Version history\n\n#### v 1.3 (2017-10-19)\n- Now support Python3! Same module will check your Python version and work on both 2.7/3!\n\n#### v 1.0 (2017-09-24)\n- New: getNumStats() report number of devices, rules, timers, scenes, groups, zones, messages\n- Enhanced: Qubino Flush 2 Relay ZMNHBD1 support
\nDHC.turnDeviceOnOff('my2relay', 1, 'All') //support 1, 2, 'All' for Q1, Q2, both
\nDHC.isDeviceOn('my2relay', 1) //support 1, 2, 'All' for Q1, Q2, both\n\n#### v 0.9 (2017-06-12)\n- First public version\n\n[⇑](#python-devolodhc)\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2017 KiboOst\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/autinerd/python-devoloDHC", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "pyDHC", "package_url": "https://pypi.org/project/pyDHC/", "platform": "", "project_url": "https://pypi.org/project/pyDHC/", "project_urls": { "Homepage": "https://github.com/autinerd/python-devoloDHC" }, "release_url": "https://pypi.org/project/pyDHC/1.3.3/", "requires_dist": [ "certifi" ], "requires_python": "", "summary": "Communication to Devolo Home Control hub", "version": "1.3.3" }, "last_serial": 4643665, "releases": { "1.3": [ { "comment_text": "", "digests": { "md5": "b938533c39539100db9e8d462effb2a6", "sha256": "a7cc6dbfbfc572f01b81e459019c639901e7f4ed9212916e41f3f568f4c4bdf7" }, "downloads": -1, "filename": "pyDHC-1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "b938533c39539100db9e8d462effb2a6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6066, "upload_time": "2018-12-29T08:05:43", "url": "https://files.pythonhosted.org/packages/b5/38/4b3d8b190c5480c19d2e5a184f1c1f864ec0abb2798a7fc035ee6f525af8/pyDHC-1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "040df49c40e8c2b1668e23c8f8635cfc", "sha256": "58c6ad157bb919d0f057604a54189f2fc68a0b7740acbc3d28ea3b7b949b8cec" }, "downloads": -1, "filename": "pyDHC-1.3.tar.gz", "has_sig": false, "md5_digest": "040df49c40e8c2b1668e23c8f8635cfc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6415, "upload_time": "2018-12-29T08:05:46", "url": "https://files.pythonhosted.org/packages/17/c3/1bd72097b3d3f3bc0e55b8126d63f3827998c2422d4ae2c5e531b6752fc4/pyDHC-1.3.tar.gz" } ], "1.3.1": [ { "comment_text": "", "digests": { "md5": "ed5d0eb23c55c7711cea60338847e7cf", "sha256": "e25294fe38664949f3708cf6d924b25df5a0bdf6805802e0ca848e9176678e38" }, "downloads": -1, "filename": "pyDHC-1.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "ed5d0eb23c55c7711cea60338847e7cf", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 14355, "upload_time": "2018-12-29T08:34:15", "url": "https://files.pythonhosted.org/packages/d4/6e/e6f5169585d08754f0b64066e3a4d5331a8d8e0997bb5ef95c4e8b799da2/pyDHC-1.3.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0a4fea7c354a3e5e488b224834d90036", "sha256": "3bd3cac69cb22a0c4fe8c5de4646e5efa8d08d71c59dfbfa84155b5bb5e68d32" }, "downloads": -1, "filename": "pyDHC-1.3.1.tar.gz", "has_sig": false, "md5_digest": "0a4fea7c354a3e5e488b224834d90036", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14309, "upload_time": "2018-12-29T08:34:17", "url": "https://files.pythonhosted.org/packages/eb/68/422cc5fb9d125470a886c6caceff8fc01f97c2f5d78911c11ac34d6fdd0b/pyDHC-1.3.1.tar.gz" } ], "1.3.2": [ { "comment_text": "", "digests": { "md5": "bfcff07b19496fc2813cfa88e16c4601", "sha256": "22bd70b7d1f6da9050d1ffbd85eaa5e5eb26953590db5a373f2991a108e4512b" }, "downloads": -1, "filename": "pyDHC-1.3.2-py3-none-any.whl", "has_sig": false, "md5_digest": "bfcff07b19496fc2813cfa88e16c4601", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 14374, "upload_time": "2018-12-29T08:47:12", "url": "https://files.pythonhosted.org/packages/ad/4e/76e516516053009f7301bc43b257fb30b446613925b73c65b17dc4b7426d/pyDHC-1.3.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4dd581e47116cc6ca623ad90050204cd", "sha256": "9b868c05a0c862c7ad7cddf6f0e2c42b66b6891fe24ac56cd9f2984183b8b311" }, "downloads": -1, "filename": "pyDHC-1.3.2.tar.gz", "has_sig": false, "md5_digest": "4dd581e47116cc6ca623ad90050204cd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14326, "upload_time": "2018-12-29T08:47:15", "url": "https://files.pythonhosted.org/packages/85/30/5b8fa7da782da16c30e5585e15f10cc5858833f25dda6d36f66eb3b90702/pyDHC-1.3.2.tar.gz" } ], "1.3.3": [ { "comment_text": "", "digests": { "md5": "0eb63e343c30026badbe7ad63620bb12", "sha256": "f56a9f541b36e4ed01a5c6fb60cd89c5251217ed66110c5c9b15cde7c8ff3b3b" }, "downloads": -1, "filename": "pyDHC-1.3.3-py3-none-any.whl", "has_sig": false, "md5_digest": "0eb63e343c30026badbe7ad63620bb12", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 14445, "upload_time": "2018-12-29T09:44:05", "url": "https://files.pythonhosted.org/packages/11/59/44ac9c1188e5bca784728d9d5102c9190cf02fa9b5fc1d7ae55e3a2f9b59/pyDHC-1.3.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a37d767a954d1e808dce6661dc838116", "sha256": "7f14a17359518d8d53abc57911dbaa3ca7e6ce019b06dab5c04d9281afd4dcbc" }, "downloads": -1, "filename": "pyDHC-1.3.3.tar.gz", "has_sig": false, "md5_digest": "a37d767a954d1e808dce6661dc838116", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14434, "upload_time": "2018-12-29T09:44:09", "url": "https://files.pythonhosted.org/packages/1d/53/915044caede9ab87ab3e8dede1543b5363b94a306172d44f64ceb82f9e0b/pyDHC-1.3.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0eb63e343c30026badbe7ad63620bb12", "sha256": "f56a9f541b36e4ed01a5c6fb60cd89c5251217ed66110c5c9b15cde7c8ff3b3b" }, "downloads": -1, "filename": "pyDHC-1.3.3-py3-none-any.whl", "has_sig": false, "md5_digest": "0eb63e343c30026badbe7ad63620bb12", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 14445, "upload_time": "2018-12-29T09:44:05", "url": "https://files.pythonhosted.org/packages/11/59/44ac9c1188e5bca784728d9d5102c9190cf02fa9b5fc1d7ae55e3a2f9b59/pyDHC-1.3.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a37d767a954d1e808dce6661dc838116", "sha256": "7f14a17359518d8d53abc57911dbaa3ca7e6ce019b06dab5c04d9281afd4dcbc" }, "downloads": -1, "filename": "pyDHC-1.3.3.tar.gz", "has_sig": false, "md5_digest": "a37d767a954d1e808dce6661dc838116", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14434, "upload_time": "2018-12-29T09:44:09", "url": "https://files.pythonhosted.org/packages/1d/53/915044caede9ab87ab3e8dede1543b5363b94a306172d44f64ceb82f9e0b/pyDHC-1.3.3.tar.gz" } ] }