ptz-conformance-testing
/ptz-conformance-testing
Sprawdza zgodność implementacji sterowania kamerą PTZ, w protokołach VISCA lub ONVIF, z symulatorem referencyjnym ptzsim i skryptami testowymi.
- Autor
- stritti ↗
- Repozytorium
- ptz-simulator ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 0
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Co robi i kiedy
Sprawdza zgodność implementacji sterowania kamerą PTZ, w protokołach VISCA lub ONVIF, z symulatorem referencyjnym ptzsim i skryptami testowymi.
Oryginalny opis (EN)
Validate a PTZ camera interface implementation (VISCA, ONVIF or other) against the ptzsim reference simulator: start ptzsim with the matching protocol, drive it with ptzsim send or an ONVIF client, or run the bundled visca_conformance.py / onvif_conformance.py smoke scripts against your own camera-side endpoint; follow the conformance checklists for reply framing, error codes, sockets, discovery, auth, faults and timeouts. Use whenever a camera interface must be proven interoperable with real clients/cameras.
Jak działa
- Quick start
- Rules for conformance tests
Podgląd SKILL.md
--- name: ptz-conformance-testing description: "Validate a PTZ camera interface implementation (VISCA, ONVIF or other) against the ptzsim reference simulator: start ptzsim with the matching protocol, drive it with ptzsim send or an ONVIF client, or run the bundled visca_conformance.py / onvif_conformance.py smoke scripts against your own camera-side endpoint; follow the conformance checklists for reply framing, error codes, sockets, discovery, auth, faults and timeouts. Use whenever a camera interface must be proven interoperable with real clients/cameras." license: MIT compatibility: ptzsim and the bundled scripts need only Python 3.8+ (standard library); optional extras (NDI runtime, onvif-zeep-async client test) are opt-in. metadata: author: stritti version: "1.0.0" source: https://github.com/stritti/ptz-simulator --- <!-- SPDX-FileCopyrightText: 2026 Stephan Strittmatter SPDX-License-Identifier: MIT --> # Conformance testing against the ptzsim reference [ptzsim](https://github.com/stritti/ptz-simulator) is the reference implementation: it speaks VISCA (Sony VISCA over IP UDP 52381, raw VISCA over TCP 5678 / UDP 1259, serial via pty) and ONVIF (Device/Media/PTZ/Imaging SOAP services, WS-Discovery, HTTP digest + WS-Security) strictly per the standards, on Python 3.8+ with no dependencies. Use it in both directions: - **Your code is the camera** (exposes the interface): run the bundled smoke scripts against your endpoint — `../visca-interface/scripts/visca_conformance.py` (VISCA) and `../onvif-ptz-interface/scripts/onvif_conformance.py` (ONVIF). They exit 0 only when every wire-level check passes. Also point a real client library at your endpoint. - **Your code is the client** (drives a camera): start ptzsim and point your client at it; work through the checklist section "Client side" (VISCA over IP control errors, separate pan/tilt speed maximums, ONVIF omitted axes) and assert on the camera model with the `ptzsim.testing` helpers `assert_stopped` / `assert_no_errors`. References: - [references/ptzsim-usage.md](references/ptzsim-usage.md) — how to install/run ptzsim, the serve/send commands, ports, auth options, and the `ptzsim.testing` helpers for end-to-end tests in your own test suite. - [references/conformance-checklist.md](references/conformance-checklist.md) — what "reference-conformant" means per protocol: the exact checks to verify (VISCA framing, sockets, error codes; ONVIF spaces, faults, discovery, auth, timeouts), the client-side pitfalls, plus the known deliberate deviations of the reference. ## Quick start ```bash # reference camera on localhost: VISCA/IP 52381, raw TCP 5678, raw UDP 1259, ONVIF 8080 python3 -m ptzsim serve --sony --tcp --udp --onvif --onvif-user admin --onvif-password secret --no-tui python3 -m ptzsim serve --pelco-d /tmp/ttyPelcoD # Pelco-D serial (ptzsim >= 0.4.0) uv run --extra ndi ptzsim serve --ndi --name "Camera 1" # NDI source with PTZ metadata # quick VISCA checks against it python3 -m ptzsim send "81 09 06 12 FF" # pan/tilt position inquiry python3 -m ptzsim send "81 01 06 04 FF" # home # smoke-test YOUR camera-side endpoint instead python3 visca_conformance.py --host 192.168.1.50 --transport sony python3 onvif_conformance.py --host 192.168.1.50 --port 8080 --user admin --password secret --discovery ``` ## Rules for conformance tests - Test over real sockets end to end, not only parsed fixtures. - Assert the exact reply bytes/SOAP structure, including error paths (syntax error, not executable, buffer full; InvalidArgVal, NoProfile, MovingPTZ, ActionNotSupported). - Cover discovery (Probe → ProbeMatches with XAddrs) and auth (401 challenge; digest and WSSE UsernameToken PasswordDigest) when the interface has them. - For a client, check after every Stop that no axis is still moving and that the camera rejected nothing; a client call that only returns after its timeout means it missed a reply (often a VISCA over IP control reply `0F 01` / `0F 02`). - Where the reference deliberately deviates from the full standard, document the deviation in your README instead of "fixing" the test (see the checklist).
Pliki w paczce (3)
- SKILL.md 4 KB
- references/conformance-checklist.md 10 KB
- references/ptzsim-usage.md 6 KB
Wersje
W bazie nie ma innych skilli o nazwie ptz-conformance-testing.
Migawka bazy z 13.11.2026 · wersja paczki 418a5b3c7c97 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90ptz-reference-interface
Implementuje zgodny ze standardem interfejs sterowania kamerami PTZ (VISCA, ONVIF) i sprawdza go w symulatorze ptzsim. - 100onvif-ptz-interface
Implementuje usługi kamery ONVIF Profile S i T: Device, Media i PTZ przez SOAP oraz klienta, który działa z kamerami różnych producentów. - 100ptz-docs
Wyszukuje i pobiera dokumentację protokołów sterowania kamerami PTZ, czyli Sony VISCA i ONVIF, z profilami i formatem ramek. - 100ptz-onvif
Wykrywa i steruje kamerami IP przez ONVIF, czyli SOAP i XML z uwierzytelnianiem WS-Security, obejmując PTZ i strumienie RTSP. - 100wsdiscovery
Skanuje protokołem WS-Discovery, aby wykrywać i wyliczać kamery ONVIF i urządzenia IoT w sieci. - 100esp32-modbus-conformance-testing
Testuje zgodność implementacji Modbus na ESP32 ze specyfikacją protokołu.