From patchwork Tue Jun 20 12:32:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marco Morandini X-Patchwork-Id: 13285781 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A7C4EEB64D8 for ; Tue, 20 Jun 2023 12:32:35 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232147AbjFTMce (ORCPT ); Tue, 20 Jun 2023 08:32:34 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55102 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231760AbjFTMcd (ORCPT ); Tue, 20 Jun 2023 08:32:33 -0400 Received: from EUR03-AM7-obe.outbound.protection.outlook.com (mail-am7eur03on2074.outbound.protection.outlook.com [40.107.105.74]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A6B6510CF; Tue, 20 Jun 2023 05:32:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dMmTFPQTirkUyLX/a1VkHQizm/qpvwCddJrC8Ag1ratg6Oa9bElaTtI4H0JH0ydD7wd9VgAEvbpDmLQZZme1HtynY0/VmrYKNwsIMjqZ6+55O0sV2UT1m9ABpgVTQ6GL/6M4jGw10kG/8C8xUODTl2lsKIc6kFKoKNN+ZCgdAc2kGOz4tuwmcFX9dycoxmdYMy8pwirPtJkuf+rjqfoKv676/NKUM1heMcp7GjZrGVMDxMPHPjYXP5vKjqQJNRB1jEQqy7DCUdmK4R5uEXznGS7We2RpEw2sgIoyT9/hvTN+Hoom8vVmHfq/8pw7X3pKEMz3apVg65+aFE/h8OZwjA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=myvCne4T8EqSaQUeoeLEXrCdMkwDygK7qpV3sUn3Ktk=; b=j8XiGkmJvoipTIpiT5rxIgpEx0viyExzmhuCBA/fcOmRttOxEqzqCMeHiQ6aTL26YVGIOQ27bik8NX3Ccr4Skji3VJhgAi1EhsZ4MM756dycdh7w99Hos6yescsMlEj5J021AIPaMGnocniY/hjianDEcuAlIQhlyMP/G0Mxl/xDn12nQAV5WMAsGPw+37fe3kPzO22ExGhWd/xVGwh4qXTTYtQk59BYcK6Xj+bIDFA7Kyf+S+SRgb5WJVne0zWdlFR0XAvHtLaDg2RKZCDctF9LdsfkU/Wdi9rs7iqfYjYFizp67CKAfIMGqBHmo66X7N4rN6ClZiqS1vXVvkIrMA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=polimi.it; dmarc=pass action=none header.from=polimi.it; dkim=pass header.d=polimi.it; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=polimi.it; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=myvCne4T8EqSaQUeoeLEXrCdMkwDygK7qpV3sUn3Ktk=; b=YF1Gr8SazIJP+kMq6rfLoeQWqzP7Wu3KL0oOSvz4XArEmzF8y78kfPd9qRQRs1niV0C1EUk+gkfHdmL78NdTYSkaZWrIh9gr+qlc6crP5QG7HXQ+ydRwnPZCEod3UVFf4aUGYEwz3eScenYE/v/dbRmVAnl11kgg6sCHPF9w4HyJK2vP2qf/2vRh4o36WijvRIlZatsTdgwhA6mCRqcT9CodN2/0TsYCmdM8ZW4D68D/m8hgnE1ZFZR4el57/7qsfIvvcgNM9NDGV7x2btKCh/MRDA8Nk05n6L5dtp5DsQOdwIuvHZr1WJAksy7RFxFU1aS4DARfuf1SVNawqmZHLQ== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=polimi.it; Received: from PAXP251MB0348.EURP251.PROD.OUTLOOK.COM (2603:10a6:102:20b::10) by PRAP251MB0490.EURP251.PROD.OUTLOOK.COM (2603:10a6:102:290::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6477.40; Tue, 20 Jun 2023 12:32:27 +0000 Received: from PAXP251MB0348.EURP251.PROD.OUTLOOK.COM ([fe80::459c:ad77:2151:62a9]) by PAXP251MB0348.EURP251.PROD.OUTLOOK.COM ([fe80::459c:ad77:2151:62a9%3]) with mapi id 15.20.6477.028; Tue, 20 Jun 2023 12:32:27 +0000 Message-ID: Date: Tue, 20 Jun 2023 14:32:25 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.12.0 From: Marco Morandini Subject: [PATCH 0/1] HID: Add introduction about HID for non-kernel programmers To: Jiri Kosina , Benjamin Tissoires , linux-input@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Content-Language: en-US, it X-ClientProxiedBy: MR1P264CA0189.FRAP264.PROD.OUTLOOK.COM (2603:10a6:501:58::16) To PAXP251MB0348.EURP251.PROD.OUTLOOK.COM (2603:10a6:102:20b::10) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PAXP251MB0348:EE_|PRAP251MB0490:EE_ X-MS-Office365-Filtering-Correlation-Id: 19d87400-ca74-4983-f7ef-08db718a6818 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 8yEQ2Z+gxF0YCVI0gTRsH/mCynn2XbFNx8dZxjNX5NKNVRhXaJbMeH81koK+d3kcyy7FqdczPJTWRYfOX+id7wwqJWQgEzoK+n8oQJmm4jGc5LvQxbx3ueJV8g+PKBVJPFCYW3EFi+OC0Eav6SxSrH9G3nNsv0Ouo2KULx5vjGPk4Qo1STucE1WqKrQjaZkMbOKXGY0peY9zMxhqVBeajxe0vJYAgUQhuTtzewRJ/aKICDRD4g7sid1z4kNr5x7d/7KLubd7E7/tYBKczG1UQn73IW7k6PcKCqNg44jndo6CcDf5vfUw1irqNOCLNAtiSsaJKsUv5PIfw1yKM9+0c/FKKTRZ4qzB2+AhmK4iEtUAvkNxOrtaIhzgYqpO6k3vmjuxyIf2qb/cnX6SsuDWwnz3pMvHEGUzINedflkL9iq8Rm51O4Oi3ekkqmIapcGAH5Pcj1UR4zhZsBE3TsqYBztlheIGDjiBkftzVbR3VGnpH04Dd3ecVKXx/6jWhRfFZVwzzhA9xeQSmtR5dJw2OBs0CgSi8Oh2Q0fwgD7109olYKB+QDTEqb4MVdkw2tNlJ8FdmfAoJh0lArVcdZzN3La6wwVwgLxp7iZIT7WmiLmGo0czO83NVgPivyaSXnTYE1J6X4NmjDXuQerCbUw8HA== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PAXP251MB0348.EURP251.PROD.OUTLOOK.COM;PTR:;CAT:NONE;SFS:(13230028)(4636009)(376002)(39860400002)(136003)(346002)(396003)(366004)(451199021)(110136005)(478600001)(6486002)(44832011)(8936002)(5660300002)(8676002)(4744005)(2906002)(36756003)(31696002)(41300700001)(38100700002)(316002)(66476007)(66946007)(786003)(66556008)(26005)(6506007)(6512007)(186003)(86362001)(31686004)(2616005)(45980500001)(43740500002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?wA3oN4avfDeEuZCdSdBt0MhT37XE?= =?utf-8?q?4PRGFxEmWKVKg6hNKlTc/f0u9ChM69CF5Jepwr640AAv4Tn0IIlZFfcjNWVsNnqzj?= =?utf-8?q?YcsHAIAl3GtTWZgfDgEAv/h04yE6V6a4StNXqoIgdjovSto9hYa4QwwSvUCaxc86Z?= =?utf-8?q?91a/W0wP959OeDWQNu70sBFHkOyHKtgcUTUm/8Aj0t1AyEYbvuKx2SZdiozaRCh9z?= =?utf-8?q?RYcJmvBp68PXsktir0ar0qrTchpLK25OipzXMKL9WKFp7W9jcQd5/En3bYVfXKn+5?= =?utf-8?q?zrJ1sMw+74ZFroclp5p+/1IkWlLSNjLg5tpOhMcwlE672iq/WBj9FYG7Q2FEtDr6W?= =?utf-8?q?8b0jj0pSPhE0MVi/e5Ol4vGR6Bw3tLGCMgpOegxAx6wUtNfZWynCJ3Pfbd435Abkz?= =?utf-8?q?V3c+E7Gw115QN7j5VsdVRFSnGqAMI/2eF20N2uelqT3P+xk1SCFYwOvNJJ+xiGoih?= =?utf-8?q?gwlc926+sp5i5z4rS+6biORhbn9EoQflDkRScRYmSTh6qTALCRikLHwEFmmx9dQr0?= =?utf-8?q?10ZJbeSnOO9shzOD9fdcN/ArgSM1ZDPwxwCxPVMYJLMweT9tcPLFjdt+uQLg+BOU3?= =?utf-8?q?EJX2GkJAhN1jUWJgQNfSQvKoTzzo6kF7NDe8UeEnA7de8NQa+iFgUiIuugvyCdUio?= =?utf-8?q?WiEkxWJtkR0iyIYhD+tX5MUMfG5PaWLvyiCZI4Qx3mU4HFbDmtnap0Y8Ge5KMV0hs?= =?utf-8?q?lmbXxT2VTVd6k8dySouecpoS4dSCjJG0chsElVVjeB1xie7pHvyoRolxmRKmCISon?= =?utf-8?q?LwOAnTSm4gcRJxIlsZWaE59MFvCA8zJgd4s6n87zpOLjq25fFTjaxziQ9s3Qe5RBb?= =?utf-8?q?D4fkIihpuOR3RbQUZmJrVjpMPD9n+2gQjPdLm4qKC4ArP8ef7liQCkxeZuSfGaBbS?= =?utf-8?q?H26Fr4g/GpPcMi0s8J1eUkXXX7X0faFIO9SsIcVe1j1mvb4k3MbxAij/+fJPE9AD5?= =?utf-8?q?fjNkTE2L4BM0MHHiNOgsp1Lj1XaZekhUXgzIqwczTr/3pZgPye/QpHDdmNEqgs3uj?= =?utf-8?q?DL1s7uynwljvdYK/ZvF09x8nbayMi6J23s054DrKqcDk7GmGHVogp61OipLohFNxT?= =?utf-8?q?d5tVaJcKkIKbVkaTtSVCHE4IBRKrNLa/4A4KgsEBvXivfUuRcdvWJ37hyF6B7Cp/6?= =?utf-8?q?J9CAp2puPg4FsBrBq3LI8UkSjwk0ZO7uaLlBenvqn3Qb+TXotumQ9oDoCsjOu6xcP?= =?utf-8?q?mPPIB8TcvajabPeB9S0kAReRwN7kYZA0C4lfUft8kCSwPd8GE7pjWFtUH/zDjyq7g?= =?utf-8?q?Irmr2r2aVa1xchRrCKXmecAj/QbStVKadYYjUwb355XoIFjL1wVaoFwGWpaXMuxWt?= =?utf-8?q?ndNOvsmu9fdxLKNHAeKe+/Ke/YgJQP52evtIsgN34A0FHbHQASTRmWeM2jxWYNBIR?= =?utf-8?q?e9N16guj3w8Ad6qUEsbFW2pHQjje5q708EwxPFDgRTu90eVr5mZF5UbtuEJHfWyD4?= =?utf-8?q?H5BFGKMO2pWenJZEKxnJ4Ed/Jrlj0MfUU5kqrGe/U3A0Iyn+TTQ9TkOfgnNOC6qjT?= =?utf-8?q?jikZ/7RP8x02?= X-OriginatorOrg: polimi.it X-MS-Exchange-CrossTenant-Network-Message-Id: 19d87400-ca74-4983-f7ef-08db718a6818 X-MS-Exchange-CrossTenant-AuthSource: PAXP251MB0348.EURP251.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Jun 2023 12:32:27.1194 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 0a17712b-6df3-425d-808e-309df28a5eeb X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: yilFvn7TZAc6McFSA6iuDo1grHq0yKWVVEhFZRJio/A2zAPb3TJ78enfCeQBV2UYyAWn4DBT9DyJlvTRdSjxaA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PRAP251MB0490 Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org This doc addition is meant to allow a random user to understand what is going wrong with his brand-new device, and possibly try to fix it on his own. I've written it, being one of those random users, in an effort to document what I think I've learned, and with the hope to minimize the pain to guys like me. The chapter is by no means complete, and for sure will require careful checking and fixing from the HID maintainers. In my opinion, it would also be great if they could add a brief explanation for the different quirks (I've left a FIXME there). I hope I've not misunderstood too many concepts (?events?) and that the whole thing is not so screwed up that it's better to throw it into the thrash can and run away without looking back. Marco