Skip to content

Insteon Redux

Jump to bottom Edit New page
galiven edited this page Nov 7, 2014 · 2 revisions

Table of Contents

Misterhouse Insteon Branch Status, TODOs, and Feature Requests

  • NOTE
  • This page initially discussed a new code base for Insteon which has since been merged into the master branch. While older references note a distinction between an "Insteon Branch" and the main Insteon code, that distinction no longer exists. Please see the Insteon page for more details. This page is in the process of being cleaned up and eventually will be deleted.

John wrote some info on how the Insteon code inside MH works: https://github.com/hollie/misterhouse/wiki/Design-details

Here are links to Insteon programming documentation that will help anyone else who would like to work on this:

While there is a developer kit at from smart home, it costs money, the agreement says that the kit may not be shared among multiple people, and it's not 100% clear it's needed for misterhouse with the links available above.

Migration

WARNING: Support for the Insteon thermostat and irrigation code has not yet been ported. If you rely on this functionality, do NOT attempt to use this code base until the corresponding code has been ported.

Miscellaneous

The prior use of a separate module called insteon_item_commands has been permanently deprecated. The equivalent functionality is now automatically included in the new libraries. You no longer have to manually include this module.

Revisions to mht Declarations

The insteon config syntax has changed from the old IPLD and IPLL tags which you may see in older references.

The following guidelines should be to convert a set of mht declarations which used the old format. The easiest way to convert an old insteon.mht file to a new one is to use convert_insteon_config as a guide.

  1. Remove all references to the "plm" item name and any devcat declarations at the end of each insteon-specific entry. These changes apply to the IPLL and IPLD declarations only.
  2. Look for all of your IPLL entries that use the plm as the controller. In general, they would look something like: "IPLL, plm:A1, myTestScene". Replace the "IPLL" tag with "INSTEON_ICONTROLLER". In addition, remove the plm reference and colon: "plm:". The above example should now look like: "INSTEON_ICONTROLLER, A1, myTestScene".
  3. All of the remaining IPLL and IPLD tags must be replaced with the new set of tags:
  • INSTEON_LAMPLINC
  • INSTEON_APPLIANCELINC
  • INSTEON_SWITCHLINC
  • INSTEON_SWITCHLINCRELAY
  • INSTEON_KEYPADLINC
  • INSTEON_KEYPADLINCRELAY
  • INSTEON_MOTIONSENSOR
  • INSTEON_REMOTELINC
If you have any device that corresponds to something other than one of the above, then it is likely that the current code base will NOT support that device.

WARNING: Because you will be changing the object definition for each insteon item, all previously stored data will now be lost. At a minimum, this includes all in-memory mirroring of device links. As a result, you will have to either wait for the automatic memory scan or perform manual memory scans.

Main page

Add a custom sidebar
Clone this wiki locally