From 9b6dfa887f20b81a091aae4a42d24748ad02cf46 Mon Sep 17 00:00:00 2001 From: Andrea Bondavalli Date: Sat, 27 Jun 2020 10:03:30 +0200 Subject: [PATCH] Created DEVICES.md document with the list of devices and interoperability testes carried out so far. Added Dante transmitter and receiver devices to the list of supported devices. --- DEVICES.md | 89 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 30 ++---------------- 2 files changed, 91 insertions(+), 28 deletions(-) create mode 100644 DEVICES.md diff --git a/DEVICES.md b/DEVICES.md new file mode 100644 index 0000000..060ff1a --- /dev/null +++ b/DEVICES.md @@ -0,0 +1,89 @@ +# Devices and interoperability tests # + +This document describes the interoperability tests carried out using the AES67 daemon and provides a guide to execute them. +Before starting make sure that the [AES67 daemon basic setup](#daemon_setup) is done. + +The following devices have been tested: + +* AVIOUSB Dante receiver, see [Audinate Dante Controller and Dante receiver](#dante_avio_receiver) +* AVIOUSB and AVIOAI2 Dante trasmitters, see [Audinate Dante Controller and Dante transmitter](#dante_avio_transmitter) +* [Hasseb audio over Ethernet receiver](#hasseb_receiver) + + +## AES67 daemon basic setup## + +Before running any interoperability test configure the AES67 daemon with the following instructions: + +* open the daemon configuration file *daemon.conf* and change the following parameters: + * set network interface name to your Ethernet card, e.g.: *"interface\_name": "eth0"* + * set default sample rate to 48Khz: *"sample\_rate": 48000* +* verify that PulseAdio is not running. See [PulseAudio](README.md#notes). +* install the ALSA RAVENNA/AES67 module with: + + sudo insmod 3rdparty/ravenna-alsa-lkm/driver/MergingRavennaALSA.ko + +* run the daemon using the new configuration file: + + aes67-daemon -c daemon.conf + +* open the Daemon WebUi *http://[address:8080]* and do the following: + * go to Config tab and verify that the sample rate is set to 48KHz + * go to Sources tab and add a new Source using the plus button, set Codec to L24 and press the Submit button + +## Audinate Dante Controller and Dante receiver ## + +To run interoperability tests using the [Dante Controller](https://www.audinate.com/products/software/dante-controller) and a Dante AVIO receiver use the following steps. These were tested using a Dante AVIOUBS device. + +* make sure [AES67 daemon basic setup](#daemon_setup) is done +* download and install the Dante controller +* connect the Dante AVIO receiver to the network +* open the Dante Controller application, select the Routing dialog and wait for the AVIO receiver to show up. Make sure this device or another on the network is working as PTP clock master +* wait for a daemon Source to show up in the Routing dialog +* using the Routing Dialog connect the Daemon channels to the AVIO receiver channels with the desired configuration, prohibition icons should show up +* go to the daemon WebUI, click on the PTP tab and wait for the "PTP Status" to report "locked" +* open a shell on the Linux host and start the playback on the RAVENNA ALSA device. For example to playback a test sound use: + + speaker-test -D plughw:RAVENNA -r 48000 -c 2 -t sine + +* alternatively start a playback with a file in S24_3LE format: + + aplay -D plughw:RAVENNA -r 48000 -c 2 -f S24_3LE test.wav + +* return to the Dante Controller application, select the Routing dialog and verify that prohibition icons get replaced with green icons to indicate that the audio flow is active + +## Audinate Dante Controller and Dante transmitter ## + +To run interoperability tests using the [Dante Controller](https://www.audinate.com/products/software/dante-controller) and a Dante transmitter use the followings steps. These were tested using a Dante AVIOUBS and AVIOAI2 devices. + +* make sure [AES67 daemon basic setup](#daemon_setup) is done +* download and install the Dante controller +* connect the Dante AVIO transmitter to the network +* open the Dante Controller application, select the Routing dialog and wait for the AVIO transmitter to show up. Make sure this device or another on the network is working as PTP clock master +* in the Dante Controller wait for a daemon Source to show up in the Routing dialog +* in the Dante Controller go to Device view and select AVIO transmitter, go to the AES67 Config tab and select "AES67 Mode" to Enabled. Reboot the device if required +* go to the daemon WebUI, click on the Browser tab and wait for the AVIO transmitter to show up as remote SAP source +* on the daemon WebUI select the Sinks tab, click on the plus icon to add a new Sink, mark the "Use SDP" flag and select the AVIO transmitter SAP source +* open a shell on the Linux host and start the recording on the RAVENA ALSA device. For example: + + arecord -D plughw:RAVENNA -c 2 -f S24_3LE -r 48000 -t wav sink.wav + +## Hasseb audio over Ethernet receiver ## + +To run interoperability tests using the [Hasseb audio over Ethernet receiver](http://hasseb.fi/shop2/index.php?route=product/product&product_id=62) follow these steps: + +* make sure [AES67 daemon basic setup](#daemon_setup) is done +* open the Hasseb WebUI and do the following: + * deselect the "PTP slave only" checkbox to enable PTP master on Hasseb device + * wait for the daemon source to show up in the "Stream name" drop down list and select it. Please note that mDNS support must be enabled on the daemon + * press the Submit button +* go to the daemon WebUI, click on the PTP tab and wait for the "PTP Status" to report "locked" +* open a shell on the Linux host and start the playback on the RAVENNA ALSA device. For example to playback a test sound use: + + speaker-test -D plughw:RAVENNA -r 48000 -c 2 -t sine + +* alternatively start a playback with a file in S24_3LE format: + + aplay -D plughw:RAVENNA -r 48000 -c 2 -f S24_3LE test.wav + + + diff --git a/README.md b/README.md index 0e5b378..65a2cf6 100644 --- a/README.md +++ b/README.md @@ -142,34 +142,8 @@ The demo performs the following operations: * start playing a test sound on the configured ALSA source * wait for the recording to complete and terminate ptp4l and the AES67 daemon -## Interoperability tests ## -To run interoperability tests using the [Hasseb audio over Ethernet receiver](http://hasseb.fi/shop2/index.php?route=product/product&product_id=62) follow these steps: - -* open the daemon configuration file *daemon.conf* and change the following parameters: - * set network interface name to your Ethernet card, e.g.: *"interface\_name": "eth0"* - * set default sample rate to 48Khz: *"sample\_rate": 48000* -* verify that PulseAdio is not running. See [PulseAudio](#notes). -* install the ALSA RAVENNA/AES67 module with: - - sudo insmod 3rdparty/ravenna-alsa-lkm/driver/MergingRavennaALSA.ko - -* run the daemon using the new configuration file: - - aes67-daemon -c daemon.conf - -* open the Daemon WebUi *http://[address:8080]* and do the following: - * go to Config tab and verify that the sample rate is set to 48KHz - * go to Sources tab and add a new Source using the plus button, set Codec to L24 and press the Submit button - * go to Sources tab and click on the info icon on the right of the newly created source and copy the SDP file -* open the Hasseb WebUI and do the following: - * deselect the "PTP slave only" checkbox to enable PTP master on Hasseb device - * select the "Add SDP file manually" checkbox and copy the previous Source SDP into the SDP field - * alternatively to the step above, select in the "Stream name" drop down the daemon Source just added - * press the Submit button -* return to the daemon WebUI, click on the PTP tab and wait for the "PTP Status" to report "locked" -* open a shell on the Linux host and start the playback on the ravenna ALSA device. For example to playback a test sound use: - - speaker-test -D plughw:RAVENNA -r 48000 -c 2 -t sine +## Devices and interoperability tests ## +See [Devices and interoperability tests with the AES67 daemon](DEVICES.md) ## Notes ##