]> git.basschouten.com Git - openhab-addons.git/blob
fc90a45de830f2ce6d8e32fbdf4ee07d7a4b5537
[openhab-addons.git] /
1 /**
2  * Copyright (c) 2010-2022 Contributors to the openHAB project
3  *
4  * See the NOTICE file(s) distributed with this work for additional
5  * information.
6  *
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
10  *
11  * SPDX-License-Identifier: EPL-2.0
12  */
13 package org.openhab.io.homekit.internal.accessories;
14
15 import static org.openhab.io.homekit.internal.HomekitCharacteristicType.*;
16
17 import java.math.BigDecimal;
18 import java.math.RoundingMode;
19 import java.util.HashMap;
20 import java.util.Map;
21 import java.util.concurrent.CompletableFuture;
22 import java.util.function.BiFunction;
23 import java.util.function.Consumer;
24 import java.util.function.Supplier;
25
26 import javax.measure.Quantity;
27 import javax.measure.Unit;
28
29 import org.eclipse.jdt.annotation.NonNullByDefault;
30 import org.eclipse.jdt.annotation.Nullable;
31 import org.openhab.core.items.GenericItem;
32 import org.openhab.core.items.Item;
33 import org.openhab.core.library.items.ColorItem;
34 import org.openhab.core.library.items.DimmerItem;
35 import org.openhab.core.library.items.NumberItem;
36 import org.openhab.core.library.items.StringItem;
37 import org.openhab.core.library.items.SwitchItem;
38 import org.openhab.core.library.types.DecimalType;
39 import org.openhab.core.library.types.HSBType;
40 import org.openhab.core.library.types.OnOffType;
41 import org.openhab.core.library.types.OpenClosedType;
42 import org.openhab.core.library.types.PercentType;
43 import org.openhab.core.library.types.QuantityType;
44 import org.openhab.core.library.types.StringType;
45 import org.openhab.core.library.unit.ImperialUnits;
46 import org.openhab.core.library.unit.SIUnits;
47 import org.openhab.core.types.State;
48 import org.openhab.core.types.UnDefType;
49 import org.openhab.io.homekit.Homekit;
50 import org.openhab.io.homekit.internal.HomekitAccessoryUpdater;
51 import org.openhab.io.homekit.internal.HomekitCharacteristicType;
52 import org.openhab.io.homekit.internal.HomekitCommandType;
53 import org.openhab.io.homekit.internal.HomekitException;
54 import org.openhab.io.homekit.internal.HomekitImpl;
55 import org.openhab.io.homekit.internal.HomekitTaggedItem;
56 import org.osgi.framework.FrameworkUtil;
57 import org.slf4j.Logger;
58 import org.slf4j.LoggerFactory;
59
60 import io.github.hapjava.characteristics.Characteristic;
61 import io.github.hapjava.characteristics.CharacteristicEnum;
62 import io.github.hapjava.characteristics.ExceptionalConsumer;
63 import io.github.hapjava.characteristics.HomekitCharacteristicChangeCallback;
64 import io.github.hapjava.characteristics.impl.airquality.NitrogenDioxideDensityCharacteristic;
65 import io.github.hapjava.characteristics.impl.airquality.OzoneDensityCharacteristic;
66 import io.github.hapjava.characteristics.impl.airquality.PM10DensityCharacteristic;
67 import io.github.hapjava.characteristics.impl.airquality.PM25DensityCharacteristic;
68 import io.github.hapjava.characteristics.impl.airquality.SulphurDioxideDensityCharacteristic;
69 import io.github.hapjava.characteristics.impl.airquality.VOCDensityCharacteristic;
70 import io.github.hapjava.characteristics.impl.audio.VolumeCharacteristic;
71 import io.github.hapjava.characteristics.impl.battery.StatusLowBatteryCharacteristic;
72 import io.github.hapjava.characteristics.impl.battery.StatusLowBatteryEnum;
73 import io.github.hapjava.characteristics.impl.carbondioxidesensor.CarbonDioxideLevelCharacteristic;
74 import io.github.hapjava.characteristics.impl.carbondioxidesensor.CarbonDioxidePeakLevelCharacteristic;
75 import io.github.hapjava.characteristics.impl.carbonmonoxidesensor.CarbonMonoxideLevelCharacteristic;
76 import io.github.hapjava.characteristics.impl.carbonmonoxidesensor.CarbonMonoxidePeakLevelCharacteristic;
77 import io.github.hapjava.characteristics.impl.common.ActiveCharacteristic;
78 import io.github.hapjava.characteristics.impl.common.ActiveEnum;
79 import io.github.hapjava.characteristics.impl.common.ConfiguredNameCharacteristic;
80 import io.github.hapjava.characteristics.impl.common.NameCharacteristic;
81 import io.github.hapjava.characteristics.impl.common.ObstructionDetectedCharacteristic;
82 import io.github.hapjava.characteristics.impl.common.StatusActiveCharacteristic;
83 import io.github.hapjava.characteristics.impl.common.StatusFaultCharacteristic;
84 import io.github.hapjava.characteristics.impl.common.StatusFaultEnum;
85 import io.github.hapjava.characteristics.impl.common.StatusTamperedCharacteristic;
86 import io.github.hapjava.characteristics.impl.common.StatusTamperedEnum;
87 import io.github.hapjava.characteristics.impl.fan.CurrentFanStateCharacteristic;
88 import io.github.hapjava.characteristics.impl.fan.CurrentFanStateEnum;
89 import io.github.hapjava.characteristics.impl.fan.LockPhysicalControlsCharacteristic;
90 import io.github.hapjava.characteristics.impl.fan.LockPhysicalControlsEnum;
91 import io.github.hapjava.characteristics.impl.fan.RotationDirectionCharacteristic;
92 import io.github.hapjava.characteristics.impl.fan.RotationDirectionEnum;
93 import io.github.hapjava.characteristics.impl.fan.RotationSpeedCharacteristic;
94 import io.github.hapjava.characteristics.impl.fan.SwingModeCharacteristic;
95 import io.github.hapjava.characteristics.impl.fan.SwingModeEnum;
96 import io.github.hapjava.characteristics.impl.fan.TargetFanStateCharacteristic;
97 import io.github.hapjava.characteristics.impl.fan.TargetFanStateEnum;
98 import io.github.hapjava.characteristics.impl.filtermaintenance.FilterLifeLevelCharacteristic;
99 import io.github.hapjava.characteristics.impl.filtermaintenance.ResetFilterIndicationCharacteristic;
100 import io.github.hapjava.characteristics.impl.lightbulb.BrightnessCharacteristic;
101 import io.github.hapjava.characteristics.impl.lightbulb.ColorTemperatureCharacteristic;
102 import io.github.hapjava.characteristics.impl.lightbulb.HueCharacteristic;
103 import io.github.hapjava.characteristics.impl.lightbulb.SaturationCharacteristic;
104 import io.github.hapjava.characteristics.impl.slat.CurrentTiltAngleCharacteristic;
105 import io.github.hapjava.characteristics.impl.slat.TargetTiltAngleCharacteristic;
106 import io.github.hapjava.characteristics.impl.thermostat.CoolingThresholdTemperatureCharacteristic;
107 import io.github.hapjava.characteristics.impl.thermostat.HeatingThresholdTemperatureCharacteristic;
108 import io.github.hapjava.characteristics.impl.valve.RemainingDurationCharacteristic;
109 import io.github.hapjava.characteristics.impl.valve.SetDurationCharacteristic;
110 import io.github.hapjava.characteristics.impl.windowcovering.CurrentHorizontalTiltAngleCharacteristic;
111 import io.github.hapjava.characteristics.impl.windowcovering.CurrentVerticalTiltAngleCharacteristic;
112 import io.github.hapjava.characteristics.impl.windowcovering.HoldPositionCharacteristic;
113 import io.github.hapjava.characteristics.impl.windowcovering.TargetHorizontalTiltAngleCharacteristic;
114 import io.github.hapjava.characteristics.impl.windowcovering.TargetVerticalTiltAngleCharacteristic;
115 import tech.units.indriya.unit.UnitDimension;
116
117 /**
118  * Creates a optional characteristics .
119  *
120  * @author Eugen Freiter - Initial contribution
121  */
122 @NonNullByDefault
123 public class HomekitCharacteristicFactory {
124     private static final Logger logger = LoggerFactory.getLogger(HomekitCharacteristicFactory.class);
125
126     // List of optional characteristics and corresponding method to create them.
127     private final static Map<HomekitCharacteristicType, BiFunction<HomekitTaggedItem, HomekitAccessoryUpdater, Characteristic>> optional = new HashMap<HomekitCharacteristicType, BiFunction<HomekitTaggedItem, HomekitAccessoryUpdater, Characteristic>>() {
128         {
129             put(NAME, HomekitCharacteristicFactory::createNameCharacteristic);
130             put(BATTERY_LOW_STATUS, HomekitCharacteristicFactory::createStatusLowBatteryCharacteristic);
131             put(FAULT_STATUS, HomekitCharacteristicFactory::createStatusFaultCharacteristic);
132             put(TAMPERED_STATUS, HomekitCharacteristicFactory::createStatusTamperedCharacteristic);
133             put(ACTIVE_STATUS, HomekitCharacteristicFactory::createStatusActiveCharacteristic);
134             put(CARBON_MONOXIDE_LEVEL, HomekitCharacteristicFactory::createCarbonMonoxideLevelCharacteristic);
135             put(CARBON_MONOXIDE_PEAK_LEVEL, HomekitCharacteristicFactory::createCarbonMonoxidePeakLevelCharacteristic);
136             put(CARBON_DIOXIDE_LEVEL, HomekitCharacteristicFactory::createCarbonDioxideLevelCharacteristic);
137             put(CARBON_DIOXIDE_PEAK_LEVEL, HomekitCharacteristicFactory::createCarbonDioxidePeakLevelCharacteristic);
138             put(HOLD_POSITION, HomekitCharacteristicFactory::createHoldPositionCharacteristic);
139             put(OBSTRUCTION_STATUS, HomekitCharacteristicFactory::createObstructionDetectedCharacteristic);
140             put(CURRENT_HORIZONTAL_TILT_ANGLE,
141                     HomekitCharacteristicFactory::createCurrentHorizontalTiltAngleCharacteristic);
142             put(CURRENT_VERTICAL_TILT_ANGLE,
143                     HomekitCharacteristicFactory::createCurrentVerticalTiltAngleCharacteristic);
144             put(TARGET_HORIZONTAL_TILT_ANGLE,
145                     HomekitCharacteristicFactory::createTargetHorizontalTiltAngleCharacteristic);
146             put(TARGET_VERTICAL_TILT_ANGLE, HomekitCharacteristicFactory::createTargetVerticalTiltAngleCharacteristic);
147             put(CURRENT_TILT_ANGLE, HomekitCharacteristicFactory::createCurrentTiltAngleCharacteristic);
148             put(TARGET_TILT_ANGLE, HomekitCharacteristicFactory::createTargetTiltAngleCharacteristic);
149             put(HUE, HomekitCharacteristicFactory::createHueCharacteristic);
150             put(BRIGHTNESS, HomekitCharacteristicFactory::createBrightnessCharacteristic);
151             put(SATURATION, HomekitCharacteristicFactory::createSaturationCharacteristic);
152             put(COLOR_TEMPERATURE, HomekitCharacteristicFactory::createColorTemperatureCharacteristic);
153             put(CURRENT_FAN_STATE, HomekitCharacteristicFactory::createCurrentFanStateCharacteristic);
154             put(TARGET_FAN_STATE, HomekitCharacteristicFactory::createTargetFanStateCharacteristic);
155             put(ROTATION_DIRECTION, HomekitCharacteristicFactory::createRotationDirectionCharacteristic);
156             put(ROTATION_SPEED, HomekitCharacteristicFactory::createRotationSpeedCharacteristic);
157             put(SWING_MODE, HomekitCharacteristicFactory::createSwingModeCharacteristic);
158             put(LOCK_CONTROL, HomekitCharacteristicFactory::createLockPhysicalControlsCharacteristic);
159             put(DURATION, HomekitCharacteristicFactory::createDurationCharacteristic);
160             put(VOLUME, HomekitCharacteristicFactory::createVolumeCharacteristic);
161             put(COOLING_THRESHOLD_TEMPERATURE, HomekitCharacteristicFactory::createCoolingThresholdCharacteristic);
162             put(HEATING_THRESHOLD_TEMPERATURE, HomekitCharacteristicFactory::createHeatingThresholdCharacteristic);
163             put(REMAINING_DURATION, HomekitCharacteristicFactory::createRemainingDurationCharacteristic);
164             put(OZONE_DENSITY, HomekitCharacteristicFactory::createOzoneDensityCharacteristic);
165             put(NITROGEN_DIOXIDE_DENSITY, HomekitCharacteristicFactory::createNitrogenDioxideDensityCharacteristic);
166             put(SULPHUR_DIOXIDE_DENSITY, HomekitCharacteristicFactory::createSulphurDioxideDensityCharacteristic);
167             put(PM25_DENSITY, HomekitCharacteristicFactory::createPM25DensityCharacteristic);
168             put(PM10_DENSITY, HomekitCharacteristicFactory::createPM10DensityCharacteristic);
169             put(VOC_DENSITY, HomekitCharacteristicFactory::createVOCDensityCharacteristic);
170             put(FILTER_LIFE_LEVEL, HomekitCharacteristicFactory::createFilterLifeLevelCharacteristic);
171             put(FILTER_RESET_INDICATION, HomekitCharacteristicFactory::createFilterResetCharacteristic);
172             put(ACTIVE, HomekitCharacteristicFactory::createActiveCharacteristic);
173             put(CONFIGURED_NAME, HomekitCharacteristicFactory::createConfiguredNameCharacteristic);
174         }
175     };
176
177     /**
178      * create optional HomeKit characteristic
179      *
180      * @param item corresponding OH item
181      * @param updater update to keep OH item and HomeKit characteristic in sync
182      * @return HomeKit characteristic
183      */
184     public static Characteristic createCharacteristic(HomekitTaggedItem item, HomekitAccessoryUpdater updater)
185             throws HomekitException {
186         final @Nullable HomekitCharacteristicType type = item.getCharacteristicType();
187         logger.trace("CreateCharacteristic, type {} item {}", type, item);
188         if (optional.containsKey(type)) {
189             return optional.get(type).apply(item, updater);
190         }
191         logger.warn("Unsupported optional characteristic. Accessory type {}, characteristic type {}",
192                 item.getAccessoryType(), type);
193         throw new HomekitException("Unsupported optional characteristic. Characteristic type \"" + type + "\"");
194     }
195
196     // METHODS TO CREATE SINGLE CHARACTERISTIC FROM OH ITEM
197
198     // supporting methods
199
200     public static boolean useFahrenheit() {
201         return FrameworkUtil.getBundle(HomekitImpl.class).getBundleContext()
202                 .getServiceReference(Homekit.class.getName()).getProperty("useFahrenheitTemperature") == Boolean.TRUE;
203     }
204
205     private static <T extends CharacteristicEnum> CompletableFuture<T> getEnumFromItem(HomekitTaggedItem item,
206             T offEnum, T onEnum, T defaultEnum) {
207         final State state = item.getItem().getState();
208         if (state instanceof OnOffType) {
209             return CompletableFuture
210                     .completedFuture(state.equals(item.isInverted() ? OnOffType.ON : OnOffType.OFF) ? offEnum : onEnum);
211         } else if (state instanceof OpenClosedType) {
212             return CompletableFuture.completedFuture(
213                     state.equals(item.isInverted() ? OpenClosedType.OPEN : OpenClosedType.CLOSED) ? offEnum : onEnum);
214         } else if (state instanceof DecimalType) {
215             return CompletableFuture.completedFuture(((DecimalType) state).intValue() == 0 ? offEnum : onEnum);
216         } else if (state instanceof UnDefType) {
217             return CompletableFuture.completedFuture(defaultEnum);
218         }
219         logger.warn(
220                 "Item state {} is not supported. Only OnOffType,OpenClosedType and Decimal (0/1) are supported. Ignore item {}",
221                 state, item.getName());
222         return CompletableFuture.completedFuture(defaultEnum);
223     }
224
225     private static void setValueFromEnum(HomekitTaggedItem taggedItem, CharacteristicEnum value,
226             CharacteristicEnum offEnum, CharacteristicEnum onEnum) {
227         if (taggedItem.getItem() instanceof SwitchItem) {
228             if (value.equals(offEnum)) {
229                 ((SwitchItem) taggedItem.getItem()).send(taggedItem.isInverted() ? OnOffType.ON : OnOffType.OFF);
230             } else if (value.equals(onEnum)) {
231                 ((SwitchItem) taggedItem.getItem()).send(taggedItem.isInverted() ? OnOffType.OFF : OnOffType.ON);
232             } else {
233                 logger.warn("Enum value {} is not supported. Only following values are supported: {},{}", value,
234                         offEnum, onEnum);
235             }
236         } else if (taggedItem.getItem() instanceof NumberItem) {
237             ((NumberItem) taggedItem.getItem()).send(new DecimalType(value.getCode()));
238         } else {
239             logger.warn("Item type {} is not supported. Only Switch and Number item types are supported.",
240                     taggedItem.getItem().getType());
241         }
242     }
243
244     private static int getIntFromItem(HomekitTaggedItem taggedItem, int defaultValue) {
245         int value = defaultValue;
246         final State state = taggedItem.getItem().getState();
247         if (state instanceof PercentType) {
248             value = ((PercentType) state).intValue();
249         } else if (state instanceof DecimalType) {
250             value = ((DecimalType) state).intValue();
251         } else if (state instanceof UnDefType) {
252             logger.debug("Item state {} is UNDEF {}. Returning default value {}", state, taggedItem.getName(),
253                     defaultValue);
254         } else {
255             logger.warn(
256                     "Item state {} is not supported for {}. Only PercentType and DecimalType (0/100) are supported.",
257                     state, taggedItem.getName());
258         }
259         return value;
260     }
261
262     /** special method for tilts. it converts percentage to angle */
263     private static int getAngleFromItem(HomekitTaggedItem taggedItem, int defaultValue) {
264         int value = defaultValue;
265         final State state = taggedItem.getItem().getState();
266         if (state instanceof PercentType) {
267             value = (int) ((((PercentType) state).intValue() * 90.0) / 50.0 - 90.0);
268         } else {
269             value = getIntFromItem(taggedItem, defaultValue);
270         }
271         return value;
272     }
273
274     private static <T extends Quantity<T>> double convertAndRound(double value, Unit<T> from, Unit<T> to) {
275         double rawValue = from.equals(to) ? value : from.getConverterTo(to).convert(value);
276         return new BigDecimal(rawValue).setScale(1, RoundingMode.HALF_UP).doubleValue();
277     }
278
279     public static @Nullable Double stateAsTemperature(@Nullable State state) {
280         if (state == null || state instanceof UnDefType) {
281             return null;
282         }
283
284         if (state instanceof QuantityType<?>) {
285             final QuantityType<?> qt = (QuantityType<?>) state;
286             if (qt.getDimension().equals(UnitDimension.TEMPERATURE)) {
287                 return qt.toUnit(SIUnits.CELSIUS).doubleValue();
288             }
289         }
290
291         return convertToCelsius(state.as(DecimalType.class).doubleValue());
292     }
293
294     public static double convertToCelsius(double degrees) {
295         return convertAndRound(degrees, useFahrenheit() ? ImperialUnits.FAHRENHEIT : SIUnits.CELSIUS, SIUnits.CELSIUS);
296     }
297
298     public static double convertFromCelsius(double degrees) {
299         return convertAndRound(degrees, SIUnits.CELSIUS, useFahrenheit() ? ImperialUnits.FAHRENHEIT : SIUnits.CELSIUS);
300     }
301
302     private static Supplier<CompletableFuture<Integer>> getAngleSupplier(HomekitTaggedItem taggedItem,
303             int defaultValue) {
304         return () -> CompletableFuture.completedFuture(getAngleFromItem(taggedItem, defaultValue));
305     }
306
307     private static Supplier<CompletableFuture<Integer>> getIntSupplier(HomekitTaggedItem taggedItem, int defaultValue) {
308         return () -> CompletableFuture.completedFuture(getIntFromItem(taggedItem, defaultValue));
309     }
310
311     private static ExceptionalConsumer<Integer> setIntConsumer(HomekitTaggedItem taggedItem) {
312         return (value) -> {
313             if (taggedItem.getItem() instanceof NumberItem) {
314                 ((NumberItem) taggedItem.getItem()).send(new DecimalType(value));
315             } else {
316                 logger.warn("Item type {} is not supported for {}. Only NumberItem is supported.",
317                         taggedItem.getItem().getType(), taggedItem.getName());
318             }
319         };
320     }
321
322     private static ExceptionalConsumer<Integer> setPercentConsumer(HomekitTaggedItem taggedItem) {
323         return (value) -> {
324             if (taggedItem.getItem() instanceof NumberItem) {
325                 ((NumberItem) taggedItem.getItem()).send(new DecimalType(value));
326             } else if (taggedItem.getItem() instanceof DimmerItem) {
327                 ((DimmerItem) taggedItem.getItem()).send(new PercentType(value));
328             } else {
329                 logger.warn("Item type {} is not supported for {}. Only DimmerItem and NumberItem are supported.",
330                         taggedItem.getItem().getType(), taggedItem.getName());
331             }
332         };
333     }
334
335     private static ExceptionalConsumer<Integer> setAngleConsumer(HomekitTaggedItem taggedItem) {
336         return (value) -> {
337             if (taggedItem.getItem() instanceof NumberItem) {
338                 ((NumberItem) taggedItem.getItem()).send(new DecimalType(value));
339             } else if (taggedItem.getItem() instanceof DimmerItem) {
340                 value = (int) (value * 50.0 / 90.0 + 50.0);
341                 ((DimmerItem) taggedItem.getItem()).send(new PercentType(value));
342             } else {
343                 logger.warn("Item type {} is not supported for {}. Only DimmerItem and NumberItem are supported.",
344                         taggedItem.getItem().getType(), taggedItem.getName());
345             }
346         };
347     }
348
349     private static Supplier<CompletableFuture<Double>> getDoubleSupplier(HomekitTaggedItem taggedItem,
350             double defaultValue) {
351         return () -> {
352             final State state = taggedItem.getItem().getState();
353             double value = defaultValue;
354             if (state instanceof PercentType) {
355                 value = ((PercentType) state).doubleValue();
356             } else if (state instanceof DecimalType) {
357                 value = ((DecimalType) state).doubleValue();
358             }
359             return CompletableFuture.completedFuture(value);
360         };
361     }
362
363     private static ExceptionalConsumer<Double> setDoubleConsumer(HomekitTaggedItem taggedItem) {
364         return (value) -> {
365             if (taggedItem.getItem() instanceof NumberItem) {
366                 ((NumberItem) taggedItem.getItem()).send(new DecimalType(value.doubleValue()));
367             } else if (taggedItem.getItem() instanceof DimmerItem) {
368                 ((DimmerItem) taggedItem.getItem()).send(new PercentType(value.intValue()));
369             } else {
370                 logger.warn("Item type {} is not supported for {}. Only Number and Dimmer type are supported.",
371                         taggedItem.getItem().getType(), taggedItem.getName());
372             }
373         };
374     }
375
376     private static Supplier<CompletableFuture<Double>> getTemperatureSupplier(HomekitTaggedItem taggedItem,
377             double defaultValue) {
378         return () -> {
379             final @Nullable Double value = stateAsTemperature(taggedItem.getItem().getState());
380             return CompletableFuture.completedFuture(value != null ? value : defaultValue);
381         };
382     }
383
384     private static ExceptionalConsumer<Double> setTemperatureConsumer(HomekitTaggedItem taggedItem) {
385         return (value) -> {
386             if (taggedItem.getItem() instanceof NumberItem) {
387                 ((NumberItem) taggedItem.getItem()).send(new DecimalType(convertFromCelsius(value)));
388             } else {
389                 logger.warn("Item type {} is not supported for {}. Only Number type is supported.",
390                         taggedItem.getItem().getType(), taggedItem.getName());
391             }
392         };
393     }
394
395     protected static Consumer<HomekitCharacteristicChangeCallback> getSubscriber(HomekitTaggedItem taggedItem,
396             HomekitCharacteristicType key, HomekitAccessoryUpdater updater) {
397         return (callback) -> updater.subscribe((GenericItem) taggedItem.getItem(), key.getTag(), callback);
398     }
399
400     protected static Runnable getUnsubscriber(HomekitTaggedItem taggedItem, HomekitCharacteristicType key,
401             HomekitAccessoryUpdater updater) {
402         return () -> updater.unsubscribe((GenericItem) taggedItem.getItem(), key.getTag());
403     }
404
405     // create method for characteristic
406     private static StatusLowBatteryCharacteristic createStatusLowBatteryCharacteristic(HomekitTaggedItem taggedItem,
407             HomekitAccessoryUpdater updater) {
408         return new StatusLowBatteryCharacteristic(
409                 () -> getEnumFromItem(taggedItem, StatusLowBatteryEnum.NORMAL, StatusLowBatteryEnum.LOW,
410                         StatusLowBatteryEnum.NORMAL),
411                 getSubscriber(taggedItem, BATTERY_LOW_STATUS, updater),
412                 getUnsubscriber(taggedItem, BATTERY_LOW_STATUS, updater));
413     }
414
415     private static StatusFaultCharacteristic createStatusFaultCharacteristic(HomekitTaggedItem taggedItem,
416             HomekitAccessoryUpdater updater) {
417         return new StatusFaultCharacteristic(
418                 () -> getEnumFromItem(taggedItem, StatusFaultEnum.NO_FAULT, StatusFaultEnum.GENERAL_FAULT,
419                         StatusFaultEnum.NO_FAULT),
420                 getSubscriber(taggedItem, FAULT_STATUS, updater), getUnsubscriber(taggedItem, FAULT_STATUS, updater));
421     }
422
423     private static StatusTamperedCharacteristic createStatusTamperedCharacteristic(HomekitTaggedItem taggedItem,
424             HomekitAccessoryUpdater updater) {
425         return new StatusTamperedCharacteristic(
426                 () -> getEnumFromItem(taggedItem, StatusTamperedEnum.NOT_TAMPERED, StatusTamperedEnum.TAMPERED,
427                         StatusTamperedEnum.NOT_TAMPERED),
428                 getSubscriber(taggedItem, TAMPERED_STATUS, updater),
429                 getUnsubscriber(taggedItem, TAMPERED_STATUS, updater));
430     }
431
432     private static ObstructionDetectedCharacteristic createObstructionDetectedCharacteristic(
433             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
434         return new ObstructionDetectedCharacteristic(
435                 () -> CompletableFuture.completedFuture(taggedItem.getItem().getState() == OnOffType.ON
436                         || taggedItem.getItem().getState() == OpenClosedType.OPEN),
437                 getSubscriber(taggedItem, OBSTRUCTION_STATUS, updater),
438                 getUnsubscriber(taggedItem, OBSTRUCTION_STATUS, updater));
439     }
440
441     private static StatusActiveCharacteristic createStatusActiveCharacteristic(HomekitTaggedItem taggedItem,
442             HomekitAccessoryUpdater updater) {
443         return new StatusActiveCharacteristic(
444                 () -> CompletableFuture.completedFuture(taggedItem.getItem().getState() == OnOffType.ON
445                         || taggedItem.getItem().getState() == OpenClosedType.OPEN),
446                 getSubscriber(taggedItem, ACTIVE_STATUS, updater), getUnsubscriber(taggedItem, ACTIVE_STATUS, updater));
447     }
448
449     private static NameCharacteristic createNameCharacteristic(HomekitTaggedItem taggedItem,
450             HomekitAccessoryUpdater updater) {
451         return new NameCharacteristic(() -> {
452             final State state = taggedItem.getItem().getState();
453             return CompletableFuture.completedFuture(state instanceof UnDefType ? "" : state.toString());
454         });
455     }
456
457     private static HoldPositionCharacteristic createHoldPositionCharacteristic(HomekitTaggedItem taggedItem,
458             HomekitAccessoryUpdater updater) {
459         return new HoldPositionCharacteristic(value -> ((SwitchItem) taggedItem.getItem()).send(OnOffType.from(value)));
460     }
461
462     private static CarbonMonoxideLevelCharacteristic createCarbonMonoxideLevelCharacteristic(
463             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
464         return new CarbonMonoxideLevelCharacteristic(
465                 getDoubleSupplier(taggedItem,
466                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
467                                 CarbonMonoxideLevelCharacteristic.DEFAULT_MIN_VALUE)),
468                 getSubscriber(taggedItem, CARBON_DIOXIDE_LEVEL, updater),
469                 getUnsubscriber(taggedItem, CARBON_DIOXIDE_LEVEL, updater));
470     }
471
472     private static CarbonMonoxidePeakLevelCharacteristic createCarbonMonoxidePeakLevelCharacteristic(
473             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
474         return new CarbonMonoxidePeakLevelCharacteristic(
475                 getDoubleSupplier(taggedItem,
476                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
477                                 CarbonMonoxidePeakLevelCharacteristic.DEFAULT_MIN_VALUE)),
478                 getSubscriber(taggedItem, CARBON_DIOXIDE_PEAK_LEVEL, updater),
479                 getUnsubscriber(taggedItem, CARBON_DIOXIDE_PEAK_LEVEL, updater));
480     }
481
482     private static CarbonDioxideLevelCharacteristic createCarbonDioxideLevelCharacteristic(HomekitTaggedItem taggedItem,
483             HomekitAccessoryUpdater updater) {
484         return new CarbonDioxideLevelCharacteristic(
485                 getDoubleSupplier(taggedItem,
486                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
487                                 CarbonDioxideLevelCharacteristic.DEFAULT_MIN_VALUE)),
488                 getSubscriber(taggedItem, CARBON_MONOXIDE_LEVEL, updater),
489                 getUnsubscriber(taggedItem, CARBON_MONOXIDE_LEVEL, updater));
490     }
491
492     private static CarbonDioxidePeakLevelCharacteristic createCarbonDioxidePeakLevelCharacteristic(
493             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
494         return new CarbonDioxidePeakLevelCharacteristic(
495                 getDoubleSupplier(taggedItem,
496                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
497                                 CarbonDioxidePeakLevelCharacteristic.DEFAULT_MIN_VALUE)),
498                 getSubscriber(taggedItem, CARBON_MONOXIDE_PEAK_LEVEL, updater),
499                 getUnsubscriber(taggedItem, CARBON_MONOXIDE_PEAK_LEVEL, updater));
500     }
501
502     private static CurrentHorizontalTiltAngleCharacteristic createCurrentHorizontalTiltAngleCharacteristic(
503             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
504         return new CurrentHorizontalTiltAngleCharacteristic(getAngleSupplier(taggedItem, 0),
505                 getSubscriber(taggedItem, CURRENT_HORIZONTAL_TILT_ANGLE, updater),
506                 getUnsubscriber(taggedItem, CURRENT_HORIZONTAL_TILT_ANGLE, updater));
507     }
508
509     private static CurrentVerticalTiltAngleCharacteristic createCurrentVerticalTiltAngleCharacteristic(
510             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
511         return new CurrentVerticalTiltAngleCharacteristic(getAngleSupplier(taggedItem, 0),
512                 getSubscriber(taggedItem, CURRENT_VERTICAL_TILT_ANGLE, updater),
513                 getUnsubscriber(taggedItem, CURRENT_VERTICAL_TILT_ANGLE, updater));
514     }
515
516     private static TargetHorizontalTiltAngleCharacteristic createTargetHorizontalTiltAngleCharacteristic(
517             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
518         return new TargetHorizontalTiltAngleCharacteristic(getAngleSupplier(taggedItem, 0),
519                 setAngleConsumer(taggedItem), getSubscriber(taggedItem, TARGET_HORIZONTAL_TILT_ANGLE, updater),
520                 getUnsubscriber(taggedItem, TARGET_HORIZONTAL_TILT_ANGLE, updater));
521     }
522
523     private static TargetVerticalTiltAngleCharacteristic createTargetVerticalTiltAngleCharacteristic(
524             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
525         return new TargetVerticalTiltAngleCharacteristic(getAngleSupplier(taggedItem, 0), setAngleConsumer(taggedItem),
526                 getSubscriber(taggedItem, TARGET_HORIZONTAL_TILT_ANGLE, updater),
527                 getUnsubscriber(taggedItem, TARGET_HORIZONTAL_TILT_ANGLE, updater));
528     }
529
530     private static CurrentTiltAngleCharacteristic createCurrentTiltAngleCharacteristic(HomekitTaggedItem taggedItem,
531             HomekitAccessoryUpdater updater) {
532         return new CurrentTiltAngleCharacteristic(getAngleSupplier(taggedItem, 0),
533                 getSubscriber(taggedItem, CURRENT_TILT_ANGLE, updater),
534                 getUnsubscriber(taggedItem, CURRENT_TILT_ANGLE, updater));
535     }
536
537     private static TargetTiltAngleCharacteristic createTargetTiltAngleCharacteristic(HomekitTaggedItem taggedItem,
538             HomekitAccessoryUpdater updater) {
539         return new TargetTiltAngleCharacteristic(getAngleSupplier(taggedItem, 0), setAngleConsumer(taggedItem),
540                 getSubscriber(taggedItem, TARGET_TILT_ANGLE, updater),
541                 getUnsubscriber(taggedItem, TARGET_TILT_ANGLE, updater));
542     }
543
544     private static HueCharacteristic createHueCharacteristic(HomekitTaggedItem taggedItem,
545             HomekitAccessoryUpdater updater) {
546         return new HueCharacteristic(() -> {
547             double value = 0.0;
548             State state = taggedItem.getItem().getState();
549             if (state instanceof HSBType) {
550                 value = ((HSBType) state).getHue().doubleValue();
551             }
552             return CompletableFuture.completedFuture(value);
553         }, (hue) -> {
554             if (taggedItem.getItem() instanceof ColorItem) {
555                 taggedItem.sendCommandProxy(HomekitCommandType.HUE_COMMAND, new DecimalType(hue));
556             } else {
557                 logger.warn("Item type {} is not supported for {}. Only Color type is supported.",
558                         taggedItem.getItem().getType(), taggedItem.getName());
559             }
560         }, getSubscriber(taggedItem, HUE, updater), getUnsubscriber(taggedItem, HUE, updater));
561     }
562
563     private static BrightnessCharacteristic createBrightnessCharacteristic(HomekitTaggedItem taggedItem,
564             HomekitAccessoryUpdater updater) {
565         return new BrightnessCharacteristic(() -> {
566             int value = 0;
567             final State state = taggedItem.getItem().getState();
568             if (state instanceof HSBType) {
569                 value = ((HSBType) state).getBrightness().intValue();
570             } else if (state instanceof PercentType) {
571                 value = ((PercentType) state).intValue();
572             }
573             return CompletableFuture.completedFuture(value);
574         }, (brightness) -> {
575             final Item item = taggedItem.getItem();
576             if (item instanceof DimmerItem) {
577                 taggedItem.sendCommandProxy(HomekitCommandType.BRIGHTNESS_COMMAND, new PercentType(brightness));
578             } else {
579                 logger.warn("Item type {} is not supported for {}. Only ColorItem and DimmerItem are supported.",
580                         item.getType(), taggedItem.getName());
581             }
582         }, getSubscriber(taggedItem, BRIGHTNESS, updater), getUnsubscriber(taggedItem, BRIGHTNESS, updater));
583     }
584
585     private static SaturationCharacteristic createSaturationCharacteristic(HomekitTaggedItem taggedItem,
586             HomekitAccessoryUpdater updater) {
587         return new SaturationCharacteristic(() -> {
588             double value = 0.0;
589             State state = taggedItem.getItem().getState();
590             if (state instanceof HSBType) {
591                 value = ((HSBType) state).getSaturation().doubleValue();
592             } else if (state instanceof PercentType) {
593                 value = ((PercentType) state).doubleValue();
594             }
595             return CompletableFuture.completedFuture(value);
596         }, (saturation) -> {
597             if (taggedItem.getItem() instanceof ColorItem) {
598                 taggedItem.sendCommandProxy(HomekitCommandType.SATURATION_COMMAND,
599                         new PercentType(saturation.intValue()));
600             } else {
601                 logger.warn("Item type {} is not supported for {}. Only Color type is supported.",
602                         taggedItem.getItem().getType(), taggedItem.getName());
603             }
604         }, getSubscriber(taggedItem, SATURATION, updater), getUnsubscriber(taggedItem, SATURATION, updater));
605     }
606
607     private static ColorTemperatureCharacteristic createColorTemperatureCharacteristic(HomekitTaggedItem taggedItem,
608             HomekitAccessoryUpdater updater) {
609         int minValue = taggedItem.getConfigurationAsInt(HomekitTaggedItem.MIN_VALUE,
610                 ColorTemperatureCharacteristic.DEFAULT_MIN_VALUE);
611         return new ColorTemperatureCharacteristic(minValue,
612                 taggedItem.getConfigurationAsInt(HomekitTaggedItem.MAX_VALUE,
613                         ColorTemperatureCharacteristic.DEFAULT_MAX_VALUE),
614                 getIntSupplier(taggedItem, minValue), setIntConsumer(taggedItem),
615                 getSubscriber(taggedItem, COLOR_TEMPERATURE, updater),
616                 getUnsubscriber(taggedItem, COLOR_TEMPERATURE, updater));
617     }
618
619     private static CurrentFanStateCharacteristic createCurrentFanStateCharacteristic(HomekitTaggedItem taggedItem,
620             HomekitAccessoryUpdater updater) {
621         return new CurrentFanStateCharacteristic(() -> {
622             final @Nullable DecimalType value = taggedItem.getItem().getStateAs(DecimalType.class);
623             @Nullable
624             CurrentFanStateEnum currentFanStateEnum = value != null ? CurrentFanStateEnum.fromCode(value.intValue())
625                     : null;
626             if (currentFanStateEnum == null) {
627                 currentFanStateEnum = CurrentFanStateEnum.INACTIVE;
628             }
629             return CompletableFuture.completedFuture(currentFanStateEnum);
630         }, getSubscriber(taggedItem, CURRENT_FAN_STATE, updater),
631                 getUnsubscriber(taggedItem, CURRENT_FAN_STATE, updater));
632     }
633
634     private static TargetFanStateCharacteristic createTargetFanStateCharacteristic(HomekitTaggedItem taggedItem,
635             HomekitAccessoryUpdater updater) {
636         return new TargetFanStateCharacteristic(() -> {
637             final @Nullable DecimalType value = taggedItem.getItem().getStateAs(DecimalType.class);
638             @Nullable
639             TargetFanStateEnum targetFanStateEnum = value != null ? TargetFanStateEnum.fromCode(value.intValue())
640                     : null;
641             if (targetFanStateEnum == null) {
642                 targetFanStateEnum = TargetFanStateEnum.AUTO;
643             }
644             return CompletableFuture.completedFuture(targetFanStateEnum);
645         }, (targetState) -> {
646             if (taggedItem.getItem() instanceof NumberItem) {
647                 ((NumberItem) taggedItem.getItem()).send(new DecimalType(targetState.getCode()));
648             } else {
649                 logger.warn("Item type {} is not supported for {}. Only Number type is supported.",
650                         taggedItem.getItem().getType(), taggedItem.getName());
651             }
652         }, getSubscriber(taggedItem, TARGET_FAN_STATE, updater),
653                 getUnsubscriber(taggedItem, TARGET_FAN_STATE, updater));
654     }
655
656     private static RotationDirectionCharacteristic createRotationDirectionCharacteristic(HomekitTaggedItem taggedItem,
657             HomekitAccessoryUpdater updater) {
658         return new RotationDirectionCharacteristic(
659                 () -> getEnumFromItem(taggedItem, RotationDirectionEnum.CLOCKWISE,
660                         RotationDirectionEnum.COUNTER_CLOCKWISE, RotationDirectionEnum.CLOCKWISE),
661                 (value) -> setValueFromEnum(taggedItem, value, RotationDirectionEnum.CLOCKWISE,
662                         RotationDirectionEnum.COUNTER_CLOCKWISE),
663                 getSubscriber(taggedItem, ROTATION_DIRECTION, updater),
664                 getUnsubscriber(taggedItem, ROTATION_DIRECTION, updater));
665     }
666
667     private static SwingModeCharacteristic createSwingModeCharacteristic(HomekitTaggedItem taggedItem,
668             HomekitAccessoryUpdater updater) {
669         return new SwingModeCharacteristic(
670                 () -> getEnumFromItem(taggedItem, SwingModeEnum.SWING_DISABLED, SwingModeEnum.SWING_ENABLED,
671                         SwingModeEnum.SWING_DISABLED),
672                 (value) -> setValueFromEnum(taggedItem, value, SwingModeEnum.SWING_DISABLED,
673                         SwingModeEnum.SWING_ENABLED),
674                 getSubscriber(taggedItem, SWING_MODE, updater), getUnsubscriber(taggedItem, SWING_MODE, updater));
675     }
676
677     private static LockPhysicalControlsCharacteristic createLockPhysicalControlsCharacteristic(
678             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
679         return new LockPhysicalControlsCharacteristic(
680                 () -> getEnumFromItem(taggedItem, LockPhysicalControlsEnum.CONTROL_LOCK_DISABLED,
681                         LockPhysicalControlsEnum.CONTROL_LOCK_ENABLED, LockPhysicalControlsEnum.CONTROL_LOCK_DISABLED),
682                 (value) -> setValueFromEnum(taggedItem, value, LockPhysicalControlsEnum.CONTROL_LOCK_DISABLED,
683                         LockPhysicalControlsEnum.CONTROL_LOCK_ENABLED),
684                 getSubscriber(taggedItem, LOCK_CONTROL, updater), getUnsubscriber(taggedItem, LOCK_CONTROL, updater));
685     }
686
687     private static RotationSpeedCharacteristic createRotationSpeedCharacteristic(HomekitTaggedItem item,
688             HomekitAccessoryUpdater updater) {
689         return new RotationSpeedCharacteristic(
690                 item.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
691                         RotationSpeedCharacteristic.DEFAULT_MIN_VALUE),
692                 item.getConfigurationAsDouble(HomekitTaggedItem.MAX_VALUE,
693                         RotationSpeedCharacteristic.DEFAULT_MAX_VALUE),
694                 item.getConfigurationAsDouble(HomekitTaggedItem.STEP, RotationSpeedCharacteristic.DEFAULT_STEP),
695                 getDoubleSupplier(item, 0), setDoubleConsumer(item), getSubscriber(item, ROTATION_SPEED, updater),
696                 getUnsubscriber(item, ROTATION_SPEED, updater));
697     }
698
699     private static SetDurationCharacteristic createDurationCharacteristic(HomekitTaggedItem taggedItem,
700             HomekitAccessoryUpdater updater) {
701         return new SetDurationCharacteristic(() -> {
702             int value = getIntFromItem(taggedItem, 0);
703             final @Nullable Map<String, Object> itemConfiguration = taggedItem.getConfiguration();
704             if ((value == 0) && (itemConfiguration != null)) { // check for default duration
705                 final Object duration = itemConfiguration.get(HomekitValveImpl.CONFIG_DEFAULT_DURATION);
706                 if (duration instanceof BigDecimal) {
707                     value = ((BigDecimal) duration).intValue();
708                     if (taggedItem.getItem() instanceof NumberItem) {
709                         ((NumberItem) taggedItem.getItem()).setState(new DecimalType(value));
710                     }
711                 }
712             }
713             return CompletableFuture.completedFuture(value);
714         }, setIntConsumer(taggedItem), getSubscriber(taggedItem, DURATION, updater),
715                 getUnsubscriber(taggedItem, DURATION, updater));
716     }
717
718     private static RemainingDurationCharacteristic createRemainingDurationCharacteristic(HomekitTaggedItem taggedItem,
719             HomekitAccessoryUpdater updater) {
720         return new RemainingDurationCharacteristic(getIntSupplier(taggedItem, 0),
721                 getSubscriber(taggedItem, REMAINING_DURATION, updater),
722                 getUnsubscriber(taggedItem, REMAINING_DURATION, updater));
723     }
724
725     private static VolumeCharacteristic createVolumeCharacteristic(HomekitTaggedItem taggedItem,
726             HomekitAccessoryUpdater updater) {
727         return new VolumeCharacteristic(getIntSupplier(taggedItem, 0),
728                 (volume) -> ((NumberItem) taggedItem.getItem()).send(new DecimalType(volume)),
729                 getSubscriber(taggedItem, DURATION, updater), getUnsubscriber(taggedItem, DURATION, updater));
730     }
731
732     private static CoolingThresholdTemperatureCharacteristic createCoolingThresholdCharacteristic(
733             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
734         double minValue = HomekitCharacteristicFactory.convertToCelsius(taggedItem.getConfigurationAsDouble(
735                 HomekitTaggedItem.MIN_VALUE, CoolingThresholdTemperatureCharacteristic.DEFAULT_MIN_VALUE));
736         double maxValue = HomekitCharacteristicFactory.convertToCelsius(taggedItem.getConfigurationAsDouble(
737                 HomekitTaggedItem.MAX_VALUE, CoolingThresholdTemperatureCharacteristic.DEFAULT_MAX_VALUE));
738         return new CoolingThresholdTemperatureCharacteristic(minValue, maxValue,
739                 taggedItem.getConfigurationAsDouble(HomekitTaggedItem.STEP,
740                         CoolingThresholdTemperatureCharacteristic.DEFAULT_STEP),
741                 getTemperatureSupplier(taggedItem, minValue), setTemperatureConsumer(taggedItem),
742                 getSubscriber(taggedItem, COOLING_THRESHOLD_TEMPERATURE, updater),
743                 getUnsubscriber(taggedItem, COOLING_THRESHOLD_TEMPERATURE, updater));
744     }
745
746     private static HeatingThresholdTemperatureCharacteristic createHeatingThresholdCharacteristic(
747             HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
748         double minValue = HomekitCharacteristicFactory.convertToCelsius(taggedItem.getConfigurationAsDouble(
749                 HomekitTaggedItem.MIN_VALUE, HeatingThresholdTemperatureCharacteristic.DEFAULT_MIN_VALUE));
750         double maxValue = HomekitCharacteristicFactory.convertToCelsius(taggedItem.getConfigurationAsDouble(
751                 HomekitTaggedItem.MAX_VALUE, HeatingThresholdTemperatureCharacteristic.DEFAULT_MAX_VALUE));
752         return new HeatingThresholdTemperatureCharacteristic(minValue, maxValue,
753                 taggedItem.getConfigurationAsDouble(HomekitTaggedItem.STEP,
754                         HeatingThresholdTemperatureCharacteristic.DEFAULT_STEP),
755                 getTemperatureSupplier(taggedItem, minValue), setTemperatureConsumer(taggedItem),
756                 getSubscriber(taggedItem, HEATING_THRESHOLD_TEMPERATURE, updater),
757                 getUnsubscriber(taggedItem, HEATING_THRESHOLD_TEMPERATURE, updater));
758     }
759
760     private static OzoneDensityCharacteristic createOzoneDensityCharacteristic(final HomekitTaggedItem taggedItem,
761             HomekitAccessoryUpdater updater) {
762         return new OzoneDensityCharacteristic(
763                 getDoubleSupplier(taggedItem,
764                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
765                                 OzoneDensityCharacteristic.DEFAULT_MIN_VALUE)),
766                 getSubscriber(taggedItem, OZONE_DENSITY, updater), getUnsubscriber(taggedItem, OZONE_DENSITY, updater));
767     }
768
769     private static NitrogenDioxideDensityCharacteristic createNitrogenDioxideDensityCharacteristic(
770             final HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
771         return new NitrogenDioxideDensityCharacteristic(
772                 getDoubleSupplier(taggedItem,
773                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
774                                 NitrogenDioxideDensityCharacteristic.DEFAULT_MIN_VALUE)),
775                 getSubscriber(taggedItem, NITROGEN_DIOXIDE_DENSITY, updater),
776                 getUnsubscriber(taggedItem, NITROGEN_DIOXIDE_DENSITY, updater));
777     }
778
779     private static SulphurDioxideDensityCharacteristic createSulphurDioxideDensityCharacteristic(
780             final HomekitTaggedItem taggedItem, HomekitAccessoryUpdater updater) {
781         return new SulphurDioxideDensityCharacteristic(
782                 getDoubleSupplier(taggedItem,
783                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
784                                 SulphurDioxideDensityCharacteristic.DEFAULT_MIN_VALUE)),
785                 getSubscriber(taggedItem, SULPHUR_DIOXIDE_DENSITY, updater),
786                 getUnsubscriber(taggedItem, SULPHUR_DIOXIDE_DENSITY, updater));
787     }
788
789     private static PM25DensityCharacteristic createPM25DensityCharacteristic(final HomekitTaggedItem taggedItem,
790             HomekitAccessoryUpdater updater) {
791         return new PM25DensityCharacteristic(
792                 getDoubleSupplier(taggedItem,
793                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
794                                 PM25DensityCharacteristic.DEFAULT_MIN_VALUE)),
795                 getSubscriber(taggedItem, PM25_DENSITY, updater), getUnsubscriber(taggedItem, PM25_DENSITY, updater));
796     }
797
798     private static PM10DensityCharacteristic createPM10DensityCharacteristic(final HomekitTaggedItem taggedItem,
799             HomekitAccessoryUpdater updater) {
800         return new PM10DensityCharacteristic(
801                 getDoubleSupplier(taggedItem,
802                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
803                                 PM10DensityCharacteristic.DEFAULT_MIN_VALUE)),
804                 getSubscriber(taggedItem, PM10_DENSITY, updater), getUnsubscriber(taggedItem, PM10_DENSITY, updater));
805     }
806
807     private static VOCDensityCharacteristic createVOCDensityCharacteristic(final HomekitTaggedItem taggedItem,
808             HomekitAccessoryUpdater updater) {
809         return new VOCDensityCharacteristic(
810                 getDoubleSupplier(taggedItem,
811                         taggedItem.getConfigurationAsDouble(HomekitTaggedItem.MIN_VALUE,
812                                 VOCDensityCharacteristic.DEFAULT_MIN_VALUE)),
813                 getSubscriber(taggedItem, VOC_DENSITY, updater), getUnsubscriber(taggedItem, VOC_DENSITY, updater));
814     }
815
816     private static FilterLifeLevelCharacteristic createFilterLifeLevelCharacteristic(HomekitTaggedItem taggedItem,
817             HomekitAccessoryUpdater updater) {
818         return new FilterLifeLevelCharacteristic(getDoubleSupplier(taggedItem, 0),
819                 getSubscriber(taggedItem, FILTER_LIFE_LEVEL, updater),
820                 getUnsubscriber(taggedItem, FILTER_LIFE_LEVEL, updater));
821     }
822
823     private static ResetFilterIndicationCharacteristic createFilterResetCharacteristic(HomekitTaggedItem taggedItem,
824             HomekitAccessoryUpdater updater) {
825         return new ResetFilterIndicationCharacteristic(
826                 (value) -> ((SwitchItem) taggedItem.getItem()).send(OnOffType.ON));
827     }
828
829     private static ActiveCharacteristic createActiveCharacteristic(HomekitTaggedItem taggedItem,
830             HomekitAccessoryUpdater updater) {
831         return new ActiveCharacteristic(
832                 () -> getEnumFromItem(taggedItem, ActiveEnum.ACTIVE, ActiveEnum.INACTIVE, ActiveEnum.INACTIVE),
833                 (value) -> setValueFromEnum(taggedItem, value, ActiveEnum.ACTIVE, ActiveEnum.INACTIVE),
834                 getSubscriber(taggedItem, ACTIVE, updater), getUnsubscriber(taggedItem, ACTIVE, updater));
835     }
836
837     private static ConfiguredNameCharacteristic createConfiguredNameCharacteristic(HomekitTaggedItem taggedItem,
838             HomekitAccessoryUpdater updater) {
839         return new ConfiguredNameCharacteristic(() -> {
840             final State state = taggedItem.getItem().getState();
841             return CompletableFuture
842                     .completedFuture(state instanceof UnDefType ? taggedItem.getName() : state.toString());
843         }, (value) -> ((StringItem) taggedItem.getItem()).send(new StringType(value)),
844                 getSubscriber(taggedItem, CONFIGURED_NAME, updater),
845                 getUnsubscriber(taggedItem, CONFIGURED_NAME, updater));
846     }
847 }