platform/chrome: wilco_ec: Add Boot on AC support
PATCH v3 1/2 platform/chrome: wilco_ec: Add Boot on AC support
Boot on AC is a policy which makes the device boot from S5 when AC power is connected. This is useful for users who want to run their device headless or with a dock.
v3 changes:
- Add docstring to wilco_ec_add_sysfs()
- Tweak a comment
- Use val > 1 instead of val != 0 && val != 1
v2 changes:
- Move documentation to Documentation/ABI/testing/sysfs-platform-wilco-ec
--- .../ABI/testing/sysfs-platform-wilco-ec | 11 +++ drivers/platform/chrome/wilco_ec/Makefile | 2 +- drivers/platform/chrome/wilco_ec/core.c | 9 +++ drivers/platform/chrome/wilco_ec/sysfs.c | 77 +++++++++++++++++++ include/linux/platform_data/wilco-ec.h | 12 +++ 5 files changed, 110 insertions(+), 1 deletion(-) create mode 100644 Documentation/ABI/testing/sysfs-platform-wilco-ec create mode 100644 drivers/platform/chrome/wilco_ec/sysfs.c
Documentation/ABI/testing/sysfs-platform-wilco-ec new file +11 -0
@@ -0,0 +1,11 @@ +What: /sys/bus/platform/devices/GOOG000C\:00/boot_on_ac +Date: April 2019 +KernelVersion: 5.2 +Description: + Boot on AC is a policy which makes the device boot from S5 + when AC power is connected. This is useful for users who + want to run their device headless or with a dock. + + Input should be parseable by kstrtou8() to 0 or 1. + Output will be either "0\n" or "1\n". +
drivers/platform/chrome/wilco_ec/Makefile +1 -1
@@ -1,6 +1,6 @@ # SPDX-License-Identifier: GPL-2.0 -wilco_ec-objs := core.o mailbox.o +wilco_ec-objs := core.o mailbox.o sysfs.o obj-$(CONFIG_WILCO_EC) += wilco_ec.o wilco_ec_debugfs-objs := debugfs.o obj-$(CONFIG_WILCO_EC_DEBUGFS) += wilco_ec_debugfs.o
drivers/platform/chrome/wilco_ec/core.c +9 -0
@@ -89,8 +89,16 @@ static int wilco_ec_probe(struct platform_device *pdev) goto unregister_debugfs; } + ret =wilco_ec_add_sysfs (ec); +if (ret <0 ) { +dev_err (dev,"Failed to create sysfs entries: %d" , ret); + goto unregister_rtc; + } +return 0 ; +unregister_rtc: +platform_device_unregister (ec->rtc_pdev); unregister_debugfs:if (ec->debugfs_pdev)platform_device_unregister (ec->debugfs_pdev);
@@ -102,6 +110,7 @@ static int wilco_ec_remove(struct platform_device *pdev) {struct wilco_ec_device *ec =platform_get_drvdata (pdev); +wilco_ec_remove_sysfs (ec);platform_device_unregister (ec->rtc_pdev);if (ec->debugfs_pdev)platform_device_unregister (ec->debugfs_pdev);
drivers/platform/chrome/wilco_ec/sysfs.c new file +77 -0
77 lines not on this page · raw message
include/linux/platform_data/wilco-ec.h +12 -0
@@ -123,4 +123,16 @@ struct wilco_ec_message {*/ int wilco_ec_mailbox (struct wilco_ec_device *ec,struct wilco_ec_message *msg); +/** +* wilco_ec_add_sysfs() - Create sysfs entries +* @ec: Wilco EC device +* +* wilco_ec_remove_sysfs() needs to be called afterwards +* to perform the necessary cleanup. +* +* Return: 0 on success or negative error code on failure. +*/ +int wilco_ec_add_sysfs (struct wilco_ec_device *ec); +void wilco_ec_remove_sysfs (struct wilco_ec_device *ec); +#endif /* WILCO_EC_H */
Signature · 1 line
2.20.1
PATCH v3 2/2 platform/chrome: wilco_ec: Add USB PowerShare Policy control
USB PowerShare is a policy which affects charging via the special USB PowerShare port (marked with a small lightning bolt or battery icon) when in low power states:
- In S0, the port will always provide power.
- In S0ix, if power_share is enabled, then power will be supplied to the port when on AC or if battery is > 50%. Else no power is supplied.
- In S5, if power_share is enabled, then power will be supplied to the port when on AC. Else no power is supplied.
v3 changes:
- Drop a silly blank line
- Use val > 1 instead of val != 0 && val != 1
v2 changes:
- Move documentation to Documentation/ABI/testing/sysfs-platform-wilco-ec
- Zero out reserved bytes in requests.
--- .../ABI/testing/sysfs-platform-wilco-ec | 16 ++++ drivers/platform/chrome/wilco_ec/sysfs.c | 92 +++++++++++++++++++ 2 files changed, 108 insertions(+)
Documentation/ABI/testing/sysfs-platform-wilco-ec +16 -0
@@ -9,3 +9,19 @@ Description: Input should be parseable by kstrtou8() to 0 or 1. Output will be either "0\n" or "1\n". +What: /sys/bus/platform/devices/GOOG000C\:00/usb_power_share +Date: April 2019 +KernelVersion: 5.2 +Description: + Control the USB PowerShare Policy. USB PowerShare is a policy + which affects charging via the special USB PowerShare port + (marked with a small lightning bolt or battery icon) when in + low power states: + - In S0, the port will always provide power. + - In S0ix, if power_share is enabled, then power will be + supplied to the port when on AC or if battery is > 50%. + Else no power is supplied. + - In S5, if power_share is enabled, then power will be supplied + to the port when on AC. Else no power is supplied. + + Input should be either "0" or "1".
drivers/platform/chrome/wilco_ec/sysfs.c +92 -0
106 lines not on this page · raw message
Signature · 1 line
2.20.1
Re: [PATCH v3 2/2] platform/chrome: wilco_ec: Add USB PowerShare Policy control
Hi Nick,
Thanks for the patch, some few comments below...
Missatge de Nick Crews <[email protected]> del dia dc., 17 d’abr. 2019 a les 3:21:
Quoted 36 lines
USB PowerShare is a policy which affects charging via the special USB PowerShare port (marked with a small lightning bolt or battery icon) when in low power states:
- In S0, the port will always provide power.
- In S0ix, ifpower_shareis enabled, then power will be supplied to the port when on AC or if battery is > 50%. Else no power is supplied.
- In S5, ifpower_shareis enabled, then power will be supplied to the port when on AC. Else no power is supplied.v3 changes:
- Drop a silly blank line
- Use val > 1 instead of val != 0 && val != 1
v2 changes:
- Move documentation toDocumentation/ABI/testing/sysfs-platform-wilco-ec
- Zero out reserved bytes in requests.Signed-off-by Nick Crews <[email protected]>--- .../ABI/testing/sysfs-platform-wilco-ec | 16 ++++ drivers/platform/chrome/wilco_ec/sysfs.c | 92 +++++++++++++++++++ 2 files changed, 108 insertions(+)Documentation/ABI/testing/sysfs-platform-wilco-ec +5
-0@@ -9,3 +9,19 @@ Description: Input should be parseable by kstrtou8() to 0 or 1. Output will be either "0\n" or "1\n". +What: /sys/bus/platform/devices/GOOG000C\:00/usb_power_share +Date: April 2019 +KernelVersion: 5.2 +Description: + Control the USB PowerShare Policy. USB PowerShare is a policy
Documentation/ABI/testing/sysfs-platform-wilco-ec Description: · line 26
Quoted 10 lines
Documentation/ABI/testing/sysfs-platform-wilco-ec +10
-0+ which affects charging via the special USB PowerShare port + (marked with a small lightning bolt or battery icon) when in + low power states: + - In S0, the port will always provide power. + - In S0ix, if power_share is enabled, then power will be + supplied to the port when on AC or if battery is > 50%. + Else no power is supplied. + - In S5, if power_share is enabled, then power will be supplied + to the port when on AC. Else no power is supplied. +
So, basically, this is to enable/disable USB Powershare capability. I think that this is not an uncommon capability can we give it a respin and see if we can do this generic?
Quoted 114 lines
Documentation/ABI/testing/sysfs-platform-wilco-ec +1
-0+ Input should be either "0" or "1".drivers/platform/chrome/wilco_ec/sysfs.c +92
-1@@ -23,6 +23,26 @@ struct boot_on_ac_request {u8 reserved7; } __packed; +#define CMD_USB_POWER_SHARE 0x39 + +enum usb_power_share_op { +POWER_SHARE_GET =0 , +POWER_SHARE_SET =1 , +}; + +struct usb_power_share_request { +u8 cmd;/* Always CMD_USB_POWER_SHARE */ +u8 reserved; +u8 op;/* One of enum usb_power_share_op */ +u8 val;/* When setting, either 0 or 1 */ +} __packed; + +struct usb_power_share_response { +u8 reserved; +u8 status;/* Set by EC to 0 on success, other value on failure */ +u8 val;/* When getting, set by EC to either 0 or 1 */ +} __packed; +static ssize_t boot_on_ac_store (struct device *dev,struct device_attribute *attr,const char *buf,size_t count)@@ -57,8 +77,80 @@ static ssize_t boot_on_ac_store(struct device *dev,static DEVICE_ATTR_WO (boot_on_ac); +static int send_usb_power_share (struct wilco_ec_device *ec, +struct usb_power_share_request *rq, +struct usb_power_share_response *rs) +{ +struct wilco_ec_message msg; +int ret; + +memset (&msg,0 ,sizeof (msg)); + msg.type =WILCO_EC_MSG_LEGACY ; + msg.request_data = rq; + msg.request_size =sizeof (*rq); + msg.response_data = rs; + msg.response_size =sizeof (*rs); + ret =wilco_ec_mailbox (ec, &msg); +if (ret <0 ) +return ret; +if (rs->status) +return -EIO ; + +return 0 ; +} + +static ssize_t usb_power_share_show (struct device *dev, +struct device_attribute *attr,char *buf) +{ +struct wilco_ec_device *ec =dev_get_drvdata (dev); +struct usb_power_share_request rq; +struct usb_power_share_response rs; +int ret; + +memset (&rq,0 ,sizeof (rq)); + rq.cmd =CMD_USB_POWER_SHARE ; + rq.op =POWER_SHARE_GET ; + + ret =send_usb_power_share (ec, &rq, &rs); +if (ret <0 ) +return ret; + +return sprintf (buf,"%d\n" , rs.val); +} + +static ssize_t usb_power_share_store (struct device *dev, +struct device_attribute *attr, +const char *buf,size_t count) +{ +struct wilco_ec_device *ec =dev_get_drvdata (dev); +struct usb_power_share_request rq; +struct usb_power_share_response rs; +int ret; +u8 val; + + ret =kstrtou8 (buf,10 , &val); +if (ret <0 ) +return ret; +if (val >1 ) +return -EINVAL ; + +memset (&rq,0 ,sizeof (rq)); + rq.cmd =CMD_USB_POWER_SHARE ; + rq.op =POWER_SHARE_SET ; + rq.val = val; + + ret =send_usb_power_share (ec, &rq, &rs); +if (ret <0 ) +return ret; + +return count; +} + +static DEVICE_ATTR_RW (usb_power_share); +static struct attribute *wilco_dev_attrs[] = { &dev_attr_boot_on_ac.attr, + &dev_attr_usb_power_share.attr,NULL , }; --
Quoted 2 lines
2.20.1
Thanks,
Enric
There's one error that Guenter just found...
drivers/platform/chrome/wilco_ec/sysfs.c line 76
Quoted 9 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +9
-0+ +int wilco_ec_add_sysfs (struct wilco_ec_device *ec) +{ +return sysfs_create_group (&ec->dev->kobj, &wilco_dev_attr_group); +} + +void wilco_ec_remove_sysfs (struct wilco_ec_device *ec) +{ +sysfs_create_group (&ec->dev->kobj, &wilco_dev_attr_group);
Should be sysfs_remove_group()
Hi Enric,
Are these two patches an acceptable use of sysfs? There were concerns earlier about abusing sysfs, but I think that these two uses follow other sysfs use-cases well.
Thanks,
Nick
Hi Nick,
Thanks for the patch, some few comments below...
Missatge de Nick Crews <[email protected]> del dia dc., 17 d’abr. 2019 a les 3:22:
Quoted 135 lines
Boot on AC is a policy which makes the device boot from S5 when AC power is connected. This is useful for users who want to run their device headless or with a dock.
v3 changes:
- Add docstring towilco_ec_add_sysfs()
- Tweak a comment
- Use val > 1 instead of val != 0 && val != 1
v2 changes:
- Move documentation toDocumentation/ABI/testing/sysfs-platform-wilco-ecSigned-off-by Nick Crews <[email protected]>--- .../ABI/testing/sysfs-platform-wilco-ec | 11 +++ drivers/platform/chrome/wilco_ec/Makefile | 2 +- drivers/platform/chrome/wilco_ec/core.c | 9 +++ drivers/platform/chrome/wilco_ec/sysfs.c | 77 +++++++++++++++++++ include/linux/platform_data/wilco-ec.h | 12 +++ 5 files changed, 110 insertions(+), 1 deletion(-) create mode 100644 Documentation/ABI/testing/sysfs-platform-wilco-ec create mode 100644 drivers/platform/chrome/wilco_ec/sysfs.cDocumentation/ABI/testing/sysfs-platform-wilco-ec new file +11
-0@@ -0,0 +1,11 @@ +What: /sys/bus/platform/devices/GOOG000C\:00/boot_on_ac +Date: April 2019 +KernelVersion: 5.2 +Description: + Boot on AC is a policy which makes the device boot from S5 + when AC power is connected. This is useful for users who + want to run their device headless or with a dock. + + Input should be parseable by kstrtou8() to 0 or 1. + Output will be either "0\n" or "1\n". +drivers/platform/chrome/wilco_ec/Makefile +1
-1@@ -1,6 +1,6 @@ # SPDX-License-Identifier: GPL-2.0 -wilco_ec-objs := core.o mailbox.o +wilco_ec-objs := core.o mailbox.o sysfs.o obj-$(CONFIG_WILCO_EC) += wilco_ec.o wilco_ec_debugfs-objs := debugfs.o obj-$(CONFIG_WILCO_EC_DEBUGFS) += wilco_ec_debugfs.odrivers/platform/chrome/wilco_ec/core.c +9
-0@@ -89,8 +89,16 @@ static int wilco_ec_probe(struct platform_device *pdev) goto unregister_debugfs; } + ret =wilco_ec_add_sysfs (ec); +if (ret <0 ) { +dev_err (dev,"Failed to create sysfs entries: %d" , ret); + goto unregister_rtc; + } +return 0 ; +unregister_rtc: +platform_device_unregister (ec->rtc_pdev); unregister_debugfs:if (ec->debugfs_pdev)platform_device_unregister (ec->debugfs_pdev);@@ -102,6 +110,7 @@ static int wilco_ec_remove(struct platform_device *pdev) {struct wilco_ec_device *ec =platform_get_drvdata (pdev); +wilco_ec_remove_sysfs (ec);platform_device_unregister (ec->rtc_pdev);if (ec->debugfs_pdev)platform_device_unregister (ec->debugfs_pdev);drivers/platform/chrome/wilco_ec/sysfs.c new file +48
-0@@ -0,0 +1,77 @@ +// SPDX-License-Identifier: GPL-2.0 +/* +* Copyright 2019 Google LLC +* +* Sysfs properties to view and modify EC-controlled features on Wilco devices. +* The entries will appear under /sys/bus/platform/devices/GOOG000C:00/ +* +* See Documentation/ABI/testing/sysfs-platform-wilco-ec for more information. +*/ + +#include <linux/platform_data/wilco-ec.h> +#include <linux/sysfs.h> + +#define CMD_KB_CMOS 0x7C +#define SUB_CMD_KB_CMOS_AUTO_ON 0x03 + +struct boot_on_ac_request { +u8 cmd;/* Always CMD_KB_CMOS */ +u8 reserved1; +u8 sub_cmd;/* Always SUB_CMD_KB_CMOS_AUTO_ON */ +u8 reserved3to5[3 ]; +u8 val;/* Either 0 or 1 */ +u8 reserved7; +} __packed; + +static ssize_t boot_on_ac_store (struct device *dev, +struct device_attribute *attr, +const char *buf,size_t count) +{ +struct wilco_ec_device *ec =dev_get_drvdata (dev); +struct boot_on_ac_request rq; +struct wilco_ec_message msg; +int ret; +u8 val; + + ret =kstrtou8 (buf,10 , &val); +if (ret <0 ) +return ret; +if (val >1 ) +return -EINVAL ; + +memset (&rq,0 ,sizeof (rq)); + rq.cmd =CMD_KB_CMOS ; + rq.sub_cmd =SUB_CMD_KB_CMOS_AUTO_ON ; + rq.val = val; + +memset (&msg,0 ,sizeof (msg)); + msg.type =WILCO_EC_MSG_LEGACY ;
drivers/platform/chrome/wilco_ec/sysfs.c line 58
Quoted 10 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +10
-0+ msg.request_data = &rq; + msg.request_size =sizeof (rq); + ret =wilco_ec_mailbox (ec, &msg); +if (ret <0 ) +return ret; + +return count; +} + +static DEVICE_ATTR_WO (boot_on_ac);
Is not possible to read the flag? From the API description seems that it is.
Quoted 8 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +8
-0+ +static struct attribute *wilco_dev_attrs[] = { + &dev_attr_boot_on_ac.attr, +NULL , +}; + +static struct attribute_group wilco_dev_attr_group = { + .attrs = wilco_dev_attrs,
drivers/platform/chrome/wilco_ec/sysfs.c line 76
Quoted 10 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +10
-0+}; + +int wilco_ec_add_sysfs (struct wilco_ec_device *ec) +{ +return sysfs_create_group (&ec->dev->kobj, &wilco_dev_attr_group); +} + +void wilco_ec_remove_sysfs (struct wilco_ec_device *ec) +{ +sysfs_create_group (&ec->dev->kobj, &wilco_dev_attr_group);
As Guenter pointed: sysfs_remove_group()
Quoted 25 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +1
-0+}include/linux/platform_data/wilco-ec.h +12
-1@@ -123,4 +123,16 @@ struct wilco_ec_message {*/ int wilco_ec_mailbox (struct wilco_ec_device *ec,struct wilco_ec_message *msg); +/** +* wilco_ec_add_sysfs() - Create sysfs entries +* @ec: Wilco EC device +* +* wilco_ec_remove_sysfs() needs to be called afterwards +* to perform the necessary cleanup. +* +* Return: 0 on success or negative error code on failure. +*/ +int wilco_ec_add_sysfs (struct wilco_ec_device *ec); +void wilco_ec_remove_sysfs (struct wilco_ec_device *ec); +#endif /* WILCO_EC_H */ --2.20.1
Thanks for the review Enric!
I can resend the patch with the fixes, or if you think the fixes are simple enough, you could tweak them as you apply them. Let me know if you want me to resend a clean version.
Quoted 4 lines
Review
Quoted 2 lines
(quoted diff) +2
-0+ +static DEVICE_ATTR_WO(boot_on_ac);Is not possible to read the flag? From the API description seems that it is.
It is not possible to read the flag. The API description is wrong, I'll fix remove
the line about reading from the documentation.
Quoted 5 lines
drivers/platform/chrome/wilco_ec/sysfs.c line 76
Quoted 3 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +3
-0+void wilco_ec_remove_sysfs (struct wilco_ec_device *ec) +{ +sysfs_create_group (&ec->dev->kobj, &wilco_dev_attr_group);As Guenter pointed:
sysfs_remove_group()
Yes, exactly.
Hi,
Quoted 6 lines · Nick Crews
Thanks for the review Enric!
I can resend the patch with the fixes, or if you think the fixes are simple enough, you could tweak them as you apply them. Let me know if you want me to resend a clean version.
No need to resend, I tweaked them.
The patch is queued to the for-next branch for the autobuilders to play with, if all goes well I'll add the patch for 5.3 when current merge window closes.
Thanks,
Enric
Quoted 17 lines
Quoted 4 lines
Review
Quoted 2 lines
(quoted diff) +2
-0+ +static DEVICE_ATTR_WO(boot_on_ac);Is not possible to read the flag? From the API description seems that it is.
It is not possible to read the flag. The API description is wrong, I'll fix remove
the line about reading from the documentation.Quoted 5 lines
drivers/platform/chrome/wilco_ec/sysfs.c line 76
Quoted 3 lines
drivers/platform/chrome/wilco_ec/sysfs.c new file +3
-0+void wilco_ec_remove_sysfs (struct wilco_ec_device *ec) +{ +sysfs_create_group (&ec->dev->kobj, &wilco_dev_attr_group);As Guenter pointed:
sysfs_remove_group()Yes, exactly.