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: [v4,2/3] Documentation: usb: add documentation for USB CCID Gadget Device From: Marcus Folkesson Message-Id: <20180626081422.19237-2-marcus.folkesson@gmail.com> Date: Tue, 26 Jun 2018 10:14:21 +0200 To: Greg Kroah-Hartman , Jonathan Corbet , Felipe Balbi , davem@davemloft.net, Mauro Carvalho Chehab , Andrew Morton , Randy Dunlap , Ruslan Bilovol , Thomas Gleixner , Kate Stewart Cc: linux-usb@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Marcus Folkesson List-ID: QWRkIGRvY3VtZW50YXRpb24gdG8gZ2l2ZSBhIGJyaWVmIGRlc2NyaXB0aW9uIG9uIGhvdyB0byB1 c2UgdGhlCkNDSUQgR2FkZ2V0IERldmljZS4KVGhpcyBpbmNsdWRlcyBhIGRlc2NyaXB0aW9uIGZv ciBhbGwgYXR0cmlidXRlcyBmb2xsb3dlZCBieSBhbiBleGFtcGxlIG9uCmhvdyB0byBzZXR1cCB0 aGUgZGV2aWNlIHdpdGggQ29uZmlnRlMuCgpSZXZpZXdlZC1ieTogUmFuZHkgRHVubGFwIDxyZHVu bGFwQGluZnJhZGVhZC5vcmc+ClNpZ25lZC1vZmYtYnk6IE1hcmN1cyBGb2xrZXNzb24gPG1hcmN1 cy5mb2xrZXNzb25AZ21haWwuY29tPgotLS0KCk5vdGVzOgogICAgdjQ6CiAgICAJLSBjbGFyaWZ5 IGhvdyB0byB1c2UgL2Rldi9jY2lkZyBhbmQgQlVMSyBlbmRwb2luZCAodGhhbmtzIFJhbmR5KQog ICAgdjM6CiAgICAJLSBjb3JyZWN0IHRoZSBncmFtbWVyICh0aGFua3MgUmFuZHkpCiAgICB2MjoK ICAgIAktIGFkZCB0aGUgbWlzc2luZyBjaGFuZ2Vsb2cgdGV4dAoKIERvY3VtZW50YXRpb24vdXNi L2dhZGdldF9jY2lkLnJzdCB8IDI2OSArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEg ZmlsZSBjaGFuZ2VkLCAyNjkgaW5zZXJ0aW9ucygrKQogY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3Vt ZW50YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdAoKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24v dXNiL2dhZGdldF9jY2lkLnJzdCBiL0RvY3VtZW50YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdApu ZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwMDAwMDAuLmM4ZjI1MDgwYzllNwotLS0g L2Rldi9udWxsCisrKyBiL0RvY3VtZW50YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdApAQCAtMCww ICsxLDI2OSBAQAorLi4gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEdQTC0yLjAKKworPT09PT09 PT09PT09CitDQ0lEIEdhZGdldAorPT09PT09PT09PT09CisKKzpBdXRob3I6IE1hcmN1cyBGb2xr ZXNzb24gPG1hcmN1cy5mb2xrZXNzb25AZ21haWwuY29tPgorCitJbnRyb2R1Y3Rpb24KKz09PT09 PT09PT09PQorCitUaGUgQ0NJRCBHYWRnZXQgd2lsbCBwcmVzZW50IGl0c2VsZiBhcyBhIENDSUQg ZGV2aWNlIHRvIHRoZSBob3N0IHN5c3RlbS4KK1RoZSBkZXZpY2Ugc3VwcG9ydHMgdHdvIGVuZHBv aW50cyBmb3Igbm93OyBCVUxLIElOIGFuZCBCVUxLIE9VVC4KK1RoZXNlIGVuZHBvaW50cyBhcmUg ZXhwb3NlZCB0byB1c2Vyc3BhY2UgdmlhIC9kZXYvY2NpZGdYIHdoZXJlIGBYYCBpcwordGhlIGRl dmljZSBlbnVtZXJhdGlvbiBudW1iZXIuCitVc2UgcmVhZCgyKSBhbmQgd3JpdGUoMykgdG8gb3Bl cmF0ZSBvbiBCVUxLX0lOIGFuZCBCVUxLX09VVCByZXNwZWN0aXZlbHkuCisKK0FsbCBDQ0lEIGNv bW1hbmRzIGFyZSBzZW50IG9uIHRoZSBCVUxLLU9VVCBlbmRwb2ludC4gRWFjaCBjb21tYW5kIHNl bnQgdG8gdGhlIENDSUQKK2hhcyBhbiBhc3NvY2lhdGVkIGVuZGluZyByZXNwb25zZS4gU29tZSBj b21tYW5kcyBjYW4gYWxzbyBoYXZlIGludGVybWVkaWF0ZQorcmVzcG9uc2VzLiBUaGUgcmVzcG9u c2UgaXMgc2VudCBvbiB0aGUgQlVMSy1JTiBlbmRwb2ludC4KK1NlZSBGaWd1cmUgMy0zIGluIHRo ZSBDQ0lEIFNwZWNpZmljYXRpb24gWzFdXyBmb3IgbW9yZSBkZXRhaWxzLgorCitUaGUgQ0NJRCBj b21tYW5kcyBtdXN0IGJlIGhhbmRsZWQgaW4gdXNlcnNwYWNlIHNpbmNlIHRoZSBkcml2ZXIgaXMg b25seSB3b3JraW5nCithcyBhIHRyYW5zcG9ydCBsYXllciBmb3IgdGhlIFRQRFVzLgorCisKK0ND SUQgQ29tbWFuZHMKKy0tLS0tLS0tLS0tLS0tCisKK0FsbCBDQ0lEIGNvbW1hbmRzIGJlZ2lucyB3 aXRoIGEgMTAtYnl0ZSBoZWFkZXIgZm9sbG93ZWQgYnkgYW4gb3B0aW9uYWwKK2RhdGEgZmllbGQg ZGVwZW5kaW5nIG9uIG1lc3NhZ2UgdHlwZS4KKworKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tKy0t LS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgT2Zmc2V0IHwgRmll bGQgICAgICAgIHwgU2l6ZSAgfCBEZXNjcmlwdGlvbiAgICAgICAgICAgICAgICAgICAgICB8Cisr PT09PT09PT0rPT09PT09PT09PT09PT0rPT09PT09PSs9PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09KworfCAwICAgICAgfCBiTWVzc2FnZVR5cGUgfCAxICAgICB8IFR5cGUgb2YgbWVz c2FnZSAgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0t Ky0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCit8IDEgICAgICB8IGR3TGVuZ3Ro ICAgICB8IDQgICAgIHwgTWVzc2FnZSBzcGVjaWZpYyBkYXRhIGxlbmd0aCAgICAgfAorfCAgICAg ICAgfCAgICAgICAgICAgICAgfCAgICAgICB8ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0rCit8IDUgICAgICB8IGJTbG90ICAgICAgICB8IDEgICAgIHwgSWRl bnRpZmllcyB0aGUgc2xvdCBudW1iZXIgICAgICAgfAorfCAgICAgICAgfCAgICAgICAgICAgICAg fCAgICAgICB8IGZvciB0aGlzIGNvbW1hbmQgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLSst LS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0r Cit8IDYgICAgICB8IGJTZXEgICAgICAgICB8IDEgICAgIHwgU2VxdWVuY2UgbnVtYmVyIGZvciBj b21tYW5kICAgICAgfAorKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tKy0tLS0tLS0rLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgNyAgICAgIHwgLi4uICAgICAgICAgIHwgMyAg ICAgfCBGaWVsZHMgZGVwZW5kcyBvbiBtZXNzYWdlIHR5cGUgICB8CisrLS0tLS0tLS0rLS0tLS0t LS0tLS0tLS0rLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAx MCAgICAgfCBhYkRhdGEgICAgICAgfCBhcnJheSB8IE1lc3NhZ2Ugc3BlY2lmaWMgZGF0YSAoT1BU SU9OQUwpIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0rCisKKworTXVsdGlwbGUgQ0NJRCBnYWRnZXRzCistLS0tLS0t LS0tLS0tLS0tLS0tLS0tCisKK0l0IGlzIHBvc3NpYmxlIHRvIGNyZWF0ZSBtdWx0aXBsZSBpbnN0 YW5jZXMgb2YgdGhlIENDSUQgZ2FkZ2V0LCBob3dldmVyLAorYSBtdWNoIG1vcmUgZmxleGlibGUg d2F5IGlzIHRvIGNyZWF0ZSBvbmUgZ2FkZ2V0IGFuZCBzZXQgdGhlIGBuc2xvdHNgIGF0dHJpYnV0 ZQordG8gdGhlIG51bWJlciBvZiBkZXNpcmVkIENDSUQgZGV2aWNlcy4KKworQWxsIENDSUQgY29t bWFuZHMgc3BlY2lmeSB3aGljaCBzbG90IGlzIHRoZSByZWNlaXZlciBpbiB0aGUgYGJTbG90YCBm aWVsZAorb2YgdGhlIENDSUQgaGVhZGVyLgorCitVc2FnZQorPT09PT0KKworQWNjZXNzIGZyb20g dXNlcnNwYWNlCistLS0tLS0tLS0tLS0tLS0tLS0tLS0tCitBbGwgY29tbXVuaWNhdGlvbiBpcyBi eSByZWFkKDIpIGFuZCB3cml0ZSgyKSB0byB0aGUgY29ycmVzcG9uZGluZyAvZGV2L2NjaWRnKiBk ZXZpY2UuCitPbmx5IG9uZSBmaWxlIGRlc2NyaXB0b3IgaXMgYWxsb3dlZCB0byBiZSBvcGVuIHRv IHRoZSBkZXZpY2UgYXQgYSB0aW1lLgorCitUaGUgYnVmZmVyIHNpemUgcHJvdmlkZWQgdG8gcmVh ZCgyKSAqKm11c3QgYmUgYXQgbGVhc3QqKiA1MjIgKDEwIGJ5dGVzIGhlYWRlciArIDUxMiBieXRl cyBwYXlsb2FkKQorYnl0ZXMgYXMgd2UgYXJlIHdvcmtpbmcgd2l0aCB3aG9sZSBjb21tYW5kcy4K KworVGhlIGJ1ZmZlciBzaXplIHByb3ZpZGVkIHRvIHdyaXRlKDIpICoqbWF5IG5vdCBleGNlZWQq KiA1MjIgKDEwIGJ5dGVzIGhlYWRlciArIDUxMiBieXRlcyBwYXlsb2FkKQorYnl0ZXMgYXMgd2Ug YXJlIHdvcmtpbmcgd2l0aCB3aG9sZSBjb21tYW5kcy4KKworCitDb25maWd1cmF0aW9uIHdpdGgg Y29uZmlnZnMKKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KKworQ29uZmlnRlMgaXMgdXNl ZCB0byBjcmVhdGUgYW5kIGNvbmZpZ3VyZSB0aGUgQ0NJRCBnYWRnZXQuCitJbiBvcmRlciB0byBn ZXQgYSBkZXZpY2UgdG8gd29yayBhcyBpbnRlbmRlZCwgYSBmZXcgYXR0cmlidXRlcyBtdXN0Citi ZSBjb25zaWRlcmVkLgorCitUaGUgYXR0cmlidXRlcyBhcmUgZGVzY3JpYmVkIGJlbG93IGZvbGxv d2VkIGJ5IGFuIGV4YW1wbGUuCisKK2ZlYXR1cmVzCit+fn5+fn5+fn4KKworVGhlIGBmZWF0dXJl YCBhdHRyaWJ1dGUgd3JpdGVzIHRvIHRoZSBkd0ZlYXR1cmVzIGZpZWxkIGluIHRoZSBjbGFzcyBk ZXNjcmlwdG9yLgorU2VlIFRhYmxlIDUuMS0xIFNtYXJ0IENhcmQgRGV2aWNlIERlc2NyaXB0b3Jz IGluIHRoZSBDQ0lEIFNwZWNpZmljYXRpb24gWzFdXy4KKworVGhlIHZhbHVlIGluZGljYXRlcyB3 aGF0IGludGVsbGlnZW50IGZlYXR1cmVzIHRoZSBDQ0lEIGhhcy4KK1RoZXNlIHZhbHVlcyBhcmUg YXZhaWxhYmxlIHRvIHVzZXIgYXBwbGljYXRpb24gYXMgZGVmaW5lZCBpbiBjY2lkLmggWzJdXy4K K1RoZSBkZWZhdWx0IHZhbHVlIGlzIDB4MDAwMDAwMDAuCisKK1RoZSB2YWx1ZSBpcyBhIGJpdHdp c2UgT1Igb3BlcmF0aW9uIHBlcmZvcm1lZCBvbiB0aGUgZm9sbG93aW5nIHZhbHVlczoKKworKy0t LS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tKworfCBWYWx1ZSAgICAgIHwgRGVzY3JpcHRpb24gICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfAorKz09PT09PT09PT09 PSs9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09KworfCAweDAwMDAwMDAwIHwgTm8gc3BlY2lhbCBjaGFyYWN0ZXJpc3RpY3MgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t KworfCAweDAwMDAwMDAyIHwgQXV0b21hdGljIHBhcmFtZXRlciBjb25maWd1cmF0aW9uIGJhc2Vk IG9uIEFUUiBkYXRhICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAw MDAwMDA0IHwgQXV0b21hdGljIGFjdGl2YXRpb24gb2YgSUNDIG9uIGluc2VydGluZyAgICAgICAg ICAgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAwMDAwMDA4IHwg QXV0b21hdGljIElDQyB2b2x0YWdlIHNlbGVjdGlvbiAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAwMDAwMDEwIHwgQXV0b21hdGlj IElDQyBjbG9jayBmcmVxdWVuY3kgY2hhbmdlIGFjY29yZGluZyB0byBhY3RpdmUgICAgICAgfAor fCAgICAgICAgICAgIHwgcGFyYW1ldGVycyBwcm92aWRlZCBieSB0aGUgSG9zdCBvciBzZWxmIGRl dGVybWluZWQgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAwMDAw MDIwIHwgQXV0b21hdGljIGJhdWQgcmF0ZSBjaGFuZ2UgYWNjb3JkaW5nIHRvIGFjdGl2ZSAgICAg ICAgICAgICAgICAgfAorfCAgICAgICAgICAgIHwgcGFyYW1ldGVycyBwcm92aWRlZCBieSB0aGUg SG9zdCBvciBzZWxmIGRldGVybWluZWQgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tKworfCAweDAwMDAwMDQwIHwgQXV0b21hdGljIHBhcmFtZXRlcnMgbmVnb3RpYXRpb24gbWFk ZSBieSB0aGUgQ0NJRCAgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAw eDAwMDAwMDgwIHwgQXV0b21hdGljIFBQUyBtYWRlIGJ5IHRoZSBDQ0lEIGFjY29yZGluZyB0byB0 aGUgICAgICAgICAgICAgICAgfAorfCAgICAgICAgICAgIHwgYWN0aXZlIHBhcmFtZXRlcnMgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0t LSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tKworfCAweDAwMDAwMTAwIHwgQ0NJRCBjYW4gc2V0IElDQyBpbiBjbG9jayBzdG9w IG1vZGUgICAgICAgICAgICAgICAgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t KworfCAweDAwMDAwMjAwIHwgTkFEIHZhbHVlIG90aGVyIHRoYW4gMDAgYWNjZXB0ZWQgKFQ9MSBw cm90b2NvbCBpbiB1c2UpICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAw MDAwNDAwIHwgQXV0b21hdGljIElGU0QgZXhjaGFuZ2UgYXMgZmlyc3QgZXhjaGFuZ2UgICAgICAg ICAgICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworCisKK09ubHkgb25lIG9m IHRoZSBmb2xsb3dpbmcgdmFsdWVzIG1heSBiZSBwcmVzZW50IHRvIHNlbGVjdCBhIGxldmVsIG9m IGV4Y2hhbmdlOgorCisrLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCBWYWx1ZSAgICAgIHwgRGVzY3JpcHRpb24gICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwKKys9PT09PT09PT09PT0rPT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0rCit8IDB4MDAwMTAwMDAg fCBUUERVIGxldmVsIGV4Y2hhbmdlcyB3aXRoIENDSUQgICAgICAgICAgICAgICAgICAgfAorKy0t LS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLSsKK3wgMHgwMDAyMDAwMCB8IFNob3J0IEFQRFUgbGV2ZWwgZXhjaGFuZ2Ugd2l0aCBDQ0lE ICAgICAgICAgICAgICB8CisrLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAwMDQwMDAwIHwgU2hvcnQgYW5kIEV4dGVu ZGVkIEFQRFUgbGV2ZWwgZXhjaGFuZ2Ugd2l0aCBDQ0lEIHwKKystLS0tLS0tLS0tLS0rLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCisKK0lmIG5vbmUg b2YgdGhvc2UgdmFsdWVzIGlzIGluZGljYXRlZCB0aGUgbGV2ZWwgb2YgZXhjaGFuZ2UgaXMKK2No YXJhY3Rlci4KKworCitwcm90b2NvbHMKK35+fn5+fn5+fn4KK1RoZSBgcHJvdG9jb2xzYCBhdHRy aWJ1dGUgd3JpdGVzIHRvIHRoZSBkd1Byb3RvY29scyBmaWVsZCBpbiB0aGUgY2xhc3MgZGVzY3Jp cHRvci4KK1NlZSBUYWJsZSA1LjEtMSBTbWFydCBDYXJkIERldmljZSBEZXNjcmlwdG9ycyBpbiB0 aGUgQ0NJRCBTcGVjaWZpY2F0aW9uIFsxXV8uCisKK1RoZSB2YWx1ZSBpcyBhIGJpdHdpc2UgT1Ig b3BlcmF0aW9uIHBlcmZvcm1lZCBvbiB0aGUgZm9sbG93aW5nIHZhbHVlczoKKworKy0tLS0tLS0t Ky0tLS0tLS0tLS0tLS0tKworfCBWYWx1ZSAgfCBEZXNjcmlwdGlvbiAgfAorKz09PT09PT09Kz09 PT09PT09PT09PT09KworfCAweDAwMDEgfCBQcm90b2NvbCBUPTAgfAorKy0tLS0tLS0tKy0tLS0t LS0tLS0tLS0tKworfCAweDAwMDIgfCBQcm90b2NvbCBUPTEgfAorKy0tLS0tLS0tKy0tLS0tLS0t LS0tLS0tKworCitJZiBubyBwcm90b2NvbCBpcyBzZWxlY3RlZCBib3RoIFQ9MCBhbmQgVD0xIHdp bGwgYmUgc3VwcG9ydGVkIChgcHJvdG9jb2xzYCA9IDB4MDAwMykuCisKK25zbG90cworfn5+fn5+ CisKK1RoZSBgbnNsb3RzYCBhdHRyaWJ1dGUgd3JpdGVzIHRvIHRoZSBiTWF4U2xvdEluZGV4IGZp ZWxkIGluIHRoZSBjbGFzcyBkZXNjcmlwdG9yLgorU2VlIFRhYmxlIDUuMS0xIFNtYXJ0IENhcmQg RGV2aWNlIERlc2NyaXB0b3JzIGluIHRoZSBDQ0lEIFNwZWNpZmljYXRpb24gWzFdXy4KKworVGhp cyBpcyB0aGUgaW5kZXggb2YgdGhlIGhpZ2hlc3QgYXZhaWxhYmxlIHNsb3Qgb24gdGhpcyBkZXZp Y2UuIEFsbCBzbG90cyBhcmUgY29uc2VjdXRpdmUgc3RhcnRpbmcgYXQgMDBoLgoraS5lLiAwRmgg PSAxNiBzbG90cyBvbiB0aGlzIGRldmljZSBudW1iZXJlZCAwMGggdG8gMEZoLgorCitUaGUgZGVm YXVsdCB2YWx1ZSBpcyAwLCB3aGljaCBtZWFucyBvbmUgc2xvdC4KKworCitwaW5zdXBwb3J0Cit+ fn5+fn5+fn5+fn4KKworVGhpcyB2YWx1ZSBpbmRpY2F0ZXMgd2hhdCBQSU4gc3VwcG9ydCBmZWF0 dXJlcyB0aGUgQ0NJRCBoYXMuCisKK1RoZSBgcGluc3VwcG9ydGAgYXR0cmlidXRlIHdyaXRlcyB0 byB0aGUgZHdQSU5TdXBwb3J0IGZpZWxkIGluIHRoZSBjbGFzcyBkZXNjcmlwdG9yLgorU2VlIFRh YmxlIDUuMS0xIFNtYXJ0IENhcmQgRGV2aWNlIERlc2NyaXB0b3JzIGluIHRoZSBDQ0lEIFNwZWNp ZmljYXRpb24gWzFdXy4KKworCitUaGUgdmFsdWUgaXMgYSBiaXR3aXNlIE9SIG9wZXJhdGlvbiBw ZXJmb3JtZWQgb24gdGhlIGZvbGxvd2luZyB2YWx1ZXM6CisKKystLS0tLS0tLSstLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tKworfCBWYWx1ZSAgfCBEZXNjcmlwdGlvbiAgICAgICAgICAgICAg ICB8CisrPT09PT09PT0rPT09PT09PT09PT09PT09PT09PT09PT09PT09PSsKK3wgMHgwMCAgIHwg Tm8gUElOIHN1cHBvcnQgICAgICAgICAgICAgfAorKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0rCit8IDB4MDEgICB8IFBJTiBWZXJpZmljYXRpb24gc3VwcG9ydGVkIHwKKyst LS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAweDAyICAgfCBQSU4gTW9k aWZpY2F0aW9uIHN1cHBvcnRlZCB8CisrLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLSsKKworVGhlIGRlZmF1bHQgdmFsdWUgaXMgc2V0IHRvIDB4MDAuCisKKworbGNkbGF5b3V0 Cit+fn5+fn5+fn5+CisKK051bWJlciBvZiBsaW5lcyBhbmQgY2hhcmFjdGVycyBmb3IgdGhlIExD RCBkaXNwbGF5IHVzZWQgdG8gc2VuZCBtZXNzYWdlcyBmb3IgUElOIGVudHJ5LgorCitUaGUgYGxj ZExheW91dGAgYXR0cmlidXRlIHdyaXRlcyB0byB0aGUgd0xjZExheW91dCBmaWVsZCBpbiB0aGUg Y2xhc3MgZGVzY3JpcHRvci4KK1NlZSBUYWJsZSA1LjEtMSBTbWFydCBDYXJkIERldmljZSBEZXNj cmlwdG9ycyBpbiB0aGUgQ0NJRCBTcGVjaWZpY2F0aW9uIFsxXV8uCisKKworVGhlIHZhbHVlIGlz IHNldCBhcyBmb2xsb3dzOgorCisrLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tKworfCBWYWx1ZSAgfCBEZXNjcmlwdGlvbiAgICAgICAgICAgICAgICAgICAgICAg IHwKKys9PT09PT09PSs9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0rCit8IDB4 MDAwMCB8IE5vIExDRCAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfAorKy0tLS0tLS0tKy0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHhYWFlZIHwgWFg6IG51bWJl ciBvZiBsaW5lcyAgICAgICAgICAgICAgICB8Cit8ICAgICAgICB8IFlZOiBudW1iZXIgb2YgY2hh cmFjdGVycyBwZXIgbGluZS4gfAorKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLSsKKworVGhlIGRlZmF1bHQgdmFsdWUgaXMgc2V0IHRvIDB4MDAwMC4KKworCitF eGFtcGxlCistLS0tLS0tCisKK0hlcmUgaXMgYW4gZXhhbXBsZSBvbiBob3cgdG8gc2V0dXAgYSBD Q0lEIGdhZGdldCB3aXRoIGNvbmZpZ2ZzIDo6CisKKyAgICAjIS9iaW4vc2gKKworICAgIENPTkZJ R0RJUj0vc3lzL2tlcm5lbC9jb25maWcKKyAgICBHQURHRVQ9JENPTkZJR0RJUi91c2JfZ2FkZ2V0 L2cwCisgICAgRlVOQ1RJT049JEdBREdFVC9mdW5jdGlvbnMvY2NpZC5zYzAKKworICAgIFZJRD1Z T1VSX1ZFTkRPUl9JRF9IRVJFCisgICAgUElEPVlPVVJfUFJPRFVDVF9JRF9IRVJFCisgICAgVURD PVlPVVJfVURDX0hFUkUKKworICAgICNNb3VudCBmaWxlc3lzdGVtCisgICAgbW91bnQgbm9uZSAt dCBjb25maWdmcyAkQ09ORklHRElSCisKKyAgICAjUG9wdWxhdGUgSUQ6cworICAgIGVjaG8gJFZJ RCA+ICRHQURHRVQvaWRWZW5kb3IKKyAgICBlY2hvICRQSUQgPiAkR0FER0VUL2lkUHJvZHVjdAor CisgICAgI0NyZWF0ZSBhbmQgY29uZmlndXJlIHRoZSBnYWRnZXQKKyAgICBta2RpciAkRlVOQ1RJ T04KKyAgICBlY2hvIDB4MDAwNDA3QjggPiAkRlVOQ1RJT04vZmVhdHVyZXMKKyAgICBlY2hvIDB4 MDIgPiAkRlVOQ1RJT04vcHJvdG9jb2xzCisKKyAgICAjQ3JlYXRlIG91ciBFbmdsaXNoIHN0cmlu Z3MKKyAgICBta2RpciAgJEdBREdFVC9zdHJpbmdzLzB4NDA5CisgICAgZWNobyA1NTY2NzcgPiAk R0FER0VUL3N0cmluZ3MvMHg0MDkvc2VyaWFsbnVtYmVyCisgICAgZWNobyAiSHVuZ3J5IFBlbmd1 aW5zIiA+ICRHQURHRVQvc3RyaW5ncy8weDQwOS9tYW51ZmFjdHVyZXIKKyAgICBlY2hvICJIYXJw b29uIFdpdGggU21hcnQgQ2FyZCIgID4gJEdBREdFVC9zdHJpbmdzLzB4NDA5L3Byb2R1Y3QKKwor ICAgICNDcmVhdGUgY29uZmlndXJhdGlvbgorICAgIG1rZGlyICAkR0FER0VUL2NvbmZpZ3MvYy4x CisgICAgbWtkaXIgICRHQURHRVQvY29uZmlncy9jLjEvc3RyaW5ncy8weDQwOQorICAgIGVjaG8g Q29uZmlnMSA+ICRHQURHRVQvY29uZmlncy9jLjEvc3RyaW5ncy8weDQwOS9jb25maWd1cmF0aW9u CisKKyAgICAjVXNlIGBDb25maWcxYCBmb3Igb3VyIENDSUQgZ2FkZ2V0CisgICAgbG4gLXMgJEZV TkNUSU9OICRHQURHRVQvY29uZmlncy9jLjEKKworICAgICNFeGVjdXRlCisgICAgZWNobyAkVURD ID4gJEdBREdFVC9VREMKKworCitSZWZlcmVuY2VzCis9PT09PT09PT09CisKKy4uIFsxXSBodHRw Oi8vd3d3LnVzYi5vcmcvZGV2ZWxvcGVycy9kb2NzL2RldmNsYXNzX2RvY3MvRFdHX1NtYXJ0LUNh cmRfQ0NJRF9SZXYxMTAucGRmCisuLiBbMl0gaW5jbHVkZS91YXBpL2xpbnV4L3VzYi9jY2lkLmgK