18c2ecf20Sopenharmony_ci# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 28c2ecf20Sopenharmony_ci%YAML 1.2 38c2ecf20Sopenharmony_ci--- 48c2ecf20Sopenharmony_ci$id: http://devicetree.org/schemas/net/ti,k3-am654-cpts.yaml# 58c2ecf20Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml# 68c2ecf20Sopenharmony_ci 78c2ecf20Sopenharmony_cititle: The TI AM654x/J721E Common Platform Time Sync (CPTS) module Device Tree Bindings 88c2ecf20Sopenharmony_ci 98c2ecf20Sopenharmony_cimaintainers: 108c2ecf20Sopenharmony_ci - Grygorii Strashko <grygorii.strashko@ti.com> 118c2ecf20Sopenharmony_ci - Sekhar Nori <nsekhar@ti.com> 128c2ecf20Sopenharmony_ci 138c2ecf20Sopenharmony_cidescription: |+ 148c2ecf20Sopenharmony_ci The TI AM654x/J721E CPTS module is used to facilitate host control of time 158c2ecf20Sopenharmony_ci sync operations. 168c2ecf20Sopenharmony_ci Main features of CPTS module are 178c2ecf20Sopenharmony_ci - selection of multiple external clock sources 188c2ecf20Sopenharmony_ci - Software control of time sync events via interrupt or polling 198c2ecf20Sopenharmony_ci - 64-bit timestamp mode in ns with PPM and nudge adjustment. 208c2ecf20Sopenharmony_ci - hardware timestamp push inputs (HWx_TS_PUSH) 218c2ecf20Sopenharmony_ci - timestamp counter compare output (TS_COMP) 228c2ecf20Sopenharmony_ci - timestamp counter bit output (TS_SYNC) 238c2ecf20Sopenharmony_ci - periodic Generator function outputs (TS_GENFx) 248c2ecf20Sopenharmony_ci - Ethernet Enhanced Scheduled Traffic Operations (CPTS_ESTFn) (TSN) 258c2ecf20Sopenharmony_ci - external hardware timestamp push inputs (HWx_TS_PUSH) timestamping 268c2ecf20Sopenharmony_ci 278c2ecf20Sopenharmony_ci Depending on integration it enables compliance with the IEEE 1588-2008 288c2ecf20Sopenharmony_ci standard for a precision clock synchronization protocol, Ethernet Enhanced 298c2ecf20Sopenharmony_ci Scheduled Traffic Operations (CPTS_ESTFn) and PCIe Subsystem Precision Time 308c2ecf20Sopenharmony_ci Measurement (PTM). 318c2ecf20Sopenharmony_ci 328c2ecf20Sopenharmony_ci TI AM654x/J721E SoCs has several similar CPTS modules integrated into the 338c2ecf20Sopenharmony_ci different parts of the system which could be synchronized with each other 348c2ecf20Sopenharmony_ci - Main CPTS 358c2ecf20Sopenharmony_ci - MCU CPSW CPTS with IEEE 1588-2008 support 368c2ecf20Sopenharmony_ci - PCIe subsystem CPTS for PTM support 378c2ecf20Sopenharmony_ci 388c2ecf20Sopenharmony_ci Depending on CPTS module integration and when CPTS is integral part of 398c2ecf20Sopenharmony_ci another module (MCU CPSW for example) "compatible" and "reg" can 408c2ecf20Sopenharmony_ci be omitted - parent module is fully responsible for CPTS enabling and 418c2ecf20Sopenharmony_ci configuration. 428c2ecf20Sopenharmony_ci 438c2ecf20Sopenharmony_ciproperties: 448c2ecf20Sopenharmony_ci $nodename: 458c2ecf20Sopenharmony_ci pattern: "^cpts@[0-9a-f]+$" 468c2ecf20Sopenharmony_ci 478c2ecf20Sopenharmony_ci compatible: 488c2ecf20Sopenharmony_ci oneOf: 498c2ecf20Sopenharmony_ci - const: ti,am65-cpts 508c2ecf20Sopenharmony_ci - const: ti,j721e-cpts 518c2ecf20Sopenharmony_ci 528c2ecf20Sopenharmony_ci reg: 538c2ecf20Sopenharmony_ci maxItems: 1 548c2ecf20Sopenharmony_ci description: 558c2ecf20Sopenharmony_ci The physical base address and size of CPTS IO range 568c2ecf20Sopenharmony_ci 578c2ecf20Sopenharmony_ci reg-names: 588c2ecf20Sopenharmony_ci items: 598c2ecf20Sopenharmony_ci - const: cpts 608c2ecf20Sopenharmony_ci 618c2ecf20Sopenharmony_ci clocks: 628c2ecf20Sopenharmony_ci description: CPTS reference clock 638c2ecf20Sopenharmony_ci 648c2ecf20Sopenharmony_ci clock-names: 658c2ecf20Sopenharmony_ci items: 668c2ecf20Sopenharmony_ci - const: cpts 678c2ecf20Sopenharmony_ci 688c2ecf20Sopenharmony_ci interrupts: 698c2ecf20Sopenharmony_ci items: 708c2ecf20Sopenharmony_ci - description: CPTS events interrupt 718c2ecf20Sopenharmony_ci 728c2ecf20Sopenharmony_ci interrupt-names: 738c2ecf20Sopenharmony_ci items: 748c2ecf20Sopenharmony_ci - const: cpts 758c2ecf20Sopenharmony_ci 768c2ecf20Sopenharmony_ci ti,cpts-ext-ts-inputs: 778c2ecf20Sopenharmony_ci $ref: /schemas/types.yaml#/definitions/uint32 788c2ecf20Sopenharmony_ci maximum: 8 798c2ecf20Sopenharmony_ci description: 808c2ecf20Sopenharmony_ci Number of hardware timestamp push inputs (HWx_TS_PUSH) 818c2ecf20Sopenharmony_ci 828c2ecf20Sopenharmony_ci ti,cpts-periodic-outputs: 838c2ecf20Sopenharmony_ci $ref: /schemas/types.yaml#/definitions/uint32 848c2ecf20Sopenharmony_ci maximum: 8 858c2ecf20Sopenharmony_ci description: 868c2ecf20Sopenharmony_ci Number of timestamp Generator function outputs (TS_GENFx) 878c2ecf20Sopenharmony_ci 888c2ecf20Sopenharmony_ci refclk-mux: 898c2ecf20Sopenharmony_ci type: object 908c2ecf20Sopenharmony_ci description: CPTS reference clock multiplexer clock 918c2ecf20Sopenharmony_ci properties: 928c2ecf20Sopenharmony_ci '#clock-cells': 938c2ecf20Sopenharmony_ci const: 0 948c2ecf20Sopenharmony_ci 958c2ecf20Sopenharmony_ci clocks: 968c2ecf20Sopenharmony_ci maxItems: 8 978c2ecf20Sopenharmony_ci 988c2ecf20Sopenharmony_ci assigned-clocks: 998c2ecf20Sopenharmony_ci maxItems: 1 1008c2ecf20Sopenharmony_ci 1018c2ecf20Sopenharmony_ci assigned-clocks-parents: 1028c2ecf20Sopenharmony_ci maxItems: 1 1038c2ecf20Sopenharmony_ci 1048c2ecf20Sopenharmony_ci required: 1058c2ecf20Sopenharmony_ci - clocks 1068c2ecf20Sopenharmony_ci 1078c2ecf20Sopenharmony_cirequired: 1088c2ecf20Sopenharmony_ci - compatible 1098c2ecf20Sopenharmony_ci - reg 1108c2ecf20Sopenharmony_ci - clocks 1118c2ecf20Sopenharmony_ci - clock-names 1128c2ecf20Sopenharmony_ci - interrupts 1138c2ecf20Sopenharmony_ci - interrupt-names 1148c2ecf20Sopenharmony_ci 1158c2ecf20Sopenharmony_ciadditionalProperties: false 1168c2ecf20Sopenharmony_ci 1178c2ecf20Sopenharmony_ciexamples: 1188c2ecf20Sopenharmony_ci - | 1198c2ecf20Sopenharmony_ci #include <dt-bindings/interrupt-controller/irq.h> 1208c2ecf20Sopenharmony_ci #include <dt-bindings/interrupt-controller/arm-gic.h> 1218c2ecf20Sopenharmony_ci 1228c2ecf20Sopenharmony_ci cpts@310d0000 { 1238c2ecf20Sopenharmony_ci compatible = "ti,am65-cpts"; 1248c2ecf20Sopenharmony_ci reg = <0x310d0000 0x400>; 1258c2ecf20Sopenharmony_ci reg-names = "cpts"; 1268c2ecf20Sopenharmony_ci clocks = <&main_cpts_mux>; 1278c2ecf20Sopenharmony_ci clock-names = "cpts"; 1288c2ecf20Sopenharmony_ci interrupts-extended = <&k3_irq 163 0 IRQ_TYPE_LEVEL_HIGH>; 1298c2ecf20Sopenharmony_ci interrupt-names = "cpts"; 1308c2ecf20Sopenharmony_ci ti,cpts-periodic-outputs = <6>; 1318c2ecf20Sopenharmony_ci ti,cpts-ext-ts-inputs = <8>; 1328c2ecf20Sopenharmony_ci 1338c2ecf20Sopenharmony_ci main_cpts_mux: refclk-mux { 1348c2ecf20Sopenharmony_ci #clock-cells = <0>; 1358c2ecf20Sopenharmony_ci clocks = <&k3_clks 118 5>, <&k3_clks 118 11>, 1368c2ecf20Sopenharmony_ci <&k3_clks 157 91>, <&k3_clks 157 77>, 1378c2ecf20Sopenharmony_ci <&k3_clks 157 102>, <&k3_clks 157 80>, 1388c2ecf20Sopenharmony_ci <&k3_clks 120 3>, <&k3_clks 121 3>; 1398c2ecf20Sopenharmony_ci assigned-clocks = <&main_cpts_mux>; 1408c2ecf20Sopenharmony_ci assigned-clock-parents = <&k3_clks 118 11>; 1418c2ecf20Sopenharmony_ci }; 1428c2ecf20Sopenharmony_ci }; 1438c2ecf20Sopenharmony_ci 144