Note: This article includes known limitations and workarounds for device compatibility, codec support (including H.265), and streaming behavior in Iris. These issues are actively being addressed by the development team, and improvements will be rolled out in future updates.
Note: This article includes known limitations and workarounds for device compatibility, codec support (including H.265), and streaming behavior in Iris. These issues are actively being addressed by the development team, and improvements will be rolled out in future updates.
While Iris Enabled devices are designed for plug-and-play integration, individual models may encounter specific issues depending on firmware, network environment, or stream settings. This guide serves as a centralized reference to capture recurring problems, common symptoms, and working solutions as we validate them.
Known Issue: “Video connection failed”
Applies to: BirdDog X1 Ultra
Symptom: Camera appears linked but fails to display video in Iris
Environment: Desktop and web clients; persistent error across both
Fix:
Open the camera’s WebUI
Go to Advanced Settings → Video
Enable Stream 2
Set the stream codec to H.264
Save and reboot the device
This resolves the RTSP handshake compatibility and allows Iris to ingest the feed successfully.
If your camera or encoder isn't appearing in Iris or isn't streaming correctly, there may be an issue with compatibility, configuration, or network discovery. This guide outlines common problems and how to resolve them.
Common Device Issues
1. The device does not appear in Iris
Ensure the device is on the same local network as your Iris Studio.
Confirm the device is powered on and not blocked by firewall or VLAN rules.
Some older devices may not support automatic discovery protocols. Use manual setup if needed.
2. The stream shows up but doesn't play
Check the codec output of the camera. Iris supports H.264, and in some cases H.265, depending on the device (see below).
Ensure the stream is not password-protected or behind an authentication layer Iris can’t parse.
Validate that the RTSP path is correct.
3. Audio is missing or delayed
Not all devices embed audio in supported formats. Use cameras or encoders known to deliver AAC or similar audio streams.
Try toggling audio settings in the camera or encoder’s admin panel.
H.265 (HEVC) Compatibility Issues
If your device isn't displaying video in Iris, check whether it’s using H.265 (HEVC) encoding. While Iris supports H.265 in some contexts, not all devices handle it consistently.
Important limitations:
H.265 is disabled for BirdDog embedded devices. Even if the camera hardware supports H.265, Iris cannot use it in these cases.
BZBGEAR cameras have known issues with H.265, even when set up for RTSP streaming. Iris compatibility is not guaranteed when H.265 is enabled.
In contrast, local device streams using RTSP with H.265 may still work if the device is not embedded or constrained by firmware.
Recommended troubleshooting steps:
Switch the camera’s output to H.264 instead of H.265.
Reboot the device and reconnect it in Iris after changing the codec.
Confirm whether the device uses embedded firmware (where codec settings may be restricted).
Note: These H.265 compatibility issues are known and actively being addressed by the Iris development team. Updates will be reflected in release notes as improvements become available.