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.freeboxos.internal.handler;
15 import static org.openhab.binding.freeboxos.internal.FreeboxOsBindingConstants.*;
17 import java.util.Collection;
21 import org.eclipse.jdt.annotation.NonNullByDefault;
22 import org.openhab.binding.freeboxos.internal.action.HostActions;
23 import org.openhab.binding.freeboxos.internal.api.FreeboxException;
24 import org.openhab.binding.freeboxos.internal.api.rest.LanBrowserManager;
25 import org.openhab.binding.freeboxos.internal.api.rest.LanBrowserManager.LanHost;
26 import org.openhab.binding.freeboxos.internal.api.rest.LanBrowserManager.Source;
27 import org.openhab.binding.freeboxos.internal.api.rest.WebSocketManager;
28 import org.openhab.binding.freeboxos.internal.config.ApiConsumerConfiguration;
29 import org.openhab.core.thing.Thing;
30 import org.openhab.core.thing.ThingStatus;
31 import org.openhab.core.thing.binding.ThingHandlerService;
32 import org.slf4j.Logger;
33 import org.slf4j.LoggerFactory;
35 import inet.ipaddr.mac.MACAddress;
38 * The {@link HostHandler} is responsible for all network equipments hosted on the network
40 * @author Gaƫl L'hopital - Initial contribution
43 public class HostHandler extends ApiConsumerHandler {
44 private final Logger logger = LoggerFactory.getLogger(HostHandler.class);
46 // We start in pull mode and switch to push after a first update...
47 protected boolean pushSubscribed = false;
49 public HostHandler(Thing thing) {
51 statusDrivenByBridge = false;
55 void initializeProperties(Map<String, String> properties) throws FreeboxException {
56 LanHost host = getLanHost();
57 properties.put(Thing.PROPERTY_VENDOR, host.vendorName());
58 host.getName(Source.UPNP).ifPresent(upnpName -> properties.put(Source.UPNP.name(), upnpName));
62 public void dispose() {
63 cancelPushSubscription();
67 protected void cancelPushSubscription() {
68 MACAddress mac = getMac();
69 if (pushSubscribed && mac != null) {
71 getManager(WebSocketManager.class).unregisterListener(mac);
72 } catch (FreeboxException e) {
73 logger.warn("Error unregistering host from the websocket: {}", e.getMessage());
75 pushSubscribed = false;
80 protected void internalPoll() throws FreeboxException {
85 LanHost host = getLanHost();
86 updateConnectivityChannels(host);
87 logger.debug("Switching to push mode - refreshInterval will now be ignored for Connectivity data");
88 pushSubscribed = getManager(WebSocketManager.class).registerListener(host.getMac(), this);
92 protected void internalForcePoll() throws FreeboxException {
93 LanHost host = getLanHost();
94 updateConnectivityChannels(host);
97 protected LanHost getLanHost() throws FreeboxException {
98 MACAddress mac = getMac();
100 throw new FreeboxException(
101 "getLanHost is not possible because MAC address is undefined for the thing " + thing.getUID());
103 return getManager(LanBrowserManager.class).getHost(mac).map(hostIntf -> hostIntf.host())
104 .orElseThrow(() -> new FreeboxException("Host data not found"));
107 public void updateConnectivityChannels(LanHost host) {
108 updateChannelOnOff(CONNECTIVITY, REACHABLE, host.reachable());
109 updateChannelDateTimeState(CONNECTIVITY, LAST_SEEN, host.getLastSeen());
110 updateChannelString(CONNECTIVITY, IP_ADDRESS, host.getIpv4());
111 updateStatus(host.reachable() ? ThingStatus.ONLINE : ThingStatus.OFFLINE);
115 MACAddress mac = getMac();
117 logger.warn("Waking up host is not possible because MAC address is undefined for the thing {}",
122 getManager(LanBrowserManager.class).wakeOnLan(mac, getConfigAs(ApiConsumerConfiguration.class).password);
123 } catch (FreeboxException e) {
124 logger.warn("Error waking up host: {}", e.getMessage());
129 public Collection<Class<? extends ThingHandlerService>> getServices() {
130 return Set.of(HostActions.class);