# Pi Support
The Pi Support plugin provides additional information about your Pi in the UI and also
alerts you about undervoltage or overheating issues observed on your Pi or if your Pi is
unsupported. If you are running OctoPi, the Pi Support plugin will also provide additional
information about that.
OctoPrint will only load this plugin when it detects that it is being run on a
Raspberry Pi.
This plugin was bundled right with OctoPrint's sources until version 1.6.0. It has been
extracted into a standalone project to allow for a different release cycle, but is still
considered a bundled plugin.
## Setup
The plugin is part of the core dependencies of OctoPrint 1.6.0+ and will be installed automatically alongside it.
In case you want to manually install it into an older version for whatever reason, install via the bundled
[Plugin Manager](https://docs.octoprint.org/en/master/bundledplugins/pluginmanager.html)
or manually using this URL:
https://github.com/OctoPrint/OctoPrint-PiSupport/archive/main.zip
To install and/or rollback to a specific version `<version>`, either use this URL in the plugin manager:
https://github.com/OctoPrint/OctoPrint-PiSupport/archive/<version>.zip
or run
pip install OctoPrint-PiSupport==<version>
in your OctoPrint virtual environment, substituting `<version>` accordingly.
## Events
### plugin_pi_support_throttle_state
*(as `Events.PLUGIN_PI_SUPPORT_THROTTLE_STATE`)*
A change in throttle state was detected.
Payload:
* `raw_value`: The raw throttle state value as received from `vcgencmd get_throttled`
* `current_undervolate`: Whether there is currently an undervoltage condition
* `past_undervoltage`: Whether there has been an undervoltage condition since last boot
* `current_overheat`: Whether there is currently an overheat condition
* `past_overheat`: Whether there has been an overheat condition since last boot
* `current_issue`: Whether there is currently an undervoltage or overheat condition
* `past_issue`: Whether there has been either an undervoltage or overheat condition since last boot
## Helpers
### get_throttled
Access to `get_throttle_state`, to retrieve the current throttle state. Returns a `dict`
with the same fields as the `PLUGIN_PI_SUPPORT_THROTTLE_STATE` event payload. By setting
the keyword argument `run_now` set to `True`, the throttle state will be refreshed before
returning.
Raw data
{
"_id": null,
"home_page": "https://github.com/OctoPrint/OctoPrint-PiSupport",
"name": "OctoPrint-PiSupport",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Gina H\u00e4u\u00dfge",
"author_email": "gina@octoprint.org",
"download_url": "https://files.pythonhosted.org/packages/e9/80/05186711d918220ae3496e08a63c6136d5b6eebc1ae5ac2a389f23549444/OctoPrint-PiSupport-2023.10.10.tar.gz",
"platform": null,
"description": "# Pi Support\n\nThe Pi Support plugin provides additional information about your Pi in the UI and also\nalerts you about undervoltage or overheating issues observed on your Pi or if your Pi is\nunsupported. If you are running OctoPi, the Pi Support plugin will also provide additional\ninformation about that.\n\nOctoPrint will only load this plugin when it detects that it is being run on a\nRaspberry Pi.\n\nThis plugin was bundled right with OctoPrint's sources until version 1.6.0. It has been\nextracted into a standalone project to allow for a different release cycle, but is still\nconsidered a bundled plugin.\n\n## Setup\n\nThe plugin is part of the core dependencies of OctoPrint 1.6.0+ and will be installed automatically alongside it.\n\nIn case you want to manually install it into an older version for whatever reason, install via the bundled\n[Plugin Manager](https://docs.octoprint.org/en/master/bundledplugins/pluginmanager.html)\nor manually using this URL:\n\n https://github.com/OctoPrint/OctoPrint-PiSupport/archive/main.zip\n\nTo install and/or rollback to a specific version `<version>`, either use this URL in the plugin manager:\n\n https://github.com/OctoPrint/OctoPrint-PiSupport/archive/<version>.zip\n\nor run\n\n pip install OctoPrint-PiSupport==<version>\n\nin your OctoPrint virtual environment, substituting `<version>` accordingly.\n\n## Events\n\n### plugin_pi_support_throttle_state\n\n*(as `Events.PLUGIN_PI_SUPPORT_THROTTLE_STATE`)*\n\nA change in throttle state was detected.\n\nPayload:\n * `raw_value`: The raw throttle state value as received from `vcgencmd get_throttled`\n * `current_undervolate`: Whether there is currently an undervoltage condition\n * `past_undervoltage`: Whether there has been an undervoltage condition since last boot\n * `current_overheat`: Whether there is currently an overheat condition\n * `past_overheat`: Whether there has been an overheat condition since last boot\n * `current_issue`: Whether there is currently an undervoltage or overheat condition\n * `past_issue`: Whether there has been either an undervoltage or overheat condition since last boot\n\n## Helpers\n\n### get_throttled\n\nAccess to `get_throttle_state`, to retrieve the current throttle state. Returns a `dict`\nwith the same fields as the `PLUGIN_PI_SUPPORT_THROTTLE_STATE` event payload. By setting\nthe keyword argument `run_now` set to `True`, the throttle state will be refreshed before\nreturning.\n\n\n",
"bugtrack_url": null,
"license": "AGPLv3",
"summary": "Provides additional information about your Pi in the UI",
"version": "2023.10.10",
"project_urls": {
"Homepage": "https://github.com/OctoPrint/OctoPrint-PiSupport"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8e0e225914d502a7fff027fe127f78b65f62fe6cb2e9febf81f8471ac4b19dd2",
"md5": "b370d0e1cec55f152fd82766e8cd5cf5",
"sha256": "cb54d81334252d2fa9dd59bb7caaa4b641345656f9e8fd8937846af5b2cd1061"
},
"downloads": -1,
"filename": "OctoPrint_PiSupport-2023.10.10-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "b370d0e1cec55f152fd82766e8cd5cf5",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 35073,
"upload_time": "2023-10-10T12:30:50",
"upload_time_iso_8601": "2023-10-10T12:30:50.022616Z",
"url": "https://files.pythonhosted.org/packages/8e/0e/225914d502a7fff027fe127f78b65f62fe6cb2e9febf81f8471ac4b19dd2/OctoPrint_PiSupport-2023.10.10-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e98005186711d918220ae3496e08a63c6136d5b6eebc1ae5ac2a389f23549444",
"md5": "246ef0f0ca3d79abf758c023a4962af2",
"sha256": "bb4ac0f70bcf612d95d85debf6716d6bc6708db13d5e5883e04abbe5b1d67eeb"
},
"downloads": -1,
"filename": "OctoPrint-PiSupport-2023.10.10.tar.gz",
"has_sig": false,
"md5_digest": "246ef0f0ca3d79abf758c023a4962af2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 32940,
"upload_time": "2023-10-10T12:30:51",
"upload_time_iso_8601": "2023-10-10T12:30:51.564664Z",
"url": "https://files.pythonhosted.org/packages/e9/80/05186711d918220ae3496e08a63c6136d5b6eebc1ae5ac2a389f23549444/OctoPrint-PiSupport-2023.10.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-10 12:30:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OctoPrint",
"github_project": "OctoPrint-PiSupport",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "octoprint-pisupport"
}
JSON
