From: Qiang Yu <quic_qianyu@quicinc.com>
To: Manivannan Sadhasivam <mani@kernel.org>
Cc: <quic_jhugo@quicinc.com>, <mhi@lists.linux.dev>,
<linux-arm-msm@vger.kernel.org>, <linux-kernel@vger.kernel.org>,
<quic_cang@quicinc.com>, <quic_mrana@quicinc.com>
Subject: Re: [PATCH v3 1/3] bus: mhi: host: Add sysfs entry to force device to enter EDL
Date: Tue, 16 Apr 2024 13:45:18 +0800 [thread overview]
Message-ID: <a62cb28a-e6ab-4f60-9210-b7aa8e0c34e0@quicinc.com> (raw)
In-Reply-To: <20240415115616.GF7537@thinkpad>
On 4/15/2024 7:56 PM, Manivannan Sadhasivam wrote:
> On Mon, Apr 15, 2024 at 04:49:03PM +0800, Qiang Yu wrote:
>> Add sysfs entry to allow users of MHI bus force device to enter EDL.
>> Considering that the way to enter EDL mode varies from device to device and
>> some devices even do not support EDL. Hence, add a callback edl_trigger in
>> mhi controller as part of the sysfs entry to be invoked and MHI core will
>> only create EDL sysfs entry for mhi controller that provides edl_trigger
>> callback. All of the process a specific device required to enter EDL mode
>> can be placed in this callback.
>>
>> Signed-off-by: Qiang Yu <quic_qianyu@quicinc.com>
>> ---
>> Documentation/ABI/stable/sysfs-bus-mhi | 11 +++++++++++
>> drivers/bus/mhi/host/init.c | 35 ++++++++++++++++++++++++++++++++++
>> include/linux/mhi.h | 2 ++
>> 3 files changed, 48 insertions(+)
>>
>> diff --git a/Documentation/ABI/stable/sysfs-bus-mhi b/Documentation/ABI/stable/sysfs-bus-mhi
>> index 1a47f9e..d0bf9ae 100644
>> --- a/Documentation/ABI/stable/sysfs-bus-mhi
>> +++ b/Documentation/ABI/stable/sysfs-bus-mhi
>> @@ -29,3 +29,14 @@ Description: Initiates a SoC reset on the MHI controller. A SoC reset is
>> This can be useful as a method of recovery if the device is
>> non-responsive, or as a means of loading new firmware as a
>> system administration task.
>> +
>> +What: /sys/bus/mhi/devices/.../force_edl
> s/force_edl/trigger_edl
>
>> +Date: April 2024
>> +KernelVersion: 6.9
>> +Contact: mhi@lists.linux.dev
>> +Description: Force devices to enter EDL (emergency download) mode. Only MHI
> How can the user trigger EDL mode? Writing to this file? If so, what is the
> value?
User can trigger EDL mode by writing a non-zero value to this file.
>
> 'Emergency Download'
>
>> + controller that supports EDL mode and provides a mechanism for
>> + manually triggering EDL contains this file. Once in EDL mode,
> 'This entry only exists for devices capable of entering the EDL mode using the
> standard EDL triggering mechanism defined in the MHI spec <insert the version>.'
>
>> + the flash programmer image can be downloaded to the device to
>> + enter the flash programmer execution environment. This can be
>> + useful if user wants to update firmware.
> It'd be good to mention the OS tool like QDL that is used to download firmware
> over EDL.
OK, can I add an additionnal line like this
Users: Any OS tools that is used to download firmware over EDL
like QDL.
>
>> diff --git a/drivers/bus/mhi/host/init.c b/drivers/bus/mhi/host/init.c
>> index 44f9349..333ac94 100644
>> --- a/drivers/bus/mhi/host/init.c
>> +++ b/drivers/bus/mhi/host/init.c
>> @@ -127,6 +127,32 @@ static ssize_t soc_reset_store(struct device *dev,
>> }
>> static DEVICE_ATTR_WO(soc_reset);
>>
>> +static ssize_t force_edl_store(struct device *dev,
> s/force_edl/trigger_edl
>
>> + struct device_attribute *attr,
>> + const char *buf, size_t count)
>> +{
>> + struct mhi_device *mhi_dev = to_mhi_device(dev);
>> + struct mhi_controller *mhi_cntrl = mhi_dev->mhi_cntrl;
>> + unsigned long val;
>> + int ret;
>> +
>> + ret = kstrtoul(buf, 10, &val);
>> + if (ret < 0) {
>> + dev_err(dev, "Could not parse string: %d\n", ret);
> No need to print error.
>
>> + return ret;
>> + }
>> +
>> + if (!val)
>> + return count;
> What does this mean?
If user want to trigger EDL mode,he has to write a non-zero value to this
file. If he writes zero, nothing will happen.
Do we need to limit the valid value to a specific value like 1?
>
>> +
>> + ret = mhi_cntrl->edl_trigger(mhi_cntrl);
>> + if (ret)
>> + return ret;
>> +
>> + return count;
>> +}
>> +static DEVICE_ATTR_WO(force_edl);
>> +
>> static struct attribute *mhi_dev_attrs[] = {
>> &dev_attr_serial_number.attr,
>> &dev_attr_oem_pk_hash.attr,
>> @@ -1018,6 +1044,12 @@ int mhi_register_controller(struct mhi_controller *mhi_cntrl,
>> if (ret)
>> goto err_release_dev;
>>
>> + if (mhi_cntrl->edl_trigger) {
>> + ret = sysfs_create_file(&mhi_dev->dev.kobj, &dev_attr_force_edl.attr);
>> + if (ret)
>> + goto err_release_dev;
>> + }
>> +
>> mhi_cntrl->mhi_dev = mhi_dev;
>>
>> mhi_create_debugfs(mhi_cntrl);
>> @@ -1051,6 +1083,9 @@ void mhi_unregister_controller(struct mhi_controller *mhi_cntrl)
>> mhi_deinit_free_irq(mhi_cntrl);
>> mhi_destroy_debugfs(mhi_cntrl);
>>
>> + if (mhi_cntrl->edl_trigger)
>> + sysfs_remove_file(&mhi_dev->dev.kobj, &dev_attr_force_edl.attr);
>> +
>> destroy_workqueue(mhi_cntrl->hiprio_wq);
>> kfree(mhi_cntrl->mhi_cmd);
>> kfree(mhi_cntrl->mhi_event);
>> diff --git a/include/linux/mhi.h b/include/linux/mhi.h
>> index cde01e1..8280545 100644
>> --- a/include/linux/mhi.h
>> +++ b/include/linux/mhi.h
>> @@ -353,6 +353,7 @@ struct mhi_controller_config {
>> * @read_reg: Read a MHI register via the physical link (required)
>> * @write_reg: Write a MHI register via the physical link (required)
>> * @reset: Controller specific reset function (optional)
>> + * @edl_trigger: CB function to enter EDL mode (optional)
> s/enter/trigger
>
> - Mani
>
next prev parent reply other threads:[~2024-04-16 5:45 UTC|newest]
Thread overview: 18+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-04-15 8:49 [PATCH v3 0/3] Add sysfs entry to EDL mode Qiang Yu
2024-04-15 8:49 ` [PATCH v3 1/3] bus: mhi: host: Add sysfs entry to force device to enter EDL Qiang Yu
2024-04-15 11:56 ` Manivannan Sadhasivam
2024-04-16 5:45 ` Qiang Yu [this message]
2024-04-22 7:24 ` Manivannan Sadhasivam
2024-04-22 12:13 ` Qiang Yu
2024-04-15 8:49 ` [PATCH v3 2/3] bus: mhi: host: Add a new API for getting channel doorbell address Qiang Yu
2024-04-15 12:02 ` Manivannan Sadhasivam
2024-04-15 8:49 ` [PATCH v3 3/3] bus: mhi: host: pci_generic: Add edl callback to enter EDL Qiang Yu
2024-04-15 12:12 ` Manivannan Sadhasivam
2024-04-15 23:53 ` Mayank Rana
2024-04-16 3:50 ` Qiang Yu
2024-04-16 18:12 ` Mayank Rana
2024-04-17 3:01 ` Qiang Yu
2024-04-17 4:41 ` Qiang Yu
2024-04-18 17:37 ` Mayank Rana
2024-04-22 8:08 ` Manivannan Sadhasivam
2024-04-22 12:06 ` Qiang Yu
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=a62cb28a-e6ab-4f60-9210-b7aa8e0c34e0@quicinc.com \
--to=quic_qianyu@quicinc.com \
--cc=linux-arm-msm@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mani@kernel.org \
--cc=mhi@lists.linux.dev \
--cc=quic_cang@quicinc.com \
--cc=quic_jhugo@quicinc.com \
--cc=quic_mrana@quicinc.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®