Re: [PATCH] mhi: host: Add tme supported image download functionality

[Jeffrey Hugo]

On 7/20/2023 8:39 PM, Qiang Yu wrote:
> Add tme supported image related flag which makes decision in terms of how
> FBC image based AMSS image is being downloaded with connected endpoint.
> FBC image is having 2 image combine: SBL image + AMSS image.
> 1. FBC image download using legacy image format:
> - SBL image: 512KB of FBC image is downloaded using BHI.
> - AMSS image: full FBC image is downloaded using BHIe.
> 2. FBC image download using TME supported image format:
> - SBL image: 512 KB of FBC image is downloaded using BHI.
> - AMSS image: 512 KB onward FBC image is downloaded using BHIe.
> There is no change for SBL image download. Although AMSS image start
> address is end address of SBL image while using TME supported image format.

I know what TME is, but in the context of this patch, it doesn't seem 
like relevant information.  "tme" is just a name for this mode, but it 
is not very descriptive.  Also, I suspect that this mode is not 
intrinsically related to the TME hardware on the endpoint, it just 
happens to be used on targets where TME is present.

Is there something else we can call this?

> Signed-off-by: Mayank Rana <quic_mrana@xxxxxxxxxxx>
> Signed-off-by: Qiang Yu <quic_qianyu@xxxxxxxxxxx>

This doesn't make sense.  This patch is from you, which makes you the 
author.  But Mayank's SOB is listed first, which means he is the author. 
 Those two facts conflict.

Did Mayank author this and you are just submitting it on his behalf, or 
did the two of you co-author this?

> ---
>   drivers/bus/mhi/host/boot.c | 24 +++++++++++++++++-------
>   include/linux/mhi.h         |  2 ++
>   2 files changed, 19 insertions(+), 7 deletions(-)
>
> diff --git a/drivers/bus/mhi/host/boot.c b/drivers/bus/mhi/host/boot.c
> index d2a19b07..563b011 100644
> --- a/drivers/bus/mhi/host/boot.c
> +++ b/drivers/bus/mhi/host/boot.c
> @@ -365,12 +365,13 @@ int mhi_alloc_bhie_table(struct mhi_controller *mhi_cntrl,
>   }
>   
>   static void mhi_firmware_copy(struct mhi_controller *mhi_cntrl,
> -			      const struct firmware *firmware,
> +			      const u8 *image_buf,
> +			      size_t img_size,
>   			      struct image_info *img_info)
>   {
> -	size_t remainder = firmware->size;
> +	size_t remainder = img_size;
>   	size_t to_cpy;
> -	const u8 *buf = firmware->data;
> +	const u8 *buf = image_buf;
>   	struct mhi_buf *mhi_buf = img_info->mhi_buf;
>   	struct bhi_vec_entry *bhi_vec = img_info->bhi_vec;
>   
> @@ -395,8 +396,9 @@ void mhi_fw_load_handler(struct mhi_controller *mhi_cntrl)
>   	const char *fw_name;
>   	void *buf;
>   	dma_addr_t dma_addr;
> -	size_t size;
> +	size_t size, img_size;
>   	int i, ret;
> +	const u8 *img_buf;
>   
>   	if (MHI_PM_IN_ERROR_STATE(mhi_cntrl->pm_state)) {
>   		dev_err(dev, "Device MHI is not in valid state\n");
> @@ -478,15 +480,23 @@ void mhi_fw_load_handler(struct mhi_controller *mhi_cntrl)
>   	 * device transitioning into MHI READY state
>   	 */
>   	if (mhi_cntrl->fbc_download) {
> -		ret = mhi_alloc_bhie_table(mhi_cntrl, &mhi_cntrl->fbc_image,
> -					   firmware->size);
> +		img_size = firmware->size;
> +		img_buf = firmware->data;
> +		dev_dbg(dev, "tme_supported_image:%s\n",
> +				(mhi_cntrl->tme_supported_image ? "True" : "False"));
> +		if (mhi_cntrl->tme_supported_image) {
> +			img_buf = firmware->data + mhi_cntrl->sbl_size;
> +			img_size = img_size - mhi_cntrl->sbl_size;
> +		}
> +
> +		ret = mhi_alloc_bhie_table(mhi_cntrl, &mhi_cntrl->fbc_image, img_size);
>   		if (ret) {
>   			release_firmware(firmware);
>   			goto error_fw_load;
>   		}
>   
>   		/* Load the firmware into BHIE vec table */
> -		mhi_firmware_copy(mhi_cntrl, firmware, mhi_cntrl->fbc_image);
> +		mhi_firmware_copy(mhi_cntrl, img_buf, img_size, mhi_cntrl->fbc_image);
>   	}
>   
>   	release_firmware(firmware);
> diff --git a/include/linux/mhi.h b/include/linux/mhi.h
> index f6de4b6..5f46dc9 100644
> --- a/include/linux/mhi.h
> +++ b/include/linux/mhi.h
> @@ -306,6 +306,7 @@ struct mhi_controller_config {
>    * @reg_len: Length of the MHI MMIO region (required)
>    * @fbc_image: Points to firmware image buffer
>    * @rddm_image: Points to RAM dump buffer
> + * @tme_supported_image: Flag to make decision about firmware download start address (optional)
>    * @mhi_chan: Points to the channel configuration table
>    * @lpm_chans: List of channels that require LPM notifications
>    * @irq: base irq # to request (required)
> @@ -391,6 +392,7 @@ struct mhi_controller {
>   	size_t reg_len;
>   	struct image_info *fbc_image;
>   	struct image_info *rddm_image;
> +	bool tme_supported_image;

A bool in the middle of several pointers?  Surely that makes the pahole 
output rather sad?  A lot of work went into the organization of this 
structure.

>   	struct mhi_chan *mhi_chan;
>   	struct list_head lpm_chans;
>   	int *irq;