{"id":40,"date":"2009-01-12T11:10:30","date_gmt":"2009-01-12T16:10:30","guid":{"rendered":"http:\/\/wordpress.schollnick.net\/?page_id=40"},"modified":"2012-06-20T09:21:06","modified_gmt":"2012-06-20T13:21:06","slug":"indigo-security-script","status":"publish","type":"page","link":"http:\/\/www.schollnick.net\/wordpress\/home-automation\/indigo-plugins-for-v4\/indigo-security-script\/","title":{"rendered":"Indigo Security Script v4"},"content":{"rendered":"

What is the Indigo Security Script?<\/strong><\/p>\n

The Indigo Security Script is a AppleScript applet for Indigo that is run anytime a Security Event has been received by Indigo.<\/p>\n\n\n\n
[toc=”2,3,4″ title=”Table of contents”]<\/td>\nDonate to help continue the development
\nof the Indigo Security Script
\n[paypal-donation purpose=”Software Donation” reference=”Indigo Security Script”]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The typical Security device is a DS10A X10 based magnetic reed sensor switch. \u00c2\u00a0The sensor itself is very versatile, and can be used for a variety of tasks, including detecting:<\/p>\n

    \n
  • Open Doors, and Windows<\/li>\n
  • With Small modification detecting Deadbolt positions<\/li>\n<\/ul>\n

    The script itself when a event occurs, can do the following:<\/p>\n

      \n
    • Sound a Chime \u00c2\u00a0(Every time, or only on open events) on a device-by-device basis<\/li>\n
    • Send a Growl Notification on a device-by-device basis<\/li>\n
    • Play a Sound File on a device-by-device basis<\/li>\n
    • Monitor for inactivate security sensors (eg. Low Battery Warning, Broken Sensor Warning)<\/li>\n
    • Ignore the event on a device by device basis<\/li>\n
    • Use Mac Text-to-Speech to speak the alarm<\/li>\n
    • (Optional) Indigo Security Status Web Plugin (See below)<\/li>\n<\/ul>\n

      Changes in Version 4<\/h2>\n

      The major benefit to Version 4 of the Security Script, is that it is now more versatile. \u00c2\u00a0Instead of activating a single device, the script now can also trigger Action Groups. \u00c2\u00a0Why would you want to do that? \u00c2\u00a0Because it simpilifies things quite a bit.<\/p>\n

      With version 3, you needed to create a trigger to detect a sensor opening or closing, if you wished to control more than one device or more than one action. \u00c2\u00a0For example:<\/p>\n

        \n
      1. if kitchen_door_is_open is changed to true\n
          \n
        • Action 1 – turn on hall way light<\/li>\n
        • action 2 – set timer to 600 seconds.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n

          And this could get out of control, simply because you have to create a trigger per sensor, and if they all are controlling the same device(s), there is a lot of duplication of effort….<\/p>\n

          With version 4, it’s easier, and simpler… \u00c2\u00a0In the Alarm Matrix, field 9 is an “Action group” prefix, if this is defined Indigo will attempt execute the Action Group when an sensor is triggered. \u00c2\u00a0The action group that it executes depends on what signal the sensor sends:<\/p>\n

          {91, “Ben_AlarmFob”, false, true, “Sound Chime”, false, false, false, “AlarmFob<\/strong>“}<\/p>\n

          The security script will take the action group name and append the following action name to it:<\/p>\n

            \n
          • _Opened \u00c2\u00a0 \u00c2\u00a0 – Insteon Door\/Window Sensor has been opened<\/li>\n
          • _Closed \u00c2\u00a0 \u00c2\u00a0 \u00c2\u00a0 – Insteon Door\/Window Sensor has been Closed<\/li>\n
          • _ArmHome \u00c2\u00a0– If the Armed (Home) button is pressed<\/li>\n
          • _ArmAway – If the Arm Away button is pressed<\/li>\n
          • _Disarm \u00c2\u00a0 \u00c2\u00a0 \u00c2\u00a0– Disarm Button pressed<\/li>\n
          • _LightsOn \u00c2\u00a0– Lights On button pressed<\/li>\n
          • _LightsOff \u00c2\u00a0– Lights Off button pressed<\/li>\n
          • _Panic_On – Panic Mode is turned on<\/li>\n
          • _Panic_Off – Panic Mode is turned off<\/li>\n<\/ul>\n

            So for the Alarm Matrix entry above, the 9th item (“AlarmFob<\/strong>“) is the prefix, and when the Panic button is pressed Indigo will check for an Action group called “AlarmFob_Panic_On<\/strong>“, and if it exists execute it. \u00c2\u00a0But this name doesn’t have to be unique<\/strong>. \u00c2\u00a0So if you have 3 security devices, all three can call the same action group.<\/strong> This allows you to write it once, and use it with a variety of security devices, assuming that they all perform the same actions.<\/p>\n

            Version 4.03 now adds another feature, the ability to Arm and Disarm the “security script”. \u00c2\u00a0The Security_Status variable will be “Armed” when Armed, and when disarmed it will be \u00c2\u00a0“Disarmed”. \u00c2\u00a0When Armed, the script will automatically email the addresses in the SecurityAlert_Email variable (multiple addressed seperated by a comma).<\/p>\n


            \n<\/span><\/span><\/div>\n

            To Install:<\/h2>\n
              \n
            1. Download the Security Script<\/li>\n
            2. Copy the Indigo Timer script to\u00c2\u00a0\/Library\/Application Support\/Perceptive Automation\/Indigo 4\/Scripts\/Background Tasks<\/strong><\/li>\n
            3. Now we need to start the script, everytime the Indigo Server Starts. \u00c2\u00a0So define a new trigger “Indigo Server Startup” with a type “Indigo Server Startup”. No condition needed. \u00c2\u00a0The action is to execute Applescript in a file.\u00c2\u00a0Select the Timer script in the Background Tasks folder.\u00c2\u00a0To start the script, you can restart the Indigo server or just execute the trigger.<\/li>\n
            4. Copy the Security Script v4 into\u00c2\u00a0\/Library\/Application Support\/Perceptive Automation\/Indigo 4\/Scripts\/Attachments<\/strong><\/li>\n
            5. Please ensure that the old copy of the security script is moved out of the attachment script, but do not delete it. \u00c2\u00a0You may want to revert at some point (or use it for testing purposes).<\/li>\n
            6. At this point just update the Security script’s Alarm matrix. \u00c2\u00a0See the security script for more details.<\/li>\n<\/ol>\n

              Versions for Download<\/h2>\n