From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v3,2/3] Documentation: usb: add documentation for USB CCID Gadget Device From: Marcus Folkesson Message-Id: <20180530113459.GC2939@gmail.com> Date: Wed, 30 May 2018 13:34:59 +0200 To: Randy Dunlap Cc: Greg Kroah-Hartman , Jonathan Corbet , Felipe Balbi , davem@davemloft.net, Mauro Carvalho Chehab , Andrew Morton , Ruslan Bilovol , Thomas Gleixner , Kate Stewart , linux-usb@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org List-ID: SGkgUmFuZHksCgpPbiBUdWUsIE1heSAyOSwgMjAxOCBhdCAwMToyNzoyM1BNIC0wNzAwLCBSYW5k eSBEdW5sYXAgd3JvdGU6Cj4gT24gMDUvMjkvMjAxOCAxMTo1MCBBTSwgTWFyY3VzIEZvbGtlc3Nv biB3cm90ZToKPiA+IEFkZCBkb2N1bWVudGF0aW9uIHRvIGdpdmUgYSBicmllZiBkZXNjcmlwdGlv biBvbiBob3cgdG8gdXNlIHRoZQo+ID4gQ0NJRCBHYWRnZXQgRGV2aWNlLgo+ID4gVGhpcyBpbmNs dWRlcyBhIGRlc2NyaXB0aW9uIGZvciBhbGwgYXR0cmlidXRlcyBmb2xsb3dlZCBieSBhbiBleGFt cGxlIG9uCj4gPiBob3cgdG8gc2V0dXAgdGhlIGRldmljZSB3aXRoIENvbmZpZ0ZTLgo+ID4gCj4g PiBTaWduZWQtb2ZmLWJ5OiBNYXJjdXMgRm9sa2Vzc29uIDxtYXJjdXMuZm9sa2Vzc29uQGdtYWls LmNvbT4KPiA+IC0tLQo+ID4gCj4gPiBOb3RlczoKPiA+ICAgICB2MzoKPiA+ICAgICAJLSBjb3Jy ZWN0IHRoZSBncmFtbWVyICh0aGFua3MgUmFuZHkpCj4gPiAgICAgdjI6Cj4gPiAgICAgCS0gYWRk IHRoZSBtaXNzaW5nIGNoYW5nZWxvZyB0ZXh0Cj4gPiAKPiA+ICBEb2N1bWVudGF0aW9uL3VzYi9n YWRnZXRfY2NpZC5yc3QgfCAyNjcgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysKPiA+ICAxIGZpbGUgY2hhbmdlZCwgMjY3IGluc2VydGlvbnMoKykKPiA+ICBjcmVhdGUgbW9k ZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi91c2IvZ2FkZ2V0X2NjaWQucnN0Cj4gPiAKPiA+IGRpZmYg LS1naXQgYS9Eb2N1bWVudGF0aW9uL3VzYi9nYWRnZXRfY2NpZC5yc3QgYi9Eb2N1bWVudGF0aW9u L3VzYi9nYWRnZXRfY2NpZC5yc3QKPiA+IG5ldyBmaWxlIG1vZGUgMTAwNjQ0Cj4gPiBpbmRleCAw MDAwMDAwMDAwMDAuLjUyNGZlOWU2YWMxOQo+ID4gLS0tIC9kZXYvbnVsbAo+ID4gKysrIGIvRG9j dW1lbnRhdGlvbi91c2IvZ2FkZ2V0X2NjaWQucnN0Cj4gPiBAQCAtMCwwICsxLDI2NyBAQAo+ID4g Ky4uIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wCj4gPiArCj4gPiArPT09PT09PT09 PT09Cj4gPiArQ0NJRCBHYWRnZXQKPiA+ICs9PT09PT09PT09PT0KPiA+ICsKPiA+ICs6QXV0aG9y OiBNYXJjdXMgRm9sa2Vzc29uIDxtYXJjdXMuZm9sa2Vzc29uQGdtYWlsLmNvbT4KPiA+ICsKPiA+ ICtJbnRyb2R1Y3Rpb24KPiA+ICs9PT09PT09PT09PT0KPiA+ICsKPiA+ICtUaGUgQ0NJRCBHYWRn ZXQgd2lsbCBwcmVzZW50IGl0c2VsZiBhcyBhIENDSUQgZGV2aWNlIHRvIHRoZSBob3N0IHN5c3Rl bS4KPiA+ICtUaGUgZGV2aWNlIHN1cHBvcnRzIHR3byBlbmRwb2ludHMgZm9yIG5vdzsgQlVMSyBJ TiBhbmQgQlVMSyBPVVQuCj4gPiArVGhlc2UgZW5kcG9pbnRzIGFyZSBleHBvc2VkIHRvIHVzZXJz cGFjZSB2aWEgL2Rldi9jY2lkZyouCj4gPiArCj4gPiArQWxsIENDSUQgY29tbWFuZHMgYXJlIHNl bnQgb24gdGhlIEJVTEstT1VUIGVuZHBvaW50LiBFYWNoIGNvbW1hbmQgc2VudCB0byB0aGUgQ0NJ RAo+ID4gK2hhcyBhbiBhc3NvY2lhdGVkIGVuZGluZyByZXNwb25zZS4gU29tZSBjb21tYW5kcyBj YW4gYWxzbyBoYXZlIGludGVybWVkaWF0ZQo+ID4gK3Jlc3BvbnNlcy4gVGhlIHJlc3BvbnNlIGlz IHNlbnQgb24gdGhlIEJVTEstSU4gZW5kcG9pbnQuCj4gPiArU2VlIEZpZ3VyZSAzLTMgaW4gdGhl IENDSUQgU3BlY2lmaWNhdGlvbiBbMV1fIGZvciBtb3JlIGRldGFpbHMuCj4gPiArCj4gPiArVGhl IENDSUQgY29tbWFuZHMgbXVzdCBiZSBoYW5kbGVkIGluIHVzZXJzcGFjZSBzaW5jZSB0aGUgZHJp dmVyIGlzIG9ubHkgd29ya2luZwo+ID4gK2FzIGEgdHJhbnNwb3J0IGxheWVyIGZvciB0aGUgVFBE VXMuCj4gCj4gSSB0aGluayB0aGF0IGl0IHdvdWxkIGJlIGhlbHBmdWwgdG8gdGVsbCB1cyB3aGF0 IHRoZSBuYW1pbmcgb2YgdGhlIC9kZXYvY2NpZGcqCj4gZW5kcG9pbnRzIGxvb2tzIGxpa2UuICBB bHNvLCBob3cgdG8gZGlzdGluZ3Vpc2ggdGhlIEJVTEstSU4gZnJvbSB0aGUgQlVMSy1PVVQKPiBl bmRwb2ludC4KCllvdSBhcmUgcmlnaHQsIGl0IGlzIG5vdCBjbGVhci4KClRoZSBkZXZpY2VzIGFy ZSBuYW1lZCBhcyAvZGV2L2NjaWRnWzAtNF0gYW5kIGlzIHBlciBkZXZpY2UuCldyaXRpbmcvcmVh ZGluZyB0byB0aGUgZGV2aWNlIGlzIHVzaW5nIEJVTEstSU4vQlVMSy1PVVQsIHRoZSAvZGV2L2Nj aWRnKgpkZXZpY2UgaXMgbm90IGJvdW5kIHRvIGEgcGFydGljdWxhciBlbmRwb2ludC4KCkkgd2ls bCBjb21lIHVwIHdpdGggc29tZXRoaW5nIHRoYXQgbWFrZSBpdCBtb3JlIGNsZWFyLgoKVGhhbmsg eW91IQoKCj4gCj4gPiArCj4gPiArCj4gPiArQ0NJRCBDb21tYW5kcwo+ID4gKy0tLS0tLS0tLS0t LS0tCj4gPiArCj4gPiArQWxsIENDSUQgY29tbWFuZHMgYmVnaW5zIHdpdGggYSAxMC1ieXRlIGhl YWRlciBmb2xsb3dlZCBieSBhbiBvcHRpb25hbAo+ID4gK2RhdGEgZmllbGQgZGVwZW5kaW5nIG9u IG1lc3NhZ2UgdHlwZS4KPiA+ICsKPiA+ICsrLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0rLS0tLS0t LSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKwo+ID4gK3wgT2Zmc2V0IHwgRmll bGQgICAgICAgIHwgU2l6ZSAgfCBEZXNjcmlwdGlvbiAgICAgICAgICAgICAgICAgICAgICB8Cj4g PiArKz09PT09PT09Kz09PT09PT09PT09PT09Kz09PT09PT0rPT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PSsKPiA+ICt8IDAgICAgICB8IGJNZXNzYWdlVHlwZSB8IDEgICAgIHwgVHlw ZSBvZiBtZXNzYWdlICAgICAgICAgICAgICAgICAgfAo+ID4gKystLS0tLS0tLSstLS0tLS0tLS0t LS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gPiArfCAx ICAgICAgfCBkd0xlbmd0aCAgICAgfCA0ICAgICB8IE1lc3NhZ2Ugc3BlY2lmaWMgZGF0YSBsZW5n dGggICAgIHwKPiA+ICt8ICAgICAgICB8ICAgICAgICAgICAgICB8ICAgICAgIHwgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgfAo+ID4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSst LS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gPiArfCA1ICAgICAg fCBiU2xvdCAgICAgICAgfCAxICAgICB8IElkZW50aWZpZXMgdGhlIHNsb3QgbnVtYmVyICAgICAg IHwKPiA+ICt8ICAgICAgICB8ICAgICAgICAgICAgICB8ICAgICAgIHwgZm9yIHRoaXMgY29tbWFu ZCAgICAgICAgICAgICAgICAgfAo+ID4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0t Ky0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gPiArfCA2ICAgICAgfCBiU2Vx ICAgICAgICAgfCAxICAgICB8IFNlcXVlbmNlIG51bWJlciBmb3IgY29tbWFuZCAgICAgIHwKPiA+ ICsrLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0rLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tKwo+ID4gK3wgNyAgICAgIHwgLi4uICAgICAgICAgIHwgMyAgICAgfCBGaWVs ZHMgZGVwZW5kcyBvbiBtZXNzYWdlIHR5cGUgICB8Cj4gPiArKy0tLS0tLS0tKy0tLS0tLS0tLS0t LS0tKy0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKPiA+ICt8IDEw ICAgICB8IGFiRGF0YSAgICAgICB8IGFycmF5IHwgTWVzc2FnZSBzcGVjaWZpYyBkYXRhIChPUFRJ T05BTCkgfAo+ID4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gPiArCj4gPiArCj4gPiArTXVsdGlwbGUgQ0NJRCBn YWRnZXRzCj4gPiArLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQo+ID4gKwo+ID4gK0l0IGlzIHBvc3Np YmxlIHRvIGNyZWF0ZSBtdWx0aXBsZSBpbnN0YW5jZXMgb2YgdGhlIENDSUQgZ2FkZ2V0LCBob3dl dmVyLAo+ID4gK2EgbXVjaCBtb3JlIGZsZXhpYmxlIHdheSBpcyB0byBjcmVhdGUgb25lIGdhZGdl dCBhbmQgc2V0IHRoZSBgbnNsb3RzYCBhdHRyaWJ1dGUKPiA+ICt0byB0aGUgbnVtYmVyIG9mIGRl c2lyZWQgQ0NJRCBkZXZpY2VzLgo+ID4gKwo+ID4gK0FsbCBDQ0lEIGNvbW1hbmRzIHNwZWNpZnkg d2hpY2ggc2xvdCBpcyB0aGUgcmVjZWl2ZXIgaW4gdGhlIGBiU2xvdGAgZmllbGQKPiA+ICtvZiB0 aGUgQ0NJRCBoZWFkZXIuCj4gPiArCj4gPiArVXNhZ2UKPiA+ICs9PT09PQo+ID4gKwo+ID4gK0Fj Y2VzcyBmcm9tIHVzZXJzcGFjZQo+ID4gKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiA+ICtBbGwg Y29tbXVuaWNhdGlvbiBpcyBieSByZWFkKDIpIGFuZCB3cml0ZSgyKSB0byB0aGUgY29ycmVzcG9u ZGluZyAvZGV2L2NjaWRnKiBkZXZpY2UuCj4gPiArT25seSBvbmUgZmlsZSBkZXNjcmlwdG9yIGlz IGFsbG93ZWQgdG8gYmUgb3BlbiB0byB0aGUgZGV2aWNlIGF0IGEgdGltZS4KPiAKPiAKPiBSZXZp ZXdlZC1ieTogUmFuZHkgRHVubGFwIDxyZHVubGFwQGluZnJhZGVhZC5vcmc+Cj4gCj4gCj4gdGhh bmtzLAo+IC0tIAo+IH5SYW5keQoKQmVzdCByZWdhcmRzLApNYXJjdXMgRm9sa2Vzc29uCi0tLQpU byB1bnN1YnNjcmliZSBmcm9tIHRoaXMgbGlzdDogc2VuZCB0aGUgbGluZSAidW5zdWJzY3JpYmUg bGludXgtdXNiIiBpbgp0aGUgYm9keSBvZiBhIG1lc3NhZ2UgdG8gbWFqb3Jkb21vQHZnZXIua2Vy bmVsLm9yZwpNb3JlIG1ham9yZG9tbyBpbmZvIGF0ICBodHRwOi8vdmdlci5rZXJuZWwub3JnL21h am9yZG9tby1pbmZvLmh0bWwK