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 

    19 

    20 

    21 #ifndef __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__

    22 #define __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__

    23 

    24 

    25 typedef enum

    26 {

    27 

    28     /*

    29         Everything is ok - update package were installed successfully and 

    30         newer version of OS is running.

    31     */

    32 	UPD_OK=0,

    33     /*

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

    35         Download agent.

    36         

    37         Solutions:

    38             - Probable: Download agent created an invalid file.

    39               Fix download agent.

    40             - Inprobable: Corrupted request file, or FAT

    41     */

    42     UPD_INSTALL_REQUEST_IS_INVALID=1,

    43     /*

    44         Problem: Update package is absent from specified location.

    45 

    46         Solution: Incorrect user application actions. 

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

    48         update mode.

    49     */

    50     UPD_UPDATE_PACKAGE_IS_ABSENT=2,

    51     /*

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

    53         check failed)

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

    55     */

    56 	UPD_UPDATE_PACKAGE_IS_CORRUPTED=3,

    57     /*

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

    59         This problem normally refers to the fact that update package

    60         were created incorrectly.

    61     

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

    63         error cause.

    64     */

    65 	UPD_UPDATE_PACKAGE_CONTENTS_IS_INVALID=4,

    66     /*

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

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

    69     */    

    70 

    71 	UPD_UPDATE_PACKAGE_IS_NOT_COMPATIBLE_WITH_CURRENT_MOBILE_DEVICE=5,

    72     /*

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

    74         code after which phone becomes dead.

    75     

    76         Solution: Phone should be taken to maintenance.

    77         This error code cannot be seen by normal mode applications 

    78         because OS cannot be started when phone became dead.

    79     */

    80 	UPD_FATAL_ERROR=0xFFFFFFFF

    81 } InstallationResult;

    82 

    83 

    84 typedef enum

    85 {

    86     UPD_InvalidBlockHeaderIdentifier    =1,

    87     UPD_InvalidUpdatePackageVersion     =2,

    88     UPD_GenericInvalidFileFormat        =3

    89 } DetailedInstallationResult;

    90 

    91 

    92 

    93 #endif //__COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__