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.binding.netatmo.internal.handler.capability;
15 import static org.openhab.binding.netatmo.internal.NetatmoBindingConstants.*;
17 import java.util.ArrayList;
18 import java.util.List;
19 import java.util.stream.Collectors;
21 import org.eclipse.jdt.annotation.NonNullByDefault;
22 import org.eclipse.jdt.annotation.Nullable;
23 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.AlimentationStatus;
24 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.SdCardStatus;
25 import org.openhab.binding.netatmo.internal.api.dto.HomeDataPerson;
26 import org.openhab.binding.netatmo.internal.api.dto.HomeEvent;
27 import org.openhab.binding.netatmo.internal.api.dto.HomeStatusModule;
28 import org.openhab.binding.netatmo.internal.api.dto.NAObject;
29 import org.openhab.binding.netatmo.internal.deserialization.NAObjectMap;
30 import org.openhab.binding.netatmo.internal.handler.CommonInterface;
31 import org.openhab.binding.netatmo.internal.handler.channelhelper.CameraChannelHelper;
32 import org.openhab.binding.netatmo.internal.handler.channelhelper.ChannelHelper;
33 import org.openhab.binding.netatmo.internal.providers.NetatmoDescriptionProvider;
34 import org.openhab.core.library.types.OnOffType;
35 import org.openhab.core.thing.ChannelUID;
36 import org.openhab.core.types.Command;
37 import org.openhab.core.types.StateOption;
40 * {@link CameraCapability} give to handle Welcome Camera specifics
42 * @author Gaƫl L'hopital - Initial contribution
46 public class CameraCapability extends HomeSecurityThingCapability {
47 private final CameraChannelHelper cameraHelper;
48 private final ChannelUID personChannelUID;
50 protected @Nullable String localUrl;
51 protected @Nullable String vpnUrl;
53 public CameraCapability(CommonInterface handler, NetatmoDescriptionProvider descriptionProvider,
54 List<ChannelHelper> channelHelpers) {
55 super(handler, descriptionProvider, channelHelpers);
56 this.personChannelUID = new ChannelUID(thing.getUID(), GROUP_LAST_EVENT, CHANNEL_EVENT_PERSON_ID);
57 this.cameraHelper = (CameraChannelHelper) channelHelpers.stream().filter(c -> c instanceof CameraChannelHelper)
58 .findFirst().orElseThrow(() -> new IllegalArgumentException(
59 "CameraCapability must find a CameraChannelHelper, please file a bug report."));
63 public void updateHomeStatusModule(HomeStatusModule newData) {
64 super.updateHomeStatusModule(newData);
65 // Per documentation vpn_url expires every 3 hours and on camera reboot. So useless to reping it if not changed
66 String newVpnUrl = newData.getVpnUrl();
67 if (newVpnUrl != null && !newVpnUrl.equals(vpnUrl)) {
68 // This will also decrease the number of requests emitted toward Netatmo API.
69 localUrl = newData.isLocal() ? securityCapability.map(cap -> cap.ping(newVpnUrl)).orElse(null) : null;
70 cameraHelper.setUrls(newVpnUrl, localUrl);
71 eventHelper.setUrls(newVpnUrl, localUrl);
74 if (!SdCardStatus.SD_CARD_WORKING.equals(newData.getSdStatus())
75 || !AlimentationStatus.ALIM_CORRECT_POWER.equals(newData.getAlimStatus())) {
76 statusReason = String.format("%s, %s", newData.getSdStatus(), newData.getAlimStatus());
81 public void handleCommand(String channelName, Command command) {
82 if (command instanceof OnOffType && CHANNEL_MONITORING.equals(channelName)) {
83 securityCapability.ifPresent(cap -> cap.changeStatus(localUrl, OnOffType.ON.equals(command)));
85 super.handleCommand(channelName, command);
90 protected void beforeNewData() {
91 super.beforeNewData();
92 homeCapability.ifPresent(cap -> {
93 NAObjectMap<HomeDataPerson> persons = cap.getPersons();
94 descriptionProvider.setStateOptions(personChannelUID, persons.values().stream()
95 .map(p -> new StateOption(p.getId(), p.getName())).collect(Collectors.toList()));
100 public List<NAObject> updateReadings() {
101 List<NAObject> result = new ArrayList<>();
102 securityCapability.ifPresent(cap -> {
103 HomeEvent event = cap.getDeviceLastEvent(handler.getId(), moduleType.apiName);
106 result.addAll(event.getSubevents());