Skip to content

Commit 249fa82

Browse files
hadessgregkh
hadess
authored and
gregkh
committed
USB: Add driver to control USB fast charge for iOS devices
iOS devices will not draw more than 500mA unless instructed to do so. Setting the charge type power supply property to "fast" tells the device to start drawing more power, using the same procedure that official "MFi" chargers would. Signed-off-by: Bastien Nocera <hadess@hadess.net> Acked-by: Alan Stern <stern@rowland.harvard.edu> Link: https://lore.kernel.org/r/20191016093933.693-7-hadess@hadess.net Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
1 parent 77419aa commit 249fa82

File tree

4 files changed

+254
-0
lines changed

4 files changed

+254
-0
lines changed

‎MAINTAINERS‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17182,6 +17182,12 @@ S: Maintained
1718217182
F: Documentation/usb/acm.rst
1718317183
F: drivers/usb/class/cdc-acm.*
1718417184

17185+
USB APPLE MFI FASTCHARGE DRIVER
17186+
M: Bastien Nocera <hadess@hadess.net>
17187+
L: linux-usb@vger.kernel.org
17188+
S: Maintained
17189+
F: drivers/usb/misc/apple-mfi-fastcharge.c
17190+
1718517191
USB AR5523 WIRELESS DRIVER
1718617192
M: Pontus Fuchs <pontus.fuchs@gmail.com>
1718717193
L: linux-wireless@vger.kernel.org

‎drivers/usb/misc/Kconfig‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,16 @@ config USB_APPLEDISPLAY
137137
Say Y here if you want to control the backlight of Apple Cinema
138138
Displays over USB. This driver provides a sysfs interface.
139139

140+
config APPLE_MFI_FASTCHARGE
141+
tristate "Fast charge control for iOS devices"
142+
select POWER_SUPPLY
143+
help
144+
Say Y here if you want to control whether iOS devices will
145+
fast charge from the USB interface, as implemented in "MFi"
146+
chargers.
147+
148+
It is safe to say M here.
149+
140150
source "drivers/usb/misc/sisusbvga/Kconfig"
141151

142152
config USB_LD

‎drivers/usb/misc/Makefile‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ obj-$(CONFIG_USB_EMI26) += emi26.o
1111
obj-$(CONFIG_USB_EMI62) += emi62.o
1212
obj-$(CONFIG_USB_EZUSB_FX2) += ezusb.o
1313
obj-$(CONFIG_USB_FTDI_ELAN) += ftdi-elan.o
14+
obj-$(CONFIG_APPLE_MFI_FASTCHARGE) += apple-mfi-fastcharge.o
1415
obj-$(CONFIG_USB_IDMOUSE) += idmouse.o
1516
obj-$(CONFIG_USB_IOWARRIOR) += iowarrior.o
1617
obj-$(CONFIG_USB_ISIGHTFW) += isight_firmware.o

‎drivers/usb/misc/apple-mfi-fastcharge.c‎

Lines changed: 237 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,237 @@
1+
// SPDX-License-Identifier: GPL-2.0+
2+
/*
3+
* Fast-charge control for Apple "MFi" devices
4+
*
5+
* Copyright (C) 2019 Bastien Nocera <hadess@hadess.net>
6+
*/
7+
8+
/* Standard include files */
9+
#include <linux/module.h>
10+
#include <linux/power_supply.h>
11+
#include <linux/slab.h>
12+
#include <linux/usb.h>
13+
14+
MODULE_AUTHOR("Bastien Nocera <hadess@hadess.net>");
15+
MODULE_DESCRIPTION("Fast-charge control for Apple \"MFi\" devices");
16+
MODULE_LICENSE("GPL");
17+
18+
#define TRICKLE_CURRENT_MA 0
19+
#define FAST_CURRENT_MA 2500
20+
21+
#define APPLE_VENDOR_ID 0x05ac /* Apple */
22+
23+
/* The product ID is defined as starting with 0x12nn, as per the
24+
* "Choosing an Apple Device USB Configuration" section in
25+
* release R9 (2012) of the "MFi Accessory Hardware Specification"
26+
*
27+
* To distinguish an Apple device, a USB host can check the device
28+
* descriptor of attached USB devices for the following fields:
29+
* ■ Vendor ID: 0x05AC
30+
* ■ Product ID: 0x12nn
31+
*
32+
* Those checks will be done in .match() and .probe().
33+
*/
34+
35+
static const struct usb_device_id mfi_fc_id_table[] = {
36+
{ .idVendor = APPLE_VENDOR_ID,
37+
.match_flags = USB_DEVICE_ID_MATCH_VENDOR },
38+
{},
39+
};
40+
41+
MODULE_DEVICE_TABLE(usb, mfi_fc_id_table);
42+
43+
/* Driver-local specific stuff */
44+
struct mfi_device {
45+
struct usb_device *udev;
46+
struct power_supply *battery;
47+
int charge_type;
48+
};
49+
50+
static int apple_mfi_fc_set_charge_type(struct mfi_device *mfi,
51+
const union power_supply_propval *val)
52+
{
53+
int current_ma;
54+
int retval;
55+
__u8 request_type;
56+
57+
if (mfi->charge_type == val->intval) {
58+
dev_dbg(&mfi->udev->dev, "charge type %d already set\n",
59+
mfi->charge_type);
60+
return 0;
61+
}
62+
63+
switch (val->intval) {
64+
case POWER_SUPPLY_CHARGE_TYPE_TRICKLE:
65+
current_ma = TRICKLE_CURRENT_MA;
66+
break;
67+
case POWER_SUPPLY_CHARGE_TYPE_FAST:
68+
current_ma = FAST_CURRENT_MA;
69+
break;
70+
default:
71+
return -EINVAL;
72+
}
73+
74+
request_type = USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE;
75+
retval = usb_control_msg(mfi->udev, usb_sndctrlpipe(mfi->udev, 0),
76+
0x40, /* Vendor‐defined power request */
77+
request_type,
78+
current_ma, /* wValue, current offset */
79+
current_ma, /* wIndex, current offset */
80+
NULL, 0, USB_CTRL_GET_TIMEOUT);
81+
if (retval) {
82+
dev_dbg(&mfi->udev->dev, "retval = %d\n", retval);
83+
return retval;
84+
}
85+
86+
mfi->charge_type = val->intval;
87+
88+
return 0;
89+
}
90+
91+
static int apple_mfi_fc_get_property(struct power_supply *psy,
92+
enum power_supply_property psp,
93+
union power_supply_propval *val)
94+
{
95+
struct mfi_device *mfi = power_supply_get_drvdata(psy);
96+
97+
dev_dbg(&mfi->udev->dev, "prop: %d\n", psp);
98+
99+
switch (psp) {
100+
case POWER_SUPPLY_PROP_CHARGE_TYPE:
101+
val->intval = mfi->charge_type;
102+
break;
103+
case POWER_SUPPLY_PROP_SCOPE:
104+
val->intval = POWER_SUPPLY_SCOPE_DEVICE;
105+
break;
106+
default:
107+
return -ENODATA;
108+
}
109+
110+
return 0;
111+
}
112+
113+
static int apple_mfi_fc_set_property(struct power_supply *psy,
114+
enum power_supply_property psp,
115+
const union power_supply_propval *val)
116+
{
117+
struct mfi_device *mfi = power_supply_get_drvdata(psy);
118+
int ret;
119+
120+
dev_dbg(&mfi->udev->dev, "prop: %d\n", psp);
121+
122+
ret = pm_runtime_get_sync(&mfi->udev->dev);
123+
if (ret < 0)
124+
return ret;
125+
126+
switch (psp) {
127+
case POWER_SUPPLY_PROP_CHARGE_TYPE:
128+
ret = apple_mfi_fc_set_charge_type(mfi, val);
129+
break;
130+
default:
131+
ret = -EINVAL;
132+
}
133+
134+
pm_runtime_mark_last_busy(&mfi->udev->dev);
135+
pm_runtime_put_autosuspend(&mfi->udev->dev);
136+
137+
return ret;
138+
}
139+
140+
static int apple_mfi_fc_property_is_writeable(struct power_supply *psy,
141+
enum power_supply_property psp)
142+
{
143+
switch (psp) {
144+
case POWER_SUPPLY_PROP_CHARGE_TYPE:
145+
return 1;
146+
default:
147+
return 0;
148+
}
149+
}
150+
151+
static enum power_supply_property apple_mfi_fc_properties[] = {
152+
POWER_SUPPLY_PROP_CHARGE_TYPE,
153+
POWER_SUPPLY_PROP_SCOPE
154+
};
155+
156+
static const struct power_supply_desc apple_mfi_fc_desc = {
157+
.name = "apple_mfi_fastcharge",
158+
.type = POWER_SUPPLY_TYPE_BATTERY,
159+
.properties = apple_mfi_fc_properties,
160+
.num_properties = ARRAY_SIZE(apple_mfi_fc_properties),
161+
.get_property = apple_mfi_fc_get_property,
162+
.set_property = apple_mfi_fc_set_property,
163+
.property_is_writeable = apple_mfi_fc_property_is_writeable
164+
};
165+
166+
static int mfi_fc_probe(struct usb_device *udev)
167+
{
168+
struct power_supply_config battery_cfg = {};
169+
struct mfi_device *mfi = NULL;
170+
int err;
171+
172+
/* See comment above mfi_fc_id_table[] */
173+
if (udev->descriptor.idProduct < 0x1200 ||
174+
udev->descriptor.idProduct > 0x12ff) {
175+
return -ENODEV;
176+
}
177+
178+
mfi = kzalloc(sizeof(struct mfi_device), GFP_KERNEL);
179+
if (!mfi) {
180+
err = -ENOMEM;
181+
goto error;
182+
}
183+
184+
battery_cfg.drv_data = mfi;
185+
186+
mfi->charge_type = POWER_SUPPLY_CHARGE_TYPE_TRICKLE;
187+
mfi->battery = power_supply_register(&udev->dev,
188+
&apple_mfi_fc_desc,
189+
&battery_cfg);
190+
if (IS_ERR(mfi->battery)) {
191+
dev_err(&udev->dev, "Can't register battery\n");
192+
err = PTR_ERR(mfi->battery);
193+
goto error;
194+
}
195+
196+
mfi->udev = usb_get_dev(udev);
197+
dev_set_drvdata(&udev->dev, mfi);
198+
199+
return 0;
200+
201+
error:
202+
kfree(mfi);
203+
return err;
204+
}
205+
206+
static void mfi_fc_disconnect(struct usb_device *udev)
207+
{
208+
struct mfi_device *mfi;
209+
210+
mfi = dev_get_drvdata(&udev->dev);
211+
if (mfi->battery)
212+
power_supply_unregister(mfi->battery);
213+
dev_set_drvdata(&udev->dev, NULL);
214+
usb_put_dev(mfi->udev);
215+
kfree(mfi);
216+
}
217+
218+
static struct usb_device_driver mfi_fc_driver = {
219+
.name = "apple-mfi-fastcharge",
220+
.probe = mfi_fc_probe,
221+
.disconnect = mfi_fc_disconnect,
222+
.id_table = mfi_fc_id_table,
223+
.generic_subclass = 1,
224+
};
225+
226+
static int __init mfi_fc_driver_init(void)
227+
{
228+
return usb_register_device_driver(&mfi_fc_driver, THIS_MODULE);
229+
}
230+
231+
static void __exit mfi_fc_driver_exit(void)
232+
{
233+
usb_deregister_device_driver(&mfi_fc_driver);
234+
}
235+
236+
module_init(mfi_fc_driver_init);
237+
module_exit(mfi_fc_driver_exit);

0 commit comments

Comments
 (0)