Signalogic SigMRF Bedienungsanleitung

SigMRF Users Guide



2016-2017 Signalogic, Inc.

Revision A2, Apr 2017

Signalogic, Inc.

9617 Wendell @ Skillman

Dallas, TX 75243

Tel: 214-349-5551

Fax: 972-598-0806

http://www.signalogic.com

tech_supp[email protected]

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

TABLE OF CONTENTS

1Overview 1

2SigMRF Architecture 2

2.1 Software Architecture ................................................................................................. 2

2.1.1 Libraries.................................................................................................................. 3

2.1.2 Background Process............................................................................................... 3

2.2 Platform Architecture .................................................................................................. 4

2.2.1 Packet I/O............................................................................................................... 4

2.2.2 DPDK ..................................................................................................................... 4

2.2.3 coCPU™ Option ..................................................................................................... 5

3SigMRF Functionality 9

3.1 Packet Flow................................................................................................................ 9

3.2 Frame Flow ...............................................................................................................13

3.3 Codecs ......................................................................................................................14

3.3.1 Voice Codecs.........................................................................................................14

3.3.2 Video Codecs ........................................................................................................15

3.4 mediaTest Demo, Test, and Measurement Program..................................................16

3.5 APIs...........................................................................................................................21

3.5.1 Pktlib......................................................................................................................21

3.5.2 Voplib ....................................................................................................................25

3.5.3 DirectCore™..........................................................................................................26

3.5.4 Session Data and Session Command Structs........................................................27

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

iii

Revision History

Created Rev A1 Nov 2016 SigMRF Users Guide

Modified Rev A2 Apr 2017 Add pseudocode example for packet and frame

processing

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

1 / 39

1 Overview

SigMRF (Signalogic Media Resource Functions) software provides voice and video transcoding,

transrating, algorithms, packet processing, statistics, logging, resource management, redundancy,

and other media related functionality for the following application areas:

•Telecom infrastructure such as IMS LTE and VoLTE test and simulation equipment

•IT security

•Lawful interception and recording

•Session Border Controllers (SBCs)

•Media Gateways, including extreme capacity systems

•Augmented Reality (AR) systems that require real-time, bidirectional video data flow and

processing

•Data analytics and data streaming applications that require voice and video interfaces

•Content delivery

SigMRF is designed to scale from low capacity, relatively simple systems to high capacity,

complex systems. When high capacity is required, SigMRF supports coCPU™ hardware that

can increase, by a factor of 10x or more, the capacity of cloud servers, as well as small form

factor systems (such as mini-ITX), in which size and power consumption constraints can

severely limit the number of x86 cores. The coCPU hardware option also supports ATCA blade

server systems.

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

2 / 39

2 SigMRF Architecture

SigMRF software and hardware consists of:

•Libraries (Linux and Windows)

•Background Process (for example, media and packet tasks)

•Test and demo applications (for example, mediaTest)

•Optional coCPU™ hardware

The SigMRF architecture is designed for both flexibility and high performance, supporting

multiple data flow and packet I/O options, DPDK, and entry points for user defined applications.

User apps can operate and make API calls at several levels, including frame, packet, and session.

2.1 Software Architecture

The SigMRF software architecture includes both libraries and background tasks. Figure 1-1

below shows the SigMRF software architecture.

Figure 1-1, SigMRF software architecture and packet I/O

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

3 / 39

All SigMRF software components are dependent on the DirectCore library for thread-safe access

to information about multiple instances, multiple users, and CPU core allocation in cases when

explicitly specified. In addition, DirectCore provides an interface layer between software and

hardware elements, for example between software and DPDK, software and coCPU™ cores, and

software and coCPU NICs.

2.1.1 Libraries

SigMRF provides several libraries, both in Linux (.so 1) and Windows (DLL 2) formats,

including:

•Pktlib (packet library)

•Voplib (media, or voice / video over packet, library)

•Codec libraries (various voice and video codecs)

Codec libraries are accessed by user applications via Voplib; currently direct access to codec

libraries is not supported.

SigMRF also requires the DirectCore set of libraries. DirectCore is a separate product, used by a

number of Signalogic application areas, including telecom, image analytics, AI (neural

networks), and more. The DirectCore reference guide is located at

ftp://ftp.signalogic.com/documentation/DirectCore/DirectCore_Reference_Guide_v3_1_0.pdf.

For Windows, SigMRF shall support only Win10 and above. Some aspects of SigMRF, such as

the mediaTest program, used for application reference, demo and test purposes, are expected to

require WSL (Windows Subsystem for Linux), which is available only in Win10.

Testing and Development Notes

1Pktlib and Voplib Linux shared objects have been tested with Ubuntu v12.04 thru 16.04 (kernel

v3.2.0- 45 thru v4.4) and CentOS 7, 7.1 and v6.2. In general, Signalogic software for Linux

systems has been tested on tested with Red Hat 9 (Enterprise) 2.6.9- 42 kernel, Ubuntu v12.04

thru 16.04 (kernel v3.2.0- 45 thru v4.4) CentOS 7, 7.1 and v6.2, and Gentoo v2.6.255.

2Resources and priority assigned to development of Win10 Pktlib and Voplib DLLs depends on

customer needs and business case. Development mostly involves porting existing and tested

Linux .so libs to Win10.

2.1.2 Background Process

The SigMRF background process, when needed, runs separately from user applications, and

includes:

•Packet task, which runs at a relatively high rate (typically every 1 msec) and handles

packet I/O, adding packets to the jitter buffer

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

4 / 39

•Media task, which runs at a lower rate (typically every 5 msec) and handles packet and

payload processing, including transcoding, ptime and transrating, DTMF, and more

Typically, the SigMRF background process comes into play when there is a need for higher

performance or user application code must be simplified. Although not all situations require the

SigMRF background process to be running, it cannot be separated from SigMRF from a product

ordering or support standpoint.

2.2 Platform Architecture

SigMRF supports the following platforms:

•Off-the-shelf rack servers. Typical examples include 1U and 2U form-factors with 8 to

24 Xeon x86 cores

•ATCA server blades. Typical examples include ATCA blades with 4 to 16 x86 or

PowerPC cores

•Small form-factor servers. Typical examples include mini-ITX enclosures with 2-4 Atom

x86 cores

2.2.1 Packet I/O

SigMRF supports several platform configurations for packet I/O, including:

•Motherboard embedded NICs

•Add-in PCIe card NICs

•Add-in coCPU PCIe card NICs

•Backplane Ethernet interface (ATCA only)

In addition, SigMRF supports packet flow paths between these NIC options including:

•Standard Linux and Windows sockets

•DPDK “fast path” between add-in cards and user applications (Linux only)

2.2.2 DPDK

SigMRF support for DPDK is currently under background development and not documented

here. It’s worthwhile to note that existing SigMRF customers have implemented DPDK with

coCPU PCIe cards for very high performance server applications.

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

5 / 39

2.2.3 coCPU™ Option

SigMRF supports coCPU hardware options to (i) substantially increase platform transcoding

capacity, (ii) enable transcoding in very small-form factors, and (iii) provide reduced packet

latency if needed for certain applications (using NICs located directly on the coCPU hardware,

as shown in Figure 2-1 below).

As one example, 64 to 256 coCPU cores can be added to a 1U server; as another example, a 14-

slot ATCA rack can host 1920 coCPU cores. These high levels of core density are suitable to

address applications constrained in space and power consumption.

From a software architecture perspective, in the diagram in Figure 1-1 above, which uses a

partial 3D representation, DirectCore forms a “dividing layer” between x86 CPUs in front of the

layer and coCPUs behind the layer. If coCPU hardware is in use, the SigMRF background

process, as well as packet and media libraries, exist on both sides of this layer.

The coCPU Users Guide is located at

ftp://ftp.signalogic.com/documentation/Hardware/SigC667x/SigC667x_UserGuide_RevD2.pdf.

coCPU Hardware Options

coCPU hardware options include:

•32-core and 64-core PCIe cards

•160 core ATCA blades

coCPU hardware uses Texas Instruments CPUs (8-core c66x devices) which provide the

following benefits:

•State-of-the-art CPU architecture, including multicore, L2 cache, DDR3 external mem,

onchip PCIe and network I/O, onchip wire-speed packet processor including UDP port

filtering, high clock rate SIMD instruction architecture, and extensive onchip DMA

•Run standard C/C++ software without undue modifications, including open source

packages of various types

•Build tools generate highly optimized, efficient run-time codes, especially for

calculation-intensive applications such as codecs, analytics, neural net convolutions, etc.

Figures 2-1 through 2-4 below show examples of coCPU hardware installed in various off-the-

shelf server platforms.

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

6 / 39

Figure 2-1, coCPU full-length PCIe card installed in a Supermicro 1U server.

Note the dual slot PCIe risers on either side of the motherboard

Figure 2-1 above shows a coCPU full-length PCIe card installed in a low-cost Supermicro 1U

server with dual slot PCIe risers on either side of the motherboard. This configuration allows up

to 256 coCPU cores to be added to a single 1U server.

Figure 2-2 below shows dual full-length PCIe cards with 128 total coCPU cores, 32 GB DDR3

mem, and 4x GbE interfaces installed in HP DL380 and Dell R720 2U servers.

4/17/17 SigMRF Users Guide, Rev A2 Copyright Signalogic, Inc. 2016-2017

7 / 39

Figure 2-2, coCPU full-length PCIe cards installed in HP DL380 and Dell R720

2U servers

Figure 2-3 below shows a half-length PCIe card with 32 coCPU cores, 8 GB DDR3 mem, and

GbE interface installed in a mini-ITX server on a standard PCIe riser. The mini-ITX

motherboard has a quad-core Atom CPU, 8 GB memory, and 4x GbE interfaces.

Inhaltsverzeichnis

Beliebte E/A-System Handbücher anderer Marken

WAGO

WAGO 750-344 Bedienungsanleitung

Teknim

Teknim TWM-1887 Bedienungsanleitung

Intelligent Appliance

Intelligent Appliance IA-2662-E Bedienungsanleitung

BERGHOF

BERGHOF ECC DIO 16/16 Bedienungsanleitung

Advantech

Advantech PCM-27J3AU Installations- und Betriebshandbuch

Festo

Festo CP-E08-M12-CL Bedienungsanleitung

Measurement Computing

Measurement Computing PCI-DAS64/M1/16 Bedienungsanleitung

Hitachi

Hitachi HX-RIO3 Series Bedienungsanleitung

NUUO

NUUO SCB-A08 Bedienungsanleitung

M-system

M-system R3Y-RS8 Bedienungsanleitung

jablotron

jablotron JB-110N Bedienungsanleitung

Omron

Omron SYSMAC C200H Bedienungsanleitung

DOLD

DOLD SAFEMASTER M Bedienungsanleitung

ABB

ABB OPT-MF-001 Bedienungsanleitung

Omron

Omron SYSMAC C2000H Bedienungsanleitung

Helmholz

Helmholz TB20 Bedienungsanleitung

ICP DAS USA

ICP DAS USA tM-AD2 Bedienungsanleitung

Automationdirect.com

Automationdirect.com DL305 Bedienungsanleitung