Prepare your Origin system

It is assumed that your Origin system hardware components (including Viper cameras, Beacon(s), and Pulsar active marker clusters) have been placed in your volume and connected to a power supply, and that Evoke is installed and licensed.

If you're installing your Origin system yourself, see any Vicon documentation that was supplied with your hardware and Installing and licensing Vicon Evoke. If you need further help, please contact Vicon Support.

To set up your Origin system, complete the following procedures:

For information on additional optional preparations, see Optional setup.

Supported devices

Evoke checks for supported Vicon devices before allowing connection. Currently supported devices include:

• Viper, ViperX, Vero, and Vantage motion capture cameras
• Vue video cameras (to provide full-color reference video, synchronized with the rest of the Vicon system)
• Beacon and Pulsar
• Lock

Ensure Beacon is free of interference

Beacon channels are in the 2.4 GHz ISM band and numbered 11 to 26. To ensure smooth running of your system, make sure that there is no interference from other 2.4 GHz radio/Wi-Fi sources and that nothing blocks the signal between the Beacon and the volume.

To prevent interference and signal-blocking, follow these guidelines:

• Place the Beacon as close to the middle of the volume as possible.
• Place the Beacon high up, to minimize masking of the RF signal by participants.
• Do not re-use a channel number within a site or a co-located group of sites.
• Do not place multiple Beacons closer together than four meters.
• If channel n and channel n+1 are used in a site, do not use channels n-1 or n+2 in that site or adjacent sites.
• If channel n and channel n+2 are used in a site, do not use channels n-2 or n+4 in that site or adjacent sites.

Prepare the Pulsars

Turn on the Pulsars (press the power button once).

Check that the Pulsar firmware is up-to-date and that all the Pulsars are fully charged.

• Check Pulsar firmware
• Ensure Pulsars are fully charged
• Keep marker LEDs enabled while charging

Check Pulsar firmware

Check the firmware for your Vicon hardware when you first set up your Origin system and periodically afterwards.

To update your Pulsar firmware:

1. Connect the Pulsars to the PC via USB, either by using the supplied recharging dock or directly, using USB cable(s).
2. From the Windows Start menu, click Vicon, then Vicon Pulsar Reprogramming Tool.
3. In the Pulsar Reprogramming Tool window, click Target Firmware and select the firmware file to update to.

   

4. Before you update, ensure you have closed any other Vicon applications that you may have opened.
5. To update to the selected firmware version, click OK.

6. When the firmware has been updated, reboot the Pulsars, either by unplugging them or by turning off the recharging dock.

For information on updating firmware for cameras and Beacons, see Update camera firmware.

Ensure Pulsars are fully charged

If a Pulsar's status light appears pink or red, the battery is less than 20% charged.

To recharge Pulsars:

• Place them in the supplied recharging dock and connect to your power supply; or
• Recharge them using a standard micro-USB to USB cable

The average battery run-time for a Pulsar used at 100% brightness is around nine hours of continuous use. You can extend battery life by disabling Pulsars when not required for tracking, which will give up to 18 hours of typical use.

Note the following times to recharge Pulsar batteries:

• Recharge time to 80%: 1 hr (max)
• Recharge time to 100%: 3 hr (max)

Keep marker LEDs enabled while charging

From Evoke 1.2.2 and later, Evoke can configure Pulsars to keep their IR marker LEDs on while charging. This may be useful if you're using a backpack PC as a power source. The default behavior is still to turn off marker LEDs while charging.

This parameter is available both for Pulsar devices (on the System tab) and for Smart Objects (on the Tracking tab). When a Pulsar is linked to a Smart Object, it inherits the Smart Object value for Markers On While Charging.

Start Evoke

When you install Evoke, a Vicon Evoke desktop shortcut appears on your desktop (and an entry is added to the Windows Start menu).

(Depending on the options selected during installation, you may also see icons for Vicon Retarget, which lets you create retarget setup files (*.vsr), used by Evoke for retargeting; and the Vicon Firmware Update Utility.)

• Double-click the Vicon Evoke icon to start Evoke and ensure the System tab is visible.

  

  From this tab, you monitor and control devices connected to the software.

Windows power options monitoring

When you first start Evoke, you may see a warning icon on the right side of the menu bar, like this:

This icon indicates that the current power plan is set to favor power savings over performance. The power-saving features of Windows can significantly reduce Evoke's performance and increase output latency, depending on the power plan that is chosen and the processor support for power-saving features.

For more information and access to the Power Options in the Windows Control Panel, click the icon.

For best performance in VR, choose the High performance plan (or a plan created from the high performance plan).

Ensure optimal latency

To ensure optimal latency for all scenarios, on the Processing panel, ensure Low Jitter Mode is selected.

Turn on the Beacon and enable pairing

Note that if the Pulsars are already paired to the correct Beacon, you can skip these pairing steps.

To enable pairing:

1. Ensure that the Beacon is connected to a powered PoE switch and that this switch is connected to the host PC running Evoke.
2. Turn on the Beacon.
   In Evoke, on the System tab, a Beacon is displayed in the Connectivity section.Check that the Beacon connection status is green.

   

3. To perform a radio scan to check which Beacon channels are clear from interference from other radio devices and Wi-Fi, right-click the Beacon and select Radio Channels.

   The Radio Channels dialog box shows the signal strength of the currently available channels.

   

   The numbers on the left of the chart represent the signal strength in decibels.The channel numbers along the bottom of the chart are buttons that enable you to select the channel. The yellow warning triangles alert you that the channel above is in use (for more information, hover the mouse pointer over the icon). The light blue bars indicate the average power for each channel and the dark blue bars indicate the maximum power. In the bars for each channel, the white line represents the last sample taken. Note that all Pulsars connected to the Beacon are temporarily disconnected while scanning is in progress as the Beacon can't scan channels and broadcast sync at the same time.

4. Select a channel in one of the following ways:
   
   • In the Radio Channels dialog box, click a channel number at the bottom of the chart to select the relevant channel; or
   • On the System tab, ensure the Beacon is still selected and in the Radio section below, click in the Radio Channel field and select an appropriate channel.

     

     If you choose a channel that is already in use, the Beacon does not turn on sync broadcasts and a warning is displayed.
5. With the Beacon still selected, right-click on it and then click Radio Pairing.

6. In the Radio Pairing dialog box, click the Start Pairing button for the selected Beacon.

   Pairing mode is enabled, which means that the Beacon is available for pairing and any unpaired Pulsar that is turned on (see Pair Pulsars with a Beacon) will try to connect to it.

7. To specify which pairing requests are accepted, in the Radio Host section at the top of the dialog box, select or clear Allow List Enabled for the required Beacon:

   

   • If the allow list is not enabled, all pairing requests are accepted.

   • If the allow list is enabled, only Pulsars on the allow list are accepted.

     Other Pulsars are refused, but are displayed in the Radio Pairing dialog box so you can choose to accept the request.

     To add one or more selected Pulsars to the selected radio host allow list, right-click the Pulsar(s) and then click Add to <host name> allow list. The Pulsars on the allow list are now accepted.

     In the case of pairing requests, pairing must also be started to enable the Pulsar to connect.

   Tip: Pairing/connection requests persist until you exit Evoke. If a Pulsar fails to connect, check its physical status. Evoke only knows about the last communicated status of the Pulsar, which may now be out-of-date.

   For more information about the symbols displayed in the Radio Pairing dialog box and how to move Pulsars to and from radio hosts and their allow lists, see About the Radio Pairing dialog box.

8. On the System tab, check that no warnings are displayed next to the Beacon.

About the Radio Pairing dialog box

At the top of the Radio Pairing dialog box, the Radio Host list shows the number of clusters connected to and paired with the radio host, and enables you to choose whether the allow list for the selected Beacon is enabled.

Below the Radio Host section, the Assigned Clusters section lists Pulsars that are paired to the selected Beacon or are on its allow list.

• A green 'Play' symbol indicates a Pulsar that is paired and connected to the selected host's allow list.

• A blue 'i' indicates a Pulsar that is paired to the system, but unable to connect because it's not on the host's allow list.

• A red 'x' indicates a Pulsar that is unpaired. It cannot connect unless the Beacon is put into pairing mode (and the Pulsar is on the allow list, or the allow list is disabled).

• A yellow 'Pause' symbol indicates a Pulsar that is connected but disabled.

• A gray 'Play' symbol indicates a Pulsar that is connected but not linked to a Smart Object.

• A magenta 'i' indicates a pairing request.

• No icon indicates a Pulsar is missing (ie, it hasn't connected during this session).

• A partially selected check box in the Paired column indicates a Pulsar that is paired to a Beacon that is different from the one that is currently selected.

To perform the following operations on Pulsars in the Assigned Clusters list, right-click on one or more selected Pulsars and select the required option:

• Add to or Remove: Add or remove the selected Pulsar(s) from the selected radio host allow list
• Clean the allow list: Remove any Pulsars from the selected radio host allow list that are paired to another radio host. This option is useful after load-balancing (see Load balancing between hosts).
• Unpair: Unpair the selected Pulsar(s) from the selected radio host
• Transfer: Pair the selected Pulsar(s) to another connected, enabled radio host

At the bottom of the Radio Pairing dialog box, the Unassigned Clusters section lists connection or pairing requests, and unpaired Pulsars. This list persists for the lifetime of the application session. To add Pulsars in this list to to the selected radio host's allow list, right-click on the Pulsar(s) and then click Add to Host <hostname> allow list.

Load balancing between hosts

The number of clusters connected to each Beacon must be balanced. If too many clusters are connected to one host then connection stability is reduced, and the time required to send commands to all clusters increases.

To automatically balance the number of Pulsars between Beacons, click the Load Balance Hosts button at the bottom of the dialog box. This transfers the connected clusters so that an equal number is connected to each host.

After load balancing, you may find a number of clusters on one host's allow list are paired to a different host. To remove these clusters from the allow list, right-click on the cluster(s) and then click Clean Host <host name> allow list.

Pair Pulsars with a Beacon

After you have turned on a Beacon and made sure it is available for pairing, you can pair Pulsars to it.

1. On a Pulsar, press the power button to turn it on.

   Tip: If you transfer a Pulsar between Beacons, you must un-pair the Pulsar so that it can connect to the new Beacon. To do this, during the 10-second period after booting, double-press the Pulsar button to un-pair it.

   The Pulsar automatically searches radio channels to find the Beacon it is paired with, or if unpaired, a Beacon that has pairing enabled (see Turn on Beacon and enable pairing).
   In Evoke, on the System tab, in the Clusters section, a Pulsar is displayed.

2. Ensure that the Pulsar connection status is cyan (connected but not assigned a marker pattern).

   

   If the Pulsar's battery level is low, a status icon indicates this. If any other icon is displayed, see Pulsar status icons in Evoke to troubleshoot possible issues.

3. When all the Pulsars have been paired, turn off pairing mode. To do this, either click the Stop Pairing button or close the Radio Pairing dialog box.

   Tip: To deactivate a Pulsar, on the System tab, select the Pulsar and in the General section below, clear the Enabled check box.

   In the Clusters section, the Pulsar connection status turns yellow. The marker LEDs turn off, to reduce power consumption.

Pulsar status icons in Evoke

On the System tab, in the Clusters part of the System tree, Pulsars that are paired with a connected Beacon are displayed. Adjacent icons indicate the status of the Pulsars:

The following table describes each of the Pulsar status icons that are displayed on the System tab in Evoke.

Note that the overall system charge is determined by the device with the lowest charge (unless recharging – see the following note), which is shown at the top of the Clusters section on the System tab.

The number of devices on charge is also displayed here.

In the following image, the red battery icons to the right of the Pulsar names indicate that the batteries of the relevant Pulsars are low. The Lowest Battery Charge indicator shows that the Pulsar with the lowest charge is almost at 0%, ie, almost fully discharged (a Pulsar whose battery is fully discharged can no longer communicate with Evoke and disconnects, and the Lowest Battery Charge indicator then displays the Pulsar with the next lowest battery).

In the following image, the yellow lightning icons to the right of the Pulsar names indicate that the batteries of the relevant Pulsars are charging (and the yellow battery icons indicate that the charge is still low). The Lowest Battery Charge indicator shows that the Pulsar with the lowest charge is now at 13%.

Enable Evoke to track Pulsars and props

Both Smart Objects and basic objects define a pattern of markers that Evoke can locate from camera centroid detections.

Create Smart Objects

A Smart Object is the representation in Evoke of a type of object that has programmable active markers (eg, a Pulsar). Pulsars are smart in that they communicate with the Evoke PC via a Beacon. This enables a Pulsar to set its marker pattern, sync to the Viper cameras and report its battery level back to the PC.

To enable tracking of Pulsars, you must create a Smart Object in Evoke for each Pulsar that you want to track.

For more information, see Work with Smart Objects or watch the Vicon video:

Create basic objects

A basic object lacks the two-way communication of a Smart Object (eg, a Nova active strand). A Nova is a basic object as its active markers can be either on or off and it has to be controlled manually.

To enable tracking of props, you must create basic objects in Evoke for each prop that you want to track.

For more information, see Work with basic objects or watch the Vicon video:

Manage your tracking configuration

When you have finished setting up your Smart Objects and basic objects, you can save the whole tracking configuration (including all basic and Smart Objects) in MCP format for future use.

To do this, at the top of the Tracking pane, click the Save tracking configuration button:

The default location for tracking configuration files is:

C:\Users\Public\Documents\Vicon\Evoke1.x\Tracking

When you want to re-use your tracking configuration, click the Load tracking configuration button to re-load the file.

Position cameras and Pulsars

With your Origin system installed and licensed, and after you have created Smart Objects, you can position the cameras and markers.

1. Position your cameras around the volume, ensuring that two or more cameras can see every point in the volume in which you intend to track motion.
2. Place Pulsars around the floor to outline your volume.

Check volume coverage

After you have positioned cameras and Pulsars in the volume, ensure that the cameras can see the whole of the volume.

1. Ensure your cameras are physically connected to the system.
2. Ensure your Origin system hardware is switched on, and that Evoke is running.
3. On the System tab (by default located on the left of the Evoke window), SHIFT+click to select all the cameras or, for a large number of cameras, right-click and click the relevant Select All option.
4. In the Workspace ensure that the Cameras view is selected.

   

5. Using the default lens settings on each camera, ensure that:
   
   • You can see Pulsar images from each connected camera.
   • Two or more cameras can see every point in the volume in which you intend to track motion.

Deactivate unused objects

It's important to ensure that any objects that aren't currently in use are deactivated.

Evoke is constantly trying to find all enabled objects. Objects that are enabled but not visible in the volume (eg, Pulsars that are charging, powered off or out of the volume) may cause spurious object tracks, or impede the tracking of the objects that are visible in the volume.

To deactivate an object:

• On the Tracking pane, select it and in the General section below, clear the Enabled check box.
  Or
• In the Tracking tree, clear the relevant check box:

  

Update camera firmware

Vicon hardware is programmed with firmware to control its operation. Periodically, Vicon supplies firmware updates to correct or improve device functionality. You apply these firmware updates to your Vicon cameras and Beacon(s) via the Vicon Ethernet network using the Vicon Firmware Update Utility, as described below.

You are automatically notified when any component of your Vicon system is running out-of-date firmware, and given the opportunity to update to the latest version.

To monitor and/or upgrade system firmware:

1. When you start Evoke or connect any Vicon devices into your system, Evoke checks to see whether the firmware for your cameras and Beacon(s) is up-to-date.If your devices aren’t using the latest firmware, Evoke displays an icon in the toolbar to let you know that a more up-to-date version of the firmware is available:

   

2. Click the icon to display more information.Evoke displays a prompt that enables you to open the Vicon Firmware Update Utility (reprogramming tool).

   

3. Click Yes to open the Vicon Firmware Update Utility. Note that you can also open the Vicon Firmware Update Utility from the Start menu (select Vicon > Vicon Firmware Update Utility). Evoke closes and the Vicon Firmware Update Utility is displayed, showing all the connected devices and their current firmware version.By default, all devices are selected.

   

4. If you don’t want to update any of the devices, clear the relevant check box(es).
   Note that if required, you can select devices to be updated that are already using the latest version.
5. At the bottom of the Vicon Firmware Update Utility window, in the Choose Firmware version list, select or browse to the required firmware version.
6. Click Reprogram to update the firmware for the selected device(s).

   

   When updating is complete, the Firmware Version column displays the updated firmware version and the System Status line and the Reprogramming Status column display Complete on a green background.

   

To downgrade to an earlier firmware version

To downgrade to a firmware version that was previously downloaded, open the Vicon Firmware Update Utility (from the Start menu click Vicon > Vicon Firmware Update Utility) and select the required firmware version.