Actions

Difference between revisions of "Turbine Test and Demo Application"

From Zenitel Wiki
(→‎Measuring ambient noise)
(168 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
[[File:TurbineDemoApplication.PNG|right|350px|thumb|The Turbine Demo Application]]
+
[[File:TurbineTestDemo2433.png|right|550px|thumb|The Turbine Test & Demo Application]]
−
The '''Turbine Demo application''' and messaging package allows Turbine Compact IP Stations to work in demo mode. In demo mode you can play special .wav audio files directly from the IP stations without any connections to a server.
+
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
  
−
=Turbine stations with 4.2.3.9 software=
+
'''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 demo software==
+
 
−
===Open SSH and TCP port in Turbine IP station for demo application===
+
 
−
*Logon to the web interface of the Turbine IP station
+
==Installation of the software==
−
* Set the station in '''SIP Mode'''
+
 
−
*Check the firewall settings in '''Advanced Network'''.
+
===Install the "Turbine Test and Demo Application" on your PC===
−
*Open up SSH port
+
*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.
−
*Enable the Demo application port 55010
+
* Install the software on the PC
−
[[Image:turbine_demo_firewall.png|thumb|left|500px|Open the firewall ports on the Turbine station]]
+
 
 +
===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.
 +
[[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;" />
  
−
===Load media files onto Turbine IP station===
+
==Add stations or devices==
−
On the downloads page you will find a download called '''vsf-demo-media_2.0.3.0.ipk'''
+
* 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'''
−
Note! Installing the Demo Media Package is only necessary for Demo Mode. For test mode standard Turbine Image is enough.  
+
* 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"
  
−
*To use the demo mode the vsf-demo-media package needs to be uploaded.
+
[[Image:TestDemo Connect.PNG|thumb|left|500px|Successfully connected to a Turbine device]]
−
*This can be uploaded using same system as a normal image upgrade.
 
−
*Put the IPKG package on your TFTP server and insert the name (without ipk extension) in station web form.
 
−
*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: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;" />
  
−
===Install demo application on your PC===
 
−
*Download VS-Tools from the download page. This installation package is a bundle of a PC-tool for flash image upgrade of the AMC-IP as well as the Turbine Demo Application.
 
−
*Install the software.
 
  
−
== Basic application use==
+
== Test Mode View - applications==
−
===Add stations===
+
Start the "Turbine Test and Demo Application" on your laptop, and select the tab '''Test Mode View'''.
−
*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]]
+
===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;" />
 
<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.
+
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.
 +
 
  
−
=Turbine stations with 3.0.3.4 software=
+
== Demo Mode View ==
−
== Installation of demo software ==
+
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.
  
−
To install demo software for your Turbine, the following steps must be taken:
+
===Load media files onto Turbine device ===
−
#Open up SSH and TCP port inTurbine IP stastion for demo application
+
* From the [[Downloads#Applications_and_Tools|downloads page]] download the file '''vsf-demo-media_2.0.3.0.ipk''' to your computer
−
#Load media files onto Turbine IP station
+
* 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
−
#Install demo application on your PC
+
* Select '''Start Upgrade'''. The file will now be uploaded. This process takes approximately 2 minutes
−
#Close SSH port
+
[[File:TestDemo Media.PNG|thumb|left|500px|Upload the media package file]]
 +
<br style="clear:both;" />
  
−
===Open SSH and TCP port in Turbine IP station for demo application===
 
−
*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 ===
 
  
−
On the [[Downloads#Turbine_station|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.
+
* When the upload is finished, select '''Upgrade'''. The media files will now be installed and the Turbine station will reboot.
−
*Copy this package to /tmp on the Turbine station using for example WinSCP. The protocol is SCP. Tool: http://winscp.net/eng/index.php
+
[[File:TestDemo Media2.PNG|thumb|left|500px|Upgrade process information]]
−
*Login to the Turbine consol with protocol SSH. Tool: http://www.chiark.greenend.org.uk/~sgtatham/putty/
+
<br style="clear:both;" />
−
*Username/password: root/root and do following to install package:
+
 
−
# cd /tmp
+
=== Play audio clips ===
−
# ipkg install turbine-media-demo_3.0.1.3-2_armel.ipk
+
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;" />
  
−
=== Install demo application on your PC ===
+
*Stop audio trace by pressing the '''Stop Tracing''' button.
−
 
−
*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.
 
  
 +
{{note|After using these functions and leaving site it is recommended to restart the Turbine device to make sure the streaming is terminated}}
  
−
===Close SSH port===
+
[[Category: Audio Settings and Audio Features]]
−
*Logon to the web interface of the Turbine IP station
 
−
*Check the firewall settings in ”Advanced Network”.
 
−
*Disable the SSH port
 

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"