<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.12: http://docutils.sourceforge.net/" />
<title>UHD - Device streaming</title>
<style type="text/css">
body{
font-family:Arial, Helvetica, sans-serif;
font-size:11pt;
color:black;
background-color:white;
width:90%;
margin:0 auto 0 auto;
}
div.document div.contents{
border:1px solid #333333;
padding:10px 30px 10px 10px;
margin-left:50px;
color:inherit;
background-color:#FCFCFC;
display:inline-block;
}
div.document p.topic-title{
font-weight:bold;
}
div.document a:link, div.document a:visited{
color:#236B8E;
background-color:inherit;
text-decoration:none;
}
div.document a:hover{
color:#4985D6;
background-color:inherit;
text-decoration:none;
}
div.document h1.title{
font-size:150%;
border-left:1px solid #333333;
border-bottom:1px solid #333333;
text-align:left;
padding:10px 0px 10px 10px;
margin:10px 5px 20px 5px;
color:#333333;
background-color:inherit;
}
div.document h2.subtitle, div.section h1{
margin-top:50px;
border-bottom:1px solid #333333;
font-size:140%;
text-align:center;
padding:20px 0px 10px 0px;
color:#333333;
background-color:inherit;
}
div.section h2{
font-size:110%;
text-align:left;
padding:15px 0px 5px 0px;
text-decoration:underline;
color:#333333;
background-color:inherit;
}
div.document pre.literal-block{
border:1px inset #333333;
padding:5px;
margin:10px 5px 10px 5px;
color:inherit;
background-color:#FCFCFC;
font-size:90%;
}
div.document table{
padding:5px;
font-size:95%;
}
div.document th{
padding:3px 7px 3px 7px;
border:1px solid #333333;
text-align:center;
color:inherit;
background-color:#ECECEC;
}
div.document tr{
}
div.document td{
padding:3px 7px 3px 7px;
border:1px solid #333333;
text-align:center;
color:inherit;
background-color:#FCFCFC;
}
div.footer{
margin:50px auto 30px auto;
text-align:center;
font-size:85%;
}
</style>
</head>
<body>
<div class="document" id="uhd-device-streaming">
<h1 class="title">UHD - Device streaming</h1>
<div class="contents topic" id="table-of-contents">
<p class="topic-title first">Table of Contents</p>
<ul class="simple">
<li><a class="reference internal" href="#introduction-to-streaming" id="id1">Introduction to Streaming</a></li>
<li><a class="reference internal" href="#link-layer-encapsulation" id="id2">Link Layer Encapsulation</a></li>
<li><a class="reference internal" href="#data-types" id="id3">Data Types</a><ul>
<li><a class="reference internal" href="#the-host-cpu-data-type" id="id4">The host/CPU data type</a></li>
<li><a class="reference internal" href="#the-link-layer-data-type" id="id5">The link-layer data type</a></li>
<li><a class="reference internal" href="#conversion" id="id6">Conversion</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="introduction-to-streaming">
<h1>Introduction to Streaming</h1>
<p>The concept of streaming refers to the transportation of samples between host and device.
A stream is an object that facilitates streaming between host application and device.
An RX stream allows the user to receive samples from the device.
A TX stream allows the user to transmit samples to the device.</p>
</div>
<div class="section" id="link-layer-encapsulation">
<h1>Link Layer Encapsulation</h1>
<p>The VITA49 standard provides encapsulation for sample data across a link layer.
On all second generation hardware (and later), samples are encapsulated into VRT IF data packets.
These packets also provide sample decoration such as stream time and burst flags.
Sample decoration is exposed to the user in the form of RX and TX metadata structs.</p>
<p>The length of an IF data packet can be limited by several factors:</p>
<ul class="simple">
<li><strong>MTU of the link layer:</strong> network card, network switch</li>
<li><strong>Buffering on the host:</strong> frame size in a ring buffer</li>
<li><strong>Buffering on the device:</strong> size of BRAM FIFOs</li>
</ul>
</div>
<div class="section" id="data-types">
<h1>Data Types</h1>
<p>There are two important data types to consider when streaming:</p>
<ul class="simple">
<li>The data type of the samples used on the host for processing</li>
<li>The data type of the samples sent through the link-layer</li>
</ul>
<div class="section" id="the-host-cpu-data-type">
<h2>The host/CPU data type</h2>
<p>The host data type refers to the format of samples used in the host for baseband processing.
Typically, the data type is complex baseband such as normalized <strong>complex-float32</strong> or <strong>complex-int16</strong>.</p>
</div>
<div class="section" id="the-link-layer-data-type">
<h2>The link-layer data type</h2>
<p>The link-layer or "over-the-wire" data type refers to the format of the samples sent through the link.
Typically, this data type is <strong>complex-int16</strong>.
However, to increase throughput over the link-layer,
at the expense of precision, <strong>complex-int8</strong> may be used.</p>
</div>
<div class="section" id="conversion">
<h2>Conversion</h2>
<p>The user may request arbitrary combinations of host and link data types;
however, not all combinations are supported.
The user may register custom data type formats and conversion routines.
See <strong>uhd/convert.hpp</strong> for further documentation.</p>
<p>TODO: provide example of convert API</p>
</div>
</div>
</div>
<div class="footer">
<hr class="footer" />
Generated on: 2014-10-15 11:47 UTC.
</div>
</body>
</html>
