Skip to content
Skills Library
Programming · Building & coding

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.

Licence
MIT
Last repository change
12.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
1
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Workflow
  2. Skill map
  3. Ground rules
Original SKILL.md headings · 53 lines, 400 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.