All of lore.kernel.org
 help / color / mirror / Atom feed
From: Yanteng Si <siyanteng@loongson.cn>
To: Harry Wei <harryxiyou@gmail.com>
Cc: Alex Shi <alex.shi@linux.alibaba.com>,
	Yanteng Si <siyanteng01@gmail.com>,
	Jonathan Corbet <corbet@lwn.net>,
	linux-doc@vger.kernel.org, Huacai Chen <chenhuacai@gmail.com>,
	Jiaxun Yang <jiaxun.yang@flygoat.com>,
	Yanteng Si <siyanteng@loongson.cn>
Subject: [PATCH v6 4/4] doc/zh_CN: add mips ingenic-tcu.rst translation
Date: Tue, 12 Jan 2021 19:52:59 +0800	[thread overview]
Message-ID: <20210112115259.217944-4-siyanteng@loongson.cn> (raw)
In-Reply-To: <20210112115259.217944-1-siyanteng@loongson.cn>

This patch translates Documentation/mips/ingenic-tcu.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
---
 .../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..72b5d409ed89
--- /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 <ingenic-tcu>`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_ingenic-tcu:
+
+===============================================
+君正 JZ47xx SoC定时器/计数器硬件单元
+===============================================
+
+君正 JZ47xx SoC中的定时器/计数器单元(TCU)是一个多功能硬件块。它有多达
+8个通道,可以用作计数器,计时器,或脉冲宽度调制器。
+
+- JZ4725B, JZ4750, JZ4755 只有6个TCU通道。其它SoC都有8个通道。
+
+- JZ4725B引入了一个独立的通道,称为操作系统计时器(OST)。这是一个32位可
+  编程定时器。在JZ4760B及以上型号上,它是64位的。
+
+- 每个TCU通道都有自己的时钟源,可以通过 TCSR 寄存器设置通道的父级时钟
+  源(pclk、ext、rtc)、开关以及分频。
+
+    - 看门狗和OST硬件模块在它们的寄存器空间中也有相同形式的TCSR寄存器。
+    - 用于关闭/开启的 TCU 寄存器也可以关闭/开启看门狗和 OST 时钟。
+
+- 每个TCU通道在两种模式的其中一种模式下运行:
+
+    - 模式 TCU1:通道无法在睡眠模式下运行,但更易于操作。
+    - 模式 TCU2:通道可以在睡眠模式下运行,但操作比 TCU1 通道复杂一些。
+
+- 每个 TCU 通道的模式取决于使用的SoC:
+
+    - 在最老的SoC(高于JZ4740),八个通道都运行在TCU1模式。
+    - 在 JZ4725B,通道5运行在TCU2,其它通道则运行在TCU1。
+    - 在最新的SoC(JZ4750及之后),通道1-2运行在TCU2,其它通道则运行
+      在TCU1。
+
+- 每个通道都可以生成中断。有些通道共享一条中断线,而有些没有,其在SoC型
+  号之间的变更:
+
+    - 在很老的SoC(JZ4740及更低),通道0和通道1有它们自己的中断线;通
+      道2-7共享最后一条中断线。
+    - 在 JZ4725B,通道0有它自己的中断线;通道1-5共享一条中断线;OST
+      使用最后一条中断线。
+    - 在比较新的SoC(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
+脉冲宽度调制器      drivers/pwm/pwm-jz4740.c
+看门狗              drivers/watchdog/jz4740_wdt.c
+===========         =====
+
+因为可以从相同的寄存器控制属于不同驱动程序和框架的TCU的各种功能,所以
+所有这些驱动程序都通过相同的控制总线通用接口访问它们的寄存器。
+
+有关TCU驱动程序的设备树绑定的更多信息,请参阅:
+Documentation/devicetree/bindings/timer/ingenic,tcu.yaml.
-- 
2.27.0


  parent reply	other threads:[~2021-01-12 11:53 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-01-12 11:52 [PATCH v6 1/4] doc/zh_CN: add mips index.rst translation Yanteng Si
2021-01-12 11:52 ` [PATCH v6 2/4] doc/zh_CN: add mips booting.rst translation Yanteng Si
2021-01-12 11:52 ` [PATCH v6 3/4] doc/zh_CN: add mips features.rst translation Yanteng Si
2021-01-12 11:52 ` Yanteng Si [this message]
2021-01-12 12:15 ` [PATCH v6 1/4] doc/zh_CN: add mips index.rst translation Jiaxun Yang
2021-01-12 15:09 ` Jonathan Corbet
2021-01-13 14:53   ` yanteng si
  -- strict thread matches above, loose matches on Subject: below --
2021-01-12  4:24 [PATCH v6 2/4] doc/zh_CN: add mips booting.rst translation Yanteng Si
2021-01-12  4:24 ` [PATCH v6 4/4] doc/zh_CN: add mips ingenic-tcu.rst translation Yanteng Si

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210112115259.217944-4-siyanteng@loongson.cn \
    --to=siyanteng@loongson.cn \
    --cc=alex.shi@linux.alibaba.com \
    --cc=chenhuacai@gmail.com \
    --cc=corbet@lwn.net \
    --cc=harryxiyou@gmail.com \
    --cc=jiaxun.yang@flygoat.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=siyanteng01@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.