1 /*

     2  * Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies). 

     3  * All rights reserved.

     4  * This component and the accompanying materials are made available

     5  * under the terms of "Eclipse Public License v1.0"

     6  * which accompanies this distribution, and is available

     7  * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8  *

     9  * Initial Contributors:

    10  * Nokia Corporation - initial contribution.

    11  *

    12  * Contributors:

    13  *

    14  * Description:   Update agent result codes

    15  *

    16  */

    17 

    18 #ifndef __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__

    19 #define __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__

    20 

    21 typedef enum

    22     {

    23 

    24     /*

    25      Everything is ok - update package were installed successfully and 

    26      newer version of OS is running.

    27      */

    28     UPD_OK = 0,

    29     /*

    30      Problem: The request sent to update installer were invalid - probable issue in

    31      Download agent.

    32      

    33      Solutions:

    34      - Probable: Download agent created an invalid file.

    35      Fix download agent.

    36      - Inprobable: Corrupted request file, or FAT

    37      */

    38     UPD_INSTALL_REQUEST_IS_INVALID = 1,

    39     /*

    40      Problem: Update package is absent from specified location.

    41 

    42      Solution: Incorrect user application actions. 

    43      Read update application document / manual on how to switch to 

    44      update mode.

    45      */

    46     UPD_UPDATE_PACKAGE_IS_ABSENT = 2,

    47     /*

    48      Problem: Update package is corrupted. (Integrity or authenticity 

    49      check failed)

    50      Solution: End-user should try to download again update package.

    51      */

    52     UPD_UPDATE_PACKAGE_IS_CORRUPTED = 3,

    53     /*

    54      Problem: Update package contents is invalid for some reason.

    55      This problem normally refers to the fact that update package

    56      were created incorrectly.

    57      

    58      Solution: Contact update package build team in order to find out the 

    59      error cause.

    60      */

    61     UPD_UPDATE_PACKAGE_CONTENTS_IS_INVALID = 4,

    62     /*

    63      Problem: Update package is not compatible with current mobile device.

    64      Solution: End-user should try to download again update package.

    65      */

    66 

    67     UPD_UPDATE_PACKAGE_IS_NOT_COMPATIBLE_WITH_CURRENT_MOBILE_DEVICE = 5,

    68     /*

    69      Problem: This error code will be used to indicate fatal error 

    70      code after which phone becomes dead.

    71      

    72      Solution: Phone should be taken to maintenance.

    73      This error code cannot be seen by normal mode applications 

    74      because OS cannot be started when phone became dead.

    75      */

    76     UPD_FATAL_ERROR = 0xFFFFFFFF

    77     } InstallationResult;

    78 

    79 typedef enum

    80     {

    81     UPD_InvalidBlockHeaderIdentifier = 1,

    82     UPD_InvalidUpdatePackageVersion = 2,

    83     UPD_GenericInvalidFileFormat = 3

    84     } DetailedInstallationResult;

    85 

    86 #endif //__COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__