Skip to content

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
NickWaterton committed May 27, 2022
1 parent 7debd26 commit 91e4433
Showing 1 changed file with 51 additions and 0 deletions.
51 changes: 51 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# lutron.py
A python Asyncronous MQTT interface to Lutron Casetta Devices

Uses the LEAP protocol.

## Requirements

Needs a Lutron Bridge or Bridge Pro 2
Python 3.6 or above only (uses asyncio)

### Packages required
paho-mqtt
pylutron-caseta (see https://github.com/gurumitts/pylutron-caseta)

## Usage

```
usage: lutron.py [-h] [-t TOPIC] [-T FEEDBACK] [-b BROKER] [-p PORT] [-U USER] [-P PASSWD] [-l LOG] [-J] [-D] [--version] bridgeip
Forward MQTT data to Lutron API
positional arguments:
bridgeip Bridge ip Address (default: None)
optional arguments:
-h, --help show this help message and exit
-t TOPIC, --topic TOPIC
MQTT Topic to send commands to, (can use # and +) default: /lutron/command)
-T FEEDBACK, --feedback FEEDBACK
Topic on broker to publish feedback to (default: /lutron/feedback)
-b BROKER, --broker BROKER
ipaddress of MQTT broker (default: None)
-p PORT, --port PORT MQTT broker port number (default: 1883)
-U USER, --user USER MQTT broker user name (default: None)
-P PASSWD, --passwd PASSWD
MQTT broker password (default: None)
-l LOG, --log LOG path/name of log file (default: ./lutron.log)
-J, --json_out publish topics as json (vs individual topics) (default: False)
-D, --debug debug mode
--version Display version of this program
```

## Example

```
./lutron.py 192.168.100.141 -b 192.168.100.16
```

Where `192.168.100.141` is the ip address of your bridge, and `192.168.100.16` is the ip address of your MQTT broker

The first time you run the command, you will be prompted to pair with the bridge by pressing the button on the bridge. This will download the neccessary certificates to allow secure communications. You only need to do this the first time you connect.

0 comments on commit 91e4433

Please sign in to comment.