fotaapplication/fotaserver/inc/fotaUpdateAgentComms.h
branchRCL_3
changeset 25 b183ec05bd8c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/fotaapplication/fotaserver/inc/fotaUpdateAgentComms.h	Tue Aug 31 16:04:06 2010 +0300
@@ -0,0 +1,86 @@
+/*
+ * Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies). 
+ * All rights reserved.
+ * This component and the accompanying materials are made available
+ * under the terms of "Eclipse Public License v1.0"
+ * which accompanies this distribution, and is available
+ * at the URL "http://www.eclipse.org/legal/epl-v10.html".
+ *
+ * Initial Contributors:
+ * Nokia Corporation - initial contribution.
+ *
+ * Contributors:
+ *
+ * Description:   Update agent result codes
+ *
+ */
+
+#ifndef __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__
+#define __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__
+
+typedef enum
+    {
+
+    /*
+     Everything is ok - update package were installed successfully and 
+     newer version of OS is running.
+     */
+    UPD_OK = 0,
+    /*
+     Problem: The request sent to update installer were invalid - probable issue in
+     Download agent.
+     
+     Solutions:
+     - Probable: Download agent created an invalid file.
+     Fix download agent.
+     - Inprobable: Corrupted request file, or FAT
+     */
+    UPD_INSTALL_REQUEST_IS_INVALID = 1,
+    /*
+     Problem: Update package is absent from specified location.
+
+     Solution: Incorrect user application actions. 
+     Read update application document / manual on how to switch to 
+     update mode.
+     */
+    UPD_UPDATE_PACKAGE_IS_ABSENT = 2,
+    /*
+     Problem: Update package is corrupted. (Integrity or authenticity 
+     check failed)
+     Solution: End-user should try to download again update package.
+     */
+    UPD_UPDATE_PACKAGE_IS_CORRUPTED = 3,
+    /*
+     Problem: Update package contents is invalid for some reason.
+     This problem normally refers to the fact that update package
+     were created incorrectly.
+     
+     Solution: Contact update package build team in order to find out the 
+     error cause.
+     */
+    UPD_UPDATE_PACKAGE_CONTENTS_IS_INVALID = 4,
+    /*
+     Problem: Update package is not compatible with current mobile device.
+     Solution: End-user should try to download again update package.
+     */
+
+    UPD_UPDATE_PACKAGE_IS_NOT_COMPATIBLE_WITH_CURRENT_MOBILE_DEVICE = 5,
+    /*
+     Problem: This error code will be used to indicate fatal error 
+     code after which phone becomes dead.
+     
+     Solution: Phone should be taken to maintenance.
+     This error code cannot be seen by normal mode applications 
+     because OS cannot be started when phone became dead.
+     */
+    UPD_FATAL_ERROR = 0xFFFFFFFF
+    } InstallationResult;
+
+typedef enum
+    {
+    UPD_InvalidBlockHeaderIdentifier = 1,
+    UPD_InvalidUpdatePackageVersion = 2,
+    UPD_GenericInvalidFileFormat = 3
+    } DetailedInstallationResult;
+
+#endif //__COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__