From nobody Thu Apr 9 23:24:20 2026 Received: from mail-qv1-f48.google.com (mail-qv1-f48.google.com [209.85.219.48]) (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 1769E3BED4A for ; Thu, 5 Mar 2026 15:10:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772723407; cv=none; b=e8t7QbHoReaAkvEeWdbaKBjN2L3WF3VEoVB8drlEQCJXfF72/Lptxe6IOkOl8sQbZ4UOoIOhCcp8I6VmdoYXcnhyjw0uMj7SfK5u9wnjJENrcZLxbebR5GAXsJwyLXA/iYqztOsw8JfAaNqHBPh3+KI6DeamdfRABuWR8QKJ/0Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772723407; c=relaxed/simple; bh=G0Gbsy/4+Z7L57ZxL288jEXgvc4nxW4a2lkG97ek/tU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Y02H6c+ERiNJawcrjdCgUDokMRKJEIUNDPR+ISIEB5s0jHKV0rnsorukVqkHKRdb3uRwKGkeC8E1Vioox0ELtO8z5FlQk6dlXaVcMdS4iK3SmajSQGdC9Zz2z9+i3DgNdu+NQD71/gJGK3+FqEvgiySR3ZaAr0Dc6vO43FI9UhQ= 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=a91Z0cOI; arc=none smtp.client-ip=209.85.219.48 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="a91Z0cOI" Received: by mail-qv1-f48.google.com with SMTP id 6a1803df08f44-899fb030812so63492276d6.2 for ; Thu, 05 Mar 2026 07:10:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1772723404; x=1773328204; 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=yGq/SGkUnWkPEv9Q6uJkwsdq8YtqalI2CxU9i4Sx8jA=; b=a91Z0cOIlSx1VjFSYNDKkwP+ePX6OCFL8/mwnn2Kv861zAPnMktgsd4ukIqGiuuFIx OXuxqmycG4Shii/WT9ME4LUOHkdzLIWQdHdRqcWxSKCXzKU0fRiQJHEprNP77QVeMFhO H83skBroMF3CCWuvlyBg8/LSpTRzKde50IAxzLHf6UXwzxkZZ5DYd6Yw+kmhSylpJMGf rLzdyW9zn4s0ahSILFXfyzPU1yLZPZnyDNt/OkvdNrOkGr2GakAcCiPNt57UvtRT63qQ rgbVjkALDYm7fc8WvJzcRxuSdFamF72sN03nKcepgrBQ3Sfv5cyPr9o1wrnTLhpcl1Ep cnXg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1772723404; x=1773328204; 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=yGq/SGkUnWkPEv9Q6uJkwsdq8YtqalI2CxU9i4Sx8jA=; b=KXy34TSYqvgYhkmNL6oiqi8/UWXW1VBNnFZwNxJBuiHe3ZaqgKRw9UEb2g3sT5rQYY CiQ42XiupTvfPWvPgkiOdZ68gPCXnEBJDFHpQsoGgLJaHKoCY6oLr4l9TxxFoBY57dlj YTpwA11GxwMo2z25yJ0Z1B5+Quh4UxlZ9RrPufmBM/PPKrr4Gc/un46uT7GRcUzUWiII /MzAQy/35BRUzwfSNP7WlEtyoa5gnmDFzlw1VgJd+kIwC0WBTpDuRWcq8ovCmeaDQ5Zr /0HyYSGrlY49pZ4SHhigdh273qR6MFCVSK5WsOi9TPJqVyDsQdnisEUPKq7b93DAurTl HmNw== X-Forwarded-Encrypted: i=1; AJvYcCXWvrA/1bcLoMReEv1Qe0hoHZtlDfRTJAMrQJ3Elz9CYCMYrH2D429kEE/SRiRbP6pfurgXR60V0btBu/Y=@vger.kernel.org X-Gm-Message-State: AOJu0YwDIdVAr3IQhzLDbaVS/LIdI8qDwwfp2ISC18G7GLA2WwIiXbGs LZivsEUK6q4inlceoFSYXQVX5gZElSGQn4Qot2jgCjv+64fcAVdFddZH X-Gm-Gg: ATEYQzwx2eUeIyAJT3GeEfT4Zhf+XK3FTYaGOCzgmGlf093L4qoB+rC/nNKvYvRAKl5 mLaxCe+SjNaJqg1xoMcqgg8Uij4wVsUKny5YH6MWCOz/RL72enp7MKdcJNWAO1oRPmPi2eaAcl3 YpDw1JeaZYgej32gmFYgpSndVuezt0mRSduXKqLM8GtYZix/usLGQHdEi0UIUrlxY9J2+IlNZNs Jxj2lgJUy4L+7/wcwBh88pZtjNVY4FmrTSyu4hcYJblOHKYkacW5zbN+1RBqYb10tRe94Y0trho BTnjNGixyZin9Ai+zy8ipuSq8JWWTWQSw43Dp8Pounf+JC34tisCSZtL5n5Gl13R1SXmM2QecTC iI9oaPtzyYaYjWqlt5NBr7om7rORtVGdL+Ang+kBS/piqtTeeoupplV0e+jceQUZY+Y1naxLP4u SoXn2fA1HDXWF3N8L5v0B6A2EJ+6TZDCeC9LMRe5T5SiBxbexl70DxzojnAaJSmvRumUPElj+AC mC9WJErUMmQ76Dr X-Received: by 2002:ad4:5ce6:0:b0:899:efd1:9e15 with SMTP id 6a1803df08f44-89a2e031eb2mr1649216d6.49.1772723403489; Thu, 05 Mar 2026 07:10:03 -0800 (PST) Received: from PF5YBGDS.localdomain (70.15.25.19.res-cmts.sm3.ptd.net. [70.15.25.19]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-89a0bb6e27asm64183176d6.2.2026.03.05.07.10.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Mar 2026 07:10:02 -0800 (PST) From: mike.marciniszyn@gmail.com To: Alexander Duyck , Jakub Kicinski , kernel-team@meta.com, Andrew Lunn , "David S. Miller" , Eric Dumazet , Paolo Abeni , Simon Horman , Russell King , Jacob Keller , Lee Trager , Mohsin Bashir , Dan Carpenter , Pei Xiao , Stanislav Fomichev , Willem de Bruijn , Samiullah Khawaja , Hangbin Liu Cc: mike.marciniszyn@gmail.com, netdev@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH net-next v3 5/5] eth fbnic: Add mailbox self test Date: Thu, 5 Mar 2026 10:09:47 -0500 Message-ID: <20260305150947.16893-6-mike.marciniszyn@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260305150947.16893-1-mike.marciniszyn@gmail.com> References: <20260305150947.16893-1-mike.marciniszyn@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: "Mike Marciniszyn (Meta)" The mailbox self test ensures the interface to and from the firmware is healthy by sending a test message and fielding the response from the firmware. This patch uses the new completion API [1][2] that allocates a completion structure, binds the completion to the TEST message, and uses a new FW parsing routine that wraps the completion processing around the TLV parser. Link: https://patch.msgid.link/20250516164804.741348-1-lee@trager.us [1] Link: https://patch.msgid.link/20260115003353.4150771-6-mohsin.bashr@gmail.= com [2] Signed-off-by: Mike Marciniszyn (Meta) --- v2 - add enum for test return codes v3 - no changes drivers/net/ethernet/meta/fbnic/fbnic.h | 14 ++- .../net/ethernet/meta/fbnic/fbnic_ethtool.c | 15 +++ drivers/net/ethernet/meta/fbnic/fbnic_fw.c | 100 ++++++++++++++++++ drivers/net/ethernet/meta/fbnic/fbnic_fw.h | 27 +++++ 3 files changed, 142 insertions(+) diff --git a/drivers/net/ethernet/meta/fbnic/fbnic_ethtool.c b/drivers/net/= ethernet/meta/fbnic/fbnic_ethtool.c index b0c8d1b069e2..251de64baa5a 100644 --- a/drivers/net/ethernet/meta/fbnic/fbnic_ethtool.c +++ b/drivers/net/ethernet/meta/fbnic/fbnic_ethtool.c @@ -129,11 +129,13 @@ static const struct fbnic_stat fbnic_gstrings_xdp_sta= ts[] =3D { enum fbnic_self_test_results { TEST_REG =3D 0, TEST_MSIX, + TEST_MBX, }; =20 static const char fbnic_gstrings_self_test[][ETH_GSTRING_LEN] =3D { [TEST_REG] =3D "Register test (offline)", [TEST_MSIX] =3D "MSI-X Interrupt test (offline)", + [TEST_MBX] =3D "FW mailbox test (on/offline)", }; =20 #define FBNIC_TEST_LEN ARRAY_SIZE(fbnic_gstrings_self_test) @@ -1525,11 +1527,24 @@ static int fbnic_ethtool_msix_test(struct net_devic= e *netdev, u64 *data) return !!*data; } =20 +static int fbnic_ethtool_mbx_self_test(struct net_device *netdev, u64 *dat= a) +{ + struct fbnic_net *fbn =3D netdev_priv(netdev); + struct fbnic_dev *fbd =3D fbn->fbd; + + *data =3D fbnic_fw_mbx_self_test(fbd); + + return !!*data; +} + static void fbnic_self_test(struct net_device *netdev, struct ethtool_test *eth_test, u64 *data) { bool if_running =3D netif_running(netdev); =20 + if (fbnic_ethtool_mbx_self_test(netdev, &data[TEST_MBX])) + eth_test->flags |=3D ETH_TEST_FL_FAILED; + if (!(eth_test->flags & ETH_TEST_FL_OFFLINE)) { data[TEST_REG] =3D 0; data[TEST_MSIX] =3D 0; diff --git a/drivers/net/ethernet/meta/fbnic/fbnic_fw.c b/drivers/net/ether= net/meta/fbnic/fbnic_fw.c index 1f0b6350bef4..c2bad51bdde6 100644 --- a/drivers/net/ethernet/meta/fbnic/fbnic_fw.c +++ b/drivers/net/ethernet/meta/fbnic/fbnic_fw.c @@ -378,6 +378,37 @@ fbnic_fw_get_cmpl_by_type(struct fbnic_dev *fbd, u32 m= sg_type) return cmpl_data; } =20 +/** + * fbnic_fw_xmit_test_msg - Create and transmit a test message to FW mailb= ox + * @fbd: FBNIC device structure + * @cmpl: fw completion struct + * + * Return: zero on success, negative value on failure + * + * Generates a single page mailbox test message and places it in the Tx + * mailbox queue. Expectation is that the FW will validate that the nested + * value matches the external values, and then will echo them back to us. + * + * Also sets a completion slot for use in the completion wait calls when + * the cmpl arg is non-NULL. + */ +int fbnic_fw_xmit_test_msg(struct fbnic_dev *fbd, + struct fbnic_fw_completion *cmpl) +{ + struct fbnic_tlv_msg *test_msg; + int err; + + test_msg =3D fbnic_tlv_test_create(fbd); + if (!test_msg) + return -ENOMEM; + + err =3D fbnic_mbx_map_req_w_cmpl(fbd, test_msg, cmpl); + if (err) + free_page((unsigned long)test_msg); + + return err; +} + /** * fbnic_fw_xmit_simple_msg - Transmit a simple single TLV message w/o data * @fbd: FBNIC device structure @@ -1556,7 +1587,29 @@ int fbnic_fw_xmit_send_logs(struct fbnic_dev *fbd, b= ool enable, return err; } =20 +static int +fbnic_fw_parser_test(void *opaque, struct fbnic_tlv_msg **results) +{ + struct fbnic_fw_completion *cmpl; + struct fbnic_dev *fbd =3D opaque; + int err; + + /* find cmpl */ + cmpl =3D fbnic_fw_get_cmpl_by_type(fbd, FBNIC_TLV_MSG_ID_TEST); + if (!cmpl) + return -ENOSPC; + + err =3D fbnic_tlv_parser_test(opaque, results); + + cmpl->result =3D err; + complete(&cmpl->done); + fbnic_fw_put_cmpl(cmpl); + + return err; +} + static const struct fbnic_tlv_parser fbnic_fw_tlv_parser[] =3D { + FBNIC_TLV_PARSER(TEST, fbnic_tlv_test_index, fbnic_fw_parser_test), FBNIC_TLV_PARSER(FW_CAP_RESP, fbnic_fw_cap_resp_index, fbnic_fw_parse_cap_resp), FBNIC_TLV_PARSER(OWNERSHIP_RESP, fbnic_ownership_resp_index, @@ -1787,6 +1840,53 @@ void fbnic_mbx_flush_tx(struct fbnic_dev *fbd) } while (time_is_after_jiffies(timeout)); } =20 +/** + * fbnic_fw_mbx_self_test() - verify firmware interface + * @fbd: device to test + * + * This function tests the interfaces to/from the firmware. + * + * Return: See enum fbnic_fw_self_test_codes + **/ +enum fbnic_fw_self_test_codes fbnic_fw_mbx_self_test(struct fbnic_dev *fbd) +{ + enum fbnic_fw_self_test_codes err; + struct fbnic_fw_completion *cmpl; + + /* Skip test if FW interface is not present */ + if (!fbnic_fw_present(fbd)) + return FBNIC_TEST_FW_NO_FIRMWARE; + + cmpl =3D fbnic_fw_alloc_cmpl(FBNIC_TLV_MSG_ID_TEST); + if (!cmpl) + return FBNIC_TEST_FW_NO_CMPL; + + /* Load a test message onto the FW mailbox interface + * and arm the completion. + */ + err =3D fbnic_fw_xmit_test_msg(fbd, cmpl); + if (err) { + err =3D FBNIC_TEST_FW_NO_XMIT; + goto exit_free; + } + + /* Verify we received a message back */ + if (!fbnic_mbx_wait_for_cmpl(cmpl)) { + err =3D FBNIC_TEST_FW_NO_MSG; + goto exit_cleanup; + } + + /* Verify there were no parsing errors */ + if (cmpl->result) + err =3D FBNIC_TEST_FW_PARSE; +exit_cleanup: + fbnic_mbx_clear_cmpl(fbd, cmpl); +exit_free: + fbnic_fw_put_cmpl(cmpl); + + return err; +} + int fbnic_fw_xmit_rpc_macda_sync(struct fbnic_dev *fbd) { struct fbnic_tlv_msg *mac_array; diff --git a/drivers/net/ethernet/meta/fbnic/fbnic_fw.h b/drivers/net/ether= net/meta/fbnic/fbnic_fw.h index 8f7218900562..d84723e4cfa3 100644 --- a/drivers/net/ethernet/meta/fbnic/fbnic_fw.h +++ b/drivers/net/ethernet/meta/fbnic/fbnic_fw.h @@ -104,6 +104,33 @@ void fbnic_mbx_clear_cmpl(struct fbnic_dev *fbd, void fbnic_mbx_poll(struct fbnic_dev *fbd); int fbnic_mbx_poll_tx_ready(struct fbnic_dev *fbd); void fbnic_mbx_flush_tx(struct fbnic_dev *fbd); + +/** + * enum fbnic_fw_self_test_codes - return codes from self test routines + * + * These are the codes returned from the self test routines and + * stored in the test result array indexed by the specific + * test name. + * + * @FBNIC_TEST_FW_SUCCESS: test success + * @FBNIC_TEST_FW_NO_FIRMWARE: FW interface not present + * @FBNIC_TEST_FW_NO_CMPL: No completion available + * @FBNIC_TEST_FW_NO_XMIT: Could not xmit message + * @FBNIC_TEST_FW_NO_MSG: no message returned + * @FBNIC_TEST_FW_PARSE: returned message had parsing error + */ +enum fbnic_fw_self_test_codes { + FBNIC_TEST_FW_SUCCESS =3D 0, + FBNIC_TEST_FW_NO_FIRMWARE =3D 10, + FBNIC_TEST_FW_NO_CMPL =3D 20, + FBNIC_TEST_FW_NO_XMIT =3D 30, + FBNIC_TEST_FW_NO_MSG =3D 40, + FBNIC_TEST_FW_PARSE =3D 50, +}; + +enum fbnic_fw_self_test_codes fbnic_fw_mbx_self_test(struct fbnic_dev *fbd= ); +int fbnic_fw_xmit_test_msg(struct fbnic_dev *fbd, + struct fbnic_fw_completion *c); int fbnic_fw_xmit_ownership_msg(struct fbnic_dev *fbd, bool take_ownership= ); int fbnic_fw_init_heartbeat(struct fbnic_dev *fbd, bool poll); void fbnic_fw_check_heartbeat(struct fbnic_dev *fbd); --=20 2.43.0