OZO LIVE

Online Documentation

Introduction


OZO Live enables the Nokia OZO+ VR Camera to be used for multi-camera live VR broadcasts. A live production studio, OZO Live is a software product. Running GPU-assisted reference hardware, OZO Live converts the compressed 1.5Gb/sec HD-SDI signal from the OZO into a number of formats:

OZO Live provides advanced real-time multi-point stitching functionality, spatial audio processing, color correction, h.264 encoding, H.265 encoding, and a variety of advanced options in a powerful and easy-to-use package.

OZO Live is designed for professional broadcast production use, supporting three primary deployment modes:

  1. Single-camera workflow with direct RTMP uplink
  2. Single-camera workflow to a single external broadcast encoder
  3. Multi-camera workflows with full production switching and sound reinforcement.

OZO Live versions

OZO Live Versions

OZO Live 2.0.1 is a major update that introduces a new range of features. OZO Live is available under three licensing agreements:Users with the Free Version will be presented a UI without any Paid features. Though you will have the ability to turn on the paid features under the license tab, your video and audio will appear with a watermark.

You will be able to access the Multiview with either a Singlenode or Multinode license. Unlicensed machines will produce watermarked video and audio.

Users with a free license of OZO Live will be able to see all features, but will not be able to access them until upgrading to a Singlenode or Multinode license.

Users with a Multinode license will have access to the Multiview

OZO Live offers three deployment modes:

  1. Free
  2. Singlenode
  3. Multinode
OZO Live 2.0.1 (free mode)OZO Live 2.0.1 (full mode)
Max Output resolution 2560x1440p max resolution 4096x4096 max resolution via RTMP.<4K>per eye over dual SDI outputs. resolution up to 3840x2160p.
Output Frame rate 29.97 and 30 fps 29.97 and 30 fps on rtmp outputs. 59.97 and 60 fps on supported SDI cards.
Video Output FormatsMonoscopic Equirectangular OnlyAll Formats. (360 Stereoscopic T/B (Lambert and Equrectangular), 180 Stereoscopic, 360 Monoscopic Cubemap)
Audio Output Formats2.0 (Stereo) audio onlyAll formats. Pass through, 5.1, 7.1, 2.0 (Stereo), Binaural, First-order Ambisonics
MultiviewNoYes
Multi node monitoring and navigationYesYes
SDI OutNoYes
File OutputMp4Mp4
Spatial Audio MixingNoYes
PositionNoYes
4K per eye output over SDINoYes
RTMP outputYesYes
Facebook PublishingYesYes

OZO Live 2.0.1 Product Specification

Product Overview


OZO Live is a real-time broadcast solution that delivers live virtual reality experiences over IP. The software runs on standard reference hardware, delivers a standard 4K/UHD SDI video outputs or IP based streams as output. Integrates seamlessly with your existing 4K broadcast equipment. Select monoscopic 2D or stereoscopic 3D and use standard switchers, color correctors, audio mixers, and other support gear for a full production workflow. Supports up to 4K/UHD per eye over dual SDI outputs, and a maximum of 4096x4096 resolution while using encoded stream output.

OZO Live can also mix external audio sources from Dante (128 channels) or local sound cards with the OZO camera audio. The audio sources are positioned live in the full spatial environment. Multiple mixes and audio format outputs can be created at the same time. Quick to set up, easy to use, and highly reliable, OZO Live immerses you in an event as if it's happening around you.

Benefits

Multiple video output formats:

Multiple audio output formats:

Multiple audio formats and mixes can be outputed on SDI (a total of 8 channels maximum), via Dante (no limitation) or local sound card (number of channels depend on sound card).

Encoder support

Example Production Deployments


OZO Live with built-in encoder

OZO Live with external encoder

OZO Live is production format agnostic, and supports both 2D 360 and 3D 360 delivery.

Real time camera switching: Use multiple OZOs with standard video switchers / Standard 4K video output for easy integration into your existing workflow.

Production-grade reliability: Frame accurate, reliable and stable for hours upon hours at a time.

Capture events large and small: Scalable multi-camera support via standard workflows to broadcast events of any size.

Key Features


Flexible configuration

Stitch Correction Features

Color Correction Features

Hardware Specification

Disclaimers

OZO Live has significant demands on GPU, CPU and memory bandwidth. Both hardware and software are subject to frequent updates, and configuration problems will likely cause errors in software operation. We recommend the use of certified hardware with specified drivers. OZO Support cannot provide assistance with configuration issues caused by nonstandard hardware or drivers.

OZO Live runs on Windows 10 and on Ubuntu 16.04 LTS. The installation and configuration of OZO Live in Ubuntu requires familiarity with Linux system integration, up to and including the compiling of drivers from the source. If you do not have this expertise within your organization, we recommend the purchase of a pre-built Certified OZO Live system from one of our partners. Contact OZO sales for a list of OZO Live system integration partners.

We have tested multiple configurations of these machines, and list those below.

These specifications are current as of September 25, 2017, but may change at any time. We are committed to providing best-of-breed performance, and as a result future OZO Live releases may make a previously-specified machine obsolete or in need of extensive upgrade.

OZO Live Machine HW Specification

OZO Live runs under numerous configurations, depending on your budget and production needs. Please read the following tables to see which might work for you.

The Professional Broadcaster Configuration


A rackmount server configuration ensures that your setup is reliable and robust.

This configuration will support all OZO Live 2.x features.

Be sure to build your system with excellent cooling capabilities. As one of most important factors to ensure a stable system, efficient cooling also extends the lifespan of your system.

Required Components

GPU alt11 GTX 1080 Ti, 11GB RAM.
GPU alt21 Titan X Pascal or Titan Xp, 12GB RAM.
GPU alt32 GTX 1080 or better, 8GB of RAM in each card minimum. If Windows 10, will also run Creator.
PCIe slotsPCIe 3.0 x16 slots for each GPU installed, with GPUDirect preferably enabled using the most direct path traversal.
CPUIntel Core i7, Core i9 X-series or Intel Xeon, Quad core or better, 40 PCIe lanes or more, 2.8 GHz or more
RAM16 GB, DDR4, 2133 GHz or better
Disk256 GB SSD or better. The more, the better.
Network requirements1 Gbps or better
SDI Connectivity over PCIe2 BlackMagic Decklink SDI 4K or alternativly 1 AJA Corvid-88 (for 59.94 or 60 FPS output) and 1 BlackMagic Decklink Mini Recorder 4K (for camera input)
Power SupplyDual power supplies for redundancy
OSUbuntu 16.04 LTS or Windows 10 Pro 64bit

Optional Components

Dante Audio over Ethernet can provide up to 128 audio channels over dedicated Ethernet port in the PCIe card.

Recommended Dante Audio on Linux:

Recommended Dante Audio on Windows:

Recommended for future upgrade ability:

Keep room for 2 16-lane PCIe slots for full length GPU cards.

10 Gbps network port. Either on motherboard or as PCIe card.

The Cost-Efficient Configuration


If based on a PC Tower/Workstation form factor, this is the most cost efficient configuration for OZO Live. Some suggested alternatives will not support all OZO Live 2.x features.

Be sure to build your system with excellent cooling capabilities. As one of most important factors to ensure a stable system, efficient cooling also extends the lifespan of your system.

Required Components

GPU alt11 GTX 1070 or GTX 1080, 8GB RAM (see note about limited functionality)
GPU alt21 GTX 1080 Ti or better, 11GB RAM or better. Does support all OZO Live 2.0.1 features.
GPU alt32 GTX 1080 or better, 8GB of RAM in each card minimum. If Windows 10, will also run Creator.
PCIe slotsPCIe 3.0 x16 slots for each GPU installed, with GPUDirect preferably enabled using the most direct path traversal.
Other PCIe slotsEnough slots to accommodate all other PCIe cards
CPU6th or 7th generation Intel Core i7 or Core i9 X-series processors
CPU alt1i7-7700K + Z270 (cheapest)
CPU alt2i9-7900X + X299 (recommended for dual GPU setup)
RAM16 GB, DDR4, 2133 GHz or better
Disk256 GB SSD or better. The more, the better.
Network1 Gbps or better
SDI Connectivity over PCIe2 BlackMagic Decklink SDI 4K
OSWindows 10 Pro/Home 64bit

Note about using single GTX 1070/1080 GPU configuration

A single GTX 1070 or GTX 1080 will run OZO Live but will give a somewhat limited features:

Optional Components

Recomended Dante Audio on Windows:

Additional supported alternatives

SDI connectivity alternatives

SDI connectivity over Thunderbolt 2 (for a Windows laptop configuration)

SDI Connectivity over PCIe cards

SDI output is not needed if only using IP based output.

External audio connectivity alternatives

Dante is recommended for multinode camera configurations.

Other audio alternatives

Operating system alternatives

OS: Windows 10 Pro or Home, 64bit. Pro is Recommended (home does not give Remote Desktop support)

Ubuntu 16.04 LTS

Windows Configurations Quick View

The following applies to PCs running 2.0.1 for Windows.

Supported Operating System:Windows 10 Pro
Supported HardwareCPU: Intel Quad Core i7
RAM: 16 GB
For maximum performance: NVIDIA GTX 1080 (X 2)
For limited performance: NVIDIA GTX 1080 (X 1)
Blackmagic Recorder:
  • Blackmagic DeckLink Mini Recorder PCIe card (install in desktop)
  • Blackmagic DeckLink Mini Recorder 4K PCIe card (install in desktop)
  • Blackmagic UltraStudio Mini Recorder (Thunderbolt™ 2)
  • Blackmagic HyperDeck Studio Pro (Thunderbolt™ 2)
  • BlackMagic UltraStudio 4K (Thunderbolt™ 2)

Apple Thunderbolt™ 3 (USB-C) to Thunderbolt™ 2 Adapter or
StarTech Thunderbolt™ 3 to Thunderbolt™ Adapter (TBT3TBTADAP).
Wi-Fi antenna
Software requirementsThe latest Nvidia drivers installed
Blackmagic Desktop Video 10.9.7
Optional: Blackmagic Hyperdeck 5.1 pdate (for use with the Hyperdeck Studio Pro)
For CV1 - Oculus App; For HTC Vive – Vive Setup Tool and Steam VR
Windows power management set to High Performance
Nvidia power management set to Maximum

The following applies to Laptops running OZO Live 2.0.1 for Windows

Supported Operating System:Windows 10 Pro
Supported HardwareCPU: Intel Quad Core i7
RAM: 16 GB
MSI GT83VR SLI laptop with dual GTX 1080 8GB
Blackmagic Recorder:
  • Blackmagic UltraStudio Mini Recorder (Thunderbolt™ 2)
  • Blackmagic HyperDeck Studio Pro (Thunderbolt™ 2)
  • BlackMagic UltraStudio 4K (Thunderbolt™ 2)

Apple Thunderbolt™ 3 (USB-C) to Thunderbolt™ 2 Adapter or
StarTech Thunderbolt™ 3 to Thunderbolt™ Adapter (TBT3TBTADAP).
Wi-Fi antenna
Software requirementsThe latest Nvidia drivers installed
Blackmagic Desktop Video 10.9.7
Optional: Blackmagic Hyperdeck 5.1 pdate (for use with the Hyperdeck Studio Pro)
For CV1 - Oculus App; For HTC Vive – Vive Setup Tool and Steam VR
Windows power management set to High Performance
Nvidia power management set to Maximum

Configuration and Setup

OS Configuration and Setup for Ubuntu 16.04 LTS


1. Install Ubuntu 16.04 LTS - 64bit PC (AMD64) Server install image

WARNING: YOU MUST BE CONNECTED TO THE INTERNET FOR THE FOLLOWING SERIES OF COMMANDS TO WORK.

You can download and install Ubuntu fromhttp://www.ubuntu.com/download/server.

During the installation, you will be asked the automatic update option. It is important to choose "No automatic updates" which is the default selection; otherwise the Ubuntu kernel will update itself automatically, which may cause system instability.

In Software Selection page, choose "OpenSSH server"

If you missed the above steps, please use following command after installation in order to disable the automatic updates and install ssh server package.

$ sudo apt remove unattended-upgrades
$ sudo apt-mark hold linux-signed-image-generic
$ sudo apt install openssh-server

Take a note of ip address of the machine. Static IP address may be pre-configured in the dhcp server in router. You can find the ip address of the machine with following command.

$ hostname -I

2. Disable GUI login

Ubuntu may install with the GUI enabled. If this is the case, follow these steps to disable the GUI before installing OZO Live.

During Ubuntu boot, pressCtrl+Alt+F1to switch to console mode, and login with the account that was set up during the Ubuntu installation Edit the Grub configuration located in /etc/default/grub:

$ sudo vi /etc/default/grub

Change the value ofGRUB_CMDLINE_LINUX_DEFAULTtoGRUB_CMDLINE_LINUX_DEFAULT="text"

Update GRUB

$ sudo update-grub

Tell systemd not to load the GUI:

$ sudo systemctl enable multi-user.target --force
$ sudo systemctl set-default multi-user.target

3. Install dependent packages

OZO Live depends on several third-party packages. Install them using the commands below.

$ sudo apt-get install libzip4 libpng12-0 libjpeg8 libjasper1
$ sudo apt-get install openjdk-8-jre

After installing openjdk-8-jre run the following command to fix dependencies

$ sudo apt-get install -f

4. Install Nvidia driver

You need to install Nvidia drivers in order to support OZO Live's requirements. Please run the following commands:

$ sudo add-apt-repository ppa:graphics-drivers/ppa -y
$ sudo apt-get update

Upgrading to the latest Nvidia driver is highly recommended, to uninstall the old driver:

$ sudo apt-get purge nvidia-*

Install the Nvidia driver:

$ sudo apt-get install nvidia-384

Reboot the system and check the installation

$ nvidia-smi

Thu Sep 21 02:30:01 2017
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 384.69                 Driver Version: 384.69                    |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  GeForce GTX TIT...  Off  | 0000:02:00.0     Off |                  N/A |
| 22%   38C    P0    70W / 250W |      0MiB / 12206MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+
|   1  GeForce GTX TIT...  Off  | 0000:03:00.0     Off |                  N/A |
| 22%   43C    P0    72W / 250W |      0MiB / 12206MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+
                                                                              
+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+

5. Installing GPU cards

Be sure that GPU cards are installed in PCI Express slots running at 3.0 x16 mode. Check your motherboard manual to confirm PCIe operating mode for each slot configuration.

You can verify the GPU PCIe link info by running

$ nvidia-smi -q

...
GPU Link Info
  PCIe Generation
    Max                 : 3
    Current             : 3
  Link Width
    Max                 : 16x
    Current             : 16x
...

Some motherboards also have more than one I/O hub. In order to achieve the best performance we recommend that GPU cards be installed in PCIe slots attached to the same host bridge.

You can verify it by running

$ nvidia-smi topo -m

       GPU0    GPU1    CPU Affinity
GPU0     X     PHB    8-15,24-31
GPU1    PHB     X     8-15,24-31
 
Legend:
 
  X   = Self
  SOC = PCI path traverses a socket-level link (e.g. QPI)
  PHB = PCI path traverses a host bridge
  PXB = PCI path traverses multiple internal switches
  PIX = PCI path traverses an internal switch
  NV# = Path traverses # NVLinks

The example shows two GPU cards are connected via the same host bridge. If you see SOC in the output matrix, please consider rearranging the GPU slots.

6. Install Blackmagic driver

If you are using Blackmagic PCI cards for SDI input or output, you must install the Blackmagic driver. Download it from https://www.blackmagicdesign.com/support/family/capture-and-playback

You may need to install the dkms package:

$ sudo apt-get install dkms

Install the latest Desktop Video software.

$ tar xf Blackmagic_Desktop_Video_Linux_xxx.tar.gz
$ sudo dpkg -i Blackmagic_Desktop_Video_Linux_xxx/deb/amd64/desktopvideo_xxx_amd64.deb
$ BlackmagicFirmwareUpdater status

0:    (null) [/dev/blackmagic/io0]    0x41d7ca    PLEASE_UPDATE

$ BlackmagicFirmwareUpdater update 0

/dev/blackmagic/io0 firmware update completed successfully.
Please reboot your system now to activate new firmware

7. Install AJA driver

If you are using an AJA PCI card for SDI output, you must install the AJA driver. Download v12.4.1.1 Linux driver from the AJA website, and build according to the instructions. It is important to download this specific version. (e.g. v12.3.x doesn't work with OZO Live.)

Driver request page:https://www.aja.com/en/support/drivers/linux

Compile the driver with following commands:

$ unzip ntv2linux-driver-12.4.1.1.zip
$ tar zxf ntv2linux-driver-12.4.1.1.tar.gz
$ cd ntv2linux-driver-12.4.1.1/ntv2projects
$ make

Install the driver files:

$ sudo mkdir -p /opt/aja/bin
$ cd ..
$ sudo cp bin/* /opt/aja/bin

Check the installation with following commands:

$ cd /opt/aja/bin
$ sudo ./loadOEM2K

After installing OZO Live, see Install OZO Live, follow the instructions below to automatically load AJA drivers on boot.

$ sudo cp /opt/nokia/ozo_live/bin/aja-devices /etc/init.d/
$ sudo ln -s /etc/init.d/aja-devices /etc/rc2.d/S01aja-devices $ sudo chmod a+x /etc/init.d/aja-devices

Reboot the system and check if driver loaded automatically without error.

$ dmesg | grep oem2k0

<snip>
[    6.486557] oem2k0: Registered IRQ 0x78, dev_id ffffc9000b001000
[    6.486557] oem2k0: probe(): setup IRQ types
[    6.489180] oem2k0: Programmed Video FPGA with bit file built on 2016/02/16 at 17:45:42
[    6.489180] oem2k0: Successfully probed CORVID88
[    6.489182] oem2k0: PCI Version 0x20

You should see log message from "oem2k0"

If you have older firmware, please upgrade it. You may need to contact AJA support for the latest firmware and instruction for update.

8. Install Four-Audio Dante PCIe Linux kernel driver

If you are using Four-Audio dante PCIe card for Dante based audio input and output you have to install the card physically to the OZO Live server and then install the drivers.

With Four-Audio Dante cards the IOMMU needs to be disabled

$ sudo vi /etc/default/grub

Change the value of

GRUB_CMDLINE_LINUX_DEFAULT="text"

to

GRUB_CMDLINE_LINUX_DEFAULT="text iommu=off"

Remember to update and reboot:

$ sudo update-grub
$ sudo shutdown -r now

Find out the Linux kernel version

$ uname -r
4.4.0-66-generic

Request the driver for the specific kernel version (in this case 4.4.0-66) you are using by email from info@four-audio.com

Unpack, read the instructions, and install the received Dante PCIe kernel module

$ tar -xzf dante_pcie_4.4.0-66.tar.gz
$ cd 4.4.0-66
$ less README.txt
$ sudo make install
$ sudo depmod -a

You should verify that your account belongs to group audio by

$ id -nG "$USER"|grep -c "audio"

If the answer is 1, then you are already in the group but if answer is 0 then you should add your user to the audio group

sudo usermod -a -G audio $USER

You should verify now that the Dante card is usable and works by

$ aplay -L | grep DantePCIe

<snip>
aplay -L | grep DantePCIe
sysdefault:CARD=DantePCIe
DantePCIe, DantePCIe PCM
dmix:CARD=DantePCIe, DEV = 0
DantePCIe, DantePCIe PCM
dsnoop:CARD=DantePCIe, DEV = 0
DantePCIe, DantePCIe PCM
hw:CARD=DantePCIe, DEV = 0
DantePCIe, DantePCIe PCM
plughw:CARD=DantePCIe, DEV = 0
DantePCIe, DantePCIe PCM

If aplay is not installed in your machine, install it with

$ sudo apt-get install alsa-utils

You should also test that from command line prompt you are able to record through the Dante card five seconds of audio through two first channels. If you want to record something else than silence, make sure that you have connected audio sources to the two first input channels of the card.

$ arecord -v -M -D hw:CARD=DantePCIe,DEV=0 -f S24_LE -r 48000 -c 2 -d 5 -I 1.wav 2.wav

If the recording gets stuck, and the arecord command does not return after 5 seconds (-d 5), please see troubleshooting note below about Message Signaled Interrupts.

Troubleshooting Dante driver installation: Manual copying of the kernel module

If for some reason the installation does not succeed, or Dante driver is not automatically loaded during the next system reboot, you should manually copy the kernel driver to a location from where the module can be installed at boot time. The following command assumes your working directory is where you unpacked the *.tar.gz during the previous steps.

$ sudo cp dante-pcie.ko /lib/modules/`uname -r`/extra/

Add dante-pcie to /etc/modules-load.d/modules.conf as follows:

# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored
dante-pcie

$ sudo depmod -a
$ sudo shutdown -r now

Troubleshooting Dante driver installation: PCI Message Signaled Interrupt problem

Message Signaled Interrupts is a method of signaling an interrupt using a shared interrupt line. With some HW configurations MSI does not work properly between Dante and NVidia drivers. One symptom of this is hanging of 'arecord' command. In this case you should also notice pop up of "No irq handler for vector" message into the system log during execution of the 'arecord' command. Use second command prompt terminal to see this.

$ dmesg -w

do_IRQ: 1.164 No irq handler for vector

One workaround is to force the Dante card kernel module to load as the last module:

  • Add 'blacklist dante_pcie' to the file /etc/modprobe.d/blacklist.conf
  • Add 'modprobe dante-pcie' to /etc/rc.local
  • Reboot and check whether the 'arecord' command now works properly.

    $ sudo depmod -a
    $ sudo shutdown -r now
    $ arecord -v -M -D hw:CARD=DantePCIe,DEV=0 -f S24_LE -r 48000 -c 2 -d 5 -I 1.wav 2.wav

    8. Usage of Spatial Audio Mixer with ALSA sound cards

    Usage of spatial audio mixing capabilities of OZO Live ALSA compatible USB sound card. Simply, connect the powered USB sound card to OZO Live machine. The sound card will be available as input for sound sources and as output for your spatial mixes. You need to restart the pipeline service for OZO Live to detect the USB sound cards.

    $ sudo service ozo-live-pipeline restart

    Note on kernel upgrade:

    Whenever the Ubuntu kernel is upgraded, either automatically or manually, the AJA driver and Four-Audio Dante PCIe drivers are invalidated. Since AJA doesn't provide automatic installer or DKMS (dynamic kernel module support), the AJA driver must be recompiled and reinstalled using the instructions above after any kernel upgrade. You must also request Dante driver for your new kernel version from info@four-audio.com.

    OS Configuration and Setup for Windows 10 (64bit)

    Ozo Live services can be installed in any vanilla Windows 10 systems with a few dependencies.

    1. Install Blackmagic driver

    If you are using Blackmagic PCI cards or Thunderbolt devices for SDI input and output, you must install the Blackmagic driver. Download it from:
    https://www.blackmagicdesign.com/support/family/capture-and-playback

    2. Install AJA driver

    If you are using an AJA PCI card for SDI output, you must install the AJA driver. For compatible Kona devices, download the latest Windows driver from the AJA website:
    https://www.aja.com/products/kona-4#support.

    For AJA Corvid devices, the driver is shipped with the AJA ntv2 SDK, please contact AJA support for access. We recommend using the latest release version of 13.0.0.

    3. Install Nvidia driver

    You need to install the latest Nvidia drivers in order to support OZO Live video streaming. Download official Nvidia driver releases from:
    http://www.nvidia.com/Download/index.aspx

    Nvidia driver can be easily updated via the Geforce Experience application installed with the previous driver.

    To verify proper GPU configuration via the command line, "nvidia-smi" is installed under "C:\Program Files\NVIDIA Corporation\NVSMI".

    4. Install Java

    OZO Live depends on Java. Get the latest from here:
    https://java.com/en/download/

    5. Install Dante Driver

    Follow the installation instructions of your Dante PCIe card. If you have selected to use Dante Virtual Sound card, please install the software and configure it to use one of your computer's open Ethernet interfaces.

    You can use any professional hardware sound cards. There are many Dante-capable cards on the market by manufacturers such as Focusrite and Yamaha. At the time of this writing, Windows Drivers for the Four Audio Dante PCIe sound card are not available. (We are working with the manufacturer to enable a Windows driver as soon as possible. Stay tuned).

    OZO Live Windows supports devices that are accessible through WASAPI and ASIO interfaces. In practice, these two options cover all Windows-compatible sound devices.

    We have tested the Dante Virtual Soundcard (DVS) by Audinate. This driver turns a standard dedicated Ethernet connection into a Dante-enabled sound card.

    As of this writing, you can purchase a DVS from Audinate.

    Installing OZO Live

    Live Server supports both Ubuntu 16.04Ubuntu 16.04 or Windows 10

    Installing OZO Live for Ubuntu

    Copy the package file to your server

    To install OZO Live when not online, use a USB stick to copy the deb file to your hard drive.

    1. Make sure you are using a USB stick formatted as FAT32. (By default, Ubuntu doesn’t support exFAT.)
    2. Copy the deb file to the USB stick.
    3. Plug the USB stick onto the streamer machine.
    4. Use following step in the OZO Live machine to mount the USB stick and copy the file:

    $ dmesg

    You should see output similar to the following:

    [82807.081078] sd 6:0:0:0: Attached scsi generic sg1 type 0
    [82807.081234] sd 6:0:0:0: [sdb] 15728640 512-byte logical blocks:
    (8.05 GB/7.50 GiB)
    [82807.081370] sd 6:0:0:0: [sdb] Write Protect is off
    [82807.081372] sd 6:0:0:0: [sdb] Mode Sense: 0b 00 00 08
    [82807.081489] sd 6:0:0:0: [sdb] No Caching mode page found
    [82807.081858] sd 6:0:0:0: [sdb] Assuming drive cache:     write through
    [82807.103226]  sdb:
    [82807.103947] sd 6:0:0:0: [sdb] Attached SCSI removable disk

    Find the drive name for your removable disk; in this case it is myusb;


    /mnt is created to mount your USB

    $ sudo mount /dev/myusb /mnt
    $ cp /mnt/OZOxxx.deb ~/

    If the machine is connected to a network, transfer the file over IP:

    Find the IP address of OZO Live machine.

    $ ifconfig

    You can check the DHCP lease log in router or you can use ifconfig or the following command to find from the machine:

    $ hostname -I

    192.168.96.103

    In this case, the ip address is 192.168.96.103

    Use the following command from your PC to copy the deb file:

    $ scp OZO-Live-xxxx.deb nokia@192.168.96.103:/home/nokia

    Installing the OZO Live package

    The OZO Live application is delivered as a Debian package. You need to run following command to install:

    $ sudo dpkg -i OZO-Live-xxx.xxxx.xx-Linux.deb

    All the related files will be installed under/opt/nokia/ozo_live

    Take time to review release notes located in/opt/nokia/ozo_live/ReadMe.txt

    In some cases, an upgrade may require that you update dependencies, such as device drivers. Check the release notes for these requirements, but if you get an error for a dependency please install/update the dependent packages.

    As an example, an installation without properly installed GPU drivers might provide an error similar to the following:

    $ sudo dpkg -i OZO_Live-20160713.1249-Linux.deb

    (Reading database ... 129937 files and directories currently installed.)
    Preparing to unpack OZO_Live-20160713.1249-Linux.deb ...
    Unpacking ozo_live (20160713.1249) over (20160713.1249) ...
    dpkg: dependency problems prevent configuration of ozo_live:
    ozo_live depends on nvidia-381; however:
    Package nvidia-381 is not installed.
    dpkg: error processing package ozo_live (--install):
    dependency problems - leaving unconfigured
    Errors were encountered while processing:
    ozo_live

    In this case please refer to the Nvidia Driver installation instructions in:  Configuration and Setup  and retry the installation after installing the required drivers.

    Once you have completed a successful installation, reboot the system. OZO Live will start automatically.

    OZO Live runs as two separate services: a core processing service, which performs the video and audio pipeline service, and a web service, which presents a graphical user interface to any browser.

    Both services start automatically on system boot; the GUI operates as a service (ozo-live-web) running on standard HTTP port 80, which communicates with the core service (ozo-live-pipeline) using port 3000.

    Please note: After installing OZO Live 2.0.1 and loading the web interface, some browsers (particularly Chrome) return an "Error Loading Page." In this instance, please just clear the cache and reload the web interface.

    Uninstalling OZO Live

    If you want to remove OZO Live from the system, use the following command.

    $ sudo apt remove ozo_Live

    Installing OZO Live for Windows


    Before you start, please ensure you have installed Java. If not, the OZO Live installer will prompt you to do so:

    Once Java is installed, simply follow the OZO Live installation dialogue boxes:

    OZO Live is installed in your system within "C:\Program Files\Nokia OZO" along with other OZO ecosystem applications.

    OZO Live pipeline and web services start automatically after installation.

    Uninstalling OZO Live

    Uninstall OZO Live either from the Control Panel -> Program and Features, or by invoking the "uninst.exe" you'll find within the OZO Live installation folder.

    OZO Live Windows specifics

    Interoperability with other applications

    OZO Live releases hardware resources when idle and not streaming.

    Before starting your stream, however, we highly recommend closing other applications such as OZO Creator, OZO Remote, or any other applications that heavily utilize the GPU.

    Working with OZO Remote, and OZO Live on the same System

    The release of OZO Live for Windows allows the user to use OZO Remote, OZO Creator, and OZO Live on the same system. However, as some hardware resources such as GPUs and SDI input devices are shared among these applications, it's a good idea to close one before starting another.

    Here are a couple workflow suggestions.

    1. Stop OZO Live pipeline from the web UI
    2. Launch OZO Remote
    3. Set exposure, color temperature, etc.
    4. Close OZO Remote
    5. Restart OZO Live pipeline from the web UI

    Please note that you will have to stop the stream before using OZO Remote.

    An alternative might be:

    1. Open OZO Remote
    2. Open Preferences
    3. Choose Other -> Disable preview and SDI. (this releases GPU resources and disables SDI).
    4. Restart OZO Remote

    This will allow you to use OZO Remote wirelessly, while using OZO Live for preview and broadcast.

    Troubleshooting failure to start stream

    If OZO Live fails to start, and returns error messages related to missing input and/or output devices. You may verify I/O device installation using the native Windows device manager, as shown below. Devices can be found under Sound, video and game controllers.

    If any attached PCI Express or Thunderbolt devices are not listed, or are shown as installed properly when they're causing a problem, try rebooting the system. If those solutions do not work, reinstall device drivers and update the device firmware if required.

    While you may also verify valid SDI input sources by using other applications such as Blackmagic Media Express or OZO Remote, ensure that all your software versions and drivers are up to date.

    Thunderbolt 3 support

    Host computers with Thunderbolt 3 ports can connect to Blackmagic devices, such as UltraStudio Mini Recorder, UltraStudio 4k and HyperDeck Studio Pro.

    Before connecting to your device, download and install the latest drivers from either your laptop or motherboard manufacturer's website. (As of this writing, driver support for Thunderbolt 3 is limited to Windows 10.)

    Unlike USB devices, users must manually authenticate Thunderbolt 3 devices before the system will recognize them.

    1. When first connecting a Thunderbolt 3 device, you should see an automatic notification above the system tray notifying a new device has been attached, click OK to proceed.
    2. If a Windows User Account Control pops up asking to allow this app to make changes to your PC, click Yes.
    3. To approve the device you just connected, select Always Connect from the drop-down menu, click OK.

    Verify newly-attached devices, and manage approved devices by accessing the Thunderbolt Software icon in the system tray.

    Please allow for up to 5 seconds for OZO Live to discover a newly attached Blackmagic input/output device via Thunderbolt.

    If the icon is not listed in the system tray, search the Start menu for Thunderbolt to open it manually. Also, if the attached device is not listed (this is a known issue when detaching and re-attaching a Blackmagic device via Thunderbolt), you will need to restart Windows and re-verify.

    Manually control OZO Live Services

    Though OZO Live services start automatically when Windows starts, you can start, stop or restart services manually in Windows Task Manager -> Services, or by running the local Services application, as shown below.

    Using OZO Live

    Operating OZO Live

    Operating OZO Live from a Web Browser

    The GUI provides easy control of the functionality of OZO Live, and has been tested on a range of browsers including Chrome, Firefox and Safari mobile. (note: OZO Live does not support Internet Explorer.)

    To access the OZO Live GUI, point your web browser at the IP address of the OZO Live server.

    Operating OZO Live with the OZO Live Control App

    The OZO Live Control app is a native helper application that runs on your PC or Mac, and can be downloaded for free from the OZO Software download page. (The OZO Live Control app downloads and installs automatically into the Nokia OZO directory when installing OZO Live for Windows)

    Install the OZO Live control app on any of your networked computers to be able to access available OZO Live nodes without needing a web browser.

    Broadcast


    The Broadcast tab provides access to the basic settings for control of the OZO Live server.

    Click the icon on the bottom left of the broadcast image to increase it to full-screen. Hit escape to return to the normal view.

    Multinode Licenses

    Click Add Node and add the IP addresses of your servers. You can rename the node by clicking the pencil icon.

    Node View alerts indicate the current status of your OZO Live system.
    OkayGreen: Node is connected, and system is running as intended.
    WarningYellow: Node is connected, and has found some minor issues. Please consult the Logs page for specific information.
    ErrorRed: Node is connected, and has found some major issues. Please consult the Logs page for specific information.
    UnreachableNode is not connected. Check the network settings and that the OZO Live services are running.
    No ConnectionThe node is unable to connect the OZO Live pipeline service. Try to restart the OZO Live pipeline service.
    IncompatiblePlease ensure that all connected versions of OZO Live are identical.

    Enable All Features

    Enabling All Features, found under the System tab, activates the Multinode feature.

    Multiview

    A Multinode license of OZO Live also brings the convenience of a multiview monitoring system to your desktop.

    Select from among four different screen layouts:

    System Workload Monitor

    Overloading your CPU/GPU can result in overheating, frame drops, and other anomalies. The system workload monitor gives you a visual indication of the load on OZO Live.

    Once enabled, the sharpening and hue/saturation filters affect the system workload equally. In other words, their usage is not determined by the value you set.

    Denoising has the greatest effect on utilization, especially when set higher than 7, when spatial denoising kicks in.

    Note: High-end GPUs, such as the 1080 Ti/Titan can sustain more workload without dropping frames than lesser ones, such as the 1080/1070.

    The following images show the workload monitor of single 1070 GPU, streaming UHD stereo @30fps over SDI.

    1. First image shows utilization with default color filter parameter set, denoising=4, sharpening=3, hue/saturation OFF.
    2. Second image shows utilization with denoising=6, sharpening=6, hue/saturation ON.
    3. Third image shows utilization with denoising=7, sharpening=6, hue/saturation OFF.

    Though the underlying 1070 can run temporal denoising up to level 6 with sharpening and hue/saturation filters enabled, spatial denoising will overload the GPU and produce frame drops.

    If the system enters the red zone, selectively reduce your use of filters.

    Click anywhere on the monitor to reset.

    Audio Settings

    Adjust your audio delay and gain here. Delay audio from -500ms to 3000ms.


    (Users of OZO Live Singlenode and Multinode licenses can also adjust gain and delay from the Audio tab as well).

    Output Settings

    Frame Rates

    The OZO camera runs at a fixed 30fps. OZO Live enables alternate frame rate output in order to support downstream equipment. These rates are supported with simple frame removal or doubling.

    Video Formats

    The format you choose depnds on your final viewing requirements. For instance, most third-party players for hand-held devices require an the equirectangular projection in either mono or "top/bottom" stereo.

    OZO Live uses the four "equatorial" lenses on the OZO to create a stereoscopic output. Three cameras (Far Left (cam1), Left (cam2) and Far Right (cam4) ) are used for monoscopic output.

    Audio Formats

    Audio is an essential component of the immersive 360 video experience: While our eyes give us about 110°, or 170° if we turn our heads fully, our ears allow us a full 360° of immersion.

    OZO Live contains an audio processing subsystem which can convert the 8 microphone signals from the OZO into a number of output formats. Standard output is at 48kHz, 24bit.

    Make basic audio selections on the Broadcast page. Here you can convert the eight microphone signals from the OZO into a number of output formats. Standard output is at 48kHz, 24bit.

    While you can establish basic parameters from within the Broadcast tab, the Audio and Position tools (both available in the full-featured OZO Live version) allow the audio professional add external audio and to have complete control over the spatial placement of audio. Please visit those links to learn more.

    5.1 Surround and Stereo formats run the 8 microphone signals from the OZO Camera through an OZO Audio processor within OZO Live that processes and downmixes all 8 microphones into either the 5.1 or stereo output format.

    The 8-channel option passes all inputs through. Though not recommended, this can be used to pass raw OZO microphone signals or external audio signals embedded into the input.

    OZO Live can delay audio to maintain sync with the video pipeline.

    The Audio tab provides more audio controls to singlenode and multinode users.

    Video Formats

    OZO Live can output the following resolutions over quad-link HD-SDI or 6G-SDI (depending on your output card):

    Note that resolutions or framerates exceeding the SDI card's capability will result in blank frames. Custom resolutions that are foreign to the installed SDI card will appear starting from the top-left corner of the first SDI output. File and RTMP output can support resolutions of up to 4096x4096.

    Start/Stop

    You can Start and Stop your stream as your production requires.

    Please note:

    Your remote stream must be running before you start your local stream from OZO Live.
    Once your stream starts broadcasting, you'll notice all input and output options lock.

    Outputs

    OZO Live enables both direct video output over SDI, and an encoded video bitstream via RTMP or File output. Click the "Add Output" button to choose one or both of these options. Output your OZO Live stream to:

    RTMP Delivery Settings

    OZO Live supports RTMP delivery by using the hardware encoder on the NVIDIA GPU card. Using RTMP, you can deliver an encoded stream to a wide variety of streaming services including YouTube 360, Facebook 360, Periscope 360, and virtually any video platform which can accept live RTMP ingest.

    Please note that you can not save a file while streaming via RTMP.

    URL

    Enter the URL for the RTMP ingest point in this box. As illustrated above, it will start with rtmp://

    Video and Audio Bitrate

    Enter the desired encoded bitrate for the video and audio streams, respectively, in these input fields. Note that the Video bitrate is expressed in megabits per second, while the audio bitrate is expressed in kilobits per second. Typical contribution bitrates for 4K content range from 20-50 Mbps. Typical bitrates for audio range from 128kbps to 512kbps for 5.1 surround.

    OZO Live also supports the following:

    Uplink Settings for YouTube 360 Live

    Follow YouTube's instructions for establishing a live 360 event. When creating the event, be sure to go to the "Advanced Settings" tab and tick the "This live stream is 360" box. On the "Ingestion Settings" tab, you will be shown a "Primary Server URL" as well as a "Stream Name." You must concatenate these two fields to create the final URI that is entered into OZO Live.

    The dialog box may look like this:

    As an example,

    the Server URL might be:

    rtmp://a.rtmp.youtube.com/live2

    and the Stream Name might be:

    ht58-u2h4-q208-dguw.

    In this case you would enter the following URI into OZO Live:

    rtmp://a.rtmp.youtube.com/live2/ht58-u2h4-q208-dguw

    The subsequent output would look like this:

    At the time of writing, YouTube supports only 30fps monoscopic ingest, and requires a bitrate between 13-30 Mbps. Please visit the YouTube site to confirm current requirements.

    Delivering for Facebook Live

    Before you start, Make sure your Facebook settings allow Live Delivery.


    From within the Broadcast tab of OZO Live, Select Facebook in the Output menu (it will look something like this):

    As of this writing, these are the optimal OZO Live settings for Facebook:

    If your output is set for something that does not match the Facebook recommended settings, OZO Live will return a warning:

    At this point, you can proceed, or adjust your output settings.

    Color


    The Color tab enables control over color correction, white balance, denoising and sharpening. Adjustments are processed in real time.

    Color Correction

    OZO Live lets you color correct each lens, or the entire visual frame. Though in most cases you wont need to color balance individual lenses, this feature helps adjust your image if one side of the camera is particularly darker or brighter than the other.

    You can modify and edit single channels, or select the Link button and modify levels across the three channels simultaneously.

    White Level defaults to 1, and Black Level to 0, giving you control over the camera's entire dynamic range. In addition to being able to adjust the white and black levels, you can also modify the gamma to maintain dynamic range while increasing or decreasing overall contrast.

    When in Global correction, the "Reset" button resets all correction values to defaults. When modifying a specific lens, the "Reset" button resets the values of that particular lens.

    Illuminant

    The illuminant affects the white balance of the image. Selected using OZO Remote, the illuminant is metadata carried with the image and does not modify the OZO Raw file, allowing the user to modify this setting from within OZO Live.

    Override Remote Setting switch OFF: OZO Remote Illuminant setting will be observed.

    Override Remote Setting switch ON: User may adjust the Illuminant using the slider in OZO Live.

    Video Filters

    OZO Live contains a number of video filters which allow the colorist full control over the image without the need for external color correction devices.

    Stitch


    The Stitch tab allows control of real-time stitching parameters, including blend width, convergence (double image) adjustment at three vertical places along the seam, and digital pan.

    Digital Pan

    Managing the viewer's attention is a major challenge in multi-camera VR productions. OZO Live's Digital Pan feature lets the director center the point of interest before cutting to a different camera. This lets the images flow naturally, rather than requiring your viewer to spin around looking for the performer he was just watching!

    When you find your lead singer has moved to the side of the frame

    You click and drag the preview image until he is front and center.

    While the camera remains physically stationary, the video output from OZO Live rotates along the Y-axis, providing the effect of a pan.

    Please note that the pan occurs in real-time without smoothing; the movement is jerky and will be obvious: Use Digital Pan in the camera being previewed, so you're in position when the director switches your camera to Program.

    Stitching: Per-Stitch Settings

    OZO Live combines the four (or three, for monoscopic output) sensor images from OZO into a single UHD output frame. The stitching settings allow the operator to optimize the seam areas.

    In stereoscopic mode, OZO has five stitch areas.

    When in monoscopic mode, the system provides four stitch areas.

    In both cases, each stitch area can be configured with a blend width, an offset, and three convergence settings vertically along all seams but the rear seam, which has no offset.

    The offset allows the stitch area to be moved left or right. OZO has overlap of about 25° between cameras, allowing stitch lines to be moved about 12.5° in either direction from its default center position.

    Measured in meters, convergence sets the distance at which the image from two adjacent sensors is perfectly aligned and appears as a single image.

    OZO Live supports three separate convergence depths across a single stitch area. These depths are interpolated vertically over the course of the stitch area, so you can adjust the convergence at the top, middle and bottom of your frame. This is particularly useful if, for instance, you have a performer in the foreground at the bottom of your frame, and a sponsor's logo in the distance which appears at the top of your frame. OZO Live allows you to align both, rather than needing to choose.

    A convergence value of 1 equals infinity; a convergence value of 1.1 equals .62 meters.

    Stitching: Auto Tune

    OZO Live Auto Tune gives you a good starting point for your stitch. In many cases, Auto Tune creates an excellent stitch without requiring any further user input. We recommend tuning your Seam Convergence first, and your Location second.

    Auto Tune Seam Location will examine the errors caused by each possible seam location across the image, and will choose a minimum-error location automatically.

    Auto Tune Convergence is an operation which attempts to determine the optimal convergence for all three convergence values, for each stitch in the scene, based on a minimum error algorithm.

    Note: Auto Tune causes a visible "stutter" in the image and may cause frames to repeat in output: Save Auto Tune for the camera being previewed.

    Audio for Live 360


    OZO Live provides the user with multiple audio solutions:

    Audio Format

    Make basic audio selctions on the Broadcast page. Here you can convert the 8 microphone signals from the OZO into a number of output formats. Standard output is at 48kHz, 24bit.

    5.1 Surround and stereo formats run the 8 microphone signals from the OZO Camera through an OZO Audio processor within OZO Live that processes and downmixes all 8 microphones into either the 5.1 or stereo output format.

    The 8-channel option passes all inputs through. Though not recommended, this can be used to pass raw OZO microphone signals or external audio signals embedded into the input.

    OZO Live can delay audio to maintain sync with the video pipeline.

    For more robust control of your audio sources, please see the Spatial Audio Mixing section of this document.

    The Nokia OZO family of products provides fully immersive, spatial audio experiences. Like all of OZO Live, there are multiple ways to integrate the system into your workflow. For instance, if you are looking for a single-camera experience using only OZO ambient audio, you can choose from among these formats:

    You can opt to de-embed OZO audio before it reaches OZO Live, mixing externally and re-embedding into OZO Live via SDI before you send your feed to the encoder.

    Some Configuration Examples


    One OZO, one encoder, external audio only

    Multiple OZOs, OZO ambient audio only

    Multiple OZOs, external audio only, unswitched

    Multiple OZOs, ambient audio PLUS external audio mix

    OZO Live: Audio Mixer

    Audio Mixer


    The OZO Live spatial audio mixer gives you the power and freedom to define and add multiple audio parameters, thus allowing you to control the precise audio mix for any given performance. This complements OZO Live's default audio settings, which broadcast audio captured with an OZO camera to either the OZO Live server's SDI output and/or the RTMP stream of your choice. Use a 48kHz sampling rate and 24-bit resolution, tweaking interactively throughout the course of a live event.

    Mix

    An OZO Live mix includes all settings required to input and output audio to and from OZO Live.

    The default mix begins with the audio settings you select in the Broadcast tab. Though you cannot remove the default mix, you can modify its settings in either the Broadcast or Audio tab.

    The Default Mix includes:

    The format of this audio output is specified in the Broadcast tab.

    Create a New Mix:

    Select the desired output format:

    Select the desired output device:

    Send output signals directly into SDI or RTMP, or use any channels from your output audio interface. Output channels in use are marked with a "Used by <mix name>" tag. OZO Live will add the channels together automatically.

    The list of output devices depends on the configuration of your computer, and will always display at least those outputs available from the Broadcast tab.

    Select your mix by clicking its name in the Mixes sidebar. Its settings will appear in the Mix column to the right.

    Regular vs pass-through mix

    A regular mix supports the following output formats:

    A pass-through mix comes directly from the audio engineer, and passes intact through OZO Live, which defines neither the ouput format nor the output location of the mix. (Pass through is defined in more detail below)

    To Change the Mix Order

    To Delete a Mix

    To Broadcast a Mix from the OZO Live server

    Adding a new Sound Source

    Click the + sign in the Sound Sources sidebar

    Alternately, click the + sign in the mixer, and follow the dialog.

    The general properties of a sound source include:

    In the case of an OZO Live sound source, the eight microphone channels can be taken either directly from an SDI input device, or through a separate audio input interface (should the microphone signals be available there). In both cases the channel order should always be 1-8.

    A single sound source can be used in several mixes.

    For example, in the case of a small-scale live event, all bands may need to use the same drum set. While each band would have a distinct mix, all bands could share the same drum sound sources.

    To use a sound source in several mixes, click the checkboxes in the bottom of the dialog.

    Note that changing the general properties of a sound source will affect all mixes that include that sound source.

    To re-edit the properties of a sound source, click the gear icon next to its name, or change the values directly in the Sound Source Controls panel in the mixer.

    Clicking any of the circular or semi-circular controls in the mixer reveals a lever you can drag to your chosen value. Double clicking the value or the control resets its value to zero.

    Drag-and-drop to reorder your sound sources, or click the "A-Z" icon in the sidebar to sort the sound sources in alphabetical order.

    Toggle FILTER > MIX or FILTER > ALL to switch the visible sound sources to the selected mix.

    To delete a sound source, click its tool icon, and click remove from the dialog box.

    Broadcasting Multiple Audio Output Formats Simultaneously

    Add a new output format:

    Mixes are inactive until you click the ACTIVE button next to the mix name. De-activating unused mixes saves processing power.

    Creating a Binaural Monitor Output

    Be careful when selecting the channel numbers to avoid sending the monitor mix to the live stream.

    Mixer

    The mixer resembles that of common digital audio workstations (DAW) and hardware mixing consoles.

    The top section contains global sound source controls (which you can also access from the Sound Sources sidebar) and per-channel input gain trim control.

    Mix Column

    The Mix column shows the status of the currently selected mix. This status appears in both the Mixes sidebar and the Live Stream column.

    Mixes with multiple audio output formats provide:

    The same faders appear horizontally in the Live Stream column (below).

    Live Stream Column

    The Live Stream column shows the audio outputs of all mixes currently broadcasting from the OZO Live server. Toggling the LIVE button both stops the stream and removes all adjustment controls.

    Adjusting Gain

    Adjusting gain can be useful for balancing the different output formats of a single mix, or for balancing multiple mixes.

    Mute and Solo

    The solo and mute buttons, as well as fader, gain, and peak level indicator also resembles that of common digital audio workstations.

    Mute overrides solo in OZO Live.

    Source Position Controls

    OZO Live supports full 360 spatial audio. For sources other than the OZO camera, set the desired azimuth and elevation angles for each separate sound source.

    Under the Mix Controls section, click and drag the circular control to your desired value. Alternately, you can adjust this from within the Position tab.

    The Delay Setting

    The time required to route and process the sound sources may vary among audio input devices. OZO Live currently supports values from -500 to 3000 milliseconds for mix outputs and and 0 to 3000 milliseconds for sound sources.

    Pass-through mixes and Sound Sources

    While the purpose of OZO Live Audio is to create spatial audio mixes, in some cases it may also be desirable to connect sound sources directly to the output of the OZO Live server, bypassing any spatial processing. For example, your production may rely entirely on pre-recorded stereo soundtracks or 5.1 audio played from a DAW.

    Should your audio come from the SDI input of the OZO Live server, you can route it directly to the SDI output using the settings in the Broadcast tab. In the case of other audio interfaces, you must create a special pass-through mix, where all sound sources are routed directly to the output channels of the mix. Unlike the other mixes, pass-through mixes do not have a specified stream output format (e.g., Surround 7.1), but the audio channels are transmitted as they are, without any spatial processing. Create a pass-through mix by clicking the + icon in the Mixes sidebar, and then toggle Pass Through in the dialog box.

    Pass-through mixes only work with special OZO Live multichannel pass-through sound sources, which are visualized using horizontal faders in the mixer. Pass-through inputs are automatically sent to the outputs of the pass-through mix, starting from the first available channel number. Currently, pass-through mixes have maximum eight output channels.

    For example:

    Position


    Position allows you to visually modify the elevation and azimuth angles of each Sound Source.

    Select the Mix whose sources you would like to position.

    To see a list of all Sound Sources of a certain Mix, click the checkbox next to its name, which will add its name to the main window. Then, simply grab and move it to your desired location.

    Deselect a Sound Source if you wish to hide it.

    Note: OZO+ and pass-through sources are visible but disabled as they do not have a position setting.

    The Audio tab reflects changes in the elevation and azimuth angles: You should hear their effect in the output(s) of the corresponding live mixes.

    Operating OZO Live from the Command-line


    OZO Live may be operated in command-line mode. This mode enables some scripting workflows and may permit access to early features before they are available within the graphical UI.

    In order to access the command-line mode, you must first access the OZO Live machine, either from a connected keyboard/monitor, or using SSH from a terminal client.

    Running OZO Live as a service

    In most cases, the core OZO Live capability runs as two services (or daemons). These are called the ozo-live-pipeline and ozo-live-web. The ozo-live-pipeline service does the all the processing of the video and audio and the ozo-live-web is managing the web application. By default the OZO Live services starts automatically on boot, or on reboot or power-on. To manage the OZO Live services, the following commands are useful.

    To see the current status of the services, use:

    $ sudo service ozo-live-web status

    $ sudo service ozo-live-pipeline status

    To restart a currently running service:

    $ sudo service ozo-live-web restart

    $ sudo service ozo-live-pipeline restart

    To stop a service:

    $ sudo service ozo-live-web stop

    $ sudo service ozo-live-pipeline stop

    To start a service:

    $ sudo service ozo-live-web start

    $ sudo service ozo-live-pipeline start

    Once the ozo-live-pipeline service is started, commands are delivered using the netcat on port 30001.

    $ nc localhost 30001 (when logged into the machine)

    Once connected to the interface, press h (and return) to see available options.

    OZO LIVE

    OZO Best Practices

    Best Practices for Live 360 Video


    VR is a new medium, and live 360 video production is perhaps the most intense, stressful, and gratifying way to create VR content. As always, careful planning reduces risk and helps ensure a smooth production. In this section we share some of our early experiences with 360 video productions using OZO Live.

    Many aspects of live 360 production are shared with standard live video production; these are out of scope for this document. Our focus is on the unique aspects of 360.

    Camera Placement

    Camera placement is everything. Get as close to the action as you can! Sometimes, as in the first image, that means you're pretty far away:

    Sometimes it means you're up close and personal!

    Always fight for camera placement.360 video works when the camera is close to the subject; it becomes boring when the camera is far away. (OZO's award-winning design makes it easier to convince reluctant producers to give you prime placement: It's the single most important thing you can do to make a compelling production.) Remember that you're giving your audience an opportunity to see what they couldn't otherwise experience. With OZO Live's digital pan function, you can recenter your area of interest, but you can't zoom! So, get as close as the production will let you!

    Moving Cameras

    Moving cameras in 360 adds dimension and interest to a live production. As long as you keep your horizon level, and your motion even and slow, motion adds enormous depth and interest to your productions. Combined with motion parallax, OZO's stereo capabilities provide a compelling sense of immersion. With OZO Live's digital pan feature, you can maintain the user's viewing direction even when using jibs and booms. Please try out jibs, booms, dollys, and other motion platforms with OZO Live: you wont be disappointed!

    Multi-camera Shoots

    Like multi-camera television shows, 360 video productions are much more compelling with a skilled director managing the viewers' attention across multiple camera viewpoints. Use the following multi-camera best practices as a starting point, but experiment and draw your own conclusions!

    LED Light Flicker

    Direct Sunlight

    Rain

    OZO is not waterproof. However, with care, even under heavy rain (and some wind) you can produce a successful event.

    The buttons and connections at the top and bottom of OZO are the areas most susceptible to water. Use clear packing tape to cover the buttons; you'll still be able to use them. Also, wrap tape around your cables, sealing them to the body - this area is already protected by the camera itself and would only be a risk in a hurricane!

    Keeping rain off the lenses is another matter. We've had success by using a half-meter square of Plexiglas, mounted above the camera using a Magic Arm. This can be angled to protect the camera from driving rain. The rain shield is visible, but it's not as distracting as you might think: if you angle it correctly you can keep it out of a typical user's viewport for a typical production, and any raindrops on the shield are so close to the camera they're out of focus. An example:

    Cold

    OZO behaves well in cold environments; no special measures should be necessary even when operating at temperatures well below its 0° Centigrade specification.

    Heat

    Heat requires management: OZO does not like direct sunlight. Follow these steps to avoid a heat-related shut down:

    Simple Signalflow Diagrams


    OZO Live is a versatile real-time software solution for single and multi-camera productions. Though every production is unique, to get you started, we're including sample production architectures for single camera and multi-camera productions. The quad-link HD-SDI output of OZO Live is compatible with standard 4k video production equipment, enabling a wide range of live production options. You might also choose to output over a single 12 SDI cable. It's entirely up to you and your workflow.

    Single Camera

    Multi Camera

    or

    Support

    System Alerts

    The system screen gives you access to support, additional features, system reset, licensing, etc.

    Logs

    The entire OZO team wants to make sure your experience with OZO Live is awesome. We are ready to help, and are eager for your feedback.

    OZO Live Forum


    The OZO Live Forum is a place for OZO Live users and partners to exchange information. It may be found as part of the "Support and Community" section of the Nokia OZO website, at http://support.ozo.nokia.com/

    Support


    Registered users of OZO may access the OZO Support team via email at OZOsupport@nokia.com or online form at https://ozo.nokia.com/ozo_en/contact/. Customer support requests will be responded to within 24 hours.

    It helps the whole community if you report any issues you find with OZO Live. Please run following command in the folder that you ran the ozo_live application.

    $ sudo /opt/nokia/ozo_live/bin/report.sh

    Or go to the System Tab and click Download Report:

    Report_201610281154.txt.gz is generated, please attach the file in the support request

    You will see report_xxxx.txt.gz in the same folder. Attaching this file to your support request will help the support team diagnose your issue quickly and efficiently.

    Licensing OZO Live

    License Activation


    Without an active license, OZO Live installs and runs with full functionality, but watermarks the output video and audio. Audio watermark is a morse coded message on the audio tracks. To remove the watermark and validate the ability to use OZO Live for commercial broadcasts, you must apply an Activation Key.

    The turnaround for this license can be as long as 72 hours, so make sure you don't wait until production day to request your Activation Key!!

    Requesting Activation Key

    Open a web browser and go to http://<ip address of OZO Live machine>/, then click "System" on the left panel. You will see a screen like the following image.

    Clicking the "REQUEST ACTIVATION KEY" button opens this instruction window:

    Download the identifier file: "ozo_live.license_request".

    Email this file to OZOsupport@nokia.com with the reference to your purchase order number. The OZO Support team will validate your purchase and provide an Activation Key within 72 hours.

    Installing Activation Key

    Once you get an ozo_live_<anything>.licfile from OZO Support, open a web browser and move to "Settings" page. Click "add activation key" button and point to the Activation Key file that you saved from email.

    The Activation Key will be stored and validated.

    Additional Support

    Should you need additional support, press the "Download Report" button in the System tab. Email the downloaded report to OZOsupport@nokia.com

    Legal Information

    OZO Live ships with both third-party and open source software. A listing of the open source software and the accompanying license terms is included with the software package. Please press the "Licensing Terms" button in the System tab to read the applicable license terms.

    Your use of the Licensed Software is only permitted if you comply with the terms and conditions of the open source software licenses.

    Copyright © Nokia Technologies Ltd. and/or its subsidiary(-ies).

    This OZO Live software, including the accompanying documentation, is protected by copyright controlled by Nokia Technologies Ltd. All rights reserved. Unless you have signed an individually negotiated license agreement with Nokia, the license terms applicable to your use of this software are available at:

    The OZO Live Software agreement is available at https://store.ozo.nokia.com/media/custom/upload/OZO_Live_Terms_and_Conditions_EN.pdf

    If you have signed an individually negotiated license agreement with Nokia, the terms contained in that license agreement shall govern your use of this software.

    About

    OZO Live is developed by a highly dedicated and skilled team of people. Contributions have been made by, in no particular order: