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: Randy Dunlap Message-Id: Date: Tue, 29 May 2018 13:27:23 -0700 To: Marcus Folkesson , Greg Kroah-Hartman , Jonathan Corbet , Felipe Balbi , davem@davemloft.net, Mauro Carvalho Chehab , Andrew Morton , Ruslan Bilovol , Thomas Gleixner , Kate Stewart Cc: linux-usb@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org List-ID: T24gMDUvMjkvMjAxOCAxMTo1MCBBTSwgTWFyY3VzIEZvbGtlc3NvbiB3cm90ZToKPiBBZGQgZG9j dW1lbnRhdGlvbiB0byBnaXZlIGEgYnJpZWYgZGVzY3JpcHRpb24gb24gaG93IHRvIHVzZSB0aGUK PiBDQ0lEIEdhZGdldCBEZXZpY2UuCj4gVGhpcyBpbmNsdWRlcyBhIGRlc2NyaXB0aW9uIGZvciBh bGwgYXR0cmlidXRlcyBmb2xsb3dlZCBieSBhbiBleGFtcGxlIG9uCj4gaG93IHRvIHNldHVwIHRo ZSBkZXZpY2Ugd2l0aCBDb25maWdGUy4KPiAKPiBTaWduZWQtb2ZmLWJ5OiBNYXJjdXMgRm9sa2Vz c29uIDxtYXJjdXMuZm9sa2Vzc29uQGdtYWlsLmNvbT4KPiAtLS0KPiAKPiBOb3RlczoKPiAgICAg djM6Cj4gICAgIAktIGNvcnJlY3QgdGhlIGdyYW1tZXIgKHRoYW5rcyBSYW5keSkKPiAgICAgdjI6 Cj4gICAgIAktIGFkZCB0aGUgbWlzc2luZyBjaGFuZ2Vsb2cgdGV4dAo+IAo+ICBEb2N1bWVudGF0 aW9uL3VzYi9nYWRnZXRfY2NpZC5yc3QgfCAyNjcgKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysKPiAgMSBmaWxlIGNoYW5nZWQsIDI2NyBpbnNlcnRpb25zKCspCj4gIGNyZWF0 ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL3VzYi9nYWRnZXRfY2NpZC5yc3QKPiAKPiBkaWZm IC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi91c2IvZ2FkZ2V0X2NjaWQucnN0IGIvRG9jdW1lbnRhdGlv bi91c2IvZ2FkZ2V0X2NjaWQucnN0Cj4gbmV3IGZpbGUgbW9kZSAxMDA2NDQKPiBpbmRleCAwMDAw MDAwMDAwMDAuLjUyNGZlOWU2YWMxOQo+IC0tLSAvZGV2L251bGwKPiArKysgYi9Eb2N1bWVudGF0 aW9uL3VzYi9nYWRnZXRfY2NpZC5yc3QKPiBAQCAtMCwwICsxLDI2NyBAQAo+ICsuLiBTUERYLUxp Y2Vuc2UtSWRlbnRpZmllcjogR1BMLTIuMAo+ICsKPiArPT09PT09PT09PT09Cj4gK0NDSUQgR2Fk Z2V0Cj4gKz09PT09PT09PT09PQo+ICsKPiArOkF1dGhvcjogTWFyY3VzIEZvbGtlc3NvbiA8bWFy Y3VzLmZvbGtlc3NvbkBnbWFpbC5jb20+Cj4gKwo+ICtJbnRyb2R1Y3Rpb24KPiArPT09PT09PT09 PT09Cj4gKwo+ICtUaGUgQ0NJRCBHYWRnZXQgd2lsbCBwcmVzZW50IGl0c2VsZiBhcyBhIENDSUQg ZGV2aWNlIHRvIHRoZSBob3N0IHN5c3RlbS4KPiArVGhlIGRldmljZSBzdXBwb3J0cyB0d28gZW5k cG9pbnRzIGZvciBub3c7IEJVTEsgSU4gYW5kIEJVTEsgT1VULgo+ICtUaGVzZSBlbmRwb2ludHMg YXJlIGV4cG9zZWQgdG8gdXNlcnNwYWNlIHZpYSAvZGV2L2NjaWRnKi4KPiArCj4gK0FsbCBDQ0lE IGNvbW1hbmRzIGFyZSBzZW50IG9uIHRoZSBCVUxLLU9VVCBlbmRwb2ludC4gRWFjaCBjb21tYW5k IHNlbnQgdG8gdGhlIENDSUQKPiAraGFzIGFuIGFzc29jaWF0ZWQgZW5kaW5nIHJlc3BvbnNlLiBT b21lIGNvbW1hbmRzIGNhbiBhbHNvIGhhdmUgaW50ZXJtZWRpYXRlCj4gK3Jlc3BvbnNlcy4gVGhl IHJlc3BvbnNlIGlzIHNlbnQgb24gdGhlIEJVTEstSU4gZW5kcG9pbnQuCj4gK1NlZSBGaWd1cmUg My0zIGluIHRoZSBDQ0lEIFNwZWNpZmljYXRpb24gWzFdXyBmb3IgbW9yZSBkZXRhaWxzLgo+ICsK PiArVGhlIENDSUQgY29tbWFuZHMgbXVzdCBiZSBoYW5kbGVkIGluIHVzZXJzcGFjZSBzaW5jZSB0 aGUgZHJpdmVyIGlzIG9ubHkgd29ya2luZwo+ICthcyBhIHRyYW5zcG9ydCBsYXllciBmb3IgdGhl IFRQRFVzLgoKSSB0aGluayB0aGF0IGl0IHdvdWxkIGJlIGhlbHBmdWwgdG8gdGVsbCB1cyB3aGF0 IHRoZSBuYW1pbmcgb2YgdGhlIC9kZXYvY2NpZGcqCmVuZHBvaW50cyBsb29rcyBsaWtlLiAgQWxz bywgaG93IHRvIGRpc3Rpbmd1aXNoIHRoZSBCVUxLLUlOIGZyb20gdGhlIEJVTEstT1VUCmVuZHBv aW50LgoKPiArCj4gKwo+ICtDQ0lEIENvbW1hbmRzCj4gKy0tLS0tLS0tLS0tLS0tCj4gKwo+ICtB bGwgQ0NJRCBjb21tYW5kcyBiZWdpbnMgd2l0aCBhIDEwLWJ5dGUgaGVhZGVyIGZvbGxvd2VkIGJ5 IGFuIG9wdGlvbmFsCj4gK2RhdGEgZmllbGQgZGVwZW5kaW5nIG9uIG1lc3NhZ2UgdHlwZS4KPiAr Cj4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0rCj4gK3wgT2Zmc2V0IHwgRmllbGQgICAgICAgIHwgU2l6ZSAgfCBEZXNj cmlwdGlvbiAgICAgICAgICAgICAgICAgICAgICB8Cj4gKys9PT09PT09PSs9PT09PT09PT09PT09 PSs9PT09PT09Kz09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0rCj4gK3wgMCAgICAg IHwgYk1lc3NhZ2VUeXBlIHwgMSAgICAgfCBUeXBlIG9mIG1lc3NhZ2UgICAgICAgICAgICAgICAg ICB8Cj4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0rCj4gK3wgMSAgICAgIHwgZHdMZW5ndGggICAgIHwgNCAgICAgfCBN ZXNzYWdlIHNwZWNpZmljIGRhdGEgbGVuZ3RoICAgICB8Cj4gK3wgICAgICAgIHwgICAgICAgICAg ICAgIHwgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8Cj4gKystLS0t LS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0rCj4gK3wgNSAgICAgIHwgYlNsb3QgICAgICAgIHwgMSAgICAgfCBJZGVudGlmaWVzIHRo ZSBzbG90IG51bWJlciAgICAgICB8Cj4gK3wgICAgICAgIHwgICAgICAgICAgICAgIHwgICAgICAg fCBmb3IgdGhpcyBjb21tYW5kICAgICAgICAgICAgICAgICB8Cj4gKystLS0tLS0tLSstLS0tLS0t LS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gK3wg NiAgICAgIHwgYlNlcSAgICAgICAgIHwgMSAgICAgfCBTZXF1ZW5jZSBudW1iZXIgZm9yIGNvbW1h bmQgICAgICB8Cj4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gK3wgNyAgICAgIHwgLi4uICAgICAgICAgIHwgMyAg ICAgfCBGaWVsZHMgZGVwZW5kcyBvbiBtZXNzYWdlIHR5cGUgICB8Cj4gKystLS0tLS0tLSstLS0t LS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4g K3wgMTAgICAgIHwgYWJEYXRhICAgICAgIHwgYXJyYXkgfCBNZXNzYWdlIHNwZWNpZmljIGRhdGEg KE9QVElPTkFMKSB8Cj4gKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCj4gKwo+ICsKPiArTXVsdGlwbGUgQ0NJRCBnYWRn ZXRzCj4gKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiArCj4gK0l0IGlzIHBvc3NpYmxlIHRvIGNy ZWF0ZSBtdWx0aXBsZSBpbnN0YW5jZXMgb2YgdGhlIENDSUQgZ2FkZ2V0LCBob3dldmVyLAo+ICth IG11Y2ggbW9yZSBmbGV4aWJsZSB3YXkgaXMgdG8gY3JlYXRlIG9uZSBnYWRnZXQgYW5kIHNldCB0 aGUgYG5zbG90c2AgYXR0cmlidXRlCj4gK3RvIHRoZSBudW1iZXIgb2YgZGVzaXJlZCBDQ0lEIGRl dmljZXMuCj4gKwo+ICtBbGwgQ0NJRCBjb21tYW5kcyBzcGVjaWZ5IHdoaWNoIHNsb3QgaXMgdGhl IHJlY2VpdmVyIGluIHRoZSBgYlNsb3RgIGZpZWxkCj4gK29mIHRoZSBDQ0lEIGhlYWRlci4KPiAr Cj4gK1VzYWdlCj4gKz09PT09Cj4gKwo+ICtBY2Nlc3MgZnJvbSB1c2Vyc3BhY2UKPiArLS0tLS0t LS0tLS0tLS0tLS0tLS0tLQo+ICtBbGwgY29tbXVuaWNhdGlvbiBpcyBieSByZWFkKDIpIGFuZCB3 cml0ZSgyKSB0byB0aGUgY29ycmVzcG9uZGluZyAvZGV2L2NjaWRnKiBkZXZpY2UuCj4gK09ubHkg b25lIGZpbGUgZGVzY3JpcHRvciBpcyBhbGxvd2VkIHRvIGJlIG9wZW4gdG8gdGhlIGRldmljZSBh dCBhIHRpbWUuCgoKUmV2aWV3ZWQtYnk6IFJhbmR5IER1bmxhcCA8cmR1bmxhcEBpbmZyYWRlYWQu b3JnPgoKCnRoYW5rcywK