From sacadmin Tue Jan 18 19:04:10 2005 Received: from sunmail1brm.Central.Sun.COM (sunmail1brm.Central.Sun.COM [129.147.62.17]) by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j0J349ac021092 for ; Tue, 18 Jan 2005 19:04:10 -0800 (PST) Received: from westmail1mpk.West.Sun.COM (westmail1mpk.West.Sun.COM [129.153.100.33]) by sunmail1brm.Central.Sun.COM (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j0J33Gh16103 for ; Tue, 18 Jan 2005 20:03:17 -0700 (MST) Received: from phys-san-2 (phys-san-2.West.Sun.COM [129.153.85.71]) by westmail1mpk.West.Sun.COM (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j0J33G84024601 for ; Tue, 18 Jan 2005 19:03:16 -0800 (PST) Received: from conversion-daemon.san-mail1.west.sun.com by san-mail1.west.sun.com (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003)) id <0IAJ00G01MHDO7@san-mail1.west.sun.com> (original mail from hitendra.zhangada@sun.com) for fwarc@sun.com; Tue, 18 Jan 2005 19:03:16 -0800 (PST) Received: from [129.153.85.36] (sr1-usan-06.West.Sun.COM [129.153.85.36]) by san-mail1.west.sun.com (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003)) with ESMTPA id <0IAJ00BLCN5F18@san-mail1.west.sun.com> for fwarc@sun.com; Tue, 18 Jan 2005 19:03:15 -0800 (PST) Date: Tue, 18 Jan 2005 19:03:15 -0800 From: Hitendra Zhangada Subject: Fast-track : 2005/030 - MSI properties To: Firmware Arch Reply-to: hitendra.zhangada@sun.com Message-id: <41EDCDF3.4040805@sun.com> Organization: Sun Microsystems Inc. MIME-version: 1.0 Content-type: multipart/mixed; boundary="Boundary_(ID_6XPHjPxntlOoG3WUrzxOQw)" X-Accept-Language: en-us, en User-Agent: Mozilla/5.0 (X11; U; SunOS sun4u; en-US; rv:1.7.5) Gecko/20041229 Status: RO This is a multi-part message in MIME format. --Boundary_(ID_6XPHjPxntlOoG3WUrzxOQw) Content-type: text/plain; charset=us-ascii; format=flowed Content-transfer-encoding: 7BIT I am sponsoring this case for David Kahn. The one-pager and the MSI property descriptions are attached as well as copied in the "materials" directory under case directory. http://sac.sfbay.sun.com/Archives/CaseLog/arc/FWARC/2005/030/materials/ The timer for this case times-out on January 25th, 2005. Thanks. -- Hitendra Zhangada ==================================== SPS Common SW Features Engineering Scalable Systems Group, Sun Microsystems, Inc. Sun Ph# (858) 625 3757, Sun Ext. x53757 Internal homepage http://esp.west/~hitu --Boundary_(ID_6XPHjPxntlOoG3WUrzxOQw) Content-type: text/plain; name=1pager.txt Content-transfer-encoding: 7BIT Content-disposition: inline; filename=1pager.txt Template Version: @(#)onepager.txt 1.29 04/11/15 SMI 1. Introduction 1.1. Project/Component Working Name: MSI related-properties for "fire" based host bridges 1.2. Name of Document Author/Supplier: David.Kahn@sun.com 1.3. Date of This Document: 01/13/05 1.4. Name of Major Document Customer(s)/Consumer(s): n/a 1.4.2. The ARC(s) you expect to review your project: FWARC 1.4.3. The Director/VP who is "Sponsoring" this project: Tony.Barreca@sun.com 1.4.4. The name of your business unit: SSG 1.5. Email Aliases: 1.5.1. Responsible Manager: Gary.Hethcoat@sun.com 1.5.2. Responsible Engineer: David.Kahn@sun.com 1.5.3. Marketing Manager: 1.5.4. Interest List: 2. Project Summary 2.1. Project Description: Define properties needed for the MSI implementation on the fire "family" of sun host adaptors. 2.2. Risks and Assumptions: low risk. 3. Business Summary 3.1. Problem Area: Define properties describing the implementation and options for Message Signaled Interrupts (MSI) on Sun host adaptors, 3.2. Market/Requester: SSG, any platform based on Fire, Niagara2, Rock, etc. 3.3. Business Justification: MSI is specified by PCI standards and required by PCI Express. We must support MSI on systems which have MSI support and particularly systems based on Fire or Fire derivatives. 3.4. Competitive Analysis: Intel, IBM, HP, etc. 3.5. Opportunity Window/Exposure: Support needs to be there for Ontario platform. 3.6. How will you know when you are done?: When the fire OS driver supports MSIs. #ifndef HALF_PAGER // A Half Pager stops at this point 4. Technical Description: 4.1. Details: Create a set of MSI-specific properties describing the MSI implementation on Fire and Fire-related host adaptors. (See case materials.) 4.2. Bug/RFE Number(s): None. 4.3. In Scope: n/a 4.4. Out of Scope: n/a 4.5. Interfaces: A set of properties described by the document msi-props.txt, in the case directory. 4.6. Doc Impact: None. The properties are an interface between the "firmware" and the fire OS driver. 4.7. Admin/Config Impact: n/a 4.8. HA Impact: n/a 4.9. I18N/L10N Impact: none 4.10. Packaging & Delivery: n/a 4.11. Security Impact: none 4.12. Dependencies: none. 5. Reference Documents: PCI and PCI-Express Specifications describe the MSI requirements and are located at http://pcisig.com/ Fire PRM, describes the Fire implementation of MSI in the host adaptor. 6. Resources and Schedule: 6.1. Projected Availability: Q3 2005 6.2. Cost of Effort: One person, 3 months. 6.3. Cost of Capital Resources: n/a 6.4. Product Approval Committee requested information: 6.4.1. Consolidation or Component Name: ON 6.4.3. Type of CPT Review and Approval expected: n/a, this is a part of Ontario and other projects. 6.4.4. Project Boundary Conditions: n/a 6.4.5. Is this a necessary project for OEM agreements: no. 6.4.6. Notes: 6.4.7. Target RTI Date/Release: n/a - Will be integrated with Ontario platform support. 6.4.8. Target Code Design Review Date: 6.4.9. Update approval addition: n/a 6.5. ARC review type: FastTrack 7. Prototype Availability: 7.1. Prototype Availability: Available now. 7.2. Prototype Cost: n/a #endif --Boundary_(ID_6XPHjPxntlOoG3WUrzxOQw) Content-type: text/plain; name=msi-props.txt Content-transfer-encoding: 7BIT Content-disposition: inline; filename=msi-props.txt #pragma ident "@(#)msi-props.txt 1.10 05/01/18 SMI" This document describes a set of MSI properties related to the Fire-based PCI Express host adaptors including Niagara2, Rock, etc. MSI related properties msi-address-ranges - Decoded MSI address ranges. Two tuples in the form: {pci-addr.hi, pci-addr.lo size} ... Each field in each tuple is an encoded integer. Describes the pci address ranges decoded as MSIs. Any write to an address within these ranges is considered an MSI/X transaction. The low order n bits of data selects which msi# is being targeted. The first tuple shall be the pci-mem32 entry. #msi - Number of MSI's (Required) A single encoded integer. Describes the number of unique MSI messages. Typically 256 for fire, etc. msi-data-mask - Optional property defines which MSI data bits are used to select the msi#. A single encoded integer. Describes the number of significant bits of MSI data used to select the msi#. Default is 0xff when absent. msi-ranges - Optional list of available msi numbers. Format is one or more tuples in the form: {msi#, #msis} Each field in the tuple is a single encoded integer. Describes the MSI numbers available to the client. For each tuple, the first number (msi#) is the base MSI number in the range. The second number is the span of this range. Thus, the value {0, 256} describes a range starting at 0 and ending at 255. Similarly, the value {128, 64} describes a range starting at 128 and ending at 191. If the property is absent, the default value is {0, 256} msi-eq-size - Optional number of records in MSI-EQ. A single encoded integer, containing the EQ size. Describes the size of the MSI-EQs in number of records in the buffer. Default is 256. This property is host adaptor specific. This definition applies to the fire family of host adaptors and to the vpci host adaptor. This property shall be absent if it doesn't apply. msix-data-width - Optional property describes the number of significant bits in the MSI-X data. (16 for Fire 1.0) A single encoded integer. Default value is 32. Must be published for Fire 1.0 as 16. NB: Fire 1.0 drops the upper 16 bits of MSI-X data. Thus, the upper 16 bits of the data won't appear in the MSI EQ data record, even if assigned by software. This property is host adaptor specific. This definition applies to the fire family of host adaptors and to the vpci host adaptor. This property shall be absent if it doesn't apply. #msi-eqs - Optional number of MSI EQs. A single encoded integer. Describes the number of MSI EQs available to the client. Default when absent is 36. This property is host adaptor specific. This definition applies to the fire family of host adaptors and to the vpci host adaptor. This property shall be absent if it doesn't apply. msi-eq-to-devino - Optional list of msi-eq to interrupt number mappings. Format is 1 or more tuples in the form: (msi-eq#, #msi-eqs, devino#) Each field in each tuple is an encoded integer. Describes the MSI-EQ numbers available to the client and the mapping from an MSI-EQ number to a device interrupt number (devino). The first field (msi-eq#) is the first MSI-EQ number available. The second field (#msi-eqs) is the number of MSI-EQs in this range. The third field is the first devino in this range. If the range (#msi-eqs) is > 1, then the entry is shorthand for a range of consecutive mappings. For each n: msi-eq# + n -> devino# + n where n varies from 0 to #msi-eqs - 1. Default when absent is a single tuple: {0, 36, 24} This property is host adaptor specific. This definition applies to the fire family of host adaptors and to the vpci host adaptor. This property shall be absent if it doesn't apply. --Boundary_(ID_6XPHjPxntlOoG3WUrzxOQw)-- From sacadmin Tue Jan 25 18:20:43 2005 Received: from sunmail1brm.Central.Sun.COM (sunmail1brm.Central.Sun.COM [129.147.62.17]) by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j0Q2Khac002544 for ; Tue, 25 Jan 2005 18:20:43 -0800 (PST) Received: from westmail2san.west.sun.com (westmail2san.West.Sun.COM [129.153.85.6]) by sunmail1brm.Central.Sun.COM (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j0Q2Jkh21596 for ; Tue, 25 Jan 2005 19:19:46 -0700 (MST) Received: from phys-san-2 (phys-san-2.West.Sun.COM [129.153.85.71]) by westmail2san.west.sun.com (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j0Q2JjYW009855 for ; Tue, 25 Jan 2005 18:19:46 -0800 (PST) Received: from conversion-daemon.san-mail1.west.sun.com by san-mail1.west.sun.com (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003)) id <0IAW00401JPP1C@san-mail1.west.sun.com> (original mail from hitendra.zhangada@sun.com) for fwarc@sun.com; Tue, 25 Jan 2005 18:19:45 -0800 (PST) Received: from [129.153.85.36] (sr1-usan-06.West.Sun.COM [129.153.85.36]) by san-mail1.west.sun.com (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003)) with ESMTPA id <0IAW00F4TJSXQ8@san-mail1.west.sun.com> for fwarc@sun.com; Tue, 25 Jan 2005 18:19:45 -0800 (PST) Date: Tue, 25 Jan 2005 18:19:45 -0800 From: Hitendra Zhangada Subject: Re: Fast-track : 2005/030 - MSI properties In-reply-to: <41EDCDF3.4040805@sun.com> To: Firmware Arch Reply-to: hitendra.zhangada@sun.com Message-id: <41F6FE41.3080704@sun.com> Organization: Sun Microsystems Inc. MIME-version: 1.0 Content-type: text/plain; charset=us-ascii; format=flowed Content-transfer-encoding: 7BIT X-Accept-Language: en-us, en User-Agent: Mozilla/5.0 (X11; U; SunOS sun4u; en-US; rv:1.7.5) Gecko/20041229 References: <41EDCDF3.4040805@sun.com> Status: RO Hitendra Zhangada wrote: > I am sponsoring this case for David Kahn. The one-pager > and the MSI property descriptions are attached as well > as copied in the "materials" directory under case directory. > > http://sac.sfbay.sun.com/Archives/CaseLog/arc/FWARC/2005/030/materials/ > > > The timer for this case times-out on January 25th, 2005. The timer for this case has timed-out and this case is now approved. IAM file has been updated. -- Hitendra Zhangada ==================================== SPS Common SW Features Engineering Scalable Systems Group, Sun Microsystems, Inc. Sun Ph# (858) 625 3757, Sun Ext. x53757 Internal homepage http://esp.west/~hitu