Add camera setup guide documenting recommended configuration for Dahua cameras #108

Closed
opened 2026-07-14 02:48:21 +00:00 by coding-agent-marvin8 · 2 comments
coding-agent-marvin8 commented 2026-07-14 02:48:21 +00:00 (Migrated from codeberg.org)

Cang users need to configure their cameras before cang will work well with them, but there is currently no documentation covering this. A camera setup guide would cover recommended settings (snapshot interval, etc.) and known gotchas — such as the requirement to be logged in as the admin account on Dahua cameras to save config changes. The guide should include Dahua-specific detail since that is the only currently supported adapter.

Cang users need to configure their cameras before cang will work well with them, but there is currently no documentation covering this. A camera setup guide would cover recommended settings (snapshot interval, etc.) and known gotchas — such as the requirement to be logged in as the admin account on Dahua cameras to save config changes. The guide should include Dahua-specific detail since that is the only currently supported adapter.
coding-agent-marvin8 commented 2026-07-14 02:48:38 +00:00 (Migrated from codeberg.org)

Findings from hands-on Dahua HFW2841T-ZS configuration session:

  • The snapshot interval 'Customized' field in Camera → Video → Snapshot accepts 1–50000 seconds
  • Saving config via the web UI requires the admin account — operator-level accounts (e.g. sub-accounts) get a silent 'Save failed' error
  • The snapshot interval is not stored in the Snap CGI config; the UI sends it via a JSON-RPC multicall to the Encode and SnapStrategy config names
  • Recommended interval for cang: lower values (e.g. 7–60 s) give denser snapshot coverage; 60 s is a reasonable default

Plan:

  1. Create with a Dahua section covering: snapshot settings (type, strategy, quality, interval), the admin login requirement, and the CGI/RPC2 API as a fallback when the UI fails
  2. Add the page to the in
  3. Branch:
  4. Single commit:
  5. PR targeting main, body includes
Findings from hands-on Dahua HFW2841T-ZS configuration session: - The snapshot interval 'Customized' field in Camera → Video → Snapshot accepts 1–50000 seconds - Saving config via the web UI requires the **admin** account — operator-level accounts (e.g. sub-accounts) get a silent 'Save failed' error - The snapshot interval is not stored in the Snap CGI config; the UI sends it via a JSON-RPC multicall to the Encode and SnapStrategy config names - Recommended interval for cang: lower values (e.g. 7–60 s) give denser snapshot coverage; 60 s is a reasonable default Plan: 1. Create with a Dahua section covering: snapshot settings (type, strategy, quality, interval), the admin login requirement, and the CGI/RPC2 API as a fallback when the UI fails 2. Add the page to the in 3. Branch: 4. Single commit: 5. PR targeting main, body includes
coding-agent-marvin8 commented 2026-07-14 02:48:56 +00:00 (Migrated from codeberg.org)

Findings from hands-on Dahua HFW2841T-ZS configuration session:

  • The snapshot interval 'Customized' field in Camera → Video → Snapshot accepts 1–50000 seconds
  • Saving config via the web UI requires the admin account — operator-level accounts (e.g. sub-accounts) get a silent 'Save failed' error
  • The snapshot interval is not stored in the Snap CGI config; the UI sends it via a JSON-RPC multicall to the Encode and SnapStrategy config names
  • Recommended interval for cang: lower values (e.g. 7–60 s) give denser snapshot coverage; 60 s is a reasonable default

Plan:

  1. Create docs/camera-setup.md with a Dahua section covering: snapshot settings (type, strategy, quality, interval), the admin login requirement, and the CGI/RPC2 API as a fallback when the UI fails
  2. Add the page to the nav in mkdocs.yml
  3. Branch: docs/camera-setup
  4. Single commit: :memo: add camera setup guide for Dahua cameras
  5. PR targeting main, body includes Closes #108
Findings from hands-on Dahua HFW2841T-ZS configuration session: - The snapshot interval 'Customized' field in Camera → Video → Snapshot accepts 1–50000 seconds - Saving config via the web UI requires the **admin** account — operator-level accounts (e.g. sub-accounts) get a silent 'Save failed' error - The snapshot interval is not stored in the Snap CGI config; the UI sends it via a JSON-RPC multicall to the Encode and SnapStrategy config names - Recommended interval for cang: lower values (e.g. 7–60 s) give denser snapshot coverage; 60 s is a reasonable default Plan: 1. Create `docs/camera-setup.md` with a Dahua section covering: snapshot settings (type, strategy, quality, interval), the admin login requirement, and the CGI/RPC2 API as a fallback when the UI fails 2. Add the page to the `nav` in `mkdocs.yml` 3. Branch: `docs/camera-setup` 4. Single commit: `:memo: add camera setup guide for Dahua cameras` 5. PR targeting main, body includes `Closes #108`
Sign in to join this conversation.
No labels
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
marvin8/cang#108
No description provided.