From sacadmin Thu Mar 10 18:32:57 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 j2B2WvSp003042 for ; Thu, 10 Mar 2005 18:32:57 -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 j2B2VU228664 for ; Thu, 10 Mar 2005 19:31:30 -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 j2B2VT38015637 for ; Thu, 10 Mar 2005 18:31:29 -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 <0ID600H0110YET@san-mail1.west.sun.com> (original mail from hitendra.zhangada@sun.com) for fwarc@sun.com; Thu, 10 Mar 2005 18:31:29 -0800 (PST) Received: from [129.153.85.35] (sr1-usan-05.West.Sun.COM [129.153.85.35]) by san-mail1.west.sun.com (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003)) with ESMTPA id <0ID6004B81OH4S@san-mail1.west.sun.com> for fwarc@sun.com; Thu, 10 Mar 2005 18:31:29 -0800 (PST) Date: Thu, 10 Mar 2005 18:31:29 -0800 From: Hitendra Zhangada Subject: 2005/113 - virtual console device binding fast-track To: Firmware Arch Reply-to: hitendra.zhangada@sun.com Message-id: <42310301.5020309@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 Status: RO Content-Length: 2652 I sponsoring this case for David Kahn. This case is dependent upon approval of FWARC/2005/111 - sun4v device bindings but it is expected that sun4v device bindings will get approved on Monday. I am submitting the console bindings for review before sun4v binding case is approved to expedite the approval process. The timer for this case is set for March 17th (one week from today). If there are major changes to the "virtual-devices" part of the sun4v bindings or the sun4v bindings does not get approved this Monday then the timer will be extended appropriately. The latest specification (version 1.3) is available at, http://sac.sfbay.sun.com/arc/FWARC/2005/113/inception.materials/console.txt I have cut/paste the specification below. ===== #pragma ident "@(#)console.txt 1.3 05/03/10 SMI" Copyright 2004 Sun Microsystems, Inc All Rights Reserved Title: sun4v virtual console device binding 1. This document describes the device binding to Open Firmware for the sun4v virtual console device. The virtual console device is a child of the "virtual-devices" sun4v bus node. 2. Properties 2.1. Open Firmware Defined Properties "reg" - standard propname defining the devices address space A single configuration space entry Note: Since this node is a 'virtual-devices' child node, the reg property format is defined by the 'virtual-devices' binding, which is specified by FWARC/2005/111. "name" - standard propname defining the device name Value: "console" "compatible" - standard propname defining driver compatibility Value: "SUNW,sun4v-console" "interrupts" - standard propname defining the interrupts Value - A single encoded int with the value 1 "device_type" - standard propname defining the programming model Value - "serial" 3. Methods 3.1. Open Firmware Defined Methods open ( -- okay? ) Prepare this device for subsequent use. close ( -- ) Close this previously opened device. read ( addr len -- actual ) Read device into memory buffer; return actual byte count. write ( addr len -- actual ) Write memory buffer to device; return actual byte count. install-abort ( -- ) Begin polling for a console abort sequence. remove-abort ( -- ) Cease polling for a console abort sequence. restore ( -- ) Restore device to useable state after unexpected reset. ring-bell ( -- ) Ring the bell. ======= -- 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 From sacadmin Thu Mar 17 18:31:26 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 j2I2VQSp029508 for ; Thu, 17 Mar 2005 18:31:26 -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 j2I2Ts205625 for ; Thu, 17 Mar 2005 19:29:54 -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 j2I2Ts69001070 for ; Thu, 17 Mar 2005 18:29:54 -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 <0IDI00F01ZTSKP@san-mail1.west.sun.com> (original mail from hitendra.zhangada@sun.com) for fwarc@sun.com; Thu, 17 Mar 2005 18:29:54 -0800 (PST) Received: from [129.153.85.35] (sr1-usan-05.West.Sun.COM [129.153.85.35]) by san-mail1.west.sun.com (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003)) with ESMTPA id <0IDJ00HG609TNH@san-mail1.west.sun.com> for fwarc@sun.com; Thu, 17 Mar 2005 18:29:54 -0800 (PST) Date: Thu, 17 Mar 2005 18:29:53 -0800 From: Hitendra Zhangada Subject: Re: 2005/113 - virtual console device binding fast-track In-reply-to: <42310301.5020309@sun.com> To: Firmware Arch Reply-to: hitendra.zhangada@sun.com Message-id: <423A3D21.5000609@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.6) Gecko/20050310 References: <42310301.5020309@sun.com> Status: RO Content-Length: 3075 Hitendra Zhangada wrote: > I sponsoring this case for David Kahn. This case is dependent > upon approval of FWARC/2005/111 - sun4v device bindings but > it is expected that sun4v device bindings will get approved > on Monday. I am submitting the console bindings for review > before sun4v binding case is approved to expedite the approval > process. > > The timer for this case is set for March 17th (one week from > today). This fast-track case has timed out and is now approved. IAM file has been updated. > > If there are major changes to the "virtual-devices" part of > the sun4v bindings or the sun4v bindings does not get approved > this Monday then the timer will be extended appropriately. > > The latest specification (version 1.3) is available at, > > http://sac.sfbay.sun.com/arc/FWARC/2005/113/inception.materials/console.txt > > > I have cut/paste the specification below. > > ===== > > #pragma ident "@(#)console.txt 1.3 05/03/10 SMI" > Copyright 2004 Sun Microsystems, Inc > All Rights Reserved > > Title: sun4v virtual console device binding > > > 1. This document describes the device binding to Open Firmware > for the sun4v virtual console device. > > The virtual console device is a child of the "virtual-devices" > sun4v bus node. > > 2. Properties > > 2.1. Open Firmware Defined Properties > > "reg" - standard propname defining the devices address space > > A single configuration space entry > > Note: Since this node is a 'virtual-devices' > child node, the reg property format is defined > by the 'virtual-devices' binding, which > is specified by FWARC/2005/111. > > "name" - standard propname defining the device name > > Value: "console" > > "compatible" - standard propname defining driver compatibility > > Value: "SUNW,sun4v-console" > > "interrupts" - standard propname defining the interrupts > > Value - A single encoded int with the value 1 > > "device_type" - standard propname defining the programming model > > Value - "serial" > > > 3. Methods > > 3.1. Open Firmware Defined Methods > > open ( -- okay? ) Prepare this device for subsequent use. > > close ( -- ) Close this previously opened device. > > read ( addr len -- actual ) Read device into memory buffer; > return actual byte count. > > write ( addr len -- actual ) Write memory buffer to device; > return actual byte count. > > install-abort ( -- ) Begin polling for a console abort sequence. > > remove-abort ( -- ) Cease polling for a console abort sequence. > > restore ( -- ) Restore device to useable state after unexpected > reset. > > ring-bell ( -- ) Ring the bell. > > ======= > > -- 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