212 lines
9.1 KiB
C++
212 lines
9.1 KiB
C++
/*********************************************************************************
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2021-2022 Gregg E. Berman
|
|
*
|
|
* https://github.com/HomeSpan/HomeSpan
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in all
|
|
* copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*
|
|
********************************************************************************/
|
|
|
|
// HomeSpan Television Service Example
|
|
|
|
// Covers all Characteristics of the Television Service that appear to
|
|
// be supported in the iOS 15 version of the Home App. Note these Services
|
|
// are not documented by Apple and are not officially part HAP-R2.
|
|
//
|
|
// For Service::Television():
|
|
//
|
|
// * Characteristic::Active()
|
|
// * Characteristic::ConfiguredName()
|
|
// * Characteristic::ActiveIdentifier()
|
|
// * Characteristic::RemoteKey()
|
|
// * Characteristic::PowerModeSelection()
|
|
//
|
|
// For Service::InputSource():
|
|
//
|
|
// * Characteristic::ConfiguredName()
|
|
// * Characteristic::ConfiguredNameStatic() // a HomeSpan-specific variation of ConfiguredName()
|
|
// * Characteristic::Identifier()
|
|
// * Characteristic::IsConfigured()
|
|
// * Characteristic::CurrentVisibilityState()
|
|
// * Characteristic::TargetVisibilityState()
|
|
|
|
// NOTE: This example is only designed to demonstrate how Television Services and Characteristics
|
|
// appear in the Home App, and what they each control. To keep things simple, actions for the
|
|
// Input Sources have NOT been implemented in the code below. For example, the code below does not include
|
|
// any logic to update CurrentVisibilityState when the TargetVisibilityState checkboxes are clicked.
|
|
|
|
#include "HomeSpan.h"
|
|
|
|
struct HomeSpanTV : Service::Television {
|
|
|
|
SpanCharacteristic *active = new Characteristic::Active(0); // TV On/Off (set to Off at start-up)
|
|
SpanCharacteristic *activeID = new Characteristic::ActiveIdentifier(3); // Sets HDMI 3 on start-up
|
|
SpanCharacteristic *remoteKey = new Characteristic::RemoteKey(); // Used to receive button presses from the Remote Control widget
|
|
SpanCharacteristic *settingsKey = new Characteristic::PowerModeSelection(); // Adds "View TV Setting" option to Selection Screen
|
|
|
|
HomeSpanTV(const char *name) : Service::Television() {
|
|
new Characteristic::ConfiguredName(name); // Name of TV
|
|
Serial.printf("Configured TV: %s\n",name);
|
|
}
|
|
|
|
boolean update() override {
|
|
|
|
if(active->updated()){
|
|
Serial.printf("Set TV Power to: %s\n",active->getNewVal()?"ON":"OFF");
|
|
}
|
|
|
|
if(activeID->updated()){
|
|
Serial.printf("Set Input Source to HDMI-%d\n",activeID->getNewVal());
|
|
}
|
|
|
|
if(settingsKey->updated()){
|
|
Serial.printf("Received request to \"View TV Settings\"\n");
|
|
}
|
|
|
|
if(remoteKey->updated()){
|
|
Serial.printf("Remote Control key pressed: ");
|
|
switch(remoteKey->getNewVal()){
|
|
case 4:
|
|
Serial.printf("UP ARROW\n");
|
|
break;
|
|
case 5:
|
|
Serial.printf("DOWN ARROW\n");
|
|
break;
|
|
case 6:
|
|
Serial.printf("LEFT ARROW\n");
|
|
break;
|
|
case 7:
|
|
Serial.printf("RIGHT ARROW\n");
|
|
break;
|
|
case 8:
|
|
Serial.printf("SELECT\n");
|
|
break;
|
|
case 9:
|
|
Serial.printf("BACK\n");
|
|
break;
|
|
case 11:
|
|
Serial.printf("PLAY/PAUSE\n");
|
|
break;
|
|
case 15:
|
|
Serial.printf("INFO\n");
|
|
break;
|
|
default:
|
|
Serial.print("UNKNOWN KEY\n");
|
|
}
|
|
}
|
|
|
|
return(true);
|
|
}
|
|
};
|
|
|
|
///////////////////////////////
|
|
|
|
void setup() {
|
|
|
|
Serial.begin(115200);
|
|
|
|
homeSpan.begin(Category::Television,"HomeSpan Television");
|
|
|
|
SPAN_ACCESSORY();
|
|
|
|
// Below we define 10 different InputSource Services using different combinations
|
|
// of Characteristics to demonstrate how they interact and appear to the user in the Home App
|
|
|
|
SpanService *hdmi1 = new Service::InputSource(); // Source included in Selection List, but excluded from Settings Screen
|
|
new Characteristic::ConfiguredName("HDMI 1");
|
|
new Characteristic::Identifier(1);
|
|
|
|
SpanService *hdmi2 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 2");
|
|
new Characteristic::Identifier(2);
|
|
new Characteristic::IsConfigured(0); // Source excluded from both the Selection List and the Settings Screen
|
|
|
|
SpanService *hdmi3 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 3");
|
|
new Characteristic::Identifier(3);
|
|
new Characteristic::IsConfigured(1); // Source included in both the Selection List and the Settings Screen
|
|
|
|
SpanService *hdmi4 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 4");
|
|
new Characteristic::Identifier(4);
|
|
new Characteristic::IsConfigured(1); // Source included in the Settings Screen...
|
|
new Characteristic::CurrentVisibilityState(1); // ...but excluded from the Selection List
|
|
|
|
SpanService *hdmi5 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 5");
|
|
new Characteristic::Identifier(5);
|
|
new Characteristic::IsConfigured(1); // Source included in the Settings Screen...
|
|
new Characteristic::CurrentVisibilityState(0); // ...and included in the Selection List
|
|
|
|
SpanService *hdmi6 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 6");
|
|
new Characteristic::Identifier(6);
|
|
new Characteristic::IsConfigured(0); // Source excluded from both the Selection List and the Settings Screen
|
|
new Characteristic::CurrentVisibilityState(0); // If IsConfigured(0) is specified, CurrentVisibilityState() has no effect
|
|
|
|
SpanService *hdmi7 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 7");
|
|
new Characteristic::Identifier(7);
|
|
new Characteristic::IsConfigured(1); // Source included in the Settings Screen...
|
|
new Characteristic::CurrentVisibilityState(0); // ...and included in the Selection List...
|
|
new Characteristic::TargetVisibilityState(0); // ...and a "checked" checkbox is provided on the Settings Screen that can be used to toggle CurrentVisibilityState()
|
|
|
|
SpanService *hdmi8 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 8");
|
|
new Characteristic::Identifier(8);
|
|
new Characteristic::IsConfigured(1); // Source included in the Settings Screen...
|
|
new Characteristic::CurrentVisibilityState(1); // ...but excluded from the Selection List...
|
|
new Characteristic::TargetVisibilityState(1); // ...and an "un-checked" checkbox is provided on the Settings Screen that can be used to toggle CurrentVisibilityState()
|
|
|
|
SpanService *hdmi9 = new Service::InputSource();
|
|
new Characteristic::ConfiguredName("HDMI 9");
|
|
new Characteristic::IsConfigured(1); // Source included in the Settings Screen...
|
|
new Characteristic::CurrentVisibilityState(0); // ...but without an Identifier() set, the Source is excluded from the Selection List regardless of CurrentVisibilityState(0)
|
|
new Characteristic::TargetVisibilityState(0);
|
|
|
|
SpanService *hdmi10 = new Service::InputSource();
|
|
(new Characteristic::ConfiguredName("HDMI 10"))->removePerms(PW); // Source Name permissions changed and now cannot be edited in Settings Screen
|
|
new Characteristic::Identifier(10);
|
|
new Characteristic::IsConfigured(1); // Source included in the Settings Screen...
|
|
new Characteristic::CurrentVisibilityState(0); // ...and included in the Selection List...
|
|
new Characteristic::TargetVisibilityState(0); // ...and a "checked" checkbox is provided on the Settings Screen that can be used to toggle CurrentVisibilityState()
|
|
|
|
(new HomeSpanTV("Test TV")) // Define a Television Service. Must link in InputSources!
|
|
->addLink(hdmi1)
|
|
->addLink(hdmi2)
|
|
->addLink(hdmi3)
|
|
->addLink(hdmi4)
|
|
->addLink(hdmi5)
|
|
->addLink(hdmi6)
|
|
->addLink(hdmi7)
|
|
->addLink(hdmi8)
|
|
->addLink(hdmi9)
|
|
->addLink(hdmi10)
|
|
;
|
|
|
|
}
|
|
|
|
///////////////////////////////
|
|
|
|
void loop() {
|
|
homeSpan.poll();
|
|
}
|