Firmware.idl

module firmware {

    enumeration UpdateHistoryStatus {
        SUCCESSFUL,                     
        FAILED,                         
        INCOMPLETE                      
    };

    structure UpdateHistoryEntry {
        time timestamp;                 
        string oldVersion;              
        string imageVersion;            
        string imageMD5;                
        UpdateHistoryStatus status;     
    };

    enumeration ImageState {
        NONE,                           
        UPLOADING,                      
        UPLOAD_FAILED,                  
        DOWNLOADING,                    
        DOWNLOAD_FAILED,                
        COMPLETE                        
    };

    structure ImageStatus {
        ImageState state;               
        string error_message;           
        time time_started;              
        int size_total;                 
        int size_done;                  
    };

    structure ImageInfo_1_0_1 {
        boolean valid;                  

        string version;                 
        string min_required_version;    
        string min_downgrade_version;   

        string product;                 
        string platform;                
        string oem;                     
        string hwid_whitelist;          
        string hwid_blacklist;          

        boolean compatible;             

        boolean signature_present;      
        string signed_by;               
        boolean signature_good;         
        string certified_by;            
        boolean certificate_good;       

        boolean model_list_present;     
        boolean model_supported;        
    };

    enumeration UpdateFlags {
        CROSS_OEM,                      
        CROSS_HW,                       
        ALLOW_UNTRUSTED                 
    };

    interface Firmware_2_0_0 {

        void reboot();

        void factoryReset();

        string getVersion();

        vector<UpdateHistoryEntry> getUpdateHistory();

        ImageStatus getImageStatus();

        void discardImage();

        boolean getImageInfo(out ImageInfo_1_0_1 info);

        void startUpdate(in vector<UpdateFlags> flags);

    };

}