How to Set Up an Intel NUC for Dolby Voice Hub App Development

Table of Contents

  1. Introduction
  2. Hardware Requirements
  3. Boot the Dolby Voice Hub
    3.1. Prepare the USB stick
    3.2. Configure the Intel NUC to boot from USB
    3.3. Boot sequence
  4. Configure the System
    4.1. Find the Dolby Voice Hub IP Address
    4.2. Configure the Dolby Conference Phone
           4.2.1. Update the Dolby Conference Phone
           4.2.2. Configure other critical parameters on the Dolby Conference Phone
    4.3. Configure the Dolby Voice Hub
  5. Software update
    5.1. Prepare the provisioning server
    5.2. Connect the Dolby Voice Hub to the provisioning server
  6. Acquire and Install Dolby Certificates

1. Introduction

This document is created for Dolby Voice Hub App developers. It describes how to set up an Intel NUC and Dolby Conference Phone for app development. If you already have the Dolby Voice Hub hardware, then you can use this document as a reference, but most of the procedures will not be applicable.

These instructions are applicable to Dolby Voice Hub software version main.716 or above and Dolby Conference Phone Simone.82 or above software.

Note: Starting with the version ITS-5 released on Dec. 5, 2017, all Dolby Voice Hubs as well as Intel NUCs need a Dolby-issued certificate to function properly. See section 6 for details.

2. Hardware Requirements

Before you start, make sure you have the following hardware ready.

Index Hardware Specification
1 Intel NUC 6th generation ("Skylake") i3 platform (identical to Dolby Voice Hub hardware platform), with 4GB RAM. You do not need a built-in storage device such as an M.2 SSD card.

Please note that Intel has discontinued the 6th generation NUC. Unfortunately, the Dolby Voice Hub software is not compatible with the 7th generation NUC. Please make sure you purchase a 6th generation NUC for development purposes. Here's one source for purchasing the 6th generation i3.
2 USB stick 4GB USB 3.0
3 USB camera Logitech C930; any other USB camera will work, as well
4 Dolby Conference Phone The phone must have Simone.x software installed. Simone is the code name for the upcoming Dolby Conference Phone software that is designed to work with Dolby Voice Hub. The Simone.x software is contained in the Dolby Voice Hub software (see section 4.2.1).
5 PoE switch or PoE injector Dolby Conference Phone requires Power over Ethernet (PoE)
6 TV Supports at least 1080p resolution
7 USB mouse and keyboard Required when using the NUC's console mode or GUI mode.
8 Cables 1 HDMI (output to TV), 3x Ethernet cable (minimum 3 feet)

3. Boot the Dolby Voice Hub

3.1. Prepare the USB stick

The USB stick needs to be populated with Dolby Voice Hub software, available through a Dolby shared folder on Box. Please reach out to your Dolby counterparts to obtain the Dolby Voice Hub platform software.

  • Download the image from the Dolby-provided location.
  • Flash it to the USB drive using dd or any suitable windows tool. When using dd on MacOS X, use /dev/rdiskN as the of= argument instead of /dev/diskN (more details). On Linux make sure the of= argument is the whole device, i.e., /dev/sdb, not a partition node like /dev/sdb1.

3.2. Configure the Intel NUC to boot from USB

  • Power on the NUC with keyboard/mouse attached; press F2 to enter the BIOS setup.
  • Enable Internal UEFI Shell and USB under the Boot Configuration menu, as shown below.

image

  • Save the changes, then reboot.
  • The UEFI Shell has a 5-second timeout during boot. Wait for the timeout to complete; then the system will boot from Linux.

3.3. Boot sequence

The NUC will boot up showing a blue screen with a menu. This is the Dolby boot loader screen which eventually will not be displayed on the final Dolby Voice Hub product. Depending on whether you have an internal storage device (e.g., an M.2 SSD card), you may or may not need to select the booting device. If you don't have an internal storage device, then the first entry in the menu will work.

By default, the Dolby Voice Hub software boots up showing a YouTube playlist. Once you see the video, it means the system is fully booted and is ready for you to move to the next section of this document.

4. Configure the System

4.1. Find the Dolby Voice Hub IP Address

Identifying the Dolby Voice Hub IP address is important because you will need this information to configure the Dolby Conference Phone to point to the NUC.

  • Connect a USB keyboard to the Intel NUC.
  • Press Ctrl + Alt + F2 to switch to console
  • Login as root
  • Type ifconfig and mark down the IP address
  • Press Ctrl + Alt + F8 to return to the GUI

image

4.2. Configure the Dolby Conference Phone

4.2.1. Update the Dolby Conference Phone

The Dolby Voice Hub software contains a provisioning server that can supply the matching software to the Dolby Conference Phone. Follow the instructions below to configure the Dolby Conference Phone to provision itself using the Dolby Voice Hub.

  • Power on the Dolby Conference Phone and get the Dolby Conference Phone's IP address by pressing Settings > ... > About
  • On a computer browser, enter the Dolby Conference Phone's IP address to access the web UI. Log in as admin/1739.
  • Under Settings > Provisioning > Server, set the following fields:

Configuration Value
"Manual Server Configuration" On
"Provisioning Server Address" Dolby Voice Hub IP address
"Provisioning Server Type" HTTP

Click "Save". The Dolby Conference Phone will start the software upgrade process.

4.2.2. Configure other critical parameters on the Dolby Conference Phone

Once the Dolby Conference Phone completes the software update, follow the procedure below to complete the setup.

  • Under Settings > Dolby Voice Conferencing Service > Peer Device, enter the Dolby Voice Hub IP address, then click Save.
  • Under Settings > IP PBX Settings > Server > Primary Call Server / Primary Call Server / Outbound Proxy, enter Dolby Voice Hub IP address; click Save.
  • Under Settings > Video Hub > IP Address, enter the NUC's IP address. Click Save; the Dolby Conference Phone will reboot.

4.3. Configure the Dolby Voice Hub

Now you are ready to configure the Dolby Voice Hub for loading your apps. The Dolby Voice Hub app architecture contains two app components:

  • A Web App that runs on the Dolby Voice Hub itself (TVUI app).
  • A CSAF (Conferencing Service Application Framework) app that runs on the Dolby Conference Phone.

To configure the Dolby Voice Hub to run these apps, follow the instructions below:

  • On a computer browser, enter the Dolby Voice Hub's IP address to access the Web UI. Log in as admin/1739.
  • Under Settings > Dolby Conferencing Service > Hub Application, enter the URL that the Dolby Voice Hub will use to load the TVUI web app. For your convenience, Dolby has created https://rtc2.trydcc.com to demonstrate the Dolby Voice Hub capabilities.
  • Under Settings > Dolby Conference Phone > Application, enter the URL that the Dolby Conference Phone will use to load the CSAF app. At this time, there is no tailor-made app for the Dolby Voice Hub/Dolby Conference Phone configuration, but to get audio connected on the Dolby Conference Phone you can configure this parameter to load any CSAF app.

5. Software update

You can always use the wic file to update the Dolby Voice Hub by following section 3.1. However, the Dolby Voice Hub supports an easier and faster software update mechanism using provisioning. This is the intended software update mechanism in production.

5.1. Prepare the provisioning server

From time to time, Dolby releases a Dolby Voice Hub software update package. This is a .zip file that is similar to the one created for the Dolby Conference Phone. To update the Dolby Voice Hub, follow the instructions below.

  • Read the "Dolby Voice Hub Service Provider Provisioning Guide".
  • Set up a Web server, and unzip the .zip file into the web server's document root folder. Make sure both the .meta and .tar.gz files are in the same folder.
  • Create/Update the master configuration file as follows (assuming you plan to update to main.716 release):

{
    "directory_file": "directory.json",
    "certificates": [
        "certs.pem"
    ],
    "img_file": "",
    "cfg_files": [
        ""
    ],
    "vpu9000": {
        "img_file": "dvhh-main.716.tar.gz",
        "cfg_files": [
            "voicehub-config.json"
        ]
    }
}

5.2. Connect the Dolby Voice Hub to the provisioning server

  • Follow section 4.1 to find the Dolby Voice Hub IP address.
  • Enter the IP address in your web browser.
  • Login as "admin" and "1739".
  • Go to Settings > Provisioning and enter the provisioning server/host name in the server field, as shown below.

image

  • Similar to Dolby Conference Phone, you can force the Dolby Voice Hub to reprovision itself by going to the Web interface Tools > Utilities and clicking on "You can synchronize with the provisioning server using this link".

image

6. Acquire and Install Dolby Certificates

As of release ITS-5, all Dolby Voice Hubs and Intel NUCs require a Dolby certificate. This section provides instructions to get the certificates and install them onto Dolby Voice Hubs or Intel NUCs.

Step-by-Step Instructions

  1. Prepare a list of Dolby Voice Hub and NUC serial numbers and save them in a text file.

    To get the serial number, log in to the Dolby Voice Hub/NUC Web UI (admin/1739) and navigate to Status > System > Device > Serial Number.


    Create a text file that lists each serial number on a separate line:
    Z0654358
    Z0654359
    Z0654360
    Z0654361
    Z0654362
    Z0654363
    
  2. Email the serial number text file to *dcpsdksupport@dolby.com*.
  3. Dolby generates the signed certificates based on the serial numbers and returns the new certificates. Each device will have its own SN.tar.gz file.
  4. Transfer the SN.tar.gz to the Dolby Voice Hub/NUC (using scp, for example) to /usr/dolby/data.
  5. Issue the following Linux commands to install the certificate onto the Hub.
    umount  /sstorage
    mkfs.ext2 -F /dev/mapper/sstorage
    mount /dev/mapper/sstorage /sstorage/
    tar -x -v -f Z0123456.tar.gz -C /sstorage
    mount -o ro,remount /sstorage
    
  6. Reboot the Dolby Voice Hub/NUC to complete the setup.