Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

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.

Repozytorium
ptz-simulator ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. Quick start
  2. Rules for conformance tests
Sekcje z nagłówków SKILL.md, w oryginale · 64 linii, 459 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.