FREUND IP-INTEGRA VoIP for Windows User Manual
- June 4, 2024
- FREUND
Table of Contents
USER MANUAL IP-INTEGRA VoIP for Windows
USER MANUAL
General Information
IP-INTEGRA VoIP for Windows does not require the installation of additional
libraries, runtimes or frameworks.
If automatic start-up of the application is enabled, or when you close the
main window, IP-INTEGRA VoIP for Windows will be minimized to the system tray.
Softphone usage modes:
- Single call mode – single window, basic functionality. Enabled by default.
- Extended mode – two windows, multiple calls, conferences, attended transfers.
Communication types:
- Calls through SIP server / PBX – select “Add Account” after installing.
- Direct calls by IP address (or domain name) – works out of the box, using the “Local Account”.
1.1 Interface Description
- Menu
- Dialer – Enter the name/number/extension you wish to call
- Keypad
- Video call/Audio call/Message
- Speaker and Microphone Volume
- Do-not-disturb/Auto-Answer
- Extension status (Online/Offline/Timeout)
- Extension number 1.1 Dialer
1.2 Call List
1.3 Contacts
Welcome screen / Dialpad
Mainly used for dialing or sending dual tones (DTMF). Various input formats
are supported.
Example: 1-800-567-46-57; 1234;
1234@sip.server.com;
1234@sip.server.com:5043; 192.168.0.55
Contacts
To add a contact, right-click in an empty area of the Contacts page. Only the
Number field is required. One number can be added to the Contacts list only
once. Numbers can be specified in various input formats.You can enable Presence Subscription to see
contact availability status, use BLF functionality, and pickup calls. This may
require additional configuration of your SIP server. For some types of servers
(not Asterisk), you must enable “Publish Presence” in the “Account” window to
share your availability status for other contacts. After successfully setting
up the presence, the entries in your contacts will have a color indication.
When a contact receives an incoming call, its icon will blink. To answer the
incoming call (directed call pickup), double click on it or use the context
menu item – “Call Pickup”. The pickup code is hardcoded: “”. For example, to
configure call pickup for Asterisk, add to extensions.conf: extent =>
_.,1,Pickup(${EXTEN:2})
Messages
Allows you to send and receive messages to devices that support messaging.
|
---|---
Account
To set up an account, click on the Menu, and then Add Account.For a detailed explanation of how to install and set up the IP-INTEGRA VoIP for Windows, please refer to our Application Note available here.
- SIP server – your account SIP server
- SIP proxy – Your account SIP proxy or a chain of proxies. Examples: 192.168.1.1, 192.168.1.1;hide, “; hide” parameter can solve impossibility of registration or calls due to server configuration
- Username – your account username
- Domain – your account domain
- Login – username for authentication. If empty, will be used Username
- Password – Your account password
- Display name – Your name, the remote party will see it in incoming calls and messages
- Dialing Prefix – International calling prefix for numbers in local format (must begin with “+” or “00”), or a simple prefix for each dialing phone number
- Dial Plan – transforms dialing number according to pattern. Numbers that do not match any patterns are blocked. Patterns are separated by a pipe symbol: |. The entire value can be enclosed in brackets ()
x [sequence] – “x” represents any character.
Enter characters within square brackets to create a list of accepted digits.
Numeric range: enter [2-9] to allow the user to enter any one digit from 2
through 9. Numeric range with other characters: enter [16- 9] to allow the
user to enter 1, 6, 7, 8, 9, or .
Example 1: <8:1555> If user dials 81234567, the 8 will be substituted and the
system will transmit as follows: 15551234567.
Example 2: <:1> If user dials 1234567890, the system transmits 11234567890. .
(period symbol)
Represents zero or more entries of the previous digit.
Example: 01.=> 0,01,011,0111,…,x.=>matches any dialed number.
- Voicemail Number – Voicemail access number. If empty, IP-INTEGRA for Windows will try to determine it automatically
- Media encryption – Disabled – never use encryption, Optional – use encryption when remote party supports encryption, Mandatory – use encryption always. Recommend value: Optional
- Transport – The value depends on the configuration of your SIP server. Failsafe value: UDP. Best value: TLS. TCP is good, but it may not work with your router/NAT due to SIP ALG being enabled. “UDP+TCP” is a mix of UDP (for small requests) and TCP (for large)
- Public address – Can be used to solve call flow and media delivery issues when you do not have a dedicated public IP address. You can manually specify IP address or hostname for Via, Contact, and SDP. It can point to one of the interface’s addresses OR it can point to the public address of a NAT router where port mappings have been configured. For automatic public address detection and rewrite you can use Allow IP rewrite feature or use the STUN server
- Local port – By default IP-INTEGRA for Windows tries to listen on standard SIP port – 5060. If the port is busy by another application, IP-INTEGRA for Windows will listen on a random port. You can manually change the port to any
- Publish presence – Sends on SIP server publish query, it means that other subscribed contacts can see your status and can pick up your incoming calls (BLF functionality). Besides, often you must specify which contacts have the right to see your presence information – you can do this for example via SIP provider webpage. Your SIP server must support this feature
- ICE – Helps to find the shortest way for media streams and reduce media latency. It is useful when possible direct P2P connection without an SIP provider media gate. Enabling ICE can cause problems within media delivery if SIP server is configured incorrectly
- Allow IP rewrite – Can be used to solve call flow and media delivery issues when you do not have a dedicated public IP address. If enabled, IPINTEGRA for Windows will keep track of the public IP address from the response of the REGISTER request. Public IP will be used in later SIP queries in Via, Contact and SDP. See also: Public address, STUN
- Disable Session Timers – Specify the usage of Session Timers. Try to disable Session Timers if your calls drop after XX minutes. Recommended value: Unchecked
Settings
- Single call mode – Provides a simple user interface with limited functionality. You must disable this if you wish to manage multiple calls, make attended transfers or conference calls
- Ringtone – You can choose any WAV file on an incoming call
- Microphone Amplification – Extends the range of input signal level regulation by adding software amplification on top half of the regulator. Default value – no
- Software Level Adjustment – Enables internal input level regulation instead of changing the global level of the input device. Note that hardware regulation has a lower noise rating. Default value – no
- Audio Codecs – You can enable and disable codecs by moving it between lists. Also, you can set codec priority (for outgoing calls) by moving codecs in the right list
- VAD – Enables voice activity detection. Default value – no
- EC – Enable echo cancellation. Default value – no 12
- Force codec for incoming – Normally, the caller defines codec priority. For incoming calls, this option allows you (callee) to select the preferred codec
- Disable H.264 codec – Normally, caller defines codec that will be used by both parties. But some callees parties force your selected codec with some other, but in the same time they support your codec. In this case you can disable unwanted codec. Default value – no
- Disable H.263 codec – See above. Default value – no
- Video codec bitrate – Set the maximum bitrate. If one party set 256 kbit/s and the other 512 kbit/s – will be used 256 kbit/s for both. Dynamic scenes require higher bitrates (~512 kbit/s), otherwise picture quality will degrade
- DTMF Method – Auto: IP-INTEGRA for Windows will use RFC2833 for DTMF relay by default but will switch to in-band audio DTMF tones if the remote side does not indicate support of RFC2833 in SDP. Note: in-band method will not work properly with every audio codec due to compression algorithms
- Auto answer – IP-INTEGRA for Windows will play a short tone and popup when the call is auto-accepted. SIP header – when receiving the “Call-Info: Auto Answer” or “Call- Info: answer-after=0” or “X-AUTOANSWER: TRUE” in the SIP header
- Deny incoming – Helps to block unwanted or spam incoming calls. Different user/domain/user-domain means that callee data do not match data in your account window. Different remote domain means that the caller domain does not match the domain in your account window
- Directory of users – Enter URL to obtain contacts from an external source via HTTP(s). JSON and XML responses are supported. Use UTF-8 encoding
Also supports Cisco IP phone directory format, Yealink and some others – just try yours. To change the frequency of automatic refresh use “refresh” property or HTTP header “CacheControl: max- age=3600”, where 3600 – value in seconds. If zero or not specified will be used default value is 3600 seconds.
- STUN server – Helps to make direct way for media streams without SIP provider media gate when NAT is used. It opens UDP ports on the NAT server for incoming connections. Exists different NAT types (full cone NAT, (address) restricted cone NAT, port restricted cone NAT and symmetric NAT). You can use STUN only if your NAT is not symmetric! Otherwise, you will have problems – you cannot hear and cannot hears you – remove it from settings. Default value – empty
- Handle Media Buttons – Enables handling of media keys or button events on multimedia keyboards or headsets with buttons (WM_APPCOMMAND message). Can be used for call answer, hold, resume, and end calls
- Sound events – Playback key presses and signals of outgoing call
- Enable local account – Local account allows you to make and receive calls without a SIP server and SIP account. In this case, you can call by IP address (or domain name) as a number. Note: local account always enabled if SIP account is not configured or disabled. Example: sip:192.168.1.21 or just 192.168.1.21 or username@192.168.1.21
- Enable log file – Activates IP-INTEGRA for Windows log file. Used for debugging. To open log file right click on tray icon
- Random position of the answer box – Display the incoming call window at a random position on the screen and random monitor
- Send crash report – Automatically send a crash report to the IP-INTEGRA for the Windows team for analysis. The report includes OS name and version, log file (if enabled in Settings). It never contains your passwords
DTMF
While you are in a call you can press buttons on dial pad to send DTMF
signals. If you want automatically to pass DTMF commands just after call is
established, then add “,dtmf_sequence” or “, dtmf_sequence1, dtmf_sequence2”
in calling number. One comma means a pause in one second.
Video
Supported H.264 and H.263+ (another name H.263-1998) video codecs. Default
codec – H.264, video format – 640×480 @ 30 fps, outgoing bitrate 512 kbit/s.
H.264 encoding requires significant CPU resources. Recommended dual-core
processor, multimedia extensions like MMX will be used if is present.
Video capture and video rendering use DirectX and Direct3D (with hardware
acceleration). Because hardware acceleration is used, video calls will not
work with a remote desktop session (RDP).
If you have serious problems with performance:
– update video adapter drivers
– install/reinstall DirectX
Remarks
This feature increases a UDP packet size (SDP message length of INVITE query).
If UDP packet size will be > 1500 bytes (MTU), it will be fragmented. Not all
routers can correctly work with fragmented UDP packets. If any extra features
are enabled (like SRTP, or ICE, or select too many enabled codecs, or making
video call) there is a chance that you will not be able to make a call.
Possible solutions: use a TCP or TLS transport, but in this case your SIP
server must support it. Please note that TCP may not work with SIP ALG enabled
on your router
Freund Elektronik A/S, in cooperation with our sister company Freund
Elektronika D.O.O. Sarajevo, is developing an IP-Based Intercoms, Audio
Systems, Access Control and Smart Home solutions.
As a developer, manufacturer, and reseller, we have been self-improving and
perfecting ourselves for over 30 years. In the industry, we negotiate the most
advanced and innovative solutions regarding building communication. Our daily
focus is on the development and user-friendliness of our high-quality and
pleasantly designed products. As a developer and manufacturer of our own IP-
INTEGRA system, we have made top-of-the-line products for Door Telephony,
Public Audio, and Access Control solution. Our development department,
together with our partners, has created elegant and robust door phones, SIP-
Centrals, Terminals, IP-Speakers, ACC Controllers, and applications with
intelligent features using the most advanced technologies when available, and
creating new technologies when they are not while keeping it simple for our
customers.
FREUND ELEKTRONIKA d.o.o
International Burch University | Francuske revolution bb | 71210 Ilidza |
Bosnia and Herzegovina
www.ip-integra.com | info@ip-
integra.com | +387 33 922 890
References
- IP-INTEGRA INTERCOM solution
- IP-INTEGRA INTERCOM solution
- Cisco Unified IP Phone Services Application Development Notes, Release 7.0(1) - CiscoIPPhone XML Object Quick Reference [Support] - Cisco
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>