...

Add a new upload specification to any existing Spring bean file. For example
{{Box File| sipXconfig/neoconf/src/org/sipfoundry/sipxconfig/phone/phone.beans.xml|

  <bean id="polycomFirmware"
    class="org.sipfoundry.sipxconfig.upload.UploadSpecification">

    <!-- Use upload spring bean -->
    <constructor-arg value="upload"/>

    <!-- Directory to find upload.xml file -->
    <constructor-arg value="wayCool"/>

    <!-- Label -->
    <constructor-arg value="Way Cool Device"/>

  </bean>

...

Step 2:Describe upload files

Create following file
{{Box File| sipXconfig/neoconf/etc/wayCool/upload.xml|

<?xml version="1.0"?>
<!DOCTYPE model PUBLIC "-//SIPFoundry//sipXconfig//Model specification 2.0//EN" 
  "http://www.sipfoundry.org/sipXconfig/dtd/setting_2_0.dtd">
<model>
  <group name="firmware">
    <label>Firmware</label>
    <description>Firmware for Way Cool Device</description>
    <setting name="wayCoolFirmware.dat">
      <label>wayCoolFirmware.dat</label>
      <type><file><contentType>application/binary</contentType></file></type>
      <description>Firmware binary.</description>
    </setting>
  <group>
</model>

...

The group and setting names and labels are irrelevant, but pick meaningful values incase you need to process the settings.

...

• You can write your own code to deliver or process the uploaded files. Extend Upload.java, add an entry in Spring file similiar to Spring bean "upload". Change the first argument of the upload specification entry to your spring bean name.
• Declare firmware, ring tones, dial plans, directories, etc, in your upload.xml file. Break into logical groups for better presentation in web UI.
• To add support for multiple firmware versions, you can create a series of upload.xml files to organize and extend other versions, much like phone.xml and line.xml files. For example:
  {{Box File| sipXconfig/etc/wayCool |

  Panel
  upload.xml – all firmware files upload_3.x.xml – describe firmware files unique to version 3.x upload_4.x.xml – describe firmware files unique to version 4.x

  }}

and multiple upload specification entries in the spring file for 3.0 and 4.0

Future

• Phone and gateways will be able to select from a list of available upload entries. At minimum this will enable new setting for the device to show up based on that firmware version.