OpenITS
Docs Schema registry AsyncAPI
Search the docs /
GitHub
Docs/Model reference/cctv
Illustrative excerpt from openits-cctv.yang. The full model is the normative source. View source ↗

cctv

CORE · WIRED

CCTV / PTZ cameras: pan, tilt and zoom position with presets and tours, stream and encoder status, enclosure environment, and control-authority arbitration.

Namespace
urn:openits:yang:cctv
Latest revision
2026-07-21
Reference std
NTCIP 1205
Event types
6

Data model

The configuration and state tree. Safety constraints are expressed as YANG must and validated at every boundary.

container camera {
container config { uses device-identity; } // id, location, mounting
container state {
config false;
leaf operational-status { type operational-status; } // online|degraded|offline
}
container ptz {
container config { // commanded pan/tilt/zoom, arbitrated under the control holder
leaf pan-degrees { type decimal64; }
leaf tilt-degrees { type decimal64; }
leaf zoom-percent { type uint8; units "percent"; }
}
container state { config false; } // readback: actual position + move-mode
container presets { list preset { key "preset-id"; } }
container tours { list tour { key "tour-id"; } } // recall/run + state
}
container streams { list stream {
key "stream-id";
leaf uri { type inet:uri; } // out-of-band encoder endpoint, not the video
} }
container control { // joystick-ownership arbitration
leaf control-mode { type control-mode; } // local|remote|maintenance
leaf current-holder { config false; } // last-writer-wins; loser gets lockout-denied
}
}

Notifications & events

Each event is its own typed notification with its own ce-type. Consumers filter by subject before parsing.

Event
ce-type
Family
fault-cleared
openits.cctv.fault-cleared.v1
fault
fault-raised
openits.cctv.fault-raised.v1
fault
lockout-denied
openits.cctv.lockout-denied.v1
lockout
mode-changed
openits.cctv.mode-changed.v1
mode
ptz-preset-recalled
openits.cctv.ptz-preset-recalled.v1
ptz
tour-state-changed
openits.cctv.tour-state-changed.v1
tour
Event families: fault lockout mode ptz tour

Subject & bindings

# canonical subject (reference CloudEvents binding)
openits.us-tx.txdot.d07.cctv.i35-exit-214.fault-cleared
Open in AsyncAPI ↗ Protobuf shapes

Schema registry

Every revision is immutable and content-addressed. Cite the exact date in ce-dataschema; there is no latest alias.

2026-07-21CURRENT
schema.proto · module.yang ↗
2026-07-17
schema.proto · module.yang ↗
← Previous
reversible-lane
Next →
Model reference index