Releases · bitfocus/companion-module-ptzoptics-visca

What's Changed

This is a fresh release for a single, large change:

VISCA command representation and processing has been extensively rewritten by @jswalden in #33
- VISCA commands are now represented in a structured format defining their contents, embedded parameters and their handling, and expected responses and their embedded parameters.
- VISCA responses to commands by the camera are no longer silently dropped but instead are compared against each command's expected response format.
- "Learn" support has been added to the "Exposure Mode" and "Focus Mode" actions as proof-of-concept of response processing.
- The "Custom command" action now supports user-filled numeric parameters and can require specific camera responses (beyond the normal ACK and Completion).

This release is a major-version bump:

The command/processing rewrite is sufficiently complicated to warrant one (even if in principle there's no observable difference).
The "Custom command" changes impute ACK + Completion return semantics to all existing custom commands. This will break existing custom commands for which a different reply is expected. You must manually adjust the expected response for all "Custom command" actions that don't expect an ACK + Completion response.

Camera assumptions

This release makes certain new assumptions about cameras:

All VISCA commands sent by this module (other than custom commands) must receive in response either ACK followed by Completion, or a non-ACK single-message return in case of error (which will be logged in Companion's logs).
The two VISCA inquiries sent by this release for "Exposure Mode" and "Focus Mode" learning must be interpreted consistent with PTZOptics VISCA over IP documentation for those modes of operation to work correctly.

Your mileage may vary if you use this module with a non-PTZOptics camera that doesn't comply with these assumptions. (You may be able to work around these concerns by using the "Custom command" action and specifying in precise detail your camera's command and its characteristics.)

Full Changelog: v2.1.0...v3.0.0-rc1