Motorola MC3090G Integration Guide - Page 116

XML Provisioning, Creating an XML Provisioning File

Get Motorola MC3090G - Win CE 5.0 Core PDF manuals and user guides View all Motorola MC3090G manuals
Add to My Manuals
Save this manual to your list of manuals

Page 116 highlights

5 - 6 MC3000 Integrator Guide To load the splash screen on the MC3000: 1. Create a text file named pkgs.lst which contains the name of the bmp file. For example, mysplash.bmp. 2. Copy the bmp file and the pkgs.lst file to one of the following: • MC3000's \temp directory • MC3000's \Windows directory. 3. Perform a cold boot. 4. Press the trigger or side scan button for 5 seconds while booting to invoke the Update Loader and install the splash screen. XML Provisioning To configure the settings on an MC3000, use XML provisioning. To install an XML provisioning file on the MC3000, create a Cabinet Provisioning File (CPF). A CPF file is similar to a CAB file and contains just one file: _setup.xml. Like a CAB file, the CPF extension is associated with WCELoad.EXE. Opening a CPF extracts the XML code and uses it to provision and configure the MC3000. The user receives an e-mail notification indicating success or failure. XML provisioning provides the ability to configure various features of the MC3000 (i.e., registry and file system). However, some settings require security privileges. To change registry settings via a CPF file, you must have certain privileges (roles). Some registry keys require you to simply be an Authenticated User, while other registry keys require you to be a Manager. Refer to the Microsoft Windows Mobile 6 Help file, Metabase Settings for Registry Configuration Service Provider section, for the default role settings in Windows Mobile 6.1. For those registry settings that require the Manager role, the CPF file must be signed with a privileged certificate installed on the device. Refer to the Microsoft Windows Mobile 6 Help file and the Windows Mobile 6 SDK for instructions and sample test certificates. Creating an XML Provisioning File To create a .cpf file: 1. Create a valid provisioning XML file named _setup.xml using an XML editor or the tools supplied with Visual Studio 2005. (For example, use the SampleReg.xml sample created in the RegMerge section and rename it _setup.xml.) Ensure the file contains the required parameters for the operation. Refer to the Microsoft Windows Mobile 6 Help file for information. 2. In the Windows Mobile 6.1 tools directory on the desktop computer (typically \Program Files\Windows CE Tools\wce500\Windows Mobile 6 Pocket PC SDK\Tools), run the Makecab.exe utility, using the following syntax to create a .cpf file from the _setup.xml file: MakeCab.exe /D COMPRESS=OFF _setup.xml myOutCpf NOTE COMPRESS=OFF is required for backward compatibility with Pocket PC. 3. Optionally, use the Authenticode tools to sign the .cpf file. 4. Tap the filename to install. 5. Certain applications and settings require a cold boot to take affect. In these cases, cold boot the MC3000. Refer to the Windows Mobile Version 6 Help file for more information.

  • 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
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
5 - 6
MC3000 Integrator Guide
To load the splash screen on the MC3000:
1.
Create a text file named pkgs.lst which contains the name of the bmp file. For example,
mysplash.bmp
.
2.
Copy the bmp file and the pkgs.lst file to one of the following:
•
MC3000’s \temp directory
•
MC3000’s \Windows directory.
3.
Perform a cold boot.
4.
Press the trigger or side scan button for 5 seconds while booting to invoke the Update Loader and install the
splash screen.
XML Provisioning
To configure the settings on an MC3000, use XML provisioning. To install an XML provisioning file on the MC3000,
create a Cabinet Provisioning File (CPF). A CPF file is similar to a CAB file and contains just one file: _setup.xml.
Like a CAB file, the CPF extension is associated with WCELoad.EXE. Opening a CPF extracts the XML code and
uses it to provision and configure the MC3000. The user receives an e-mail notification indicating success or
failure.
XML provisioning provides the ability to configure various features of the MC3000 (i.e., registry and file system).
However, some settings require security privileges. To change registry settings via a CPF file, you must have
certain privileges (roles). Some registry keys require you to simply be an
Authenticated User
, while other registry
keys require you to be a
Manager
. Refer to the
Microsoft Windows Mobile 6 Help
file,
Metabase Settings for
Registry Configuration Service Provider
section, for the default role settings in Windows Mobile 6.1.
For those registry settings that require the
Manager
role, the CPF file must be signed with a privileged certificate
installed on the device. Refer to the
Microsoft Windows Mobile 6 Help
file and the
Windows Mobile 6 SDK
for
instructions and sample test certificates.
Creating an XML Provisioning File
To create a .cpf file:
1.
Create a valid provisioning XML file named _setup.xml using an XML editor or the tools supplied with Visual
Studio 2005. (For example, use the SampleReg.xml sample created in the
RegMerge
section and rename it
_setup.xml.) Ensure the file contains the required parameters for the operation. Refer to the
Microsoft Windows
Mobile 6 Help
file for information.
2.
In the Windows Mobile 6.1 tools directory on the desktop computer (typically \Program Files\Windows CE
Tools\wce500\Windows Mobile 6 Pocket PC SDK\Tools), run the Makecab.exe utility, using the following
syntax to create a .cpf file from the _setup.xml file:
MakeCab.exe /D COMPRESS=OFF _setup.xml myOutCpf
3.
Optionally, use the Authenticode tools to sign the .cpf file.
4.
Tap the filename to install.
5.
Certain applications and settings require a cold boot to take affect. In these cases, cold boot the MC3000.
Refer to the
Windows Mobile Version 6 Help
file for more information.
NOTE
C
OMPRESS=OFF is required for backward compatibility with Pocket PC.