original_kernel/Documentation/translations/zh_TW/arch/mips/ingenic-tcu.rst

74 lines
3.0 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. SPDX-License-Identifier: GPL-2.0
.. include:: ../../disclaimer-zh_TW.rst
:Original: Documentation/arch/mips/ingenic-tcu.rst
:翻譯:
司延騰 Yanteng Si <siyanteng@loongson.cn>
.. _tw_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.