[PATCH v5 1/4] doc/zh_CN: add mips index.rst translation

[PATCH v5 1/4] doc/zh_CN: add mips index.rst translation

[Yanteng Si]

This patch translates Documentation/mips/index.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
---
 .../translations/zh_CN/mips/index.rst         | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/mips/index.rst

diff --git a/Documentation/translations/zh_CN/mips/index.rst b/Documentation/translations/zh_CN/mips/index.rst
new file mode 100644
index 000000000000..2c7b836a3da5
--- /dev/null
+++ b/Documentation/translations/zh_CN/mips/index.rst
@@ -0,0 +1,29 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/mips/index.rst <index>`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_index:
+
+
+===========================
+MIPS特性文档
+===========================
+
+.. toctree::
+   :maxdepth: 2
+   :numbered:
+
+   booting
+   ingenic-tcu
+
+   features
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
-- 
2.27.0

[PATCH v5 2/4] doc/zh_CN: add mips booting.rst translation

[Yanteng Si]

This patch translates Documentation/mips/booting.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
---
 .../translations/zh_CN/mips/booting.rst       | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/mips/booting.rst

diff --git a/Documentation/translations/zh_CN/mips/booting.rst b/Documentation/translations/zh_CN/mips/booting.rst
new file mode 100644
index 000000000000..3099d0fff7a6
--- /dev/null
+++ b/Documentation/translations/zh_CN/mips/booting.rst
@@ -0,0 +1,31 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/mips/booting.rst <booting>`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_booting:
+
+BMIPS设备树引导
+------------------------
+
+  一些bootloaders只支持在内核镜像开始地址处的单一入口点。而其它
+  bootloaders将跳转到ELF的开始地址处。两种方案都支持的；因为
+  CONFIG_BOOT_RAW=y and CONFIG_NO_EXCEPT_FILL=y, 所以第一条指令
+  会立即跳转到kernel_entry()入口处执行。
+
+  与arch/arm情况(b)类似，dt感知的引导加载程序需要设置以下寄存器:
+
+         a0 : 0
+
+         a1 : 0xffffffff
+
+         a2 : RAM中指向设备树块的物理指针(在chapterII中定义)。
+              设备树可以位于前512MB物理地址空间(0x00000000 -
+              0x1fffffff)的任何位置，以64位边界对齐。
+
+  传统bootloaders不会使用这样的约定，并且它们不传入DT块。
+  在这种情况下，Linux将通过选中CONFIG_DT_*查找DTB。
+
+  以上约定只在32位系统中定义，因为目前没有任何64位的BMIPS实现。
-- 
2.27.0

[PATCH v5 3/4] doc/zh_CN: add mips features.rst translation

[Yanteng Si]

This patch translates Documentation/mips/features.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
---
 Documentation/translations/zh_CN/mips/features.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/mips/features.rst

diff --git a/Documentation/translations/zh_CN/mips/features.rst b/Documentation/translations/zh_CN/mips/features.rst
new file mode 100644
index 000000000000..7e67f81a0982
--- /dev/null
+++ b/Documentation/translations/zh_CN/mips/features.rst
@@ -0,0 +1,10 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/mips/features.rst <features>`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_features:
+
+.. kernel-feat:: $srctree/Documentation/features mips
-- 
2.27.0

[PATCH v5 4/4] doc/zh_CN: add mips ingenic-tcu.rst translation

[Yanteng Si]

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

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
---
 .../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..06bd2627a23d
--- /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个通道，可以用作计数器，计时器，或PWM。
+
+- 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。
+    - 在最新的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
+PWM          drivers/pwm/pwm-jz4740.c
+看门狗       drivers/watchdog/jz4740_wdt.c
+===========  =====
+
+因为可以从相同的寄存器控制属于不同驱动程序和框架的TCU的各种功能，所以
+所有这些驱动程序都通过相同的控制总线通用接口访问它们的寄存器。
+
+有关TCU驱动程序的设备树绑定的更多信息，请参阅:
+Documentation/devicetree/bindings/timer/ingenic,tcu.yaml.
-- 
2.27.0

Re: [PATCH v5 4/4] doc/zh_CN: add mips ingenic-tcu.rst translation

[Alex Shi]

在 2021/1/9 上午11:00, Yanteng Si 写道:
> This patch translates Documentation/mips/ingenic-tcu.rst into Chinese.
> 
> Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> ---
>  .../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..06bd2627a23d
> --- /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个通道，可以用作计数器，计时器，或PWM。

pulse-width modulation?  脉冲宽度调制器？

> +
> +- 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。
> +    - 在最新的Soc（JZ4750及之后），通道1-2运行在TCU2，其它通道则运行
> +      在TCU1。
> +
> +- 每个通道都可以生成中断。有些通道共享一条中断线，而有些没有，其在Soc型

s/Soc/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
> +PWM          drivers/pwm/pwm-jz4740.c
> +看门狗       drivers/watchdog/jz4740_wdt.c
> +===========  =====
> +
> +因为可以从相同的寄存器控制属于不同驱动程序和框架的TCU的各种功能，所以
> +所有这些驱动程序都通过相同的控制总线通用接口访问它们的寄存器。
> +
> +有关TCU驱动程序的设备树绑定的更多信息，请参阅:
> +Documentation/devicetree/bindings/timer/ingenic,tcu.yaml.
> 

Re: [PATCH v5 4/4] doc/zh_CN: add mips ingenic-tcu.rst translation

[yanteng si]

That's great,Thank you!

Alex Shi <alex.shi@linux.alibaba.com> 于2021年1月11日周一 上午11:05写道：
>
>
>
> 在 2021/1/9 上午11:00, Yanteng Si 写道:
> > This patch translates Documentation/mips/ingenic-tcu.rst into Chinese.
> >
> > Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> > ---
> >  .../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..06bd2627a23d
> > --- /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个通道，可以用作计数器，计时器，或PWM。
>
> pulse-width modulation?  脉冲宽度调制器？
>
> > +
> > +- 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。
> > +    - 在最新的Soc（JZ4750及之后），通道1-2运行在TCU2，其它通道则运行
> > +      在TCU1。
> > +
> > +- 每个通道都可以生成中断。有些通道共享一条中断线，而有些没有，其在Soc型
>
> s/Soc/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
> > +PWM          drivers/pwm/pwm-jz4740.c
> > +看门狗       drivers/watchdog/jz4740_wdt.c
> > +===========  =====
> > +
> > +因为可以从相同的寄存器控制属于不同驱动程序和框架的TCU的各种功能，所以
> > +所有这些驱动程序都通过相同的控制总线通用接口访问它们的寄存器。
> > +
> > +有关TCU驱动程序的设备树绑定的更多信息，请参阅:
> > +Documentation/devicetree/bindings/timer/ingenic,tcu.yaml.
> >