doc/zh_CN: add mips ingenic-tcu.rst translation

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>
Link: https://lore.kernel.org/r/20210112115259.217944-4-siyanteng@loongson.cn
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Yanteng Si 2021-01-12 19:52:59 +08:00 committed by Jonathan Corbet
parent 72bc9d0886
commit 419b1d4ed1

View File

@ -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 只有个TCU通道。其它SoC都有个通道。
- 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。
- 在最新的SoCJZ4750及之后通道1-2运行在TCU2其它通道则运行
在TCU1。
- 每个通道都可以生成中断。有些通道共享一条中断线而有些没有其在SoC型
号之间的变更:
- 在很老的SoCJZ4740及更低通道0和通道1有它们自己的中断线
道2-7共享最后一条中断线。
- 在 JZ4725B通道0有它自己的中断线通道1-5共享一条中断线OST
使用最后一条中断线。
- 在比较新的SoCJZ4750及以后通道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.