ptz-reference-interface
/ptz-reference-interface
Implement a reference-conformant PTZ camera control interface (VISCA over serial or IP, ONVIF Profile S/T PTZ, or another PTZ protocol) that interoperates with real cameras, VMS and controllers: choose the protocol, implement framing and operations exactly per the standard, and validate the result against the ptzsim reference simulator. Use this skill when a project needs to expose or consume a camera interface for pan/tilt/zoom/presets and the wire behaviour must match the standard.
- Author
- stritti ↗
- Repository
- ptz-simulator ↗
- Licence
- MIT
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 1
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
Implement a reference-conformant PTZ camera control interface (VISCA over serial or IP, ONVIF Profile S/T PTZ, or another PTZ protocol) that interoperates with real cameras, VMS and controllers: choose the protocol, implement framing and operations exactly per the standard, and validate the result against the ptzsim reference simulator. Use this skill when a project needs to expose or consume a camera interface for pan/tilt/zoom/presets and the wire behaviour must match the standard.
Original author description
Implement a reference-conformant PTZ camera control interface (VISCA over serial or IP, ONVIF Profile S/T PTZ, or another PTZ protocol) that interoperates with real cameras, VMS and controllers: choose the protocol, implement framing and operations exactly per the standard, and validate the result against the ptzsim reference simulator. Use this skill when a project needs to expose or consume a camera interface for pan/tilt/zoom/presets and the wire behaviour must match the standard.
How it works
- Workflow
- Skill map
- Ground rules
SKILL.md preview
---
name: ptz-reference-interface
description: "Implement a reference-conformant PTZ camera control interface (VISCA over serial or IP, ONVIF Profile S/T PTZ, or another PTZ protocol) that interoperates with real cameras, VMS and controllers: choose the protocol, implement framing and operations exactly per the standard, and validate the result against the ptzsim reference simulator. Use this skill when a project needs to expose or consume a camera interface for pan/tilt/zoom/presets and the wire behaviour must match the standard."
license: MIT
compatibility: No runtime requirements. The bundled conformance scripts and the ptzsim reference simulator need only Python 3.8+ (standard library).
metadata:
author: stritti
version: "1.0.0"
source: https://github.com/stritti/ptz-simulator
---
<!--
SPDX-FileCopyrightText: 2026 Stephan Strittmatter
SPDX-License-Identifier: MIT
-->
# Reference-conformant PTZ camera interface
Goal: an interface for pan/tilt/zoom/focus/presets whose **wire behaviour matches the
published standard**, so real clients and real cameras accept it. "Reference-conformant"
here means: byte-exact framing and reply codes (VISCA) or SOAP operations, coordinate
spaces, fault chains and discovery/auth behaviour (ONVIF), validated against a reference
implementation — the [ptzsim](https://github.com/stritti/ptz-simulator) simulator, which
implements VISCA (serial, TCP, UDP, Sony VISCA over IP), ONVIF (Device/Media/PTZ,
WS-Discovery, WS-Security), Pelco-D (serial RS-485, since ptzsim 0.4.0) and NDI PTZ
(XML metadata on the NDI stream, optional `ndi` extra) strictly per the standards.
## Workflow
1. **Choose the protocol** — see [references/protocol-selection.md](references/protocol-selection.md)
(comparison matrix, default ports, selection guide, official specification links).
- VISCA (Sony) for broadcast/hardware controllers → skill `visca-interface`
- ONVIF Profile S/T for VMS/surveillance integrations → skill `onvif-ptz-interface`
- Pelco-D over RS-485 for legacy surveillance cabling → skill `pelco-d-interface`
- NDI PTZ metadata for pure NDI workflows (Studio Monitor, vMix, OBS) → skill `ndi-ptz-interface`
2. **Implement** the interface with the matching protocol skill. Keep parsing strictly
separated from I/O so every message handler is unit-testable without sockets.
Be strict where the standard is strict (framing, checksums, error codes, ranges);
document deliberate deviations.
3. **Validate** with skill `ptz-conformance-testing`:
- camera-side implementation (your code exposes the interface): run the bundled
`visca_conformance.py` / `onvif_conformance.py` scripts against your endpoint;
- client-side implementation (your code drives a camera): point your client at a
running ptzsim and compare behaviour.
4. **Document** supported operations, limits and deviations in the project README.
## Skill map
| Skill | Use when |
|---|---|
| `visca-interface` | Implement/validate a VISCA endpoint or client (RS-232/422, VISCA over IP UDP 52381) |
| `onvif-ptz-interface` | Implement/validate an ONVIF Profile S/T PTZ service (SOAP, WS-Discovery, WS-Security) |
| `pelco-d-interface` | Implement/validate a Pelco-D serial endpoint or client (RS-485, 7-byte frames + checksum) |
| `ndi-ptz-interface` | Implement/validate NDI PTZ (ndi_capabilities + ntk_ptz_* XML metadata on the NDI stream) |
| `ptz-conformance-testing` | Test any camera interface against the ptzsim reference simulator + checklists |
## Ground rules
- Match the standard exactly on the wire; do not be lenient where the spec is strict.
- Answer errors the way the standard defines them (VISCA error replies, ONVIF SOAP faults).
- Keep every command observable (log or expose it) so integrations can be debugged.
- Test over real sockets end to end, not only with parsed fixtures.
Files in this package (2)
- SKILL.md 4 KB
- references/protocol-selection.md 3 KB
Versions
The database has no other skills named ptz-reference-interface.
Database snapshot: 13.11.2026 · package version 4440be60603b (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100ptz-conformance-testing
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… - 100onvif-ptz-interface
Implement an ONVIF Profile S/T conformant PTZ service (SOAP 1.2 over HTTP): Device, Media and PTZ services with their operations, WS-Discovery on UDP 3702, HTTP digest and WS-Security UsernameToken (PasswordDigest) authentication, generic pan/tilt/zoom coordinate spaces (-1..1 /… - 100ptz-docs
Search and fetch docs for PTZ camera control protocols: Sony VISCA (Command List v2.00, BRC-H900, SRG-300H, PTZOptics VISCA over IP) — byte-level serial or UDP:52381 with payload-wrapped VISCA, and ONVIF (onvif.org profiles — S streaming deprecated, T successor with… - 100ptz-visca
Control PTZ cameras with Sony VISCA protocol (RS-232/485 serial 9600/38400 8N1, or UDP:52381 with 8-byte payload header): pan/tilt/zoom/focus/exposure/WB commands, libvisca + libvisca-ip, python-visca, pyvisca, pysca, visca-over-ip. Supported cameras: Sony (BRC/SRG/FR7/FCB… - 98ezviz-open-ptz-control
萤石开放平台云台设备控制技能。支持设备列表查询、设备状态查询、云台控制 (PTZ)、预置点管理等功能。 Use when: 需要控制萤石云台设备、调整摄像头角度、设置预置点。 ⚠️ 安全要求:必须设置 EZVIZ_APP_KEY 和 EZVIZ_APP_SECRET 环境变量,使用最小权限凭证。 - 100cameras
Use this skill when working with cameras in Phaser 4. Covers camera effects (shake, fade, flash, pan, zoom), following sprites, scroll, bounds, viewports, multiple cameras, and minimap. Triggers on: camera, viewport, scroll, zoom, follow, shake, fade.