[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH v8 23/26] docs/fusa: add NS16x50 UART requirements for x86


  • To: Stefano Stabellini <sstabellini@xxxxxxxxxx>
  • From: "Halder, Ayan Kumar" <ayankuma@xxxxxxx>
  • Date: Fri, 20 Nov 2026 11:17:59 +0000
  • Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=kernel.org smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none (0)
  • 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=R1cXXqe72+tKMbfCZJXgKhrA9+bFY4xdOJGYZDSsfnw=; b=pjQCSxwezEh0qYbaC7AnPZhXMm0SDYRWK1YEcKaulX+lmkG3H0mPnMef3cgYIU5/hJ0b5WEB3nIL4DjMtopUvOd0e+hKfaGa7wgj37ygT7yp5d1fLndZEi9QR7KSOMvwXyOnw8f73Jx9KpDu/HCRtBkQZMAAfiL9XSZ1mVmZAEI0mXuYi8WSvOKCY37Iwv38s9dn6Iwha3SB/KSrAkkz41+mgBsuyXCAPbBBPYfUkgShgHYo7HvZGWyzaoUH4XqRJ6qzZ7yFXOED0fVEdZ8rTyJ6cu/xWbJz1oMt/x4QQxfqClBiSfDuoQyC6CK6IRpaBkTZamoxiaz6BKiY5WQr1Q==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=EUXO1T1dIxXRlvKQPKpFN2XKnTAS4T3kcyQ6jcBC9C1SpeorbumXEqQBx/TK3yySHBRLyOIhENraV4PZzSaVX10A+nin3NOcAAaQ96WWw74fkodwqhAM5Kn36lSLgJyGJm9sx+8OPTRrzT72g03HxYznXibvc30hkpy0PmxbeDjnTEt6521M5HU4YS+9N4oKI//5zjcLTXgp1OWz4H1iZSt6jAaeaoQj7AU8C9u0wzGol9FByYajGar87E/k/cyEmD/So6rTO/cTyG+cUlwY+jazdYVIAbJgRw2r4GxuSzlifp1WclKR4tBGg/9EzS24ioDI4/P2obUE0GxE0s1rAw==
  • Authentication-results: eu.smtp.expurgate.cloud; dkim=pass header.s=selector1 header.d=amd.com header.i="@amd.com" header.h="From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck"
  • Cc: <dmukhin@xxxxxxxx>, <xen-devel@xxxxxxxxxxxxxxxxxxxx>, <andrew.cooper3@xxxxxxxxxx>, <anthony.perard@xxxxxxxxxx>, <jbeulich@xxxxxxxx>, <julien@xxxxxxx>, <michal.orzel@xxxxxxx>, <roger@xxxxxxxxxxxxxx>, <xakep.amatop@xxxxxxxxx>, <dmukhin@xxxxxxx>, "Ayan Kumar Halder" <ayan.kumar.halder@xxxxxxx>
  • Delivery-date: Fri, 20 Nov 2026 11:18:29 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>

Hi Stefano,

On 19/11/2026 22:22, Stefano Stabellini wrote:
On Thu, 19 Nov 2026, Halder, Ayan Kumar wrote:
Hi Denis,

The requirements look good. And it is great that you have written the tests as 
well.

So from a FuSa perspective, these requirements are 'covered'.

I want to confirm the tests for each of the requirements.

Refer "[XTF PATCH v1 6/6] x86: add NS16550-compatible emulator test"

On 11/11/2026 19:47, dmukhin@xxxxxxxx wrote:

From: Ayan Kumar Halder <ayan.kumar.halder@xxxxxxx>

Add the market-to-design traceability chain for the emulated
NS16550-compatible UART exposed to x86 domains.

The design requirements are written one per row of the test_suite[]
array in the XTF test tests/emul-ns16x50/main.c, so that each
requirement is covered by a test case.

Additionally, document the assumptions Xen makes on the domain in order
to provide the functionality.

Introduce XenProd~x86_emulated_uart~1 as the product requirement the
design requirements cover, and add the two new documents to the toctree.

Finally, fill in the maintainer of the FUSA (x86) entry and extend it to
cover the x86 product requirements.

Signed-off-by: Ayan Kumar Halder <ayan.kumar.halder@xxxxxxx>
Signed-off-by: Denis Mukhin <dmukhin@xxxxxxxx>
---
  MAINTAINERS                                |   7 +
  docs/fusa/reqs/design-reqs/x86/ns16x50.rst | 386 +++++++++++++++++++++
  docs/fusa/reqs/index.rst                   |   2 +
  docs/fusa/reqs/product-reqs/x86/reqs.rst   |  24 ++
  4 files changed, 419 insertions(+)
  create mode 100644 docs/fusa/reqs/design-reqs/x86/ns16x50.rst
  create mode 100644 docs/fusa/reqs/product-reqs/x86/reqs.rst

diff --git a/MAINTAINERS b/MAINTAINERS
index 327adf4641a1..2c0eaaea2d24 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -335,6 +335,13 @@ F: xen/arch/x86/include/asm/x86_*/efi*.h
  F:    xen/common/efi/
  F:    xen/include/efi/
+FUSA (x86)
+M:     Denis Mukhin <dmukhin@xxxxxxxx>
+R:     Ayan Kumar Halder <ayan.kumar.halder@xxxxxxx>
+S:     Supported
+F:     docs/fusa/reqs/design-reqs/x86
+F:     docs/fusa/reqs/product-reqs/x86
Hi Ayan, Denis,

The MAINTAINERS file is not hierarchical, so with this change the x86
directories would no longer be covered by the maintainers listed under
FUSA.

Could we have at least two maintainers listed? Ayan is already a
reviewer; if he agrees, we could make him a maintainer so that we have
two.

The rest of the patch appears to be acked, so I can make this change on
commit if we all agree.

I am ok with this.

- Ayan




 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.