Difference between revisions of "IVS Wiki:Configuring a Privacy Switch"

From IVS Wiki
Jump to: navigation, search
(19 intermediate revisions by the same user not shown)
Line 55: Line 55:
 
<ol>
 
<ol>
 
<li>Pan/Tilt/Zoom your camera to the desired angle.</li>
 
<li>Pan/Tilt/Zoom your camera to the desired angle.</li>
<li>Go to <b>PTZ</b> &#x2192; <b>Preset Positions</b>.</li>
+
<li>Go to {{img - tooltip | text = <b>PTZ</b> &#x2192; <b>Preset Positions</b> | file = Privacy rules 12x 05.png}}.</li>
 
{{hr - 2}}
 
{{hr - 2}}
 
<li>Select <b>Preset Positions</b> &#x2192; <b>Create preset position</b>.</li>
 
<li>Select <b>Preset Positions</b> &#x2192; <b>Create preset position</b>.</li>
Line 83: Line 83:
 
While your camera is in the Privacy Position:
 
While your camera is in the Privacy Position:
 
<ol>
 
<ol>
<li><b>Video</b> &#x2192; <b>Privacy Masks</b> &#x2192; <b>Hit the plus (+) button)</b> to add a Mask.</li>
+
<li>{{img - tooltip | text = <b>Video</b> &#x2192; <b>Privacy Masks</b> | file = Privacy rules 12x 03.png}} &#x2192; <b>Hit the plus (+) button</b> to add a Mask.</li>
 
<li>Have the mask cover the entire view.</li>
 
<li>Have the mask cover the entire view.</li>
 
<li>Name the mask <b>Privacy</b>.</li>
 
<li>Name the mask <b>Privacy</b>.</li>
Line 95: Line 95:
 
{{Manual lvl 2 | title = Add Recipients | content =  
 
{{Manual lvl 2 | title = Add Recipients | content =  
 
<ol>
 
<ol>
<li>Go to <b>System</b> &#x2192; <b>Events</b> &#x2192; <b>Recipients</b>.</li>
+
<li>Go to {{img - tooltip | text = <b>System</b> &#x2192; <b>Events</b> | file = Privacy rules 12x 04.png}} &#x2192; <b>Recipients</b>.</li>
 
<li>Select <b>Add Recipient</b>.</li>
 
<li>Select <b>Add Recipient</b>.</li>
 
<li>In the <b>Name</b> field, enter the name of the camera.</li>
 
<li>In the <b>Name</b> field, enter the name of the camera.</li>
Line 105: Line 105:
 
{{Aside - Warning | hue = 50 | content = <b>Repeat this process</b> on all cameras in the room that the privacy switch would be activating.}}
 
{{Aside - Warning | hue = 50 | content = <b>Repeat this process</b> on all cameras in the room that the privacy switch would be activating.}}
 
}}
 
}}
 
  
 
{{Manual lvl 3 | title = Remote PTZ Recipient | content =  
 
{{Manual lvl 3 | title = Remote PTZ Recipient | content =  
 
For remote PTZ cameras, separate PTZ Control recipients need to be made alongside the standard recipient of the form:  
 
For remote PTZ cameras, separate PTZ Control recipients need to be made alongside the standard recipient of the form:  
 
:<pre>http://CAMERA_IP/axis-cgi/com/ptz.cgi</pre>
 
:<pre>http://CAMERA_IP/axis-cgi/com/ptz.cgi</pre>
 +
{{Section - Expand | title = Image Example | color = #f6c62a | content = <center>{{img - resize | file  = Privacy rules 12x 00.png | width = 504px}}</center> }}
 
<ol>
 
<ol>
 
<li>Enter in the corresponding Username and Password for the recipient camera.</li>
 
<li>Enter in the corresponding Username and Password for the recipient camera.</li>
Line 123: Line 123:
 
{{Manual lvl 2 | title = Privacy Off | content =  
 
{{Manual lvl 2 | title = Privacy Off | content =  
 
<ol>
 
<ol>
   <li>Go to <b>System</b> &#x2192; <b>Events</b> &#x2192; <b>Rules</b>.</li>
+
   <li>Go to {{img - tooltip | text = <b>System</b> &#x2192; <b>Events</b> | file = Privacy rules 12x 04.png}} &#x2192; <b>Rules</b>.</li>
 
   <li>Select <b>Add a rule</b>.</li>
 
   <li>Select <b>Add a rule</b>.</li>
 
   <li>Set <b>Name</b> to <b>Privacy Off</b>.</li>
 
   <li>Set <b>Name</b> to <b>Privacy Off</b>.</li>
Line 167: Line 167:
 
   </tr>
 
   </tr>
 
</table>
 
</table>
 +
{{Section - Expand | title = Image Example | color = #f6c62a | content = <center>{{img - resize | file  = Privacy rules 12x 01.png | width = 504px }}</center> }}
 +
The completed suffix should be <em>(ignore word wrapping)</em>:
 +
<pre>
 +
action=update&Image.I0.Overlay.MaskWindows.M0.Enabled=no& AudioSource.A0.InputGain=0&PTZ.Various.V1.PanEnabled=true& PTZ.Various.V1.TiltEnabled=true&TZ.Various.V1.ZoomEnabled=true
 +
</pre>
 +
{{Aside - Warning | hue = 50 | content = Set AudioSource.A0.InputGain to the amount of gain necessary for the room. For example, if you gain would normally be set to 15 dB, you want to use the name/value pair to be AudioSource.A0.InputGan=15.}}
 +
}}
  
 +
{{hr - 2}}
  
The completed suffix should be (ignore word wrapping):  
+
{{Manual lvl 2 | title = Privacy On | content =
 +
<ol>
 +
  <li>Go to {{img - tooltip | text = <b>System</b> &#x2192; <b>Events</b> | file = Privacy rules 12x 04.png}} &#x2192; <b>Rules</b>.</li>
 +
  <li>Select <b>Add a rule</b>.</li>
 +
  <li>Set <b>Name</b> to <b>Privacy On</b>.</li>
 +
  <li>Set <b>Condition</b> to <b>Digital input is active</b> or <b>I/O &#x2192; Digital input</b>. <em>(Firmware Dependent)</em></li>
 +
  <li>In the <b>Port</b> section, select the port the privacy switch trigger is connected to <em>(white wire)</em>.</li>
 +
  <li>Set <b>Action</b> to <b>Send notification through HTTP</b>.</li>
 +
  <li>Set the Recipient.</li>
 +
  <li>The <b>Query string suffix</b> will be of the form <code>name=value</code> for each parameter <b>name</b> and <b>value</b>, with an ampersand (&) between each name/value pair.</li>
 +
</ol>
 +
The suffix should be composed of the following pairs:
 +
<table class="wikitable" style="width:100%">
 +
  <tr>
 +
    <th>Name</th>
 +
    <th>Value</th>
 +
  </tr>
 +
  <tr>
 +
    <td>action</td>
 +
    <td>update</td>
 +
  </tr>
 +
  <tr>
 +
    <td>Image.I0.Overlay.MaskWindows.M0.Enabled</td>
 +
    <td>yes</td>
 +
  </tr>
 +
  <tr>
 +
    <td>AudioSource.A0.InputGain</td>
 +
    <td>mute</td>
 +
  </tr>
 +
  <tr>
 +
    <td>PTZ.Various.V1.PanEnabled</td>
 +
    <td>false</td>
 +
  </tr>
 +
  <tr>
 +
    <td>PTZ.Various.V1.TiltEnabled</td>
 +
    <td>false</td>
 +
  </tr>
 +
  <tr>
 +
    <td>PTZ.Various.V1.ZoomEnabled</td>
 +
    <td>false</td>
 +
  </tr>
 +
</table>
 +
{{Section - Expand | title = Image Example | color = #f6c62a | content = <center>{{img - resize | file  = Privacy rules 12x 02.png | width = 504px }}</center> }}
 +
The completed suffix should be <em>(ignore word wrapping)</em>:  
 
<pre>
 
<pre>
action=update&Image.I0.Overlay.MaskWindows.M0.Enabled=no& AudioSource.A0.InputGain=0&PTZ.Various.V1.PanEnabled=true& PTZ.Various.V1.TiltEnabled=true&TZ.Various.V1.ZoomEnabled=true
+
action=update&Image.I0.Overlay.MaskWindows.M0.Enabled=yes& AudioSource.A0.InputGain=mute&PTZ.Various.V1.PanEnabled=false& PTZ.Various.V1.TiltEnabled=false&PTZ.Various.V1.ZoomEnabled=false
 
</pre>
 
</pre>
 
}}
 
}}
{{Manual lvl 2 | title = Privacy On| content = }}
 
  
 
{{hr - 2}}
 
{{hr - 2}}
  
{{Manual lvl 2 | title = LED Toggle | content = }}
+
{{Manual lvl 2 | title = LED Toggle | content =  
 +
On the <b>Host Camera</b>:
 +
<ol>
 +
  <li>Go to {{img - tooltip | text = <b>System</b> &#x2192; <b>Events</b> | file = Privacy rules 12x 04.png}} &#x2192; <b>Rules</b>.</li>
 +
  <li>Select <b>Add a rule</b>.</li>
 +
  <li>Set <b>Name</b> to <b>LED Toggle</b>.</li>
 +
  <li>Set <b>Condition</b> to <b>Digital input is active</b> or <b>I/O &#x2192; Digital input</b>. <em>(Firmware Dependent)</em></li>
 +
  <li>In the <b>Port</b> section, select the port the privacy switch trigger is connected to <em>(white wire)</em>.</li>
 +
  <li>Set <b>Action</b> to <b>Toggle I/O while the rule is active</b>.</li>
 +
  <li>Set the <b>Action Port</b> to the port the privacy switch LED is connected to <em>(black wire)</em>.</li>
 +
  <li>Set the <b>Action State</b> to <b>Active</b>.</li>
 +
</ol>
 +
}}
  
 
{{hr - 2}}
 
{{hr - 2}}
  
{{Manual lvl 2 | title = PTZ Rules | content = }}
+
{{Manual lvl 2 | title = PTZ Rules | content = The following rules will be used to move the camera to a privacy location with privacy is enabled, and then move to a home location once the privacy is disabled.}}
 +
 
 +
{{Manual lvl 3 | title = PTZ Privacy | content =
 +
<ol>
 +
  <li>Go to {{img - tooltip | text = <b>System</b> &#x2192; <b>Events</b> | file = Privacy rules 12x 04.png}} &#x2192; <b>Rules</b>.</li>
 +
  <li>Select <b>Add a rule</b>.</li>
 +
  <li>Set <b>Name</b> to the camera name with <b>PTZ Privacy Position</b>.</li>
 +
  <li>Set <b>Condition</b> to <b>Digital input is active</b> or <b>I/O &#x2192; Digital input</b>. <em>(Firmware Dependent)</em></li>
 +
  <li>In the <b>Port</b> section, select the port the privacy switch trigger is connected to <em>(white wire)</em>.</li>
 +
  <li>Set <b>Action</b> to <b>Send notification through HTTP</b>.</li>
 +
  <li>Set the <b>Recipient</b> to be the proper <b>PTZ Controls Recipient</b>.</li>
 +
  <li>The <b>Query string suffix</b> should be: <code>gotoserverpresetname=Privacy</code></li>
 +
</ol>
 +
}}
 +
 
 +
 
 +
{{Manual lvl 3 | title = PTZ Home | content =
 +
<ol>
 +
  <li>Go to {{img - tooltip | text = <b>System</b> &#x2192; <b>Events</b> | file = Privacy rules 12x 04.png}} &#x2192; <b>Rules</b>.</li>
 +
  <li>Select <b>Add a rule</b>.</li>
 +
  <li>Set <b>Name</b> to the camera name with <b>PTZ Home Position</b>.</li>
 +
  <li>Set <b>Condition</b> to <b>Digital input is active</b> or <b>I/O &#x2192; Digital input</b>. <em>(Firmware Dependent)</em></li>
 +
  <li>Check the box <b>Invert this condition</b>.</li>
 +
  <li>In the <b>Port</b> section, select the port the privacy switch trigger is connected to <em>(white wire)</em>.</li>
 +
  <li>Set <b>Action</b> to <b>Send notification through HTTP</b>.</li>
 +
  <li>Set the <b>Recipient</b> to be the proper <b>PTZ Controls Recipient</b>.</li>
 +
  <li>The <b>Query string suffix</b> should be: <code>gotoserverpresetname=Home</code></li>
 +
</ol>
 +
}}
  
{{Manual lvl 3 | title = PTZ Privacy | content = }}
+
{{hr}}
  
+
<h1>Quick Notes</h1>
{{Manual lvl 3 | title = PTZ Home | content = }}
+
{{Manual lvl 2 | title = | content = }}
 +
{{Manual lvl 2 | title = | content = }}
 
}}
 
}}

Revision as of 13:48, 1 April 2025

Prepare all Cameras

On each camera in the room:

  1. Set the I/O Ports
  2. Set the PTZ Presets
  3. Set the Privacy Mask


Set the I/O Ports

The Input/Output (I/O) ports will be wired to the Privacy Switch. These are used to determine which mode the camera should be in and outputs power to the Privacy Switch to light up the LED.


  1. Go to SystemAccessories.
  2. Ensure that Ports 1 & 3 are set as Input and 2 & 4 are set as Output.
  3. Port 1 Input Port 2 Output
    Port 3 Input Port 4 Output

Some cameras will only have ports 1 & 2.


Set the PTZ Presets

If there are any PTZ cameras in the room, you will need to set the preset positions on those cameras. These locations will help drive the camera to its Privacy Position and Home Position.


  1. Pan/Tilt/Zoom your camera to the desired angle.
  2. Go to PTZPreset PositionsPrivacy rules 12x 05.png🖼️.

  3. Select Preset PositionsCreate preset position.
    1. Home Position
      • Set a typical angle that would capture the room normally.
      • The Home preset may already exist. If this is the case, hit the Edit button on the existing Home preset instead of creating a new preset.

      • In the Name field enter Home.
    2. Privacy Position
      • Typically, this involves having the PTZ face the wall.
      • The exact position does not matter for functionality, but having the camera visibly face the wall can help to ensure visual privacy even if the mask is off.

      • In the Name field enter Privacy.

Set the Privacy Mask

The Privacy Mask will be used to block the view


While your camera is in the Privacy Position:

  1. VideoPrivacy MasksPrivacy rules 12x 03.png🖼️Hit the plus (+) button to add a Mask.
  2. Have the mask cover the entire view.
  3. Name the mask Privacy.
  4. Make sure this is the first/only mask!


Add Recipients

Add Recipients

  1. Go to SystemEventsPrivacy rules 12x 04.png🖼️Recipients.
  2. Select Add Recipient.
  3. In the Name field, enter the name of the camera.
  4. It is common to use "Self" for the main camera.
  5. In the Type field, select HTTP.
  6. The URL of the recipient will be in the form:
    http://CAMERA_IP/axis-cgi/param.cgi 

Repeat this process on all cameras in the room that the privacy switch would be activating.

Remote PTZ Recipient

For remote PTZ cameras, separate PTZ Control recipients need to be made alongside the standard recipient of the form:

http://CAMERA_IP/axis-cgi/com/ptz.cgi
Image Example

Privacy rules 12x 00.png

  1. Enter in the corresponding Username and Password for the recipient camera.
  2. Hit the Test button.
  3. If the camera responds that everything is okay, hit the Save button to save your recipient.
  4. Repeat this process on all PTZ cameras in the room that the privacy switch would be activating.


Add Privacy Event Rules

Privacy Off

  1. Go to SystemEventsPrivacy rules 12x 04.png🖼️Rules.
  2. Select Add a rule.
  3. Set Name to Privacy Off.
  4. Set Condition to Digital input is active or I/O → Digital input. (Firmware Dependent)
  5. In the Port section, select the port the privacy switch trigger is connected to (white wire).
  6. Set Action to Send notification through HTTP.
  7. Set the Recipient.
  8. The Query string suffix will be of the form name=value for each parameter name and value, with an ampersand (&) between each name/value pair.

The suffix should be composed of the following pairs:

Name Value
action update
Image.I0.Overlay.MaskWindows.M0.Enabled no
AudioSource.A0.InputGain 0
PTZ.Various.V1.PanEnabled true
PTZ.Various.V1.TiltEnabled true
PTZ.Various.V1.ZoomEnabled true
autofocus on
Image Example

Privacy rules 12x 01.png

The completed suffix should be (ignore word wrapping):

action=update&Image.I0.Overlay.MaskWindows.M0.Enabled=no& AudioSource.A0.InputGain=0&PTZ.Various.V1.PanEnabled=true& PTZ.Various.V1.TiltEnabled=true&TZ.Various.V1.ZoomEnabled=true 

Set AudioSource.A0.InputGain to the amount of gain necessary for the room. For example, if you gain would normally be set to 15 dB, you want to use the name/value pair to be AudioSource.A0.InputGan=15.


Privacy On

  1. Go to SystemEventsPrivacy rules 12x 04.png🖼️Rules.
  2. Select Add a rule.
  3. Set Name to Privacy On.
  4. Set Condition to Digital input is active or I/O → Digital input. (Firmware Dependent)
  5. In the Port section, select the port the privacy switch trigger is connected to (white wire).
  6. Set Action to Send notification through HTTP.
  7. Set the Recipient.
  8. The Query string suffix will be of the form name=value for each parameter name and value, with an ampersand (&) between each name/value pair.

The suffix should be composed of the following pairs:

Name Value
action update
Image.I0.Overlay.MaskWindows.M0.Enabled yes
AudioSource.A0.InputGain mute
PTZ.Various.V1.PanEnabled false
PTZ.Various.V1.TiltEnabled false
PTZ.Various.V1.ZoomEnabled false
Image Example

Privacy rules 12x 02.png

The completed suffix should be (ignore word wrapping):

action=update&Image.I0.Overlay.MaskWindows.M0.Enabled=yes& AudioSource.A0.InputGain=mute&PTZ.Various.V1.PanEnabled=false& PTZ.Various.V1.TiltEnabled=false&PTZ.Various.V1.ZoomEnabled=false

LED Toggle

On the Host Camera:

  1. Go to SystemEventsPrivacy rules 12x 04.png🖼️Rules.
  2. Select Add a rule.
  3. Set Name to LED Toggle.
  4. Set Condition to Digital input is active or I/O → Digital input. (Firmware Dependent)
  5. In the Port section, select the port the privacy switch trigger is connected to (white wire).
  6. Set Action to Toggle I/O while the rule is active.
  7. Set the Action Port to the port the privacy switch LED is connected to (black wire).
  8. Set the Action State to Active.

PTZ Rules

The following rules will be used to move the camera to a privacy location with privacy is enabled, and then move to a home location once the privacy is disabled.

PTZ Privacy

  1. Go to SystemEventsPrivacy rules 12x 04.png🖼️Rules.
  2. Select Add a rule.
  3. Set Name to the camera name with PTZ Privacy Position.
  4. Set Condition to Digital input is active or I/O → Digital input. (Firmware Dependent)
  5. In the Port section, select the port the privacy switch trigger is connected to (white wire).
  6. Set Action to Send notification through HTTP.
  7. Set the Recipient to be the proper PTZ Controls Recipient.
  8. The Query string suffix should be: gotoserverpresetname=Privacy


PTZ Home

  1. Go to SystemEventsPrivacy rules 12x 04.png🖼️Rules.
  2. Select Add a rule.
  3. Set Name to the camera name with PTZ Home Position.
  4. Set Condition to Digital input is active or I/O → Digital input. (Firmware Dependent)
  5. Check the box Invert this condition.
  6. In the Port section, select the port the privacy switch trigger is connected to (white wire).
  7. Set Action to Send notification through HTTP.
  8. Set the Recipient to be the proper PTZ Controls Recipient.
  9. The Query string suffix should be: gotoserverpresetname=Home

Quick Notes