Linksys SPA921 Cisco Small Business IP Telephony Devices Provisioning Guide - Page 59

Data Types

Page 59 highlights

Creating Provisioning Scripts Data Types 2 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. Data Types The data types used with configuration profile parameters are as follows: • Uns-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-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-A generic string with up to n non-reserved characters. • Float-A floating point value with up to n decimal places. Cisco Small Business IP Telephony Devices Provisioning Guide 57

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116

Creating Provisioning Scripts
Data Types
Cisco Small Business IP Telephony Devices Provisioning Guide
57
2
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,
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
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.
Data Types
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.