Linux on Power Architecture Reference System Software Work Group syssw-chair@openpowerfoundation.org OpenPOWER Foundation 2016 OpenPOWER Foundation Revision 2.0_pre2 OpenPOWER Copyright details are filled in by the template. The purpose of this document is to provide firmware and software architectural details associated with Runtime Abstraction Services (firmware) on OpenPOWER Systems. The base content for this document were contributed to the OpenPOWER Foundation in the IBM Linux on Power Architecture Platform Reference (LoPAPR) Draft document. It had numerous contributors inside IBM. This document is a Standard Track, Work Group Specification work product owned by the System Software Workgroup and handled in compliance with the requirements outlined in the OpenPOWER Foundation Work Group (WG) Process document. It was created using the Master Template Guide version 0.9.5. Comments, questions, etc. can be submitted to the public mailing list for this document at TBD. 2017-10-11 Revision 2.0_pre2 - Updates to include latest PAPR ACRs (2.8) as follows: ISA 2.07 privileged doorbell extensions (9/16/2012) POWER ISA Name Change Category Vector.XOR to Vector.CRYPTO (11/4/2012) Enable Multiple Redirected RDMA mappings per page (3/5/2013) Add Block Invalidate Option (3/5/2013) Implementation Dependent Optimizations (3/13/2013) System Firmware Service Entitlement Date (Warranty Date) Check (4/3/2013) New Function for ibm,change-msi to specify 32 bit MSI (5/14/2013) Remove Client-Architecture-Support bit for UUID option (4/16/2013) AddClient Architecture Support bit for RTAS ibm,change-msi (5/28/2013) Add VNIC Server (5/24/2014) VPA changes for P8 (EBB) (5/24/2013) Add an hcall to clean up the entire MMU hashtable (11/20/2013) Add LPCR[ILE] support to H_SET_MODE (5/31/2013) New Root Node Properties (1/12/2016) Extended Firmware Assisted Dump for P8 Registers (1/24/2014) Sufficient H_COP_OP output buffer (6/21/2014) Extend H_SEND_LOGICAL_LAN for large send packets (6/29/2014) Extend H_GET_MPP_X reporting coalesced pages (8/24/2014) Update ibm,pcie-link-speed-stats property to support PCIe 3.0 link speeds (6/12/2015) Extend ibm,get-system-parameters RTAS to report Energy Management Tuning Parameters (3/18/2015) Additional System Parameters related to mgmt of FW Service Entitlement Warranty period (6/22/2015) Additional System Parameter to read LPAR Name string (10/7/2015) Redesign of properties for DRC information and dynamic memory (7/23/2015) Add additional logical loction code sections (3/4/2016) Add ibm,vnic-client-mac to support vNIC failover (2/29/2016) hcall for registering the process table (3/21/2016) New device tree property for UUID (3/21/2016) Changes for Hotplug RTAS Events (10/24/2016) Support 64-bit PE TCEs in ibm,query-pe-dma-window (7/14/2016) 2016-05-04 Revision 2.0_pre1 - initial conversion from IBM document. Extracted from Linux on Power Architecture Platform Reference (LoPAPR) version 1.1 dated March 24, 2016 -- Chapter 7 (Run-time Abstration Services), Appendix G (Firmware Assisted Dump Data Format), and Appendix I (CMO Characteristics Definition).