@brandonarrindell/homebridge-envisalink

A maintained fork of homebridge-envisalink (v1.2.10) with enhanced features and Homebridge 2.0 support.

This Homebridge plugin integrates your Envisalink security system with HomeKit, allowing you to:

• Control your alarm panel (arm/disarm) using Siri or any HomeKit app
• Monitor sensors for automations (e.g., turn on lights when doors open)
• Trigger panic buttons (police, fire, ambulance) from HomeKit
• Auto-discover Envisalink devices on your network

Version History

This fork continues from version 1.2.10 of the original plugin:

• v1.3.0 - First release of the fork
  • Added Homebridge 2.0 support
  • Added auto-discovery feature
  • Improved stability and error handling
  • TypeScript rewrite

For earlier version history, see the original repository.

Features

✨ What's New in This Fork

• Full Homebridge 2.0 compatibility
• Automatic discovery of Envisalink devices
• Improved stability and error handling
• Regular updates and maintenance
• TypeScript rewrite for better reliability

🔒 Core Features

• Support for both Envisalink 3 and 4
• DSC and Honeywell panel support
• Zone monitoring (doors, windows, motion, smoke, leak sensors)
• Multiple partition support
• Custom command support
• Chime control
• Panic buttons

Installation

npm install -g @brandonarrindell/homebridge-envisalink

Configuration

Add to your Homebridge config.json:

{
  "platforms": [
    {
      "platform": "Envisalink",
      "enableAutoDiscovery": true,
      "host": "192.168.0.XXX",  // Optional if enableAutoDiscovery is true
      "deviceType": "DSC",
      "password": "YOUR_PASSWORD",  // Default is "user"
      "pin": "YOUR_PANEL_PIN",
      "suppressZoneAccessories": false,
      "suppressClockReset": false,
      "ambulancePanic": {
          "enabled": true,
          "name": "Ambulance Panic"
      },
      "firePanic": {
          "enabled": true,
          "name": "Fire Panic"
      },
      "policePanic": {
          "enabled": true,
          "name": "Police Panic"
      },
      "partitions": [
        {
          "name": "Main Alarm",
          "enableChimeSwitch": true,
          "pin": "1243"
        }
      ],
      "zones": [
        {
          "name": "Front Door",
          "type": "door",
          "partition": 1
        },
        {
          "name": "Master Bedroom Door",
          "type": "door",
          "partition": 1
        }
      ]
    }
  ]
}

Configuration Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | enableAutoDiscovery | boolean | true | Automatically discover Envisalink devices | | host | string | - | IP address of Envisalink (optional with auto-discovery) | | deviceType | string | "DSC" | Panel type ("DSC" or "Honeywell") | | password | string | "user" | Envisalink web interface password | | pin | string | - | Alarm panel PIN for disarming | | suppressZoneAccessories | boolean | false | Hide zone accessories in HomeKit | | suppressClockReset | boolean | false | Disable hourly panel clock sync |

See config.schema.json for full configuration options.

Auto-Discovery

The auto-discovery feature scans your network for Envisalink devices:

1. Enable with enableAutoDiscovery: true
2. Omit host to use auto-discovery exclusively
3. First discovered device will be used
4. Manual host configuration takes precedence

Advanced Features

Home vs. Night Arm Modes

• Home: Arms in stay mode with entry delay
• Night: Arms in stay mode with no entry delay (instant alarm)

Non-Sequential Zones

For systems with gaps in zone numbering:

{
  "zones": [
    {
      "name": "Front Door",
      "type": "door",
      "partition": 1,
      "zoneNumber": 1
    },
    {
      "name": "Garage Door",
      "type": "door",
      "partition": 1,
      "zoneNumber": 5
    }
  ]
}

Custom Commands

Add custom panel commands:

{
  "customCommands": [
    {
      "name": "System Test",
      "command": "071*600004"
    }
  ]
}

Troubleshooting

Common Issues

1. Connection Problems

   • Only one socket connection allowed at a time
   • Use wired connections when possible
   • Set static IP for Envisalink
   • Verify password is correct

2. Debug Mode

   {
     "platforms": [
       {
         "platform": "Envisalink",
         "enableVerboseLogging": true
       }
     ]
   }

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

Credits

• Original plugin by Dustin D. Clark
• Built on Node Alarm Proxy

License

This project is licensed under the MIT License - see the LICENSE file for details.