From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR03-VE1-obe.outbound.protection.outlook.com (mail-oln040092072059.outbound.protection.outlook.com [40.92.72.59]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 21F2320958BE9 for ; Tue, 5 Sep 2017 20:19:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=jQt3HIUmGK8OGPme0sX/dkXYu1EOSiJ5yXXwNu0pRGo=; b=Jy4TIhdwyOcTFnCfQE4pEqn89Lii6bsqdcXSTAnB7RVBv8lv/X2joGeFzj4Mt8o0ZiftWLIsNX6mNMyVYQR231Ua1shVcyOocS0V5m94dXv4EWEnpvU20o8ccFmqArNXU0mWNZca66X7sVR1bsOV779z5/3Cs3kFhjwIzmFrpdaC/UGdlGJ9M1PupEGhzcujHNd+plXumZIi3y0DhBHgCrheeaQwToPiRsQFhiMFxZuIrvVR+iDhJsp3V1ympa8vwX0MEc2Psu1vaC50BXKNaH/RhRbe/t/nwZxhZZtJsWvTbCBOyItdHeURKD1jERh5XvE8QOhwyLM7J1rgxO66hQ== Received: from DB5EUR03FT032.eop-EUR03.prod.protection.outlook.com (10.152.20.52) by DB5EUR03HT206.eop-EUR03.prod.protection.outlook.com (10.152.21.235) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.1385.11; Wed, 6 Sep 2017 03:21:58 +0000 Received: from AM4PR06MB1491.eurprd06.prod.outlook.com (10.152.20.58) by DB5EUR03FT032.mail.protection.outlook.com (10.152.20.162) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1385.11 via Frontend Transport; Wed, 6 Sep 2017 03:21:57 +0000 Received: from AM4PR06MB1491.eurprd06.prod.outlook.com ([fe80::6cae:b5f6:6e86:86b0]) by AM4PR06MB1491.eurprd06.prod.outlook.com ([fe80::6cae:b5f6:6e86:86b0%13]) with mapi id 15.20.0013.018; Wed, 6 Sep 2017 03:21:57 +0000 From: Marvin H?user To: "edk2-devel@lists.01.org" Thread-Topic: PI 1.6: Issues within the SPI sections. Thread-Index: AdMmvwtNCvQ32VhVRT+pHJESLZsZqQ== Date: Wed, 6 Sep 2017 03:21:57 +0000 Message-ID: Accept-Language: de-DE, en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: lists.01.org; dkim=none (message not signed) header.d=none;lists.01.org; dmarc=none action=none header.from=outlook.com; x-incomingtopheadermarker: OriginalChecksum:1B0FC5B4BFA21C3D1B9E5EBF037A2D767EA035ADC97A53031B7B3CA11F2D75B1; UpperCasedChecksum:84943BBEF34398D2CBF42E9BC2BFF0E7AFC25017BBD446ABE366B9BCB5E6F600; SizeAsReceived:6985; Count:43 x-tmn: [mtYRLX2S19ItfJ5TQe7vxceZls0IyzW4+p62qWyEraeDr1eHV/HUIOsOFsbxYMxl] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; DB5EUR03HT206; 6:HhBlXF9f3EcemIAUu7748ZOJFjVk9u9H6d0BHcPdl5dcONuJzilCj0RbrISNd+FAxmRloKafZmVI/VBiVrnaFzqoO9ehjDENfYsRw1GQNcMOgsFQE5dwylTgIP+SRl/FbQyhf/iHMv3Ldd6FTHf84J/3mr6+jm+Rthf7e577VffSCbB+L3EFxkAmo8iCQRx2IU8KXQZxTHUEmeydSUrr//O6trUJALzf0b7kpGCNg5FUlG4iLomQmYF82wSeog93SwLEd4WHV5BRPfnyREAY8IjLpjSheGO69mGG6VX38fPcQrvIyHxO2dAwk84lNhzIHOXGtRH2GRwvcsbz+IVbqQ==; 5:+kRg+TvBzMOOsEKQ95zY/NXJSx3zwNpjtoCpidZbarunyoEgfs48movPnmm7hCIZ77CsfAh/7+Fv3FAgGW2BD6COZkoFxHRaYmpFnnWqpn9DH59E4DRkUzGMx9SsiiwW8Or5EiDtPEr+bPz1O44BlQ==; 24:5hu5M7G1jeuxY5Z8AB8wmGFIQO5DBwna8oUDOVrJk52FYbI5p2r2w2fHwcMV0t3mzUm6jukoofzbRLYp6gPzRRJWD56gH/LgMW/rtO5ORsk=; 7:Le6n0VsyiplGEvqWZhMZBdrJDByQI4yuTEWn3JYuINmg0LAmKlBbYIwrcfPbVNLH6/Ji64qoyS1G0dNBk3w7QthSzZx2o1d1sQI1AS4xh2Ldkp4cUgKebmH/ieZ2Ta1WEP7kfQQ0UxsmuyTRVPMJK8H+etPUedCckmrpszvyPixox3XWR4Zc72lGJPmYxvQC7KbBrHXc6Xa7Ac0ac64TBtfzBXcUovHdS0nHx5rLK2I= x-incomingheadercount: 43 x-eopattributedmessage: 0 x-ms-office365-filtering-correlation-id: c690fbf7-0395-4e60-4b98-08d4f4d66e77 x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(300000502095)(300135100095)(22001)(300000503095)(300135400095)(201702061074)(5061506573)(5061507331)(1603103135)(2017031320274)(2017031324274)(2017031323274)(2017031322404)(1601125374)(1603101448)(1701031045)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:DB5EUR03HT206; x-ms-traffictypediagnostic: DB5EUR03HT206: x-exchange-antispam-report-test: UriScan:(21748063052155); x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(444000031); SRVR:DB5EUR03HT206; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:DB5EUR03HT206; x-forefront-prvs: 0422860ED4 x-forefront-antispam-report: SFV:NSPM; SFS:(7070007)(98901004); DIR:OUT; SFP:1901; SCL:1; SRVR:DB5EUR03HT206; H:AM4PR06MB1491.eurprd06.prod.outlook.com; FPR:; SPF:None; LANG:; spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM MIME-Version: 1.0 X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Sep 2017 03:21:57.9260 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Internet X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB5EUR03HT206 X-Content-Filtered-By: Mailman/MimeDel 2.1.22 Subject: PI 1.6: Issues within the SPI sections. X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Sep 2017 03:19:10 -0000 Content-Language: de-DE Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Dear UEFI contributors, I am not an UEFI contributor and hence cannot submit changes. Could somebod= y please take note of the following? 1. I do not see EFI_SPI_TRANSACTION_TYPE defined anywhere. There is a li= st of names for possible values with descriptions (PI 1.6, Vol. 5, page 368= ), though not assigned to numerical values. The size of the type is unknown= , as far as I can see. 2. Some parameter names in the protocol descriptions are flawed (e.g. PI= 1.6, Vol. 5, page 368: "Read Bytes", "Read Buffer"). 3. Some protorype return types are flawed (e.g. PI 1.6, Vol. 5, page 367= : "EFI STATUS" (space instead of underscore); page 364: "FI STATUS" (same a= s before, also "E" missing)). 4. Some prototype parameter types are flawed (e.g. PI 1.6, Vol. 5, page = 364: "EFI- LEGACY- SPI- FLASH- PROTOCOL"). 5. Some status code descriptions are flawed (e.g. PI 1.6, Vol. 5, page 3= 64: "BLocksToProtect" (capital "L")). 6. Some formatations are flawed (e.g. PI 1.6, Vol. 5, page 358: multiple= parameters in one line). 7. Some function decorators are flawed (e.g. PI 1.6, Vol. 5, page 357: "= In" (lower-case "n")). 8. Some function parameter names are flawed (e.g. PI 1.6, Vol. 5, page 3= 56: "LengthinBytes" (lower-case "i")). 9. Some descriptions contain spaces in inappropiate places (e.g. PI 1.5,= Vol. 5, page 349: "EFI_SPI_P ART"). 10. Occasionally incorrect punctuation (e.g. PI 1.6, Vol. 5, page 346: "[= ...] SPI busses, The SPI bus layer [...]" (comma instead of period)). 11. PI 1.6, Vol. 5, page 349: The description of "SpiPeripheralDriverGuid= " speaks of a "Driversupported" routine. Is EFI_DRIVER_BINDING_PROTOCOL.Sup= ported() meant by this? 12. PI 1.6, Vol. 5, page 350: The description of "ChipSelectParameter" co= ntains spaces, though they are barely noticable when having the PDF opened = with the latest version of Acrobat DC. Can this be fixed? 13. UEFI PI 1.6, Vol. 5, 18.2 contains a reference to "EDK2". Is this int= ended? Please note that this list is not complete. Maybe the entire section 18 sho= uld be reviewed again? Thank you in advance! Regards, Marvin.