Home | Manufacturers and Developers | Engineers | Forum

A free, simple, easy-to-implement, standards-based,
feature-rich dialtone for your SIP hardware or softphone...

Plug-n-Dial

Engineers Testing or Implementing Plug-N-Dial

Provisioning Method:
TFTP Protocol | HTTPS Protocol | HTTP Protocol | Live Examples |

The HTTP Provisioning Method is defined as follows:

Step 1: Retrieve Configuration File


At boot time the SIP device should initially attempt to download the encrypted configuration file from the Automatic Provisioning System. This is done by placing a HTTP request to the APS server which has a HTTP server running to accomodate this request.

Example: A HTTP get request should be formatted as follows:

http://<SERVER>/<Make/Model>/app?class=<Make/Model>;mac_address=xxxxxxxxxx

The format of the return file can be either in plaintext / XML / encrypted:

For example:

The SIP device updates via HTTP with a plaintext response then the field format will be as follows

sip_server="proxy01.sipphone.com"
sip_server_port="5060"
local_rtp_port="5004"
local_sip_port="5060"
codec3="G711u"

The SIP device updates via HTTP using XML then the field names would directly translate as follows:

<sip_server>
        proxy01.sipphone.com
</sip_server>
<sip_server_port>
        5060
</sip_server_port>

The SIP device updates via HTTP w/ encryption then the field names would directly translate as follows:

<xml>
 <flat-profile>
   <ENC>
      c7fc19404e0b0bcc8885d31f2d8ff7e8e09f0e28......
   </ENC>
 </flat-profile>
 <sessionData>
   <proc>provision</proc>
   <class>OEM</class>
 </sessionData>
</xml>


Step 2: Automatic Firmware Updates


The firmware updating process is accomplished by first grabbing a file "currentversion.txt" and determining from the contents of that file whether it is necessary to download the new firmware.


To begin the Firmware Updating process a HTTP / HTTP request should be formatted as follows:

http://<SERVER>/firmware/<OEM>/<Model/Make>/currentversion.txt

An Example of this would be: http://aps.sipphone.com/firmware/leadtek/LR8051S/currentversion.txt

Contents Example:

Image_file="some_file_format.bin"
Prom_file="some_other_format.blah"

The device should then determine from the currentversion.txt file whether a firmware update is required. If an update is not required then the device should then continue in the boot process, otherwise the device will download the file from our server.

To download the firmware the format of the request should be like the following:

http://<SERVER>/firmware/<OEM>/<Model/Make>/some_file_format.bin

An Example of this would be: http://aps.sipphone.com/firmware/leadtek/LR8051S/SIP_1.0_US_LDTK_AR15.rom

After the device has downloaded the firmware the device will update, reboot, and return to the beginning of the Auto Provisioning process.

Home | Manufacturers and Developers | Engineers | Forum