Difference between revisions of "Insteon - Setting Up PLM Template"

From LinuxMCE
Jump to: navigation, search
 
(60 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[[Category:Tutorials]]
+
{{Versioninfo|810Status=Q/A|810UpdatedDate=29 JUNE 2010|810UpdatedBy=langstonius|710Status=N/A|710UpdatedDate=29JUNE 2010|710UpdatedBy=langstonius}}
[[:Category:Tutorials]]
+
[[category: Insteon]]
 +
[[Category:Power Line Control]]
 +
[[Category:GSD| ]]
 +
{| align="right"
 +
  | __TOC__
 +
  |}
  
* Log into the webadmin
+
:''' UPDATED: 11-MAR-08 Many bugs fixed, X10 fixes...
* select Interfaces(under Devices)
+
:''' UPDATED: 13-FEB-08 X10 Support fixed!
* click Add device (loads Pick Device Template popup)
+
'''
 +
:--ddamron
  
:with the Pick Device Template Popup:
+
:''' UPDATED: 7-FEB-12 Remove instructions on setting up template, use Template 1932
 +
'''
 +
:--Aviator
  
:* click Add Manufacturer (loads Add Manufacturer popup)
+
:''' UPDATED: Adding Info for 2412n template In addition to posting plm code changes to enable Venstar Thermostat''' --[[User:Trippleg|Trippleg]] 00:06, 25 February 2012 (CET)
  
::with the Add Manufacturer popup:
 
:::* type 'Smarthome' and click Add
 
:::* Click Close
 
  
::* press F5 to refresh the page.
 
::* In the Manufacturer field, select 'Smarthome'.
 
::* Under Device Category, select 'Lighting Interface < Interfaces'.
 
::* Click Add device Template (popup changes to Add model)
 
::* select the LAST option:
 
  
<nowiki>"It's a simple, generic serial device controlled by RS232, Ethernet or USB, which you'll control with Pluto's GSD and embedded Ruby snippets (very easy). Examples: Lighting control, alarm panels, surveillance cameras, thermostats, weather stations, a/v equipment with RS232 ports, etc"</nowiki>
+
Here are the steps to create an Insteon PLM Template.  This driver is written entirely in Ruby.  Please consider this driver complete, and is in Release Candidate 1.  I'm sure there are still a few bugs (although we've ironed most of them out now). The more people testing this code, the more bugs we can find, and get this to a release state.  Once it's in release state, it will be added to sqlcvs and offered via a 'quick' update.
  
::* Type in 'Insteon PLM' in the name or model#.
+
{{p}}
::* Click Add
+
::* Close the Add device Template window.
+
  
:* In Webadmin, Select Advanced, Configuration, Device Templates (from the top menu)
+
==Supported Devices==
:* In the Device Template field, select 'Insteon PLM'
+
This driver supports ONLY the Powerlinc Modem model (PLM)#2412S, #2413S, #2412U and #2413U. The code will NOT work for a model #2414 also known as a Powerlinc CONTROLLER (PLC).
:* click 'Pick Device Template' (loads Edit Device Template Popup)
+
::* NOTE the Template Number!  write this down. (it will be needed for Plug N Play)
+
::* Make sure 'Implements DCE' is checked (should be)
+
::* In the Comm Method, select RS232
+
::* Click 'Edit Ruby Codes' ( loads Edit Ruby Codes Popup)
+
:::* In the field to the LEFT of 'Create new group', type in 'Insteon PLM'
+
:::* click 'Create new group'
+
:::* If the 'Uses Group/Codeset' does not change to 'Insteon PLM', repeat the previous 2 steps again.
+
:::* Once the 'Uses Group/Codeset' says 'Insteon PLM' Check 'Discoverable Interfaces'
+
:::* Check 'Ruby Insternal Commands'
+
:::* click Update
+
  
:::* In the #756 Report Child Devices field (the big one) copy and paste this code:
+
NOTE: I am expecting a PLC to arrive in the mail in the next few days. Support for that device will be sooner than later.
::::[[Insteon PLM Ruby Code #756]]
+
:::* In the #776 Reset field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #776]]
+
:::* In the #760 Send Command to Child field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #760]]
+
:::* In the #788 StatusReport field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #788]]
+
:::* In the #373 Private Method Listing field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #373]]
+
:::* In the #351 Process IDLE field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #351]]
+
:::* In the #350 Process Incoming Data field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #350]]
+
:::* In the #384 Process Receive Command for Child field, copy and paste this code:
+
::::[[Insteon PLM Ruby Code #384]]
+
:::* In the #356 Process Release, leave it blank. (no code for now)
+
::::[[Insteon PLM Ruby Code #356]]
+
:::* Click Update
+
:::* Click Close
+
::* Press F5 for refresh the 'Edit Device Template' popup
+
::* In the 'Device data' section, in 'Add a New Parameter' select 'COM Port on PC' and click Add.
+
::* in the Comments Field, type 'COM Port'
+
::* in the Default Value field, type '/dev/ttyS0'
+
::* check the 'Required' and 'Allowed to Modify' boxes
+
::* In the 'Device data' section, in 'Add a New Parameter' select 'COM Port BaudRate' and click Add.
+
::* in the Comments Field, type 'Baud Rate'
+
::* in the Default Value field, type '38400'
+
::* check the 'Required' and 'Use Master Device List Defaults' boxes
+
::* In the 'Device data' section, in 'Add a New Parameter' select 'Only One Per PC' and click Add.
+
::* in the Comments Field, type 'Only One Per PC'
+
::* in the Default Value field, type '1'
+
::* In the 'Device data' section, in 'Add a New Parameter' select 'Auto-assign to parents room' and click Add.
+
::* in the Comments Field, type 'Assign to Parents Room'
+
::* in the Default Value field, type '1'
+
  
::* Scroll down to the 'Plug & Play' Section
+
*Febuary 2, 2012 - PLC support will NOT be added to this driver -Aviator
::* Enter These values:
+
:::From = '0', To = '0'
+
:::Vendor Model ID = '2412S' PNP protocol = 'Proprietary'
+
:::Serial Number = 'Insteon PLM' Parms is blank
+
:::PNP detection script is '88_InsteonPLM.sh'
+
:::Comment is 'Insteon PLM'
+
  
 +
*Febuary 3, 2012 - Thanks to the work of trippleg, we now have support for the 2412N as well. -Aviator
  
::* Scroll down to the bottom of the popup window and click Save
+
This driver now supports  the Smartlinc 2412N as well. Please use template 2197
::* Click Close
+
::* Modify the SECOND LAST LINE of this script (88_InsteonPLM.sh) and change the LAST number to your Template ID.
+
::* add this script file to /usr/pluto/pnp (88_InsteonPLM.sh)
+
<pre>
+
#!/bin/bash
+
  
echo "Insteon Powerline Modem Detection Script queue $2"
+
Simplehomenet's EZBridge/EZServ products will be added once this code is stable.  These products are a 'wrapper' for the PLM, and hence, use the same code.  Integration will be a matter of adding the 'wrapper' code. (which is done)
/usr/pluto/bin/TestSerialPort -p $3 -P N81 -b 19200 -t "\02\60"  -i 1 -s "\03\05"
+
 
if [[ "$?" -ne 0 ]]; then
+
{{p}}
echo "It's not an Insteon Powerline Modem"
+
 
/usr/pluto/bin/MessageSend dcerouter -r 0 $1 1 806 224 $2 13 "$4" 44 0
+
==Setting up the Template==
else
+
* The template is Plug and Play, configuration should have been taken care of for you.
echo "It is an Insteon Powerline Modem"
+
 
/usr/pluto/bin/MessageSend dcerouter -r 0 $1 1 806 224 $2 13 "$4" 44 1901
+
* Goto [[LinuxMCE Admin Website]]-->Wizard-->Devices-->Interfaces
fi
+
* Add device-->Template Id 1932 Insteon PLM
</pre>
+
For 2412N
::* chmod 755 /usr/pluto/pnp/88_InsteonPLM.sh (make it executable)
+
* Add device -->Template Id 2197 Smartlinc
 +
 
 +
 
 +
:* Now, in the COM PORT ON PC, you can select the com port it's on. '''UPDATE''' I didn't see any "COM PORT ON PC" field. You wil need to reload the router first, then you see the "COM PORT ON PC" field. 8/9/08 Williammanda
 +
 
 +
 
 +
 
 +
'''TODO''' Other than looking on the motherboard for the com port label and guess and check methods, what else can be done to identify the correct com port?
 +
:* select Update (at the bottom)
 +
 
 +
You are Done!
 +
 
 +
{{p}}
 +
 
 +
==Next Steps==
 +
go to [[Running the Insteon PLM Driver for the First Time]]

Latest revision as of 03:41, 20 October 2012

Version Status Date Updated Updated By
710 N/A 29JUNE 2010 langstonius
810 Q/A 29 JUNE 2010 langstonius
1004 Unknown N/A N/A
1204 Unknown N/A N/A
1404 Unknown N/A N/A
Usage Information
UPDATED: 11-MAR-08 Many bugs fixed, X10 fixes...
UPDATED: 13-FEB-08 X10 Support fixed!

--ddamron
UPDATED: 7-FEB-12 Remove instructions on setting up template, use Template 1932

--Aviator
UPDATED: Adding Info for 2412n template In addition to posting plm code changes to enable Venstar Thermostat --Trippleg 00:06, 25 February 2012 (CET)


Here are the steps to create an Insteon PLM Template. This driver is written entirely in Ruby. Please consider this driver complete, and is in Release Candidate 1. I'm sure there are still a few bugs (although we've ironed most of them out now). The more people testing this code, the more bugs we can find, and get this to a release state. Once it's in release state, it will be added to sqlcvs and offered via a 'quick' update.



Supported Devices

This driver supports ONLY the Powerlinc Modem model (PLM)#2412S, #2413S, #2412U and #2413U. The code will NOT work for a model #2414 also known as a Powerlinc CONTROLLER (PLC).

NOTE: I am expecting a PLC to arrive in the mail in the next few days. Support for that device will be sooner than later.

  • Febuary 2, 2012 - PLC support will NOT be added to this driver -Aviator
  • Febuary 3, 2012 - Thanks to the work of trippleg, we now have support for the 2412N as well. -Aviator

This driver now supports the Smartlinc 2412N as well. Please use template 2197

Simplehomenet's EZBridge/EZServ products will be added once this code is stable. These products are a 'wrapper' for the PLM, and hence, use the same code. Integration will be a matter of adding the 'wrapper' code. (which is done)



Setting up the Template

  • The template is Plug and Play, configuration should have been taken care of for you.

For 2412N

  • Add device -->Template Id 2197 Smartlinc


  • Now, in the COM PORT ON PC, you can select the com port it's on. UPDATE I didn't see any "COM PORT ON PC" field. You wil need to reload the router first, then you see the "COM PORT ON PC" field. 8/9/08 Williammanda


TODO Other than looking on the motherboard for the com port label and guess and check methods, what else can be done to identify the correct com port?

  • select Update (at the bottom)

You are Done!



Next Steps

go to Running the Insteon PLM Driver for the First Time