Bitfocus Companion Quickstart
Bitfocus Companion Quickstart
A brief explanation on connecting the Seervision Suite to Bitfocus' Companion
Bitfocus’ Companion is an Open Source software that is finding its way into more and more studio environments and production workflows. Its main value lies in connecting more than 200+ distinct pieces of presentation switchers, broadcasting software and more. At Seervision, we use it in conjunction with the Elgato Stream Deck to make VMix overlays, PTZ presets and more available with the tap of a button.
Getting set up
- Launch Companion and navigate to the Connections tab.
- Add a new connection, and search for Seervision Suite. If you can’t find this connection, double-check to make sure you are using Companion V2.2 or later.
- In the newly created connection, add the IP of the Seervision server (the same IP you would also use to access the User Interface). If you like, give it a name that is easy to recognise, such as Seervision Server 1.
- Hit Save and that should be it, Companion and the Seervision Suite should now be connected!
What's next?
Through Companion, you are now able to recall containers, start or stop tracking and quite a bit more. To find out all the options that are available, either experiment in Companion, or better, just read our manual which has all the details!
Quickstart: What's next?
Quickstart: What's next?
Next steps after completing the quickstart
If you’ve completed the Quickstart and you’ve connected the SDI/NDI feed to the Seervision Server, it’s now time to start looking at our Seervision Server setup and configuration page!
SDI/NDI® and Seervision
SDI/NDI® and Seervision
Let's talk a bit more about hooking up a video feed to the Seervision Server
Seervision uses Computer Vision to steer the PTU that it’s controlling. In order to do that, unsurprisingly, we need a video feed from the PTU that we’re controlling. Below, we’ll try to answer some of the most common questions we get.
SDI: The Basics
In its simplest form, you take an SDI out of the PTU and directly plug it into SDI port(s) of the Seervision server.
Can I first route my SDI signal somewhere else, before feeding it to the Seervision server?
Yes, that works fine for us (we use it ourselves actually!).
Do you provide a loop-through or copy of the input SDI signal?
Our previous hardware revisions did, but our newest (starting September 2022) no longer provide an SDI loop out.
3G (FullHD) or 12G (4k)?
That’s up to you. We can do both, but you’ll have to tell us up front – the capture card our servers use is different depending on whether we need to capture a 3G or 12G signal.
NDI® Support
Seervision currently supports high bandwidth NDI® as well as NDI®|HX (V1 as well as V2) as an alternative to SDI. You can select the NDI® stream in the interface (see our manual for more information).
Note that we currently do not support NDI|HX V2 on Panasonic PTZs due to an implementation limitation. We hope to be able to fix this soon!
We also support consuming feeds from an NDI® Discovery Server or NDI® Bridge. As of July 2022, that is currently a manual process that needs to be done once by Seervision support, but we’re working on a feature enabling the end-user to add an NDI® Discovery Server via our interface!
Disclaimer: NDI® is a registered trademark of Vizrt Group.
Ross Robotic Head Quickstart
Ross Robotic Head Quickstart
Quickstart for the Ross heads supported by Seervision
This quickstart guide is aimed to help you get started in connecting a Ross robotic head to the Seervision Suite. Note that as of this writing, Seervision only supports the Ross Furio VR100 and VR600 robotic heads, as well as the CamBot 600XY.
Note: We actually suspect we support all Ross robotic heads that have tracking data output, but we haven’t been able to test these ourselves. If you have Ross hardware that has Tracking Data Output, we are happy to test this out with you!
We won’t be discussing the mounting, rigging and general setup of the robotic head, Ross Support usually handles these aspects. Below, we will only list the steps that must be taken in order for the Ross head to work with the Seervision Suite. This guide assumes that the Furio head is powered up and connected to the LAN.
Verifying the Furio Firmware
The first step is to access the Furio web interface and browsing to the Status & Logging tab. Under this tab, the Firmware Version should indicate a version equal or later than 5.3. If that is not the case, first update the firmware on this head – only the firmwares after 5.3 include the changes necessary to enable our tracking.
Enabling UDP tracking
The first step is to configure the Ross head to show additional tracking protocols in its web interface. This step will most likely have to be handled by your Ross representative, as it requires logging into the head over SSH.
- Log in to the head via SSH
- Modify the file under /home/vrone/Furio.properties
- Add in the line supervisor.showExtraTrackingProtocols=true
- You should see similar named lines around line 50 in this file
- Save and reboot. The Seer protocol should now be available in the Tracking tab in the web interface of the Ross robotic head
Configure UDP tracking
Once the Furio is on the correct firmware version and shows the additional tracking protocols, open the web interface again:
- Navigate to the Tracking tab
- Under the Protocol dropdown, select Seer as the protocol
- Under the Send IP column, configure at least one of the entries to point at the IP of the Seervision server that will be controlling this Furio head
- Make sure to tick the box next to the IP, and set the port to 10244
- You can leave the UART box unchecked
- Hit Save & Reboot
Set up lens control
All that’s left is to verify that the servo of the lens is connected to the Lens Drive port on the Furio head, usually via a 10- or 20-pin cable provided by your supplier.
Wrap-up
That’s it! The next steps would be to:
- Connect the camera SDI to the Seervision server, see SDI and Seervision
- Set up the Seervision server to correctly control the Furio head, see Seervision Server Setup
Seervision Pauli Quickstart
Seervision Pauli Quickstart
This article covers the basics of getting set up with a Seervision Pauli robotic head
This quickstart is aimed to get you started specifically with the Pauli robotic head, which is sold by Seervision. Due to its nature, the quickstart is kept brief on purpose. If you would like to have more technical detail, you can always access the Pauli PDF manual here. You can also find the tech specs of the Pauli head at the bottom of this page.
You will need to have our web interface open and ready to go – if you’re not certain how to get to it, read our manual’s Getting Started chapter first.
You’ll notice that there is quite some overlap between this Quickstart and the more generic Robotic Head Quickstart – this is intentional. This way, we make sure that both pages can stand on their own without the user needing to navigate back and forth.
Mounting the Pauli
The Pauli robotic head uses standard 3/8″ screws at the bottom of its base that are used for securely mounting it. The mounting options are standard, using a mounting plate or a ball mount. The Pauli can also be mounted upside-down, though this will need to be configured in the software after mounting.
Mounting a camera onto the Pauli
Before mounting the camera, make sure the Pauli is in its neutral position: the Seervision logo on the base of the Pauli, as well as the lens control connectors (PDMovie, Fujinon, Canon) should be pointing towards the same direction.
A mounting plate should have been provided together with the Pauli package. Mount this plate on the bottom of the camera you wish to mount, then slide the assembly into the plate-holder on the Pauli head.
Lastly, connect the SDI Out of the camera to one of the two SDI loop-throughs on the Pauli head. Both SDI1 and SDI2 are equivalent and are directly connected to the respective SDI1 and SDI2 connectors on the base of the Pauli. For powering the camera, connect its power supply to either the D-Tap or XLR power port on the Pauli head.
Lens control
Lens control (i.e. setting the zoom/focus/iris) on the Pauli can be done in two ways: either by using external lens motors (works with nearly all lenses, but is a bit more complicated) or using a digital lens protocol (only works for supported protocols, see below).
External Lens Motors (PDMovie Air motors)
Controlling the lens via external lens motors is very versatile and works with nearly all lenses, but the setup is a bit more complicated. We made a video about the process of “rigging” the PDMovies on a Pauli below.
Once you are done rigging the external lens motors as shown in the video, use the LEMO cables provided to connect them in series, and connect one of the motors to the PDMovie port on the Pauli head. With the Pauli powered on, initiate the lens motor calibration by holding the button at the bottom of the motor for 1-2 seconds. The calibration process can be interrupted anytime by a single press of the button.
Once the LEDs on the motors light up, verify that:
- The motor for the Zoom control has a red color that is not blinking
- The motor for the Focus control has a green color that is not blinking
- The motor for Iris control has a blue color that is not blinking
If one of the colors is not correct, press the button at the bottom of the motor twice in a row until the correct color shows. To stop the LEDs from blinking, press the bottom button five times until the lighting is constant.
Depending on the configuration, it may be that the lens motor is turning in the wrong direction. In other words, when you use the Seervision Suite to zoom in, the lens actually zooms out (idem for focus). In that case, just inverse the lens motor direction by pressing the bottom button seven times.
If you are running a Pauli V2 (all Paulis shipped after Q1 2021), verify in its web interface that the lens control is set to PDMOVIE. If you are running an older Pauli, these are configured by default to use the PD Movie protocol. In case you aren’t certain, just shoot us an email and we can check it out.
Digital Lens Protocol (Canon/Fujinon)
The Pauli robotic head also supports steering over digital lens protocols. It can be set up as follows:
- Make sure that the lens supports the digital protocol you want to use. This can be verified by looking up the lens specs, or contacting your Fujinon/Canon representative. If it does not support the protocol, this lens control won’t work, so make sure to double-check!
- Use a 10- or 20-pin connector to connect the EXT port of the servo to the Fujinon/Canon port of the Pauli head. These connectors are often provided by us on-demand, or by other suppliers
- Connect the servo power cable to the power port on the camera
- Make sure that all controls on the servo are set to S (for servo) and not M (for manual)
- If you are using a Pauli V2 (all Paulis shipped in Q1 2021 and later), set its lens control to Fujinon/Canon mode in the head’s web interface. You can access this web interface through your browser on the head’s IP and port 3000.
Wrap-up
At this stage, you should have a powered-up Pauli, with a camera, lens and lens actuation configured. The next steps are
- Connect the Pauli to LAN so that it can communicate with the Seervision server
- Route the SDI1 or SDI2 (depending on your choice) to the Seervision server (for more details on how we use SDI, see SDI and Seervision)
- Double-check that you have configured the correct lens protocol on the Pauli in its web interface on port 3000 (only for new Paulis).
- Configure the Seervision server to control this Pauli head (see Seervision Server Setup)
Pauli V2 (2021 and later) Technical Specifications
Camera payload | 20 kg |
Weight | 8.4 kg |
Dimensions | 434 x 276 x 144 mm |
Pan angle | ± 175° |
Tilt angle | ± 180° |
Pan speed | 0.001-180°/s |
Tilt speed | 0.001-180°/s |
Acceleration | 90 °/s² |
Presets | Preset play/run, preset array, maximum 100 points, preset in some axes and manual control in others possible |
Temperature operating range | -10° to 45° |
Power requirements | 100-240 VAC |
Connectors (audio, video) | 2 SDI coax pass-through |
Joystick | Any joystick with VISCA over IP; Skaarhoj configurable Joystick |
Connection | IP Ethernet |
Noise level | 40 dB |
Communication connectors | Ethernet with Ethernet switch in the head – 2 connectors in the base and 1 for the camera, all with locking mechanism |
Power output connectors | 12VDC, 60W D-tap and XLR |
Zoom, Focus, Iris control | Interface for Canon and Fujinon lenses, interface for PD Movie external lens motors; LANC & Panasonic analog |
Mounting | Standard tripod mount, reverse mount possible, 90° wall-mount with adapter possible |
Protection class | IP52 |
Shot Recall Repeatability | ±0.025° |
Pauli V1 (pre-2021) Technical Specifications
Parameter | Value |
Maximum payload |
Up to 7kg for full performance; up to 15kg with reduced performance |
Pan axis range |
±175 degrees (nominally limited in software to ± 90 degrees) |
Tilt axis range |
± 180 degrees (nominally limited in software to ± 20 degrees) |
Pan/tilt axis velocity range |
± 0 to 180 degrees/s |
Power supply (AC) |
100-240 Volts |
12V out connector (D-tap and XLR) |
12V DC power |
Weight |
6.5kg |
Operating temperature range |
-10 to +35 degrees Celsius |
Storage temperature range |
-20 to +60 degrees Celsius |
Ambient humidity |
10% to 90% non-condensing |
Protection class |
IP52 |
Robotic Head Quickstart
Robotic Head Quickstart
How to connect everything between a Seervision Server and a supported robotic head
This page will guide you through the setup of your robotic head.
There’s no mention of power cables on these pages, we’re going to assume that you already know how to connect those.
What you’ll need:
- A Seervision server
- A robotic head (for the list of integrations, see our integrations page). We also have dedicated pages for the Seervision Pauli head, and one for the Ross Furio heads.
- A camera and lens, as well as a way to control that lens
Getting set up:
- Power up and connect the robotic head to your LAN
- Power up and connect the Seervision server to your LAN
If you’ve got a robotic head that serves a configuration interface via the LAN, you should at this point be able to access it. That’s a good way to verify that you’ve connected everything correctly,
If you’re unclear on the network situation at this point, or how to communicate with the head, don’t worry, we’ll get to that on the Seervision Server Setup once you’re done with this Quickstart.
Lens Control for Robotic Heads
On robotic heads, lens control is usually handled by the robotic head itself. We just send zoom/focus/iris commands to the robotic head, which will then take care of translating and communicating with the lens itself.
There’s sometimes exceptions, but we list those on the page of the respective robotic heads in this knowledge base (here are quick links for the Seervision Pauli and Ross heads).
All done!
With this, your robotic head setup should be complete! The next thing you’ll want to do is hook up the SDI feed to the Seervision server, we go into more depth on that here: SDI and Seervision. If you’ve already handled that, then just directly go to the Seervision Server Setup page.
PTZ Quickstart (VISCA)
PTZ Quickstart (VISCA)
How to connect everything between a Seervision Server and a VISCA-controlled PTZ.
This page will guide you through getting set up with a PTZ that is controlled via the VISCA protocol.
In order to connect everything, you will need our interface up and running. If you are not sure on how to do that, see our Getting Started chapter first.
Preparing the PTZ
There are many different PTZs that can be controlled by the VISCA protocol, so setup may vary from model to model. We won’t go into detail for all of them, there’s only two requirements from our side:
- The PTZ accepts control over VISCA (for 99% of the PTZs, this is enabled by default)
- You know the IP of the PTZ (we will need this in order to communicate with it)
Connecting the Seervision server and the PTZ
To enable the Seervision server to control the PTZ, go into the Operations Server and create a new configuration.
- Give it a name that is easy to remember, this can be anything you like
- For the PTU, select the relevant PTU driver from the dropdown which corresponds to the model you wish to control. If the PTZ isn’t listed, contact Seervision and we will help you on your way.
- Under IP, add the IP of the PTZ
- Under Model and Lens, again select the names that are relevant for your model of PTZ
- Hit Save, then launch or re-launch the system, depending on whether it’s running
Activate FreeD Support
Free-D is a protocol that outputs tracking data in a standardised format, which helps us improve performance. We will inform you if your model supports Free-D, in which case you’ll have to enable it as follows:
- Open up the web interface of the PTZ camera and log in
- Find the section that refers to Free-D (this changes from model to model, but it can usually be found in Network Settings, IP Out, or Tracking Data Output)
- Enable the FreeD output, set the port to 40000 and set the destination IP to the IP of the Seervision server. If there are any other settings, you can leave them as default
- Hit Save & Apply
All done!
That’s it for the technical configuration. The next thing you should do is connect the SDI feed to the Seervision server, we go more in depth on that here: SDI and Seervision. If that’s already done, you should be good to go!
PTZ Quickstart (Birddog)
PTZ Quickstart (Birddog)
How to connect everything between a Seervision Server and a Birddog PTZ camera.
This page guides the user through the setup of a new Seervision Server to control a Birddog PTZ. If you have a robotic head, see Quickstart for Robotic Heads instead.
You will need to have our web interface open and ready to go – if you’re not certain how to get to it, read our manual’s Getting Started chapter first.
There’s no mention of power cables on these pages, we’re going to assume that you already know how to connect those.
Updating the Birddog
Before you configure the machine, make sure your Birddog is running the latest firmware, at the very least 5.5.094 or later.
Configuring the Birddog
For improved performance, we take advantage of the FreeD output of Birddog PTZs. This needs to be configured via the web interface of the relevant Birddog PTZ through the following steps:
- Open up the Birddog PTZ web interface, and navigate to Cam Control > FreeD tab.
- Make sure FreeD is set to Enable
- Set IP Address to the IP address of the Seervision server
- Set Port to 40000, or, if you are planning to control the PTZ through the second instance of the SV Suite on your Seervision server, set the port to 40001.
- Hit Apply
All done!
You can now continue with the configuration of this PTZ as if it were a standard VISCA PTZ by following our guide for VISCA PTZs.
PTZ Quickstart (Canon PTZs)
PTZ Quickstart (Canon PTZs)
How to connect everything between a Seervision Server and Canon's PTZs.
This page guides the user through the setup of a new Seervision Server to control a Canon PTZ. If you have a robotic head, see Quickstart for Robotic Heads instead.
You will need to have our web interface open and ready to go – if you’re not certain how to get to it, read our manual’s Getting Started chapter first.
There’s no mention of power cables on these pages, we’re going to assume that you already know how to connect those.
Configuring the Canon PTZ
For successful communication between the Seervision server and the Canon PTZ, the relevant ports need to be configured through the following steps:
- Open up the Admin interface of the Canon PTZ by accessing its IP in your web browser
- Make sure the firmware of the device is v1.2.0 or later
- Navigate to System > Communication > External Connection (IP) > Response Port Number, and set its value to Source Port Number
- Next, scroll down to the section Output Tracking Data
- Make sure it is set to Enable
- Set the Client IP Address to the IP of the Seervision server
- Set the port to 40000 or, if you intend to control the PTZ with the second instance on your Seervision server, set the port to 40001.
- Leave all other settings here to default.
All done!
You can now continue with the configuration of this PTZ as if it were a standard VISCA PTZ by following our guide for VISCA PTZs.
PTZ Quickstart (Panasonic)
PTZ Quickstart (Panasonic)
How to connect everything between a Seervision Server and Panasonic's PTZs
This page guides the user through the setup of a new Seervision Server to control a Panasonic PTZ. If you have a different PTZ or robotic head, see our other Quickstart articles instead.
You will need to have our web interface open and ready to go – if you’re not certain how to get to it, read our manual’s Getting Started chapter first.
Connecting the Seervision server and the Panasonic
A note on the PTZ IP
Regardless of how you will be using it, the PTZ will always serve its own configuration interface over its LAN port. We don’t change or affect that IP. If you can’t find this IP, you can use Panasonic’s EasyIP which will usually find it without issue (provided you are connected to the same network as the PTZs LAN port).
To enable the Seervision server to control the Panasonic PTZ, go into the Operations Server of the Seervision server and create a new configuration.
- Give it a Name that is easy to remember
- For PTU, select the relevant PTU driver from the dropdown, which should correspond to the model you wish to control
- Under IP, add the IP of the PTZ
- Under Model and Lens, make sure to select the relevant model and corresponding lens to get the best tracking and control performance
- Hit Save, and launch or re-launch the system if necessary to load the configuration
That’s it!
Configuring newer Panasonics
If you have a Panasonic model released after 2019 (AW-UE100, AW-UE150, AW-UE80), you’ll need to modify a couple more settings on the PTZ itself, all of which can be found under the Setup tab of its web interface.
Make sure to double-check this step was correctly performed. Not correctly configuring the PTZ will inevitably lead to subpar performance.
- In the left-hand menu, under Basic, navigate to System > Pan / Tilt
- Make sure the Install Position is set to what you’re using (hanging or standing). This is important for the flipping of the output feed (which we process)
- Change the P/T Speed Mode to the fastest available
- Set Speed with Zoom Position to OFF
- Only for AW-UE100: Make sure that Focus Adjust with PTZ is set to off
- Navigate to Tracking Data Output > Connection Type and double-check that the Serial column is set to Off (it should be by default)
- Only if you want the SV Suite to control the focus (not recommended): Navigate to the Image/Audio pane in the left-hand menu bar, select the Lens option, and change Focus Mode to Manual
Configuring FreeD on newer Panasonic models
Both the AW-UE100 and the AW-UE150 from the Panasonic PTZ line are the fastest devices available, and offer substantially better tracking performance than the older models. They require some additional configuration of the FreeD protocol, which the older models don’t support.
What you’ll need:
- A Seervision server
- A PTZ (AW-UE150 or AW-UE100), connected to the same LAN as the Seervision server, updated to the latest Pansonic firmware
- Make sure that both the PTZ and the Seervision server are on the same LAN, i.e. they can “see” eachother via IP
Getting set up:
- Enable FreeD on the PTZ. Navigate to the PTZ’s configuration interface, then to Tracking Data Output > IP Out. There, enable any of the output clients, and configure the enabled output client to point to the LAN IP of the Seervision server and set the port to 1112.
If you are running multiple instances of the Seervision Suite on the same server, this FreeD port number will increase by 1 for each additional instance. E.g. if you are automating two Panasonics 100/150 with a single Seervision server, the first Panasonic should be configured to use port 1112 (as written above), and the second Panasonic should use port 1113.
- Under Tracking Data Output > Connection Type make sure that IP Communication is enabled.
- Double-check that the Seervision server is trying to connect to the correct PTZ IP. You can do this by opening up the Operations Server on the server and verifying that the PTU IP field is set to the correct PTZ IP.
- Re-launch the Seervision Suite from the Operations Server to make sure it picks up the FreeD packets.
All done!
That should be it from a hardware perspective. The next thing you’ll want to do is hook up the SDI or NDI® feed to the Seervision server, we go into more depth on that here: SDI/NDI® and Seervision. If you’ve already handled that, then just directly go to the Seervision Server Setup page.
Disclaimers: NDI® is a registered trademark of Vizrt Group.