2 * Copyright (c) 2010-2023 Contributors to the openHAB project
4 * See the NOTICE file(s) distributed with this work for additional
7 * This program and the accompanying materials are made available under the
8 * terms of the Eclipse Public License 2.0 which is available at
9 * http://www.eclipse.org/legal/epl-2.0
11 * SPDX-License-Identifier: EPL-2.0
13 package org.openhab.io.homekit.internal.accessories;
15 import static org.openhab.io.homekit.internal.HomekitCharacteristicType.*;
17 import java.math.BigDecimal;
18 import java.util.HashMap;
20 import java.util.Optional;
21 import java.util.concurrent.CompletableFuture;
22 import java.util.concurrent.ExecutionException;
23 import java.util.function.Function;
24 import java.util.function.Supplier;
26 import org.eclipse.jdt.annotation.NonNullByDefault;
27 import org.openhab.io.homekit.internal.HomekitCharacteristicType;
28 import org.slf4j.Logger;
29 import org.slf4j.LoggerFactory;
31 import io.github.hapjava.characteristics.Characteristic;
32 import io.github.hapjava.characteristics.impl.airquality.AirQualityCharacteristic;
33 import io.github.hapjava.characteristics.impl.airquality.AirQualityEnum;
34 import io.github.hapjava.characteristics.impl.common.ActiveCharacteristic;
35 import io.github.hapjava.characteristics.impl.common.ActiveEnum;
36 import io.github.hapjava.characteristics.impl.common.ActiveIdentifierCharacteristic;
37 import io.github.hapjava.characteristics.impl.common.ConfiguredNameCharacteristic;
38 import io.github.hapjava.characteristics.impl.common.IdentifierCharacteristic;
39 import io.github.hapjava.characteristics.impl.common.IsConfiguredCharacteristic;
40 import io.github.hapjava.characteristics.impl.common.IsConfiguredEnum;
41 import io.github.hapjava.characteristics.impl.common.NameCharacteristic;
42 import io.github.hapjava.characteristics.impl.heatercooler.CurrentHeaterCoolerStateCharacteristic;
43 import io.github.hapjava.characteristics.impl.heatercooler.CurrentHeaterCoolerStateEnum;
44 import io.github.hapjava.characteristics.impl.heatercooler.TargetHeaterCoolerStateCharacteristic;
45 import io.github.hapjava.characteristics.impl.heatercooler.TargetHeaterCoolerStateEnum;
46 import io.github.hapjava.characteristics.impl.inputsource.CurrentVisibilityStateCharacteristic;
47 import io.github.hapjava.characteristics.impl.inputsource.CurrentVisibilityStateEnum;
48 import io.github.hapjava.characteristics.impl.inputsource.InputDeviceTypeCharacteristic;
49 import io.github.hapjava.characteristics.impl.inputsource.InputDeviceTypeEnum;
50 import io.github.hapjava.characteristics.impl.inputsource.InputSourceTypeCharacteristic;
51 import io.github.hapjava.characteristics.impl.inputsource.InputSourceTypeEnum;
52 import io.github.hapjava.characteristics.impl.television.ClosedCaptionsCharacteristic;
53 import io.github.hapjava.characteristics.impl.television.ClosedCaptionsEnum;
54 import io.github.hapjava.characteristics.impl.television.PictureModeCharacteristic;
55 import io.github.hapjava.characteristics.impl.television.PictureModeEnum;
56 import io.github.hapjava.characteristics.impl.television.SleepDiscoveryModeCharacteristic;
57 import io.github.hapjava.characteristics.impl.television.SleepDiscoveryModeEnum;
58 import io.github.hapjava.characteristics.impl.televisionspeaker.VolumeControlTypeCharacteristic;
59 import io.github.hapjava.characteristics.impl.televisionspeaker.VolumeControlTypeEnum;
60 import io.github.hapjava.characteristics.impl.thermostat.CurrentHeatingCoolingStateCharacteristic;
61 import io.github.hapjava.characteristics.impl.thermostat.CurrentHeatingCoolingStateEnum;
62 import io.github.hapjava.characteristics.impl.thermostat.TargetHeatingCoolingStateCharacteristic;
63 import io.github.hapjava.characteristics.impl.thermostat.TargetHeatingCoolingStateEnum;
66 * Creates an optional characteristics from metadata
68 * @author Cody Cutrer - Initial contribution
71 public class HomekitMetadataCharacteristicFactory {
72 private static final Logger logger = LoggerFactory.getLogger(HomekitMetadataCharacteristicFactory.class);
74 // List of optional characteristics that can be set via metadata, and the corresponding method to create them.
75 private final static Map<HomekitCharacteristicType, Function<Object, Characteristic>> optional = new HashMap<>() {
77 put(ACTIVE_IDENTIFIER, HomekitMetadataCharacteristicFactory::createActiveIdentifierCharacteristic);
78 put(ACTIVE_STATUS, HomekitMetadataCharacteristicFactory::createActiveStatusCharacteristic);
79 put(AIR_QUALITY, HomekitMetadataCharacteristicFactory::createAirQualityCharacteristic);
80 put(CLOSED_CAPTIONS, HomekitMetadataCharacteristicFactory::createClosedCaptionsCharacteristic);
81 put(CONFIGURED, HomekitMetadataCharacteristicFactory::createIsConfiguredCharacteristic);
82 put(CONFIGURED_NAME, HomekitMetadataCharacteristicFactory::createConfiguredNameCharacteristic);
83 put(CURRENT_HEATER_COOLER_STATE,
84 HomekitMetadataCharacteristicFactory::createCurrentHeaterCoolerStateCharacteristic);
85 put(CURRENT_HEATING_COOLING_STATE,
86 HomekitMetadataCharacteristicFactory::createCurrentHeatingCoolingStateCharacteristic);
87 put(CURRENT_VISIBILITY, HomekitMetadataCharacteristicFactory::createCurrentVisibilityCharacteristic);
88 put(IDENTIFIER, HomekitMetadataCharacteristicFactory::createIdentifierCharacteristic);
89 put(INPUT_DEVICE_TYPE, HomekitMetadataCharacteristicFactory::createInputDeviceTypeCharacteristic);
90 put(INPUT_SOURCE_TYPE, HomekitMetadataCharacteristicFactory::createInputSourceTypeCharacteristic);
91 put(NAME, HomekitMetadataCharacteristicFactory::createNameCharacteristic);
92 put(PICTURE_MODE, HomekitMetadataCharacteristicFactory::createPictureModeCharacteristic);
93 put(SLEEP_DISCOVERY_MODE, HomekitMetadataCharacteristicFactory::createSleepDiscoveryModeCharacteristic);
94 put(TARGET_HEATER_COOLER_STATE,
95 HomekitMetadataCharacteristicFactory::createTargetHeaterCoolerStateCharacteristic);
96 put(TARGET_HEATING_COOLING_STATE,
97 HomekitMetadataCharacteristicFactory::createTargetHeatingCoolingStateCharacteristic);
98 put(VOLUME_CONTROL_TYPE, HomekitMetadataCharacteristicFactory::createVolumeControlTypeCharacteristic);
102 public static Optional<Characteristic> createCharacteristic(String characteristic, Object value) {
103 var type = HomekitCharacteristicType.valueOfTag(characteristic);
104 if (type.isEmpty() || !optional.containsKey(type.get()))
105 return Optional.empty();
106 return Optional.of(optional.get(type.get()).apply(value));
109 private static Supplier<CompletableFuture<Integer>> getInteger(Object value) {
111 if (value instanceof BigDecimal) {
112 intValue = ((BigDecimal) value).intValue();
113 } else if (value instanceof Float) {
114 intValue = ((Float) value).intValue();
115 } else if (value instanceof Integer) {
116 intValue = (Integer) value;
117 } else if (value instanceof Long) {
118 intValue = ((Long) value).intValue();
120 intValue = Integer.valueOf(value.toString());
122 return () -> CompletableFuture.completedFuture(intValue);
125 private static Supplier<CompletableFuture<String>> getString(Object value) {
126 return () -> CompletableFuture.completedFuture(value.toString());
129 private static <T extends Enum<T>> Supplier<CompletableFuture<T>> getEnum(Object value, Class<T> klazz) {
130 T enumValue = Enum.valueOf(klazz, value.toString());
131 return () -> CompletableFuture.completedFuture(enumValue);
134 private static <T extends Enum<T>> Supplier<CompletableFuture<T>> getEnum(Object value, Class<T> klazz, T trueValue,
136 if (value.equals(true) || value.equals("true")) {
137 return () -> CompletableFuture.completedFuture(trueValue);
138 } else if (value.equals(false) || value.equals("false")) {
139 return () -> CompletableFuture.completedFuture(falseValue);
141 return getEnum(value, klazz);
144 private static Characteristic createActiveIdentifierCharacteristic(Object value) {
145 return new ActiveIdentifierCharacteristic(getInteger(value), v -> {
151 private static Characteristic createActiveStatusCharacteristic(Object value) {
152 return new ActiveCharacteristic(getEnum(value, ActiveEnum.class, ActiveEnum.ACTIVE, ActiveEnum.INACTIVE), v -> {
158 private static Characteristic createAirQualityCharacteristic(Object value) {
159 return new AirQualityCharacteristic(getEnum(value, AirQualityEnum.class), v -> {
164 private static Characteristic createClosedCaptionsCharacteristic(Object value) {
165 return new ClosedCaptionsCharacteristic(
166 getEnum(value, ClosedCaptionsEnum.class, ClosedCaptionsEnum.ENABLED, ClosedCaptionsEnum.DISABLED),
173 private static Characteristic createIsConfiguredCharacteristic(Object value) {
174 return new IsConfiguredCharacteristic(
175 getEnum(value, IsConfiguredEnum.class, IsConfiguredEnum.CONFIGURED, IsConfiguredEnum.NOT_CONFIGURED),
182 private static Characteristic createConfiguredNameCharacteristic(Object value) {
183 return new ConfiguredNameCharacteristic(getString(value), v -> {
189 private static Characteristic createCurrentVisibilityCharacteristic(Object value) {
190 return new CurrentVisibilityStateCharacteristic(getEnum(value, CurrentVisibilityStateEnum.class,
191 CurrentVisibilityStateEnum.SHOWN, CurrentVisibilityStateEnum.HIDDEN), v -> {
196 private static Characteristic createCurrentHeaterCoolerStateCharacteristic(Object value) {
197 var enumSupplier = getEnum(value, CurrentHeaterCoolerStateEnum.class);
198 CurrentHeaterCoolerStateEnum enumValue;
200 enumValue = enumSupplier.get().get();
201 } catch (InterruptedException | ExecutionException e) {
202 enumValue = CurrentHeaterCoolerStateEnum.INACTIVE;
204 return new CurrentHeaterCoolerStateCharacteristic(new CurrentHeaterCoolerStateEnum[] { enumValue },
210 private static Characteristic createCurrentHeatingCoolingStateCharacteristic(Object value) {
211 var enumSupplier = getEnum(value, CurrentHeatingCoolingStateEnum.class);
212 CurrentHeatingCoolingStateEnum enumValue;
214 enumValue = enumSupplier.get().get();
215 } catch (InterruptedException | ExecutionException e) {
216 enumValue = CurrentHeatingCoolingStateEnum.OFF;
218 return new CurrentHeatingCoolingStateCharacteristic(new CurrentHeatingCoolingStateEnum[] { enumValue },
224 private static Characteristic createIdentifierCharacteristic(Object value) {
225 return new IdentifierCharacteristic(getInteger(value));
228 private static Characteristic createInputDeviceTypeCharacteristic(Object value) {
229 return new InputDeviceTypeCharacteristic(getEnum(value, InputDeviceTypeEnum.class), v -> {
234 private static Characteristic createInputSourceTypeCharacteristic(Object value) {
235 return new InputSourceTypeCharacteristic(getEnum(value, InputSourceTypeEnum.class), v -> {
240 private static Characteristic createNameCharacteristic(Object value) {
241 return new NameCharacteristic(getString(value));
244 private static Characteristic createPictureModeCharacteristic(Object value) {
245 return new PictureModeCharacteristic(getEnum(value, PictureModeEnum.class), v -> {
251 private static Characteristic createSleepDiscoveryModeCharacteristic(Object value) {
252 return new SleepDiscoveryModeCharacteristic(getEnum(value, SleepDiscoveryModeEnum.class,
253 SleepDiscoveryModeEnum.ALWAYS_DISCOVERABLE, SleepDiscoveryModeEnum.NOT_DISCOVERABLE), v -> {
258 private static Characteristic createTargetHeaterCoolerStateCharacteristic(Object value) {
259 var enumSupplier = getEnum(value, TargetHeaterCoolerStateEnum.class);
260 TargetHeaterCoolerStateEnum enumValue;
262 enumValue = enumSupplier.get().get();
263 } catch (InterruptedException | ExecutionException e) {
264 enumValue = TargetHeaterCoolerStateEnum.AUTO;
267 return new TargetHeaterCoolerStateCharacteristic(new TargetHeaterCoolerStateEnum[] { enumValue }, enumSupplier,
274 private static Characteristic createTargetHeatingCoolingStateCharacteristic(Object value) {
275 var enumSupplier = getEnum(value, TargetHeatingCoolingStateEnum.class);
276 TargetHeatingCoolingStateEnum enumValue;
278 enumValue = enumSupplier.get().get();
279 } catch (InterruptedException | ExecutionException e) {
280 enumValue = TargetHeatingCoolingStateEnum.OFF;
283 return new TargetHeatingCoolingStateCharacteristic(new TargetHeatingCoolingStateEnum[] { enumValue },
290 private static Characteristic createVolumeControlTypeCharacteristic(Object value) {
291 return new VolumeControlTypeCharacteristic(getEnum(value, VolumeControlTypeEnum.class), v -> {