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;
39 import inet.ipaddr.mac.MACAddress;
42 * The {@link WifiStationHandler} is responsible for handling everything associated to
43 * any Freebox thing types except the bridge thing type.
45 * @author Gaƫl L'hopital - Initial contribution
48 public class WifiStationHandler extends HostHandler {
49 private static final String SERVER_HOST = "Server";
51 private final Logger logger = LoggerFactory.getLogger(WifiStationHandler.class);
53 public WifiStationHandler(Thing thing) {
58 protected void internalPoll() throws FreeboxException {
61 MACAddress mac = getMac();
63 throw new FreeboxException(
64 "internalPoll is not possible because MAC address is undefined for the thing " + thing.getUID());
67 // Search if the wifi-host is hosted on server access-points
68 Optional<Station> station = getManager(APManager.class).getStation(mac);
69 if (station.isPresent()) {
70 Station data = station.get();
71 updateChannelDateTimeState(CONNECTIVITY, LAST_SEEN, data.getLastSeen());
72 updateChannelString(GROUP_WIFI, WIFI_HOST, SERVER_HOST);
73 updateWifiStationChannels(data.signal(), data.getSsid(), data.rxRate(), data.txRate());
77 // Search if it is hosted by a repeater
78 Optional<LanHost> wifiHost = getManager(RepeaterManager.class).getHost(mac);
79 if (wifiHost.isPresent()) {
80 updateChannelDateTimeState(CONNECTIVITY, LAST_SEEN, wifiHost.get().getLastSeen());
81 LanAccessPoint lanAp = wifiHost.get().accessPoint();
83 updateChannelString(GROUP_WIFI, WIFI_HOST, "%s-%s".formatted(lanAp.type(), lanAp.uid()));
84 updateWifiStationChannels(lanAp.getRSSI(), lanAp.getSsid(), lanAp.rxRate(), lanAp.txRate());
88 // Not found a wifi repeater/host, so update all wifi channels to NULL
89 getThing().getChannelsOfGroup(GROUP_WIFI).stream().map(Channel::getUID).filter(uid -> isLinked(uid))
90 .forEach(uid -> updateState(uid, UnDefType.NULL));
93 private void updateWifiStationChannels(int rssi, @Nullable String ssid, long rxRate, long txRate) {
94 updateChannelString(GROUP_WIFI, SSID, ssid);
95 updateChannelQuantity(GROUP_WIFI, RSSI, rssi <= 0 ? new QuantityType<>(rssi, Units.DECIBEL_MILLIWATTS) : null);
96 updateChannelDecimal(GROUP_WIFI, WIFI_QUALITY, rssi <= 0 ? toQoS(rssi) : null);
97 updateRateChannel(RATE + "-down", rxRate);
98 updateRateChannel(RATE + "-up", txRate);
101 private void updateRateChannel(String channel, long rate) {
102 QuantityType<?> qtty = rate != -1 ? new QuantityType<>(rate * 8, Units.BIT_PER_SECOND) : null;
103 updateChannelQuantity(GROUP_WIFI, channel, qtty);
106 private int toQoS(int rssi) {
107 return rssi > -50 ? 4 : rssi > -60 ? 3 : rssi > -70 ? 2 : rssi > -85 ? 1 : 0;
111 protected LanHost getLanHost() throws FreeboxException {
113 return super.getLanHost();
114 } catch (FreeboxException e) {
115 HostName identifier = getConfigAs(WifiHostConfiguration.class).getIdentifier();
116 if (identifier != null) {
117 cancelPushSubscription();
118 Optional<LanHost> lanHost = getManager(LanBrowserManager.class).getHost(identifier);
119 return lanHost.map(host -> {
120 Configuration thingConfig = editConfiguration();
121 thingConfig.put(Thing.PROPERTY_MAC_ADDRESS, host.getMac().toColonDelimitedString());
122 updateConfiguration(thingConfig);
123 logger.info("MAC address of the wifihost {} changed, configuration updated to {}", thing.getUID(),
126 }).orElseThrow(() -> new FreeboxException("Host data not found - mDNS failed also"));
128 throw new FreeboxException("Host not found - no mDNS alternative");