From patchwork Fri Aug 16 17:12:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Li X-Patchwork-Id: 13766680 Received: from DU2PR03CU002.outbound.protection.outlook.com (mail-northeuropeazon11012067.outbound.protection.outlook.com [52.101.66.67]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AF1C11BF33E for ; Fri, 16 Aug 2024 17:12:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=52.101.66.67 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1723828345; cv=fail; b=aXnH9+AgWMx051lEESk548XAa9PGxTS21L6zAojg44KT5r2prP0b+o6+Ay6+Qv1W4uvsIgeLcEYhLFPgiFEBEcp8Fxqc6I8uffTWaJg/2oq8UfbcmHdY91fz71MauqXyo1fIpSHmY2WaKqkOG7cya0nnyXAzRGWF9TUQgF2KKqw= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1723828345; c=relaxed/simple; bh=uhJYSLys4mR80kjZd0WY8J4jBOBfbIBbpvXfFyGUnhM=; h=From:To:Cc:Subject:Date:Message-Id:Content-Type:MIME-Version; b=F+xpYwSTTBOmkxQY5cyDXM1btWfqrVeeFYNpMVGL5VkvuCCsVj+n8ml8B6Tns6awKSYSshZYC1JemRRRMADVupMUNV/7CQVN7+96/K+o0aZ/eUm9R8hXY4NDzr2q8X9/yPj2EMyLspMv9GaQAnUfzDC65V7vG6JFS9W6MtuwQ4Y= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com; spf=pass smtp.mailfrom=nxp.com; dkim=pass (2048-bit key) header.d=nxp.com header.i=@nxp.com header.b=dQll53yD; arc=fail smtp.client-ip=52.101.66.67 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=nxp.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=nxp.com header.i=@nxp.com header.b="dQll53yD" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=NYdmr/Ya329UTSiqZRKmka9DNWJeP8HBBr4NcrqZR4yI/ydC3JohfUjFbiXLQHd5vZZiLe/1yweJBXPEgMt71tuQZOZgE/PMyUH9kRj+mPpRJUL9Kb0ag4s+u6Yn012j8hRGeja7OUVE6Wc9+5uGoVLwTgCcWw9rz5P6A8X/cdmKZC4+IuWYzcjGS/d0BVIovczDkCf6sa4RXV/2Ak6uM59dov72V+pavK++fdC+O+L4sf90xdWYbZkfTpcRItPDwoXmTNGbqdrS7ClDSiL+xcekWijMxwkLEpXcQDgJsbEgwGuTQwh1rjBElda3Nr+d94iamB+rd/StoM9Ky3ZQXQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NxWESkxZHLgtZnpErSHmaCawdocuBYJPdYdbNS/6yDc=; b=PFZIz2N/cfcw/qqN5giLq3DRTn5rn6Cj0hCqVn6yncx3kGbiVZSkw4Vio9bX76HhwiqL1f27ZVH64ab1KZoNJF6QondDmRj2Oc0d2QqNZjoz3tRriEflfPEUlBET2W/8zMkZttZSmi8zJBRUNH3DoOQbo0vhTdEEunDqhwj4UZIgc8oGVXl0asy89MEUKjZXICaIVYFeFI/0EBXxVCDr66BtXIymTXWfqGYoiUeXifMYagxDufHnW1LnLmmx16mDkjCWppcOxD5kqFvZAuGCZsmHfYHVMMxgMgQMONxTHWtwGNJqMpG2mWn2qR0ogGKlwsfbE75NrYtZ+gYeLFUEbg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NxWESkxZHLgtZnpErSHmaCawdocuBYJPdYdbNS/6yDc=; b=dQll53yDhGahBy768JbAOEP8y1s7zE8teJU7qa9pE+Fuie2I79fKFOEJYp+qwbcZOw/7fYi95cbdPpP9EFflMG6KjKAspfzb3tAVERyW0pY8NqpyG7Z4Oo/EqhitlR+ae63fiNwefGXo/hbRszOwvzJ/B5Q5KJkUGojoJRzvZ0s0Hzrr9fJvQbfNU4x0Egow6QRttBxpDILZ48XcmEO0YZQtgBvo5Rdj3kjMyEjQI8An4zyxyDvOe2aUgD4Z7676lZec2ngLPtksP4g+n56zwcuWjNhq8OkyrNYYD8QLuz1bo7drlRGTT2X3tiM0YJfwMdMN3PW0MtfRjxqJgufufg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) by AS8PR04MB8328.eurprd04.prod.outlook.com (2603:10a6:20b:3fc::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7875.19; Fri, 16 Aug 2024 17:12:20 +0000 Received: from PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::9126:a61e:341d:4b06]) by PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::9126:a61e:341d:4b06%3]) with mapi id 15.20.7875.016; Fri, 16 Aug 2024 17:12:20 +0000 From: Frank Li To: Kalle Valo , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Brian Norris , linux-wireless@vger.kernel.org (open list:NETWORKING DRIVERS (WIRELESS)), netdev@vger.kernel.org (open list:NETWORKING DRIVERS), devicetree@vger.kernel.org (open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS), linux-kernel@vger.kernel.org (open list) Cc: imx@lists.linux.dev Subject: [PATCH v2 1/1] dt-bindings: net: wireless: convert marvel-8xxx.txt to yaml format Date: Fri, 16 Aug 2024 13:12:01 -0400 Message-Id: <20240816171203.143486-1-Frank.Li@nxp.com> X-Mailer: git-send-email 2.34.1 X-ClientProxiedBy: SJ0PR05CA0090.namprd05.prod.outlook.com (2603:10b6:a03:332::35) To PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) Precedence: bulk X-Mailing-List: imx@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PAXPR04MB9642:EE_|AS8PR04MB8328:EE_ X-MS-Office365-Filtering-Correlation-Id: a088b53b-a0b9-4d77-3c0a-08dcbe169667 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|7416014|366016|1800799024|52116014|376014|921020|38350700014; X-Microsoft-Antispam-Message-Info: KYKa92q/dZoJOY0G3gPcQDgOWt9GbCbRHoNsMk3O5IQ37wGfwQULE/KsPXXVhCulJRayocFKethUghAIf+OuU+r9rTN9FdY4HS/c8C7RqQb/vdJONx+WpIjFdGMJfOYgx7f0xf7CP5yT57QHlqD2jwLYiKW+IrrFNDrgi2ENMe/ygEyBdk57v+aOljxIjD/nwjaUeIktBriPaVfCeMkbT6lh+gL4JjOTrH4ZZD10TNj6f154qw/6vaSZCICEYJjCIRKX3oElkssTqAkCD8GWRoV+16xYxUswtRuJNA46egAaVe3S5KSY7j5Rp9O+U9Gyhg/MWh/oPZEVHoaLZidtmWJKop00MzKyIujlVZnafdjjZPS8omOATYvYMqirGI7pR/yhYCtIuH2vDUwNdl8Qlxja55mLnxlvNy7SnpVD9DKbjniBGiOAbzFx0PJQyCT4ckg+HuYfy99mepxU3lX4PQHjXVHoxpxPbhKU8u5ZnAXiZaNJOOVDt7plr8LzNrVMJ/cw8kdMuhAhQPRpKWAlmhdsKzNFUNhPoDjs0d6zuoZ5HvZRgSDcCRc2JV6jJl7GnNnHZ5O0LKdH2KHF1U1hq0eg91zmoJlJstc/P1ZE45ZdPuPdGwRMJY13OMMc7mHJ1OXNC27vKBjN4ELkcl+MAqmXbS6KB3+f6v/YDe3vfhFfWLUMIQcTqkWky9ZF7qPKQwItiLhdlOXt68Y7dw0V53OLj9C+wTzzsCOGwMVCGjxhlCNse3veWYAORg5/IKIGZtXhEHF2d/QbUZmHBJHgXE+/liMFITwXNFe4K+autzMNCpMv8frfdi7VsJwavUoZFfZJ6Ejjmhdc5eVD42LaTUOmnkZg23oRcHuITxodkXGIUgZoXGyW3KqE655O3gsXQWrLlf2E5efYAr3UBZ9O9bKDFCc3qUcSOt99IV8q/aFXbnrb8eO49ylZPubevfacK2JIVqsKEOe0f5G3p/ezOy084FmUuA+X3q5MkrdoBG9tG+oVPRcD/Yh9BSMzzQXA+j1hsLLKEmW9SMEe9JMEi9PDYqm5AOuOi4h0/dCyofFcv7zyI19yKW8kDYJyO9HYuPrkc3vX6Tglwys+2rhsbnJUCUYBakr6PSymn4H97W5LWbieKn/lP44hJC7AbQFPkZZBhpOPK4WYO49OGIJPaaNlU98DvQh4RKOsJ8DxSkCX+NXSF/4AOtSGv2ZzDmNlSKiOJVD2+eNKKNS6iKn8zoBQrNSTWSFL06LQrU78kGtvLSgSLWIM40CJD4/i2y2ij0EWqYT8RiYubv/VDq/YfVCSlYKmWOuqSSo++6d68+7BvYeDiQrCuinbwnVCK8bPjzzl83fiWEuFcLHB7qj60+GxSJ7gzNyPdTtYZ7v4reE= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PAXPR04MB9642.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(7416014)(366016)(1800799024)(52116014)(376014)(921020)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: quvPAM+wJfME3LB3X+z4OuX07tT+xIdW70uALdecd/3RY+4PFZtkilmwDWk8SGuLUwQpuNn63OmNSgv7E4bao1cYfrRfnvTE7bLsSAVqSf4/th9eQnN05MMPDnTUuhEsKuibCuEwppWJyDS/395/4VMhTU4UHbwNS2A1lbsDWWFX5iU7a1VQBEO072pYockBoBhYEOe/ouasL7amc+aqrCecmspr3FeU+9RhrznicWjMqQA7UbpkM7IM5KliVRGS+66CMlU1N6rTpGfg2hHZOx4VgjU6gZiGfWKZU8wKaF6AO2zC4S2Lf4K7NA4HUSkUwh2jGi+yWmjfMhIzHUrmga4SMhCO9LKDQQwdxRlYCv6eG+5kurmBQyJY7lg7khVtmo3P6rD/Cw005Y41qwyYyZWMq1KcoPWw2N78/1qNm5jD2XVg/tPC4FC5X1Fv8Z0cKPZpUvmnN9d45yskpjR0Y0/ePySAYlNXj8sXuZs1l6ikySyiEXFpmGSK5cCTRHw+F5f7/0DGwDfa5vfa+0N53w07UCIvys5zUFYSA6Qmf+Ozytw4846bLZMFRJfB8E/sPNFfHPy2sa5ICEd+A+s/jbpazudE7RSJzywnfcinqYo7RApSZaziN8XVzIfcYTmDa9/I+XIAKmVnTu/AmwwsRv0LfOsA7YU9RqvMJ4tzsc3Uxr6hZeB8AZyYRf4wW2YFKAdVzrqdpDW2Gyh8vQryg/KIjxCEVvpZVmAuA9KJ2w4/puvUM6yC68KdiUuukPOiP/qp2TvxFz6ktDQjMSkQ4bo+/TYGDLZyHkX6qAeWNmUklPXY3PNU2a9E7dunbpHlyIt98mTSLnsbGAu+vmY20WWg5gn++ajsn7irtDbqqMoy85p1lRKaqNJuiTBcwejJaFGlh/j+XV6moAdhW/HB/HbQIdy0ndEFfsJGfWk2KWrWC8Tm+JVKY0ondNVMjoID2NariL1A4FURrjRta8ASpvNDdrzww4cpLOpXYXoOweLOqoOSDImj6hDbPTTCe5fJ3X19BXbBGMpO+m9eOAhsnm4nmajorix0IEuzCbyh7UxWkTy6rl652DbMdfDeFVKANgf8tA917cphEcCvO8yXuq3Su8+cDfWRgwAJ5OPcbSJGo2M5I9sYUlF7bCeHgZqlaroBem0l/Ax+Jf0FFs+XKAdphnI7je5E224RfiyzCum8UbGVgpJCydiqV612VgJzNQnrG9tHdNas8CoiIAgHX/wJxRFjwoQ6yLLgOxmk8HA0fwx4SRAlQA7fUgu54gscsuATt+ExaGqrjfI+h18upF55/mMcL0HXvFmwLLB422Dzni4Z4PgEZD2olSNfkdN10SpKEFESRpm9X+n0CIINRRj3eYo/38OoULvQED1beWCOTBRL/v063qlMULp8uBhpRpWQ+kZWVYaqgrtoRVLq2UKky7DheaS08/s46+LzI2EFTDupYVGxwbkWGeRvvc/6FN6cQuknGPWqclHYI5r3aj5jqHI7zEfGyGNFrvSnJp5ialxFI4/mreuFCjakTrHYdmnOHsT8qXiO1mirOb2wtMI16X1oLq+ENk2dvXbhlnI= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: a088b53b-a0b9-4d77-3c0a-08dcbe169667 X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9642.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Aug 2024 17:12:20.7167 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: ldJfIY5nnZsF7JinkYiYA3dh6MA8EuFAtnncunlRtxzDQZnxrrUGySIJ8zQ0hxDXleASnFCkCz3aS3QdvxlFlw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR04MB8328 Convert binding doc marvel-8xxx.txt to yaml format. Additional change: - Remove marvell,caldata_00_txpwrlimit_2g_cfg_set in example. - Remove mmc related property in example. - Add wakeup-source property. - Remove vmmc-supply and mmc-pwrseq. Fix below warning: arch/arm64/boot/dts/freescale/imx8mp-beacon-kit.dtb: /soc@0/bus@30800000/mmc@30b40000/wifi@1: failed to match any schema with compatible: ['marvell,sd8997'] Signed-off-by: Frank Li Reviewed-by: Rob Herring (Arm) Acked-by: Brian Norris --- Change from v1 to v2 - Add Brian Norris + - Frank Li + +description: + This node provides properties for describing the Marvell SDIO/PCIE wireless device. + The node is expected to be specified as a child node to the SDIO/PCIE controller that + connects the device to the system. + +properties: + compatible: + enum: + - marvell,sd8787 + - marvell,sd8897 + - marvell,sd8978 + - marvell,sd8997 + - nxp,iw416 + - pci11ab,2b42 + - pci1b4b,2b42 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + wakeup-source: true + + marvell,caldata-txpwrlimit-2g: + $ref: /schemas/types.yaml#/definitions/uint8-array + description: Calibration data for the 2GHz band. + maxItems: 566 + + marvell,caldata-txpwrlimit-5g-sub0: + $ref: /schemas/types.yaml#/definitions/uint8-array + description: Calibration data for sub-band 0 in the 5GHz band.. + maxItems: 502 + + marvell,caldata-txpwrlimit-5g-sub1: + $ref: /schemas/types.yaml#/definitions/uint8-array + description: Calibration data for sub-band 1 in the 5GHz band.. + maxItems: 688 + + marvell,caldata-txpwrlimit-5g-sub2: + $ref: /schemas/types.yaml#/definitions/uint8-array + description: Calibration data for sub-band 2 in the 5GHz band.. + maxItems: 750 + + marvell,caldata-txpwrlimit-5g-sub3: + $ref: /schemas/types.yaml#/definitions/uint8-array + description: Calibration data for sub-band 3 in the 5GHz band. + maxItems: 502 + + marvell,wakeup-pin: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Provides the pin number for the wakeup pin from the device's point of + view. The wakeup pin is used for the device to wake the host system + from sleep. This property is only necessary if the wakeup pin is + wired in a non-standard way, such that the default pin assignments + are invalid. + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + #include + + mmc { + #address-cells = <1>; + #size-cells = <0>; + + wifi@1 { + compatible = "marvell,sd8897"; + reg = <1>; + interrupt-parent = <&pio>; + interrupts = <38 IRQ_TYPE_LEVEL_LOW>; + marvell,wakeup-pin = <3>; + }; + }; + diff --git a/Documentation/devicetree/bindings/net/wireless/marvell-8xxx.txt b/Documentation/devicetree/bindings/net/wireless/marvell-8xxx.txt deleted file mode 100644 index cdc303caf5f45..0000000000000 --- a/Documentation/devicetree/bindings/net/wireless/marvell-8xxx.txt +++ /dev/null @@ -1,70 +0,0 @@ -Marvell 8787/8897/8978/8997 (sd8787/sd8897/sd8978/sd8997/pcie8997) SDIO/PCIE devices ------- - -This node provides properties for controlling the Marvell SDIO/PCIE wireless device. -The node is expected to be specified as a child node to the SDIO/PCIE controller that -connects the device to the system. - -Required properties: - - - compatible : should be one of the following: - * "marvell,sd8787" - * "marvell,sd8897" - * "marvell,sd8978" - * "marvell,sd8997" - * "nxp,iw416" - * "pci11ab,2b42" - * "pci1b4b,2b42" - -Optional properties: - - - marvell,caldata* : A series of properties with marvell,caldata prefix, - represent calibration data downloaded to the device during - initialization. This is an array of unsigned 8-bit values. - the properties should follow below property name and - corresponding array length: - "marvell,caldata-txpwrlimit-2g" (length = 566). - "marvell,caldata-txpwrlimit-5g-sub0" (length = 502). - "marvell,caldata-txpwrlimit-5g-sub1" (length = 688). - "marvell,caldata-txpwrlimit-5g-sub2" (length = 750). - "marvell,caldata-txpwrlimit-5g-sub3" (length = 502). - - marvell,wakeup-pin : a wakeup pin number of wifi chip which will be configured - to firmware. Firmware will wakeup the host using this pin - during suspend/resume. - - interrupts : interrupt pin number to the cpu. driver will request an irq based on - this interrupt number. during system suspend, the irq will be enabled - so that the wifi chip can wakeup host platform under certain condition. - during system resume, the irq will be disabled to make sure - unnecessary interrupt is not received. - - vmmc-supply: a phandle of a regulator, supplying VCC to the card - - mmc-pwrseq: phandle to the MMC power sequence node. See "mmc-pwrseq-*" - for documentation of MMC power sequence bindings. - -Example: - -Tx power limit calibration data is configured in below example. -The calibration data is an array of unsigned values, the length -can vary between hw versions. -IRQ pin 38 is used as system wakeup source interrupt. wakeup pin 3 is configured -so that firmware can wakeup host using this device side pin. - -&mmc3 { - vmmc-supply = <&wlan_en_reg>; - mmc-pwrseq = <&wifi_pwrseq>; - bus-width = <4>; - cap-power-off-card; - keep-power-in-suspend; - - #address-cells = <1>; - #size-cells = <0>; - mwifiex: wifi@1 { - compatible = "marvell,sd8897"; - reg = <1>; - interrupt-parent = <&pio>; - interrupts = <38 IRQ_TYPE_LEVEL_LOW>; - - marvell,caldata_00_txpwrlimit_2g_cfg_set = /bits/ 8 < - 0x01 0x00 0x06 0x00 0x08 0x02 0x89 0x01>; - marvell,wakeup-pin = <3>; - }; -};