From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by spool.mail.gandi.net (Postfix) with ESMTPS id 0F378AC1AFB for ; Tue, 28 Nov 2023 19:45:12 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=oZKERFLUZ5IzyBdS22Cgcw/NQbUh67qCP1E+bwMWhOM=; c=relaxed/simple; d=groups.io; h=ARC-Seal:ARC-Message-Signature:ARC-Authentication-Results:From:To:CC:Subject:Thread-Topic:Thread-Index:Date:Message-ID:References:In-Reply-To:Accept-Language:MIME-Version:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:Content-Language:Content-Type:Content-Transfer-Encoding; s=20140610; t=1701200711; v=1; b=AJvPVrkRwTizGzq4+Kt7v1NlZER+/SWK+EajRY8jeyoKYi+lr1+zQk0eL2daSPkgGVc0/UAm dkKfkHBRb2hbcItNqGZz4crEUYNHajpeKpCGns9AwHWtS9V/e6pJM9Uod8ZspkB1A2SM7aoWv6d vzhSHsxmHc2hSsundKhQ3rzk= X-Received: by 127.0.0.2 with SMTP id 0mU7YY7687511xCg96oKnaEa; Tue, 28 Nov 2023 11:45:11 -0800 X-Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.151]) by mx.groups.io with SMTP id smtpd.web11.2059.1701200710585068702 for ; Tue, 28 Nov 2023 11:45:10 -0800 X-IronPort-AV: E=McAfee;i="6600,9927,10908"; a="373194202" X-IronPort-AV: E=Sophos;i="6.04,234,1695711600"; d="scan'208";a="373194202" X-Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 28 Nov 2023 11:43:08 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10908"; a="886546850" X-IronPort-AV: E=Sophos;i="6.04,234,1695711600"; d="scan'208";a="886546850" X-Received: from orsmsx602.amr.corp.intel.com ([10.22.229.15]) by fmsmga002.fm.intel.com with ESMTP/TLS/AES256-GCM-SHA384; 28 Nov 2023 11:43:08 -0800 X-Received: from orsmsx611.amr.corp.intel.com (10.22.229.24) by ORSMSX602.amr.corp.intel.com (10.22.229.15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.34; Tue, 28 Nov 2023 11:43:07 -0800 X-Received: from orsmsx610.amr.corp.intel.com (10.22.229.23) by ORSMSX611.amr.corp.intel.com (10.22.229.24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.34; Tue, 28 Nov 2023 11:43:07 -0800 X-Received: from ORSEDG602.ED.cps.intel.com (10.7.248.7) by orsmsx610.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.34 via Frontend Transport; Tue, 28 Nov 2023 11:43:07 -0800 X-Received: from NAM10-MW2-obe.outbound.protection.outlook.com (104.47.55.101) by edgegateway.intel.com (134.134.137.103) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.34; Tue, 28 Nov 2023 11:43:06 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=UWq95mgp/2KBz2+mP3jgjuLlazWS3pv1GNsE3X1OtLNBhUKGXwvrzxrVFglbkx08dGx1AIgzTu6nhCZlDcePy/gBYXK579fhcqWuPC34Jx6FPQOEYaLNdhTvurK/HMbrc/tmei2WDRyrOxfzDLUuA3TDbQRHA0G5eT1//hzOO8QvyMw//ORHJ/Rul5eAm51IvRoO+GE6qknpYrza6yo/rFyZlTdfNHPEiJuy16UuFdRhgV/dFXoQ4kLjvTIkBBcNJb+iSNEdBb72W9wIs6rrkbr6DmuKqDea4014XLy6ITO4CyVLtfGCQV7uxUZfrb9hGy2fLczvC39hgnQrhjhq8w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=2cxAQ5yZHUVsoRTohK6CombfTom3SQkQhlXZ610sCK8=; b=K8h5Q/4ydu2Zxxdc9XMmIM3cUK3TsOHMT8zma2lZKkYa2kOKB28+Y5iKT5EbduBVYc8+hTy8kmWDuLDBLHYc2nuWK229ETo9FyGbN/RQHsBcuSsAGYVjbYtqgnbMVshxww4Rf8R2LUiHtCkhF43r278BP+iwhD9uo1sZSEfHxASd6fMNyNTW4uwPsWewI5vCJv/8lSZrehEhLnyksg7slHUhE0sYP2Q8VWa75qltxSFKu27a8TUI+UFEpXe1dLqLCpmMBVvdJ6u3yFn3MMSV2y4/ZZi57DqIIXUn3ZfMW5VeiTz8yKmMg3mFWuf9Wtgw6TRsAHCjZ4WyCAMshTBl3A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none X-Received: from CO1PR11MB4929.namprd11.prod.outlook.com (2603:10b6:303:6d::19) by DM4PR11MB6214.namprd11.prod.outlook.com (2603:10b6:8:ac::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.29; Tue, 28 Nov 2023 19:43:05 +0000 X-Received: from CO1PR11MB4929.namprd11.prod.outlook.com ([fe80::4382:5b03:f13:88ff]) by CO1PR11MB4929.namprd11.prod.outlook.com ([fe80::4382:5b03:f13:88ff%4]) with mapi id 15.20.7025.022; Tue, 28 Nov 2023 19:43:05 +0000 From: "Michael D Kinney" To: "Czajkowski, Maciej" , "devel@edk2.groups.io" CC: "Kinney, Michael D" Subject: Re: [edk2-devel][edk2-staging] DeviceSimPkg branch creation Thread-Topic: [edk2-devel][edk2-staging] DeviceSimPkg branch creation Thread-Index: AQHaFkNpBqQjOSpJcEaanfGPa+msQrCQOU1Q Date: Tue, 28 Nov 2023 19:43:05 +0000 Message-ID: References: <20231113150919.1470-1-maciej.czajkowski@intel.com> In-Reply-To: <20231113150919.1470-1-maciej.czajkowski@intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: CO1PR11MB4929:EE_|DM4PR11MB6214:EE_ x-ms-office365-filtering-correlation-id: 8ad0e628-7a42-4f47-10f5-08dbf04a3d76 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam-message-info: RT1OWteUvtprpqdE3wbuIj/VXC1Q80jIFPzu4iFb7VF34nGkpRF7mbfR6Z9sh41ev1FhdQ2lvAemOqeNmGjwjdQ7RmdRV5/B8RrbIMuIT5FXv8YkOC94zwEHfT9YoFFfiIif0VPNXtStDxHI+kPOYctfTc2yJv115FzRZvtSUY41CyZCe8OMng15xWMWIwcM6IT6G8+U5KlFHI6YPUTDzDU0tiXqjJYcntQMB9dVHazyql9j5W5XUlQ47LrzGYJQMDdllTaU0Mz0aJ8ps0+ortw3R/ush0WQOx/nqLGeoCoeBFKNgCLWzjPg/6kRi7ALmoJ3IYN4Rj2Ty4q2+TRznBTuRWZQWxDPsTomK3C79jwiWb8JsKZnp/FEazkbFV/Q6nSkj+hVCF/s3MGfiVkn9phzZbeSBt3v63Q2etRORDykA64nsgOkp5D+XQknprrFhk5a8i4HP1oIAgdFqqMLOOfDaF1+s+GobqrxSSMUm6jTsPSAdLgQ/Af8+Kjf998EccfxkmdBV/Qn3Xbg5S33oMJa0HptYQnc0VnN8G5mEK1Vhsfk1ac3LFe4QubvcCcwri3/wiWpO4rHySxUdkmU91sagO/PRG5bwtbjXXMS2tA= x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?NLwmR+y0U3qkm/ASbZ9+wkfiMcmnebVlr5PCNLTs9/vgunI3Cm+J4qANZZbm?= =?us-ascii?Q?FvhPFlxuCH2U490gw5BV8jhBx9vsg439/KebY2KRK+oUKfz4dQbCB5Jo9af6?= =?us-ascii?Q?4YyAoBgzezSNdDIDO7N35OerqN3ywo9uNcIgu+4RdFagBMyHIGm9VN9ZFzM/?= =?us-ascii?Q?udMoQdsAIypA8ueTyIXnu4ZR2lfvCv7LtcfKeAPr7Ggt+2Rt7koDcHbquU38?= =?us-ascii?Q?Ty4FSrQr5tOMVYAYMvaBBvUeAox/9ZHkUqTFp5gys3nQrBpsf1hpYwm3G1Np?= =?us-ascii?Q?628T+WASAXPpBxypGIzvkfaeQZth9NUStyPpztr86Jhaf5zPzLuDvILXysVl?= =?us-ascii?Q?OxH5UsKjdv5cyRC/L7D1QI7dt4xGFrVMOuBr/nGvQSZTkoBoxlhN++ecbzGK?= =?us-ascii?Q?vaqxEV83HhrEdxR/oiHIPt69gv0GPAtNPIabrl2fUTq8fFXCyXSUYnOTKOaX?= =?us-ascii?Q?RbXK9pCEh9GOMS0jQCNOCdVs5yNbvSxI+xl9SUn9wCpj5rq85tGu5fApFOBE?= =?us-ascii?Q?7qoGFrYb8c9Q3eLzuYu0kn0vObsDCbFfoYJeeKGaW9wIhtaW7aKKpkG3AvyG?= =?us-ascii?Q?dBb9HvuMMHbZxAxqTbzs2LAGSJ0BQjhjkoA6JlrCcbpm48efZCizmSCPCuUA?= =?us-ascii?Q?IeLkaR9k8HgJe8Z359JpN1SEMRMm3Tz/dTh2yYhc8xdKakZDWtyV2pMht3ev?= =?us-ascii?Q?pV1nMmxMgylFi1m/y1QtbWIvWMAfqB4xgwJheZZJbUXH4tMCy2TpivGfXiD8?= =?us-ascii?Q?QcqNpU3GhfCXG/e9CxmapSxRG1FB6fFvuE2/kqNYV2/18Tl11ZuXsXa8bWSM?= =?us-ascii?Q?Af597l04eIRKoJPwqly7jpKQxSUhfqIx1eeVedHWB0MgcHmIbaWqEE5ybfis?= =?us-ascii?Q?OC4OyrHqZ8XsOeRi99V1v40GizNg01NCkRKTcAf/ArLDL+AX3vWI5WSte4Og?= =?us-ascii?Q?qLoLZTj3w3YBjft0mfHbkGC/zsb9RGTSKQwUo6xV5qng02I1khz5q3kxslRH?= =?us-ascii?Q?HLLxiAdELKnN0ihIu2m34YHu/dtljSwZHXnOK7DSo6QVngIhYKgjG17Rqbd5?= =?us-ascii?Q?gbKWeYKTaLySc2cb4QfVkImabTl/S1SLNpNIoiwbk86IX1jRAJT20kvxSspR?= =?us-ascii?Q?/S+AQycaEisr4Q391ementO+EECZy+pX2/QiOcgI0fF+ufgSMueSlWvoHPta?= =?us-ascii?Q?mfsClQaGzsrBIl3KVzozZlvsdYhgSv+xO9a/lzz3qYGj0ZhWCB7Bw3LA42U6?= =?us-ascii?Q?OMQltGoOzb9kN4B9/wppFfmKzUangpBX80bxQGFyddDgsoMe3crGAwFhybZz?= =?us-ascii?Q?bZKnWG9RcATTnqPO7lMMcxF1xkq+uMlmgcCaUGAjwLjQtfEmMig8OaOryL6E?= =?us-ascii?Q?Qdzh10laMU0LzvcZF7mDW8EILYfWGfXQ7sAdtFxNU9Tjygb38MvMVjhcwi4X?= =?us-ascii?Q?dmXHwla8RyyZkAD/rDVpxgAsavfnafXDdx/7XLCRm46kv0W5Sx/aU9VpKKPA?= =?us-ascii?Q?ZtOvY8ACoXFJiKEOGBXycT/Tjl+g48QdF8cqjnZqghHuwQmWRh1BY50Yskd+?= =?us-ascii?Q?+PQOvboEzYmuMQUX30/aumnVTCMI2S9bSukmIvs3O1HHtnED1g8E0BiLWGNJ?= =?us-ascii?Q?mw=3D=3D?= MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: CO1PR11MB4929.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8ad0e628-7a42-4f47-10f5-08dbf04a3d76 X-MS-Exchange-CrossTenant-originalarrivaltime: 28 Nov 2023 19:43:05.2302 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: yMSRNLg3QIG71nFBiLVpq95rtn+e3Y6t1qcJA/S38Zijn59bg7rxtgZzHYrCCo0AA96uwfqkTazcKti1ChfSjLvWvpkwe2HYWE5QHDjego0= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR11MB6214 X-OriginatorOrg: intel.com Precedence: Bulk List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,michael.d.kinney@intel.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: MMhdYkMneKftpvij2DwNtAICx7686176AA= Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable X-GND-Status: LEGIT Authentication-Results: spool.mail.gandi.net; dkim=pass header.d=groups.io header.s=20140610 header.b=AJvPVrkR; arc=reject ("signature check failed: fail, {[1] = sig:microsoft.com:reject}"); dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=intel.com (policy=none); spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io Hi Maciej, Reviewed-by: Michael D Kinney I have invited you to the EDK II Staging Maintainer team that allows you to create this new branch in the edk2-staging repo. Mike > -----Original Message----- > From: Czajkowski, Maciej > Sent: Monday, November 13, 2023 7:09 AM > To: devel@edk2.groups.io > Cc: Kinney, Michael D > Subject: [edk2-devel][edk2-staging] DeviceSimPkg branch creation >=20 > Hello, >=20 > I would like to announce DeviceSimPkg branch creation in edk2-staging > repository. > Branch will be used to develop DeviceSimPkg, a package for developing OS > executable tests > for device focused code. >=20 > Branch owner: Maciej Czajkowski , GitHub ID: > 81293748 (https://github.com/mczaj) >=20 > Signed-off-by: Maciej Czajkowski > Cc: Michael D Kinney > --- > Readme.md | 37 +++++++++++++++++++++++++++++++++++++ > 1 file changed, 37 insertions(+) > create mode 100644 Readme.md >=20 > diff --git a/Readme.md b/Readme.md > new file mode 100644 > index 000000000000..96077d0a478c > --- /dev/null > +++ b/Readme.md > @@ -0,0 +1,37 @@ > +# DeviceSimPkg > + > +## Introduction > + > +DeviceSimPkg is a package aimed at providing an environment to write OS- > executable unit tests for code that interacts directly with devices. > +This code is referred to as driver code below although code under test > doesn't have to follow UEFI driver model. \ > +Branch owner: Maciej Czajkowski <> > + > +## How to use it > +### Using the code > + > +You can refer to UnitTest modules to see the usage details. In general > you will need to link to package libraries (instead of the ones normally > provided by MdePkg/MdeModulePkg) and initialize your device access. > Details of initialization will vary based on which > REGISTER_ACCESS_INTERFACE implementer library you will > +choose. Please refer to corresponding libraries Readmes for details. > + > +## General architecture > + > +On high-level package consists of: > + > +* REGISTER_ACCESS_INTERFACE - interface between device model and driver > code > +* REGISTER_ACCESS_INTERFACE wrappers - libraries that wrap > REGISTER_ACCESS_INTERFACE and present it as a standard UEFI library > +* REGISTER_ACCESS_INTERFACE implementers - libraries that implement > REGISTER_ACCESS_INTERFACE interface > + > +## Wrapper libraries > + > +Currently package implements following wrappers: > + > +* IoLib in > [RegisterAccessIoLib](DeviceSimPkg/Library/RegisterAccessIoLib/Readme.md) > +* PciSegmentLib in RegisterAccessPciSegmentLib > +* PCI_IO_PROTOCOL in RegisterAccessPciIoLib > + > +## REGISTER_ACCESS_INTERFACE implementations > + > +Currently only a single implementation is fully supported - > FakeRegisterSpaceLib. Please see its Readme for more details on how to us= e > it. > + > +## GMOCK support > + > +DeviceSim implements Gmock based mock object for the IoLib functions. > Please see GmockIoLib [Readme](DeviceSimPkg/Library/MockIoLib//Readme.md) > for details. > -- > 2.39.1.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#111824): https://edk2.groups.io/g/devel/message/111824 Mute This Topic: https://groups.io/mt/102563078/7686176 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/leave/12367111/7686176/19134562= 12/xyzzy [rebecca@openfw.io] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-