Actions

Difference between revisions of "Turbine Test and Demo Application"

From Zenitel Wiki

(→‎Load media files onto Turbine IP station)
(→‎Measuring ambient noise)
(144 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
[[File:TurbineTestDemoClient.PNG|right|350px|thumb|The Turbine Demo Application for software 4.2.x.x]]
+
[[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 any connections to a 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.
  
−
The client operates on two modes:
+
The application has seven options:
 
* Test Mode View
 
* Test Mode View
 
* Demo Mode View
 
* Demo Mode View
 +
* Performance View
 +
* Audio Lines
 +
* AudioClient Instances
 +
* Audio Streams
 +
* AudioProcessing
  
−
Demo Mode required that an additional audio file package (vsf-demo-media package) is uploaded to the station. Test Mode will work without this package.
+
'''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.
  
−
There are two versions of the Turbine Test and Demo Application. The new version works with Turbine software 4.2.x.x.  The old version is for Turbine software version 3.0.x.x.
 
−
In case you have Turbine with ver. 3.0.x.x, it is recommended to upgrade to version 4.2.x.x., and use the newest version of the Turbine Test and Demo Application.
 
  
 +
==Installation of the software==
  
−
=Turbine stations with 4.2.3.9 software=
+
===Install the "Turbine Test and Demo Application" on your PC===
−
==Installation of demo software==
+
*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.
 +
* Install the software on the PC
  
−
===Install demo application on your PC===
+
===Open the port for "Demo" and "AudioData" in Turbine IP device ===
−
*Download the file '''VS-Tools.msi''' from the [[Downloads#Turbine_Test_and_Demo_Application|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.
+
* Logon to the web interface of the Turbine IP device
−
*Install the software on the PC
+
* Check the firewall settings in '''Advanced Network'''.
 +
* Enable the '''Demo''' (TCP port 55010) and "AudioData" (UDP port 5035). A reboot is required for the changes to take effect. Make sure these ports are open in your laptop as well.
 +
[[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"
  
−
===Open SSH and TCP port in Turbine IP station for demo application===
+
[[Image:TestDemo Connect.PNG|thumb|left|500px|Successfully connected to a Turbine device]]
−
*Logon to the web interface of the Turbine IP station
 
−
*Check the firewall settings in '''Advanced Network'''.
 
−
*Open up SSH port
 
−
*Enable the Demo application port 55010
 
−
[[Image:turbine_demo_firewall.png|thumb|left|500px|Open the firewall ports on the Turbine station]]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
−
===Load media files onto Turbine IP station===
 
−
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.
 
  
−
On the [[Downloads#Turbine_Test_and_Demo_Application|downloads page]] you will find a download called '''vsf-demo-media_2.0.3.0.ipk'''
+
== Test Mode View - applications==
−
+
Start the "Turbine Test and Demo Application" on your laptop, and select the tab '''Test Mode View'''.
−
*To use the demo mode the vsf-demo-media package needs to be uploaded.
+
 
−
*This can be uploaded using same system as a normal image upgrade.
+
===Audio Clip to Loudspeaker===
−
*Put the IPKG package on your TFTP server and insert the name (without ipk extension) in station web form.
+
Start playing an audio clip by clicking on the wanted audio clip. '''Stop Playing''' will terminate the play.
−
*Note! Due to size of package and the complete process is done in the web page load process this you need to wait approximately 2 minute to process to finish.
+
[[Image:TestDemo AudioClips.PNG|thumb|left|700px|Play audio clips in loudspeaker]]
−
[[Image:turbine_demo_mediapackage_upload.png|thumb|left|500px|Upload the media package file]]
 
−
<br style="clear:both;" />
 
−
[[Image:turbine_demo_mediapackage_info.png|thumb|left|500px|Upgrade process ifno]]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
−
== Basic application use==
+
===Audio Clip to Mic===
−
===Add stations===  
+
When '''Audio Clip to Mic Signal''' is enabled the audio file will be played to the microphone input instead of speaker output.
−
*You can add stations via the list on the right hand side.
 
−
*When added all Stations to manage press the button "Connect All Clients".
 
  
−
[[Image:turbine_demo_add_stations.png|thumb|left|500px|Add Turbine stations]]
+
This means that during an active call one can send an audio clip from the Turbine under control to the other conversation partner.
−
<br style="clear:both;" />
 
  
 
===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.
+
On the Turbine devices it is possible for debugging purposes to record the audio, and store the audio files on the device it self.
−
*One test case is calling into a station and get it to automatically talk back to you or send some test signals.
+
 
 +
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;" />
  
−
===Audio Recordings===
 
−
*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 Recording: Click on link and all three recoding files is downloaded to PC. Check Status window for destination
 
 
<br>
 
<br>
−
*AecSignalMicIn.wav: Recorded signal direct from mic (HW Codec ADC). This signal is only processed by HW Codec by Gain blocks and Filter blocks.
+
The recorded files:
−
*AecSignalOut.wav: Signal out from AEC filter and software gain blocks. This is the real signal sent to far-end station in conversation.
+
*'''AecSignalMicIn.wav''': Recorded signal direct from mic (HW Codec ADC). This signal is only processed by HW Codec by Gain blocks and Filter blocks.
−
*AecSignalToSpeaker.wav: Signal from far-end station in conversation after decoding audio codec. Played directly to speaker and used as AEC reference signal.
+
*'''AecSignalOut.wav''': Signal out from AEC filter and software gain blocks. This is the real signal sent to far-end station in conversation.
−
Prefix: A filename prefix for all recordings for easy doing a series of recordings and label them.
+
*'''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;" />
  
−
=Turbine stations with 3.0.3.4 software=
 
−
[[File:TurbineDemoApplication.PNG|right|350px|thumb|The Turbine Demo Application for software 3.0.x.x]]
 
−
'''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:
+
== Performance View ==
−
#Open up SSH and TCP port inTurbine IP stastion for demo application
+
===Highlights===
−
#Load media files onto Turbine IP station
+
* Real-time data stream of Audio Data from Turbine device
−
#Install demo application on your PC
+
* 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)
−
#Close SSH port
+
* [[Automatic Volume Control (AVC)|AVC]] Gain adjustment data
 +
* Refresh interval 100 ms
  
−
===Open SSH and TCP port in Turbine IP station for demo application===
+
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.
−
*Logon to the web interface of the 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 ===
+
===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]].
  
−
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.
+
*Make sure the Turbine device you want to trace is selected and connected in listbox to the right.
−
*Copy this package to /tmp on the Turbine station using for example WinSCP. The protocol is SCP. Tool: http://winscp.net/eng/index.php
+
*Start audio trace by '''Start Tracing''' button as indicated below.
−
*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 ===
+
[[File:TestTool MicMeasure.png|thumb|left|900px|Performance View]]
−
+
<br style="clear:both;" />
−
*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.
 
  
 +
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;" />
  
−
===Close SSH port===
+
*Stop audio trace by pressing the '''Stop Tracing''' button.
−
*Logon to the web interface of the Turbine IP station
 
−
*Check the firewall settings in ”Advanced Network”.
 
−
*Disable the SSH port
 
  
 +
{{note|After using these functions and leaving site it is recommended to restart the Turbine device to make sure the streaming is terminated}}
  
−
[[Category: Turbine]]
+
[[Category: Audio Settings and Audio Features]]

Revision as of 10:50, 25 March 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 55010) and "AudioData" (UDP port 5035). A reboot is required for the changes to take effect. 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


  • 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


Retrieved from "https://wiki.zenitel.com/w/index.php?title=Turbine_Test_and_Demo_Application&oldid=236067"