2 * Copyright (c) 2010-2024 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.binding.netatmo.internal.handler.capability;
15 import static org.openhab.binding.netatmo.internal.NetatmoBindingConstants.*;
17 import java.time.Duration;
18 import java.util.ArrayList;
19 import java.util.HashSet;
20 import java.util.List;
22 import java.util.stream.Collectors;
24 import org.eclipse.jdt.annotation.NonNullByDefault;
25 import org.openhab.binding.netatmo.internal.api.HomeApi;
26 import org.openhab.binding.netatmo.internal.api.NetatmoException;
27 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.FeatureArea;
28 import org.openhab.binding.netatmo.internal.api.dto.HomeData;
29 import org.openhab.binding.netatmo.internal.api.dto.Location;
30 import org.openhab.binding.netatmo.internal.api.dto.NAError;
31 import org.openhab.binding.netatmo.internal.api.dto.NAObject;
32 import org.openhab.binding.netatmo.internal.config.HomeConfiguration;
33 import org.openhab.binding.netatmo.internal.handler.CommonInterface;
34 import org.openhab.binding.netatmo.internal.providers.NetatmoDescriptionProvider;
35 import org.openhab.core.thing.Bridge;
36 import org.slf4j.Logger;
37 import org.slf4j.LoggerFactory;
40 * The {@link HomeCapability} is the base class for handler able to manage persons and modules
42 * @author Gaƫl L'hopital - Initial contribution
46 public class HomeCapability extends CacheCapability<HomeApi> {
48 private final Logger logger = LoggerFactory.getLogger(HomeCapability.class);
49 private final Set<FeatureArea> featureAreas = new HashSet<>();
50 private final NetatmoDescriptionProvider descriptionProvider;
51 private final Set<String> homeIds = new HashSet<>(3);
53 public HomeCapability(CommonInterface handler, NetatmoDescriptionProvider descriptionProvider) {
54 super(handler, Duration.ofSeconds(2), HomeApi.class);
55 this.descriptionProvider = descriptionProvider;
59 public void initialize() {
61 HomeConfiguration config = handler.getThingConfigAs(HomeConfiguration.class);
62 homeIds.add(config.getId());
63 if (!config.energyId.isBlank()) {
64 homeIds.add(config.energyId);
66 if (!config.securityId.isBlank()) {
67 homeIds.add(config.securityId);
72 public void dispose() {
78 protected void updateHomeData(HomeData home) {
80 if (featureAreas.contains(FeatureArea.SECURITY)) {
81 handler.getCapabilities().put(new SecurityCapability(handler));
83 handler.removeChannels(thing.getChannelsOfGroup(GROUP_SECURITY));
85 if (featureAreas.contains(FeatureArea.ENERGY)) {
86 handler.getCapabilities().put(new EnergyCapability(handler, descriptionProvider));
88 handler.removeChannels(thing.getChannelsOfGroup(GROUP_ENERGY));
90 home.getCountry().map(country -> properties.put(PROPERTY_COUNTRY, country));
91 home.getTimezone().map(tz -> properties.put(PROPERTY_TIMEZONE, tz));
92 properties.put(GROUP_LOCATION, ((Location) home).getLocation().toString());
93 properties.put(PROPERTY_FEATURE,
94 featureAreas.stream().map(FeatureArea::name).collect(Collectors.joining(",")));
99 * Errored equipments are reported at home level - so we need to explore all the tree to identify modules
100 * depending from a child device.
103 protected void updateErrors(NAError error) {
104 handler.getAllActiveChildren((Bridge) thing).stream().filter(handler -> handler.getId().equals(error.getId()))
105 .findFirst().ifPresent(handler -> handler.setNewData(error));
109 protected List<NAObject> getFreshData(HomeApi api) {
110 List<NAObject> result = new ArrayList<>();
111 homeIds.stream().filter(id -> !id.isEmpty()).forEach(id -> {
114 HomeData homeData = api.getHomeData(id);
115 if (homeData != null) {
116 result.add(homeData);
117 featureAreas.addAll(homeData.getFeatures());
121 api.getHomeStatus(id).ifPresent(body -> {
122 body.getHomeStatus().ifPresent(result::add);
123 result.addAll(body.getErrors());
125 } catch (NetatmoException e) {
126 logger.warn("Error getting Home informations: {}", e.getMessage());