78 lines
4.7 KiB
C++
78 lines
4.7 KiB
C++
|
|
////////////////////////////////////////////////////////////
|
|
// //
|
|
// HomeSpan: A HomeKit implementation for the ESP32 //
|
|
// ------------------------------------------------ //
|
|
// //
|
|
// Example 13: Target States and Current States //
|
|
// * implementing a Garage Door Opener //
|
|
// * implementing a motorized Window Shade //
|
|
// //
|
|
////////////////////////////////////////////////////////////
|
|
|
|
#include "HomeSpan.h"
|
|
#include "DEV_Identify.h"
|
|
#include "DEV_DoorsWindows.h"
|
|
|
|
void setup() {
|
|
|
|
// In Example 12 we saw how to implement the loop() method for a Service to continuously monitor our device and periodically report
|
|
// changes in one or more Characteristics back to HomeKit using setVal() and timeVal(). In that example we implemented passive sensors
|
|
// that operated independently and required no input from the user, which meant we did not need to implement any update() methods.
|
|
|
|
// In this Example 13 we demonstrate the simultaneous use of both the update() and loop() methods by implementing two new Services:
|
|
// a Garage Door Opener and a motorized Window Shade. Both examples showcase HomeKit's Target-State/Current-State framework.
|
|
// For physical devices that take time to operate (such as closing a door), HomeKit Services typically use:
|
|
|
|
// * one Characteristic that HomeKit sets via update() requests to HomeSpan, and that represent a desired target state,
|
|
// such as opened, closed, or in some cases a percentage opened or closed; and
|
|
|
|
// * one read-only Characteristic that HomeSpan use to track the current state of the device in the loop() method, as well as
|
|
// report back changes to HomeKit using setVal().
|
|
|
|
// Not all HomeKit Services utilize the same Characteristics to define target and current states. Some Services use Characteristics
|
|
// that are specific to that one Service, whereas others use more generic Characteristics. The common theme seems to be that HomeKit
|
|
// guesses the actions a device is taking, and updates it tile's icon accordingly, by comparing the value of the target state
|
|
// Characteristic it sets, and the current state Characteristic it receives in the form of Event Notifications. When they are the same,
|
|
// HomeKit assumes the physical device has reached the required position. When they differ, HomeKit assumes something will be opening,
|
|
// closing, raising, lowering, etc. The details of this process for each Service is outlined in the HAP documentation, but beware
|
|
// the document is not always up to date with the lastest version of the HomeKit application. Sometimes a little experimenting and a lot
|
|
// of trial and error is required to fully understand how each Service responds to different combinations of Characteristic values.
|
|
|
|
// As always, we won't be connecting our ESP32 to an actual garage door or window shade but will instead simulate their responses and
|
|
// actions for illustrative purposes. In some ways the code is more complicated because of the need to simulate values - it might be
|
|
// easier if we actually were connecting to a garage door or window shade!
|
|
|
|
// Fully commented code for both of our derived Services can be found in DEV_DoorsWindows.h. These examples do not introduce any new
|
|
// HomeSpan functions or features. Rather we are combining everything learned so far into two reasonably complex Services. You may
|
|
// want to reference the HAP documentation for these two parent Services to fully understand the meaning of the different value settings
|
|
// for each of the Services' Characteristics.
|
|
|
|
Serial.begin(115200);
|
|
|
|
homeSpan.begin(Category::Bridges,"HomeSpan Bridge");
|
|
|
|
|
|
new SpanAccessory();
|
|
new DEV_Identify("Bridge #1","HomeSpan","123-ABC","HS Bridge","0.9",3);
|
|
new Service::HAPProtocolInformation();
|
|
new Characteristic::Version("1.1.0");
|
|
|
|
new SpanAccessory();
|
|
new DEV_Identify("Garage Door","HomeSpan","123-ABC","Door","0.9",0);
|
|
new DEV_GarageDoor(); // Create a Garage Door Opener (see DEV_DoorsWindows.h for definition)
|
|
|
|
new SpanAccessory();
|
|
new DEV_Identify("Window Shade","HomeSpan","123-ABC","Shade","0.9",0);
|
|
new DEV_WindowShade(); // Create a motorized Window Shade (see DEV_DoorsWindows.h for definition)
|
|
|
|
} // end of setup()
|
|
|
|
//////////////////////////////////////
|
|
|
|
void loop(){
|
|
|
|
homeSpan.poll();
|
|
|
|
} // end of loop()
|