Home | History | Annotate | Download | only in usb 
      1 /*
      2  * Gadget Function Driver for Android USB accessories
      3  *
      4  * Copyright (C) 2011 Google, Inc.
      5  * Author: Mike Lockwood <lockwood (at) android.com>
      6  *
      7  * This software is licensed under the terms of the GNU General Public
      8  * License version 2, as published by the Free Software Foundation, and
      9  * may be copied, distributed, and modified under those terms.
     10  *
     11  * This program is distributed in the hope that it will be useful,
     12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
     13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     14  * GNU General Public License for more details.
     15  *
     16  */
     17 
     18 #ifndef __LINUX_USB_F_ACCESSORY_H
     19 #define __LINUX_USB_F_ACCESSORY_H
     20 
     21 /* Use Google Vendor ID when in accessory mode */
     22 #define USB_ACCESSORY_VENDOR_ID 0x18D1
     23 
     24 
     25 /* Product ID to use when in accessory mode */
     26 #define USB_ACCESSORY_PRODUCT_ID 0x2D00
     27 
     28 /* Product ID to use when in accessory mode and adb is enabled */
     29 #define USB_ACCESSORY_ADB_PRODUCT_ID 0x2D01
     30 
     31 /* Indexes for strings sent by the host via ACCESSORY_SEND_STRING */
     32 #define ACCESSORY_STRING_MANUFACTURER   0
     33 #define ACCESSORY_STRING_MODEL          1
     34 #define ACCESSORY_STRING_DESCRIPTION    2
     35 #define ACCESSORY_STRING_VERSION        3
     36 #define ACCESSORY_STRING_URI            4
     37 #define ACCESSORY_STRING_SERIAL         5
     38 
     39 /* Control request for retrieving device's protocol version (currently 1)
     40  *
     41  *	requestType:    USB_DIR_IN | USB_TYPE_VENDOR
     42  *	request:        ACCESSORY_GET_PROTOCOL
     43  *	value:          0
     44  *	index:          0
     45  *	data            version number (16 bits little endian)
     46  */
     47 #define ACCESSORY_GET_PROTOCOL  51
     48 
     49 /* Control request for host to send a string to the device
     50  *
     51  *	requestType:    USB_DIR_OUT | USB_TYPE_VENDOR
     52  *	request:        ACCESSORY_SEND_STRING
     53  *	value:          0
     54  *	index:          string ID
     55  *	data            zero terminated UTF8 string
     56  *
     57  *  The device can later retrieve these strings via the
     58  *  ACCESSORY_GET_STRING_* ioctls
     59  */
     60 #define ACCESSORY_SEND_STRING   52
     61 
     62 /* Control request for starting device in accessory mode.
     63  * The host sends this after setting all its strings to the device.
     64  *
     65  *	requestType:    USB_DIR_OUT | USB_TYPE_VENDOR
     66  *	request:        ACCESSORY_START
     67  *	value:          0
     68  *	index:          0
     69  *	data            none
     70  */
     71 #define ACCESSORY_START         53
     72 
     73 /* ioctls for retrieving strings set by the host */
     74 #define ACCESSORY_GET_STRING_MANUFACTURER   _IOW('M', 1, char[256])
     75 #define ACCESSORY_GET_STRING_MODEL          _IOW('M', 2, char[256])
     76 #define ACCESSORY_GET_STRING_DESCRIPTION    _IOW('M', 3, char[256])
     77 #define ACCESSORY_GET_STRING_VERSION        _IOW('M', 4, char[256])
     78 #define ACCESSORY_GET_STRING_URI            _IOW('M', 5, char[256])
     79 #define ACCESSORY_GET_STRING_SERIAL         _IOW('M', 6, char[256])
     80 /* returns 1 if there is a start request pending */
     81 #define ACCESSORY_IS_START_REQUESTED        _IO('M', 7)
     82 
     83 #endif /* __LINUX_USB_F_ACCESSORY_H */
     84