homekit-amt8000

This projects creates a Homekit bridge and accessories for the Intelbras AMT8000 alarm system.

Security System + Panic button

Zones (motion and contact) + Bypass switches

Configuration

This project is set up using environment variables.

Full list of them and what they are for:

# Alarm IP addr.
# required.
HOST=192.168.207.4

# Alarm password.
# Should be the remote configuration password (usually 6 digits).
# required.
PASSWORD=123456

# Cental port.
# default: 9009.
PORT=9009

# Zones that are motion sensors.
MOTION="1,2,3"

# Zones that are contact sensors (i.e. doors, windows).
CONTACT="4,5,6"

# Zones to show the bypass switch for.
BYPASS='1,2,3,4,5,6,7,8'

# Indexed zone names.
# default: "Zone 1,Zone 2,..."
ZONE_NAMES="Kitchen door,Living Room Window"

# Partitions to arm when set stay mode.
# required.
STAY="1,2"

# Partitions to arm when set to night mode.
# required.
NIGHT="2,3"

# Partitions to arm when set to away mode.
# required.
AWAY="0"

# Siren numbers you want to be shown.
# It'll show them as a contact sensor, with Tamper and Battery status.
SIRENS="1,2"

# Repeater numbers you want to be shown.
# It'll show them as a contact sensor, with Tamper and Battery status.
REPEATERS="1,2"

# If the alarm is triggered, and you turn it off, after this amount of time the
# bridge will automatically clean the firings.
# If empty or 0, it will not automatically do that.
CLEAN_FIRINGS_AFTER=5m

Warning

the away mode of the Homekit bridge does not translate to the per-manual stay mode in the Intelbras alarm system, mainly because it is supper confusing. Instead, the alarm system here has 4 states:

• Off
• Night: arms the $NIGHT partitions
• Away arms the $AWAY partitions
• Home arms the $STAY partitions

Rationale for what to do in each of them can be found here, but basically you'll want to arm all partitions on away, and a subset of partitions on night and stay, depending on your use case.

For me, I created 3 partitions:

1. Inside motion sensors
2. Outside motion sensors
3. Access sensors and doors

And I set it up like so:

AWAY=0
STAY=2
NIGHT=2,3

But, you do you. 😄

Running

source .env
go run .

Pin

Open the Home app, add new accessory, the security system should show up. Setup code is 001 02 003.

TODO

• panic switch
• bypass zones (?)
• multiple partitions per state
• show zones firing
• show partitions firing
• battery statuses
• read alarm mac addr
• receive notifications from the alarm system

License

The "Intelbras Documentation Sucks" License.

Caution

Be mindful of the license. Go, read it.

Previous work and thanks

• https://github.com/elvis-epx/alarme-intelbras
• https://github.com/thspinto/isecnet-go
• Wireshark

FAQ

Is this a homebridge plugin?

No.

Does it support security cams?

No.

Can you help me set it up?

No.

Can you add this thing I need?

No.

Can you merge my PR?

Unlikely.

Did you enjoy writing this?

Not in the slightest.