git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2024 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.binding.netatmo.internal.handler.capability;
  14
  15 import static org.openhab.binding.netatmo.internal.NetatmoBindingConstants.*;
  16 import static org.openhab.binding.netatmo.internal.utils.ChannelTypeUtils.*;
  17
  18 import java.time.ZonedDateTime;
  19 import java.util.ArrayList;
  20 import java.util.List;
  21 import java.util.stream.Stream;
  22
  23 import org.eclipse.jdt.annotation.NonNullByDefault;
  24 import org.eclipse.jdt.annotation.Nullable;
  25 import org.openhab.binding.netatmo.internal.api.data.EventSubType;
  26 import org.openhab.binding.netatmo.internal.api.data.EventType;
  27 import org.openhab.binding.netatmo.internal.api.data.ModuleType;
  28 import org.openhab.binding.netatmo.internal.api.dto.Event;
  29 import org.openhab.binding.netatmo.internal.api.dto.HomeDataModule;
  30 import org.openhab.binding.netatmo.internal.api.dto.HomeEvent;
  31 import org.openhab.binding.netatmo.internal.api.dto.NAObject;
  32 import org.openhab.binding.netatmo.internal.api.dto.WebhookEvent;
  33 import org.openhab.binding.netatmo.internal.handler.CommonInterface;
  34 import org.openhab.binding.netatmo.internal.handler.channelhelper.ChannelHelper;
  35 import org.openhab.binding.netatmo.internal.providers.NetatmoDescriptionProvider;
  36 import org.openhab.core.library.types.OnOffType;
  37 import org.openhab.core.thing.ChannelUID;
  38 import org.openhab.core.types.Command;
  39 import org.openhab.core.types.StateOption;
  40 import org.openhab.core.types.UnDefType;
  41
  42 /**
  43  * {@link PersonCapability} gives the ability to handle Person specifics
  44  *
  45  * @author Gaël L'hopital - Initial contribution
  46  *
  47  */
  48 @NonNullByDefault
  49 public class PersonCapability extends HomeSecurityThingCapability {
  50     private final ChannelUID cameraChannelUID;
  51     private @Nullable ZonedDateTime lastEventTime;
  52
  53     public PersonCapability(CommonInterface handler, NetatmoDescriptionProvider descriptionProvider,
  54             List<ChannelHelper> channelHelpers) {
  55         super(handler, descriptionProvider, channelHelpers);
  56         this.cameraChannelUID = new ChannelUID(thingUID, GROUP_PERSON_LAST_EVENT, CHANNEL_EVENT_CAMERA_ID);
  57     }
  58
  59     @Override
  60     protected void beforeNewData() {
  61         super.beforeNewData();
  62         getSecurityCapability().ifPresent(cap -> {
  63             Stream<HomeDataModule> cameras = cap.getModules().values().stream()
  64                     .filter(module -> module.getType() == ModuleType.WELCOME);
  65             descriptionProvider.setStateOptions(cameraChannelUID,
  66                     cameras.map(p -> new StateOption(p.getId(), p.getName())).toList());
  67         });
  68     }
  69
  70     @Override
  71     public void handleCommand(String channelName, Command command) {
  72         if ((command instanceof OnOffType) && CHANNEL_PERSON_AT_HOME.equals(channelName)) {
  73             getSecurityCapability().ifPresent(cap -> cap.setPersonAway(handler.getId(), OnOffType.OFF.equals(command)));
  74         }
  75     }
  76
  77     @Override
  78     protected void updateWebhookEvent(WebhookEvent event) {
  79         super.updateWebhookEvent(event);
  80
  81         handler.updateState(GROUP_LAST_EVENT, CHANNEL_EVENT_SUBTYPE,
  82                 event.getSubTypeDescription().map(d -> toStringType(d)).orElse(UnDefType.NULL));
  83
  84         final String message = event.getName();
  85         handler.updateState(GROUP_LAST_EVENT, CHANNEL_EVENT_MESSAGE,
  86                 message == null || message.isBlank() ? UnDefType.NULL : toStringType(message));
  87
  88         handler.updateState(GROUP_LAST_EVENT, CHANNEL_EVENT_TIME, toDateTimeType(event.getTime()));
  89         handler.updateState(GROUP_LAST_EVENT, CHANNEL_EVENT_SNAPSHOT, toRawType(event.getSnapshotUrl()));
  90         handler.updateState(cameraChannelUID, toStringType(event.getCameraId()));
  91     }
  92
  93     @Override
  94     public void updateEvent(Event event) {
  95         super.updateEvent(event);
  96         EventType eventType = event.getEventType();
  97         ZonedDateTime localLast = lastEventTime;
  98         ZonedDateTime eventTime = event.getTime();
  99         if ((localLast != null && !eventTime.isAfter(localLast)) || !eventType.validFor(ModuleType.PERSON)) {
 100             return; // ignore incoming events if they are deprecated
 101         }
 102         lastEventTime = eventTime;
 103         handler.triggerChannel(CHANNEL_HOME_EVENT,
 104                 event.getSubTypeDescription().map(EventSubType::name).orElse(event.getEventType().name()));
 105     }
 106
 107     @Override
 108     public List<NAObject> updateReadings() {
 109         List<NAObject> result = new ArrayList<>();
 110         getSecurityCapability().ifPresent(cap -> {
 111             HomeEvent event = cap.getLastPersonEvent(handler.getId());
 112             if (event != null) {
 113                 result.add(event);
 114             }
 115         });
 116         return result;
 117     }
 118 }