在 2021/1/8 下午6:02, Yanteng Si 写道:
This patch translates Documentation/mips/ingenic-tcu.rst into Chinese.
Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx>
---
.../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 <ingenic-tcu>`
+:Translator: Yanteng Si <siyanteng@xxxxxxxxxxx>
+
+.. _cn_ingenic-tcu:
+
+===============================================
+君正 JZ47xx 系统级芯片定时器/计数器硬件单元
+===============================================
+ Yanjie as Ingenic expert.
Hi Yanteng,
I think SoC shouldn't be translated as it is a common sense.
+
+君正 JZ47xx 系统级芯片中的定时器/计数器单元(TCU)是一个多功能硬件块。它
+有多达8个通道,可以用作计数器,计时器,或PWM。
+
+- JZ4725B, JZ4750, JZ4755 只有6个TCU通道。其它系统级芯片都有8个通道。
Ditto.
+
+- JZ4725B引入了一个独立的通道,称为操作系统计时器(OST)。这是一个32位可
+ 编程定时器。在JZ4760B及以上型号上,它是64位的。
+
+- 每个TCU通道有自己的时钟,可以通过 TCSR 寄存器重新设置到三个不同的时
+ 钟(pclk、ext、rtc)、门控和时钟恢复。
Maybe
每个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。
+
+- 每个通道可以生成中断。有些通道共享一条中断线路,而有些没有,其在系统
+ 级芯片版本之间的变更:
"版本" seems bogus to me. Although original text is "version" but probably
"型号"
is much more fit?
I'd prefer call it "中断线" instead of “中断线路” as it is not a physical
circuit.
+
+ - 在很老的系统级芯片(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
晶振?
Thanks.
- Jiaxun
+PWM drivers/pwm/pwm-jz4740.c
+看门狗 drivers/watchdog/jz4740_wdt.c
+=========== =====
+
+因为可以从相同的寄存器控制属于不同驱动程序和框架的TCU的各种功能,所以
+所有这些驱动程序都通过相同的控制总线通用接口访问它们的寄存器。
+
+有关TCU驱动程序的设备树绑定的更多信息,请参阅:
+Documentation/devicetree/bindings/timer/ingenic,tcu.yaml.