homekit-garage-opener

README

Garage Opener

This is a simple implementation of brutella/hc. Turning a Liftmaster into a homekit compatible garage door opener.

• Parts
• Assembly
• Features
• Development
  • Basics - Install Location, Logs, Config
  • Executable
  • Packaging
  • Installing

Parts

Name	Link	Price Estimate
Raspberry Pi	Zero W / 3B+	Zero W ~ $14 / 3b+ ~$35
5V 2.5A Charger (For Pi)	Newark	~ $9
5v Relay Module	Amazon / Frys	~ $5
Jumper Wires F to F	Amazon	~ $7
Wire any guage	Amazon	~ $14
	Total	$49 ~ $70

Assembly

Coming Soon

Features

• ✅ Opening and Closing
  • 🔜 True stateful opening and closing (will require distance sensor)
• 🔜 Obstacle Detection

Development

Basics

Deb install path

The deb package installs files to /opt/garage/

Logs

Logs can be found at /opt/garage/logs

Config File

The config file allows you make minor changes without touching code

Optional Values

• Name (Default=Garage Door): The text that will appear in Homekit as the name of the accessory
• Manufacturer (Default=Liftmaster): The manufacturer of the accessory
• Model (Default=Professional 1/3 HP): The model of the accessory
• SerialNumber (Default=l1f7m4573r): The serial number of the accessory

IMPORTANT Manufacturer, Model, SerialNumber has no effect besides showing it under accessory information in Homekit.

Required Values

• Pin: The BCM gpio pin that will active the relay.

Simple Config

{
    "pin": 2
}

Executable

If you would rather build to a binary/executable you can just use go build like

go build -o garage main.go

Packaging

This project uses nfpm to create a deb package for installing on linux with armhf architecture. It is fairly simple to enable other architectures, requested if would be useful.

make package-linux arch=armhf

Installing

sudo dpkg -i INSERTDEBFILEHERE