From patchwork Sun Nov 13 07:15:54 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 19305 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp1578957wru; Sat, 12 Nov 2022 23:23:43 -0800 (PST) X-Google-Smtp-Source: AA0mqf7uC2fbin5lLHKVMPcoa7OgkapfXCj0LXv193kiuJMuVH08HOMyktfqn6BDlIG5wennkTGo X-Received: by 2002:a17:906:8052:b0:7ad:821f:a3e6 with SMTP id x18-20020a170906805200b007ad821fa3e6mr6611403ejw.688.1668324223055; Sat, 12 Nov 2022 23:23:43 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668324223; cv=none; d=google.com; s=arc-20160816; b=Ec8DTg5qFfN4qDcgRGUBYOnJtQrdDEEP9cRNgchv2YJCbgfIejv3g/ijWsdB0J33G5 udjeJkx4FeX7I1oRWN4/OQfSKrIwyh76I4ujPtLuzTCOOiFPLRRfnfVyF5IUMMnMln/r QjaZHtWkoPqG/ssFosrRUCKhv93hjh0IVDWzrdhIvWbaLG8MYbXHnFA6WBZUa0jBbh9a gDI6FYkynpn5wNYpa4pvl5LN9ovuS7Us0UrZV3oCNXpjZUV7YtvV1q6qN2q5xxWxNt2G OMSGi/nndnHPihSmkb41Qno2SVHPLjiFh0MittlfkIQqG4euPlvlExqPv9HcMKoSJuUa UT/A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=HcM6BnULuk4HE0ydbQ1YLhiYfPsIBUqRxDvLaj/58do=; b=RhaTCsaF8cOc849pe1D14htiHjz4knX+3o6v8S57jA/gVvDig6pd6i925b8AeDc4hs 1mlEjX+bso9PKgSEofyyx92aLEUYsEigISgc4DWMruFrtU585Ujq5iRTpWDI5uaTnghN Mkedu4kJsYFGP9+vcsaYofN1A4XsTuXl6Cx4LP5//1fAunVu1a+uX07D77D35pPM9HTq 7OXv5wmxEPJFrVR6hh9I4ynFw4LelTJR8qz7XpAGAxOE6BZO4qE9VnFp6E5u6AWs2O60 54b93uSjdMhXVua6EFAMAtSWoBvHHyVjgPZRm5Q+S6D6ZsV+bRABsJXaxxQoTjnY8NRX dkjg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lirui.org header.s=key1 header.b=NbdcHbek; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id nb36-20020a1709071ca400b007a45e4f4ff2si7605230ejc.853.2022.11.12.23.23.19; Sat, 12 Nov 2022 23:23:43 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@lirui.org header.s=key1 header.b=NbdcHbek; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235170AbiKMHQr (ORCPT + 99 others); Sun, 13 Nov 2022 02:16:47 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58708 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231972AbiKMHQq (ORCPT ); Sun, 13 Nov 2022 02:16:46 -0500 Received: from out0.migadu.com (out0.migadu.com [IPv6:2001:41d0:2:267::]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5F57113D18; Sat, 12 Nov 2022 23:16:44 -0800 (PST) X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lirui.org; s=key1; t=1668323802; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=HcM6BnULuk4HE0ydbQ1YLhiYfPsIBUqRxDvLaj/58do=; b=NbdcHbekJS3KMfylSSSWXZtOSKqbS7vgf5MWzatw3CJwdWH/qM+G9C0UBUdslT7OSeRppJ fOk5qWAhlzTqjhbT4CdzmtD9O0xnMsPZZqrll+jXaqmD9t84CUb3Ce0iuJB4JfZRBI4Bhu nSuK1k+tzd8wYVh7wSlK+Ewn/pkvr1eCMxxpNnS+1rZyWGByc4cUxG94m1de6TaW+KEcnX SkiuBRWpAlbIrEYapfE8EeJ/Zcwr7rrW16gSt9qpGYmx4+OV8zDPPwmpEXGlu5vUm560VB coRtOIqEMsL+cRnYUzA9UTete6Kv5yEPaFuSiNrvidXeYvEge5Rezj+b+jK3iw== From: Rui Li To: Wu XiangCheng , Alex Shi , Yanteng Si Cc: Jonathan Corbet , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Rui Li Subject: [PATCH v2] docs/zh_CN: Add userspace-api/accelerators/ocxl Chinese translation Date: Sun, 13 Nov 2022 15:15:54 +0800 Message-Id: <20221113071554.476980-1-me@lirui.org> MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS, SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749364740450943563?= X-GMAIL-MSGID: =?utf-8?q?1749364740450943563?= Translate the following documents into Chinese: - userspace-api/accelerators/ocxl.rst Signed-off-by: Rui Li Reviewed-by: Wu XiangCheng --- Changes since v1: - Correct translations. --- .../zh_CN/userspace-api/accelerators/ocxl.rst | 168 ++++++++++++++++++ .../zh_CN/userspace-api/index.rst | 2 +- 2 files changed, 169 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/userspace-api/accelerators/ocxl.rst diff --git a/Documentation/translations/zh_CN/userspace-api/accelerators/ocxl.rst b/Documentation/translations/zh_CN/userspace-api/accelerators/ocxl.rst new file mode 100644 index 000000000000..845b932bf935 --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/accelerators/ocxl.rst @@ -0,0 +1,168 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../disclaimer-zh_CN.rst + +:Original: Documentation/userspace-api/accelerators/ocxl.rst + +:翻译: + + 李睿 Rui Li + +===================================== +OpenCAPI （开放相干加速器处理器接口） +===================================== + +*OpenCAPI: Open Coherent Accelerator Processor Interface* + +OpenCAPI是处理器和加速器之间的一个接口，致力于达到低延迟和高带宽。该规范 +由 `OpenCAPI Consortium `_ 开发。 + +它允许加速器（可以是FPGA、ASIC等）使用虚拟地址连贯地访问主机内存。一个OpenCAPI +设备也可以托管它自己的内存，并可以由主机访问。 + +OpenCAPI在Linux中称为“ocxl”，它作为“cxl”（用于powerpc的IBM CAPI接口的驱动）的 +开放、处理器无关的演进，这么命名是为了避免与ISDN CAPI子系统相混淆。 + + +高层视角 +======== + +OpenCAPI定义了一个在物理链路层上实现的数据链路层（TL）和传输层（TL）。任何 +实现DL和TL的处理器或者设备都可以开始共享内存。 + +:: + + +-----------+ +-------------+ + | | | | + | | | Accelerated | + | Processor | | Function | + | | +--------+ | Unit | +--------+ + | |--| Memory | | (AFU) |--| Memory | + | | +--------+ | | +--------+ + +-----------+ +-------------+ + | | + +-----------+ +-------------+ + | TL | | TLX | + +-----------+ +-------------+ + | | + +-----------+ +-------------+ + | DL | | DLX | + +-----------+ +-------------+ + | | + | PHY | + +---------------------------------------+ + + Processor：处理器 + Memory：内存 + Accelerated Function Unit：加速函数单元 + + + +设备发现 +======== + +OpenCAPI依赖一个在设备上实现的与PCI类似的配置空间。因此主机可以通过查询 +配置空间来发现AFU。 + +OpenCAPI设备在Linux中被当作类PCI设备（有一些注意事项）。固件需要对硬件进行 +抽象，就好像它是一个PCI链路。许多已有的PCI架构被重用：在模拟标准PCI时， +设备被扫描并且BAR（基址寄存器）被分配。像“lspci”的命令因此可以被用于查看 +哪些设备可用。 + +配置空间定义了可以在物理适配器上可以被找到的AFU，比如它的名字、支持多少内 +存上下文、内存映射IO（MMIO）区域的大小等。 + + + +MMIO +==== + +OpenCAPI为每个AFU定义了两个MMIO区域： + +* 全局MMIO区域，保存和整个AFU相关的寄存器。 +* 每个进程的MMIO区域，对于每个上下文固定大小。 + + + +AFU中断 +======= + +OpenCAPI拥有AFU向主机进程发送中断的可能性。它通过定义在传输层的“intrp_req” +来完成，指定一个定义中断的64位对象句柄。 + +驱动允许一个进程分配中断并获取可以传递给AFU的64位对象句柄。 + + + +字符设备 +======== + +驱动为每个在物理设备上发现的AFU创建一个字符设备。一个物理设备可能拥有多个 +函数，一个函数可以拥有多个AFU。不过编写这篇文档之时，只对导出一个AFU的设备 +测试过。 + +字符设备可以在 /dev/ocxl/ 中被找到，其命名为： +/dev/ocxl/.<位置>.<索引> + + 是一个最长20个字符的名称，和在AFU配置空间中找到的相同。 +<位置>由驱动添加，可在系统有不止一个相同的OpenCAPI设备时帮助区分设备。 +<索引>也是为了在少见情况下帮助区分AFU，即设备携带多个同样的AFU副本时。 + + + +Sysfs类 +======= + +添加了代表AFU的ocxl类。查看/sys/class/ocxl。布局在 +Documentation/ABI/testing/sysfs-class-ocxl 中描述。 + + + +用户API +======= + +打开 +---- + +基于在配置空间中找到的AFU定义，AFU可能支持在多个内存上下文中工作，这种情况 +下相关的字符设备可以被不同进程多次打开。 + + +ioctl +----- + +OCXL_IOCTL_ATTACH: + + 附加调用进程的内存上下文到AFU，以允许AFU访问其内存。 + +OCXL_IOCTL_IRQ_ALLOC: + + 分配AFU中断，返回标识符。 + +OCXL_IOCTL_IRQ_FREE: + + 释放之前分配的AFU中断。 + +OCXL_IOCTL_IRQ_SET_FD: + + 将一个事件文件描述符和AFU中断关联，因此用户进程可以在AFU发送中断时收到通 + 知。 + +OCXL_IOCTL_GET_METADATA: + + 从卡中获取配置信息，比如内存映射IO区域的大小、AFU版本和当前上下文的进程 + 地址空间ID（PASID）。 + +OCXL_IOCTL_ENABLE_P9_WAIT: + + 允许AFU唤醒执行“等待”的用户空间进程。返回信息给用户空间，允许其配置AFU。 + 注意这只在POWER9上可用。 + +OCXL_IOCTL_GET_FEATURES: + + 报告用户空间可用的影响OpenCAPI的CPU特性。 + + +mmap +---- + +一个进程可以mmap每个进程的MMIO区域来和AFU交互。 diff --git a/Documentation/translations/zh_CN/userspace-api/index.rst b/Documentation/translations/zh_CN/userspace-api/index.rst index 68b69b14b143..5dc0f2e69c17 100644 --- a/Documentation/translations/zh_CN/userspace-api/index.rst +++ b/Documentation/translations/zh_CN/userspace-api/index.rst @@ -26,6 +26,7 @@ Linux 内核用户空间API指南 no_new_privs seccomp_filter + accelerators/ocxl ebpf/index sysfs-platform_profile futex2 @@ -35,7 +36,6 @@ TODOList: * landlock * unshare * spec_ctrl -* accelerators/ocxl * ioctl/index * iommu * media/index