From patchwork Thu Jan 13 18:10:04 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hongren Zheng X-Patchwork-Id: 1579771 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=zenithal.me header.i=@zenithal.me header.a=rsa-sha256 header.s=selector1 header.b=P6UHta5n; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org (client-ip=209.51.188.17; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4JZXbW3bSNz9sXM for ; Fri, 14 Jan 2022 05:12:53 +1100 (AEDT) Received: from localhost ([::1]:54282 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n84af-0000Ib-Tx for incoming@patchwork.ozlabs.org; Thu, 13 Jan 2022 13:12:49 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45264) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Yk-0000Fg-2r for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:10:50 -0500 Received: from [2a01:111:f403:7010::70d] (port=45377 helo=JPN01-TYC-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Yf-0001eJ-Pk for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:10:49 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GdRRjeMCoIYt4kh6rpIN3uY0+qiLp5cZRNu8D6MG9qGqwRqWgS5UrVmVz6qWeFsoEN1FtmoFdAohkSTFhnKHpdjfDqcwSrsGCL0INcbaeyjJLsTOzLtGZfqiJJdLCxTy4nLpX9nuRbZznKstMRFWXmLIKDOTmupd2HwK530LeKho6eV/Mi//1x3OAJ9vI0D7TbpnHe89u6WoIOwQK4i+9odM6YRFgTXbcBwhxSr/B0Tez9twplJ2hxAIh1DtG34YG3FUfGMLfmFlv87LxUYzNpszw/PxpoqKcNiBIWzoFfCBzMgrMek2Zqr7IdE11QT8qMgNbXvkHaYJnM3Z8s2jxg== 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=MI/7ECuG7zTs81R9Hkh85f9e8IjioqOyLL4eaMNKOIA=; b=DOAsZMoy+zZVSMf7ykaFbg1cW3mvgnvvoZygXoajRVdtcMa9TU/RFn0KTSm9JF9RaeJ0/pS3iLy9FxbTt1Z4h9++onTMdDPH0J3IkaQuCSRVCac1q4dO1NZUSFoziDf2jhB4fxQVEu3DC0vCEZqde9hRwDW9uJOiqpMPqy7H30MDwIRN7kEVHvqtyQpSWjK061QCRF3kmtVuiDM5P5vMcdE/dNby7o8/IUhhJoy8pDsb/u1TD9qHaccE2ss+OL0CHobmPKx56wMBT3GMccHUdv5j4McaXgfli/cZhBYJ/Br7t+qxt5N5eFuscoIE5hw1F9Zx0e/Uc0PHkC3IssNsQQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zenithal.me; dmarc=pass action=none header.from=zenithal.me; dkim=pass header.d=zenithal.me; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zenithal.me; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=MI/7ECuG7zTs81R9Hkh85f9e8IjioqOyLL4eaMNKOIA=; b=P6UHta5nMCPULDbAlmD/Pe43ze97x1dFTGq6uepDpeJ9SaD9c932I6152qpk196GDKw/b+GDc/nAOlsNupA3/uOs5SE0L7v4OvzSy/FXjU3FP44sk2BQg9EPe3EfXVes5TeZidKCXqhJqPnK/Mxdio5lq6NDj48gRN/XD/6hUQg= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zenithal.me; Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) by OSZP286MB1166.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:13b::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9; Thu, 13 Jan 2022 18:10:07 +0000 Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9]) by TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9%8]) with mapi id 15.20.4888.011; Thu, 13 Jan 2022 18:10:07 +0000 Date: Fri, 14 Jan 2022 02:10:04 +0800 From: "Hongren (Zenithal) Zheng" To: qemu-devel@nongnu.org Subject: [PATCH v3 1/6] hw/usb: Add CanoKey Implementation Message-ID: References: Content-Disposition: inline In-Reply-To: X-Operating-System: Linux Sun 5.10.81 X-Mailer: Mutt 2.1.5 (2021-12-30) X-ClientProxiedBy: HK2PR04CA0060.apcprd04.prod.outlook.com (2603:1096:202:14::28) To TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 4717eee8-3812-4ddc-ad34-08d9d6bfee0b X-MS-TrafficTypeDiagnostic: OSZP286MB1166:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:4714; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 0SGtEAlxD/jU16lGKxh2xLfdhuR3ynCvZY1r8Lx4SrS0myX0P1P2hADLCyWBNiBSeGcF1hcgqC8fX8ZFOzp3RkUMa0QV2iDbRjDi90Er63kqxm4s04Hf+dslpJTHvY9J9j+j6LeqfTQNSwIz/qQWZ3C/+JACgOo9vYQDeMJ0GMqGnSA/h63UW/PJqhUvU61hdhMr/GONsCQYqrA4t2/U+5j/HbNm8QU7vOjNxach1/885HtABYPlQYPAoFdDafxOoot/Ju0ELxMR75v9goop7Yn8WJprNvg/9hp39Ug8l/pf3VZwQxAygYn1RBmx5//A0W6Ja4wtUlhrlvy7hQ31kC1+jm4L3H+HUjMq0OM1LeU9bTjLb8Sk7Od4mz2/CRz3gnfx9iXYzybMIE93R3Oo2j/dZ0ncYkrWj6H+lo6Pu1KxUE0PM68VUnsRWk77Rk3h4TupkOnLFjomNAETBG7CINmgeRiS4JMb2UuowbOYqx19feGGa+H8QQ/D/DAb2liOR4Z8v0u0of5ohkRnS4TojNkFaFJ4rp9YMiET7DU0aLF4Ie/PzuO33UDhR/66MGz3Al0+owGMVYlOZvz4pVt4LuxzjxID5nwGiOUJjiiUNi+2UEVzNs/u/1FmUKkh1Pr6LoJzviJ4TzKRpMUgJd+uTlxpeHNA7YomXklUoyomVAE1pSZPRsnWgUNQPowD/VH/WN5xDt4CnQ/k1rlZe0YGa/c8eiLHVgToDeivXw+aKhAv0pNws3zu0hzwJqTuCDcXS7+KRX0mPGSbEVom+4I5Og== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(7916004)(396003)(346002)(39830400003)(366004)(136003)(376002)(6486002)(54906003)(8676002)(6666004)(186003)(4326008)(52116002)(30864003)(966005)(5660300002)(8936002)(6506007)(2906002)(38100700002)(66946007)(66556008)(66476007)(316002)(9686003)(6916009)(6512007)(86362001)(508600001)(33716001)(786003)(83380400001)(49092004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 5/2UB8qRMK+3qKOVnTbiYJvqrv0cq++BP+c9TX0eEjKewAO488TzoQmGvwwoYMBPXo9Da5XD4Izk5SyK5YLedwXJb1GMsJOfwgqubabqLLKDXhPwMcqKqdnxrjYMCgSoLfGbKSgJkMUgvwaKyF9qd19nk5mfbRZo4HfGIN4akGwCyWlK/HyqpW8n82SrDvw3z+8HNbSSRHhs7c8KhqrohJa45RkCfULSjxPIQXIC8zhWv40ZTuwZcR+keQnBxKC1TTWWeqE22yp1/KzSoajbC+4o82RiLZDAU3hfjGpb4sz8MZDn0hbUDYOloH16PeeclnNrSgMvUM1dGHSU5dNuGEDE5nWbPa29+UO2jj3cVjkWC2hjezOVto/0pqVkNHrHYz+I8N4lO/YtxrWZuDBBEXrtxHJhW+ZK8tJ90DYG10rb5PA1oEoMuuLKo3hX562+017KJkY33wpi/tBnryWnVORCfaYVDZ5YFNtpJoAUDh9GdBoVgyIxM+oNnU5nzM7huQY6s96KL+CQNewS6V0zELa68lGrAl5iHcmHtUBAljd5uTPUe8QabOGTlmald/vUjmUdzrIzWzOdfsMGl1p/9KVy+a1KOXGZOehQuJhJ+SoqCaOJCetrzHJZORqIMKNWeG14v9EozBTap8rm6kuHgPlsNeqsyyMht5gZ/Nc1E7pTsi0PzUvGwfnmqLexpnzIyuETGIplxuD9FGzkPnQPBi96kpwxgTN7tXDIcsXgxWez/EcsVWSJhvsEff+/rIXeWwqsyMm6O7F7OL3sakAppkZKNeiDCfbpETV35dk78yn8aWs4VXu+y/7sGHY8YSCQu54keVi3vJHvlYpJMb5ITIBzrXcNcIRMT57sP8O+UCw4yQNG+sTvzN8r+rMOYMQpNtCstkNmSl4SG55ZxlXuVyLuamM+eMtzvXW6XNWVqtXrPkc6q7uFNklKL/Ufcc3gGal3HL4wnlS/KhbA6Pm7PFOjlNrEhtS8vIkPp6yyAgdQ4CcBLvR8qZbl5c99lTiMHn1FbLQh+DeCgI/msKi41/uqfGRlHRFka1xjam2Sh3w5U3FDuKKZRe1FjY9IVZO+Gn7TCwn1paoy6ArlsqbihiK5QqfBiScddWsFZKE9azwFbkg3efiNhv6bfDno9sWKDA5OqjA2mtNTxMcFSFctWkxv/CtrJ6P29wFkzEFJCPBkTQzEGOyytgMX2HawT284lzovQKgkT7A/AuSBkgTNHy0075y3OYP//MO26ukJnevFaqjxR1ldYy3OGXI4w//PM6X5pTC5OZpQ6bMQNFeHLDGgkrKpN48xJ6dHkHd5C+cs+SHjhoWn4ZgxpCBcOpqdU2U/Dq1j3jVPnQuCKZJbQ1XN1wPR2AdhKAwPy4MorC7rGyy3LrNfGHRWjh30aXpg5HhXVKYQyoPh5SXhfvJXc/GCv8E70nLEFmQRCCZ5kD6AEtU8Tu1G8qzWP2kx7OaxkEIwC0IkZ1uxomRvTguILx4s2uJ+1p4ujnVVu5z8oqeVtLehrXwvEnRaMwtSMyc+DnvHIWMgP+eD6kinzBxpXo5JYuTL6NQvAmWzwwStERCUtmCNTi79ay79796sYdVZ X-OriginatorOrg: zenithal.me X-MS-Exchange-CrossTenant-Network-Message-Id: 4717eee8-3812-4ddc-ad34-08d9d6bfee0b X-MS-Exchange-CrossTenant-AuthSource: TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2022 18:10:07.2038 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 436d481c-43b1-4418-8d7f-84c1e4887cf0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 65na32Mgq9aoUZGrc+q/tqYIcqnyqrjtm1gt6m60ALtLq3G9vcYagq3mRm0KSW4w X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1166 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a01:111:f403:7010::70d (failed) Received-SPF: pass client-ip=2a01:111:f403:7010::70d; envelope-from=i@zenithal.me; helo=JPN01-TYC-obe.outbound.protection.outlook.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RDNS_NONE=0.793, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Gerd Hoffmann , contact@canokeys.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" This commit added a new emulated device called CanoKey to QEMU. CanoKey implements platform independent features in canokey-core https://github.com/canokeys/canokey-core, and leaves the USB implementation to the platform. In this commit the USB part was implemented in QEMU using QEMU's USB APIs, therefore the emulated CanoKey can communicate with the guest OS using USB. Signed-off-by: Hongren (Zenithal) Zheng --- hw/usb/canokey.c | 326 +++++++++++++++++++++++++++++++++++++++++++++++ hw/usb/canokey.h | 60 +++++++++ 2 files changed, 386 insertions(+) create mode 100644 hw/usb/canokey.c create mode 100644 hw/usb/canokey.h diff --git a/hw/usb/canokey.c b/hw/usb/canokey.c new file mode 100644 index 0000000000..6bd4dedfd2 --- /dev/null +++ b/hw/usb/canokey.c @@ -0,0 +1,326 @@ +/* + * CanoKey QEMU device implementation. + * + * Copyright (c) 2021-2022 Canokeys.org + * Written by Hongren (Zenithal) Zheng + * + * This code is licensed under the Apache-2.0. + */ + +#include "qemu/osdep.h" +#include + +#include "qemu/module.h" +#include "qemu/thread.h" +#include "qemu/main-loop.h" +#include "qapi/error.h" +#include "hw/usb.h" +#include "hw/qdev-properties.h" +#include "desc.h" +#include "canokey.h" + +#define CANOKEY_EP_IN(ep) ((ep) & 0x7F) + +#define CANOKEY_VENDOR_NUM 0x20a0 +#define CANOKEY_PRODUCT_NUM 0x42d2 + +/* + * placeholder, canokey-qemu implements its own usb desc + * Namely we do not use usb_desc_handle_contorl + */ +enum { + STR_MANUFACTURER = 1, + STR_PRODUCT, + STR_SERIALNUMBER +}; + +static const USBDescStrings desc_strings = { + [STR_MANUFACTURER] = "canokeys.org", + [STR_PRODUCT] = "CanoKey QEMU", + [STR_SERIALNUMBER] = "0" +}; + +static const USBDescDevice desc_device_canokey = { + .bcdUSB = 0x0, + .bMaxPacketSize0 = 16, + .bNumConfigurations = 0, + .confs = NULL, +}; + +static const USBDesc desc_canokey = { + .id = { + .idVendor = CANOKEY_VENDOR_NUM, + .idProduct = CANOKEY_PRODUCT_NUM, + .bcdDevice = 0x0100, + .iManufacturer = STR_MANUFACTURER, + .iProduct = STR_PRODUCT, + .iSerialNumber = STR_SERIALNUMBER, + }, + .full = &desc_device_canokey, + .str = desc_strings, +}; + + +/* Implement canokey-qemu functions */ +int canokey_emu_stall_ep(void *base, uint8_t ep) +{ + CanoKeyState *key = base; + uint8_t ep_in = CANOKEY_EP_IN(ep); /* INTR IN has ep 129 */ + qemu_mutex_lock(&key->ep_in_mutex[ep_in]); + key->ep_in_size[ep_in] = 0; + key->ep_in_status[ep_in] = CANOKEY_EP_IN_STALL; + qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); + return 0; +} + +int canokey_emu_set_address(void *base, uint8_t addr) +{ + CanoKeyState *key = base; + key->dev.addr = addr; + return 0; +} + +int canokey_emu_prepare_receive( + void *base, uint8_t ep, uint8_t *pbuf, uint16_t size) +{ + CanoKeyState *key = base; + /* + * No mutex here because it is usually called by + * canokey_emu_data_out (qemu thread), which already has mutex + */ + key->ep_out[ep] = pbuf; + key->ep_out_size[ep] = size; + return 0; +} + +int canokey_emu_transmit( + void *base, uint8_t ep, const uint8_t *pbuf, uint16_t size) +{ + CanoKeyState *key = base; + uint8_t ep_in = CANOKEY_EP_IN(ep); /* INTR IN has ep 129 */ + qemu_mutex_lock(&key->ep_in_mutex[ep_in]); + memcpy(key->ep_in[ep_in], pbuf, size); + key->ep_in_size[ep_in] = size; + key->ep_in_status[ep_in] = CANOKEY_EP_IN_READY; + qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); + return 0; +} + +uint32_t canokey_emu_get_rx_data_size(void *base, uint8_t ep) +{ + CanoKeyState *key = base; + return key->ep_out_size[ep]; +} + +static void *canokey_thread(void *arg) +{ + CanoKeyState *key = arg; + + while (true) { + /* Wait signal */ + qemu_mutex_lock(&key->key_mutex); + qemu_cond_wait(&key->key_cond, &key->key_mutex); + qemu_mutex_unlock(&key->key_mutex); + + /* Exit thread check */ + if (key->stop_thread) { + key->stop_thread = false; + break; + } + + canokey_emu_device_loop(); + } + return NULL; +} + +static void canokey_handle_reset(USBDevice *dev) +{ + CanoKeyState *key = CANOKEY(dev); + for (int i = 0; i != CANOKEY_EP_NUM; ++i) { + key->ep_in_status[i] = CANOKEY_EP_IN_WAIT; + key->ep_in_pos[i] = 0; + } + canokey_emu_reset(); +} + +static void canokey_handle_control(USBDevice *dev, USBPacket *p, + int request, int value, int index, int length, uint8_t *data) +{ + CanoKeyState *key = CANOKEY(dev); + + canokey_emu_setup(request, value, index, length); + qemu_cond_signal(&key->key_cond); + + uint8_t ep_in = CANOKEY_EP_IN(p->ep->nr); + uint32_t dir_in = request & DeviceRequest; + if (!dir_in) { + /* OUT */ + qemu_mutex_lock(&key->key_mutex); + if (key->ep_out[0] != NULL) { + memcpy(key->ep_out[0], data, length); + } + canokey_emu_data_out(p->ep->nr, data); + qemu_cond_signal(&key->key_cond); + qemu_mutex_unlock(&key->key_mutex); + } + + /* IN */ + qemu_mutex_lock(&key->ep_in_mutex[ep_in]); + if (key->ep_in_status[ep_in] == CANOKEY_EP_IN_WAIT) { + p->status = USB_RET_NAK; + qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); + return; + } + if (key->ep_in_status[ep_in] == CANOKEY_EP_IN_STALL) { + p->status = USB_RET_STALL; + } + key->ep_in_status[ep_in] = CANOKEY_EP_IN_WAIT; + memcpy(data, key->ep_in[ep_in], key->ep_in_size[ep_in]); + p->actual_length = key->ep_in_size[ep_in]; + + qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); +} + +static void canokey_handle_data(USBDevice *dev, USBPacket *p) +{ + CanoKeyState *key = CANOKEY(dev); + + uint8_t ep_in = CANOKEY_EP_IN(p->ep->nr); + uint8_t ep_out = p->ep->nr; + uint32_t in_len; + switch (p->pid) { + case USB_TOKEN_OUT: + qemu_mutex_lock(&key->key_mutex); + if (p->iov.size > key->ep_out_size[ep_out]) { + /* unlikely we will reach here, but check still needed */ + p->status = USB_RET_NAK; + qemu_mutex_unlock(&key->key_mutex); + break; + } + usb_packet_copy(p, key->ep_out[ep_out], p->iov.size); + key->ep_out_size[ep_out] = p->iov.size; + canokey_emu_data_out(ep_out, NULL); + qemu_cond_signal(&key->key_cond); + qemu_mutex_unlock(&key->key_mutex); + break; + case USB_TOKEN_IN: + qemu_mutex_lock(&key->ep_in_mutex[ep_in]); + if (key->ep_in_pos[ep_in] == 0) { + canokey_emu_data_in(ep_in); + qemu_cond_signal(&key->key_cond); + if (key->ep_in_status[ep_in] == CANOKEY_EP_IN_WAIT) { + p->status = USB_RET_NAK; + qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); + break; + } + if (key->ep_in_status[ep_in] == CANOKEY_EP_IN_STALL) { + p->status = USB_RET_STALL; + } + key->ep_in_status[ep_in] = CANOKEY_EP_IN_WAIT; + + in_len = MIN(key->ep_in_size[ep_in], p->iov.size); + usb_packet_copy(p, key->ep_in[ep_in], in_len); + if (in_len < key->ep_in_size[ep_in]) { + key->ep_in_pos[ep_in] = in_len; + } + } else { + in_len = MIN(key->ep_in_size[ep_in] - key->ep_in_pos[ep_in], + p->iov.size); + usb_packet_copy(p, + key->ep_in[ep_in] + key->ep_in_pos[ep_in], in_len); + key->ep_in_pos[ep_in] += in_len; + if (key->ep_in_pos[ep_in] == key->ep_in_size[ep_in]) { + key->ep_in_pos[ep_in] = 0; + } + } + qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); + break; + default: + p->status = USB_RET_STALL; + break; + } +} + +static void canokey_realize(USBDevice *base, Error **errp) +{ + CanoKeyState *key = CANOKEY(base); + + if (key->file == NULL) { + error_setg(errp, "You must provide file=/path/to/canokey-file"); + return; + } + + usb_desc_init(base); + + /* Synchronization */ + qemu_cond_init(&key->key_cond); + qemu_mutex_init(&key->key_mutex); + for (int i = 0; i != CANOKEY_EP_NUM; ++i) { + qemu_mutex_init(&key->ep_in_mutex[i]); + key->ep_in_status[i] = CANOKEY_EP_IN_WAIT; + key->ep_in_pos[i] = 0; + } + + if (canokey_emu_init(key, key->file)) { + error_setg(errp, "canokey can not create or read %s", key->file); + return; + } + + /* Thread */ + key->stop_thread = false; + qemu_thread_create(&key->key_thread, "canokey", canokey_thread, + key, QEMU_THREAD_JOINABLE); +} + +static void canokey_unrealize(USBDevice *base) +{ + CanoKeyState *key = CANOKEY(base); + + /* Thread */ + key->stop_thread = true; + qemu_cond_signal(&key->key_cond); + qemu_thread_join(&key->key_thread); + + /* Synchronization */ + qemu_cond_destroy(&key->key_cond); + qemu_mutex_destroy(&key->key_mutex); + for (int i = 0; i != CANOKEY_EP_NUM; ++i) { + qemu_mutex_destroy(&key->ep_in_mutex[i]); + } +} + +static Property canokey_properties[] = { + DEFINE_PROP_STRING("file", CanoKeyState, file), + DEFINE_PROP_END_OF_LIST(), +}; + +static void canokey_class_init(ObjectClass *klass, void *data) +{ + DeviceClass *dc = DEVICE_CLASS(klass); + USBDeviceClass *uc = USB_DEVICE_CLASS(klass); + + uc->product_desc = "CanoKey QEMU"; + uc->usb_desc = &desc_canokey; + uc->handle_reset = canokey_handle_reset; + uc->handle_control = canokey_handle_control; + uc->handle_data = canokey_handle_data; + uc->handle_attach = usb_desc_attach; + uc->realize = canokey_realize; + uc->unrealize = canokey_unrealize; + dc->desc = "CanoKey QEMU"; + device_class_set_props(dc, canokey_properties); +} + +static const TypeInfo canokey_info = { + .name = TYPE_CANOKEY, + .parent = TYPE_USB_DEVICE, + .instance_size = sizeof(CanoKeyState), + .class_init = canokey_class_init +}; + +static void canokey_register_types(void) +{ + type_register_static(&canokey_info); +} + +type_init(canokey_register_types) diff --git a/hw/usb/canokey.h b/hw/usb/canokey.h new file mode 100644 index 0000000000..d17648fff6 --- /dev/null +++ b/hw/usb/canokey.h @@ -0,0 +1,60 @@ +/* + * CanoKey QEMU device header. + * + * Copyright (c) 2021-2022 Canokeys.org + * Written by Hongren (Zenithal) Zheng + * + * This code is licensed under the Apache-2.0. + */ + +#ifndef CANOKEY_H +#define CANOKEY_H + +#include "hw/qdev-core.h" + +#define TYPE_CANOKEY "canokey" +#define CANOKEY(obj) \ + OBJECT_CHECK(CanoKeyState, (obj), TYPE_CANOKEY) + +/* + * State of the Canokey (i.e. hw/canokey.c) + */ + +/* CTRL INTR BULK */ +#define CANOKEY_EP_NUM 3 +/* BULK IN CAN BE UP TO 500 bytes */ +#define CANOKEY_EP_IN_BUFFER_SIZE 1024 + +typedef enum { + CANOKEY_EP_IN_WAIT, + CANOKEY_EP_IN_READY, + CANOKEY_EP_IN_STALL +} CanoKeyEPStatus; + +typedef struct CanoKeyState { + USBDevice dev; + uint8_t idle; + + /* IN packets from canokey device loop */ + uint8_t ep_in[CANOKEY_EP_NUM][CANOKEY_EP_IN_BUFFER_SIZE]; + /* for IN larger than p->iov.size, we would do multiple handle_data() */ + uint32_t ep_in_pos[CANOKEY_EP_NUM]; + uint32_t ep_in_size[CANOKEY_EP_NUM]; + CanoKeyEPStatus ep_in_status[CANOKEY_EP_NUM]; + QemuMutex ep_in_mutex[CANOKEY_EP_NUM]; + + /* OUT pointer to canokey recv buffer */ + uint8_t *ep_out[CANOKEY_EP_NUM]; + uint32_t ep_out_size[CANOKEY_EP_NUM]; + + /* Properties */ + char *file; /* canokey-file */ + + /* Emulation thread and sync */ + QemuCond key_cond; + QemuMutex key_mutex; + QemuThread key_thread; + bool stop_thread; +} CanoKeyState; + +#endif /* CANOKEY_H */ From patchwork Thu Jan 13 18:10:23 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hongren Zheng X-Patchwork-Id: 1579770 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=zenithal.me header.i=@zenithal.me header.a=rsa-sha256 header.s=selector1 header.b=ReNoB55e; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org (client-ip=209.51.188.17; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4JZXbW22mNz9sP7 for ; Fri, 14 Jan 2022 05:12:53 +1100 (AEDT) Received: from localhost ([::1]:54302 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n84af-0000Jk-W5 for incoming@patchwork.ozlabs.org; Thu, 13 Jan 2022 13:12:50 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45292) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Yl-0000He-GE for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:10:52 -0500 Received: from [2a01:111:f403:7010::70d] (port=45377 helo=JPN01-TYC-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Yj-0001eJ-ND for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:10:51 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ITjgWOywhhP4NCvoclvCuX8llqwBTMpJqvu4ESt+nF7H8FWeNGS4eqo/IyS0uV/D5GPwvf5S7q2KvI+rDCptjM73HQGDs2LrJ/zZ5o4dBokfVPVB/k41g4ZPn1KuPdus7qonfvJaiNakJs3XZFEbZpH6WCyQ6MFt1SKyu5IauzcsAtgOt0SXbQB/S1BCgbSS3PSpwnQqQPTQORW4D4pJZISnimLREj0iVQtEwQ57rRLQBIoqFiCgyL5wkFuCQDu/c+ULpSXTcxCuruZj/BD/CZXP+pqxqv7ldwUAdU21WbnI/BpnKlsJh7FF+AmjgA2BQbL12CEOpJNBki504V09Rw== 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=udim2FuE295RaRqsTASFxBH7qLv79wLFB65K43Ezzz4=; b=R5+7dQIrbA0Pj4TDKTLhwhIOXwuHqKWwOmZrTkXDIpe6/EI3t/Z1nuLoRGFSpPlboLl+1iY9uXvFgWV6/A0Xsy3BX2gWH8CNm7zdMtNu0SKLdSaBukmC1C1I9HwVXPKA8ZYd2TK7KkOuFVb57Pkm0XktE3Mp2mPldA0YYa7A0WhxUk/YA5DCCPkKVc6yPoPvDjm3F3M75EJoNDseO8zZ42WcZTF+6Ug0tloIgaQkFrHyuXA6G/begT7GV1WaBz5rJKcsCYhaOCIu7ohLlV4sdv/FbULtVgxOwHY8+/tQc++wnYn0CJQcb6x/yES+cWQZ69+GvpnC9BkTmuRnZ+0GIg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zenithal.me; dmarc=pass action=none header.from=zenithal.me; dkim=pass header.d=zenithal.me; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zenithal.me; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=udim2FuE295RaRqsTASFxBH7qLv79wLFB65K43Ezzz4=; b=ReNoB55eGoHQiMyj9mgEUEfWaJBMrDHUBUD07Qd5GwR/tp+pbv3gnsUXPmZt9tVhUvQMXVPvrUbIwCSvWt1uRhm0ziO+jkUO68UGc0oq+CbCr8H1KYl3/LqRbIJs1CiYIEqFpxk+u/wbuLsvoPsxlcOHhvn01KggwQAyeYoTvCY= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zenithal.me; Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) by OSZP286MB1166.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:13b::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9; Thu, 13 Jan 2022 18:10:25 +0000 Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9]) by TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9%8]) with mapi id 15.20.4888.011; Thu, 13 Jan 2022 18:10:25 +0000 Date: Fri, 14 Jan 2022 02:10:23 +0800 From: "Hongren (Zenithal) Zheng" To: qemu-devel@nongnu.org Subject: [PATCH v3 2/6] hw/usb/canokey: Add trace events Message-ID: References: Content-Disposition: inline In-Reply-To: X-Operating-System: Linux Sun 5.10.81 X-Mailer: Mutt 2.1.5 (2021-12-30) X-ClientProxiedBy: HK2PR04CA0059.apcprd04.prod.outlook.com (2603:1096:202:14::27) To TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 00d6f694-32ce-402d-dd22-08d9d6bff925 X-MS-TrafficTypeDiagnostic: OSZP286MB1166:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:376; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: xte+x9fpDfXnFH3bhzHMzbaibojlHDx6MA08UQMNvCxOtM89/7kh/i9GUd6z70pralzPjbRmH+yBjqP2zVCcdYNJKpEA4zDQYxHX5HjvYmrV8+SsFqOtl2Cl5+bbdtTt6azNnTalG++qhG5TB9Dqgm4WgJ8Dl5XV7I9iCsEBi0JrO7ea0EHEVa+02Ci/vBGG1C3v5+3f7J81cKdsa/OjPGcfyb/TPgTH5Ivb3Kgohl4jefnF2Kwh7S13fb0uMHgGN3emuq01aC7MmJRT930HmuU08qpzlSdIJY1Mboth+p1Bi30Q/k5Kzzzkck/uBJZ23Ja9PhetncMDG4MiUC8Z/+6lQfL2/U8ZrxE024XqUtqmdQ+1fZqW/ua6jLrn8M8/9DSjKRHXHq641DFG5WZCEvS5tQLbHtuGS0Sa90GRhJTAtrkX0NjL+ze8ncu/FAwwjXYqpNDfDTmbFutxDNijFaHZiIR+Ev6VnEKr6dpDAELMBPFUE9ckNCAUgAkFygZ4kiwuHF3rgDc81jtlhn7tnG2mJuK55bJLVKt1moy2cmnfUw3tFu70CbIH2M9ylyeMr//HC1C0UQspxXN0M5sLkW8XrS7iYK7/IeEGQ2bJjVNP4KL5eO3NgEef4aaSCNc0OoielxAoh9UTjrzQnxxwuf2ftHEU4KpBXcztSEC7sJ6ee45abWizlB+Tt1IMmvUENZW1P9uk7EcxPuBDoo8I/A== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(7916004)(396003)(346002)(39830400003)(366004)(136003)(376002)(6486002)(54906003)(8676002)(186003)(4326008)(52116002)(5660300002)(8936002)(6506007)(2906002)(38100700002)(66946007)(66556008)(66476007)(316002)(9686003)(6916009)(6512007)(86362001)(508600001)(33716001)(786003)(83380400001)(49092004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: KYG/6cHXfmWAo/OSaR5RDStY+2zriVCUij8CMh2siTnW/fRDU+u+EajEcxZWHBoUlU39wwsh+c0kcl6LzywGhoQicRzvwpqqKxrwr0rS27GqVFDLfab6KWEerHkAWWhy2HEOwoSCqwKxE7BYD2f1ZnNu1zgctssCP84UMxxl9KroqWSgQupq782kfQ3k7aZxxFxcq7WKWdQlgoeHFKh4PPWM9uayu+ne/yFg1uMNr8fbMoNlnHpk8J/QFYQQAcebAqLmleaGA77SPfNVEBAF6pC2YljPQ0M3/tq2ndSMaiNirdQQIDJDXNsc1ucium6wxmieghQgQ4NhRFiIkED8dW7CEgz84plkqmXIQkLNKtp1Ef1F9zYsOKnurSGFZ5dn8nP4sXfl2sFWO3ktXzMp3EExXlYlgkEArWLM9cSagJh0r42Gr6BW7FidMmdvp9QUhiUE7u6NXfq0kc20zE2Om53giAQ4zqiiRjNPHomRYGzjhZop2D2nuIuhtIkVFT3DcX5pJX6ipJtJM00ncGwJ4h0UtGPZaV2BfgfDnxsdTGQY5vg2xm1+aGfDL/kvEsgQLjb9Ewb6YpdUC5r78s4hyHd0BUrRCByrvFXnMytTtI3PiD5iFJAQrZeVuIuEcbYs2581mP8FzZx/Jl3wzI/mDCBCVUfDv50dvFbDnUjDmAlkYEHwCoiuEBYiUl4db1bS054MEfBhvmXAgPJozaZDhwjOCoqXGwGazfLoiq0GDYpC17FJfVY1TFh+pofqaXSqS8D0ZvKhfPpIluLhVgpPs6KRztEIRluU2p8F7EZ/V/DxJqBN29Suyu2vMX1gxKH/WT7OlGRld92pIx3NFkTY+a7iCyBLsPPU/WQnuIF9Pp4TrFcgyZ3tIC2BkQQ2VmnNbPa/jIsqrxDgV09VzolNccZyyfw4nLE1Gblx0y47pDKheHg0Tq1iy/OwubSZC808DlgtoE4mCbnkj2C57KwSeq5bKczG0SP1+tgApw1z5lry6AfRO4xsO6bVzOeOOd/hi8RQLztNdTzfY6XlKDs2vQ97BV0Esug/R8QLUoBUE4E1NYyHmTC1AjXrT6Q/STab+t8vV7JgroyHZDkUh5hFEp6EJpn6gJhxPgfDGsBprvDq+wKh54Qggatu0BvDVCFp2X1FTnsSv7pl9gjlA10jTrD3MszJOrriD4Trn8egCwoRdxipDEcxSy3+iZEmEnpe7ZR2zL/0Akhe/yKCzll8HDE4dH1LsT2qyLBmCVZ82IoRHrJUwoHQBpVOaqebi7k5cUKTqYqYRTUAn52wj0vpzEdEZWRvJV4fdZeTUDThWI2/bc8zXM6wi3DJEKYQ0NshB9UNywKDULn8TPi7nLjjd+weyrMu7pZbvygay1yfSZvAWPbBP61Tq/ZpcXVQTLRv/W/c6HfqgYgBn8BBkrg0eXyRce19vAXK6+wlJj0QzgagdhC4SCjYvLXri3Ud7CxMYCWTQRAj1CayF4ocO6kgFYuGNXOFVzaxNP03cJD+QaZwdMUXaQ3uSPRyFptbz0FHFPbPvU1Tz1dD4Txd7YFxOs1kOVU8AZmZTQmZCv3ERYKebAvarwSrkXI9agBRExcy X-OriginatorOrg: zenithal.me X-MS-Exchange-CrossTenant-Network-Message-Id: 00d6f694-32ce-402d-dd22-08d9d6bff925 X-MS-Exchange-CrossTenant-AuthSource: TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2022 18:10:25.8303 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 436d481c-43b1-4418-8d7f-84c1e4887cf0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: eBSQR3xjcQVHDASdoEgGAg+7mF5cfWOV/DilQ0iwRUZY0WU6eh1FUfqANkraP+eE X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1166 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a01:111:f403:7010::70d (failed) Received-SPF: pass client-ip=2a01:111:f403:7010::70d; envelope-from=i@zenithal.me; helo=JPN01-TYC-obe.outbound.protection.outlook.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RDNS_NONE=0.793, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Gerd Hoffmann , contact@canokeys.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" Signed-off-by: Hongren (Zenithal) Zheng --- hw/usb/canokey.c | 18 ++++++++++++++++++ hw/usb/trace-events | 17 +++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/hw/usb/canokey.c b/hw/usb/canokey.c index 6bd4dedfd2..2899515b6e 100644 --- a/hw/usb/canokey.c +++ b/hw/usb/canokey.c @@ -16,6 +16,7 @@ #include "qapi/error.h" #include "hw/usb.h" #include "hw/qdev-properties.h" +#include "trace.h" #include "desc.h" #include "canokey.h" @@ -64,6 +65,7 @@ static const USBDesc desc_canokey = { /* Implement canokey-qemu functions */ int canokey_emu_stall_ep(void *base, uint8_t ep) { + trace_canokey_emu_stall_ep(ep); CanoKeyState *key = base; uint8_t ep_in = CANOKEY_EP_IN(ep); /* INTR IN has ep 129 */ qemu_mutex_lock(&key->ep_in_mutex[ep_in]); @@ -75,6 +77,7 @@ int canokey_emu_stall_ep(void *base, uint8_t ep) int canokey_emu_set_address(void *base, uint8_t addr) { + trace_canokey_emu_set_address(addr); CanoKeyState *key = base; key->dev.addr = addr; return 0; @@ -83,6 +86,7 @@ int canokey_emu_set_address(void *base, uint8_t addr) int canokey_emu_prepare_receive( void *base, uint8_t ep, uint8_t *pbuf, uint16_t size) { + trace_canokey_emu_prepare_receive(ep, size); CanoKeyState *key = base; /* * No mutex here because it is usually called by @@ -96,6 +100,7 @@ int canokey_emu_prepare_receive( int canokey_emu_transmit( void *base, uint8_t ep, const uint8_t *pbuf, uint16_t size) { + trace_canokey_emu_transmit(ep, size); CanoKeyState *key = base; uint8_t ep_in = CANOKEY_EP_IN(ep); /* INTR IN has ep 129 */ qemu_mutex_lock(&key->ep_in_mutex[ep_in]); @@ -114,6 +119,7 @@ uint32_t canokey_emu_get_rx_data_size(void *base, uint8_t ep) static void *canokey_thread(void *arg) { + trace_canokey_thread_start(); CanoKeyState *key = arg; while (true) { @@ -124,6 +130,7 @@ static void *canokey_thread(void *arg) /* Exit thread check */ if (key->stop_thread) { + trace_canokey_thread_stop(); key->stop_thread = false; break; } @@ -135,6 +142,7 @@ static void *canokey_thread(void *arg) static void canokey_handle_reset(USBDevice *dev) { + trace_canokey_handle_reset(); CanoKeyState *key = CANOKEY(dev); for (int i = 0; i != CANOKEY_EP_NUM; ++i) { key->ep_in_status[i] = CANOKEY_EP_IN_WAIT; @@ -146,6 +154,7 @@ static void canokey_handle_reset(USBDevice *dev) static void canokey_handle_control(USBDevice *dev, USBPacket *p, int request, int value, int index, int length, uint8_t *data) { + trace_canokey_handle_control_setup(request, value, index, length); CanoKeyState *key = CANOKEY(dev); canokey_emu_setup(request, value, index, length); @@ -155,6 +164,7 @@ static void canokey_handle_control(USBDevice *dev, USBPacket *p, uint32_t dir_in = request & DeviceRequest; if (!dir_in) { /* OUT */ + trace_canokey_handle_control_out(); qemu_mutex_lock(&key->key_mutex); if (key->ep_out[0] != NULL) { memcpy(key->ep_out[0], data, length); @@ -179,6 +189,8 @@ static void canokey_handle_control(USBDevice *dev, USBPacket *p, p->actual_length = key->ep_in_size[ep_in]; qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); + + trace_canokey_handle_control_in(p->actual_length); } static void canokey_handle_data(USBDevice *dev, USBPacket *p) @@ -190,9 +202,12 @@ static void canokey_handle_data(USBDevice *dev, USBPacket *p) uint32_t in_len; switch (p->pid) { case USB_TOKEN_OUT: + trace_canokey_handle_data_out(ep_out); qemu_mutex_lock(&key->key_mutex); if (p->iov.size > key->ep_out_size[ep_out]) { /* unlikely we will reach here, but check still needed */ + trace_canokey_handle_data_out_err( + ep_out, p->iov.size, key->ep_out_size[ep_out]); p->status = USB_RET_NAK; qemu_mutex_unlock(&key->key_mutex); break; @@ -213,6 +228,7 @@ static void canokey_handle_data(USBDevice *dev, USBPacket *p) qemu_mutex_unlock(&key->ep_in_mutex[ep_in]); break; } + trace_canokey_handle_data_in(ep_in); if (key->ep_in_status[ep_in] == CANOKEY_EP_IN_STALL) { p->status = USB_RET_STALL; } @@ -243,6 +259,7 @@ static void canokey_handle_data(USBDevice *dev, USBPacket *p) static void canokey_realize(USBDevice *base, Error **errp) { + trace_canokey_realize(); CanoKeyState *key = CANOKEY(base); if (key->file == NULL) { @@ -274,6 +291,7 @@ static void canokey_realize(USBDevice *base, Error **errp) static void canokey_unrealize(USBDevice *base) { + trace_canokey_unrealize(); CanoKeyState *key = CANOKEY(base); /* Thread */ diff --git a/hw/usb/trace-events b/hw/usb/trace-events index b8287b63f1..4ffed7193c 100644 --- a/hw/usb/trace-events +++ b/hw/usb/trace-events @@ -345,3 +345,20 @@ usb_serial_set_baud(int bus, int addr, int baud) "dev %d:%u baud rate %d" usb_serial_set_data(int bus, int addr, int parity, int data, int stop) "dev %d:%u parity %c, data bits %d, stop bits %d" usb_serial_set_flow_control(int bus, int addr, int index) "dev %d:%u flow control %d" usb_serial_set_xonxoff(int bus, int addr, uint8_t xon, uint8_t xoff) "dev %d:%u xon 0x%x xoff 0x%x" + +# canokey.c +canokey_emu_stall_ep(uint8_t ep) "ep %d" +canokey_emu_set_address(uint8_t addr) "addr %d" +canokey_emu_prepare_receive(uint8_t ep, uint16_t size) "ep %d size %d" +canokey_emu_transmit(uint8_t ep, uint16_t size) "ep %d size %d" +canokey_thread_start(void) +canokey_thread_stop(void) +canokey_handle_reset(void) +canokey_handle_control_setup(int request, int value, int index, int length) "request 0x%04X value 0x%04X index 0x%04X length 0x%04X" +canokey_handle_control_out(void) +canokey_handle_control_in(int actual_len) "actual len %d" +canokey_handle_data_out(uint8_t ep_out) "ep %d" +canokey_handle_data_out_err(uint8_t ep_out, uint32_t income, uint32_t buffer_size) "ep %d overflow! income %d, buffer size %d" +canokey_handle_data_in(uint8_t ep_out) "ep %d" +canokey_realize(void) +canokey_unrealize(void) From patchwork Thu Jan 13 18:11:08 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hongren Zheng X-Patchwork-Id: 1579774 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=zenithal.me header.i=@zenithal.me header.a=rsa-sha256 header.s=selector1 header.b=ZlffYc5B; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org (client-ip=209.51.188.17; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4JZXjn3mR0z9sRR for ; Fri, 14 Jan 2022 05:18:19 +1100 (AEDT) Received: from localhost ([::1]:33188 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n84fw-0005fs-Dr for incoming@patchwork.ozlabs.org; Thu, 13 Jan 2022 13:18:16 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45740) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Zk-0000z6-Lg for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:11:52 -0500 Received: from [2a01:111:f403:7010::702] (port=49479 helo=JPN01-TYC-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Zc-0001t7-PO for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:11:51 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jnSYeH8o/s9TqbEl8NhnXVm9bIGlH7hFyIBMK+dJJ5xxXUipaYBqEqsEBz/51zlU3oucQfGBp71jSbEjsxKInjjLjiPw0EZunJo2N2txSJypbsqsc4VWPtsz6aBHJypicZkm2P4JEgZnghBLAFb2Xfeign8+Fp4O+14cUZcCVCW9ruixyVPI8Cr3RYWEp3yR8jrMhjTJBlHMRpGL8b2QTOBsecFG3J68J7HjxNFuqiGQ/ZtVjmaBLSfl4c1vFnb4+pkS359kXRkJ/hOt6OBeBkDfK/YuhI800VWFQibe25M8B3MRqDfaRXRt1o5hRvoDB9IbK9+LFqrk4YHrd9U4fw== 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=5PBc5QjGjN0cyimI8SWc/GYiN9RNBNKFiQItH69aFsY=; b=YJU3w2IrSegpQ2a9k7hl5UIb9I64acqSW9E+jfWxAVNKlU4BYWvcxsnixwR5khsF/zry/iiwOXRu/bdvTkhdgv1Me0VDM5k0sp+x+zWCZhV4CLIK2zlYzPMVS9kaxNla1ZF42/5PdB7Wn+0NYvov1T4yOB0jXDPgamkM28Yt6P2jk3fICut83MAuq974cxevFB1JBfTRnv/CPhnDLo+zbmAkxh4ED76kvhFuBEWX7TGVrI4Gj8kjRse0rcRNc2FkO2MdlDv9wQUtAJ3FvEH2jKYMhbQU2lguKR4vqRy+HGnKAFMQMSlZSrs2KWsEmbfg4uvBD4saR2M3PGBHcvO7wQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zenithal.me; dmarc=pass action=none header.from=zenithal.me; dkim=pass header.d=zenithal.me; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zenithal.me; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=5PBc5QjGjN0cyimI8SWc/GYiN9RNBNKFiQItH69aFsY=; b=ZlffYc5BrvNMQam9YA++ttiFgPB8zamNhTmwgKVV/mAeRzHyG142YEkVfbLqKsY4SVzNJgSWwaTVHsCmNujQAMJihnC5IOUvrvnzkdpasNHAtvussP4rQSrajuVbP+sMnhew+1i664RkXJyFdhPTouvdvnF25a5JtD/BSR3anDw= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zenithal.me; Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) by OSZP286MB1166.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:13b::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9; Thu, 13 Jan 2022 18:11:10 +0000 Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9]) by TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9%8]) with mapi id 15.20.4888.011; Thu, 13 Jan 2022 18:11:10 +0000 Date: Fri, 14 Jan 2022 02:11:08 +0800 From: "Hongren (Zenithal) Zheng" To: qemu-devel@nongnu.org Subject: [PATCH v3 3/6] meson: Add CanoKey Message-ID: References: Content-Disposition: inline In-Reply-To: X-Operating-System: Linux Sun 5.10.81 X-Mailer: Mutt 2.1.5 (2021-12-30) X-ClientProxiedBy: HK2PR04CA0060.apcprd04.prod.outlook.com (2603:1096:202:14::28) To TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: da3aa151-855a-452b-b023-08d9d6c0138e X-MS-TrafficTypeDiagnostic: OSZP286MB1166:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:238; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: TIT6VbiLsA5A/e4HwJ+6bJtWmmgmz/5mJbugtK/QwSs//G6Lpc6kqsTdcuKLqkhqICJZBFNZDTTTEJl27jZ1CUVS64Q07YQevSmyWoD3okQ78avxA+aaGTngNsLRGInVjD2qlakc66g7zVrldVkbU6xYyWXSRDSETmD0bm6QeWUrAMkgrMaA4XPk1sdxCKJBnuKpTTqde28Ef9wdH8gGc/tymiu1gaoESYmzeFzBjztfQNOpmDq2GsEiFpAVktxVs6/lb8INYx5ynSM4Gj33cqY4Qz/MHA6yCmpnOD/TgeISmgWd6gwFdSL9kHhiZ73SKvCLlq/Cz1vSWMOfwUWFWMUug101VJWHwB0gmDJQbcMjK/yjf9p6fNzcof1gOIuHa7RDszjKfN3lblbqF1mv/f68BJJkxOXAPFs6Ot6X9fXi9cx8jmCU5vf6EFHCaLodc+pWQM3/ILBHDmbIyMFPgNpL8vc+AcX/7+s3ttqN69chZShl1TtFvYRkrbjFdo5JH6aj8QUx3qgAS+6U36/2MIDGNB/dYl9OlUDJgJtzBSUFHFHaOwIXx2pGFn/dkteROZJRQ6OnFwEG+tr5iYS7GUOArORlQwUCjLs5G70mLKVEcy6UfWOanAjvB+TiLq63U5LN95AL16OyX2IUDrK2m0QtRfPaLIe/EW8rR3OMn+U4hlW7vyVJNgBJl0KZ+zUF X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(7916004)(396003)(346002)(39830400003)(366004)(136003)(376002)(6486002)(54906003)(8676002)(186003)(4326008)(52116002)(5660300002)(8936002)(6506007)(2906002)(38100700002)(66946007)(66556008)(66476007)(316002)(9686003)(6916009)(6512007)(86362001)(508600001)(33716001)(786003)(83380400001)(49092004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 9FacLOo7Fnn9ZG2y+USx+T5vEaKd0JImVWlo6iacVZnFW5d02yUkv8kUtpVAtVWfqiraIoSRwOFz0sGCfFLVEPGH1TiCxJkYaQA9VUTbkD2f8z2QOgj1Xp92w6rbaPjirVwUZUqU1qzJMQoQVeq+QBQARLU5KTS5sct0qHTowW7nNiAMpMEuB2bOd8ydnO5s0PS76HaMgQKFP6xUZH4cAO071SOD0L3nQgzQzfY1OejX1MJiC4VZCcETUhx1FTbCtSpRdHSTTfeW4ZcevqBUZ/pNkEcflR13ithk0+qi8v0fSci6UCkaC8LVQL2nie3oqyJkPMvlAciUn0W8f+tcAUCFZqPbvgd/D3YWzyKPfv0yuVYQjtEqjd+0lqFxWrn3UvkMTYATUXAHtVI5gzyVE5/aInpsjeXnR/rRcMCfIMNb7tvgFmi+HUOvqB/aZ25BUvCuSIWVkKliNOfwXBSodBK9u3JetGT7oERqOTa10rvTlLa/arPW2imxuhkb+wrTmXiSSerAXfBp0rWIPAtJYKGTSiMcR6EtAWkzNJpV6ygxEquwlf5oNfVK7WKUucoPuqcN7pg/BNOg7a/i3hfauniZVW6AQ3qOxFNJ3+rW0PZb+M35Y5X2TeL/9Y9ZTbgUhEYz4Z/vuwz/aSVIFKSks5uDhjJvYc95ua13uilCD8iZg0KpEUAVCsHJ70a5dV0WXRna7KH1X2WmoXJyjHp2C98BaZbXypqFlBSr4u0mfbey6uO0D+IZnwrxF7Cd0ln3rHfqoFYsP3ca/xo3KuejRXS4cbbHPmpjaQG3grWLK452e9TCn2opdVKZcy5+l3tdk98DFvFgAxNnKggfLGz8ZnTriIQ9DH9GbgVKx8NP5tWg0EpqofCGBp3C2C9KzjhLEy0o8ZZGexXzubDGZZ+QlajyL8IleW93+swoNpS+NTV6ZEqCjI122hmfucgshCCYyTAqwfrpnM/3tmdf9TEie6jzvf/t7o7B/23W7xIlly2s5voAvlF96lVVTLdW4Yn9jlDOKqlKc8QnjlzSXG+l2PpTNnAJzI1l7s508MzeC8O1xohGRKCSPBxIpo1nx1RuGkc4yOxcjw014GMRYwOl/BXHgk+kHLgFZgXRByjAIsRcAUsThk5eIrEuhC29OXXQ3CrTt+iAGP6bQk6BIk8a5js36ML/SJTUmFA5MI5BIaYSaASs96ab2VkdppZZPrNK3R7OwLQpLijS5ODC++6Gshf+au0O3f/hsMwgQJPQ/WfAmlepAq3faEzJEHUzUYjtg3K641Y+a0MbjP9Xzji7Rpxf+AsDFI2H88chij1T/jluaEEhRCMV6TOKn6/1LAqLpDXUldiPDDossvA+hJzlaCO0KEzEzvaE+A1BSbf9pfWF/gIHiW1RF0wIyBB1jFEkyWaKlTkAj/+o0Sbs1N9Rg2/uHVrIW5kaptH0/k55DB2k7hGVKle6KqAW/uD4S8C8Y59JEGU57G3NwkQvpqKnvPQbvaD5W5lUuQ8kAy8pDF7Ewg6n/ogFcRUQkSTWwkaeNIu+ZBcoHwZJay4rfgy+8us2MwIRy9L5rf1sEgZWwtoQ1cnT8iVelMUKIGjRf82D X-OriginatorOrg: zenithal.me X-MS-Exchange-CrossTenant-Network-Message-Id: da3aa151-855a-452b-b023-08d9d6c0138e X-MS-Exchange-CrossTenant-AuthSource: TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2022 18:11:10.1075 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 436d481c-43b1-4418-8d7f-84c1e4887cf0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: Hs+4+U7eceNqlTYCNxZNL/Pr8iYa5G06QLKFKeVaPoSeaHmVEWPnc3iMnSt4lG5W X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1166 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a01:111:f403:7010::702 (failed) Received-SPF: pass client-ip=2a01:111:f403:7010::702; envelope-from=i@zenithal.me; helo=JPN01-TYC-obe.outbound.protection.outlook.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RDNS_NONE=0.793, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Gerd Hoffmann , contact@canokeys.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" Signed-off-by: Hongren (Zenithal) Zheng --- hw/usb/Kconfig | 5 +++++ hw/usb/meson.build | 3 +++ meson.build | 6 ++++++ meson_options.txt | 2 ++ scripts/meson-buildoptions.sh | 3 +++ 5 files changed, 19 insertions(+) diff --git a/hw/usb/Kconfig b/hw/usb/Kconfig index 53f8283ffd..ce4f433976 100644 --- a/hw/usb/Kconfig +++ b/hw/usb/Kconfig @@ -119,6 +119,11 @@ config USB_U2F default y depends on USB +config USB_CANOKEY + bool + default y + depends on USB + config IMX_USBPHY bool default y diff --git a/hw/usb/meson.build b/hw/usb/meson.build index de853d780d..8390a29f8c 100644 --- a/hw/usb/meson.build +++ b/hw/usb/meson.build @@ -63,6 +63,9 @@ if u2f.found() softmmu_ss.add(when: 'CONFIG_USB_U2F', if_true: [u2f, files('u2f-emulated.c')]) endif +# CanoKey +softmmu_ss.add(when: 'CONFIG_USB_CANOKEY', if_true: [canokey, files('canokey.c')]) + # usb redirect if usbredir.found() usbredir_ss = ss.source_set() diff --git a/meson.build b/meson.build index 53065e96ec..89324cecbb 100644 --- a/meson.build +++ b/meson.build @@ -1186,6 +1186,12 @@ if have_system method: 'pkg-config', kwargs: static_kwargs) endif +canokey = not_found +if have_system + canokey = dependency('canokey-qemu', required: get_option('canokey'), + method: 'pkg-config', + kwargs: static_kwargs) +endif usbredir = not_found if not get_option('usb_redir').auto() or have_system usbredir = dependency('libusbredirparser-0.5', required: get_option('usb_redir'), diff --git a/meson_options.txt b/meson_options.txt index 921967eddb..7f5ffba35c 100644 --- a/meson_options.txt +++ b/meson_options.txt @@ -143,6 +143,8 @@ option('spice_protocol', type : 'feature', value : 'auto', description: 'Spice protocol support') option('u2f', type : 'feature', value : 'auto', description: 'U2F emulation support') +option('canokey', type : 'feature', value : 'auto', + description: 'CanoKey support') option('usb_redir', type : 'feature', value : 'auto', description: 'libusbredir support') option('l2tpv3', type : 'feature', value : 'auto', diff --git a/scripts/meson-buildoptions.sh b/scripts/meson-buildoptions.sh index 50bd7bed4d..56ae780d4f 100644 --- a/scripts/meson-buildoptions.sh +++ b/scripts/meson-buildoptions.sh @@ -28,6 +28,7 @@ meson_options_help() { printf "%s\n" ' bpf eBPF support' printf "%s\n" ' brlapi brlapi character device driver' printf "%s\n" ' bzip2 bzip2 support for DMG images' + printf "%s\n" ' canokey CanoKey support' printf "%s\n" ' cap-ng cap_ng support' printf "%s\n" ' cocoa Cocoa user interface (macOS only)' printf "%s\n" ' coreaudio CoreAudio sound support' @@ -115,6 +116,8 @@ _meson_option_parse() { --disable-brlapi) printf "%s" -Dbrlapi=disabled ;; --enable-bzip2) printf "%s" -Dbzip2=enabled ;; --disable-bzip2) printf "%s" -Dbzip2=disabled ;; + --enable-canokey) printf "%s" -Dcanokey=enabled ;; + --disable-canokey) printf "%s" -Dcanokey=disabled ;; --enable-cap-ng) printf "%s" -Dcap_ng=enabled ;; --disable-cap-ng) printf "%s" -Dcap_ng=disabled ;; --enable-capstone) printf "%s" -Dcapstone=enabled ;; From patchwork Thu Jan 13 18:11:41 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hongren Zheng X-Patchwork-Id: 1579775 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=zenithal.me header.i=@zenithal.me header.a=rsa-sha256 header.s=selector1 header.b=UQfDW/jw; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org (client-ip=209.51.188.17; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4JZXk447txz9sRR for ; Fri, 14 Jan 2022 05:18:36 +1100 (AEDT) Received: from localhost ([::1]:33976 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n84gD-0006Cr-Qq for incoming@patchwork.ozlabs.org; Thu, 13 Jan 2022 13:18:33 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45778) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Zo-00015D-Bb for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:11:57 -0500 Received: from [2a01:111:f403:7010::702] (port=49479 helo=JPN01-TYC-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84Zk-0001t7-CV for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:11:56 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cMgLLgPBcLcY+bvtisDhdhFe9WgJ8U4+v6j1oOmjZB00W0RTnSC0lXHHlYFbcQL7PzuJDn6fCB3tiLi2m2l4MiKJRVUCX0LNzCZFy2uOVefabmRssLN8HqDMTGOD7uMajWFy6ZEWXaiWrNfNgJHID+p+L0LgqyY6avhzzrPpjb3OIPNCzRY2AnCeyr90L0KS2SiZNiFfGPfm+3yqtF75Y4F1iGcY5hvj0BrlDr+BqrjM9a+DJ76xczNzp1eHP6H6jmUZm/00dfNRPLvvS1/En1rC6z6OUYeSoPWdGr4zjXmWVR6pG8an5JLWGlOM+MamPmw5ydFHvIhp6MpGXwU80A== 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=PoJNmgIQB+mGwaqLhSvUkV+y0pydFu6361UWYZyVskM=; b=AxJmn76/w9EmCKOnwM1nFdj3slJncNqpjDc6wo3FMavxf8/vebU+5FWwZ7m/c88RKr5LZ7twiTsSlMvMy0LtsgptCgr1gTEypHW5kfWvpqqKFsTiju6GFJ75DktdAA1WsoxFxzMo6WFWMkn1JQYUQTvAUwfv5g2W8KzzQNxZuX1LasAZ2GMSjfI/lijBLle2T/BH63MKSDtQhE6Kei4j1L4HcdlDdDj7VFiZAz+z4iiqpzyTF5An0gBlzPMXIduHdn03R09L0la2qfXcDTxJpPVVw6SHqvU3Ymw3Fts8Boz1TpyFdkTI04mN9fTWY4gIt1QKBysoLKSHlsSlvq31uQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zenithal.me; dmarc=pass action=none header.from=zenithal.me; dkim=pass header.d=zenithal.me; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zenithal.me; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=PoJNmgIQB+mGwaqLhSvUkV+y0pydFu6361UWYZyVskM=; b=UQfDW/jw8r6ZvaAHcGCC3sqiNKpBuGDPyjhwX4avUTyuThPHd9balyugKeltgUSWGl9ykpw50Gl2ALIr8bcuaQMMlDdo3xv1G59l+i/ZHxSC8aHDNoMIBWWX+bwbBvqxJkOLaEXcBzMYmDF0gITf7vv3gzhcCB8Ja75e1Il1Dos= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zenithal.me; Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) by OSZP286MB1166.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:13b::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9; Thu, 13 Jan 2022 18:11:43 +0000 Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9]) by TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9%8]) with mapi id 15.20.4888.011; Thu, 13 Jan 2022 18:11:43 +0000 Date: Fri, 14 Jan 2022 02:11:41 +0800 From: "Hongren (Zenithal) Zheng" To: qemu-devel@nongnu.org Subject: [PATCH v3 4/6] docs: Add CanoKey documentation Message-ID: References: Content-Disposition: inline In-Reply-To: X-Operating-System: Linux Sun 5.10.81 X-Mailer: Mutt 2.1.5 (2021-12-30) X-ClientProxiedBy: HK2PR04CA0057.apcprd04.prod.outlook.com (2603:1096:202:14::25) To TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 099b1937-25af-42cb-49bf-08d9d6c02781 X-MS-TrafficTypeDiagnostic: OSZP286MB1166:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: BTpSXs/oXVFF3vkj7JORmDAhtvHo82qhKXtTzWqfkEC+VWLU4/I3jueSlTPHGAKC0F9DNHYXPSLAahafvZnn0jRKRWNAZcZgruzbFnaGokeSScipNUiUP5i6LhJ65Rxt4w5EMoiDLd1V04Q+6GqOW/jWYhEFj74KjSbXQcsqYRcGPWhQ5Xcn+icINfZw5HA6qI57MOf2xNugQQ29cb8auLU/KFhGNBZFs3xnWyZWimWYeY9MoAcN2otnP5AxsjndMazfLU7ndkdx4yCOkDQCOm3Ta0GpZhhCM4HbAHOPOnTDibTZL4GwGrEeG7Gj6wxTZvyDN1QdDgLBLjzibcKVdYAR5Bijpba4pHuzcEQ77KS+0JqJgCvM7HbM2EnP4hwN116Ias0N7B3ScT5xPepURdGu/M8FNSn+kZ4Zu9hjY9LaJNm9qxi86klInfKj/BipdeSenl9t/4kpXNb2LxfbGMKNmyJXPrW3z+yJkGbCtkUXExeJtPrNaniEgYlhdjUx/PCvOYDecDvXcG1LGRsOdjUsvUPbPKd2Dy1lmX3NMKzKILONAOgnc6O8ZMLvMJIHq25HNgMYEikpgz+Qfy1DfUbNrUQBqQ1l73wcGaXG7i1ELTzxlOyFVCCd9bsbT/nEWWJ/WB9Ay+AcF5EpaQPbIvslv9bAwAT7y/5gFT0EeZ8ySRa7X0gKFMwDmFAOwbP2gVqsSNnDUHsxAPPnm0RR8n4BNmdjP4OnyQkFoJmpS3qADRn5GcI0WR6i220qF/E+jID53cLHpLQqQttRbykikg== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(7916004)(396003)(346002)(39830400003)(366004)(136003)(376002)(6486002)(54906003)(8676002)(186003)(4326008)(52116002)(966005)(5660300002)(8936002)(6506007)(2906002)(38100700002)(66946007)(66556008)(66476007)(316002)(9686003)(6916009)(6512007)(86362001)(508600001)(33716001)(786003)(83380400001)(49092004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: k+mFOJ8H/rOjPlQSuf4z7OB1serjDvaz/UyPokzn0jJZu914b5cHi/ITgXO+wCMherIXfS2Q4VcUMFhFjttOiZsJDEDSAs1qipp72TVpMHmwmSFGveWTtAxrIHIUw/dSg4xKE1zs97suC58viAJ4bfD2n7OHjcnWhrCx1b8kbtX//y+lFEA+/2qj7YvsKwEv+hwgBTXnYX57Y0foR2FbfD2NdpCvTZLXvgDI090E1wXS1c0aRY2klUCx8TaeU+tkoJC2AUDm7oG/spNBwXWae/t++EwWnY97CA3wv8f/Gl461jAjjFCxeVDhL1d5EvqjEf/KzuRkTCMN8x5TW5zTLxOCUt4BRbmhuIrD0UYkINex8PZWH3fhsOmXXeFQ40hRiY7bXkEPovLT7z8tnSQuMN8q1ZN/t1p2Ri9uELw62ebyevX2YdapK1aFjb4zeYQtCJst1/mFuiw0j/pAMlzl43xfI5jsSLbgK6pry+ewJurCoP9GCzV4K5hukVgMlbrWU6O/Ru0GZTznJ3umVRAA/YV2eC9WqL3UsJWkW4tbhHcrUTK607gXpCu2rasgqDfMsPWb3D8zFFDgVdOnBk8x3LdA7uZN7OYUewAu04n+S80COhKtHRgK9tl2TJ0FM0RheL7ZtsK2zKB8TQ5bYsTFbmdMPoVra6yiba7mz9n90ilViUI9q97aOSYGJTYiQLYGBHufwi5nCqn2VJPRjQrp4fBRxMeayIrVKXJNd+0ci3QRZM6BGlQfudOdLcNFLH6+jAZ150V/7TRoydWjNL9gi4t8U+v6NM+JHk0XMa8sMiJ9SPLXu96tPseXEhayEcbPK05AGUs7rD6KPd79kLSbYITfWYZptuMVuGy8bezP4bUL7Xq6c5HCnWd4z8CKmXnfl+xe45MJX+hp2Zs1nGb1Rqm7f/nfNLD4yzJBrTwOuQjg76S+jcD3OIQ3LgrHb1Zma0QouDCPfa95GgOfKUY8U5QqNwDuFS+yWjW7/vMFoKOBxxXOaFD5iBEkzasnoZvOtbn483v8D1RoZPtlTOkBQN6WOGcuKuH6YPBQSX1OZ+K5L4VpDo89PWtumNMLMPiwaMismhgLaOTVsclfL1iWHH/cpCvj++8aa5FkJ9PGpKT7M1dpmU6nPw2+aM0RZRAi962EOg0ebqb8swvkKtMyS27w6u1LtOsfo/gyCL5FI+zsH/4+H9PLQhThafjXxfpfR9dfU2Isxw8y6bbmxiHAVrHGsdo/YK0+SygBRKH1mHoHISaP6PicGiwKNi2MO+fpobKb6E+qpo3XM+YBhQa0APSQ7EQHdAWmbh5jK2hH0LevhqE0NTWvD0HUuTZyASNqu6g7STZu3rlvwi9Eo3Yv7N3SS0ZoXtMV6ez4Wju8KNTJn3xIMqc34s6DbXZ+KJ5sMgz8VzgjqWObx60XG68BIEsbw1DlL8ZmDTjsnrvNUzzU0FG/xo9YjWgFYAWWUcjBPazdeGmUpwuUE2RT5lxGf/bGam1pHGKduzOjSm6BviAWkxYClIX2i3c+oFKVvXQslAiJ/6WotG9HnzYGGDMkbth2of9j+quhNsvgytW4ugqPNlSfoPABqU8/AexB49w6 X-OriginatorOrg: zenithal.me X-MS-Exchange-CrossTenant-Network-Message-Id: 099b1937-25af-42cb-49bf-08d9d6c02781 X-MS-Exchange-CrossTenant-AuthSource: TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2022 18:11:43.6047 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 436d481c-43b1-4418-8d7f-84c1e4887cf0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 5sSJ6Szl9MpKFAa1gmuXX8HIH4vLyLjKG3JeHm8sTvicGbJkR9pkfWX+Y6m3Jbgw X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1166 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a01:111:f403:7010::702 (failed) Received-SPF: pass client-ip=2a01:111:f403:7010::702; envelope-from=i@zenithal.me; helo=JPN01-TYC-obe.outbound.protection.outlook.com X-Spam_score_int: 7 X-Spam_score: 0.7 X-Spam_bar: / X-Spam_report: (0.7 / 5.0 requ) APP_DEVELOPMENT_NORDNS=1.997, BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RDNS_NONE=0.793, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Gerd Hoffmann , contact@canokeys.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" Signed-off-by: Hongren (Zenithal) Zheng --- docs/system/device-emulation.rst | 1 + docs/system/devices/canokey.rst | 158 +++++++++++++++++++++++++++++++ 2 files changed, 159 insertions(+) create mode 100644 docs/system/devices/canokey.rst diff --git a/docs/system/device-emulation.rst b/docs/system/device-emulation.rst index 19944f526c..b753fa83d0 100644 --- a/docs/system/device-emulation.rst +++ b/docs/system/device-emulation.rst @@ -89,3 +89,4 @@ Emulated Devices devices/vhost-user.rst devices/virtio-pmem.rst devices/vhost-user-rng.rst + devices/canokey.rst diff --git a/docs/system/devices/canokey.rst b/docs/system/devices/canokey.rst new file mode 100644 index 0000000000..3b40bc4511 --- /dev/null +++ b/docs/system/devices/canokey.rst @@ -0,0 +1,158 @@ +.. _canokey: + +CanoKey QEMU +------------ + +CanoKey [1]_ is an open-source secure key with supports of + +* U2F / FIDO2 with Ed25519 and HMAC-secret +* OpenPGP Card V3.4 with RSA4096, Ed25519 and more [2]_ +* PIV (NIST SP 800-73-4) +* HOTP / TOTP +* NDEF + +All these platform-independent code are in canokey-core [3]_. + +For different platforms, CanoKey has different implementations, +including both hardware implementions and virtual cards: + +* CanoKey STM32 [4]_ +* CanoKey Pigeon [5]_ +* (virt-card) CanoKey USB/IP +* (virt-card) CanoKey FunctionFS + +In QEMU, yet another CanoKey virt-card is implemented. +CanoKey QEMU exposes itself as a USB device to the guest OS. + +With the same software configuration as a hardware key, +the guest OS can use all the functionalities of a secure key as if +there was actually an hardware key plugged in. + +CanoKey QEMU provides much convenience for debuging: + +* libcanokey-qemu supports debuging output thus developers can + inspect what happens inside a secure key +* CanoKey QEMU supports trace event thus event +* QEMU USB stack supports pcap thus USB packet between the guest + and key can be captured and analysed + +Then for developers: + +* For developers on software with secure key support (e.g. FIDO2, OpenPGP), + they can see what happens inside the secure key +* For secure key developers, USB packets between guest OS and CanoKey + can be easily captured and analysed + +Also since this is a virtual card, it can be easily used in CI for testing +on code coping with secure key. + +Building +======== + +libcanokey-qemu is required to use CanoKey QEMU. + +.. code-block:: shell + + git clone https://github.com/canokeys/canokey-core + mkdir canokey-core/build + pushd canokey-core/build + +If you want to install libcanokey-qemu in a different place, +add ``-DCMAKE_INSTALL_PREFIX=/path/to/your/place`` to cmake below. + +.. code-block:: shell + + cmake .. -DQEMU=ON + make + make install # may need sudo + popd + +Then configuring and building: + +.. code-block:: shell + + # depending on your env, lib/pkgconfig can be lib64/pkgconfig + export PKG_CONFIG_PATH=/path/to/your/place/lib/pkgconfig:$PKG_CONFIG_PATH + ./configure --enable-canokey && make + +Using CanoKey QEMU +================== + +CanoKey QEMU stores all its data on a file of the host specified by the argument +when invoking qemu. + +.. parsed-literal:: + + |qemu_system| -usb -device canokey,file=$HOME/.canokey-file + +Note: you should keep this file carefully as it may contain your private key! + +The first time when the file is used, it is created and initialized by CanoKey, +afterwards CanoKey QEMU would just read this file. + +After the guest OS boots, you can check that there is a USB device. + +For example, If the guest OS is an Linux machine. You may invoke lsusb +and find CanoKey QEMU there: + +.. code-block:: shell + + $ lsusb + Bus 001 Device 002: ID 20a0:42d4 Clay Logic CanoKey + +You may setup the key as guided in [6]_. The console for the key is at [7]_. + +Debuging +======== + +CanoKey QEMU consists of two parts, ``libcanokey-qemu.so`` and ``canokey.c``, +the latter of which resides in QEMU. The former provides core functionality +of a secure key while the latter provides platform-dependent functions: +USB packet handling. + +If you want to trace what happens inside the secure key, when compiling +libcanokey-qemu, you should add ``-DENABLE_DEBUG_OUTPUT=ON`` in cmake command +line: + +.. code-block:: shell + + cmake .. -DQEMU=ON -DENABLE_DEBUG_OUTPUT=ON + +If you want to trace events happened in canokey.c, use + +.. parsed-literal:: + + |qemu_system| --trace "canokey_*" \\ + -usb -device canokey,file=$HOME/.canokey-file + +If you want to capture USB packets between the guest and the host, you can: + +.. parsed-literal:: + + |qemu_system| -usb -device canokey,file=$HOME/.canokey-file,pcap=key.pcap + +Limitations +=========== + +Currently libcanokey-qemu.so has dozens of global variables as it was originally +designed for embedded systems. Thus one qemu instance can not have +multiple CanoKey QEMU running, namely you can not + +.. parsed-literal:: + + |qemu_system| -usb -device canokey,file=$HOME/.canokey-file \\ + -device canokey,file=$HOME/.canokey-file2 + +Also, there is no lock on canokey-file, thus two CanoKey QEMU instance +can not read one canokey-file at the same time. + +References +========== + +.. [1] ``_ +.. [2] ``_ +.. [3] ``_ +.. [4] ``_ +.. [5] ``_ +.. [6] ``_ +.. [7] ``_ From patchwork Thu Jan 13 18:11:56 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hongren Zheng X-Patchwork-Id: 1579777 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=zenithal.me header.i=@zenithal.me header.a=rsa-sha256 header.s=selector1 header.b=hIo2NVBu; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org (client-ip=209.51.188.17; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4JZXmx2YWbz9sRR for ; Fri, 14 Jan 2022 05:21:05 +1100 (AEDT) Received: from localhost ([::1]:39718 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n84id-0001g2-6z for incoming@patchwork.ozlabs.org; Thu, 13 Jan 2022 13:21:03 -0500 Received: from eggs.gnu.org ([209.51.188.92]:46040) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84aT-0001rf-9c for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:12:38 -0500 Received: from [2a01:111:f403:7010::730] (port=41879 helo=JPN01-TYC-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84aR-0001yL-Rc for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:12:37 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=fd3Katjp2G+gKOxGTPqU1/xIAj/7BXIn52FpigPLiIs3pFGEKQOvMOjwurqYaYE5WZxlZPnq847Cwk6ti3UDE3UIG8fCuHdHJ3hp9cja3D5z5hkV5LdG9HtpAxGQmSz5rGyhoUlDwyEkJsPnK8WWByrorBteyjZ+dpHgTCOXW8EFyeAxMEccIcpUE3VFk2/PNeBaXkoIWXZ/fw2gXaoGje0hIMwPeWiuluFVTZpuWhdnl62Xdk36VvReYTFjPYU3InRxBtzcFBcl2tTnWf8D6z6fSAa80ixkKfujiZ7K4BApMrTkndTGmAOmv4nfl+WVvXQqZiNDTE0Bv5NGnCKXoA== 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=O8XKO/huN2cB+a81Use87V9PGHZOttZ5KeIkoMImvjM=; b=cUn3T1FvrIw/l6JrrfRV7pSuncWmBlHlDomR00r1z8n4y/Xjlv+aWAz7guCAkGXEiUsFH9MoXXejgEWwY5cxxw8l/7lYGMddYh4fAmkfr2MqMYWp6k8A5w/4FRbrtzLPvR2TXaMn2v2qL7yQ2R8cCRd1Q3c0JKBb4Ks0Iu8Ivrz2df7iZ7uFH6tWp7vMiY6QDhbICRq49N5FKVB1jqakhAPRatRnKy/bV/jB6yn/3xPiWa+d/inkmMDXDhDkRp0sM3YmI80BoXXZYPieO7fAJd2nMYJfEYiLLnhQ40GJ8WBr6DMzm8q+rOk6dzLJLKBcx0l0x1NkmbdDO9FHOCF1bg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zenithal.me; dmarc=pass action=none header.from=zenithal.me; dkim=pass header.d=zenithal.me; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zenithal.me; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=O8XKO/huN2cB+a81Use87V9PGHZOttZ5KeIkoMImvjM=; b=hIo2NVBuB4AdLehuRmlI15kCeZctDkrbIXnLJ6JjxULK6gJcoqE/Ed2FP8FIB5cMLaWcUMxiO9KjYeDyX9awwrzdVyRIZYVQpkCMXRtv0y7BM2dMXg25i0IjjIK9GZCRYTob8PLe5FaqKY24eTn+d9p46KnqLgw35UITmicAR28= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zenithal.me; Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) by OSZP286MB1166.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:13b::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9; Thu, 13 Jan 2022 18:11:59 +0000 Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9]) by TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9%8]) with mapi id 15.20.4888.011; Thu, 13 Jan 2022 18:11:59 +0000 Date: Fri, 14 Jan 2022 02:11:56 +0800 From: "Hongren (Zenithal) Zheng" To: qemu-devel@nongnu.org Subject: [PATCH v3 5/6] docs/system/devices/usb: Add CanoKey to USB devices examples Message-ID: References: Content-Disposition: inline In-Reply-To: X-Operating-System: Linux Sun 5.10.81 X-Mailer: Mutt 2.1.5 (2021-12-30) X-ClientProxiedBy: HK2PR04CA0058.apcprd04.prod.outlook.com (2603:1096:202:14::26) To TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: ffaa1560-94c6-4c9f-d147-08d9d6c030cf X-MS-TrafficTypeDiagnostic: OSZP286MB1166:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:276; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 3upRU6GJmeJFZBYjwTDdOD3+CzK6qsK8GBAfsYq6rXsbJe6qRYlDHQaryWq93P9ozgkd82ESDDPGDE1aDC8OH0j9jKAXeZZr9UksnnZ07bq3wXF4MxSTkbjdqQSoIJen9HRNAP48t4KzO2dr/OCWlR1Q7HFAIE5JNheGxVrFihi3x3unjUHayvmQDerBOAd4VKfWU2DcTJx+1lzgF42zZxVcQfGR84NoI788GT2q/XT2v+6zZQNj2nFH6ytEX21dCAKUGdMg5DL1W0/nxJr3H2sbdgqU/L5fRXR27OKPNo0fBLNPNYhVjX1jMFybz31iY3wwPqgIKxSAqFVqWk3h2fwDnaiUBPHjxnrhDr2PIOISonqxaz+vbkACdsHfgL5uBZobCfFzjqNAF4ukiTlOMNkVYRCXd2Dkera+06s0srJDOiT2356rYv4IVpAFA9AsROaG5/4bgM6gC0vpKne59wuwiPWgRCfl8xA8Sa+Z73DPwl0oDrPW1KxEWROTrVQgXbYcmVcxs+McADdsgbwjWWviL3fgpl3oAAT1vD6S6wfgGedYW44qCxEO+zfX63tmlxhIdd+ERYzgR/u3MHq8oZYBaDwkPahGkgamKUAeY+VgvNQM41yLLArgiTS4yk2CAg5ZGAluM/eDCtYLlh1DYvGFiQHxYjVG4hAMcaAqiMzCphRNXgMEf0SjNy0ycdE3y7yE+QIdhpnibKWJxDoXGA== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(7916004)(396003)(346002)(39830400003)(366004)(136003)(376002)(6486002)(54906003)(8676002)(6666004)(186003)(4326008)(52116002)(4744005)(5660300002)(8936002)(6506007)(2906002)(38100700002)(66946007)(66556008)(66476007)(316002)(9686003)(6916009)(6512007)(86362001)(508600001)(33716001)(786003)(49092004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: VjLauZMBVcXrupELC1uZbghK1b2NmIPTR0DLoWDYknGRyGGHBRAAimt4RttUUcltLpwlgFdjcRTR78VrxUgtNjSn1TUJR+KQ0zHASSzMuqmCnbxbHsUJPWQyGCnwo2ifFmt9FxuoFL+fKYKho5mozlrrNDnY5UWuWjvvdoBjPGMlyfN8AZf4BabUjVcokPopybxUpftfc4kvbwQ0pavvksmAhbPHX3qvM4eZ8MnJI2nISwWGktNHY8kM7TQLpPWAtMOt0976xWOsZGKDQqKG+MIj+Jc0QmbJq6RZH/QCOBPfPR0Xw1gedYn5lgGe6gOUYnlEV21HjfHhWyZwsVBLydENkWaAKLjelOev6/k3vm6e0Vy12MCb/OmcHre/J0u+rkt5YNGFofENXwGTour+A2GN/nvR+zwMJ7bpvIAgiD/Vg+wB6qwawWoOEwFirlpuDPcj1qou1AHebJDTbq9fR9ZM3seG6TLa3PWbF2fdXMgU2XHBQnWoyD6S/tIKd/ai9XiNW59nIE1rZyCxD+MhUj7b9AVd/nKfp5DhaPocOR7KDNJV+AsyfkDBegcEYr+KaaP0s4NfR+BHkFu9JI7l7RdKsfsikSJpS3pwbs0+IKMApgT7S99bDi2XkZjWnQtd+wYYjlPKT7aHliBPJsSLSQXf0P7Hm/SPEOijT3ujpgqiO6d+nll3g2otkW4fOgG/5LPi5/qXprWPkWwZzIkJhHRtsc2e0e7/N1rARZoC7jo81zQHSeq71x/yNRPHxFpf6lmivmTPpvs51qqTmsaUJ4wnIDRECpu5xne9gmei24aJwqsQOjdOT0jNXeEqgpyrxD/mgxkNDTyuCRWJ8BMoBAXA1KCsGemsLVOPx0dnu33Esfk6jwnexqbN80YcL6DQ6rqvClrAghS9jSujxUTE+qX2KT70gCMJp3WbaxiZPXHpOPgvbJKGvcZgcrHbJO59y/p25/kZBGGYa5vVmG0Eu8a0jc4OyrHAeSeyi7PDIH9BqEX1Ar27+9UTQmFzUlZ6DdRQEP6BhWDDtxoCHxMacf5azFjpl14bn7/pSubQKbxYcs+8uMee4nwe+V1tvx83SVT/PbuDAU9cLC0mAe41DUFttNMkIklzt/M2sFKqeqr6DIQrljoLhXw2uWjdEDiyLzMQBhvGyRmTrpLPt9YqedB5anugv5XRBuUCfcI4vw64xOej7Sc/khvQsbIYj7bW+uZ7nf6wbKstDV0kcE+l4hlfQoDbf945SztvovaVKbvE7dmEi58dbsJCFQiqGfoBzXREgLfMCSXqgNId/1ibT4nLM8jH12+hi8P8hEYdO/uaWLzbrjPGTHeAu2yUev3D4pwmidr4e4CaEYrd6jAJWMR/BttDio/0WFP1KqvEIb6fYUm0y1sxJ457f/dPrj6I/m8kRm4m0eVlkcMelW+Xu9adPVFYJCpStxRBmh2cEcP7VA0BEdlRxSlMLfnOPvMKXadgWz24qPRu+8tJjVTzGNeslq/hoa5lDm+Q/mhh6w4iUwDKIszjVSmfvBVsnf1byot6257285DGhHqnb4s7r3Kg5SDrI3hcdq46+yaJRx0L8hYX1w4/moTcGU3ytyCF X-OriginatorOrg: zenithal.me X-MS-Exchange-CrossTenant-Network-Message-Id: ffaa1560-94c6-4c9f-d147-08d9d6c030cf X-MS-Exchange-CrossTenant-AuthSource: TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2022 18:11:59.1720 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 436d481c-43b1-4418-8d7f-84c1e4887cf0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 47umCNBpOSnd5+Ra7HidOQhI2J1eS/mT9H2HohxJIH/f9f9N3rSXEr8lbffz/xS7 X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1166 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a01:111:f403:7010::730 (failed) Received-SPF: pass client-ip=2a01:111:f403:7010::730; envelope-from=i@zenithal.me; helo=JPN01-TYC-obe.outbound.protection.outlook.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RDNS_NONE=0.793, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Gerd Hoffmann , contact@canokeys.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" Signed-off-by: Hongren (Zenithal) Zheng Reviewed-by: Thomas Huth --- docs/system/devices/usb.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/system/devices/usb.rst b/docs/system/devices/usb.rst index afb7d6c226..341694403a 100644 --- a/docs/system/devices/usb.rst +++ b/docs/system/devices/usb.rst @@ -199,6 +199,9 @@ option or the ``device_add`` monitor command. Available devices are: ``u2f-{emulated,passthru}`` Universal Second Factor device +``canokey`` + An Open-source Secure Key implementing FIDO2, OpenPGP, PIV and more. + Physical port addressing ^^^^^^^^^^^^^^^^^^^^^^^^ From patchwork Thu Jan 13 18:12:12 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hongren Zheng X-Patchwork-Id: 1579772 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=zenithal.me header.i=@zenithal.me header.a=rsa-sha256 header.s=selector1 header.b=ThiBbyWZ; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org (client-ip=209.51.188.17; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4JZXct2q6qz9sRR for ; Fri, 14 Jan 2022 05:14:06 +1100 (AEDT) Received: from localhost ([::1]:56592 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n84br-00028M-FY for incoming@patchwork.ozlabs.org; Thu, 13 Jan 2022 13:14:03 -0500 Received: from eggs.gnu.org ([209.51.188.92]:46056) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84aW-0001t6-Bq for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:12:40 -0500 Received: from [2a01:111:f403:7010::730] (port=41879 helo=JPN01-TYC-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n84aU-0001yL-Km for qemu-devel@nongnu.org; Thu, 13 Jan 2022 13:12:39 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GnEQoQHbBpkjsLqm2YxAwyVvKdaZrJRWt5QwmoMtIkDwitXNbthds20Y7oWmafsIdKKLHI4UZIyhYfyYRLPTcip2FrEIWJQ8elBgOeAQ9oiRArNwxIUKaS7/CpS7XmMpm+LeKB3adB5cBr+eKJa/IbfH4kq/m8fBsyVbQ8htH0EwCa7DnRyKcPDn4sjvOnIVXVKynzZ1pPv8X+8CS8dV+xw7vAUdPFX1vQ0FbHP0mZ7/rALWuCy+jdIF92c0hbJzc1/g6jJDLh+MuRoLkpZcm2ky6MM8PwG14RuGsI7HQbph5AsBC0nM87bzL2pU+BJviPf/PGYoYWaDIFLFFhOQuA== 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=xe9iOLv7iamUXphV6+faF9atlrqNzbnQ47tgV+SXHzw=; b=WtFtzAqKmVCZNvf8/aiQM+HFBeUl4NjpxyHpL+wqzgbFy18UPOI177HtOcTqfQu/fEaHb6+5TD9AE+5cklhmwdS7ySsUrgpBX1W5m8eA9wgUBR5oCz8x4xWBAelx/eU+/QkRWGiz0JkKa+DUrqcmK9LCaV2dhYnvHmZl1u7825SJ5HsZUZ10wt6nnQBJUa3N9d7Bm6SZ43KqxesT/BUl5wkiIEccre4TCgH2EP9SFmrZd0hzhMqVrr+zW19mwwfNGyCjJ/qj3kFWK3T+g5kbYwDje3EdMvtLSm8d4628QqnG7GMEV/OjTlO0GZUaoAK6TN9ugjbZ1NG0h1DWVcEc2g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zenithal.me; dmarc=pass action=none header.from=zenithal.me; dkim=pass header.d=zenithal.me; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zenithal.me; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=xe9iOLv7iamUXphV6+faF9atlrqNzbnQ47tgV+SXHzw=; b=ThiBbyWZbr+ZGWJ0Z1I+sF0W8EgXwXZ3zqThGVCPvksYvfmN5nsgXpDxTBvbAjtaQXZTT0qM/NHB5tM1XoJP3nddL3RkuU0ZpmGFaPhCQEfjt7bNJZBoImR2B7njjNKwYzh+Kd7iY9Cwrsl85Cf8YFNU7fAk3wg35hUyn4w63q0= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zenithal.me; Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) by OSZP286MB1166.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:13b::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9; Thu, 13 Jan 2022 18:12:14 +0000 Received: from TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9]) by TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM ([fe80::5cf9:8c86:9001:90d9%8]) with mapi id 15.20.4888.011; Thu, 13 Jan 2022 18:12:14 +0000 Date: Fri, 14 Jan 2022 02:12:12 +0800 From: "Hongren (Zenithal) Zheng" To: qemu-devel@nongnu.org Subject: [PATCH v3 6/6] MAINTAINERS: add myself as CanoKey maintainer Message-ID: References: Content-Disposition: inline In-Reply-To: X-Operating-System: Linux Sun 5.10.81 X-Mailer: Mutt 2.1.5 (2021-12-30) X-ClientProxiedBy: HK2PR04CA0046.apcprd04.prod.outlook.com (2603:1096:202:14::14) To TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:c0::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 47549bfa-2b76-4531-b82a-08d9d6c03a18 X-MS-TrafficTypeDiagnostic: OSZP286MB1166:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:214; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: kHLSakfvpkJj4TMSLHjnsj5kwmKXWYtrX+MaH+1dOI6nqJjkeo5K4eW2Nl0zXcdreHiCwsgWxbDOI/lo4/7V6p7EBaZLeYeBAYstEok7phhCSrsL8EF3NaXdvXhxFuGKcuYPMf5uv2myVL01ZqGBC1xnQvwKz/MVXE9vOE3yZabjqRwaBzO3PhIu7QD4HIeZQ7F7OciWqqFT3y1NvwsZSC4alhcO8RKhnne10TLP8f5xrjav1PVC2qUKz362dhv0MKdwjxEfkSM0podxNaq6hz9od/MAKeOCwZBDhR6d6Wh+LseP6pImXLUuvM/7qt6T2IjvR7gjBkBrC1Dv6mMPU0sxAIoxAVsur3UKq+GkojFI1K0DHT99BMT77JkCwkLgXxkyd2ie2npF81JAS6O7jUh8zOLaLtu/Rh99sWa+v4fzaimYOQ3x53qZDYvxAExJoJzsZ+yJcZxYFVkYzhfwkdSt/H28m/wntv7VK19kvYu/QHdOKMHS4/KfGTQc7M9J/BCGVSBDGdwt6iaFBx5QT9zrRiFi9itwIVADbgt6KwETkNkQoczi581GVQ1vmAnc0WEStwX2rSpble+9HMLkaX/te+2jPzEPOuuUD87msNZINANdfJBNf/ShWJIcChvtTwJZXYRBaSQ3PplpwZW2DmBQ0gh76lCh7FGe9+YjSaiCbIMz4iRUorIoiVslPu7isHpc6rKrXVRQhwIei5FVaQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(7916004)(396003)(346002)(39830400003)(366004)(136003)(376002)(6486002)(54906003)(8676002)(186003)(4326008)(52116002)(4744005)(5660300002)(8936002)(6506007)(2906002)(38100700002)(66946007)(66556008)(66476007)(316002)(9686003)(6916009)(6512007)(86362001)(508600001)(33716001)(786003)(49092004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: bAxXxaO3/W0rr+yJVeCUUGzsRX0m2pEgT1pFIoD+5XNiACUO4Q84JioZtodk4Kv5SJxxzOjDZ6LiRjC+qYjA2SpyojHPJkRrGJTVmsLVIkfbmyN5V4gq6QLE6jOFszYp/GO5BXHFLDQPt74baghwAT+B4axMw3zKhMoVN2g1SvSRfAlvipSoFDPHUnG0cULFpCGbDYngM0pKaGoRhVveEP2SLkrjuW97/ITnc6LpK1mTK2+InyHUn/f7SoeaoY0ZoukHepf1tvyI7PhEkRwPMvgFuQTUJcYMS2KeUM/FRhSMW6gPWbtLT+hB7pnipjJXDzqRPrxS06beCawyuXwVBrzt+rfoA69HmNfXii9gljJXrTBk40b3bFq3LpcMHg/bHtlvpef12quRchtevZqD0uRxkbDoPRRvIZZKfiIIKHaugTVlWZ76Nwn4SOWlb4iUKp9SyxlPsONbGt/oHSFaGKGY9kgA01C4Pumm9xsxsU/5TiC7i+kH7cast13lyimEdlBlb4VPnzmvMujHwGVx/Be+QewwQzGLoMcsUJAB+kKROxFwtt5qiximvaGZatm4jor9WBZ63mkAM+A5Vsh+LfoLxC5VBADTOJ2OA/yDgDjSmPSEe3PvdyVwZhIeuCiBZa2uZGJSH8WGpmkTcNmILw7CN/uKFBI2T6Y6jaVuvNQ6MV+re/0nSqDKALdnsBEe4QEjadM8U4BE4gEPc4DeJ0G3LipvtZ1YXFwwNhHCf4OfjJ/RqdQBHiEHyEukrBtB59MDRruwfftst5z93YcmtWIJSotF1NUOQ0mfuaLBHKheraJt5LUlhyhr0uzvGZ7wtDjjhos6KN9KM+CWQ49bgaZePfxYnE50OLSIQIFU9mCIEoDNBvBXmzKcYwKflQFv56KejPT7ZWyMUUzunmuleUqLgtX5eERdowYz0Gqel9H1jMKVdIUAg4ziPDOoUynmuDOpZkD98+tr7SUgXkaCDC0weFT/jHHoE6bOEP02Z8TnTxA5rSXtaA9iKc9C5tSwVG2R4vXiY/SR99+GU1NzV/GRsWeVpWX/mZK8CmENbS1FwliTjzOf5zFUf5ZPDXYjvVtD5ZyAZ8qaJ2Qz1bDHIrTGoKsXRz+vS4lz+1r+v/my02cfGPGIfwOhpTDTquIjd7lWu/CzuNtDnPkcOIABf+aV5GtvhstTbn9hZEwmFtj5Y5e5kgx/F11c7TkMVi0f2zpumcFH17/bx84bmNdGJvt73piDAS7HipZDeZbnGPt0GKbqNd1VhF/j69BYcLYLEcTUskrpBevYX9QN8lPTLFr+x3xdWz+gsiK1bVBR0fCKAZ0ZR4usT0hyF/jASe+rwOml+kPEUhbvviWi/oNHkVb6MjDGOBIW0RzllyhaUBw8Z0jYm4QiV5gkGb539/xma+TJKGFfWhbJcjOiaSD+XRBrTZFxFtEKsoJUudHocBqwahKI2JYQmuvk1XmlfXduOTIt/jpL70VDqul+fxy92iy/NxA7qEgzIUPBNDCfIYcJAODErf2yqdl3Mexnzmizyc2/RixGgAXhuSqp0xqH9OG6TsubZZ2DP+kEF/WIauA3ecfXf2msirzeU5F7LzLG X-OriginatorOrg: zenithal.me X-MS-Exchange-CrossTenant-Network-Message-Id: 47549bfa-2b76-4531-b82a-08d9d6c03a18 X-MS-Exchange-CrossTenant-AuthSource: TYCP286MB1393.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2022 18:12:14.7648 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 436d481c-43b1-4418-8d7f-84c1e4887cf0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: uGZXSdvqkalQG9fAsuieArTyzwtFTpu/XvdVb7rHjxNt2pfR0xvX+7CXbAp1vtbN X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1166 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a01:111:f403:7010::730 (failed) Received-SPF: pass client-ip=2a01:111:f403:7010::730; envelope-from=i@zenithal.me; helo=JPN01-TYC-obe.outbound.protection.outlook.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RDNS_NONE=0.793, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Gerd Hoffmann , contact@canokeys.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" Signed-off-by: Hongren (Zenithal) Zheng --- MAINTAINERS | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/MAINTAINERS b/MAINTAINERS index f871d759fd..51dae611fa 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -2296,6 +2296,14 @@ F: hw/timer/mips_gictimer.c F: include/hw/intc/mips_gic.h F: include/hw/timer/mips_gictimer.h +CanoKey +M: Hongren (Zenithal) Zheng +S: Maintained +R: Canokeys.org +F: hw/usb/canokey.c +F: hw/usb/canokey.h +F: docs/canokey.txt + Subsystems ---------- Overall Audio backends