## Discovery
-The discovery feature of openHAB can be used to find and setup any ONVIF cameras.
+The discovery feature of openHAB can be used to find and setup ONVIF cameras.
This method should be preferred as it will discover the cameras IP, ports and URLs for you, making the setup much easier.
The binding needs to use UDP port 3702 to discover the cameras with, so this port needs to be unblocked by your firewall or add the camera manually if the camera is not auto found.
To use the discovery, just press the `+` icon located in the Inbox, then select the IpCamera binding from the list of installed bindings.
+The binding will only search using openHAB's currently selected primary network address, see <https://www.openhab.org/docs/settings/>.
If your camera is not found after a few searches, it may not be ONVIF and in this case you will need to manually add the camera via the UI.
Cameras that are not ONVIF should be added as a `generic` thing type and you will need to provide the URLs manually.
import org.openhab.core.config.discovery.DiscoveryResult;
import org.openhab.core.config.discovery.DiscoveryResultBuilder;
import org.openhab.core.config.discovery.DiscoveryService;
+import org.openhab.core.net.NetworkAddressService;
import org.openhab.core.thing.ThingTypeUID;
import org.openhab.core.thing.ThingUID;
+import org.osgi.service.component.annotations.Activate;
import org.osgi.service.component.annotations.Component;
+import org.osgi.service.component.annotations.Reference;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class IpCameraDiscoveryService extends AbstractDiscoveryService {
private final Logger logger = LoggerFactory.getLogger(IpCameraDiscoveryService.class);
+ private final NetworkAddressService networkAddressService;
- public IpCameraDiscoveryService() {
+ @Activate
+ public IpCameraDiscoveryService(@Reference NetworkAddressService networkAddressService) {
super(SUPPORTED_THING_TYPES, 0, false);
+ this.networkAddressService = networkAddressService;
}
@Override
@Override
protected void startScan() {
removeOlderResults(getTimestampOfLastScan());
- OnvifDiscovery onvifDiscovery = new OnvifDiscovery(this);
+ OnvifDiscovery onvifDiscovery = new OnvifDiscovery(networkAddressService, this);
try {
onvifDiscovery.discoverCameras();
} catch (UnknownHostException | InterruptedException e) {
import org.eclipse.jdt.annotation.Nullable;
import org.openhab.binding.ipcamera.internal.Helper;
import org.openhab.binding.ipcamera.internal.IpCameraDiscoveryService;
+import org.openhab.core.net.NetworkAddressService;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
*/
@NonNullByDefault
+@io.netty.channel.ChannelHandler.Sharable
public class OnvifDiscovery {
private IpCameraDiscoveryService ipCameraDiscoveryService;
private final Logger logger = LoggerFactory.getLogger(OnvifDiscovery.class);
+ private final NetworkAddressService networkAddressService;
public ArrayList<DatagramPacket> listOfReplys = new ArrayList<DatagramPacket>(10);
- public OnvifDiscovery(IpCameraDiscoveryService ipCameraDiscoveryService) {
+ public OnvifDiscovery(NetworkAddressService networkAddressService,
+ IpCameraDiscoveryService ipCameraDiscoveryService) {
this.ipCameraDiscoveryService = ipCameraDiscoveryService;
+ this.networkAddressService = networkAddressService;
}
public @Nullable List<NetworkInterface> getLocalNICs() {
+ String primaryHostAddress = networkAddressService.getPrimaryIpv4HostAddress();
List<NetworkInterface> results = new ArrayList<>(2);
try {
for (Enumeration<NetworkInterface> enumNetworks = NetworkInterface.getNetworkInterfaces(); enumNetworks
InetAddress inetAddress = enumIpAddr.nextElement();
if (!inetAddress.isLoopbackAddress() && inetAddress.getHostAddress().toString().length() < 18
&& inetAddress.isSiteLocalAddress()) {
- results.add(networkInterface);
+ if (inetAddress.getHostAddress().equals(primaryHostAddress)) {
+ results.add(networkInterface);
+ logger.debug("Scanning network {} for any ONVIF cameras", primaryHostAddress);
+ } else {
+ logger.debug("Skipping network {} as it was not selected as openHAB's 'Primary Address'",
+ inetAddress.getHostAddress());
+ }
+ } else {
+ logger.debug("Skipping network {} as it was not site local", inetAddress.getHostAddress());
}
}
}
if (!xAddr.isEmpty()) {
searchReply(xAddr, xml);
} else if (xml.contains("onvif")) {
- logger.info("Possible ONVIF camera found at:{}", packet.sender().getHostString());
- ipCameraDiscoveryService.newCameraFound("onvif", packet.sender().getHostString(), 80);
+ String brand;
+ try {
+ brand = getBrandFromLoginPage(packet.sender().getHostString());
+ } catch (IOException e) {
+ brand = "onvif";
+ }
+ logger.info("Possible {} camera found at:{}", brand, packet.sender().getHostString());
+ if ("reolink".equals(brand)) {
+ ipCameraDiscoveryService.newCameraFound(brand, packet.sender().getHostString(), 8000);
+ } else {
+ ipCameraDiscoveryService.newCameraFound(brand, packet.sender().getHostString(), 80);
+ }
}
}
}
return "dahua";
} else if (response.toLowerCase().contains("dahua")) {
return "dahua";
+ } else if (response.toLowerCase().contains("doorbird")) {
+ return "doorbird";
} else if (response.toLowerCase().contains("foscam")) {
return "foscam";
} else if (response.toLowerCase().contains("hikvision")) {
return "hikvision";
} else if (response.toLowerCase().contains("instar")) {
return "instar";
- } else if (response.toLowerCase().contains("doorbird")) {
- return "doorbird";
+ } else if (response.toLowerCase().contains("reolink")) {
+ return "reolink";
} else if (response.toLowerCase().contains("ipc-")) {
return "dahua";
} else if (response.toLowerCase().contains("dh-sd")) {
return "dahua";
- } else if (response.toLowerCase().contains("reolink")) {
- return "reolink";
}
return "onvif";
}
public void discoverCameras() throws UnknownHostException, InterruptedException {
List<NetworkInterface> nics = getLocalNICs();
if (nics == null || nics.isEmpty()) {
+ logger.warn(
+ "No 'Primary Address' selected to use for camera discovery. Check openHAB's Network Settings page to select a valid Primary Address.");
return;
}
NetworkInterface networkInterface = nics.get(0);