TI DRA7 ATL clocks

DRA7 Audio Tracking Logic

DRA7 SoC의 ATL(Audio Tracking Logic) clock 바인딩입니다. ATL은 baseband와 audio codec을 동기화할 clock을 생성합니다. 하나의 ATL IP가 같은 functional clock을 공유하는 ATL clock instance 네 개를 제공하지만 각 instance는 서로 다른 output을 만들 수 있습니다.

ATL은 `bws`와 `aws` signal을 기준으로 원하는 평균 frequency를 유지하여 두 word-select signal 사이의 drift를 보상할 수 있습니다.

SoC 내부 또는 외부 component가 사용할 output clock을 지원하려면 clock-tree 바인딩과 IP-driver 바인딩 두 세트가 필요합니다. Clock-tree node는 CCF 수준에서 ATL clock을 표현하고 실제 IP 설정은 별도 IP driver가 처리합니다.

Clock-tree node와 IP node 속성

Clock-tree provider의 `compatible`은 `ti,dra7-atl-clock`, `#clock-cells`는 0이며 `clocks`에는 ATL functional clock phandle을 연결합니다.

IP driver node의 `compatible`은 `ti,dra7-atl`, `reg`는 ATL IP base address입니다. `ti,provided-clocks`에는 네 ATL output clock phandle을, `clocks`에는 functional clock을, `clock-names`에는 `fck`를, `ti,hwmods`에는 `atl`을 지정합니다.

ATL instance 설정

선택적인 `atl0`, `atl1`, `atl2`, `atl3` child가 각 instance를 설정합니다. `bws`는 baseband word-select signal을, `aws`는 audio word-select signal을 선택합니다.

유효한 word-select 상수는 `dt-bindings/clock/ti-dra7-atl.h` include file에 정의되어 있습니다.

네 output과 ATL2 tracking 예제

첫 예제는 `atl_gfclk_mux`를 공유 parent로 쓰는 네 0-cell ATL clock node를 만들고, IP node의 `ti,provided-clocks`에 네 phandle을 모두 연결합니다.

/* clock bindings for atl provided clocks */
atl_clkin0_ck: atl_clkin0_ck {
        #clock-cells = <0>;
        compatible = "ti,dra7-atl-clock";
        clocks = <&atl_gfclk_mux>;
};

atl_clkin1_ck: atl_clkin1_ck {
        #clock-cells = <0>;
        compatible = "ti,dra7-atl-clock";
        clocks = <&atl_gfclk_mux>;
};

atl_clkin2_ck: atl_clkin2_ck {
        #clock-cells = <0>;
        compatible = "ti,dra7-atl-clock";
        clocks = <&atl_gfclk_mux>;
};

atl_clkin3_ck: atl_clkin3_ck {
        #clock-cells = <0>;
        compatible = "ti,dra7-atl-clock";
        clocks = <&atl_gfclk_mux>;
};

/* binding for the IP */
atl: atl@4843c000 {
        compatible = "ti,dra7-atl";
        reg = <0x4843c000 0x3ff>;
        ti,hwmods = "atl";
        ti,provided-clocks = <&atl_clkin0_ck>, <&atl_clkin1_ck>,
                                <&atl_clkin2_ck>, <&atl_clkin3_ck>;
        clocks = <&atl_gfclk_mux>;
        clock-names = "fck";
};

두 번째 예제는 header를 include한 뒤 ATL2의 `bws`를 `DRA7_ATL_WS_MCASP2_FSX`, `aws`를 `DRA7_ATL_WS_MCASP3_FSX`로 선택합니다.

#include <dt-bindings/clock/ti-dra7-atl.h>

&atl {

        atl2 {
                bws = <DRA7_ATL_WS_MCASP2_FSX>;
                aws = <DRA7_ATL_WS_MCASP3_FSX>;
        };
};