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.Optional;
19 import org.eclipse.jdt.annotation.NonNullByDefault;
20 import org.eclipse.jdt.annotation.Nullable;
21 import org.openhab.binding.freeboxos.internal.api.FreeboxException;
22 import org.openhab.binding.freeboxos.internal.api.rest.APManager;
23 import org.openhab.binding.freeboxos.internal.api.rest.APManager.LanAccessPoint;
24 import org.openhab.binding.freeboxos.internal.api.rest.APManager.Station;
25 import org.openhab.binding.freeboxos.internal.api.rest.LanBrowserManager;
26 import org.openhab.binding.freeboxos.internal.api.rest.LanBrowserManager.HostName;
27 import org.openhab.binding.freeboxos.internal.api.rest.LanBrowserManager.LanHost;
28 import org.openhab.binding.freeboxos.internal.api.rest.RepeaterManager;
29 import org.openhab.binding.freeboxos.internal.config.WifiHostConfiguration;
30 import org.openhab.core.config.core.Configuration;
31 import org.openhab.core.library.types.QuantityType;
32 import org.openhab.core.library.unit.Units;
33 import org.openhab.core.thing.Channel;
34 import org.openhab.core.thing.Thing;
35 import org.openhab.core.types.UnDefType;
36 import org.slf4j.Logger;
37 import org.slf4j.LoggerFactory;
40 * The {@link WifiStationHandler} is responsible for handling everything associated to
41 * any Freebox thing types except the bridge thing type.
43 * @author Gaƫl L'hopital - Initial contribution
46 public class WifiStationHandler extends HostHandler {
47 private static final String SERVER_HOST = "Server";
49 private final Logger logger = LoggerFactory.getLogger(WifiStationHandler.class);
51 public WifiStationHandler(Thing thing) {
56 protected void internalPoll() throws FreeboxException {
59 // Search if the wifi-host is hosted on server access-points
60 Optional<Station> station = getManager(APManager.class).getStation(getMac());
61 if (station.isPresent()) {
62 Station data = station.get();
63 updateChannelDateTimeState(CONNECTIVITY, LAST_SEEN, data.getLastSeen());
64 updateChannelString(GROUP_WIFI, WIFI_HOST, SERVER_HOST);
65 updateWifiStationChannels(data.signal(), data.getSsid(), data.rxRate(), data.txRate());
69 // Search if it is hosted by a repeater
70 Optional<LanHost> wifiHost = getManager(RepeaterManager.class).getHost(getMac());
71 if (wifiHost.isPresent()) {
72 updateChannelDateTimeState(CONNECTIVITY, LAST_SEEN, wifiHost.get().getLastSeen());
73 LanAccessPoint lanAp = wifiHost.get().accessPoint();
75 updateChannelString(GROUP_WIFI, WIFI_HOST, "%s-%s".formatted(lanAp.type(), lanAp.uid()));
76 updateWifiStationChannels(lanAp.getRSSI(), lanAp.getSsid(), lanAp.rxRate(), lanAp.txRate());
80 // Not found a wifi repeater/host, so update all wifi channels to NULL
81 getThing().getChannelsOfGroup(GROUP_WIFI).stream().map(Channel::getUID).filter(uid -> isLinked(uid))
82 .forEach(uid -> updateState(uid, UnDefType.NULL));
85 private void updateWifiStationChannels(int rssi, @Nullable String ssid, long rxRate, long txRate) {
86 updateChannelString(GROUP_WIFI, SSID, ssid);
87 updateChannelQuantity(GROUP_WIFI, RSSI, rssi <= 0 ? new QuantityType<>(rssi, Units.DECIBEL_MILLIWATTS) : null);
88 updateChannelDecimal(GROUP_WIFI, WIFI_QUALITY, rssi <= 0 ? toQoS(rssi) : null);
89 updateRateChannel(RATE + "-down", rxRate);
90 updateRateChannel(RATE + "-up", txRate);
93 private void updateRateChannel(String channel, long rate) {
94 QuantityType<?> qtty = rate != -1 ? new QuantityType<>(rate * 8, Units.BIT_PER_SECOND) : null;
95 updateChannelQuantity(GROUP_WIFI, channel, qtty);
98 private int toQoS(int rssi) {
99 return rssi > -50 ? 4 : rssi > -60 ? 3 : rssi > -70 ? 2 : rssi > -85 ? 1 : 0;
103 protected LanHost getLanHost() throws FreeboxException {
105 return super.getLanHost();
106 } catch (FreeboxException e) {
107 HostName identifier = getConfigAs(WifiHostConfiguration.class).getIdentifier();
108 if (identifier != null) {
109 cancelPushSubscription();
110 Optional<LanHost> lanHost = getManager(LanBrowserManager.class).getHost(identifier);
111 return lanHost.map(host -> {
112 Configuration thingConfig = editConfiguration();
113 thingConfig.put(Thing.PROPERTY_MAC_ADDRESS, host.getMac().toColonDelimitedString());
114 updateConfiguration(thingConfig);
115 logger.info("MAC address of the wifihost {} changed, configuration updated to {}", thing.getUID(),
118 }).orElseThrow(() -> new FreeboxException("Host data not found - mDNS failed also"));
120 throw new FreeboxException("Host not found - no mDNS alternative");