author | hgs |
Tue, 13 Jul 2010 09:51:41 +0530 | |
changeset 51 | 2e64dc50f295 |
parent 0 | b497e44ab2fc |
child 62 | 19bba8228ff0 |
permissions | -rw-r--r-- |
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
1 |
/* |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
2 |
* Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies). |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
3 |
* All rights reserved. |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
4 |
* This component and the accompanying materials are made available |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
5 |
* under the terms of "Eclipse Public License v1.0" |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
6 |
* which accompanies this distribution, and is available |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html". |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
8 |
* |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
9 |
* Initial Contributors: |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
10 |
* Nokia Corporation - initial contribution. |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
11 |
* |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
12 |
* Contributors: |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
13 |
* |
51 | 14 |
* Description: Fotaengine api |
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
15 |
* |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
16 |
*/ |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
17 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
18 |
#ifndef __FOTAENGINE_H__ |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
19 |
#define __FOTAENGINE_H__ |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
20 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
21 |
// INCLUDES |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
22 |
#include <e32std.h> |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
23 |
#include <e32def.h> |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
24 |
#include <SyncMLDef.h> |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
25 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
26 |
#include "fotaConst.h" |
51 | 27 |
#include <s32strm.h> |
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
28 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
29 |
// CONSTANTS |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
30 |
/** FOTA Server commands */ |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
31 |
enum TFotaIPCCmds |
51 | 32 |
{ |
33 |
EFotaDownload, // The download command |
|
34 |
EFotaDownloadAndUpdate, // The download and update command |
|
35 |
EFotaUpdate, // The update command |
|
36 |
EPauseDownload, // The download pause command |
|
37 |
EFotaTryResumeDownload, // The download resume command |
|
38 |
EGetState, // The get state command |
|
39 |
EGetResult, // The get result command |
|
40 |
EDeletePackage, // The package delete command |
|
41 |
EGetUpdateTimestamp, // The get command for updated timestamp |
|
42 |
EGetUpdatePackageIds, // The get command for all package ids |
|
43 |
EGenericAlertSentForPackage, // The generic alert sent notification command |
|
44 |
EScheduledUpdate, // The schedule update command |
|
45 |
EGetCurrFwDetails // The get command for reading current firmware package details |
|
46 |
}; |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
47 |
|
51 | 48 |
/** Fota start up action states */ |
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
49 |
enum TFotaUpdateStates |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
50 |
{ |
51 | 51 |
EFotaDefault, // No action |
52 |
EFotaPendingGenAlert, // Send pending generic alert |
|
53 |
EFotaDownloadInterrupted, // Try to resume download |
|
54 |
EFotaUpdateInterrupted // Try to resume update |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
55 |
}; |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
56 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
57 |
class TFotaScheduledUpdate; |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
58 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
59 |
// CLASS DECLARATION |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
60 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
61 |
/** |
51 | 62 |
* A client handle to a FOTA engine session. |
63 |
* @lib fotaengine.lib |
|
64 |
* @since SF4 |
|
65 |
*/ |
|
66 |
//class RFotaEngineSession : public RAknAppServiceBase // 10.1 changes |
|
67 |
class RFotaEngineSession : public RSessionBase |
|
68 |
{ |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
69 |
|
51 | 70 |
public: |
71 |
// enums |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
72 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
73 |
/** |
51 | 74 |
* An enumeration of the firmware update progress state codes as specified |
75 |
* in FUMO spec. |
|
76 |
*/ |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
77 |
enum TState |
51 | 78 |
{ |
79 |
/** No firmware update has been started */ |
|
80 |
EIdle = 10, |
|
81 |
/** Client has sent a client initiated request */ |
|
82 |
EClientRequest = 5, |
|
83 |
/** There is no data available and download is about to start */ |
|
84 |
EStartingDownload = 15, |
|
85 |
/** Download failed and there is no data received */ |
|
86 |
EDownloadFailed = 20, |
|
87 |
/** Download is progressing without resume support. */ |
|
88 |
EDownloadProgressing = 30, |
|
89 |
/** Have data and download has been completed successfully */ |
|
90 |
EDownloadComplete = 40, |
|
91 |
/** Have data and about to start update */ |
|
92 |
EStartingUpdate = 50, |
|
93 |
/** Denotes that the update is currently running, but has not yet |
|
94 |
completed */ |
|
95 |
EUpdateProgressing = 60, |
|
96 |
/** Have data but update failed */ |
|
97 |
EUpdateFailed = 70, |
|
98 |
/** Update failed and data deleted or removed */ |
|
99 |
EUpdateFailedNoData = 80, |
|
100 |
/** Update complete and data still available */ |
|
101 |
EUpdateSuccessful = 90, |
|
102 |
/** Data deleted or removed after a successful update */ |
|
103 |
EUpdateSuccessfulNoData = 100, |
|
104 |
}; |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
105 |
|
51 | 106 |
/** |
107 |
* An enumeration of the firmware update result codes as specified |
|
108 |
* in the OMA Firmware Update Management Oobject specification. |
|
109 |
*/ |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
110 |
enum TResult |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
111 |
{ |
51 | 112 |
/** Requested operation is successful */ |
113 |
EResSuccessful = 200, |
|
114 |
/** Requested operation is cancelled by user */ |
|
115 |
EResUserCancelled = 401, |
|
116 |
/** Firmware update is corrupt */ |
|
117 |
EResCorruptedFWUPD = 402, |
|
118 |
/** Firmware update mismatches with the device */ |
|
119 |
EResPackageMismatch = 403, |
|
120 |
/** Not used */ |
|
121 |
EResFailedSignatureAuthentication = 404, |
|
122 |
/** Undefined error occured during the operation */ |
|
123 |
EResUndefinedError = 409, |
|
124 |
/** Update has failed */ |
|
125 |
EResUpdateFailed = 410, |
|
126 |
/** Download failed due to malformed or bad url */ |
|
127 |
EResMalformedOrBadURL = 411, |
|
128 |
/** The OMA DL server is unavailable */ |
|
129 |
EResAlternateDLServerUnavailable = 412, |
|
130 |
/** Download paused due to out of memory */ |
|
131 |
EResDLFailDueToDeviceOOM = 501, |
|
132 |
/** Download paused due to network error */ |
|
133 |
EResDLFailDueToNWIssues = 503, |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
134 |
|
51 | 135 |
//Vendor specific errors |
136 |
/** Download failed due to content type mismatch */ |
|
137 |
EResContentMisMatch = 600, |
|
138 |
/** Download failed due to invalid OMA DL1.0 descriptor */ |
|
139 |
EResInvalidDownloadDescriptor = 601, |
|
140 |
/** Update suspended due to low battery */ |
|
141 |
EResLowBattery = 602 |
|
142 |
}; |
|
143 |
||
144 |
public: |
|
145 |
// Constructors |
|
146 |
||
147 |
IMPORT_C RFotaEngineSession(); |
|
148 |
||
149 |
public: |
|
150 |
// new functions |
|
151 |
/** |
|
152 |
* Opens session to Fota Engine |
|
153 |
* |
|
154 |
* @since SF4 |
|
155 |
* @param None |
|
156 |
* @return None |
|
157 |
*/ |
|
158 |
IMPORT_C void OpenL(); |
|
159 |
||
160 |
/** |
|
161 |
* Closes session to Fota Engine |
|
162 |
* |
|
163 |
* @since SF4 |
|
164 |
* @param None |
|
165 |
* @return None |
|
166 |
*/ |
|
167 |
IMPORT_C void Close(); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
168 |
|
51 | 169 |
/** |
170 |
* Called when DM server calls execute command to |
|
171 |
* Firmware update object URI ./FUMO/<x>/Download |
|
172 |
* Initiates a firmware download for the specified update package. |
|
173 |
* |
|
174 |
* @since SF4 |
|
175 |
* @param aPkgId Unique identifier of the update package. |
|
176 |
* Mapped to Mgmt URI ./FUMO/<x> in DM Framework |
|
177 |
* @param aPkgURL Contains the URL where the firmware update package |
|
178 |
* or download |
|
179 |
* descriptor is located. This URL is used for |
|
180 |
* alternative download |
|
181 |
* mechanism such as Descriptor Based Download. |
|
182 |
* Mgmt URI ./FUMO/<x>/Download/PkgURL |
|
183 |
* @param aProfileId ProfileId of the DM server that send the execute |
|
184 |
* command |
|
185 |
* @param aPkgName Name associated with the firmware update package, |
|
186 |
* may be empty |
|
187 |
* Mgmt URI ./FUMO/<x>/PkgName |
|
188 |
* @param aPkgVersion Version information for the firmware update |
|
189 |
* package, |
|
190 |
* may be empty. |
|
191 |
* Mgmt URI./FUMO/<x>/PkgVersion |
|
192 |
* @param aSilent Decides whether the download has to be silent or not |
|
193 |
* @return Immediate result of the command |
|
194 |
* KErrNotFound: url doesn't exist |
|
195 |
*/ |
|
196 |
IMPORT_C TInt Download(const TInt aPkgId, const TDesC8& aPkgURL, |
|
197 |
const TSmlProfileId aProfileId, const TDesC8& aPkgName, |
|
198 |
const TDesC8& aPkgVersion, TBool aSilentDownload = EFalse); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
199 |
|
51 | 200 |
/** |
201 |
* Called when DM server calls execute command to |
|
202 |
* Firmware update object URI ./FUMO/<x>/DownloadAndUpdate |
|
203 |
* Initiates a firmware download and an immediate update for the specified |
|
204 |
* update package. |
|
205 |
* |
|
206 |
* @since SF4 |
|
207 |
* @param aPkgId Unique identifier of the update package. |
|
208 |
* Mapped to Mgmt URI ./FUMO/<x> in DM Framework |
|
209 |
* @param aPkgURL Contains the URL where the firmware update package or |
|
210 |
* download descriptor is located. This URL is used for |
|
211 |
* alternative download mechanism such as Descriptor |
|
212 |
* Based Download. |
|
213 |
* Mgmt URI ./FUMO/<x>/DownloadAndUpdate/PkgURL |
|
214 |
* @param aProfileId ProfileId of the DM server that send the execute |
|
215 |
* command |
|
216 |
* @param aPkgName Name associated with the firmware update package, |
|
217 |
* may be empty. |
|
218 |
* Mgmt URI ./FUMO/<x>/PkgName |
|
219 |
* @param aPkgVersion Version information for the firmware update |
|
220 |
* package, may be empty. |
|
221 |
* Mgmt URI./FUMO/<x>/PkgVersion |
|
222 |
* @param aSilent Decides whether the download has to be silent or not |
|
223 |
* @return Immediate result of the command |
|
224 |
*/ |
|
225 |
IMPORT_C TInt DownloadAndUpdate(const TInt aPkgId, const TDesC8& aPkgURL, |
|
226 |
const TSmlProfileId aProfileId, const TDesC8& aPkgName, |
|
227 |
const TDesC8& aPkgVersion, TBool aSilentDownload = EFalse); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
228 |
|
51 | 229 |
/** |
230 |
* Called when DM server calls execute command to |
|
231 |
* Firmware update object URI ./FUMO/<x>/Update |
|
232 |
* Initiates a firmware update for the specified update package. |
|
233 |
* Firmware Update Package should be already downloaded to the device |
|
234 |
* either using DM Large Object or OMA OTA download mechanisms. |
|
235 |
* |
|
236 |
* @since SF4 |
|
237 |
* @param aPkgId Unique identifier of the update package. |
|
238 |
* @param aProfileId ProfileId of the DM server that send the execute |
|
239 |
* command |
|
240 |
* @param aPkgName Name associated with the firmware update package, may |
|
241 |
* be empty. |
|
242 |
* Mgmt URI ./FUMO/<x>/PkgName |
|
243 |
* @param aPkgVersion Version information for the firmware update |
|
244 |
* package, may be empty. |
|
245 |
* Mgmt URI./FUMO/<x>/PkgVersion |
|
246 |
* @return Immediate result of the command |
|
247 |
*/ |
|
248 |
IMPORT_C TInt Update(const TInt aPkgId, const TSmlProfileId aProfileId, |
|
249 |
const TDesC8& aPkgName, const TDesC8& aPkgVersion); |
|
250 |
||
251 |
/** |
|
252 |
* Requests to pause the ongoing download. |
|
253 |
* |
|
254 |
* @since Symbian 4 |
|
255 |
* @param None |
|
256 |
* @return KErrNone if pause is successful, or any system-wide error. |
|
257 |
*/ |
|
258 |
IMPORT_C TInt PauseDownload(); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
259 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
260 |
/** |
51 | 261 |
* Requests to resume the suspended download of the update package. |
262 |
* Called by Fota Monitory Service. for ex, when network is available again. |
|
263 |
* @since 3.2.2 |
|
264 |
* @param aSilent Decides whether the download has to be silent or not |
|
265 |
* |
|
266 |
* @return KErrNone when successful, else System wide errors |
|
267 |
* |
|
268 |
*/ |
|
269 |
||
270 |
IMPORT_C TInt TryResumeDownload(TBool aSilentDownload = EFalse); |
|
271 |
||
272 |
/** |
|
273 |
* Called when caller wants to enquire State of specified |
|
274 |
* firmware update. If the State is unknown to FOTA Engine, then it should |
|
275 |
* return EIdle. |
|
276 |
* |
|
277 |
* @since SF4 |
|
278 |
* @param aPkgId Unique identifier of the update package. |
|
279 |
* @return State reached by specified firmware update package |
|
280 |
*/ |
|
281 |
IMPORT_C TState GetState(const TInt aPkgId); |
|
282 |
||
283 |
/** |
|
284 |
* Called when caller wants to enquire Final Result Code of specified |
|
285 |
* firmware update operation. If the update operation is not yet reached |
|
286 |
* final stage, then -1 should be returned to the caller. Possible Final |
|
287 |
* Result Codes are specified in OMA FUMO Specification. Note that Download |
|
288 |
* operation also ends to final result code e.g. 202 - Successful Download. |
|
289 |
* |
|
290 |
* @since SF4 |
|
291 |
* @param aPkgId Unique identifier of the update package. |
|
292 |
* @return Result code as specified in FUMO specification, -1 if |
|
293 |
* not yet reached final result. |
|
294 |
*/ |
|
295 |
IMPORT_C TInt GetResult(const TInt aPkgId); |
|
296 |
||
297 |
/** |
|
298 |
* Called when DM server deletes firmware update management object |
|
299 |
* from device's management tree. I.e. Delete to mgmt URI ./FUMO/<x>. |
|
300 |
* If FOTA Engine has not yet deleted specified update package, then it |
|
301 |
* should do so. |
|
302 |
* |
|
303 |
* @since SF4 |
|
304 |
* @param aPkgId Unique identifier of the update package. |
|
305 |
* @return Result code |
|
306 |
*/ |
|
307 |
IMPORT_C TInt DeleteUpdatePackage(const TInt aPkgId); |
|
308 |
||
309 |
/** |
|
310 |
* Retrieves the timestamp of last succesful update. |
|
311 |
* |
|
312 |
* @since SF4 |
|
313 |
* @param aUpdate On return, contains time of last succesfull update |
|
314 |
* @return Error code. KErrUnknown if device has never been |
|
315 |
* updated. |
|
316 |
*/ |
|
317 |
IMPORT_C TInt LastUpdate(TTime& aUpdate); |
|
318 |
||
319 |
/** |
|
320 |
* Tells device FW version |
|
321 |
* |
|
322 |
* @since SF4 |
|
323 |
* @param aSWVersion On return, contains FW version of device. |
|
324 |
* @return Error code |
|
325 |
*/ |
|
326 |
IMPORT_C TInt CurrentVersion(TDes& aSWVersion); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
327 |
|
51 | 328 |
/** |
329 |
* Gets IDs of the present update packages. |
|
330 |
* |
|
331 |
* @since SF4 |
|
332 |
* @param aPackageIdList On return, contains array of pkg ids |
|
333 |
* @return Error code |
|
334 |
*/ |
|
335 |
IMPORT_C TInt GetUpdatePackageIds(TDes16& aPackageIdList); |
|
336 |
||
337 |
/** |
|
338 |
* Version of the fota server |
|
339 |
* |
|
340 |
* @since SF4 |
|
341 |
* @return version |
|
342 |
*/ |
|
343 |
IMPORT_C TVersion Version() const; |
|
344 |
||
345 |
/** |
|
346 |
* Tells fotaserver that generic alert for package is sent. |
|
347 |
* When fotaengine session is closed, cleanup for package |
|
348 |
* is done. |
|
349 |
* |
|
350 |
* @since SF4 |
|
351 |
* @param aPackageId |
|
352 |
* @return Error code |
|
353 |
*/ |
|
354 |
IMPORT_C void GenericAlertSentL(const TInt aPackageID); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
355 |
|
51 | 356 |
/** |
357 |
* Like Update, but called by scheduler mechanism. |
|
358 |
* Needed package details (profile id etc are already known) |
|
359 |
* |
|
360 |
* @since 3.2 |
|
361 |
* @param aSchedule Schedule data |
|
362 |
* @return Error code |
|
363 |
*/ |
|
364 |
IMPORT_C TInt ScheduledUpdateL(TFotaScheduledUpdate aSchedule); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
365 |
|
51 | 366 |
/** |
367 |
* Gets the details for current/last firmware update. |
|
368 |
* |
|
369 |
* @since SF4 |
|
370 |
* @param aName - name of the firmware |
|
371 |
* @param aVersion - version of the firmware |
|
372 |
* @param aSize - size of the firmware in bytes |
|
373 |
* @return, on return all the params would be filled. Can leave with system wide error. |
|
374 |
*/ |
|
375 |
IMPORT_C void GetCurrentFirmwareDetailsL(TDes8& aName, TDes8& aVersion, |
|
376 |
TInt& aSize); |
|
377 |
||
378 |
IMPORT_C TBool IsPackageStoreSizeAvailable(const TInt aSize); |
|
379 |
||
380 |
||
381 |
IMPORT_C TInt OpenUpdatePackageStore(const TInt aPkgId |
|
382 |
,RWriteStream*& aPkgStore); |
|
383 |
||
384 |
IMPORT_C TInt GetDownloadUpdatePackageSize(const TInt aPkgId, TInt& aDownloadedSize, TInt& aTotalSize); |
|
385 |
||
386 |
IMPORT_C void UpdatePackageDownloadComplete( |
|
387 |
const TInt aPkgId); |
|
388 |
||
389 |
private: |
|
390 |
||
391 |
/** Returns the UID of the service that this session provides an |
|
392 |
* interface for. Client side service implementations must implement this |
|
393 |
* function to return the UID for the service that they implement. |
|
394 |
* |
|
395 |
* @since SF4 |
|
396 |
* @param None |
|
397 |
* @return The UID of the service implemented by the derived class. |
|
398 |
*/ |
|
399 |
TUid ServiceUid() const; |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
400 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
401 |
|
51 | 402 |
private: |
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
403 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
404 |
/** |
51 | 405 |
* Starts fotaserver server application. |
406 |
* |
|
407 |
* @since SF4 |
|
408 |
* @param aNameUid Differentiator. |
|
409 |
* @param aAppServerUid FotaServer app uid |
|
410 |
* @return None |
|
411 |
**/ |
|
412 |
void StartApplicationL(const TUid& aNameUid, const TUid& aAppServerUid); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
413 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
414 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
415 |
/** |
51 | 416 |
* Connects to the server |
417 |
* |
|
418 |
* @since SF4 |
|
419 |
* @return KErrNone if successful, otherwise system wide errors |
|
420 |
**/ |
|
421 |
||
422 |
TBool connectToHbServer(); |
|
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
423 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
424 |
private: // Data |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
425 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
426 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
427 |
/** |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
428 |
* If not -1 , indicates that generic alert has been sent for this package |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
429 |
*/ |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
430 |
TInt iGenericAlertSentPkgID; |
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
431 |
|
51 | 432 |
}; |
0
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
433 |
|
b497e44ab2fc
Revision: 200949
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
434 |
#endif // __FOTAENGINE_H__ |