Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs for onvif camera support #7999

Merged
merged 7 commits into from Sep 29, 2023
Merged

docs for onvif camera support #7999

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
12b6c13
docs for onvif camera support
hawkeye217 Sep 29, 2023
e252469
fix warning
hawkeye217 Sep 29, 2023
157bbb7
warning to caution
hawkeye217 Sep 29, 2023
6020e38
update table
hawkeye217 Sep 29, 2023
f49274d
centering
hawkeye217 Sep 29, 2023
17b0b75
no autotracking for reolinks
hawkeye217 Sep 29, 2023
e337808
zoom only for 511WA
hawkeye217 Sep 29, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
37 changes: 28 additions & 9 deletions docs/docs/configuration/cameras.md
View file
Open in desktop
Expand Up @@ -11,11 +11,11 @@ A camera is enabled by default but can be temporarily disabled by using `enabled

Each role can only be assigned to one input per camera. The options for roles are as follows:

| Role | Description |
| ---------- | ---------------------------------------------------------------------------------------- |
| `detect` | Main feed for object detection |
| `record` | Saves segments of the video feed based on configuration settings. [docs](record.md) |
| `rtmp` | Deprecated: Broadcast as an RTMP feed for other services to consume. [docs](restream.md) |
| Role | Description |
| -------- | ---------------------------------------------------------------------------------------- |
| `detect` | Main feed for object detection |
| `record` | Saves segments of the video feed based on configuration settings. [docs](record.md) |
| `rtmp` | Deprecated: Broadcast as an RTMP feed for other services to consume. [docs](restream.md) |

```yaml
mqtt:
Expand Down Expand Up @@ -51,20 +51,39 @@ For camera model specific settings check the [camera specific](camera_specific.m

## Setting up camera PTZ controls

Add onvif config to camera
:::caution

Not every PTZ supports ONVIF, which is the standard protocol Frigate uses to communicate with your camera. Check your camera documentation or manufacturer's website to ensure your camera supports ONVIF. If your camera supports ONVIF and you continue to have trouble, make sure your camera is running the latest firmware.

:::

Add the onvif section to your camera in your configuration file:

```yaml
cameras:
back:
ffmpeg:
...
ffmpeg: ...
onvif:
host: 10.0.10.10
port: 8000
user: admin
password: password
```

then PTZ controls will be available in the cameras WebUI.
If the ONVIF connection is successful, PTZ controls will be available in the camera's WebUI.

An ONVIF-capable camera that supports relative movement within the field of view (FOV) can also be configured to automatically track moving objects and keep them in the center of the frame. For autotracking setup, see the [autotracking](autotracking.md) docs.

## ONVIF PTZ camera recommendations
hawkeye217 marked this conversation as resolved.
Show resolved Hide resolved

This list of working and non-working PTZ cameras is based on user feedback.

| Brand or specific camera | PTZ Controls | Autotracking | Notes |
| ------------------------ | :----------: | :----------: | ------------------------------------------------------- |
| Amcrest | ✅ | ⛔️ | Some older models (IP2M-841) don't support autotracking |
| Amcrest ASH21 | ❌ | ❌ | No ONVIF support |
| Dahua | ✅ | ✅ |
| Reolink 511WA | ✅ | ❌ | Zoom only |
| Reolink E1 Zoom | ✅ | ❌ | |
| Tapo C210 | ❌ | ❌ | Incomplete ONVIF support |
| Vikylin PTZ-2804X-I2 | ❌ | ❌ | Incomplete ONVIF support |