Actions

Difference between revisions of "Turbine Test and Demo Application"

From Zenitel Wiki

(AVC Gain adjustment data)
 
(102 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[File:TurbineTestDemo2433.png|right|450px|thumb|The Turbine Test & Demo Application]]
+
[[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.
 
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.
  
Line 20: Line 20:
 
* Install the software on the PC
 
* Install the software on the PC
  
===Open the port for "Demo" in Turbine IP device ===
+
===Open the port for "Demo" and "AudioData" in Turbine IP device ===
 
* Logon to the web interface of the Turbine IP device
 
* Logon to the web interface of the Turbine IP device
 
* Check the firewall settings in '''Advanced Network'''.
 
* Check the firewall settings in '''Advanced Network'''.
* Enable the '''Demo''' port (55010)
+
* 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.
[[File:Demo port enable.PNG|thumb|left|500px|Open the port for "Demo" on the Turbine device]]
+
[[File:TestDemo Firewall.PNG|thumb|left|700px|Open the port "Demo" and "AudioData" on the Turbine device]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
== Basic application use==
+
==Add stations or devices==  
Start the "Turbine Test and Demo Application" on your PC.
+
* 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.
===Add stations===
 
* 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, 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
 
* 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
 
* A station can be deleted from the list by highlighting it in the list, then press the "Delete" button on your laptop
Line 39: Line 36:
 
[[Image:TestDemo Connect.PNG|thumb|left|500px|Successfully connected to a Turbine device]]
 
[[Image:TestDemo Connect.PNG|thumb|left|500px|Successfully connected to a Turbine device]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
 +
 +
 +
== 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===
 
===Tone Frequency Slider===
 
Slide to play tones with 100 HZ steps 100-8000 Hz.  
 
Slide to play tones with 100 HZ steps 100-8000 Hz.  
  
===Audio Clip to Mic===
+
===Audio Recordings===
The feature can be used to route the audio file being played to the mic input instead of speaker output.
 
*One test case is calling into a station and get it to automatically talk back to you or send some test signals.
 
 
 
==Audio Recording==
 
 
On the Turbine devices it is possible for debugging purposes to record the audio, and store the audio files on the device it self.
 
On the Turbine devices it is possible for debugging purposes to record the audio, and store the audio files on the device it self.
  
Line 54: Line 61:
 
*'''Start Recording''': New recording starts and timer counter shows time of running recording
 
*'''Start Recording''': New recording starts and timer counter shows time of running recording
 
*'''Stop Recording''': Stop recording and writeout wav headers to .wav files.
 
*'''Stop Recording''': Stop recording and writeout wav headers to .wav files.
*'''Download Recording''': Click on link and all three recoding files are downloaded to PC. Check Status window for destination  
+
*'''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|500px|Audio Recording]]
+
[[Image:Audio Recording.png|thumb|left|700px|Audio Recording]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Line 64: Line 71:
 
*'''AecSignalOut.wav''': Signal out from AEC filter and software gain blocks. This is the real signal sent to far-end station in conversation.
 
*'''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.
 
*'''AecSignalToSpeaker.wav''': Signal from far-end station in conversation after decoding audio codec. Played directly to speaker and used as AEC reference signal.
'''Prefix''': A filename prefix for all recordings for easy doing a series of recordings and label them.
+
'''Prefix''': Add a filename prefix for all recordings for easy doing a series of recordings and label the files.
  
==Load media files onto Turbine IP station==
 
'''Demo Mode''' allows you to play audio clips of prerecorded speech, music and alarm signals. In order to use the '''Demo Mode''', a Demo Media Package must be installed in the Turbine station. For '''Test Mode''' this is not neccessary.
 
  
 +
== 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
 
* 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
+
* 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 '''Save Settings'''. The file will now be uploaded. This process takes approximately 2 minutes
+
* Select '''Start Upgrade'''. The file will now be uploaded. This process takes approximately 2 minutes
[[File:TurbineDemoUpload2.PNG|thumb|left|500px|Upload the media package file]]
+
[[File:TestDemo Media.PNG|thumb|left|500px|Upload the media package file]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
 +
 +
  
 
* When the upload is finished, select '''Upgrade'''. The media files will now be installed and the Turbine station will reboot.
 
* When the upload is finished, select '''Upgrade'''. The media files will now be installed and the Turbine station will reboot.
[[File:TurbineDemoUpload.PNG|thumb|left|500px|Upgrade process information]]
+
[[File:TestDemo Media2.PNG|thumb|left|500px|Upgrade process information]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
* When the station is up and running, it is ready to be used by the Test and Demo Application.
+
=== Play audio clips ===
 +
When the device is up and running, the audio clips in '''Demo Mode View''' tab are ready to be used:
  
==Turbine stations with 3.0.3.4 software==
+
[[File:TestDemo DemoMode.png|thumb|left|500px|Demo Mode View]]
[[File:TurbineDemoApplication.PNG|right|350px|thumb|The Turbine Demo Application for software 3.0.x.x]]
+
<br style="clear:both;" />
'''Note:''' It is recommended to upgrade the Turbine station to 4.2.x.x, and use the Demo Application for that version.
 
  
=== Installation of demo software ===
 
  
To install demo software for your Turbine, the following steps must be taken:
 
#Open up SSH and TCP port in Turbine IP station for demo application
 
#Load media files onto Turbine IP station
 
#Install demo application on your PC
 
#Close SSH port
 
  
====Open SSH and TCP port in Turbine IP station for demo application====
+
== Performance View ==
*Logon to the web interface of the Turbine IP station
+
===Highlights===
* Set the station in '''SIP Mode'''
+
* Real-time data stream of Audio Data from Turbine device
*Check the firewall settings in '''Advanced Network'''.
+
* 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)
*Open up SSH port
+
* [[Automatic Volume Control (AVC)|AVC]] Gain adjustment data
*Enable the Demo application port 55010
+
* Refresh interval 100 ms
  
==== Load media files onto Turbine IP station ====
+
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.
  
The file '''turbine-media-demo_3.0.1.3-2_armel.ipk''' must be uploaded and installed in each Turbine station. Contact alphasupport@zenitel.com to get this file.
+
===Measuring ambient noise ===
*Copy this package to /tmp on the Turbine station using for example WinSCP. The protocol is SCP. Tool: http://winscp.net/eng/index.php
+
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]].
*Login to the Turbine consol with protocol SSH. Tool: http://www.chiark.greenend.org.uk/~sgtatham/putty/
 
*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 ====
+
*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.
*Download the '''TurbineCommandClient.zip''' from the [[Downloads#Turbine_station|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.
 
*In the application, double-click inside the picture of the station to set IP address of the station
 
* Press '''Connect to Mr. Turbine''' and red color should become green to show that you have a connection to the Turbine Station.
 
*You might have to reset the PC first time after installation to make it work.
 
  
 +
[[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.
  
====Close SSH port====
+
[[File:TestTool MicMeasure2.png|thumb|left|900px|Performance View - One graph is showing realtime SPL, the other the average SPL]]
*Logon to the web interface of the Turbine IP station
+
<br style="clear:both;" />
*Check the firewall settings in ”Advanced Network”.
+
 
*Disable the SSH port
+
{{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]]
 
[[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.