2 * Copyright (c) 2010-2021 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.synopanalyzer.internal.handler;
15 import static org.openhab.binding.synopanalyzer.internal.SynopAnalyzerBindingConstants.*;
17 import java.io.IOException;
18 import java.time.ZoneOffset;
19 import java.time.ZonedDateTime;
20 import java.time.format.DateTimeFormatter;
21 import java.util.ArrayList;
22 import java.util.Arrays;
23 import java.util.HashMap;
24 import java.util.List;
26 import java.util.Optional;
27 import java.util.concurrent.ScheduledFuture;
28 import java.util.concurrent.TimeUnit;
30 import javax.measure.quantity.Speed;
31 import javax.ws.rs.HttpMethod;
33 import org.eclipse.jdt.annotation.NonNullByDefault;
34 import org.eclipse.jdt.annotation.Nullable;
35 import org.openhab.binding.synopanalyser.internal.synop.Overcast;
36 import org.openhab.binding.synopanalyser.internal.synop.StationDB;
37 import org.openhab.binding.synopanalyser.internal.synop.Synop;
38 import org.openhab.binding.synopanalyser.internal.synop.SynopLand;
39 import org.openhab.binding.synopanalyser.internal.synop.SynopMobile;
40 import org.openhab.binding.synopanalyser.internal.synop.SynopShip;
41 import org.openhab.binding.synopanalyser.internal.synop.WindDirections;
42 import org.openhab.binding.synopanalyzer.internal.config.SynopAnalyzerConfiguration;
43 import org.openhab.core.i18n.LocationProvider;
44 import org.openhab.core.io.net.http.HttpUtil;
45 import org.openhab.core.library.types.DateTimeType;
46 import org.openhab.core.library.types.DecimalType;
47 import org.openhab.core.library.types.PointType;
48 import org.openhab.core.library.types.QuantityType;
49 import org.openhab.core.library.types.StringType;
50 import org.openhab.core.library.unit.SIUnits;
51 import org.openhab.core.thing.ChannelUID;
52 import org.openhab.core.thing.Thing;
53 import org.openhab.core.thing.ThingStatus;
54 import org.openhab.core.thing.binding.BaseThingHandler;
55 import org.openhab.core.types.Command;
56 import org.openhab.core.types.RefreshType;
57 import org.openhab.core.types.State;
58 import org.openhab.core.types.UnDefType;
59 import org.slf4j.Logger;
60 import org.slf4j.LoggerFactory;
63 * The {@link SynopAnalyzerHandler} is responsible for handling commands, which are
64 * sent to one of the channels.
66 * @author Gaƫl L'hopital - Initial contribution
67 * @author Mark Herwege - Correction for timezone treatment
70 public class SynopAnalyzerHandler extends BaseThingHandler {
71 private static final String OGIMET_SYNOP_PATH = "http://www.ogimet.com/cgi-bin/getsynop?block=%s&begin=%s";
72 private static final int REQUEST_TIMEOUT_MS = 5000;
73 private static final DateTimeFormatter SYNOP_DATE_FORMAT = DateTimeFormatter.ofPattern("yyyyMMddHH00");
74 private static final double KASTEN_POWER = 3.4;
75 private static final double OCTA_MAX = 8.0;
77 private final Logger logger = LoggerFactory.getLogger(SynopAnalyzerHandler.class);
79 private @Nullable ScheduledFuture<?> executionJob;
80 private @NonNullByDefault({}) String formattedStationId;
81 private final LocationProvider locationProvider;
82 private final @Nullable StationDB stationDB;
84 public SynopAnalyzerHandler(Thing thing, LocationProvider locationProvider, @Nullable StationDB stationDB) {
86 this.locationProvider = locationProvider;
87 this.stationDB = stationDB;
91 public void initialize() {
92 SynopAnalyzerConfiguration configuration = getConfigAs(SynopAnalyzerConfiguration.class);
93 formattedStationId = String.format("%05d", configuration.stationId);
94 logger.info("Scheduling Synop update thread to run every {} minute for Station '{}'",
95 configuration.refreshInterval, formattedStationId);
97 StationDB stations = stationDB;
98 if (thing.getProperties().isEmpty() && stations != null) {
99 discoverAttributes(stations, configuration.stationId);
102 executionJob = scheduler.scheduleWithFixedDelay(this::updateSynopChannels, 0, configuration.refreshInterval,
106 protected void discoverAttributes(StationDB stations, int stationId) {
107 stations.stations.stream().filter(s -> stationId == s.idOmm).findFirst().ifPresent(s -> {
108 Map<String, String> properties = new HashMap<>();
109 properties.put("Usual name", s.usualName);
110 properties.put("Location", s.getLocation());
112 PointType stationLocation = new PointType(s.getLocation());
113 PointType serverLocation = locationProvider.getLocation();
114 if (serverLocation != null) {
115 DecimalType distance = serverLocation.distanceFrom(stationLocation);
117 properties.put("Distance", new QuantityType<>(distance, SIUnits.METRE).toString());
119 updateProperties(properties);
123 private Optional<Synop> getLastAvailableSynop() {
124 logger.debug("Retrieving last Synop message");
126 String url = forgeURL();
128 String answer = HttpUtil.executeUrl(HttpMethod.GET, url, REQUEST_TIMEOUT_MS);
129 List<String> messages = Arrays.asList(answer.split("\n"));
130 if (!messages.isEmpty()) {
131 String message = messages.get(messages.size() - 1);
132 logger.debug(message);
133 if (message.startsWith(formattedStationId)) {
134 logger.debug("Valid Synop message received");
136 List<String> messageParts = Arrays.asList(message.split(","));
137 String synopMessage = messageParts.get(messageParts.size() - 1);
139 return createSynopObject(synopMessage);
141 logger.warn("Message does not belong to station {} : {}", formattedStationId, message);
143 logger.warn("No valid Synop found for last 24h");
144 } catch (IOException e) {
145 logger.warn("Synop request timedout : {}", e.getMessage());
147 return Optional.empty();
150 private void updateSynopChannels() {
151 logger.debug("Updating device channels");
153 Optional<Synop> synop = getLastAvailableSynop();
154 updateStatus(synop.isPresent() ? ThingStatus.ONLINE : ThingStatus.OFFLINE);
155 synop.ifPresent(theSynop -> {
156 getThing().getChannels().forEach(channel -> {
157 String channelId = channel.getUID().getId();
158 if (isLinked(channelId)) {
159 updateState(channelId, getChannelState(channelId, theSynop));
165 private State getChannelState(String channelId, Synop synop) {
167 case HORIZONTAL_VISIBILITY:
168 return new StringType(synop.getHorizontalVisibility().name());
170 return new DecimalType(Math.max(0, synop.getOcta()));
171 case ATTENUATION_FACTOR:
172 double kc = Math.max(0, Math.min(synop.getOcta(), OCTA_MAX)) / OCTA_MAX;
173 kc = 1 - 0.75 * Math.pow(kc, KASTEN_POWER);
174 return new DecimalType(kc);
176 int octa = synop.getOcta();
177 Overcast overcast = Overcast.fromOcta(octa);
178 return overcast == Overcast.UNDEFINED ? UnDefType.NULL : new StringType(overcast.name());
180 return new QuantityType<>(synop.getPressure(), PRESSURE_UNIT);
182 return new QuantityType<>(synop.getTemperature(), TEMPERATURE_UNIT);
184 return new QuantityType<>(synop.getWindDirection(), WIND_DIRECTION_UNIT);
186 return new StringType(WindDirections.getWindDirection(synop.getWindDirection()).name());
188 return getWindStrength(synop);
189 case WIND_SPEED_BEAUFORT:
190 QuantityType<Speed> wsKpH = getWindStrength(synop).toUnit(SIUnits.KILOMETRE_PER_HOUR);
191 return (wsKpH != null) ? new DecimalType(Math.round(Math.pow(wsKpH.floatValue() / 3.01, 0.666666666)))
194 ZonedDateTime now = ZonedDateTime.now(ZoneOffset.UTC);
195 int year = synop.getYear() == 0 ? now.getYear() : synop.getYear();
196 int month = synop.getMonth() == 0 ? now.getMonth().getValue() : synop.getMonth();
197 ZonedDateTime zdt = ZonedDateTime.of(year, month, synop.getDay(), synop.getHour(), 0, 0, 0,
199 return new DateTimeType(zdt);
201 logger.error("Unsupported channel Id '{}'", channelId);
202 return UnDefType.UNDEF;
207 * Returns the wind strength depending upon the unit of the message.
209 private QuantityType<Speed> getWindStrength(Synop synop) {
210 return new QuantityType<>(synop.getWindSpeed(), synop.getWindUnit());
213 private Optional<Synop> createSynopObject(String synopMessage) {
214 List<String> list = new ArrayList<>(Arrays.asList(synopMessage.split("\\s+")));
215 if (synopMessage.startsWith(LAND_STATION_CODE)) {
216 return Optional.of(new SynopLand(list));
217 } else if (synopMessage.startsWith(SHIP_STATION_CODE)) {
218 return Optional.of(new SynopShip(list));
219 } else if (synopMessage.startsWith(MOBILE_LAND_STATION_CODE)) {
220 return Optional.of(new SynopMobile(list));
222 return Optional.empty();
225 private String forgeURL() {
226 ZonedDateTime utc = ZonedDateTime.now(ZoneOffset.UTC).minusDays(1);
227 String beginDate = SYNOP_DATE_FORMAT.format(utc);
228 return String.format(OGIMET_SYNOP_PATH, formattedStationId, beginDate);
232 public void dispose() {
233 ScheduledFuture<?> job = this.executionJob;
234 if (job != null && !job.isCancelled()) {
241 public void handleCommand(ChannelUID channelUID, Command command) {
242 if (command == RefreshType.REFRESH) {
243 updateSynopChannels();