From nobody Tue Dec 2 02:19:59 2025 Received: from mail-wm1-f53.google.com (mail-wm1-f53.google.com [209.85.128.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 564A33128BA for ; Wed, 19 Nov 2025 18:47:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.53 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763578061; cv=none; b=rThixMKac45NB4KwUlMCcpdZVmwEamsxlM1wCDUeoh3NctIvtKgemmW5wBuM7OLd72AbYmpafDp8/pAfWI6SUhfEsu4OWjehLKK2aT8Xwa+mnuIi6LA8QBUsJXgnU2od5O5ytaAVIM5IEoKEzrr36WIQdw84IRT/Y8qG/xe8qJA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763578061; c=relaxed/simple; bh=1VU8vez7VAT++QNZEEkDasqzO4N4y/rnpDpzft4h/pQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=EC78UpyN4zTqHkLTZvfrl2KM0KR24AsK7a9iBCxqcgyUAn0dXR4nrafj2EGUm+ocreFLNZSUMSl2TwlU+0KDkqD1bIKt2vDXHk1DwxRNUVD0oqOiE9A8X5YWawjGBZKIwNDiODHTnXxC5OcJdln4IomzEsv6OlQ4wsqTXOaC+dk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=itnFfpwf; arc=none smtp.client-ip=209.85.128.53 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="itnFfpwf" Received: by mail-wm1-f53.google.com with SMTP id 5b1f17b1804b1-47755a7652eso696805e9.0 for ; Wed, 19 Nov 2025 10:47:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763578049; x=1764182849; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=A83IouDszoOM4nYAvaeRYh1AjY1berYJB856i9pOeQQ=; b=itnFfpwfa3JcijLUSHrXO8GJExmWS97VaR57kpB1bf2QtkcCiizOExBezGaoLVsOB5 WiaHiZhAWrP3imFu+dc4+4g6689srY2kUJ1qau/ifvYgNlEztmBCO4peuw33rnN8XdOp 1BOYok1f6e4c/YOJRK884JUV4vNL6FfgofocVtwSNBKKn7alyZrLJkU6ceplL0jnR9Wp HA7XdQQGDE7edayBrnJF7Iwcxq7aM1B7oIQvKv3UcMwdwMhOIBD/ZWoBwCzs0Rv16qmV PZ5ntUUCx2i2cZ2rSK9b1aufY5lOVeK78nwnLH/WVejemPCsXrbcubcaX3qUWKLicazR mqkg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763578049; x=1764182849; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=A83IouDszoOM4nYAvaeRYh1AjY1berYJB856i9pOeQQ=; b=FwOwh2X1xeyztJHCeHbca4HWYB2aSL47Eoeeb9gHYilZH9SjvpWnTiDSQ/u7pwQkuC MtatDoDL7X7ThQYUgf9cJJIjlVHMBc6DolDAjA4qTOdPKrssbjOY355iRcUxNYgHKy1L NRr74ozQoYkCfl9GVLnmMUn0GQG/b46dMrNTGIdSBlkX3O7rNDOfu3Y2uFj/4e9c4fSp zzm1ydxBlp8lcNayz/iP4ww8alebTBRH24OiMhLHZyZgFU7aLqu22fEQ7BNIJT/VxV9f AZ0hgPaQWuATpXBy+2QEMrvvO6z06sfSuYXXi9xOJ00HY7dDs4rtHry9SHKHSGHoRuyl sPzQ== X-Gm-Message-State: AOJu0Yx7RA/XJ9HoqgIlthPN9ZwVR/RHPjGEZyEljImxLpk6CB+e0XF8 9I4OvPMmLtMlEvTiqr76elv68iu5e499g8ne0dTg0dnE5A+m2HdO0QLkvwcoeY59 X-Gm-Gg: ASbGncsQK93u947rxWd+wK8L0p8o9NpiyYKiUV7mEsM4PMzpXZVeV35Z6or1hf4YhkT TUZo0B+DVGN0fa4Yl1CFOUC1e/mux3Qshii4Gw0SRm2aXwtHYtFHtJM4Ut0yhNKBnPyuZkR2oLl Fg9w6JqEaG3i+Wdzipq6ooBAHBUY16QuZFKsnh/3hBiVsOPtZ3OVenOGxrlyb0j5plCLMDvMnAM vhqd3pbtUXXzXq89yeXwpepOidYFidXJ+G5zooJ//ydjgqM0kRzIQkJ1IxurnndMCDaqWhqqYmy PwqxapA7p6xkU7FDd0dwV4o+yUkaHE7MVoQGqBaCGVdTBdkbcrrmu9ftqLVfeDLCMZnlnQd1Rvo lsODlT53TV9upwqmdMDGj+kAdywvXhdPTdHiG3pHZMtIkTfehJ5PkhQabuRr3N69XKmd1CN9gjU rgkXodMevnQyVVu8BG1wYYBXcLfT8N0+nbPIlf51SaROhI+klJrANErRQNNqIDFltGe/wGFmGTn b30n2fR41AEi8EoE8HDgKGS X-Google-Smtp-Source: AGHT+IFROQbeM4xEw/+SN2gJ+GHD1xZYoJk0VErnDEBIQaVp+K4Ys8C5aaRCpGFODkSNEgs1i26mpA== X-Received: by 2002:a05:600c:1550:b0:477:b0b9:3131 with SMTP id 5b1f17b1804b1-477b8951fe9mr2833495e9.8.1763578048520; Wed, 19 Nov 2025 10:47:28 -0800 (PST) Received: from iris-Ian.fritz.box (p200300eb5f27c400b58af32dfc3cbd97.dip0.t-ipconnect.de. [2003:eb:5f27:c400:b58a:f32d:fc3c:bd97]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-477b82e8ea6sm4909795e9.8.2025.11.19.10.47.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 19 Nov 2025 10:47:28 -0800 (PST) From: iansdannapel@gmail.com To: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-fpga@vger.kernel.org, mdf@kernel.org, yilun.xu@intel.com, trix@redhat.com, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, heiko@sntech.de, neil.armstrong@linaro.org, mani@kernel.org, kever.yang@rock-chips.com, dev@kael-k.io, iansdannapel@gmail.com Cc: Conor Dooley , Alexander Dahl Subject: [PATCH v5 1/3] dt-bindings: vendor-prefix: Add prefix for Efinix, Inc. Date: Wed, 19 Nov 2025 19:47:04 +0100 Message-ID: <20251119184708.566461-2-iansdannapel@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251119184708.566461-1-iansdannapel@gmail.com> References: <20251119184708.566461-1-iansdannapel@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Ian Dannapel Add entry for Efinix, Inc. (https://www.efinixinc.com/) Signed-off-by: Ian Dannapel Acked-by: Conor Dooley Acked-by: Alexander Dahl --- Documentation/devicetree/bindings/vendor-prefixes.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/devicetree/bindings/vendor-prefixes.yaml b/Docum= entation/devicetree/bindings/vendor-prefixes.yaml index f1d1882009ba..afe41267df32 100644 --- a/Documentation/devicetree/bindings/vendor-prefixes.yaml +++ b/Documentation/devicetree/bindings/vendor-prefixes.yaml @@ -469,6 +469,8 @@ patternProperties: description: Emtop Embedded Solutions "^eeti,.*": description: eGalax_eMPIA Technology Inc + "^efinix,.*": + description: Efinix, Inc. "^egnite,.*": description: egnite GmbH "^einfochips,.*": --=20 2.43.0 From nobody Tue Dec 2 02:19:59 2025 Received: from mail-wm1-f51.google.com (mail-wm1-f51.google.com [209.85.128.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id EA868311963 for ; Wed, 19 Nov 2025 18:47:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763578063; cv=none; b=eTcTWmZRChZvXVAoI6GeIYcO++VMJjWhliSGW8WOYEtV0zD2dLKJZa3NN+Vg+xfoN1sv/mDnv4pRWLkW8KTYx3C2+bhX07ozLZS34ZtYuU96bEypG2BhbTdoNLEIBZgZTb9UQz6W8wvIc46JV4slHO77fyWQKchqULfbLprK4FU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763578063; c=relaxed/simple; bh=U8TCrBTBHMBDeRXWEsimFplzVxGZZOM7cBfndCP4s3g=; h=From:To:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ZZC8c8QW2rsBTXTKqKZrx86hF13ANoa24/ddyRgmo/+6FmVfEWIrXoX31NnejLnJ+6XjPkWLSdmE6+OGDhU6UTyZ+WaW3ApdNBWJxFF6Y/CJ3XN6H3x5oM3CRiEhDhNGRYn/fclEaYSPsUTl1SZkZyO3cxQYo1TMLv9i8HyUJCE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=KWZOlnL7; arc=none smtp.client-ip=209.85.128.51 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="KWZOlnL7" Received: by mail-wm1-f51.google.com with SMTP id 5b1f17b1804b1-477b198f4bcso611965e9.3 for ; Wed, 19 Nov 2025 10:47:34 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763578052; x=1764182852; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=RR3qWt/sDG3G1Q99fkPxp94915dORCZ61UZ5fAGW9WI=; b=KWZOlnL7cLAs4HvV+SBMXOJbOWC2F0AKzFCc9tMMGnpNG406AY/hke/G4n0U/Tis7R xZfiLB0wEHrQmwKSDQO0D1IW/IVxbWo9XdRZ4ZKspgIyC7g21USgJ+z0t2tsp2+P+Rec DoTh0kj+hyUX0AoH8sQ18qPkJnFTKmp9Nx00wEwebRwAXHj4fU4L4MVnFJvK6K64i75m E7/QAY50fVCJp5UGdu6OKsoFh4nwThKcRo36BYfUg77qFv0vGbXHB/pvPY/LgwsiYrp9 OO85GNefK1v8ZiTSfhwCmMKJONa6v290pTsXmwfov501NtULcK5r7AnODeSja8+0VPF6 IFdg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763578052; x=1764182852; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=RR3qWt/sDG3G1Q99fkPxp94915dORCZ61UZ5fAGW9WI=; b=Kf6zYacgkmtLmw4YIBS24FTmabTkaVsgqVfHw5a9pUl9KG/eku47w4b8AG3CTzFds5 Wqpq0A1JuYW1FBc8Fz0n+rHRYUga+ZFJ3C8ykbLPHetgHLtcTO2jSHQgxDIddvCJVieI QUqm9lt2uNTrWzG6ZKfb31JVcAvbU1R0zq6LUoq4ReNwXg58FaLn9HywYQtjW16/Z2Qj kN+Sok3vIZ6s5ER4AMunbb+67xWC3KNEfQroZkdvf3hh62j4JjOSZH6ML52ErSfsnCWo 0DeKpn+TN3CdI6V+1ZEjmMWnkHjzXSchqd5ThFVshJqV2WYwskOC4I3knZmbDAOQHcvC H+IA== X-Gm-Message-State: AOJu0YwAVPvuGXXt1uD0G6VurMxXlOnytAUeowcfjrYqZCrG0y19ANYn A2pEmM3tpDOEoNSBeHTmpGdOblue82RkRi7SLLa4YcwHgaD0ucS0kkzFzhpzuLlu X-Gm-Gg: ASbGncsIhWoxjPM3k4BF6kvDpFas5Loe2cfCDedJs9xOMV9WhR08J3K9OMKWn98Gmpa Au5fl0cDBi+iW64CtlbPHljnHI1xpeTvdqOLMGe4LftBf2+En7vPmTIlzLm+KRs94YISLTtUrSp YHTTdwvdhwL/6eSxYOnCZlR2iY9mnL4Yd/8eGKoqmseWXuOfZgduYr0h7HVMgXFjjbUS//zn0Gx ewqmqEbmzNBylVjumH5SIPKfqSY5tUs0xTC4ikwGRGkJGgAyxFMZPx1hJ2kPLjVktlIK8UAP6lo 8ds2yfACKbJySYGLkZFncWkjiltS9719fjii/s282B6tkp9BGZO4vwbT1Wf/6Kfp5G3kx/ugbSN t6k7dK2fzSFFgtgFTKNEm9vA421eq+WnEYh0+lQNFvBiH0sqiGVbPeDZfhTrsbEYv2qOCNGeueF zNSDSNhPD664fKY99gvxoorX0H+2G39tN6R3YFJ/O/9mxdeddGdGvg6cS6j7/tZDAIpNKTTCrA3 B+1S7l0jhFOIpGUZGTstNpI X-Google-Smtp-Source: AGHT+IGWVqRzVIdI2HiJbqd9d8aRb1UulJ8h0GdhVCJ4DwCO+QpTMuGuwBn/M4IYR3NluDI6T041PQ== X-Received: by 2002:a05:600c:458a:b0:477:7a78:3016 with SMTP id 5b1f17b1804b1-477b8a50e23mr2549755e9.8.1763578052194; Wed, 19 Nov 2025 10:47:32 -0800 (PST) Received: from iris-Ian.fritz.box (p200300eb5f27c400b58af32dfc3cbd97.dip0.t-ipconnect.de. [2003:eb:5f27:c400:b58a:f32d:fc3c:bd97]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-477b82e8ea6sm4909795e9.8.2025.11.19.10.47.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 19 Nov 2025 10:47:31 -0800 (PST) From: iansdannapel@gmail.com To: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-fpga@vger.kernel.org, mdf@kernel.org, yilun.xu@intel.com, trix@redhat.com, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, heiko@sntech.de, neil.armstrong@linaro.org, mani@kernel.org, kever.yang@rock-chips.com, dev@kael-k.io, iansdannapel@gmail.com Subject: [PATCH v5 2/3] dt-bindings: fpga: Add Efinix SPI programming bindings Date: Wed, 19 Nov 2025 19:47:05 +0100 Message-ID: <20251119184708.566461-3-iansdannapel@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251119184708.566461-1-iansdannapel@gmail.com> References: <20251119184708.566461-1-iansdannapel@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Ian Dannapel Add device tree bindings documentation for configuring Efinix FPGA using serial SPI passive programming mode. Signed-off-by: Ian Dannapel --- .../bindings/fpga/efinix,trion-spi.yaml | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 Documentation/devicetree/bindings/fpga/efinix,trion-spi= .yaml diff --git a/Documentation/devicetree/bindings/fpga/efinix,trion-spi.yaml b= /Documentation/devicetree/bindings/fpga/efinix,trion-spi.yaml new file mode 100644 index 000000000000..9ac37e5e5094 --- /dev/null +++ b/Documentation/devicetree/bindings/fpga/efinix,trion-spi.yaml @@ -0,0 +1,77 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/fpga/efinix,spi.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Efinix SPI FPGA Manager + +maintainers: + - Ian Dannapel + +description: | + Efinix FPGAs (Trion, Topaz, and Titanium families) support loading bitst= reams + through "SPI Passive Mode". + Note: Additional pins hogs for bus width configuration must be set + elsewhere, if necessary. Only bus width 1x serial is supported. + + References: + - https://www.efinixinc.com/docs/an006-configuring-trion-fpgas-v6.3.pdf + - https://www.efinixinc.com/docs/an033-configuring-titanium-fpgas-v2.8.p= df + - https://www.efinixinc.com/docs/an061-configuring-topaz-fpgas-v1.1.pdf + +allOf: + - $ref: /schemas/spi/spi-peripheral-props.yaml# + +properties: + compatible: + enum: + - efinix,trion-spi + - efinix,titanium-spi + - efinix,topaz-spi + + spi-cpha: true + + spi-cpol: true + + spi-max-frequency: + maximum: 25000000 + + reg: + maxItems: 1 + + reset-gpios: + description: + reset and re-configuration trigger pin (low active) + maxItems: 1 + + cdone-gpios: + description: + optional configuration done status pin (high active) + maxItems: 1 + +required: + - compatible + - reg + - reset-gpios + +unevaluatedProperties: false + +examples: + - | + #include + spi { + #address-cells =3D <1>; + #size-cells =3D <0>; + cs-gpios =3D <&gpio5 13 GPIO_ACTIVE_LOW>; + fpga-mgr@0 { + compatible =3D "efinix,trion-spi"; + reg =3D <0>; + spi-max-frequency =3D <25000000>; + spi-cpha; + spi-cpol; + reset-gpios =3D <&gpio4 17 GPIO_ACTIVE_LOW>; + cdone-gpios =3D <&gpio0 9 GPIO_ACTIVE_HIGH>; + }; + }; +... --=20 2.43.0 From nobody Tue Dec 2 02:19:59 2025 Received: from mail-wm1-f44.google.com (mail-wm1-f44.google.com [209.85.128.44]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9C3472DC78D for ; Wed, 19 Nov 2025 18:47:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.44 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763578073; cv=none; b=sUmkCljhOfaFUZ8xsOxtNY07vaUR4RU1AFz+2dRjSnXNn0KUfP7JYTT26yXrcv4ErA5+bOdZWidyVO/Ft70ENG7d7zH+zqboPOCcfn++AmX9LYYuF+4/l8L5fneFQCpfMAQNNepXNSQkMYIpv9DT4dPKa6uWW0wOnHPhpktXSR0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763578073; c=relaxed/simple; bh=Tv1eAdhQHSWAlUW6LScmbNGfJzz1gmQ/O/XZmm+eLxs=; h=From:To:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=KVTnQos118rtf5YYLEEKuFPmI9qpIGEunEwW07cP4Qm7/Cu2QDbWTR/n9pEQePMStqllrmA9nvHQ2+TM3wGFn4zehD+67wuhEkr6WpI+H8R92Npewqlhvyi/MRAP5TZ5BecH92UDsTMlqLOdoXNRdzz+EJbGgrN+iIkqKAJLpNc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=GI02/0BH; arc=none smtp.client-ip=209.85.128.44 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="GI02/0BH" Received: by mail-wm1-f44.google.com with SMTP id 5b1f17b1804b1-477b91680f8so225525e9.0 for ; Wed, 19 Nov 2025 10:47:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763578060; x=1764182860; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=ITAPmWjWHfAxOOhIuXDANdTyH6b8fLP88ZKP703/IUU=; b=GI02/0BHw4nTTQ4dyJjH2n9aFJpB4PozmMIpZPvnWYPeTqsW5QLMty49NBA2+eB2kq j2PIazTlM4lQYdgf+3sKQeAUbYO7A8FF/BSDqlxAr/5ts6JxqB23ySVwMP6jkV3HDW96 q8p0uhr65ua69fCS2VG13l+NkYSTDg2J9ATNloBfoPvnHvv/Uc0jdQ7pmLRiAk7oGQ1X srVs1oRfnkEERP9VMdB9JEdpF31JYapdaYTvYxV5cxDWjVnb8dNIKUToQrG6FTs76WTz BwEFxcT+Vci7BhCqER5uCpN6FXXEi+S79vaeMfys/QsdIQwRh950fmxKj0QntGv/S3yS pO/w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763578060; x=1764182860; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=ITAPmWjWHfAxOOhIuXDANdTyH6b8fLP88ZKP703/IUU=; b=tOEHPYVgzdCboV2uX/gAZM3WlUjdgq3fPqV4UGTqACEe91jof7NX/rlsUhfD2fRuaG KxHm1iH/iAs5AAOGWNpbWVldzsuyB/6oHuD9xY4e9ldcXYwvNMDvQYwoTPJZddeRd8P9 rnMU4ViYuptfwWNZjAgzN6KCjQp4ZvGnf5CuYs2UfXv0yExe7Hc+qJKyPP2g21sqZ5lf u7MRFr6ejOiWFppi8+faehH7I71JfC7y3PenyHZ4cmMfnIXg29kU2ognTZzQ/B7+b4+a vq4DMeyK501IAHC0aC+nLtlxQyiTmWzgDVZ+VcH6ECbcMdnf5Z4pzHUXt5/YU+7zYYa+ 7+4A== X-Gm-Message-State: AOJu0YykJnlQpk+uUeBBktinkBWsJR/dR3AMDdOsMm+IESLm98rmkFyV aow0Zx1yoe/l6zleypp/6yXG2AmRW9fnA5r6m1wx+A4P8QHFMYHOEtyo/PnnnZUo X-Gm-Gg: ASbGnctOeW1PNCxS5ikb9hAIaOkr/ffL2HQaLwIGgVcGWNK2PkTbyTSyPncRfeBDn0u 0QOpAy09e9/sTGaBPfPbqwZwBA+BsohsUcPVqD7qqcz6mHd+GX+LKlfZgETINxfWCASCPYWPGEx F2Q5Eec/M40uwWYSOVn/wREVr/0qNhYUwbZDWUTsfEAknpw0MCOQ2/jgdFylGF41UQHLug9S+xk Vc2FsiqDqVmXYzrRr0i2n4WjyyU8ZGRnvkj7nWHwhstZdUtFD/gaKIkio406rVlQY7ZorhaJGLh OK0ziiWF1IbyWjBZFHiDUCMci+aAh0dH3p5IiCw5rS+XsL6r9PX8mHXez9louwkv2GhPGDl9Onx 4cU0ody1sEO6RQGP2nS3W8Nr+kPG+YYqVBFnf+/6EbhVotkYMLowXBqBIvFSYZto+gLNnxsAYvJ xfycgndCuZIWgA7uWXTgJEY28gcQf4Y6ycGKJTZKmCgozzIyR5X/5iD8MG7+AJ5iZQMc5r0RNc/ ltRgi6t3Ib13gguSlu97sGE X-Google-Smtp-Source: AGHT+IErCv+sOQgcO5mi8NftvWwZqQ/+UAV7XQ9k7EDWfASMBaFhDi8VaGpvOa0KVUbzTOD3bneiTA== X-Received: by 2002:a05:600c:3b07:b0:46e:37fe:f0e6 with SMTP id 5b1f17b1804b1-477b8a9c8b8mr3035295e9.30.1763578060201; Wed, 19 Nov 2025 10:47:40 -0800 (PST) Received: from iris-Ian.fritz.box (p200300eb5f27c400b58af32dfc3cbd97.dip0.t-ipconnect.de. [2003:eb:5f27:c400:b58a:f32d:fc3c:bd97]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-477b82e8ea6sm4909795e9.8.2025.11.19.10.47.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 19 Nov 2025 10:47:39 -0800 (PST) From: iansdannapel@gmail.com To: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-fpga@vger.kernel.org, mdf@kernel.org, yilun.xu@intel.com, trix@redhat.com, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, heiko@sntech.de, neil.armstrong@linaro.org, mani@kernel.org, kever.yang@rock-chips.com, dev@kael-k.io, iansdannapel@gmail.com Subject: [PATCH v5 3/3] fpga-mgr: Add Efinix SPI programming driver Date: Wed, 19 Nov 2025 19:47:06 +0100 Message-ID: <20251119184708.566461-4-iansdannapel@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251119184708.566461-1-iansdannapel@gmail.com> References: <20251119184708.566461-1-iansdannapel@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable From: Ian Dannapel Add a new driver for loading binary firmware to configuration RAM using "SPI passive mode" on Efinix FPGAs. Signed-off-by: Ian Dannapel --- drivers/fpga/Kconfig | 7 ++ drivers/fpga/Makefile | 1 + drivers/fpga/efinix-spi.c | 256 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 264 insertions(+) create mode 100644 drivers/fpga/efinix-spi.c diff --git a/drivers/fpga/Kconfig b/drivers/fpga/Kconfig index 37b35f58f0df..b5d60ba62900 100644 --- a/drivers/fpga/Kconfig +++ b/drivers/fpga/Kconfig @@ -83,6 +83,13 @@ config FPGA_MGR_XILINX_SPI FPGA manager driver support for Xilinx FPGA configuration over slave serial interface. =20 +config FPGA_MGR_EFINIX_SPI + tristate "Efinix FPGA configuration over SPI" + depends on SPI + help + FPGA manager driver support for Efinix FPGAs configuration over SPI + (passive mode only). + config FPGA_MGR_ICE40_SPI tristate "Lattice iCE40 SPI" depends on OF && SPI diff --git a/drivers/fpga/Makefile b/drivers/fpga/Makefile index aeb89bb13517..adbd51d2cd1e 100644 --- a/drivers/fpga/Makefile +++ b/drivers/fpga/Makefile @@ -18,6 +18,7 @@ obj-$(CONFIG_FPGA_MGR_TS73XX) +=3D ts73xx-fpga.o obj-$(CONFIG_FPGA_MGR_XILINX_CORE) +=3D xilinx-core.o obj-$(CONFIG_FPGA_MGR_XILINX_SELECTMAP) +=3D xilinx-selectmap.o obj-$(CONFIG_FPGA_MGR_XILINX_SPI) +=3D xilinx-spi.o +obj-$(CONFIG_FPGA_MGR_EFINIX_SPI) +=3D efinix-spi.o obj-$(CONFIG_FPGA_MGR_ZYNQ_FPGA) +=3D zynq-fpga.o obj-$(CONFIG_FPGA_MGR_ZYNQMP_FPGA) +=3D zynqmp-fpga.o obj-$(CONFIG_FPGA_MGR_VERSAL_FPGA) +=3D versal-fpga.o diff --git a/drivers/fpga/efinix-spi.c b/drivers/fpga/efinix-spi.c new file mode 100644 index 000000000000..953cf94f1f03 --- /dev/null +++ b/drivers/fpga/efinix-spi.c @@ -0,0 +1,256 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * FPGA Manager Driver for Efinix + * + * Copyright (C) 2025 iris-GmbH infrared & intelligent sensors + * + * Ian Dannapel + * + * Load Efinix FPGA firmware over SPI using the serial configuration inter= face. + * + * Note: Only passive mode (host initiates transfer) is currently supporte= d. + */ + +#include +#include +#include +#include +#include +#include + +/* 13 dummy bytes =E2=86=92 104 SPI clock cycles (8 bits each) + * Used to meet the requirement for >100 clock cycles idle sequence. + */ +#define EFINIX_SPI_IDLE_CYCLES_BYTES 13 + +/* tDMIN: Minimum time between deassertion of CRESET_N to first + * valid configuration data. (32 =C2=B5s) + */ +#define EFINIX_TDMIN_US_MIN 35 +#define EFINIX_TDMIN_US_MAX 40 + +/* tCRESET_N: Minimum CRESET_N low pulse width required to + * trigger re-configuration. (320 ns) + */ +#define EFINIX_TCRESETN_DELAY_MIN_US 1 +#define EFINIX_TCRESETN_DELAY_MAX_US 2 + +/* tUSER: Minimum configuration duration after CDONE goes high + * before entering user mode. (25 =C2=B5s) + */ +#define EFINIX_TUSER_US_MIN 30 +#define EFINIX_TUSER_US_MAX 35 + +struct efinix_spi_conf { + struct spi_device *spi; + struct gpio_desc *cdone; + struct gpio_desc *reset; + bool bus_locked; +}; + +static void efinix_spi_reset(struct efinix_spi_conf *conf) +{ + gpiod_set_value(conf->reset, 1); + usleep_range(EFINIX_TCRESETN_DELAY_MIN_US, EFINIX_TCRESETN_DELAY_MAX_US); + gpiod_set_value(conf->reset, 0); + usleep_range(EFINIX_TDMIN_US_MIN, EFINIX_TDMIN_US_MAX); +} + +static enum fpga_mgr_states efinix_spi_state(struct fpga_manager *mgr) +{ + struct efinix_spi_conf *conf =3D mgr->priv; + + if (conf->cdone && gpiod_get_value(conf->cdone) =3D=3D 1) + return FPGA_MGR_STATE_OPERATING; + + return FPGA_MGR_STATE_UNKNOWN; +} + +static int efinix_spi_write_init(struct fpga_manager *mgr, + struct fpga_image_info *info, + const char *buf, size_t count) +{ + struct efinix_spi_conf *conf =3D mgr->priv; + struct spi_transfer assert_cs =3D { + .cs_change =3D 1, + }; + struct spi_message message; + int ret; + + if (info->flags & FPGA_MGR_PARTIAL_RECONFIG) { + dev_err(&mgr->dev, "Partial reconfiguration not supported\n"); + return -EOPNOTSUPP; + } + + spi_bus_lock(conf->spi->controller); + conf->bus_locked =3D true; + spi_message_init_with_transfers(&message, &assert_cs, 1); + ret =3D spi_sync_locked(conf->spi, &message); + if (ret) { + spi_bus_unlock(conf->spi->controller); + conf->bus_locked =3D false; + return ret; + } + + /* Reset with CS asserted */ + efinix_spi_reset(conf); + + return 0; +} + +static int efinix_spi_write(struct fpga_manager *mgr, const char *buf, + size_t count) +{ + struct spi_transfer write_xfer =3D { + .tx_buf =3D buf, + .len =3D count, + .cs_change =3D 1, /* Keep CS asserted */ + }; + struct efinix_spi_conf *conf =3D mgr->priv; + struct spi_message message; + int ret; + + spi_message_init_with_transfers(&message, &write_xfer, 1); + ret =3D spi_sync_locked(conf->spi, &message); + if (ret) { + dev_err(&mgr->dev, "SPI error in firmware write: %d\n", ret); + if (conf->bus_locked) { + spi_bus_unlock(conf->spi->controller); + conf->bus_locked =3D false; + } + } + return ret; +} + +static int efinix_spi_write_complete(struct fpga_manager *mgr, + struct fpga_image_info *info) +{ + unsigned long timeout =3D + jiffies + usecs_to_jiffies(info->config_complete_timeout_us); + struct spi_transfer clk_cycles =3D { + .len =3D EFINIX_SPI_IDLE_CYCLES_BYTES, + }; + struct efinix_spi_conf *conf =3D mgr->priv; + struct spi_message message; + int ret =3D -1, done =3D 0; + bool expired =3D false; + u8 *dummy_buf; + + dummy_buf =3D kzalloc(EFINIX_SPI_IDLE_CYCLES_BYTES, GFP_KERNEL); + if (!dummy_buf) { + ret =3D -ENOMEM; + goto unlock_spi; + } + + clk_cycles.tx_buf =3D dummy_buf; + spi_message_init_with_transfers(&message, &clk_cycles, 1); + ret =3D spi_sync_locked(conf->spi, &message); + if (ret) { + dev_err(&mgr->dev, "SPI error in write complete: %d\n", ret); + goto free_buf; + } + + if (conf->cdone) { + while (!expired) { + done =3D gpiod_get_value(conf->cdone); + if (done < 0) { + ret =3D done; + goto free_buf; + } + if (done) + break; + + usleep_range(10, 20); + expired =3D time_after(jiffies, timeout); + } + + if (expired) { + dev_err(&mgr->dev, "Timeout waiting for CDONE\n"); + ret =3D -ETIMEDOUT; + goto free_buf; + } + } + + usleep_range(EFINIX_TUSER_US_MIN, EFINIX_TUSER_US_MAX); + +free_buf: + kfree(dummy_buf); +unlock_spi: + if (conf->bus_locked) { + spi_bus_unlock(conf->spi->controller); + conf->bus_locked =3D false; + } + return ret; +} + +static const struct fpga_manager_ops efinix_spi_ops =3D { + .state =3D efinix_spi_state, + .write_init =3D efinix_spi_write_init, + .write =3D efinix_spi_write, + .write_complete =3D efinix_spi_write_complete, +}; + +static int efinix_spi_probe(struct spi_device *spi) +{ + struct efinix_spi_conf *conf; + struct fpga_manager *mgr; + + conf =3D devm_kzalloc(&spi->dev, sizeof(*conf), GFP_KERNEL); + if (!conf) + return -ENOMEM; + + conf->spi =3D spi; + + conf->reset =3D devm_gpiod_get(&spi->dev, "reset", GPIOD_OUT_HIGH); + if (IS_ERR(conf->reset)) + return dev_err_probe(&spi->dev, PTR_ERR(conf->reset), + "Failed to get RESET gpio\n"); + + if (!(spi->mode & SPI_CPHA) || !(spi->mode & SPI_CPOL)) + return dev_err_probe(&spi->dev, -EINVAL, + "Unsupported SPI mode, set CPHA and CPOL\n"); + + conf->cdone =3D devm_gpiod_get_optional(&spi->dev, "cdone", GPIOD_IN); + if (IS_ERR(conf->cdone)) + return dev_err_probe(&spi->dev, PTR_ERR(conf->cdone), + "Failed to get CDONE gpio\n"); + + mgr =3D devm_fpga_mgr_register(&spi->dev, + "Efinix FPGA Manager", + &efinix_spi_ops, conf); + + conf->bus_locked =3D false; + + return PTR_ERR_OR_ZERO(mgr); +} + +static const struct of_device_id efinix_spi_of_match[] =3D { + { .compatible =3D "efinix,trion-spi", }, + { .compatible =3D "efinix,titanium-spi", }, + { .compatible =3D "efinix,topaz-spi", }, + {} +}; +MODULE_DEVICE_TABLE(of, efinix_spi_of_match); + +static const struct spi_device_id efinix_ids[] =3D { + { "trion-spi", 0 }, + { "titanium-spi", 0 }, + { "topaz-spi", 0 }, + {}, +}; +MODULE_DEVICE_TABLE(spi, efinix_ids); + +static struct spi_driver efinix_spi_driver =3D { + .driver =3D { + .name =3D "efinix-spi", + .of_match_table =3D efinix_spi_of_match, + }, + .probe =3D efinix_spi_probe, + .id_table =3D efinix_ids, +}; + +module_spi_driver(efinix_spi_driver); + +MODULE_LICENSE("GPL"); +MODULE_AUTHOR("Ian Dannapel "); +MODULE_DESCRIPTION("Efinix FPGA SPI Programming Driver"); --=20 2.43.0