mirror of
				git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
				synced 2025-10-31 08:44:41 +00:00 
			
		
		
		
	dt-bindings: ata: convert MediaTek controller to the json-schema
This helps validating DTS files. Signed-off-by: Rafał Miłecki <rafal@milecki.pl> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Reviewed-by: AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com> Signed-off-by: Niklas Cassel <cassel@kernel.org>
This commit is contained in:
		
							parent
							
								
									8731215112
								
							
						
					
					
						commit
						a783b2af74
					
				
					 2 changed files with 98 additions and 51 deletions
				
			
		|  | @ -1,51 +0,0 @@ | |||
| MediaTek Serial ATA controller | ||||
| 
 | ||||
| Required properties: | ||||
|  - compatible	   : Must be "mediatek,<chip>-ahci", "mediatek,mtk-ahci". | ||||
| 		     When using "mediatek,mtk-ahci" compatible strings, you | ||||
| 		     need SoC specific ones in addition, one of: | ||||
| 		     - "mediatek,mt7622-ahci" | ||||
|  - reg		   : Physical base addresses and length of register sets. | ||||
|  - interrupts	   : Interrupt associated with the SATA device. | ||||
|  - interrupt-names : Associated name must be: "hostc". | ||||
|  - clocks	   : A list of phandle and clock specifier pairs, one for each | ||||
| 		     entry in clock-names. | ||||
|  - clock-names	   : Associated names must be: "ahb", "axi", "asic", "rbc", "pm". | ||||
|  - phys		   : A phandle and PHY specifier pair for the PHY port. | ||||
|  - phy-names	   : Associated name must be: "sata-phy". | ||||
|  - ports-implemented : See ./ahci-platform.txt for details. | ||||
| 
 | ||||
| Optional properties: | ||||
|  - power-domains   : A phandle and power domain specifier pair to the power | ||||
| 		     domain which is responsible for collapsing and restoring | ||||
| 		     power to the peripheral. | ||||
|  - resets	   : Must contain an entry for each entry in reset-names. | ||||
| 		     See ../reset/reset.txt for details. | ||||
|  - reset-names	   : Associated names must be: "axi", "sw", "reg". | ||||
|  - mediatek,phy-mode : A phandle to the system controller, used to enable | ||||
| 		       SATA function. | ||||
| 
 | ||||
| Example: | ||||
| 
 | ||||
| 	sata: sata@1a200000 { | ||||
| 		compatible = "mediatek,mt7622-ahci", | ||||
| 			     "mediatek,mtk-ahci"; | ||||
| 		reg = <0 0x1a200000 0 0x1100>; | ||||
| 		interrupts = <GIC_SPI 233 IRQ_TYPE_LEVEL_HIGH>; | ||||
| 		interrupt-names = "hostc"; | ||||
| 		clocks = <&pciesys CLK_SATA_AHB_EN>, | ||||
| 			 <&pciesys CLK_SATA_AXI_EN>, | ||||
| 			 <&pciesys CLK_SATA_ASIC_EN>, | ||||
| 			 <&pciesys CLK_SATA_RBC_EN>, | ||||
| 			 <&pciesys CLK_SATA_PM_EN>; | ||||
| 		clock-names = "ahb", "axi", "asic", "rbc", "pm"; | ||||
| 		phys = <&u3port1 PHY_TYPE_SATA>; | ||||
| 		phy-names = "sata-phy"; | ||||
| 		ports-implemented = <0x1>; | ||||
| 		power-domains = <&scpsys MT7622_POWER_DOMAIN_HIF0>; | ||||
| 		resets = <&pciesys MT7622_SATA_AXI_BUS_RST>, | ||||
| 			 <&pciesys MT7622_SATA_PHY_SW_RST>, | ||||
| 			 <&pciesys MT7622_SATA_PHY_REG_RST>; | ||||
| 		reset-names = "axi", "sw", "reg"; | ||||
| 		mediatek,phy-mode = <&pciesys>; | ||||
| 	}; | ||||
							
								
								
									
										98
									
								
								Documentation/devicetree/bindings/ata/mediatek,mtk-ahci.yaml
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										98
									
								
								Documentation/devicetree/bindings/ata/mediatek,mtk-ahci.yaml
									
										
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,98 @@ | |||
| # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause | ||||
| %YAML 1.2 | ||||
| --- | ||||
| $id: http://devicetree.org/schemas/ata/mediatek,mtk-ahci.yaml# | ||||
| $schema: http://devicetree.org/meta-schemas/core.yaml# | ||||
| 
 | ||||
| title: MediaTek Serial ATA controller | ||||
| 
 | ||||
| maintainers: | ||||
|   - Ryder Lee <ryder.lee@mediatek.com> | ||||
| 
 | ||||
| allOf: | ||||
|   - $ref: ahci-common.yaml# | ||||
| 
 | ||||
| properties: | ||||
|   compatible: | ||||
|     items: | ||||
|       - enum: | ||||
|           - mediatek,mt7622-ahci | ||||
|       - const: mediatek,mtk-ahci | ||||
| 
 | ||||
|   reg: | ||||
|     maxItems: 1 | ||||
| 
 | ||||
|   interrupts: | ||||
|     maxItems: 1 | ||||
| 
 | ||||
|   interrupt-names: | ||||
|     const: hostc | ||||
| 
 | ||||
|   clocks: | ||||
|     maxItems: 5 | ||||
| 
 | ||||
|   clock-names: | ||||
|     items: | ||||
|       - const: ahb | ||||
|       - const: axi | ||||
|       - const: asic | ||||
|       - const: rbc | ||||
|       - const: pm | ||||
| 
 | ||||
|   power-domains: | ||||
|     maxItems: 1 | ||||
| 
 | ||||
|   resets: | ||||
|     maxItems: 3 | ||||
| 
 | ||||
|   reset-names: | ||||
|     items: | ||||
|       - const: axi | ||||
|       - const: sw | ||||
|       - const: reg | ||||
| 
 | ||||
|   mediatek,phy-mode: | ||||
|     description: System controller phandle, used to enable SATA function | ||||
|     $ref: /schemas/types.yaml#/definitions/phandle | ||||
| 
 | ||||
| required: | ||||
|   - reg | ||||
|   - interrupts | ||||
|   - interrupt-names | ||||
|   - clocks | ||||
|   - clock-names | ||||
|   - phys | ||||
|   - phy-names | ||||
|   - ports-implemented | ||||
| 
 | ||||
| unevaluatedProperties: false | ||||
| 
 | ||||
| examples: | ||||
|   - | | ||||
|     #include <dt-bindings/clock/mt7622-clk.h> | ||||
|     #include <dt-bindings/interrupt-controller/arm-gic.h> | ||||
|     #include <dt-bindings/phy/phy.h> | ||||
|     #include <dt-bindings/power/mt7622-power.h> | ||||
|     #include <dt-bindings/reset/mt7622-reset.h> | ||||
| 
 | ||||
|     sata@1a200000 { | ||||
|         compatible = "mediatek,mt7622-ahci", "mediatek,mtk-ahci"; | ||||
|         reg = <0x1a200000 0x1100>; | ||||
|         interrupts = <GIC_SPI 233 IRQ_TYPE_LEVEL_HIGH>; | ||||
|         interrupt-names = "hostc"; | ||||
|         clocks = <&pciesys CLK_SATA_AHB_EN>, | ||||
|                  <&pciesys CLK_SATA_AXI_EN>, | ||||
|                  <&pciesys CLK_SATA_ASIC_EN>, | ||||
|                  <&pciesys CLK_SATA_RBC_EN>, | ||||
|                  <&pciesys CLK_SATA_PM_EN>; | ||||
|         clock-names = "ahb", "axi", "asic", "rbc", "pm"; | ||||
|         phys = <&u3port1 PHY_TYPE_SATA>; | ||||
|         phy-names = "sata-phy"; | ||||
|         ports-implemented = <0x1>; | ||||
|         power-domains = <&scpsys MT7622_POWER_DOMAIN_HIF0>; | ||||
|         resets = <&pciesys MT7622_SATA_AXI_BUS_RST>, | ||||
|                  <&pciesys MT7622_SATA_PHY_SW_RST>, | ||||
|                  <&pciesys MT7622_SATA_PHY_REG_RST>; | ||||
|         reset-names = "axi", "sw", "reg"; | ||||
|         mediatek,phy-mode = <&pciesys>; | ||||
|     }; | ||||
		Loading…
	
	Add table
		
		Reference in a new issue
	
	 Rafał Miłecki
						Rafał Miłecki