Sony

Sony PTZ Camera Module

A module for controlling Sony PTZ Cameras via HTTP.

Supported Devices

• BRC-AM7
• SRG-A40
• SRG-A12
• ILME-FR7

Getting Started

Add the connection and enter the camera's details:

• Target IP — IP address of the Sony PTZ camera.
• Target Port — HTTP port the camera listens on (default: 80).
• User / Password — HTTP digest authentication credentials configured on the camera.
• Referer — Send a Referer header with each request. Leave enabled unless you have modified the "Referer Check" settings on your camera.
• Status Check — Periodically poll the camera for status updates used by feedbacks and variables.
• Status Check Interval — How often to poll, in milliseconds (default: 10000).

Actions

• System Power
  • On
  • Standby
• Auto Framing
  • On
  • Off
  • Pause On
  • Pause Off
  • Restart (Off and On)
• Auto Framing Shot Mode
  • Closer Close Up
  • Close Up
  • Waist
  • Full Body
• Framing Mode
  • Person
  • Ball Sports
• Lead Room
  • Off
  • Low
  • Middle
  • High
• Real-time Overlay (Frame/Area Indicator)
  • On
  • Off
• Auto Framing Tracking Speed *BRC-AM7 only
  • Axis (Pan/Tilt/Zoom), Value (1-5)
• Auto Framing Tracking Sensitivity *BRC-AM7 only
  • Axis (Pan/Tilt/Zoom), Value (0-5)
• Fixed Angle Position *SRG only
  • Off
  • On
  • Store Current Position
  • Recall Position
• Fixed Angle Fine Adjust *SRG only
  • Adjust the stored fixed angle
• Scene File Recall *BRC-AM7 only
  • Off (0)
  • Scene File Number (1-16)
• Auto Framing Start Position
  • Move (Recall)
  • Decide (Set)
• Preset Call
  • Look Back
  • PTZ Home (Center Position)
  • Custom Number / Variable (any preset number, supports variables)
  • Preset Number (1-10)
• Preset Set
  • Preset Number (1-10)
  • Custom Number / Variable (any preset number, supports variables)
• Number of Multi-Person Tracking Target
  • 1 (Off)
  • 2-8 (On)
• Multi-Person Tracking Wait Time
  • 0 (Wait Forever)
  • 1-60 (Seconds)
• Pan Tilt
  • Up
  • Down
  • Left
  • Right
  • Up-Left
  • Up-Right
  • Down-Left
  • Down-Right
• Zoom
  • Tele
  • Wide
• Stop Pan Tilt Zoom
  • Pan/Tilt
  • Wide/Tele
• Auto Focus
  • On/Off
  • Mode (Normal/Interval/Zoom Trigger) *SRG only
  • Sensitivity (Normal/Low) *SRG only
• White Balance Mode
  • Auto/Indoor/Outdoor/One Push WB/ATW/Manual
• White Balance Blue (Cb) Gain
  • Value (0-255)
• White Balance Red (Cr) Gain
  • Value (0-255)
• Image Stabilizer
  • On/Off
• Tally Control
  • On/Off
• Absolute Focus *SRG only
• Absolute Zoom *SRG only
• Absolute PTZF
• Absolute PanTilt
• Relative PanTilt *SRG only
• Other Command
  • Any Command Can Be Sent
• Discover Cameras
  • Broadcasts for Sony PTZ cameras and stores results in foundDevice variables
• Update Target IP via Variable
  • Sets the connection host from a variable and reconnects immediately

Presets

• System Power
• Auto Framing
• Framing Mode
• Shot Mode
• Lead Room
• Real-time Overlay
• Fixed Angle Position *SRG only
• Fixed Angle Fine Adjustment (Pan/Tilt/Zoom) *SRG only
• Multi-Person Tracking
• Auto Framing Tracking Speed *BRC-AM7 only
• Auto Framing Tracking Sensitivity *BRC-AM7 only
• Scene File Recall *BRC-AM7 only
• Pan/Tilt/Zoom
  • Down: Start
  • Up: Stop
• Preset Call
• Preset Set
• Focus Controls
  • Focus Mode
  • AF Mode *SRG only
  • Sensitivity *SRG only
• Imaging
  • White Balance Mode
  • White Balance Gain (Blue/Red current readout + rotary nudge)
  • Image Stabilizer
• Tally
  • Control (On/Off)
  • Red Tally Status indicator
• Rotary Button
  • Pan
  • Tilt
  • Zoom
  • Gain
  • Iris
  • ND Variable *BRC-AM7 only
  • Master Black *BRC-AM7 only

Model-specific presets are filtered to the connected camera once its model is known. When the camera is offline or its model is unrecognized, all presets are shown.

Feedbacks

• System Power (On/Standby)
• Auto Framing (On/Off)
• Framing Mode (Person/Ball Sports)
• Shot Mode (Closer Close Up/Close Up/Waist/Full Body)
• Lead Room (Off/Low/Middle/High)
• Real-time Overlay / Frame-Area Indicator (On/Off)
• Fixed Angle Position Enabled (On/Off) *SRG only
• Scene File - Current Scene File (matches value) *BRC-AM7 only
• Auto Framing Tracking Status (Idle/Missing/Preparing/Searching/Tracking/Waiting/Fixed Angle)
• Auto Framing Tracking Speed (matches value) *BRC-AM7 only
• Auto Framing Tracking Sensitivity (matches value) *BRC-AM7 only
• Multi-Person Tracking Targets (matches value)
• Focus Mode (Auto/Manual)
• Auto Focus Mode (Normal/Interval/Zoom Trigger) *SRG only
• Auto Focus Sensitivity (Normal/Low) *SRG only
• White Balance Mode (Auto/Indoor/Outdoor/One Push WB/ATW/Manual)
• Image Stabilizer (On/Off)
• Tally Control (On/Off)
• Red Tally Status (On/Off)

Variables

• $(this:autoFraming) - Auto Framing Status
• $(this:trackingStatus) - Auto Framing Tracking Status (Idle/Missing/Preparing/Searching/Tracking/Waiting/Fixed Angle)
• $(this:framingMode) - Framing Mode (Person/Ball Sports)
• $(this:shotMode) - Auto Framing Shot Mode (Closer Close Up/Close Up/Waist/Full Body)
• $(this:leadRoom) - Lead Room Level (Off/Low/Middle/High)
• $(this:realtimeOverlay) - Real-time Overlay (Frame/Area Indicator) State (On/Off)
• $(this:fixedAngle) - Fixed Angle Position Enabled (On/Off) *SRG only
• $(this:trackingSpeedPan) - Auto Framing Tracking Speed - Pan *BRC-AM7 only
• $(this:trackingSpeedTilt) - Auto Framing Tracking Speed - Tilt *BRC-AM7 only
• $(this:trackingSpeedZoom) - Auto Framing Tracking Speed - Zoom *BRC-AM7 only
• $(this:trackingSensitivityPan) - Auto Framing Tracking Sensitivity - Pan *BRC-AM7 only
• $(this:trackingSensitivityTilt) - Auto Framing Tracking Sensitivity - Tilt *BRC-AM7 only
• $(this:trackingSensitivityZoom) - Auto Framing Tracking Sensitivity - Zoom *BRC-AM7 only
• $(this:modelName) - Model Name
• $(this:multiTracking) - Multi-Person Tracking Status
• $(this:multiTrackingNum) - Multi Tracking Target Number
• $(this:name) - Camera Name
• $(this:power) - System Power State
• $(this:serial) - Serial Number
• $(this:softVersion) - Software Version
• $(this:streamMode) - Stream Mode
• $(this:zoomMode) - Zoom Mode
• $(this:panPos) - Current Pan Position
• $(this:tiltPos) - Current Tilt Position
• $(this:zoomPos) - Current Zoom Position
• $(this:focusPos) - Current Focus Position
• $(this:panRangeLeft) - Possible Left Movement Range of Pan
• $(this:panRangeRight) - Possible Right Movement Range of Pan
• $(this:tiltRangeLower) - Possible Lower Movement Range of Tilt
• $(this:tiltRangeUpper) - Possible Upper Movement Range of Tilt
• $(this:zoomRangeWide) - Possible Wide Movement Range of Zoom
• $(this:zoomRangeTele) - Possible Tele Movement Range of Zoom
• $(this:absoluteFocus) - Absolute Focus Value
• $(this:afSensitivity) - Auto Focus Sensitivity *SRG only
• $(this:autoFocusMode) - Auto Focus Mode (Normal/Interval/Zoom Trigger) *SRG only
• $(this:focusMode) - Focus Mode (Auto/Manual)
• $(this:exposureGain) - Exposure Gain Value
• $(this:exposureIris) - Exposure Iris Value
• $(this:exposureNDVariable) - Exposure ND Variable Value *BRC-AM7 only
• $(this:masterBlack) - Master Black Value *BRC-AM7 only
• $(this:whiteBalanceMode) - White Balance Mode (Auto/Indoor/Outdoor/One Push WB/ATW/Manual)
• $(this:whiteBalanceCbGain) - White Balance Blue (Cb) Gain Value
• $(this:whiteBalanceCrGain) - White Balance Red (Cr) Gain Value
• $(this:stabilizer) - Image Stabilizer State (On/Off)
• $(this:tallyControl) - Tally Control State (On/Off)
• $(this:rTallyStatus) - Red Tally Status (On/Off)
• $(this:currentSceneFile) - Current Scene File Number *BRC-AM7 only
• $(this:sceneFileName1) … $(this:sceneFileName16) - Scene File Names (Slots 1–16) *BRC-AM7 only
• $(this:foundDevice1) … $(this:foundDevice8) - IP addresses of cameras found by Discover Cameras

https://github.com/bitfocus/companion-module-sony-ptz/issues