|
1 | 1 | ---
|
2 | 2 | layout: plugin
|
3 | 3 |
|
4 |
| -id: tplinksmartplug |
5 |
| -title: OctoPrint-TPLinkSmartplug |
6 |
| -description: Simple plugin to control TP-Link Smartplug |
| 4 | +id: tasmota |
| 5 | +title: OctoPrint-Tasmota |
| 6 | +description: Simple plugin to control sonoff devices that have been flashed with Tasmota. |
7 | 7 | author: jneilliii
|
8 | 8 | license: AGPLv3
|
9 | 9 |
|
10 |
| -# TODO |
11 |
| -date: today's date in format YYYY-MM-DD, e.g. 2015-04-21 |
| 10 | +date: 2017-11-24 |
12 | 11 |
|
13 |
| -homepage: https://github.com/jneilliii/OctoPrint-TPLinkSmartplug |
14 |
| -source: https://github.com/jneilliii/OctoPrint-TPLinkSmartplug |
15 |
| -archive: https://github.com/jneilliii/OctoPrint-TPLinkSmartplug/archive/master.zip |
| 12 | +homepage: https://github.com/jneilliii/OctoPrint-Tasmota |
| 13 | +source: https://github.com/jneilliii/OctoPrint-Tasmota |
| 14 | +archive: https://github.com/jneilliii/OctoPrint-Tasmota/archive/master.zip |
16 | 15 |
|
17 |
| -# TODO |
18 |
| -# Set this to true if your plugin uses the dependency_links setup parameter to include |
19 |
| -# library versions not yet published on PyPi. SHOULD ONLY BE USED IF THERE IS NO OTHER OPTION! |
20 |
| -#follow_dependency_links: false |
21 |
| - |
22 |
| -# TODO |
23 | 16 | tags:
|
24 |
| -- a list |
25 |
| -- of tags |
26 |
| -- that apply |
27 |
| -- to your plugin |
28 |
| -- (take a look at the existing plugins for what makes sense here) |
| 17 | +- sonoff |
| 18 | +- tasmota |
| 19 | +- smartplug |
| 20 | +- power |
29 | 21 |
|
30 |
| -# TODO |
31 | 22 | screenshots:
|
32 |
| -- url: url of a screenshot, /assets/img/... |
33 |
| - alt: alt-text of a screenshot |
34 |
| - caption: caption of a screenshot |
35 |
| -- url: url of another screenshot, /assets/img/... |
36 |
| - alt: alt-text of another screenshot |
37 |
| - caption: caption of another screenshot |
38 |
| -- ... |
39 |
| - |
40 |
| -# TODO |
41 |
| -featuredimage: url of a featured image for your plugin, /assets/img/... |
| 23 | +- url: /assets/img/plugins/tasmota/screenshot.png |
| 24 | + alt: Screenshot |
| 25 | + caption: Navbar screenshot |
| 26 | +- url: /assets/img/plugins/tasmota/settings.png |
| 27 | + alt: Settings |
| 28 | + caption: Settings screenshot |
42 | 29 |
|
43 |
| -# TODO |
44 |
| -# You only need the following if your plugin requires specific OctoPrint versions or |
45 |
| -# specific operating systems to function - you can safely remove the whole |
46 |
| -# "compatibility" block if this is not the case. |
| 30 | +featuredimage: /assets/img/plugins/tasmota/screenshot.png |
47 | 31 |
|
48 | 32 | compatibility:
|
49 | 33 |
|
50 |
| - # List of compatible versions |
51 |
| - # |
52 |
| - # A single version number will be interpretated as a minimum version requirement, |
53 |
| - # e.g. "1.3.1" will show the plugin as compatible to OctoPrint versions 1.3.1 and up. |
54 |
| - # More sophisticated version requirements can be modelled too by using PEP440 |
55 |
| - # compatible version specifiers. |
56 |
| - # |
57 |
| - # You can also remove the whole "octoprint" block. Removing it will default to all |
58 |
| - # OctoPrint versions being supported. |
59 |
| - |
60 | 34 | octoprint:
|
61 | 35 | - 1.2.0
|
62 | 36 |
|
63 |
| - # List of compatible operating systems |
64 |
| - # |
65 |
| - # Valid values: |
66 |
| - # |
67 |
| - # - windows |
68 |
| - # - linux |
69 |
| - # - macos |
70 |
| - # - freebsd |
71 |
| - # |
72 |
| - # There are also two OS groups defined that get expanded on usage: |
73 |
| - # |
74 |
| - # - posix: linux, macos and freebsd |
75 |
| - # - nix: linux and freebsd |
76 |
| - # |
77 |
| - # You can also remove the whole "os" block. Removing it will default to all |
78 |
| - # operating systems being supported. |
79 |
| - |
80 | 37 | os:
|
81 | 38 | - linux
|
82 | 39 | - windows
|
83 | 40 | - macos
|
84 | 41 | - freebsd
|
85 | 42 |
|
86 | 43 | ---
|
| 44 | +This plugin is to control ITead Sonoff devices that have been flashed with [Sonoff-Tasmota](https://github.com/arendst/Sonoff-Tasmota) via web calls. |
| 45 | + |
| 46 | +## Configuration |
| 47 | + |
| 48 | +Once installed go into settings and enter the ip address for your TP-Link Smartplug device. Adjust additional settings as needed. |
| 49 | + |
| 50 | +## Settings Explained |
87 | 51 |
|
88 |
| -**TODO**: Longer description of your plugin, configuration examples etc. This part will be visible on the page at |
89 |
| -http://plugins.octoprint.org/plugin/tplinksmartplug/ |
| 52 | +- **Device** |
| 53 | + - The ip or hostname of sonoff device. |
| 54 | +- **Index** |
| 55 | + - Index number reprensenting the relay to control. |
| 56 | +- **Warn** |
| 57 | + - The left checkbox will always warn when checked. |
| 58 | + - The right checkbox will only warn when printer is printing. |
| 59 | +- **GCODE** |
| 60 | + - When checked this will enable the processing of M80 and M81 commands from gcode to power on/off plug. Syntax for gcode command is M80/M81 followed by hostname/ip and index. For example if your plug is 192.168.1.2 and index of 1 your gcode command would be **M80 192.168.1.2 1** |
| 61 | +- **postConnect** |
| 62 | + - Automatically connect to printer after plug is powered on. |
| 63 | + - Will wait for number of seconds configured in **Auto Connect Delay** setting prior to attempting connection to printer. |
| 64 | +- **preDisconnect** |
| 65 | + - Automatically disconnect printer prior to powering off the plug. |
| 66 | + - Will wait for number of seconds configured in **Auto Disconnect Delay** prior to powering off the plug. |
| 67 | +- **Cmd On** |
| 68 | + - When checked will run system command configured in **System Command On** setting after a delay in seconds configured in **System Command On Delay**. |
| 69 | +- **Cmd Off** |
| 70 | + - When checked will run system command configured in **System Command Off** setting after a delay in seconds configured in **System Command Off Delay**. |
0 commit comments