Technical information

Chapter 2: AT+i Commands Reference
May 31, 2008 AT+i Commands Reference Manual 2-73
W24 Parameter Update
Introduction
The W24 remote parameter update file allows users to remotely modify various non-volatile
parameters in W24 products. The file is an ASCII-formatted text file, edited by the user or created
by a dedicated application. The file's size must not exceed 10k.
The remote parameter file (RPF) naming convention is <filename>.rpf. If a parameter is assigned
a legal value within the file, that value replaces the current value in W24's non-volatile parameter
database. A parameter value that is not referred to in the file, or that is not defined using the
correct syntax rules, specified below, does not affect the current parameter value.
Remote Parameter File (RPF) Structure
The RPFfile must include the letters "RP_" as its first 3 characters, and can include additional
header lines (defined below), as well as various parameter assignments. Assignments follow the
rules defined for parameter settings, but excluding the AT+i prefix. For example, to assign the
value myname to the POP3 mailbox name parameter, the correct assignment is MBX=myname
This is equivalent to the host sending AT+iMBX=myname to W24. Each line, terminated with
<CR>/<LF>, can contain one assignment only. The order of assignments is not important, except
for the RPF header parameters, which must be first and must follow the header definitions below.
After the first non-RPF header parameter, additional header parameters are ignored.
Comment lines can appear anywhere in the file. Comment line syntax is defined as:
#<anything>CR/LF
The first line in the file that is not a comment line is considered the authentication header line and
must have the following syntax:
RP_[GROUP=<string><space_character>][RP_DEST=<string>]CR/LF
The remainder of the header must contain lines with the following syntax:
<header_parameter_name>=<general_parameter_value>CR/LF
Header Parameter Names and Values
Table 2-5 shows the header parameter names and values.
Table 2-5: Header Parameter Names and Values
Name Value Default
RP_DEST Single string, no
space characters.
NONE
RP_GROUP NONE
RP_START_FROM_FACTORY_DEFAULTS YES/NO NO