1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
# STC/Harman AVTP Pipeline Contribution Notes
## General Status
- Consider the AVTP Pipeline a work in progress.
- Integrated with OpenAvnu:
- gPTP
- MAAP
- MSRP
- igb direct for packet TX.
- igb credit based shaper
- build system
- Credit-based shaper algorithm is not used for individual streams.
- Testing of various mappings and benchmarking has been performed. Look at the end of this file for benchmark results.
- Documentation and doc generation has not been fully updated.
## Building Current OpenAvnu
### Tool chain and libraries
- Ubuntu 14.04
- Install dependencies for OpenAvnu ($ sudo apt-get install ...)
- $ sudo apt-get install build-essential
- $ sudo apt-get install libpcap-dev
- $ sudo apt-get install libpci-dev
- $ sudo apt-get install libsndfile1-dev
- $ sudo apt-get install libjack-dev
- $ sudo apt-get install linux-headers-generic
- linux-headers (same version as the kernel you're building for)
- Install dependencies for AVTP pipeline
- $ sudo apt-get install libglib2.0-dev
- $ sudo apt-get install libgstreamer0.10-dev
- $ sudo apt-get install libgstreamer-plugins-base0.10-dev
- $ sudo apt-get install libasound2-dev
### Building everything
- Building from the repo root
- $ ARCH=I210 make all
### Building just AVTP pipeline
- $ make avtp_pipeline
Binaries will be installed in lib/avtp_pipeline/build/bin.
### Building AVTP pipeline without SRP or MAAP support
- $ AVB_FEATURE_ENDPOINT=0 make avtp_pipeline
Make sure to call `make avtp_pipeline_clean` before.
### Building AVTP pipeline documentation
- $ make avtp_pipeline_doc
### Building just AVTP AVDECC support
- $ make avtp_avdecc
Binaries will be installed in lib/avtp_pipeline/build_avdecc/bin.
The openavb_avdecc binary needs to be run in addition to the AVTP pipeline binary (openavb_harness or openavb_host) for AVDECC to be supported.
### Building AVTP AVDECC documentation
- $ make avtp_avdecc_doc
## Running OpenAvnu daemons
- Helper scripts in the repo root.
- `$ sudo ./run_igb.sh eth1`
- Load the igb driver. Supply the interface name (ethx) as parameter.
- `$ sudo ./run_gptp.sh eth1`
- Start gptp daemon. Supply the interface name (ethx) as parameter.
- `$ sudo ./run_srp.sh eth1`
- Start msrp daemon. Supply the interface name (ethx) as parameter.
- `$ sudo ./run_maap.sh eth1`
- Start maap daemon. Supply the interface name (ethx) as parameter.
## Running OpenAvnu simple talker example
- `$ sudo ./run_simple_talker.sh eth1`
- Run the current OpenAvnu simple talker example. Supply the interface name (ethx) as parameter.
## Running OpenAvnu Echo Talker
- `$ sudo ./run_echo_talker.sh eth1`
- Run the AVTP Echo talker test stream. Supply the interface name (ethx) as parameter.
## Running OpenAvnu Echo Listener
- `$ sudo ./run_echo_listener.sh eth1`
- Run the AVTP Echo talker test stream. Supply the interface name (ethx) as parameter.
## Benchmark results
All test done on DELL Optiplex 755 with Intel Core 2 Duo CPU E8400 @ 3.00GHz
| Type | Comment | Class | Streams | CPU Talker | CPU Listener |
|:-------:| -------------|:-----:| -------:| ----------:| ------------:|
| 61883-6 | 48kHz stereo | A | 1 | 3.2%| 4.9%|
| | | | 2 | 22.8%| 9.3%|
| | | | 4 | 28.2%| 20.3%|
| | | | 8 | 39.7%| 35.0%|
| | | | 16 | 60.8%| 73.1%|
| aaf | 48kHz stereo | A | 1 | 3.4%| 4.8%|
| | | | 2 | 22.7%| 8.9%|
| | | | 4 | 28.7%| 19.4%|
| | | | 8 | 40.5%| 35.7%|
| | | | 16 | 63.0%| 74.8%|
| h264 | 4675 Kbps vbr| A | 1 | 3.2%| 27.0%|
| | | | 2 | 6.4%| 59.8%|
| | | | 4 | 10.5%| 108.1%|
| | | | 6 | 15.6%| 149.9%|
| mpeg2ts | 1405 Kbps vbr| A | 1 | 2.5%| 14.7%|
| | | | 2 | 5.0%| 40.9%|
| | | | 4 | 7.6%| 86.3%|
| | | | 6 | 10.7%| 123.5%|
| mjpeg | live camera | A | 1 | 11.5%| 10.2%|
| mjpeg | videotestsrc | A | 1 | 10.0%| 6.4%|
| | | | 2 | 21.4%| 13.0%|
| | | | 4 | 40.5%| 26.9%|
| | | | 6 | 57.7%| 42.0%|
| | | B | 12 | 113.0%| 79.0%|
## More examples
Below are examples of AVTP pipeline usage with various stream types (mappings). These commands were used for generating benchmark results above. AVTP pipeline was compiled without SRP support (`AVB_FEATURE_ENDPOINT=0 make avtp_pipeline`).
IFNAME=eth0
STREAMS=7
CLASS=A
RATE=8000
TRANSIT_USEC=2000
REPORT=0 # statistics display interval in seconds (0 turns off statistics)
# AAF talker
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad aaf_file_talker.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,map_nv_sparse_mode=0,intf_nv_file_name=test01.wav,report_seconds=$REPORT
# AAF listener
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad aaf_listener_auto.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,map_nv_sparse_mode=0,intf_nv_audio_endian=big,report_seconds=$REPORT
# 61883-6 talker
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad wav_file_talker.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,intf_nv_file_name=test01.wav,report_seconds=$REPORT
# 61883-6 listener
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad alsa_listener.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
# H264 talker
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad h264_gst_talker.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
# H264 listener
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad h264_gst_listener.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
# MJPEG talker
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad mjpeg_gst_talker.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
# MJPEG listener
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad mjpeg_gst_listener.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
# MPEG2TS talker
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad mpeg2ts_file_talker.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
# MPEG2TS listener
sudo ./openavb_harness -I $IFNAME -s $STREAMS -d 0 -a a0:36:9f:2d:01:ad mpeg2ts_gst_listener.ini,sr_class=$CLASS,map_nv_tx_rate=$RATE,max_transit_usec=$TRANSIT_USEC,report_seconds=$REPORT
|
