From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 8CCE93A7859; Fri, 10 Apr 2026 13:07:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775826470; cv=none; b=Mox8p7b+s5un1YQmQCLmuP5tlIhvp140Sexe0oNvMTST1ppNz5M9GENveDkXUIVcZ2WNiWw1JG6T1hM+eu0SE0x3/ZdJHBNP5FZFDthcQRhQ+qa8liipcTQbnJQCJTgM5Cr/IoVba3So8MewXEtDGwx6zDbwuxHIW2qw7G47qKI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775826470; c=relaxed/simple; bh=GZXFFlTnzKdbEZFmQMlw20A/Pi6qX85elHZMjhsouqY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=lT0RpynSHWV3TdXBi+PZGAzacpxmGHO+Uc14ma0mcf0otd4ATXZtZmRYr9FFEIPFLQ3n7INW95EUpWNrby3u5/kRuCB1jsMdze76qlW9W1BkELQJqFjUN4MbdjuyLkEYN3aAOcSvqZDxl6d9lB9uKhznJ6b5cbM7NmVXYwlLrRg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=JuH2bBoI; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="JuH2bBoI" Received: by smtp.kernel.org (Postfix) with ESMTPS id 59D07C2BCC6; Fri, 10 Apr 2026 13:07:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1775826470; bh=GZXFFlTnzKdbEZFmQMlw20A/Pi6qX85elHZMjhsouqY=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=JuH2bBoIG9m6GkN6JhjEz7Dy9ZRoEnSOiQbLQdByGX/NfLAPZ0MOemEBZ0iLi9ywc I/4OsvWS8Mrei021+yNzh7f57v3ZbYvelNc869X7jaXcWOuTf085yGqRvGM2VtMOAy FxGkz51hMjr7CE2cVntHGqb0ueCwO+3MPqY9WIgDXCsXoD/jh4oIjqW0SHNOt8sT1g erKkRPGydp3E3DxFGfJfIq7+SX8uc8u71L86RzZyhFz+o9nte5cz7tJqwTU5rxZE76 78da0wHKFGL8LobY21NrMWJKUzE5fZ3yu5JxLOBb1K6tRWDZUBy+BEGAoRqHalFNt/ PsdkLUStlRpug== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 51C98F4485F; Fri, 10 Apr 2026 13:07:50 +0000 (UTC) From: Nathan Lynch via B4 Relay Date: Fri, 10 Apr 2026 08:07:23 -0500 Subject: [PATCH 13/23] dmaengine: sdxi: Add unit tests for descriptor ring reservations Precedence: bulk X-Mailing-List: dmaengine@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260410-sdxi-base-v1-13-1d184cb5c60a@amd.com> References: <20260410-sdxi-base-v1-0-1d184cb5c60a@amd.com> In-Reply-To: <20260410-sdxi-base-v1-0-1d184cb5c60a@amd.com> To: Vinod Koul Cc: Wei Huang , Mario Limonciello , Bjorn Helgaas , Jonathan Cameron , Stephen Bates , PradeepVineshReddy.Kodamati@amd.com, John.Kariuki@amd.com, linux-pci@vger.kernel.org, linux-kernel@vger.kernel.org, dmaengine@vger.kernel.org, Nathan Lynch X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1775826467; l=5269; i=nathan.lynch@amd.com; s=20260410; h=from:subject:message-id; bh=96M0WH79Yh/L9470L8b4C78AEBFI/SqNNfiQfEX5P3w=; b=0kiv+rFYk3O+HIB4rLGkttlP47zUaUiDRxHnrUNrT9OwF4HW7fidZvrEiVcyM/6SxrW+1zYNZ aj87bdlfu4/BeN7GcSxDwCgqj7X2LS6RCfksPVVCya3JtkzOeU5v/VK X-Developer-Key: i=nathan.lynch@amd.com; a=ed25519; pk=PK4ozhq+/z9/2Jl5rgDmvHa9raVomv79qM8p1RAFpEw= X-Endpoint-Received: by B4 Relay for nathan.lynch@amd.com/20260410 with auth_id=728 X-Original-From: Nathan Lynch Reply-To: nathan.lynch@amd.com From: Nathan Lynch Add KUnit tests for the descriptor ring reservation API, covering: - Valid reservations: full-ring and single-slot after advancing the read pointer. - Error paths: zero or over-capacity count (-EINVAL), inconsistent index state (-EIO), and insufficient space (-EBUSY). A .kunitconfig is included ease of use: $ tools/testing/kunit/kunit.py run \ --kunitconfig=drivers/dma/sdxi/.kunitconfig No SDXI hardware is required to run these tests. Co-developed-by: Wei Huang Signed-off-by: Wei Huang Signed-off-by: Nathan Lynch --- drivers/dma/sdxi/.kunitconfig | 4 ++ drivers/dma/sdxi/Kconfig | 8 ++++ drivers/dma/sdxi/Makefile | 3 ++ drivers/dma/sdxi/ring_kunit.c | 105 ++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 120 insertions(+) diff --git a/drivers/dma/sdxi/.kunitconfig b/drivers/dma/sdxi/.kunitconfig new file mode 100644 index 000000000000..a98cf19770f0 --- /dev/null +++ b/drivers/dma/sdxi/.kunitconfig @@ -0,0 +1,4 @@ +CONFIG_KUNIT=y +CONFIG_DMADEVICES=y +CONFIG_SDXI=y +CONFIG_SDXI_KUNIT_TEST=y diff --git a/drivers/dma/sdxi/Kconfig b/drivers/dma/sdxi/Kconfig index a568284cd583..e616d3e323bc 100644 --- a/drivers/dma/sdxi/Kconfig +++ b/drivers/dma/sdxi/Kconfig @@ -6,3 +6,11 @@ config SDXI Platform Data Mover devices. SDXI is a vendor-neutral standard for a memory-to-memory data mover and acceleration interface. + +config SDXI_KUNIT_TEST + tristate "SDXI unit tests" if !KUNIT_ALL_TESTS + depends on SDXI && KUNIT + default KUNIT_ALL_TESTS + help + KUnit tests for parts of the SDXI driver. Does not require + SDXI hardware. diff --git a/drivers/dma/sdxi/Makefile b/drivers/dma/sdxi/Makefile index 23536a1defc3..372f793c15b1 100644 --- a/drivers/dma/sdxi/Makefile +++ b/drivers/dma/sdxi/Makefile @@ -7,3 +7,6 @@ sdxi-objs += \ ring.o sdxi-$(CONFIG_PCI_MSI) += pci.o + +obj-$(CONFIG_SDXI_KUNIT_TEST) += \ + ring_kunit.o diff --git a/drivers/dma/sdxi/ring_kunit.c b/drivers/dma/sdxi/ring_kunit.c new file mode 100644 index 000000000000..3bc7073e0c39 --- /dev/null +++ b/drivers/dma/sdxi/ring_kunit.c @@ -0,0 +1,105 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * SDXI descriptor ring management tests. + * + * Copyright Advanced Micro Devices, Inc. + */ +#include +#include +#include +#include +#include +#include +#include +#include + +#include "ring.h" + +MODULE_IMPORT_NS("EXPORTED_FOR_KUNIT_TESTING"); + +static void valid(struct kunit *t) +{ + __le64 wi, ri; + struct sdxi_ring_state r; + struct sdxi_ring_resv resv; + struct sdxi_desc *descs, *desc; + + + descs = kunit_kmalloc_array(t, SZ_1K, sizeof(descs[0]), + GFP_KERNEL | __GFP_ZERO); + KUNIT_ASSERT_NOT_NULL(t, descs); + + ri = wi = 0; + sdxi_ring_state_init(&r, &ri, &wi, SZ_1K, descs); + + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&r, r.entries, &resv), 0); + KUNIT_EXPECT_EQ(t, resv.range.start, 0); + KUNIT_EXPECT_EQ(t, resv.range.end, r.entries - 1); + KUNIT_EXPECT_EQ(t, le64_to_cpu(wi), r.entries); + sdxi_ring_resv_foreach(&resv, desc) { + KUNIT_EXPECT_NOT_NULL_MSG(t, sdxi_ring_resv_next(&resv), + "unexpected null descriptor for index %llu", resv.iter); + } + + ri = cpu_to_le64(1); + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&r, 1, &resv), 0); + KUNIT_EXPECT_EQ(t, le64_to_cpu(wi), r.entries + 1); + KUNIT_EXPECT_NOT_NULL(t, sdxi_ring_resv_next(&resv)); +} + +static void invalid(struct kunit *t) +{ + __le64 wi, ri; + struct sdxi_ring_state rs; + struct sdxi_ring_resv resv; + struct sdxi_desc *descs; + + descs = kunit_kmalloc_array(t, SZ_1K, sizeof(descs[0]), + GFP_KERNEL | __GFP_ZERO); + KUNIT_ASSERT_NOT_NULL(t, descs); + + ri = wi = 0; + sdxi_ring_state_init(&rs, &ri, &wi, SZ_1K, descs); + + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&rs, 0, &resv), -EINVAL); + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&rs, rs.entries + 1, &resv), -EINVAL); + + ri = cpu_to_le64(1); + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&rs, 1, &resv), -EIO); + + ri = 0; + wi = cpu_to_le64(rs.entries); + sdxi_ring_state_init(&rs, &ri, &wi, SZ_1K, descs); + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&rs, 1, &resv), -EBUSY); + + ri = cpu_to_le64(rs.entries); + wi = cpu_to_le64(rs.entries + 1); + sdxi_ring_state_init(&rs, &ri, &wi, SZ_1K, descs); + KUNIT_EXPECT_EQ(t, sdxi_ring_try_reserve(&rs, rs.entries, &resv), -EBUSY); +} + +static struct kunit_case testcases[] = { + KUNIT_CASE(valid), + KUNIT_CASE(invalid), + {} +}; + +static int setup_device(struct kunit *t) +{ + struct device *dev = kunit_device_register(t, "sdxi-mock-device"); + + KUNIT_ASSERT_NOT_ERR_OR_NULL(t, dev); + t->priv = dev; + return 0; +} + +static struct kunit_suite generic_desc_ts = { + .name = "SDXI descriptor ring management", + .test_cases = testcases, + .init = setup_device, +}; +kunit_test_suite(generic_desc_ts); + +MODULE_DESCRIPTION("SDXI descriptor ring tests"); +MODULE_AUTHOR("Nathan Lynch"); +MODULE_LICENSE("GPL"); -- 2.53.0