Pingtel Hardphone

Pingtel Hardphones


Image Image Image

This page is hopefully the start of an aggregation of the so far very little information out there about using the Pingtel hardphone with Asterisk. There are still a handful of these hardphones out there, despite the manufacturer halting production of them and selling-off that line of business. Who they sold the hardphone business line to has been kept private from us.

The phones look quite nice, seem full-featured, seem to still have some support from their website (ie: a couple of rev's firmware & some PDF's) but not too much more.

The phone runs Java. The programmer's manual describing how to write Java apps to run on the phone can be found here (for as long as this non-Pingtel site cares to host the document.)

The web GUI supports only HTTP, not HTTPS.

If you have successfully used this phone with Asterisk, kindly improve the community and this page by posting a working configuration, screen shots, et cetera, et cetera, here. One thing that might be perfect is the publishing of the plain text configuration that the phone's webGUI summarizes/shows.

--
If I can do anything else for you, please contact me.

Peace. Love. Linux.



Pingtel Xpressa manuals


Beneath is a collection of manuals available for the Pingtel Xpressa phones. Depending on the software version you use you can download it directly by clicking the link description.

Quickstart Manual

Download here the Quickstart manual

User Manuals Version 1.0

Installing & Configuring Pingtel phones
Using Pingtel phones

User Manuals Version 1.2

Installing & Configuring Pingtel phones
Using Pingtel phones

User Manuals Version 2.1

Installing & Configuring Pingtel phones
Using Pingtel phones

User Manual Version 2.2

Using Pingtel Phones with SIPxchange

Programmers Manual Version 1.0

Programmersguide 1.0

Programmers Manual Version 1.2

Programmersguide 1.2

Guidelines for User Interface Design

xDK Guidelines for User Interface Design 1.2
xDK Guidelines for User Interface Design 2.0

--
Pingtel Appz are coming soon...
Cheers!


Hey - Great Page! - I have successfully used this phone with Asterisk!

I just got 5 of these phones on Ebay. Getting the config correct the first time was a little difficult. However, once you know how to do it, its simple!


  • First, make sure you are using the latest software :
    • connect to the phone with a browser
    • default user name is "admin" no password
    • go to Administration->Upgrade log
    • you should see version 2.1.11.24
  • If its not the latest version, you can still get the upgrade from Pingtel's site
    • see : https://secure.pingtel.com/dashboard/xpressaAnnouncement.jsp
    • follow the instructions in https://secure.pingtel.com/products/xpressa/downloads/2.1.11/xpressa-2_1_11.zip to upgrade
    • BTW - nice pdf manuals on this site
  • Then, simply upload config-pingtel and config-users files
    • edit the files as provided and described below
    • connect a browser to the phone
    • navigate to Administration->File Uploads
  • Make sure you provision the extension for the phone in your Asterisk setup
    • make sure NAT is set to "never"
      • otherwise registration will fail when Asterisk doesn't send SIP replies to port 5060
    • I use FreePBX - just add the extension and make sure NAT is set to "never"

Here's the configuration files :


pinger-config


PHONESET_ADMIN_DOMAIN :
PHONESET_DEPLOYMENT_SERVER :
PHONESET_DIALPLAN_LENGTH : 4
PHONESET_EXTERNAL_IP_ADDRESS :
PHONESET_LINE.ALLOW_FORWARDING : ENABLE
PHONESET_LINE.CREDENTIAL.1.PASSTOKEN :
PHONESET_LINE.CREDENTIAL.1.REALM : asterisk
PHONESET_LINE.CREDENTIAL.1.USERID : YourExtension
PHONESET_LINE.REGISTRATION : REGISTER
PHONESET_LINE.URL : "Production"<sip:YourExtension@YourAsteriskAddress>
PHONESET_LOGICAL_ID :
PHONESET_RTP_PORT_START :
SIP_DIRECTORY_SERVERS : sip:YourAsteriskAddress
SIP_PROXY_SERVERS : sip:YourAsteriskAddress
SIP_REGISTER_PERIOD : 3600
SIP_SESSION_REINVITE_TIMER :
SIP_TCP_PORT : 5060
SIP_UDP_PORT : 5060


user-config


PHONESET_AVAILABLE_BEHAVIOR : RING
PHONESET_BUSY_BEHAVIOR : BUSY
PHONESET_CALL_WAITING_BEHAVIOR : ALERT
PHONESET_DIGITMAP.(xxxx|xxxxxxxxxx|1xxxxxxxxxx|91xxxxxxxxxx|9xxxxxxxxxx) : "{digits}" <sip:{digits}@YourAsteriskAddress>
PHONESET_DND_METHOD : FORWARD_ON_BUSY
PHONESET_HTTP_PORT : 80
PHONESET_HTTP_PROXY_HOST :
PHONESET_HTTP_PROXY_PORT :
PHONESET_LOGO_URL :
PHONESET_MSG_WAITING_SUBSCRIBE :
PHONESET_RINGER : BOTH
PHONESET_SNMP_TRAP_DESTS :
PHONESET_TELNET_ACCESS : DISABLE
PHONESET_TIME_DST_RULE :
PHONESET_TIME_OFFSET :
PHONESET_TIME_SERVER :
PHONESET_VOICEMAIL_RETRIEVE :
SIP_AUTHENTICATE_SCHEME : NONE
SIP_FORWARD_ON_BUSY :
SIP_FORWARD_ON_NO_ANSWER :
SIP_FORWARD_UNCONDITIONAL :
USER_DEFAULT_OUTBOUND_LINE : PHONESET_LINE


Before uploading the files :

  1. You will need to replace "YourAsteriskAddress" with your asterisk IP or hostname in the above files
  2. You will need to replace "YourExtension" with the extension of the phone as configured in Asterisk
  3. You will want to alter the dial plan for your setup
    1. I have the dialplan set to : (xxxx|xxxxxxxxxx|1xxxxxxxxxx|91xxxxxxxxxx|9xxxxxxxxxx) : "{digits}" <sip:{digits}@YourAsteriskAddress>
    2. this allows for dialing 4 digit extentions, 10 digit numbers, 1 and then 10 digit numbers, 91 then 10 digit numbers, or 9 then 10 digit numbers
    3. alter as you need for your orginization
    4. See page 88 of the xpressavolume1.pdf from pingtel's site for more detailed instructions

Upload the files :

  1. navigate to Administration->File Uploads
  2. Upload pinger-config
  3. Upload user-config
  4. Restart the phone
    1. You can restart either by clicking the restart button on the Administration->File Upload page, or simply unplug/replug the phone

Enter Credentials

  1. navigate to Prefrences->Lines
  2. Edit the Device Line
  3. Remove any existing credentials
  4. Click "Add Credentials"
    1. Realm is asterisk
    2. User ID is the user id for the extension as configured in Asterisk
    3. Password is the password for the extension as configured in Asterisk
  5. reboot the phone - your done!

Note: everything configured by uploading user-config and pinger-config may be configured via the web interface

I found it easier to mess with the text files, but you can enter the same settings in the web forms.
--

Pingtel Expressa Admin Account Login Session Timeout Vulnerability
http://online.securityfocus.com/bid/5221


Pingtel Hardphones


Image Image Image

This page is hopefully the start of an aggregation of the so far very little information out there about using the Pingtel hardphone with Asterisk. There are still a handful of these hardphones out there, despite the manufacturer halting production of them and selling-off that line of business. Who they sold the hardphone business line to has been kept private from us.

The phones look quite nice, seem full-featured, seem to still have some support from their website (ie: a couple of rev's firmware & some PDF's) but not too much more.

The phone runs Java. The programmer's manual describing how to write Java apps to run on the phone can be found here (for as long as this non-Pingtel site cares to host the document.)

The web GUI supports only HTTP, not HTTPS.

If you have successfully used this phone with Asterisk, kindly improve the community and this page by posting a working configuration, screen shots, et cetera, et cetera, here. One thing that might be perfect is the publishing of the plain text configuration that the phone's webGUI summarizes/shows.

--
If I can do anything else for you, please contact me.

Peace. Love. Linux.



Pingtel Xpressa manuals


Beneath is a collection of manuals available for the Pingtel Xpressa phones. Depending on the software version you use you can download it directly by clicking the link description.

Quickstart Manual

Download here the Quickstart manual

User Manuals Version 1.0

Installing & Configuring Pingtel phones
Using Pingtel phones

User Manuals Version 1.2

Installing & Configuring Pingtel phones
Using Pingtel phones

User Manuals Version 2.1

Installing & Configuring Pingtel phones
Using Pingtel phones

User Manual Version 2.2

Using Pingtel Phones with SIPxchange

Programmers Manual Version 1.0

Programmersguide 1.0

Programmers Manual Version 1.2

Programmersguide 1.2

Guidelines for User Interface Design

xDK Guidelines for User Interface Design 1.2
xDK Guidelines for User Interface Design 2.0

--
Pingtel Appz are coming soon...
Cheers!


Hey - Great Page! - I have successfully used this phone with Asterisk!

I just got 5 of these phones on Ebay. Getting the config correct the first time was a little difficult. However, once you know how to do it, its simple!


  • First, make sure you are using the latest software :
    • connect to the phone with a browser
    • default user name is "admin" no password
    • go to Administration->Upgrade log
    • you should see version 2.1.11.24
  • If its not the latest version, you can still get the upgrade from Pingtel's site
    • see : https://secure.pingtel.com/dashboard/xpressaAnnouncement.jsp
    • follow the instructions in https://secure.pingtel.com/products/xpressa/downloads/2.1.11/xpressa-2_1_11.zip to upgrade
    • BTW - nice pdf manuals on this site
  • Then, simply upload config-pingtel and config-users files
    • edit the files as provided and described below
    • connect a browser to the phone
    • navigate to Administration->File Uploads
  • Make sure you provision the extension for the phone in your Asterisk setup
    • make sure NAT is set to "never"
      • otherwise registration will fail when Asterisk doesn't send SIP replies to port 5060
    • I use FreePBX - just add the extension and make sure NAT is set to "never"

Here's the configuration files :


pinger-config


PHONESET_ADMIN_DOMAIN :
PHONESET_DEPLOYMENT_SERVER :
PHONESET_DIALPLAN_LENGTH : 4
PHONESET_EXTERNAL_IP_ADDRESS :
PHONESET_LINE.ALLOW_FORWARDING : ENABLE
PHONESET_LINE.CREDENTIAL.1.PASSTOKEN :
PHONESET_LINE.CREDENTIAL.1.REALM : asterisk
PHONESET_LINE.CREDENTIAL.1.USERID : YourExtension
PHONESET_LINE.REGISTRATION : REGISTER
PHONESET_LINE.URL : "Production"<sip:YourExtension@YourAsteriskAddress>
PHONESET_LOGICAL_ID :
PHONESET_RTP_PORT_START :
SIP_DIRECTORY_SERVERS : sip:YourAsteriskAddress
SIP_PROXY_SERVERS : sip:YourAsteriskAddress
SIP_REGISTER_PERIOD : 3600
SIP_SESSION_REINVITE_TIMER :
SIP_TCP_PORT : 5060
SIP_UDP_PORT : 5060


user-config


PHONESET_AVAILABLE_BEHAVIOR : RING
PHONESET_BUSY_BEHAVIOR : BUSY
PHONESET_CALL_WAITING_BEHAVIOR : ALERT
PHONESET_DIGITMAP.(xxxx|xxxxxxxxxx|1xxxxxxxxxx|91xxxxxxxxxx|9xxxxxxxxxx) : "{digits}" <sip:{digits}@YourAsteriskAddress>
PHONESET_DND_METHOD : FORWARD_ON_BUSY
PHONESET_HTTP_PORT : 80
PHONESET_HTTP_PROXY_HOST :
PHONESET_HTTP_PROXY_PORT :
PHONESET_LOGO_URL :
PHONESET_MSG_WAITING_SUBSCRIBE :
PHONESET_RINGER : BOTH
PHONESET_SNMP_TRAP_DESTS :
PHONESET_TELNET_ACCESS : DISABLE
PHONESET_TIME_DST_RULE :
PHONESET_TIME_OFFSET :
PHONESET_TIME_SERVER :
PHONESET_VOICEMAIL_RETRIEVE :
SIP_AUTHENTICATE_SCHEME : NONE
SIP_FORWARD_ON_BUSY :
SIP_FORWARD_ON_NO_ANSWER :
SIP_FORWARD_UNCONDITIONAL :
USER_DEFAULT_OUTBOUND_LINE : PHONESET_LINE


Before uploading the files :

  1. You will need to replace "YourAsteriskAddress" with your asterisk IP or hostname in the above files
  2. You will need to replace "YourExtension" with the extension of the phone as configured in Asterisk
  3. You will want to alter the dial plan for your setup
    1. I have the dialplan set to : (xxxx|xxxxxxxxxx|1xxxxxxxxxx|91xxxxxxxxxx|9xxxxxxxxxx) : "{digits}" <sip:{digits}@YourAsteriskAddress>
    2. this allows for dialing 4 digit extentions, 10 digit numbers, 1 and then 10 digit numbers, 91 then 10 digit numbers, or 9 then 10 digit numbers
    3. alter as you need for your orginization
    4. See page 88 of the xpressavolume1.pdf from pingtel's site for more detailed instructions

Upload the files :

  1. navigate to Administration->File Uploads
  2. Upload pinger-config
  3. Upload user-config
  4. Restart the phone
    1. You can restart either by clicking the restart button on the Administration->File Upload page, or simply unplug/replug the phone

Enter Credentials

  1. navigate to Prefrences->Lines
  2. Edit the Device Line
  3. Remove any existing credentials
  4. Click "Add Credentials"
    1. Realm is asterisk
    2. User ID is the user id for the extension as configured in Asterisk
    3. Password is the password for the extension as configured in Asterisk
  5. reboot the phone - your done!

Note: everything configured by uploading user-config and pinger-config may be configured via the web interface

I found it easier to mess with the text files, but you can enter the same settings in the web forms.
--

Pingtel Expressa Admin Account Login Session Timeout Vulnerability
http://online.securityfocus.com/bid/5221


Created by: sjobeck, Last modification: Thu 15 of Feb, 2007 (20:47 UTC) by ISDN_world
Please update this page with new information, just login and click on the "Edit" or "Discussion" tab. Get a free login here: Register Thanks! - Find us on Google+