Monitoring Digigram IQOYA audio over IP codecs

Introduction

This HowTo demonstrate the capabilities of LoriotPro Broadcast Edition for the Monitoring of Broadcast devices. The devices that the software will monitor are IQOYA audio IP codecs from the Digigram company.

DIGIGRAM is a long-standing and major player in the world of professional audio, thanks to his mastery in the design and manufacture of audio cards, audio codecs and video codecs. Their audio over IP product range IQOYA is mainly used by broadcasters to transport the audio stream from studio to studio or from studio to transmitter over an IP transport infrastructure. Their devices are natively manageable by SNMP, what more natural so than using our solution to ensure the supervision.

The goal is to get the following MAP (Active View) of the devices with the IP links established. The link can be redrawn on demand after any change. The dynamic path routing is performed by a LUA script.

ACtiveView-with-Path.jpg

In the next chapters we will discover how to:

  1. Add support for the IQOYA device within LoriotPro (MIB compilation)
  2. Discover the IQOYA device connected to the network
  3. Testing IQOYA device with SNMP requests
  4. Creating a network MAP of the devices and links
  5. In deep explanations of the working principle

All the scripts and templates used in this example can be obtained by writing to support@loriotpro.com.

Modification of the script for your own purposes can be achieved by yourself or we can quote the work for doing it.

Compiling the Digigram MIB

Before starting a discovering of the network, it is required to add the Digigram MIB to the LoriotPro MIB database. Without MIB file, it is impossible to gather SNMP objects with a symbolic short object name.

To compile the MIB select from the main menu the MIB -> Compiler option

Consult the link below to get more information about using the compiler.

When done you should see the new MIB object from Digigram in the MIB tree

Digigram-MIB-tree.jpg

Discovering IQOYA Devices

We should first add the network object in the LoriotPro Directory

InsertNetwork.jpg 

Then fill up the Network creation dialog box

Audio-Over-IP-Network-Creat.jpg

When the network is available in the tree we can start to discover devices by launching the IP Scanner tool. Click right on the Network icon and select IP Scanner.

IP-Scanner.jpg

You should have a Directory filled with the IQOYA devices discovered.

Directory-with-IQOYA.jpg

Testing IQOYA device with SNMP requests

We can check with a SNMP walk that the devices are well responding on the proprietary MIB object of the IQOYA MIB.

Select an IQOYA in the tree and do a mouse right click. Select Tools and SNMP Walker.

WalkIqoya.jpg

If your device is answering you should get values for all the object of the MIB. If you have nothing check:

  1. That the device is Green in the Directory tree (else check ping, SNMP community, version etc.)
  2. That the MIB IQOYA has been compiled

Creating a network MAP of the devices and links

When the devices are all present in the Directory we can start to create a MAP, what we call Active View within the LoriotPro software.

To insert a new Active View you can for example select the top icon LoriotPro and call the contextual menu (right click). Select  Insert Task  and Active View

InsertActiveView.jpg

A popup ask you to choose between a template or not. In this case study we do have a template ready for that.

InsertTemplate.jpg

SelectTemplate.jpg

Next we do need to provide a name for the new Active View and select the file name for the configuration file.

NamingActiveView.jpg

SavingActiveView.jpg

The new Active View is displayed:

EmptyActiveView.jpg

As you notice we already do have some information on the View, like Alarms status, but no links between devices.

The links will be created automatically by a LUA script. The IQOYA devices provide the necessary information in some MIB tables to be able to map connections between sources and destinations.

To run the script, select the Run Script option of the File menu option in the Active View

Run-Script-from-AV.jpg

Select the DIGIGRAM-AV-CreatePath.LUA script in the list

Select Yes and the default IP address, the script should run and the links should be displayed.

ACtiveView-with-Path.jpg

In deep explanations of the working principle

To get it working this example require few files.

  1. An Active View template. The Active View template is an Active View file that is built manually with the Active View Editor. This Active View has all the Iqoya devices already setup.
  2. The LUA script DIGIGRAM-AV-CreatePath.LUA that perform the drawing of the links between Devices.
  3. The device configuration fil, either a LUA script  DIGIGRAM-AV-Creation-Config.LUA, where devices parameters are declarer in a LUA table.
  4. Some complementary files that are imported within the previous file

How to create the template of the Active View

To create a template you must use the Active View Editor.

From the main menu choose Tools and Active View Editor.

In the editor you can drag and drop the device from the directory to the drawing area and then click right to see the properties. We have  changed the default image to the IQOYA device

Insert-Device-In-Template.jpg

Change-Image.jpg

Each device that you want to see on the map should be added manually.

For each device you should modify some properties according to the example below

EMITTER-Object-Config.jpg

The Ref1 field should contain the IQOYA string value

The Ref2 field should contain the IP address of the device

The Ref3 string should contain either EMITTER or TRANSMITTER.

  • EMITTER is required for IQOYA LINK devices located in studio and send audio source to a TRANSMITTER
  • TRANSMITTER is required for IQOYA LINK devices that receive audio over IP and are located in a transmitter site.

 From the version 7 release –al, it is possible to display the list of objects located in an Active View.

To display the Layers select the Shape option of the main menu in the Active View in edition mode and then select the option Layers.

This can be helpful to identify object of to move them from one layer to another layer.

List-of-object.jpg

The next step is to add the device to the configure file  DIGIGRAM-AV-Creation-Config.LUA

ConfigFile.jpg

In the configuration file for each device we define:

      {--device 1
             "Studio105",--1: name --1
             {10,100},--2: Postion x from top, y from left --2
             {100,10},--3: size in pixel --3
             "IQOYA_LINK-FAV.png",--4: image for clipart --4
             "192.168.1.105",--5: IP Address ETH0
              "192.168.0.105",--6: IP Address ETH1
              true, --7 Destination and source table retrieved by SNMP
               "EMITTER", --8:value can be EMITTER (send audio) or TRANSMITTER (receive audio)
             {},--9: DestinationTable
             {}, --10: SourceTable
             "LINK" --11 model of the DIGIGRAM device, can be LINK, LINK-LE,SERV, PIKO-OUT, PIKO-IN
      },

The entry 7 of the table allow the script to determine if the device is SNMP and if the routing can be calculated from its SNMP routing table.

Else the routing can be manually setup in this configuration file.

Example of an IQOYA device that is not SNMP

 

{--device 5 --------------------------
             "Studio210",--name
             {182,706},--Postion x from top, y from left
             {84,40},--size in pixel
             "PIKO-IN.png",--image for clipart
             "192.168.1.210",--IP Eth0 Address --5 
              "192.168.0.210",--IP Eth1 Address --6 
             false, --7 Destination and source table retreive by SNMP
              "TRANSMITTER", --8 value can be EMITTER (send audio) or TRANSMITTER (receive audio)
            {--9 DestinationTable
                     --{ Example of entry            
                     --Destination = IPaddress:port,
                     --port            
                     --}              
                  {"192.168.1.200:6020","6020"}     
            },
            {--10 SourceTable
                    --{Destination = IPaddress:port,port,}
                      {"127.0.0.1:5020","5010"},
                      {"127.0.0.1:5020","5020"}             
            },
            "PIKO-IN" --11 model of the DIGIGRAM device, can be LINK, LINK-LE,SERV, PIKO-OUT, PIKO-IN
      }

When a template is designed it can be tested from the development environment. From the main menu select Tools Script Editor. In the LUA editor open the DIGIGRAM-AV-CreatePath.LUA script In the beginning you should add a line that load the template of the Active view: Example: lpav.Load(lp.GetPath().."/config/active-view/av_DIGTLP.cmp") Beware to remove or remark the line when living the script. Press F5 to run it You should get a similar view depending of your template.  To see the Active View you should select the View option of the main menu of the Scrip editor and select Active View box. Testing-TPL.jpg

Conclusion

The Broadcast Edition of LoriotPro used in this how to offers close performance of real time for the report to display of the SNMP collected data. The frequency of collection of data on devices can be reduced to the second and thus provides an immediate reaction in case of anomaly among operators. Similarly, receipt of an SNMP alarm from the equipment, the Visual is updated in the next second if necessary. If you want to monitor your IQOYA devices or if you have a similar need with other type of devices do not hesitate to ask the LoriotPro support for help.