openhab-addons/bundles/org.openhab.binding.myq
Dan Cunningham 7efc3e9e81
[myq] Switch to using oAuth for logins (#11183)
* change MyQ binding to use now required oAuth for authentication

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* Clean up error handling

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* Cleanup checkstyle errors

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* missing newline

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* Remove unused classes

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* Add token listener

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* add a redirect limit...just in case

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* Don't resue the oAuth service if we have been disosed or its closed.  Reduce logging verbosity.

Signed-off-by: Dan Cunningham <dan@digitaldan.com>

* Force login if we get a 401 response

Signed-off-by: Dan Cunningham <dan@digitaldan.com>
2021-09-11 13:41:28 +02:00
..
src/main [myq] Switch to using oAuth for logins (#11183) 2021-09-11 13:41:28 +02:00
NOTICE [myq] Switch to using oAuth for logins (#11183) 2021-09-11 13:41:28 +02:00
pom.xml [myq] Switch to using oAuth for logins (#11183) 2021-09-11 13:41:28 +02:00
README.md [MyQ] Initial commit of the MyQ binding for OH3 (#9347) 2021-02-26 14:50:25 -08:00

MyQ Binding

This binding integrates with the The Chamberlain Group MyQ cloud service. It allows monitoring and control over MyQ enabled garage doors manufactured by LiftMaster, Chamberlain and Craftsman.

Supported Things

Account

This represents the MyQ cloud account and uses the same credentials needed when using the MyQ mobile application.

ThingTypeUID: account

Garage Door

This represents a garage door associated with an account. Multiple garage doors are supported.

ThingTypeUID: garagedoor

Lamp

This represents a lamp associated with an account. Multiple lamps are supported.

ThingTypeUID: lamp

Discovery

Once an account has been added, garage doors and lamps will automatically be discovered and added to the inbox.

Channels

Channel Item Type Thing Type States
status String garagedoor opening, closed, closing, stopped, transition, unknown
rollershutter Rollershutter garagedoor UP, DOWN, 0%, 100%
switch Switch garagedoor, lamp ON (open), OFF (closed)

Full Example

Thing Configuration

Bridge myq:account:home "MyQ Account" [ username="foo@bar.com", password="secret", refreshInterval=60 ] {
    Thing garagedoor abcd12345 "MyQ Garage Door" [ serialNumber="abcd12345" ]
    Thing lamp efgh6789 "MyQ Lamp" [ serialNumber="efgh6789" ]
}

Items

String MyQGarageDoor1Status "Door Status [%s]" {channel = "myq:garagedoor:home:abcd12345:status"}
Switch MyQGarageDoor1Switch "Door Switch [%s]" {channel = "myq:garagedoor:home:abcd12345:switch"}
Rollershutter MyQGarageDoor1Rollershutter "Door Rollershutter [%s]" {channel = "myq:garagedoor:home:abcd12345:rollershutter"}
Switch MyQGarageDoorLamp "Lamp [%s]" {channel = "myq:lamp:home:efgh6789:switch"}
}

Sitemaps

sitemap MyQ label="MyQ Demo Sitemap" {
  Frame label="Garage Door" {
    String item=MyQGarageDoor1Status
    Switch item=MyQGarageDoor1Switch
    Rollershutter item=MyQGarageDoor1Rollershutter
  }                
}