From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.8 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1C015C433E9 for ; Fri, 8 Jan 2021 10:03:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id CAF6F236F9 for ; Fri, 8 Jan 2021 10:03:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728471AbhAHKDL (ORCPT ); Fri, 8 Jan 2021 05:03:11 -0500 Received: from mail.loongson.cn ([114.242.206.163]:42938 "EHLO loongson.cn" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1728466AbhAHKDL (ORCPT ); Fri, 8 Jan 2021 05:03:11 -0500 Received: from localhost.localdomain (unknown [112.3.198.81]) by mail.loongson.cn (Coremail) with SMTP id AQAAf9Ax9bykLfhfYy4BAA--.62S5; Fri, 08 Jan 2021 18:02:26 +0800 (CST) From: Yanteng Si To: Harry Wei Cc: Alex Shi , Yanteng Si , Jonathan Corbet , linux-doc@vger.kernel.org, Huacai Chen , Jiaxun Yang , Yanteng Si Subject: [PATCH v4 4/4] doc/zh_CN: add mips ingenic-tcu.rst translation Date: Fri, 8 Jan 2021 18:02:21 +0800 Message-Id: <20210108100221.1370763-4-siyanteng@loongson.cn> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210108100221.1370763-1-siyanteng@loongson.cn> References: <20210108100221.1370763-1-siyanteng@loongson.cn> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-CM-TRANSID: AQAAf9Ax9bykLfhfYy4BAA--.62S5 X-Coremail-Antispam: 1UD129KBjvJXoWxCw1rtryrWr1xJFWDJF4kCrg_yoWrAF4Dpr n7u34xKa1xAFyfArW5GF18Wa48JFWxWa42vw4fJ3sxtr1Dta4Utr1DJr9IqryIgr1FyFW7 XF1SkrW0kr1UAwUanT9S1TB71UUUUUUqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUU9m14x267AKxVWrJVCq3wAFc2x0x2IEx4CE42xK8VAvwI8IcIk0 rVWUuVWrJwAFIxvE14AKwVWUJVWUGwA2048vs2IY020E87I2jVAFwI0_JrWl82xGYIkIc2 x26xkF7I0E14v26ryj6s0DM28lY4IEw2IIxxk0rwA2F7IY1VAKz4vEj48ve4kI8wA2z4x0 Y4vE2Ix0cI8IcVAFwI0_Ar0_tr1l84ACjcxK6xIIjxv20xvEc7CjxVAFwI0_Gr1j6F4UJw A2z4x0Y4vEx4A2jsIE14v26rxl6s0DM28EF7xvwVC2z280aVCY1x0267AKxVW0oVCq3wAS 0I0E0xvYzxvE52x082IY62kv0487Mc02F40EFcxC0VAKzVAqx4xG6I80ewAv7VC0I7IYx2 IY67AKxVWUJVWUGwAv7VC2z280aVAFwI0_Jr0_Gr1lOx8S6xCaFVCjc4AY6r1j6r4UM4x0 Y48IcxkI7VAKI48JM4x0x7Aq67IIx4CEVc8vx2IErcIFxwCF04k20xvY0x0EwIxGrwCFx2 IqxVCFs4IE7xkEbVWUJVW8JwC20s026c02F40E14v26r1j6r18MI8I3I0E7480Y4vE14v2 6r106r1rMI8E67AF67kF1VAFwI0_Jw0_GFylIxkGc2Ij64vIr41lIxAIcVC0I7IYx2IY67 AKxVWUJVWUCwCI42IY6xIIjxv20xvEc7CjxVAFwI0_Gr0_Cr1lIxAIcVCF04k26cxKx2IY s7xG6r1j6r1xMIIF0xvEx4A2jsIE14v26r1j6r4UMIIF0xvEx4A2jsIEc7CjxVAFwI0_Gr 0_Gr1UYxBIdaVFxhVjvjDU0xZFpf9x0JUd8n5UUUUU= X-CM-SenderInfo: pvl1t0pwhqwqxorr0wxvrqhubq/ Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org This patch translates Documentation/mips/ingenic-tcu.rst into Chinese. Signed-off-by: Yanteng Si --- .../translations/zh_CN/mips/ingenic-tcu.rst | 69 +++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 Documentation/translations/zh_CN/mips/ingenic-tcu.rst diff --git a/Documentation/translations/zh_CN/mips/ingenic-tcu.rst b/Documentation/translations/zh_CN/mips/ingenic-tcu.rst new file mode 100644 index 000000000000..9a8c5504b61f --- /dev/null +++ b/Documentation/translations/zh_CN/mips/ingenic-tcu.rst @@ -0,0 +1,69 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. include:: ../disclaimer-zh_CN.rst + +:Original: :ref:`Documentation/mips/ingenic-tcu.rst ` +:Translator: Yanteng Si + +.. _cn_ingenic-tcu: + +=============================================== +君正 JZ47xx 系统级芯片定时器/计数器硬件单元 +=============================================== + +君正 JZ47xx 系统级芯片中的定时器/计数器单元(TCU)是一个多功能硬件块。它 +有多达8个通道，可以用作计数器，计时器，或PWM。 + +- JZ4725B, JZ4750, JZ4755 只有６个TCU通道。其它系统级芯片都有８个通道。 + +- JZ4725B引入了一个独立的通道，称为操作系统计时器(OST)。这是一个32位可 + 编程定时器。在JZ4760B及以上型号上，它是64位的。 + +- 每个TCU通道有自己的时钟，可以通过 TCSR 寄存器重新设置到三个不同的时 + 钟（pclk、ext、rtc）、门控和时钟恢复。 + + - 看门狗和OST硬件模块在它们的寄存器空间中也有相同形式的TCSR寄存器。 + - 用于堵塞/连通的 TCU 寄存器也可以堵塞/连通看门狗和 OST 时钟。 + +- 每个TCU通道在两种模式的其中一种模式下运行： + + - 模式 TCU1：通道无法在睡眠模式下运行，但更易于操作。 + - 模式 TCU2：通道可以在睡眠模式下运行，但操作比 TCU1 通道复杂一些。 + +- 每个 TCU 通道的模式取决于使用的系统级芯片： + + - 在最老的系统级芯片（高于JZ4740），八个通道都运行在TCU1模式。 + - 在 JZ4725B，通道5运行在TCU2,其它通道则运行在TCU1。 + - 在最新的系统级芯片（JZ4750及之后），通道1-2运行在TCU2，其它通道 + 则运行在TCU1。 + +- 每个通道可以生成中断。有些通道共享一条中断线路，而有些没有，其在系统 + 级芯片版本之间的变更： + + - 在很老的系统级芯片（JZ4740及更低），通道0和通道1有它们自己的中断 + 线路；通道2-7共享最后一条中断线路。 + - 在 JZ4725B，通道0有它自己的中断线路；通道1-5共享一条中断线路；OST + 使用最后一条中断线路。 + - 在比较新的系统级芯片（JZ4750及以后），通道5有它自己的中断线路；通 + 道0-4和（如果是8通道）6-7全部共享一条中断线路；OST使用最后一条中 + 断线路。 + +实现 +==== + +TCU硬件的功能分布在多个驱动程序： + +=========== ===== +时钟 drivers/clk/ingenic/tcu.c +中断 drivers/irqchip/irq-ingenic-tcu.c +定时器 drivers/clocksource/ingenic-timer.c +OST drivers/clocksource/ingenic-ost.c +PWM drivers/pwm/pwm-jz4740.c +看门狗 drivers/watchdog/jz4740_wdt.c +=========== ===== + +因为可以从相同的寄存器控制属于不同驱动程序和框架的TCU的各种功能，所以 +所有这些驱动程序都通过相同的控制总线通用接口访问它们的寄存器。 + +有关TCU驱动程序的设备树绑定的更多信息，请参阅: +Documentation/devicetree/bindings/timer/ingenic,tcu.yaml. -- 2.27.0