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: [v2,2/3] Documentation: usb: add documentation for USB CCID Gadget Device From: Marcus Folkesson Message-Id: <20180528074258.GA4651@gmail.com> Date: Mon, 28 May 2018 09:42:58 +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: SGkgUmFuZHksCgpPbiBTdW4sIE1heSAyNywgMjAxOCBhdCAwNDozNjoyNFBNIC0wNzAwLCBSYW5k eSBEdW5sYXAgd3JvdGU6Cj4gSGksCj4gCj4gSSBoYXZlIGEgZmV3IGRvY3VtZW50YXRpb24gY29t bWVudHMgYmVsb3cuLi4KPiAKPiBPbiAwNS8yNi8yMDE4IDAyOjE5IFBNLCBNYXJjdXMgRm9sa2Vz c29uIHdyb3RlOgo+ID4gQWRkIGRvY3VtZW50YXRpb24gdG8gZ2l2ZSBhIGJyaWVmIGRlc2NyaXB0 aW9uIG9uIGhvdyB0byB1c2UgdGhlCj4gPiBDQ0lEIEdhZGdldCBEZXZpY2UuCj4gPiBUaGlzIGlu Y2x1ZGVzIGEgZGVzY3JpcHRpb24gZm9yIGFsbCBhdHRyaWJ1dGVzIGZvbGxvd2VkIGJ5IGFuIGV4 YW1wbGUgb24KPiA+IGhvdyB0byBzZXR1cCB0aGUgZGV2aWNlIHdpdGggQ29uZmlnRlMuCj4gPiAK PiA+IFNpZ25lZC1vZmYtYnk6IE1hcmN1cyBGb2xrZXNzb24gPG1hcmN1cy5mb2xrZXNzb25AZ21h aWwuY29tPgo+ID4gLS0tCj4gPiAgRG9jdW1lbnRhdGlvbi91c2IvZ2FkZ2V0X2NjaWQucnN0IHwg MjY3ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrCj4gPiAgMSBmaWxlIGNo YW5nZWQsIDI2NyBpbnNlcnRpb25zKCspCj4gPiAgY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50 YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdAo+ID4gCj4gPiBkaWZmIC0tZ2l0IGEvRG9jdW1lbnRh dGlvbi91c2IvZ2FkZ2V0X2NjaWQucnN0IGIvRG9jdW1lbnRhdGlvbi91c2IvZ2FkZ2V0X2NjaWQu cnN0Cj4gPiBuZXcgZmlsZSBtb2RlIDEwMDY0NAo+ID4gaW5kZXggMDAwMDAwMDAwMDAwLi41YWM4 MDZiMTQ2MDQKPiA+IC0tLSAvZGV2L251bGwKPiA+ICsrKyBiL0RvY3VtZW50YXRpb24vdXNiL2dh ZGdldF9jY2lkLnJzdAo+ID4gQEAgLTAsMCArMSwyNjcgQEAKPiA+ICsuLiBTUERYLUxpY2Vuc2Ut SWRlbnRpZmllcjogR1BMLTIuMAo+ID4gKwo+ID4gKz09PT09PT09PT09PQo+ID4gK0NDSUQgR2Fk Z2V0Cj4gPiArPT09PT09PT09PT09Cj4gPiArCj4gPiArOkF1dGhvcjogTWFyY3VzIEZvbGtlc3Nv biA8bWFyY3VzLmZvbGtlc3NvbkBnbWFpbC5jb20+Cj4gPiArCj4gPiArSW50cm9kdWN0aW9uCj4g PiArPT09PT09PT09PT09Cj4gPiArCj4gPiArVGhlIENDSUQgR2FkZ2V0IHdpbGwgcHJlc2VudCBp dHNlbGYgYXMgYSBDQ0lEIGRldmljZSB0byB0aGUgaG9zdCBzeXN0ZW0uCj4gPiArVGhlIGRldmlj ZSBzdXBwb3J0cyB0d28gZW5kcG9pbnRzIGZvciBub3c7IEJVTEsgSU4gYW5kIEJVTEsgT1VULgo+ ID4gK1RoZXNlIGVuZHBvaW50cyBpcyBleHBvc2VkIHRvIHVzZXJzcGFjZSB2aWEgL2Rldi9jY2lk ZyouCj4gCj4gICAgICAgICAgICAgICAgICAgIGFyZSBleHBvc2VkCj4gCj4gPiArCj4gPiArQWxs IENDSUQgY29tbWFuZHMgYXJlIHNlbnQgb24gdGhlIEJVTEstT1VUIGVuZHBvaW50LiBFYWNoIGNv bW1hbmQgc2VudCB0byB0aGUgQ0NJRAo+ID4gK2hhcyBhbiBhc3NvY2lhdGVkIGVuZGluZyByZXNw b25zZS4gU29tZSBjb21tYW5kcyBjYW4gYWxzbyBoYXZlIGludGVybWVkaWF0ZQo+ID4gK3Jlc3Bv bnNlcy4gVGhlIHJlc3BvbnNlIGlzIHNlbnQgb24gdGhlIEJVTEstSU4gZW5kcG9pbnQuCj4gPiAr U2VlIEZpZ3VyZSAzLTMgaW4gdGhlIENDSUQgU3BlY2lmaWNhdGlvbiBbMV1fIGZvciBtb3JlIGRl dGFpbHMuCj4gPiArCj4gPiArVGhlIENDSUQgY29tbWFuZHMgbXVzdCBiZSBoYW5kbGVkIGluIHVz ZXJzcGFjZSBzaW5jZSB0aGUgZHJpdmVyIGlzIG9ubHkgd29ya2luZwo+ID4gK2FzIGEgdHJhbnNw b3J0IGxheWVyIGZvciB0aGUgVFBEVXMuCj4gPiArCj4gPiArCj4gPiArQ0NJRCBDb21tYW5kcwo+ ID4gKy0tLS0tLS0tLS0tLS0tCj4gPiArCj4gPiArQWxsIENDSUQgY29tbWFuZHMgYmVnaW5zIHdp dGggYSAxMCBieXRlcyBoZWFkZXIgZm9sbG93ZWQgYnkgYW4gb3B0aW9uYWwKPiAKPiAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgd2l0aCBhIDEwLWJ5dGUgaGVhZGVyCj4gKG9yIG1heWJlIHRo YXQncyBhIGxvY2FsZSBkaWZmZXJlbmNlKQo+IAo+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+ID4gK0FsbCBDQ0lEIGNvbW1hbmRzIHNwZWNpZmll cyB3aGljaCBzbG90IHRoYXQgaXMgdGhlIHJlY2VpdmVyIGluIHRoZSBgYlNsb3RgIGZpZWxkCj4g Cj4gICAgICAgICAgICAgICAgICAgICAgc3BlY2lmeSB3aGljaCBzbG90IGlzIHRoZSByZWNlaXZl cgo+IAo+ID4gK29mIHRoZSBDQ0lEIGhlYWRlci4KPiA+ICsKPiA+ICtVc2FnZQo+ID4gKz09PT09 Cj4gPiArCj4gPiArQWNjZXNzIGZyb20gdXNlcnNwYWNlCj4gPiArLS0tLS0tLS0tLS0tLS0tLS0t LS0tLQo+ID4gK0FsbCBjb21tdW5pY2F0aW9uIGlzIGJ5IHJlYWQoMikgYW5kIHdyaXRlKDIpIHRv IHRoZSBjb3JyZXNwb25kaW5nIC9kZXYvY2NpZGcqIGRldmljZS4KPiA+ICtPbmx5IG9uZSBmaWxl ZGVzY3JpcHRvciBpcyBhbGxvd2VkIHRvIGJlIG9wZW4gdG8gdGhlIGRldmljZSBhdCBhIHRpbWUu Cj4gCj4gICAgICAgICAgICAgZmlsZSBkZXNjcmlwdG9yCj4gCj4gPiArCj4gPiArVGhlIGJ1ZmZl ciBzaXplIHByb3ZpZGVkIHRvIHJlYWQoMikgKiptdXN0IGJlIGF0IGxlYXN0KiogNTIyICgxMCBi eXRlcyBoZWFkZXIgKyA1MTIgYnl0ZXMgcGF5bG9hZCkKPiA+ICtieXRlcyBhcyB3ZSBhcmUgd29y a2luZyB3aXRoIHdob2xlIGNvbW1hbmRzLgo+ID4gKwo+ID4gK1RoZSBidWZmZXIgc2l6ZSBwcm92 aWRlZCB0byB3cml0ZSgyKSAqKm1heSBub3QgZXhjZWVkKiogNTIyICgxMCBieXRlcyBoZWFkZXIg KyA1MTIgYnl0ZXMgcGF5bG9hZCkKPiA+ICtieXRlcyBhcyB3ZSBhcmUgd29ya2luZyB3aXRoIHdo b2xlIGNvbW1hbmRzLgo+ID4gKwo+ID4gKwo+ID4gK0NvbmZpZ3VyYXRpb24gd2l0aCBjb25maWdm cwo+ID4gKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiA+ICsKPiA+ICtDb25maWdGUyBp cyB1c2VkIHRvIGNyZWF0ZSBhbmQgY29uZmlndXJlIHRoZSBDQ0lEIGdhZGdldC4KPiA+ICtJbiBv cmRlciB0byBnZXQgYSBkZXZpY2UgdG8gd29yayBhcyBpbnRlbmRlZCwgYSBmZXcgYXR0cmlidXRl cyBtdXN0Cj4gPiArYmUgY29uc2lkZXJlZC4KPiA+ICsKPiA+ICtUaGUgYXR0cmlidXRlcyBpcyBk ZXNjcmliZWQgYmVsb3cgZm9sbG93ZWQgYnkgYW4gZXhhbXBsZS4KPiAKPiAgICAgICAgICAgICAg ICAgICBhcmUKPiAKPiA+ICsKPiA+ICtmZWF0dXJlcwo+ID4gK35+fn5+fn5+fgo+ID4gKwo+ID4g K1RoZSBgZmVhdHVyZWAgYXR0cmlidXRlIHdyaXRlcyB0byB0aGUgZHdGZWF0dXJlcyBmaWVsZCBp biB0aGUgY2xhc3MgZGVzY3JpcHRvci4KPiA+ICtTZWUgVGFibGUgNS4xLTEgU21hcnQgQ2FyZCBE ZXZpY2UgRGVzY3JpcHRvcnMgaW4gdGhlIENDSUQgU3BlY2lmaWNhdGlvbiBbMV1fLgo+ID4gKwo+ ID4gK1RoZSB2YWx1ZSBpbmRpY2F0ZXMgd2hhdCBpbnRlbGxpZ2VudCBmZWF0dXJlcyB0aGUgQ0NJ RCBoYXMuCj4gPiArVGhlc2UgdmFsdWVzIGFyZSBhdmFpbGFibGUgdG8gdXNlciBhcHBsaWNhdGlv biBhcyBkZWZpbmVzIGluIGNjaWQuaCBbMl1fLgo+IAo+ICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgYXMgZGVmaW5lZAo+IAo+ID4gK1RoZSBkZWZhdWx0 IHZhbHVlIGlzIDB4MDAwMDAwMDAuCj4gCj4gCj4gW3NuaXBdCj4gCj4gSFRILgo+IC0tIAo+IH5S YW5keQoKVGhhbmsgeW91IGZvciB5b3VyIGNvbW1lbnRzLCBJIHdpbGwgdGFrZSBpdCB3aXRoIG1l IGZvciB2My4KCkJlc3QgcmVnYXJkcwpNYXJjdXMgRm9sa2Vzc29uCi0tLQpUbyB1bnN1YnNjcmli ZSBmcm9tIHRoaXMgbGlzdDogc2VuZCB0aGUgbGluZSAidW5zdWJzY3JpYmUgbGludXgtdXNiIiBp bgp0aGUgYm9keSBvZiBhIG1lc3NhZ2UgdG8gbWFqb3Jkb21vQHZnZXIua2VybmVsLm9yZwpNb3Jl IG1ham9yZG9tbyBpbmZvIGF0ICBodHRwOi8vdmdlci5rZXJuZWwub3JnL21ham9yZG9tby1pbmZv Lmh0bWwK