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: Randy Dunlap Message-Id: <2225254e-a8f1-570e-8b1c-f68168376784@infradead.org> Date: Sun, 27 May 2018 16:36:24 -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: SGksCgpJIGhhdmUgYSBmZXcgZG9jdW1lbnRhdGlvbiBjb21tZW50cyBiZWxvdy4uLgoKT24gMDUv MjYvMjAxOCAwMjoxOSBQTSwgTWFyY3VzIEZvbGtlc3NvbiB3cm90ZToKPiBBZGQgZG9jdW1lbnRh dGlvbiB0byBnaXZlIGEgYnJpZWYgZGVzY3JpcHRpb24gb24gaG93IHRvIHVzZSB0aGUKPiBDQ0lE IEdhZGdldCBEZXZpY2UuCj4gVGhpcyBpbmNsdWRlcyBhIGRlc2NyaXB0aW9uIGZvciBhbGwgYXR0 cmlidXRlcyBmb2xsb3dlZCBieSBhbiBleGFtcGxlIG9uCj4gaG93IHRvIHNldHVwIHRoZSBkZXZp Y2Ugd2l0aCBDb25maWdGUy4KPiAKPiBTaWduZWQtb2ZmLWJ5OiBNYXJjdXMgRm9sa2Vzc29uIDxt YXJjdXMuZm9sa2Vzc29uQGdtYWlsLmNvbT4KPiAtLS0KPiAgRG9jdW1lbnRhdGlvbi91c2IvZ2Fk Z2V0X2NjaWQucnN0IHwgMjY3ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr Cj4gIDEgZmlsZSBjaGFuZ2VkLCAyNjcgaW5zZXJ0aW9ucygrKQo+ICBjcmVhdGUgbW9kZSAxMDA2 NDQgRG9jdW1lbnRhdGlvbi91c2IvZ2FkZ2V0X2NjaWQucnN0Cj4gCj4gZGlmZiAtLWdpdCBhL0Rv Y3VtZW50YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdCBiL0RvY3VtZW50YXRpb24vdXNiL2dhZGdl dF9jY2lkLnJzdAo+IG5ldyBmaWxlIG1vZGUgMTAwNjQ0Cj4gaW5kZXggMDAwMDAwMDAwMDAwLi41 YWM4MDZiMTQ2MDQKPiAtLS0gL2Rldi9udWxsCj4gKysrIGIvRG9jdW1lbnRhdGlvbi91c2IvZ2Fk Z2V0X2NjaWQucnN0Cj4gQEAgLTAsMCArMSwyNjcgQEAKPiArLi4gU1BEWC1MaWNlbnNlLUlkZW50 aWZpZXI6IEdQTC0yLjAKPiArCj4gKz09PT09PT09PT09PQo+ICtDQ0lEIEdhZGdldAo+ICs9PT09 PT09PT09PT0KPiArCj4gKzpBdXRob3I6IE1hcmN1cyBGb2xrZXNzb24gPG1hcmN1cy5mb2xrZXNz b25AZ21haWwuY29tPgo+ICsKPiArSW50cm9kdWN0aW9uCj4gKz09PT09PT09PT09PQo+ICsKPiAr VGhlIENDSUQgR2FkZ2V0IHdpbGwgcHJlc2VudCBpdHNlbGYgYXMgYSBDQ0lEIGRldmljZSB0byB0 aGUgaG9zdCBzeXN0ZW0uCj4gK1RoZSBkZXZpY2Ugc3VwcG9ydHMgdHdvIGVuZHBvaW50cyBmb3Ig bm93OyBCVUxLIElOIGFuZCBCVUxLIE9VVC4KPiArVGhlc2UgZW5kcG9pbnRzIGlzIGV4cG9zZWQg dG8gdXNlcnNwYWNlIHZpYSAvZGV2L2NjaWRnKi4KCiAgICAgICAgICAgICAgICAgICBhcmUgZXhw b3NlZAoKPiArCj4gK0FsbCBDQ0lEIGNvbW1hbmRzIGFyZSBzZW50IG9uIHRoZSBCVUxLLU9VVCBl bmRwb2ludC4gRWFjaCBjb21tYW5kIHNlbnQgdG8gdGhlIENDSUQKPiAraGFzIGFuIGFzc29jaWF0 ZWQgZW5kaW5nIHJlc3BvbnNlLiBTb21lIGNvbW1hbmRzIGNhbiBhbHNvIGhhdmUgaW50ZXJtZWRp YXRlCj4gK3Jlc3BvbnNlcy4gVGhlIHJlc3BvbnNlIGlzIHNlbnQgb24gdGhlIEJVTEstSU4gZW5k cG9pbnQuCj4gK1NlZSBGaWd1cmUgMy0zIGluIHRoZSBDQ0lEIFNwZWNpZmljYXRpb24gWzFdXyBm b3IgbW9yZSBkZXRhaWxzLgo+ICsKPiArVGhlIENDSUQgY29tbWFuZHMgbXVzdCBiZSBoYW5kbGVk IGluIHVzZXJzcGFjZSBzaW5jZSB0aGUgZHJpdmVyIGlzIG9ubHkgd29ya2luZwo+ICthcyBhIHRy YW5zcG9ydCBsYXllciBmb3IgdGhlIFRQRFVzLgo+ICsKPiArCj4gK0NDSUQgQ29tbWFuZHMKPiAr LS0tLS0tLS0tLS0tLS0KPiArCj4gK0FsbCBDQ0lEIGNvbW1hbmRzIGJlZ2lucyB3aXRoIGEgMTAg Ynl0ZXMgaGVhZGVyIGZvbGxvd2VkIGJ5IGFuIG9wdGlvbmFsCgogICAgICAgICAgICAgICAgICAg ICAgICAgICAgd2l0aCBhIDEwLWJ5dGUgaGVhZGVyCihvciBtYXliZSB0aGF0J3MgYSBsb2NhbGUg ZGlmZmVyZW5jZSkKCj4gK2RhdGEgZmllbGQgZGVwZW5kaW5nIG9uIG1lc3NhZ2UgdHlwZS4KPiAr 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+ICtBbGwgQ0NJRCBjb21tYW5kcyBzcGVjaWZpZXMgd2hpY2ggc2xvdCB0aGF0 IGlzIHRoZSByZWNlaXZlciBpbiB0aGUgYGJTbG90YCBmaWVsZAoKICAgICAgICAgICAgICAgICAg ICAgc3BlY2lmeSB3aGljaCBzbG90IGlzIHRoZSByZWNlaXZlcgoKPiArb2YgdGhlIENDSUQgaGVh ZGVyLgo+ICsKPiArVXNhZ2UKPiArPT09PT0KPiArCj4gK0FjY2VzcyBmcm9tIHVzZXJzcGFjZQo+ ICstLS0tLS0tLS0tLS0tLS0tLS0tLS0tCj4gK0FsbCBjb21tdW5pY2F0aW9uIGlzIGJ5IHJlYWQo MikgYW5kIHdyaXRlKDIpIHRvIHRoZSBjb3JyZXNwb25kaW5nIC9kZXYvY2NpZGcqIGRldmljZS4K PiArT25seSBvbmUgZmlsZWRlc2NyaXB0b3IgaXMgYWxsb3dlZCB0byBiZSBvcGVuIHRvIHRoZSBk ZXZpY2UgYXQgYSB0aW1lLgoKICAgICAgICAgICAgZmlsZSBkZXNjcmlwdG9yCgo+ICsKPiArVGhl IGJ1ZmZlciBzaXplIHByb3ZpZGVkIHRvIHJlYWQoMikgKiptdXN0IGJlIGF0IGxlYXN0KiogNTIy ICgxMCBieXRlcyBoZWFkZXIgKyA1MTIgYnl0ZXMgcGF5bG9hZCkKPiArYnl0ZXMgYXMgd2UgYXJl IHdvcmtpbmcgd2l0aCB3aG9sZSBjb21tYW5kcy4KPiArCj4gK1RoZSBidWZmZXIgc2l6ZSBwcm92 aWRlZCB0byB3cml0ZSgyKSAqKm1heSBub3QgZXhjZWVkKiogNTIyICgxMCBieXRlcyBoZWFkZXIg KyA1MTIgYnl0ZXMgcGF5bG9hZCkKPiArYnl0ZXMgYXMgd2UgYXJlIHdvcmtpbmcgd2l0aCB3aG9s ZSBjb21tYW5kcy4KPiArCj4gKwo+ICtDb25maWd1cmF0aW9uIHdpdGggY29uZmlnZnMKPiArLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQo+ICsKPiArQ29uZmlnRlMgaXMgdXNlZCB0byBjcmVh dGUgYW5kIGNvbmZpZ3VyZSB0aGUgQ0NJRCBnYWRnZXQuCj4gK0luIG9yZGVyIHRvIGdldCBhIGRl dmljZSB0byB3b3JrIGFzIGludGVuZGVkLCBhIGZldyBhdHRyaWJ1dGVzIG11c3QKPiArYmUgY29u c2lkZXJlZC4KPiArCj4gK1RoZSBhdHRyaWJ1dGVzIGlzIGRlc2NyaWJlZCBiZWxvdyBmb2xsb3dl ZCBieSBhbiBleGFtcGxlLgoKICAgICAgICAgICAgICAgICAgYXJlCgo+ICsKPiArZmVhdHVyZXMK PiArfn5+fn5+fn5+Cj4gKwo+ICtUaGUgYGZlYXR1cmVgIGF0dHJpYnV0ZSB3cml0ZXMgdG8gdGhl IGR3RmVhdHVyZXMgZmllbGQgaW4gdGhlIGNsYXNzIGRlc2NyaXB0b3IuCj4gK1NlZSBUYWJsZSA1 LjEtMSBTbWFydCBDYXJkIERldmljZSBEZXNjcmlwdG9ycyBpbiB0aGUgQ0NJRCBTcGVjaWZpY2F0 aW9uIFsxXV8uCj4gKwo+ICtUaGUgdmFsdWUgaW5kaWNhdGVzIHdoYXQgaW50ZWxsaWdlbnQgZmVh dHVyZXMgdGhlIENDSUQgaGFzLgo+ICtUaGVzZSB2YWx1ZXMgYXJlIGF2YWlsYWJsZSB0byB1c2Vy IGFwcGxpY2F0aW9uIGFzIGRlZmluZXMgaW4gY2NpZC5oIFsyXV8uCgogICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGFzIGRlZmluZWQKCj4gK1RoZSBkZWZh dWx0IHZhbHVlIGlzIDB4MDAwMDAwMDAuCgoKW3NuaXBdCgpIVEguCg==