2 * Copyright (c) 2010-2022 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.ipcamera.internal;
15 import static org.openhab.binding.ipcamera.internal.IpCameraBindingConstants.*;
17 import java.math.BigDecimal;
18 import java.util.ArrayList;
20 import org.eclipse.jdt.annotation.NonNullByDefault;
21 import org.eclipse.jdt.annotation.Nullable;
22 import org.openhab.binding.ipcamera.internal.handler.IpCameraHandler;
23 import org.openhab.core.library.types.OnOffType;
24 import org.openhab.core.library.types.PercentType;
25 import org.openhab.core.library.types.StringType;
26 import org.openhab.core.thing.ChannelUID;
27 import org.openhab.core.types.Command;
28 import org.openhab.core.types.RefreshType;
30 import io.netty.channel.ChannelDuplexHandler;
31 import io.netty.channel.ChannelHandlerContext;
32 import io.netty.util.ReferenceCountUtil;
35 * The {@link InstarHandler} is responsible for handling commands, which are
36 * sent to one of the channels.
38 * @author Matthew Skinner - Initial contribution
42 public class InstarHandler extends ChannelDuplexHandler {
43 private IpCameraHandler ipCameraHandler;
44 private String requestUrl = "Empty";
46 public InstarHandler(IpCameraHandler thingHandler) {
47 ipCameraHandler = thingHandler;
50 public void setURL(String url) {
54 // This handles the incoming http replies back from the camera.
56 public void channelRead(@Nullable ChannelHandlerContext ctx, @Nullable Object msg) throws Exception {
57 if (msg == null || ctx == null) {
62 String content = msg.toString();
63 ipCameraHandler.logger.trace("HTTP Result back from camera is \t:{}:", content);
65 case "/param.cgi?cmd=getinfrared":
66 if (content.contains("var infraredstat=\"auto") || content.contains("infraredstat=\"2\"")) {
67 ipCameraHandler.setChannelState(CHANNEL_AUTO_LED, OnOffType.ON);
69 ipCameraHandler.setChannelState(CHANNEL_AUTO_LED, OnOffType.OFF);
72 case "/param.cgi?cmd=getoverlayattr&-region=1":// Text Overlays
73 if (content.contains("var show_1=\"0\"") || content.contains("show=\"0\"")) {
74 ipCameraHandler.setChannelState(CHANNEL_TEXT_OVERLAY, StringType.EMPTY);
76 value1 = Helper.searchString(content, "var name_1=\"");
77 if (!value1.isEmpty()) {
78 ipCameraHandler.setChannelState(CHANNEL_TEXT_OVERLAY, StringType.valueOf(value1));
80 value1 = Helper.searchString(content, "name=\"");
81 if (!value1.isEmpty()) {
82 ipCameraHandler.setChannelState(CHANNEL_TEXT_OVERLAY, StringType.valueOf(value1));
87 case "/cgi-bin/hi3510/param.cgi?cmd=getmdattr":// Motion Alarm old
88 if (content.contains("var m1_enable=\"1\"")) {
89 ipCameraHandler.setChannelState(CHANNEL_ENABLE_MOTION_ALARM, OnOffType.ON);
91 ipCameraHandler.setChannelState(CHANNEL_ENABLE_MOTION_ALARM, OnOffType.OFF);
94 case "/param.cgi?cmd=getalarmattr":// Motion Alarm new
95 if (content.contains("armed=\"1\"")) {
96 ipCameraHandler.setChannelState(CHANNEL_ENABLE_MOTION_ALARM, OnOffType.ON);
98 ipCameraHandler.setChannelState(CHANNEL_ENABLE_MOTION_ALARM, OnOffType.OFF);
101 case "/param.cgi?cmd=getaudioalarmattr":// Audio Alarm
102 if (content.contains("enable=\"1\"")) {
103 ipCameraHandler.setChannelState(CHANNEL_ENABLE_AUDIO_ALARM, OnOffType.ON);
104 value1 = Helper.searchString(content, "aa_value=\"");
105 if (!value1.isEmpty()) {// old cameras have threshold in percentage
106 ipCameraHandler.setChannelState(CHANNEL_THRESHOLD_AUDIO_ALARM, PercentType.valueOf(value1));
108 value1 = Helper.searchString(content, "threshold=\"");
109 if (!value1.isEmpty()) {// newer cameras have values up to 10
110 ipCameraHandler.setChannelState(CHANNEL_THRESHOLD_AUDIO_ALARM,
111 PercentType.valueOf(value1 + "0"));
115 ipCameraHandler.setChannelState(CHANNEL_ENABLE_AUDIO_ALARM, OnOffType.OFF);
116 ipCameraHandler.setChannelState(CHANNEL_THRESHOLD_AUDIO_ALARM, OnOffType.OFF);
119 case "/param.cgi?cmd=getpirattr":// PIR Alarm
120 if (content.contains("enable=\"1\"")) {
121 ipCameraHandler.setChannelState(CHANNEL_ENABLE_PIR_ALARM, OnOffType.ON);
123 ipCameraHandler.setChannelState(CHANNEL_ENABLE_PIR_ALARM, OnOffType.OFF);
125 // Reset the Alarm, need to find better place to put this.
126 ipCameraHandler.noMotionDetected(CHANNEL_PIR_ALARM);
128 case "/param.cgi?cmd=getioattr":// External Alarm Input
129 if (content.contains("enable=\"1\"")) {
130 ipCameraHandler.setChannelState(CHANNEL_ENABLE_EXTERNAL_ALARM_INPUT, OnOffType.ON);
132 ipCameraHandler.setChannelState(CHANNEL_ENABLE_EXTERNAL_ALARM_INPUT, OnOffType.OFF);
136 if (requestUrl.startsWith("/param.cgi?cmd=setasaction&-server=1&enable=1")
137 && content.contains("response=\"200\";")) {// new
138 ipCameraHandler.newInstarApi = true;
139 ipCameraHandler.logger.debug("Alarm server sucessfully setup for a 2k+ Instar camera");
140 } else if (requestUrl.startsWith("/param.cgi?cmd=setmdalarm&-aname=server2&-switch=on&-interval=1")
141 && content.startsWith("[Succeed]set ok")) {
142 ipCameraHandler.newInstarApi = false;
143 ipCameraHandler.logger.debug("Alarm server sucessfully setup for a 1080p Instar camera");
145 ipCameraHandler.logger.debug("Unknown reply from URI:{}", requestUrl);
149 ReferenceCountUtil.release(msg);
153 // This handles the commands that come from the openHAB event bus.
154 public void handleCommand(ChannelUID channelUID, Command command) {
155 if (command instanceof RefreshType) {
156 switch (channelUID.getId()) {
157 case CHANNEL_THRESHOLD_AUDIO_ALARM:
158 case CHANNEL_ENABLE_AUDIO_ALARM:
159 ipCameraHandler.sendHttpGET("/param.cgi?cmd=getaudioalarmattr");
161 case CHANNEL_ENABLE_EXTERNAL_ALARM_INPUT:
162 ipCameraHandler.sendHttpGET("/param.cgi?cmd=getioattr");
164 case CHANNEL_ENABLE_MOTION_ALARM:
165 if (ipCameraHandler.newInstarApi) {
166 ipCameraHandler.sendHttpGET("/param.cgi?cmd=getalarmattr");
168 ipCameraHandler.sendHttpGET("/cgi-bin/hi3510/param.cgi?cmd=getmdattr");
171 case CHANNEL_ENABLE_PIR_ALARM:
172 ipCameraHandler.sendHttpGET("/param.cgi?cmd=getpirattr");
174 case CHANNEL_AUTO_LED:
175 ipCameraHandler.sendHttpGET("/param.cgi?cmd=getinfrared");
177 case CHANNEL_TEXT_OVERLAY:
178 ipCameraHandler.sendHttpGET("/param.cgi?cmd=getoverlayattr&-region=1");
182 } // end of "REFRESH"
183 if (ipCameraHandler.newInstarApi) {
184 switch (channelUID.getId()) {
185 case CHANNEL_THRESHOLD_AUDIO_ALARM:
186 if (OnOffType.OFF.equals(command) || PercentType.ZERO.equals(command)) {
187 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setaudioalarmattr&enable=0");
188 } else if (OnOffType.ON.equals(command)) {
189 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setaudioalarmattr&enable=1");
190 } else if (command instanceof PercentType) {
191 int value = ((PercentType) command).toBigDecimal().divide(BigDecimal.TEN).intValue();
192 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setaudioalarmattr&enable=1&threshold=" + value);
195 case CHANNEL_ENABLE_AUDIO_ALARM:
196 if (OnOffType.ON.equals(command)) {
197 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setaudioalarmattr&enable=1");
199 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setaudioalarmattr&enable=0");
202 case CHANNEL_ENABLE_MOTION_ALARM:
203 if (OnOffType.ON.equals(command)) {
204 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setalarmattr&armed=1");
206 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setalarmattr&armed=0");
209 case CHANNEL_TEXT_OVERLAY:
210 String text = Helper.encodeSpecialChars(command.toString());
211 if (text.isEmpty()) {
212 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setoverlayattr&-region=1&-show=0");
214 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setoverlayattr&-region=1&-show=1&-name=" + text);
217 case CHANNEL_AUTO_LED:
218 if (OnOffType.ON.equals(command)) {
219 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setinfrared&-infraredstat=2");
221 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setinfrared&-infraredstat=0");
224 case CHANNEL_ENABLE_PIR_ALARM:
225 if (OnOffType.ON.equals(command)) {
226 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setpirattr&enable=1");
228 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setpirattr&enable=0");
231 case CHANNEL_ENABLE_EXTERNAL_ALARM_INPUT:
232 if (OnOffType.ON.equals(command)) {
233 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setioattr&enable=1");
235 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setioattr&enable=0");
240 switch (channelUID.getId()) {
241 case CHANNEL_THRESHOLD_AUDIO_ALARM:
242 if (OnOffType.OFF.equals(command) || PercentType.ZERO.equals(command)) {
243 ipCameraHandler.sendHttpGET("/cgi-bin/hi3510/param.cgi?cmd=setaudioalarmattr&-aa_enable=0");
244 } else if (OnOffType.ON.equals(command)) {
245 ipCameraHandler.sendHttpGET("/cgi-bin/hi3510/param.cgi?cmd=setaudioalarmattr&-aa_enable=1");
246 } else if (command instanceof PercentType) {
247 int value = ((PercentType) command).toBigDecimal().divide(BigDecimal.TEN).intValue();
248 ipCameraHandler.sendHttpGET(
249 "/cgi-bin/hi3510/param.cgi?cmd=setaudioalarmattr&-aa_enable=1&-aa_value=" + value * 10);
252 case CHANNEL_ENABLE_AUDIO_ALARM:
253 if (OnOffType.ON.equals(command)) {
254 ipCameraHandler.sendHttpGET("/cgi-bin/hi3510/param.cgi?cmd=setaudioalarmattr&-aa_enable=1");
256 ipCameraHandler.sendHttpGET("/cgi-bin/hi3510/param.cgi?cmd=setaudioalarmattr&-aa_enable=0");
259 case CHANNEL_ENABLE_MOTION_ALARM:
260 if (OnOffType.ON.equals(command)) {
261 ipCameraHandler.sendHttpGET(
262 "/cgi-bin/hi3510/param.cgi?cmd=setmdattr&-enable=1&-name=1&cmd=setmdattr&-enable=1&-name=2&cmd=setmdattr&-enable=1&-name=3&cmd=setmdattr&-enable=1&-name=4");
264 ipCameraHandler.sendHttpGET(
265 "/cgi-bin/hi3510/param.cgi?cmd=setmdattr&-enable=0&-name=1&cmd=setmdattr&-enable=0&-name=2&cmd=setmdattr&-enable=0&-name=3&cmd=setmdattr&-enable=0&-name=4");
268 case CHANNEL_TEXT_OVERLAY:
269 String text = Helper.encodeSpecialChars(command.toString());
270 if (text.isEmpty()) {
271 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setoverlayattr&-region=1&-show=0");
273 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setoverlayattr&-region=1&-show=1&-name=" + text);
276 case CHANNEL_AUTO_LED:
277 if (OnOffType.ON.equals(command)) {
278 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setinfrared&-infraredstat=auto");
280 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setinfrared&-infraredstat=close");
283 case CHANNEL_ENABLE_PIR_ALARM:
284 if (OnOffType.ON.equals(command)) {
285 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setpirattr&-pir_enable=1");
287 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setpirattr&-pir_enable=0");
290 case CHANNEL_ENABLE_EXTERNAL_ALARM_INPUT:
291 if (OnOffType.ON.equals(command)) {
292 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setioattr&-io_enable=1");
294 ipCameraHandler.sendHttpGET("/param.cgi?cmd=setioattr&-io_enable=0");
301 public void alarmTriggered(String alarm) {
302 // older cameras placed the & for the first query, whilst newer cameras do not.
303 // examples are /instar?&active=6 vs /instar?active=6&object=0
304 ipCameraHandler.setChannelState(CHANNEL_LAST_EVENT_DATA, new StringType(alarm));
305 String alarmCode = alarm.replaceAll(".+active=", "");
306 alarmCode = alarmCode.replaceAll("&.+", "");
307 String objectCode = alarm.replaceAll(".+object=", "");
309 case "1":// The motion area boxes 1-4
313 ipCameraHandler.motionDetected(CHANNEL_MOTION_ALARM);
316 ipCameraHandler.motionDetected(CHANNEL_PIR_ALARM);
318 case "6":// Audio Alarm
319 ipCameraHandler.audioDetected();
321 case "7":// Motion area 1 + PIR
322 case "8":// Motion area 2 + PIR
323 case "9":// Motion area 3 + PIR
324 case "10":// Motion area 4 + PIR
325 ipCameraHandler.motionDetected(CHANNEL_MOTION_ALARM);
326 ipCameraHandler.motionDetected(CHANNEL_PIR_ALARM);
329 ipCameraHandler.logger.debug("Unknown alarm code:{}", alarmCode);
331 if (!objectCode.isEmpty()) {
332 switch (objectCode) {
333 // person=1, car=2, animal=4 so 1+2+4=7 means one of each.
334 case "0":// no object
337 ipCameraHandler.motionDetected(CHANNEL_HUMAN_ALARM);
340 ipCameraHandler.motionDetected(CHANNEL_CAR_ALARM);
343 ipCameraHandler.motionDetected(CHANNEL_HUMAN_ALARM);
344 ipCameraHandler.motionDetected(CHANNEL_CAR_ALARM);
347 ipCameraHandler.motionDetected(CHANNEL_ANIMAL_ALARM);
350 ipCameraHandler.motionDetected(CHANNEL_HUMAN_ALARM);
351 ipCameraHandler.motionDetected(CHANNEL_ANIMAL_ALARM);
354 ipCameraHandler.motionDetected(CHANNEL_CAR_ALARM);
355 ipCameraHandler.motionDetected(CHANNEL_ANIMAL_ALARM);
358 ipCameraHandler.motionDetected(CHANNEL_HUMAN_ALARM);
359 ipCameraHandler.motionDetected(CHANNEL_CAR_ALARM);
360 ipCameraHandler.motionDetected(CHANNEL_ANIMAL_ALARM);
363 if (objectCode.startsWith("/instar?")) {
364 return;// has no object due to older Instar camera model
366 ipCameraHandler.logger.debug("Unknown object detection code:{}", objectCode);
371 // If a camera does not need to poll a request as often as snapshots, it can be
372 // added here. Binding steps through the list.
373 public ArrayList<String> getLowPriorityRequests() {
374 ArrayList<String> lowPriorityRequests = new ArrayList<String>(7);
375 lowPriorityRequests.add("/param.cgi?cmd=getaudioalarmattr");
376 lowPriorityRequests.add("/cgi-bin/hi3510/param.cgi?cmd=getmdattr");
377 lowPriorityRequests.add("/param.cgi?cmd=getalarmattr");
378 lowPriorityRequests.add("/param.cgi?cmd=getinfrared");
379 lowPriorityRequests.add("/param.cgi?cmd=getoverlayattr&-region=1");
380 lowPriorityRequests.add("/param.cgi?cmd=getpirattr");
381 lowPriorityRequests.add("/param.cgi?cmd=getioattr"); // ext alarm input on/off
382 return lowPriorityRequests;