Data Types - Cisco SPA921 - - IP Phone Provisioning Manual

Creating Provisioning Scripts

Data Types

Data Types
Cisco Small Business IP Telephony Devices Provisioning Guide
If the Upgrade_Rule contains a URL without a conditional expression, the device
upgrades to the firmware image specified by the URL. Subsequently, it does not
attempt to upgrade again until either the rule itself is modified or the effective
combination of scheme + server + port + filepath is changed, following macro
expansion and evaluation of the rule.
In order to attempt a firmware upgrade, the device disables audio at the start of
the procedure, and reboots at the end of the procedure. For this reason, an
upgrade driven by the contents of Upgrade_Rule is only automatically initiated by
the device if any voice line is currently inactive.
For example,
http://p.tel.com/firmware/spa021025.bin
In this example, the Upgrade_Rule upgrades the firmware to the image stored at
the indicated URL. The following is another example:
("$F" ne "beta-customer")? http://p.tel.com/firmware/spa021025.bin
| http://p.tel.com/firmware/spa-test-0527s.bin
This example directs the unit to load one of two images, based on the contents of
a general purpose parameter, GPP_F.
The device can enforce a downgrade limit with respect to firmware revision
number. This can be useful as a customization option. If a valid firmware revision
number is configured in the parameter Downgrade_Rev_Limit, the device rejects
upgrade attempts for firmware versions earlier than the specified limit.
The data types used with configuration profile parameters are as follows:
• Uns<n>—Unsigned n-bit value, where n = 8, 16, or 32. It can be specified in
decimal or hex format such as 12 or 0x18 as long as the value can fit into n
bits.
• Sig<n>—Signed n-bit value. It can be specified in decimal or hex format.
Negative values must be preceded by a "-" sign. A + sign before positive
value is optional.
• Str<n>—A generic string with up to n non-reserved characters.
• Float<n>—A floating point value with up to n decimal places.
2
57