A HOME Timecode Generator is configured and managed by HOME in the same manner as other HOME Apps.

Once configured, its parameters are also available (over NATs) via the HOME API. This supports integration with external broadcast control systems such as Lawo's VSM.

Common information that applies to all app types can be found in HOME Apps - General Operation.

This topic provides information that is specific to a HOME Timecode Generator.

Configuring the App Server(s)

If you have not already done so, then it is recommended to check the following options for the App Server(s):
  • Automatic deployment and Server Groups - determine how apps are deployed to the available App Server(s).
  • Stream Redundancy - required for dual-redundant streaming, compatible with SMPTE ST2022-7.
  • Single SRD mode - important for compatibility with some third-party (video) devices.
  • Redundancy Groups - can be used to configure app failover (for redundancy).
  • PTP Configuration - essential for correct synchronization of the media streams and compatibility with SMPTE ST2110-xx.

For more information, please see HOME Apps - App Server Configuration.

Preparing a HOME Timecode Generator

To prepare a new app for operation, there are four main steps:
  1. Open a connection to HOME.
  2. Create a new app.
  3. Start the app.
  4. Check the app's health.

To open a connection to HOME, you will need a computer that is installed with a suitable web browser application. The computer must be connected to the same network and subnet as the HOME management system server(s). The HOME UI is accessed by entering the IP address, or domain name, of the HOME server into a web browser and then signing in. Following a successful sign in, the HOME 'Devices' page appears. 

From HOME's 'Devices' pages, you can create an app using the New App function. This can be done at any time, with or without an app server. This step labels and configures the app, and adds it to HOME's 'Devices' list.

Please note: During the app creation process, the user is presented with a range of options that define the fundamental functionality and streaming capability of the app. The choices made here will determine the resources required to run the app: I/O bandwidth, CPU resources, etc. This allows the IP senders and receivers to be tailored to the application and network (to help manage the bandwidth of the switches and NICs). Note that the initial configuration options can be edited later but this is only possible once the app is stopped.

Once an app exists it can be started either from HOME (using Start App) or remotely (via the HOME API). This step deploys the app's processing to one of the available app servers. To start an app successfully, there must be sufficient capacity (on a HOME Apps server) and enough available licenses or credits (on the HOME system). The resources can be checked by looking at the Target App Server and Licensing information (in the 'Start App' dialog).

Once an app is started, you should check the app's health. This step confirms that the processing is correctly deployed. Click on the app's label (to open the ' Device → General ' settings) and check the  Lifecycle  area. If the status shows as " Running on <name of app server> " and " Currently reporting healthy ", then the app is ready to use.

App Configuration

For a HOME Timecode Generator, the options in the app configuration define whether the app's input receiver is provisioned and the number of output (timecode generator) streams.

A HOME Timecode Generator can be configured to provide up to 8 output senders (TX 1 to 8), where each sender transmits a SMPTE 2110-40 (Metadata) stream. If SMPTE 2110-40 is also set for the app's input receiver (RX 1), then the connected Metadata can be used as a time source for the TCG.

Once the app is configured and running, the timecode generator (for each output) can be adjusted, independently, using the app's Advanced → Timecode Generator controls.

For more information about the app configuration options, please see HOME Timecode Generator - App Configuration.

IP Senders and Receivers

For all HOME Apps, the available senders and receivers are pre-defined according to the app configuration options defined by the user. i.e. the number and type of I/O.

A HOME Timecode Generator can be configured with up to eight outputs and one input, and so the available senders (TX) and receivers (RX) are as follows.

Sources (app senders):

  • TX 1 = Timecode Generator Output 1
  • TX 2 = Timecode Generator Output 2
  • ...
  • TX 8 = Timecode Generator Output 8

Destinations (app receivers):

  • RX 1 = Timecode Generator Input

When considering the app's configuration, the Input Meta Transport option determines whether the input receiver is provisioned; the Number of Output Streams (from 1 to 8) defines the number of output (Metadata) streams.

Note that this app supports Meta streams only; there are no Video or Audio streams.

Once an app is running, its actual senders and receivers can be checked and edited from the Senders or Receivers page. See HOME Timecode Generator - Senders and HOME Timecode Generator - Receivers.

Further controls are available via the Advanced parameters page. See HOME Timecode Generator - Advanced -> Senders and HOME Timecode Generator - Advanced -> Receivers.

Connecting Signals

When viewed from HOME's 'Stream Routing' page, the available senders and receiver appear in the Source and Destination lists (as shown below).

HOME uses the following naming convention for each sender or receiver: <App Label> / TX n or <App Label> / RX n, where the App Label is provided by the user (and can be edited via the Edit Device Info dialog).

The steps below describe how to connect the app using the 'Stream Routing':

  • To connect a signal to the Timecode Generator input: choose a suitable (Meta) source on the left, and the Timecode Generator receiver on the right (e.g. Timecode Generator 1 / RX 1). Then press Connect.
  • To connect the a Timecode Generator output to a destination: choose the Timecode Generator sender on the left (e.g. Timecode Generator 1 / TX 1), and a suitable (Meta) destination on the right. Then press Connect.
  • In each case, if the device or app you wish to connect handles multiple flows, then it may be necessary to click on the reveal arrow to expand the sender (or receiver) group to access the individual Meta streams.

For more information, please see HOME Apps - Connecting Signals.

Editing an Existing App

When the user clicks on an app label in HOME, this opens the 'Device → General ' settings (for the app), and provides access to several other menu tabs: Network Ports, Senders, Receivers, etc.

From here, you can view and edit a variety of app-specific parameters such as the label and location, license type, initial configuration, senders and receivers, and so on.

How to use the individual app pages is described in HOME Timecode Generator - Reconfiguring an App.

Parameter Control

The app's 'Advanced' page provides information and configuration controls relating to the app itself, presented in a simple menu tree structure.

The same parameters can be accessed (over NATs) via the HOME API. This supports integration with external broadcast control systems such as Lawo's VSM.

It should be noted that the available menus and controls may change, depending on the app's configuration. In addition, some controls only become available once the app is running; these appear at the bottom of the parameter tree and host the app's runtime controls. 

The latest settings are saved (by HOME) whenever a change is made. If a restart is required, then this is noted in the documentation.

All possible controls are described in HOME Timecode Generator - Advanced parameter control.