• Yatharth Kochar's avatar
    Add new version of image loading. · 72600226
    Yatharth Kochar authored
    This patch adds capability to load BL images based on image
    descriptors instead of hard coded way of loading BL images.
    This framework is designed such that it can be readily adapted
    by any BL stage that needs to load images.
    
    In order to provide the above capability the following new
    platform functions are introduced:
    
      bl_load_info_t *plat_get_bl_image_load_info(void);
        This function returns pointer to the list of images that the
        platform has populated to load.
    
      bl_params_t *plat_get_next_bl_params(void);
        This function returns a pointer to the shared memory that the
        platform has kept aside to pass trusted firmware related
        information that next BL image needs.
    
      void plat_flush_next_bl_params(void);
        This function flushes to main memory all the params that
        are passed to next image.
    
      int bl2_plat_handle_post_image_load(unsigned int image_id)
        This function can be used by the platforms to update/use
        image information for given `image_id`.
    
    `desc_image_load.c` contains utility functions which can be used
    by the platforms to generate, load and executable, image list
    based on the registered image descriptors.
    
    This patch also adds new version of `load_image/load_auth_image`
    functions in-order to achieve the above capability.
    
    Following are the changes for the new version as compared to old:
      - Refactor the signature and only keep image_id and image_info_t
        arguments. Removed image_base argument as it is already passed
        through image_info_t. Given that the BL image base addresses and
        limit/size are already provided by the platforms, the meminfo_t
        and entry_point_info arguments are not needed to provide/reserve
        the extent of free memory for the given BL image.
    
      - Added check for the image size against the defined max size.
        This is needed because the image size could come from an
        unauthenticated source (e.g. the FIP header).
        To make this check, new member is added to the image_info_t
        struct for identifying the image maximum size.
    
    New flag `LOAD_IMAGE_V2` is added in the Makefile.
    Default value is 0.
    
    NOTE: `TRUSTED_BOARD_BOOT` is currently not supported when
          `LOAD_IMAGE_V2` is enabled.
    
    Change-Id: Ia7b643f4817a170d5a2fbf479b9bc12e63112e79
    72600226
porting-guide.md 92.5 KB