dt-bindings: timer: Add Sophgo sg2042 CLINT timer
authorInochi Amaoto <inochiama@outlook.com>
Wed, 4 Oct 2023 15:43:28 +0000 (23:43 +0800)
committerConor Dooley <conor.dooley@microchip.com>
Fri, 6 Oct 2023 13:36:54 +0000 (14:36 +0100)
commit4734449f73115c33733b136e225657107c03faf5
tree93480207fce921805d66c8e2cdceab5b94e1488d
parentd975794dddd2ec44f142302c7fd3b86eebec0bee
dt-bindings: timer: Add Sophgo sg2042 CLINT timer

The clint of Sophgo's sg2042 is based off IP designed by T-HEAD, but
Sophgo changes this IP layout to fit its cpu design and is incompatible
with the standard sifive clint. The timer and ipi device are on the
different address, and can not be handled by the sifive,clint dt-bindings.

If we use the same compatible string for mswi and timer of the sg2042
clint like sifive,clint, the DT may be like this:

mswi: interrupt-controller@94000000 {
compatible = "sophgo,sg2042-clint", "thead,c900-clint";
interrupts-extended = <&cpu1intc 3>;
reg = <0x94000000 0x00010000>;
};

timer: timer@ac000000 {
compatible = "sophgo,sg2042-clint", "thead,c900-clint";
interrupts-extended = <&cpu1intc 7>;
reg = <0xac000000 0x00010000>;
};

Since the address of mswi and timer are different, it is hard to merge
them directly. So we need two DT nodes to handle both devices.
If we use this DT for SBI, it will parse the mswi device in the timer
initialization as the compatible string is the same, so will mswi.
As they are different devices, this incorrect initialization will cause
the system unusable.

There is a more robust ACLINT spec. can handle this situation, but
the spec. seems to be abandoned and will not be frozen in the predictable
future.

So it is not the time to add ACLINT spec in the kernel bindings. Instead,
using vendor bindings is more acceptable.

Add new vendor specific compatible strings to identify timer of sg2042
clint.

Signed-off-by: Inochi Amaoto <inochiama@outlook.com>
Signed-off-by: Chen Wang <unicorn_wang@outlook.com>
Signed-off-by: Conor Dooley <conor.dooley@microchip.com>
Documentation/devicetree/bindings/timer/thead,c900-aclint-mtimer.yaml [new file with mode: 0644]