Actions

Difference between revisions of "Turbine Test and Demo Application"

From Zenitel Wiki

(→‎Installations of demo software)
(→‎AVC Gain adjustment data)
 
(220 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
With the Turbine demo PC Application it is possible to play audio files directly on the station, without the need of any AlphaCom server.
+
[[File:TurbineTestDemo2433.png|right|550px|thumb|The Turbine Test & Demo Application]]
 +
The '''Turbine Test and Demo Application''' is a PC application that allows you play audio files directly from the Turbine station without connection to any server. It also allows you to do audio recordings to be used for trouble shooting if there are issues related to audio in the Turbine station.
  
−
== Installations of demo software ==
+
The application has seven options:
 +
* Test Mode View
 +
* Demo Mode View
 +
* Performance View
 +
* Audio Lines
 +
* AudioClient Instances
 +
* Audio Streams
 +
* AudioProcessing
  
−
To install demo software for your Turbine, the following steps must be taken:
+
'''Demo Mode''' requires that an additional audio file package (vsf-demo-media package) is uploaded to the station. '''Test Mode''' will work without this package.
−
#Open up SSH and TCP port inTurbine IP stastion for demo application
 
−
#Load media files onto Turbine IP station
 
−
#Install demo application on your PC
 
−
#Close SSH port
 
  
−
Open up TCP port inTurbine IP stastion for demo application
 
−
*Logon to Turbine IP station
 
−
* Set the station in '''SIP Mode'''
 
−
*Check the firewall settings in '''Advanced Network'''.
 
−
*Open up SSH port
 
−
*Enable the Demo application port 55010
 
  
−
== Load media files onto Turbine IP station ==
+
==Installation of the software==
  
−
On the [[Downloads#Turbine|Downloads page]] you will find a '''turbine-media-demo_3.0.1.3-2_armel.ipk''' with wav files to be uploaded and installed in each Turbine station.
+
===Install the "Turbine Test and Demo Application" on your PC===
−
*Copy this package to /tmp on target using for example WinSCP. The protocol is SCP. Tool: http://winscp.net/eng/index.php
+
*Download the file '''VS-Tools-1.04.0011.msi''' from the [[Downloads#Applications_and_Tools|download page]]. This installation package includes the Turbine Test and Demo Application as well as a PC-tool for image upgrade of the AMC-IP board.
−
*Login to the Turbine consol with protocol SSH. Tool: http://www.chiark.greenend.org.uk/~sgtatham/putty/
+
* Install the software on the PC
−
*Username/password: root/root and do following to install package:
 
−
# cd /tmp
 
−
# ipkg install turbine-media-demo_3.0.1.3-2_armel.ipk
 
  
−
== Install demo application on your PC ==
+
===Open the port for "Demo" and "AudioData" in Turbine IP device ===
−
+
* Logon to the web interface of the Turbine IP device
−
*Download the '''TurbineCommandClient.zip''' from the [[Downloads#Turbine|Downloads page]]. Extract the .zip file and copy the software to a suited folder on your PC. No install needed, simply start the exe-file.
+
* Check the firewall settings in '''Advanced Network'''.
−
*In the application, double-click inside the picture of the station to set IP address of the station, press ”Connect to Turbine Station” and red color should become green.
+
* Enable the '''Demo''' ('''TCP port 50010''') and "AudioData" ('''UDP port 5035'''). A reboot is required for the changes to take effect. '''Note!''' Make sure these ports are open in your laptop as well.
−
*From my experience you might have to reset the PC to make it work.
+
[[File:TestDemo Firewall.PNG|thumb|left|700px|Open the port "Demo" and "AudioData" on the Turbine device]]
 +
<br style="clear:both;" />
  
 +
==Add stations or devices==
 +
* In the "Turbine Test and Demo Application" you can add stations via the list on the right hand side by typing the '''IP Address''' of the Turbine station you want to control, then press '''Add Turbine Station IP'''
 +
* When the station is added to the list, press the button '''Connect All Clients'''. It is possible to add and manage several stations.
 +
* When successfully connected to a Turbine station this is indicated by the text "- connected" next to the station
 +
* A station can be deleted from the list by highlighting it in the list, then press the "Delete" button on your laptop
 +
* Select from the list which station you want to control. Multiple stations can be selected by "Ctrl + click"
  
−
Close SSH port
+
[[Image:TestDemo Connect.PNG|thumb|left|500px|Successfully connected to a Turbine device]]
−
*Logon to Turbine IP station
+
<br style="clear:both;" />
−
*Check the firewall settings in ”Advanced Network”.
+
 
−
*Open up SSH port
+
 
 +
== Test Mode View - applications==
 +
Start the "Turbine Test and Demo Application" on your laptop, and select the tab '''Test Mode View'''.
 +
 
 +
===Audio Clip to Loudspeaker===
 +
Start playing an audio clip by clicking on the wanted audio clip. '''Stop Playing''' will terminate the play.
 +
[[Image:TestDemo AudioClips.PNG|thumb|left|700px|Play audio clips in loudspeaker]]
 +
<br style="clear:both;" />
 +
 
 +
===Audio Clip to Mic===
 +
When '''Audio Clip to Mic Signal''' is enabled the audio file will be played to the microphone input instead of speaker output.
 +
 
 +
This means that during an active call one can send an audio clip from the Turbine under control to the other conversation partner.
 +
 
 +
===Tone Frequency Slider===
 +
Slide to play tones with 100 HZ steps 100-8000 Hz.
 +
 
 +
===Audio Recordings===
 +
On the Turbine devices it is possible for debugging purposes to record the audio, and store the audio files on the device it self.
 +
 
 +
This could be helpful when experiencing audio quality issues. The device will record what it is playing, picking up and what it is sending to the other participant of the conversation after echo- and noise cancellation have been applied.
 +
 
 +
*'''Start Recording''': New recording starts and timer counter shows time of running recording
 +
*'''Stop Recording''': Stop recording and writeout wav headers to .wav files.
 +
*'''Download Recordings''': Click on link and all three recoding files are downloaded to PC. Check Status window for destination
 +
 
 +
[[Image:Audio Recording.png|thumb|left|700px|Audio Recording]]
 +
<br style="clear:both;" />
 +
 
 +
<br>
 +
The recorded files:
 +
*'''AecSignalMicIn.wav''': Recorded signal direct from mic (HW Codec ADC). This signal is only processed by HW Codec by Gain blocks and Filter blocks.
 +
*'''AecSignalOut.wav''': Signal out from AEC filter and software gain blocks. This is the real signal sent to far-end station in conversation.
 +
*'''AecSignalToSpeaker.wav''': Signal from far-end station in conversation after decoding audio codec. Played directly to speaker and used as AEC reference signal.
 +
'''Prefix''': Add a filename prefix for all recordings for easy doing a series of recordings and label the files.
 +
 
 +
 
 +
== Demo Mode View ==
 +
From the '''Demo Mode View''' tab you can [[#Play_audio_clips|play audio clips]] of prerecorded speech, music and alarm signals. In order to use the '''Demo Mode View''', a Demo Media Package must be installed in the Turbine device.
 +
 
 +
===Load media files onto Turbine device ===
 +
* From the [[Downloads#Applications_and_Tools|downloads page]] download the file '''vsf-demo-media_2.0.3.0.ipk''' to your computer
 +
* Use a TFTP server on your PC, and upload the file from to the Turbine station by selecting '''Station Administration''' > '''Manual Upgrade''' in the web interface. Note: Enter the filename ''without'' the '''.ipk''' extension
 +
* Select '''Start Upgrade'''. The file will now be uploaded. This process takes approximately 2 minutes
 +
[[File:TestDemo Media.PNG|thumb|left|500px|Upload the media package file]]
 +
<br style="clear:both;" />
 +
 
 +
 
 +
 
 +
* When the upload is finished, select '''Upgrade'''. The media files will now be installed and the Turbine station will reboot.
 +
[[File:TestDemo Media2.PNG|thumb|left|500px|Upgrade process information]]
 +
<br style="clear:both;" />
 +
 
 +
=== Play audio clips ===
 +
When the device is up and running, the audio clips in '''Demo Mode View''' tab are ready to be used:
 +
 
 +
[[File:TestDemo DemoMode.png|thumb|left|500px|Demo Mode View]]
 +
<br style="clear:both;" />
 +
 
 +
 
 +
 
 +
== Performance View ==
 +
===Highlights===
 +
* Real-time data stream of Audio Data from Turbine device
 +
* Signal levels: Microphone (Near-End), Microphone after [[Acoustic Echo Cancellation (AEC)|AEC]] and [[Active Noise Cancellation (ANC)|ANC]] (Near-End-Processed) and Loudspeaker (Far-End)
 +
* [[Automatic Volume Control (AVC)|AVC]] Gain adjustment data
 +
* Refresh interval 100 ms
 +
 
 +
Audio statistics are sent from the Turbine device to the laptop over '''UDP port 5035'''. Firewalls in network and on the laptop needs to allow these port.
 +
 
 +
===Measuring ambient noise ===
 +
The Test & Demo Tool can be used to display the ambient noise level measured by the Turbine device. This can be useful when the microphone is used as sensor microphone for the [[Distributed Automatic Volume Control (DAVC) (SIP)|AVC (Automatic Volume Control) feature]].
 +
 
 +
*Make sure the Turbine device you want to trace is selected and connected in listbox to the right.
 +
*Start audio trace by '''Start Tracing''' button as indicated below.
 +
 
 +
[[File:TestTool MicMeasure.png|thumb|left|900px|Performance View]]
 +
<br style="clear:both;" />
 +
 
 +
In the top right corner of the window popping up, set:
 +
* SPL Level
 +
* Moderate
 +
 
 +
The "'''sin SPL Avg'''" shows the average SPL level measured by microphone.
 +
 
 +
[[File:TestTool MicMeasure2.png|thumb|left|900px|Performance View - One graph is showing realtime SPL, the other the average SPL]]
 +
<br style="clear:both;" />
 +
 
 +
{{note|SPL dBA measurements are not valid under 50 dBA. Hence, if the microphone is located in a very silent room, the SPL dBA measurements might not be valid.}}
 +
 
 +
*Stop audio trace by pressing the '''Stop Tracing''' button.
 +
 
 +
{{note|After using these functions and leaving site it is recommended to restart the Turbine device to make sure the streaming is terminated}}
 +
 
 +
<br>
 +
 
 +
===AVC Gain adjustment data ===
 +
The Test & Demo Tool can be used to display the amplifier gain of a device, e.g. an ENA amplifier. This can be useful when tuning the [[Distributed Automatic Volume Control (DAVC) (SIP)|DAVC (Automatic Volume Control) feature]].
 +
 
 +
*Make sure the device (e.g. ENA amplifier) you want to trace is selected and connected in listbox to the right.
 +
*Select '''Performance View''', and start audio trace by '''Start Tracing''' button as indicated below.
 +
 
 +
[[File:TestTool MicMeasure.png|thumb|left|900px|Performance View]]
 +
<br style="clear:both;" />
 +
 
 +
 
 +
The graph in the lower window will show the amplifier gain, and how the gain changes when ambient noise in changing.
 +
 
 +
[[File:DAVC Test Demo.png|thumb|left|901px|Performance View - Monitoring amplifier gain and Lock of Volume adjustment]]
 +
<br style="clear:both;" />
 +
 
 +
{{note|The '''AVC Lock''' graph is shown for Channel 1 only}}
 +
 
 +
Examlpe of DAVC configuration in an ENA Amplifier:
 +
 
 +
[[File:DAVC Settings.png|thumb|left|900px|DAVC Settings in ENA amplifier related to the above graph]]
 +
<br style="clear:both;" />
 +
 
 +
*Stop audio trace by pressing the '''Stop Tracing''' button.
 +
 
 +
[[Category: Audio Settings and Audio Features]]

Latest revision as of 15:13, 17 June 2024

The Turbine Test & Demo Application

The Turbine Test and Demo Application is a PC application that allows you play audio files directly from the Turbine station without connection to any server. It also allows you to do audio recordings to be used for trouble shooting if there are issues related to audio in the Turbine station.

The application has seven options:

  • Test Mode View
  • Demo Mode View
  • Performance View
  • Audio Lines
  • AudioClient Instances
  • Audio Streams
  • AudioProcessing

Demo Mode requires that an additional audio file package (vsf-demo-media package) is uploaded to the station. Test Mode will work without this package.


Installation of the software

Install the "Turbine Test and Demo Application" on your PC

  • Download the file VS-Tools-1.04.0011.msi from the download page. This installation package includes the Turbine Test and Demo Application as well as a PC-tool for image upgrade of the AMC-IP board.
  • Install the software on the PC

Open the port for "Demo" and "AudioData" in Turbine IP device

  • Logon to the web interface of the Turbine IP device
  • Check the firewall settings in Advanced Network.
  • Enable the Demo (TCP port 50010) and "AudioData" (UDP port 5035). A reboot is required for the changes to take effect. Note! Make sure these ports are open in your laptop as well.
Open the port "Demo" and "AudioData" on the Turbine device


Add stations or devices

  • In the "Turbine Test and Demo Application" you can add stations via the list on the right hand side by typing the IP Address of the Turbine station you want to control, then press Add Turbine Station IP
  • When the station is added to the list, press the button Connect All Clients. It is possible to add and manage several stations.
  • When successfully connected to a Turbine station this is indicated by the text "- connected" next to the station
  • A station can be deleted from the list by highlighting it in the list, then press the "Delete" button on your laptop
  • Select from the list which station you want to control. Multiple stations can be selected by "Ctrl + click"
Successfully connected to a Turbine device



Test Mode View - applications

Start the "Turbine Test and Demo Application" on your laptop, and select the tab Test Mode View.

Audio Clip to Loudspeaker

Start playing an audio clip by clicking on the wanted audio clip. Stop Playing will terminate the play.

Play audio clips in loudspeaker


Audio Clip to Mic

When Audio Clip to Mic Signal is enabled the audio file will be played to the microphone input instead of speaker output.

This means that during an active call one can send an audio clip from the Turbine under control to the other conversation partner.

Tone Frequency Slider

Slide to play tones with 100 HZ steps 100-8000 Hz.

Audio Recordings

On the Turbine devices it is possible for debugging purposes to record the audio, and store the audio files on the device it self.

This could be helpful when experiencing audio quality issues. The device will record what it is playing, picking up and what it is sending to the other participant of the conversation after echo- and noise cancellation have been applied.

  • Start Recording: New recording starts and timer counter shows time of running recording
  • Stop Recording: Stop recording and writeout wav headers to .wav files.
  • Download Recordings: Click on link and all three recoding files are downloaded to PC. Check Status window for destination
Audio Recording



The recorded files:

  • AecSignalMicIn.wav: Recorded signal direct from mic (HW Codec ADC). This signal is only processed by HW Codec by Gain blocks and Filter blocks.
  • AecSignalOut.wav: Signal out from AEC filter and software gain blocks. This is the real signal sent to far-end station in conversation.
  • AecSignalToSpeaker.wav: Signal from far-end station in conversation after decoding audio codec. Played directly to speaker and used as AEC reference signal.

Prefix: Add a filename prefix for all recordings for easy doing a series of recordings and label the files.


Demo Mode View

From the Demo Mode View tab you can play audio clips of prerecorded speech, music and alarm signals. In order to use the Demo Mode View, a Demo Media Package must be installed in the Turbine device.

Load media files onto Turbine device

  • From the downloads page download the file vsf-demo-media_2.0.3.0.ipk to your computer
  • Use a TFTP server on your PC, and upload the file from to the Turbine station by selecting Station Administration > Manual Upgrade in the web interface. Note: Enter the filename without the .ipk extension
  • Select Start Upgrade. The file will now be uploaded. This process takes approximately 2 minutes
Upload the media package file



  • When the upload is finished, select Upgrade. The media files will now be installed and the Turbine station will reboot.
Upgrade process information


Play audio clips

When the device is up and running, the audio clips in Demo Mode View tab are ready to be used:

Demo Mode View



Performance View

Highlights

  • Real-time data stream of Audio Data from Turbine device
  • Signal levels: Microphone (Near-End), Microphone after AEC and ANC (Near-End-Processed) and Loudspeaker (Far-End)
  • AVC Gain adjustment data
  • Refresh interval 100 ms

Audio statistics are sent from the Turbine device to the laptop over UDP port 5035. Firewalls in network and on the laptop needs to allow these port.

Measuring ambient noise

The Test & Demo Tool can be used to display the ambient noise level measured by the Turbine device. This can be useful when the microphone is used as sensor microphone for the AVC (Automatic Volume Control) feature.

  • Make sure the Turbine device you want to trace is selected and connected in listbox to the right.
  • Start audio trace by Start Tracing button as indicated below.
Performance View


In the top right corner of the window popping up, set:

  • SPL Level
  • Moderate

The "sin SPL Avg" shows the average SPL level measured by microphone.

Performance View - One graph is showing realtime SPL, the other the average SPL


Note icon SPL dBA measurements are not valid under 50 dBA. Hence, if the microphone is located in a very silent room, the SPL dBA measurements might not be valid.


  • Stop audio trace by pressing the Stop Tracing button.
Note icon After using these functions and leaving site it is recommended to restart the Turbine device to make sure the streaming is terminated



AVC Gain adjustment data

The Test & Demo Tool can be used to display the amplifier gain of a device, e.g. an ENA amplifier. This can be useful when tuning the DAVC (Automatic Volume Control) feature.

  • Make sure the device (e.g. ENA amplifier) you want to trace is selected and connected in listbox to the right.
  • Select Performance View, and start audio trace by Start Tracing button as indicated below.
Performance View



The graph in the lower window will show the amplifier gain, and how the gain changes when ambient noise in changing.

Performance View - Monitoring amplifier gain and Lock of Volume adjustment


Note icon The AVC Lock graph is shown for Channel 1 only


Examlpe of DAVC configuration in an ENA Amplifier:

DAVC Settings in ENA amplifier related to the above graph


  • Stop audio trace by pressing the Stop Tracing button.
Retrieved from "https://wiki.zenitel.com/w/index.php?title=Turbine_Test_and_Demo_Application&oldid=236565"