We have moved at community.getvera.com

Author Topic: [How To] Install LUUP plugins  (Read 13366 times)

Offline Henk

  • Hero Member
  • *****
  • Posts: 820
  • Karma: +3/-0
[How To] Install LUUP plugins
« on: May 16, 2011, 03:37:59 pm »
Heres a short manual on how to install LUUP plugins into your vera.

Official repository for plugins:
http://code.mios.com

Alternative location (for now)
http://wiki.micasaverde.com/index.php/Luup_plugins_and_Luup_code

also in various forum threads coders provide their code or complete plugins.

This manual start with the assumption you have downloaded the appropriate .json and .xml files to your harddisk.
Also you have UI4 running.

1. Open you vera UI4
2. Upload the files of the plugin you downloaded to your VERA box: 'MiOS Developers' -> 'Luup files' -> 'Upload files'.
   (see screenshots attached)
3. Check 'Restart Luup after upload' (bottom of the page), click 'Go' and wait for Lua to restart.
4. Create a new Luup device with UpnpDevFilename D_<yourplugin>.xml.  
5. Set the Description to whatever you want to name the device.
   (see schreenshot attached)
6. Restart the Lua engine several times to initialise the UPnP variables (curving arrows top right in your UI.
   In some case a power cycle/reboor of your vera is neccesary.
7. Make the appropriate LUUP variable settings as per directions for the creator of the plugin.
« Last Edit: June 13, 2011, 01:01:55 pm by Henk »
| Vera2 @ UI4 1.1.1350 / 3.20 | Vera Lite @ UI5 | Vera 3 @ UI5 | 2x Merten  504519 | 1x Duewi  064374 | 1x Everspring SM103 doorbell mod |1 Y-cam IP cam | various LUUP plugins |

Offline TimAlls

  • Hero Member
  • *****
  • Posts: 722
  • Karma: +0/-0
Re: Howto: Install LUUP plugins
« Reply #1 on: May 19, 2011, 10:41:55 am »
Thanks for writing this up.....
Regards
Tim

Offline Henk

  • Hero Member
  • *****
  • Posts: 820
  • Karma: +3/-0
Re: Howto: Install LUUP plugins
« Reply #2 on: May 19, 2011, 12:55:08 pm »
Thanks for writing this up.....
Regards
Tim

Thanks for the kind words.
Im currently working on here:

http://wiki.micasaverde.com/index.php/Category:How_To

To bring all this stuff togehter.
Please keep in mind its WIP, but it will get there in the next couple of weeks!

Henk
| Vera2 @ UI4 1.1.1350 / 3.20 | Vera Lite @ UI5 | Vera 3 @ UI5 | 2x Merten  504519 | 1x Duewi  064374 | 1x Everspring SM103 doorbell mod |1 Y-cam IP cam | various LUUP plugins |

Offline cwca02

  • Sr. Newbie
  • *
  • Posts: 33
  • Karma: +0/-0
Re: Howto: Install LUUP plugins
« Reply #3 on: May 20, 2011, 02:06:19 am »
I second that thank you!  I have been getting ready to install a custom plugin and couldn't find any real guidance.  This documentation is badly needed!

Offline mcvflorin

  • Administrator
  • Hero Member
  • *****
  • Posts: 1755
  • Karma: +11/-3
Re: Howto: Install LUUP plugins
« Reply #4 on: May 20, 2011, 06:29:04 am »
1. Open you vera UI4
2. Upload the files of the plugin you downloaded to your VERA box: 'MiOS Developers' -> 'Luup files' -> 'Upload files'.
   (see screenshots attached)
3. Check 'Restart Luup after upload' (bottom of the page), click 'Go' and wait for Lua to restart.
4. Create a new Luup device with UpnpDevFilename D_<yourplugin>.xml.  
5. Set the Description to whatever you want to name the device.
   (see schreenshot attached)
6. Restart the Lua engine several times to initialise the UPnP variables (curving arrows top right in your UI.
   In some case a power cycle/reboor of your vera is neccesary.
7. Make the appropriate LUUP variable settings as per directions for the creator of the plugin.

I'd have several changes to make:
  • On step 3, checking Restart Luup after upload isn't necessary. Only one restart is necessary, after creating the device.
  • Between step 6 and step 7 there's another important step: reload the web page.
« Last Edit: May 20, 2011, 08:24:22 am by mcvflorin »

Offline SuperflyMD

  • Sr. Newbie
  • *
  • Posts: 28
  • Karma: +0/-0
Re: Howto: Install LUUP plugins
« Reply #5 on: May 20, 2011, 06:56:20 am »
How do you do it on a Mac?

Offline fdebuck

  • Newbie
  • *
  • Posts: 14
  • Karma: +0/-0
Re: Howto: Install LUUP plugins
« Reply #6 on: May 20, 2011, 07:05:47 am »
on a Mac, the procedure is the same... It's all just a webpage !

Offline Henk

  • Hero Member
  • *****
  • Posts: 820
  • Karma: +3/-0
Re: Howto: Install LUUP plugins
« Reply #7 on: May 20, 2011, 07:24:40 am »
on a Mac, the procedure is the same... It's all just a webpage !

Quote
Posted by: SuperflyMD    Posted on: Today at 12:56:20 pm
Insert Quote
How do you do it on a Mac?

Correct, the UI is HTML based and accesible through any webbrowser.
If you have UI4 (which almost any vera owner has by now) or even UI2 with a firmware that isnt ancient, this procedure works.
| Vera2 @ UI4 1.1.1350 / 3.20 | Vera Lite @ UI5 | Vera 3 @ UI5 | 2x Merten  504519 | 1x Duewi  064374 | 1x Everspring SM103 doorbell mod |1 Y-cam IP cam | various LUUP plugins |

Offline Henk

  • Hero Member
  • *****
  • Posts: 820
  • Karma: +3/-0
Re: Howto: Install LUUP plugins
« Reply #8 on: May 20, 2011, 07:28:12 am »
1. Open you vera UI4
2. Upload the files of the plugin you downloaded to your VERA box: 'MiOS Developers' -> 'Luup files' -> 'Upload files'.
   (see screenshots attached)
3. Check 'Restart Luup after upload' (bottom of the page), click 'Go' and wait for Lua to restart.
4. Create a new Luup device with UpnpDevFilename D_<yourplugin>.xml.  
5. Set the Description to whatever you want to name the device.
   (see schreenshot attached)
6. Restart the Lua engine several times to initialise the UPnP variables (curving arrows top right in your UI.
   In some case a power cycle/reboor of your vera is neccesary.
7. Make the appropriate LUUP variable settings as per directions for the creator of the plugin.

I'd have several ch change to make:
  • On step 3, checking Restart Luup after upload isn't necessary. Only one restart is necessary, after creating the device.
  • Between step 6 and step 7 there's another important step: reload the web page.


@mcvflorin

Thanks for the remarks, i will change the wiki on this.
Here: http://wiki.micasaverde.com/index.php/Category:How_To

It maybe due to the fact that i didnt have the step between 6 and 7 (which i will add), but in my setup a single LUUP restart was not enough in any sitaution. Sometimes i even had to powercycle my Vera.

Ok if i leave that in there as a failsafe?

Henk
| Vera2 @ UI4 1.1.1350 / 3.20 | Vera Lite @ UI5 | Vera 3 @ UI5 | 2x Merten  504519 | 1x Duewi  064374 | 1x Everspring SM103 doorbell mod |1 Y-cam IP cam | various LUUP plugins |

Offline aecchalet

  • Sr. Member
  • ****
  • Posts: 254
  • Karma: +1/-1
Doesn't Vera automatically install plugins?
« Reply #9 on: May 22, 2011, 10:41:25 am »
I went to the Mios Marketplace and selected thermostat plugin #589.  It gave me the option of installing the plugin, which I accepted. Now, under Mios Marketplace on my Dashboard, there is an icon for the thermostat plugin.  Do I still need to follow these steps to actually install this plugin?  If so, where do I find the file that I am supposed to upload, in step 2?
Thanks
« Last Edit: May 22, 2011, 10:43:32 am by aecchalet »
Vera Plus 1.7.2138; 12xHRDS1, 2xTrane SCHTZMT400 Tstats; 5xZIR00, 4xCA9000 PIRs; 2xHA01C Recept; 2x2wy ZDW120W switch; 1xAppl (ACT, GE/Jasco), 1xLite Dim Mod (GE/Jasco, Evolve);  2xDead Bolts Schlage

Offline Henk

  • Hero Member
  • *****
  • Posts: 820
  • Karma: +3/-0
Re: Doesn't Vera automatically install plugins?
« Reply #10 on: May 22, 2011, 11:32:30 am »
I went to the Mios Marketplace and selected thermostat plugin #589.  It gave me the option of installing the plugin, which I accepted. Now, under Mios Marketplace on my Dashboard, there is an icon for the thermostat plugin.  Do I still need to follow these steps to actually install this plugin?  If so, where do I find the file that I am supposed to upload, in step 2?
Thanks

@aecchalet

Thank you for pointing this out.
I made corrections to the wiki about this.

Only a limited amount of plugins is officially available through the Marketplace.
The Marketplace uses a click and install function out of the box, without the need to download / upload anything seperately.

However, user contributions and/or beta plugins such as available on many locations from within the forum DO need to be manualy installed using the provided How To.

You may reference these pages for (in)officially documented functionality:

User Instructions
http://wiki.micasaverde.com/index.php?title=Category:User_Instructions

How To
http://wiki.micasaverde.com/index.php/Category:How_To

You may notice i crosslinked many wiki pages to make it more accessible and easier to find things.

Henk
| Vera2 @ UI4 1.1.1350 / 3.20 | Vera Lite @ UI5 | Vera 3 @ UI5 | 2x Merten  504519 | 1x Duewi  064374 | 1x Everspring SM103 doorbell mod |1 Y-cam IP cam | various LUUP plugins |

Offline oTi@

  • Community Beta
  • Master Member
  • ******
  • Posts: 4041
  • Karma: +32/-6
  • UI what ?!
Re: Doesn't Vera automatically install plugins?
« Reply #11 on: May 22, 2011, 12:33:39 pm »
Do I still need to follow these steps to actually install this plugin?  If so, where do I find the file that I am supposed to upload, in step 2?
If all is well, your thermostat device should have gained 4 new variables in the Advanced tab, in the Variables section: HeatMax, HeatMin, CoolMax, CoolMin.
Dezwaved at the moment...

Offline mcvflorin

  • Administrator
  • Hero Member
  • *****
  • Posts: 1755
  • Karma: +11/-3
Re: Howto: Install LUUP plugins
« Reply #12 on: May 23, 2011, 11:57:18 am »
I updated the Wiki page. Major modifications are:
  • the removal of step 3. Reason: the file uploading script does just that: it uploads files and compresses them to LZO format. Therefore, restarting Luup has no effect. For those curious, the script is /www/cgi-bin/cmh/upload_upnp_file.sh
  • on step 6 (now step 5): changed from Restart Luup several times to Restart Luup once. Reason: for most plugins one restart is enough, because all the plugins initializations are done on the first restart. However, if a plugin really does require more than one restart, it should specify in its install instructions.

Offline Henk

  • Hero Member
  • *****
  • Posts: 820
  • Karma: +3/-0
Re: Howto: Install LUUP plugins
« Reply #13 on: May 23, 2011, 12:31:58 pm »
I updated the Wiki page. Major modifications are:
  • the removal of step 3. Reason: the file uploading script does just that: it uploads files and compresses them to LZO format. Therefore, restarting Luup has no effect. For those curious, the script is /www/cgi-bin/cmh/upload_upnp_file.sh
  • on step 6 (now step 5): changed from Restart Luup several times to Restart Luup once. Reason: for most plugins one restart is enough, because all the plugins initializations are done on the first restart. However, if a plugin really does require more than one restart, it should specify in its install instructions.

Thx for the review!
| Vera2 @ UI4 1.1.1350 / 3.20 | Vera Lite @ UI5 | Vera 3 @ UI5 | 2x Merten  504519 | 1x Duewi  064374 | 1x Everspring SM103 doorbell mod |1 Y-cam IP cam | various LUUP plugins |

Offline RobertN

  • Jr. Member
  • **
  • Posts: 85
  • Karma: +14/-6
Re: Howto: Install LUUP plugins
« Reply #14 on: May 28, 2011, 07:50:42 am »
If there was a reason to uninstall a LUUP plugin, how do I go about doing that? BTW, thanks for publishing this. The instructions are great and very helpful.