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