summaryrefslogtreecommitdiffstats
path: root/doc/device-tree/ibm,opal
Commit message (Collapse)AuthorAgeFilesLines
* power-mgmt : occ : Add 'freq-domain-mask' DT propertyAbhishek Goel2019-02-251-0/+37
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a new device-tree property freq-domain-indicator to define group of CPUs which would share same frequency. This property has been added under power-mgmt node. It is a bitmask. Bitwise AND is taken between this bitmask value and PIR of cpu. All the CPUs lying in the same frequency domain will have same result for AND. For example, For POWER9, 0xFFF0 indicates quad wide frequency domain. Taking AND with the PIR of CPUs will yield us frequency domain which is quad wise distribution as last 4 bits have been masked which represent the cores. Similarly, 0xFFF8 will represent core wide frequency domain for P8. Also, Add a new device-tree property domain-runs-at which will denote the strategy OCC is using to change the frequency of a frequency-domain. There can be two strategy - FREQ_MOST_RECENTLY_SET and FREQ_MAX_IN_DOMAIN. FREQ_MOST_RECENTLY_SET : the OCC sets the frequency of the quad to the most recent frequency value requested by the CPUs in the quad. FREQ_MAX_IN_DOMAIN : the OCC sets the frequency of the CPUs in the Quad to the maximum of the latest frequency requested by each of the component cores. Signed-off-by: Abhishek Goel <huntbag@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.ibm.com>
* powercap: occ: Fix the powercapping range allowed for userShilpasri G Bhat2019-02-251-1/+8
| | | | | | | | | | | | | | | | OCC provides two limits for minimum powercap. One being hard powercap minimum which is guaranteed by OCC and the other one is a soft powercap minimum which is lesser than hard-min and may or may not be asserted due to various power-thermal reasons. So to allow the users to access the entire powercap range, this patch exports soft powercap minimum as the "powercap-min" DT property. And it also adds a new DT property called "powercap-hard-min" to export the hard-min powercap limit. Fixes: c6aabe3f2eb5("powercap: occ: Add a generic powercap framework") Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Reviewed-by: Vaidyanathan Srinivasan <svaidy@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.ibm.com>
* sensor-groups : occ: Add 'ops' DT propertyShilpasri G Bhat2017-08-111-7/+12
| | | | | | | | Add new device-tree property 'ops' to define different operations supported on each sensor-group. Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc: RST syntax fixesStewart Smith2017-08-014-15/+25
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* sensors: occ: Add support to clear sensor groupsShilpasri G Bhat2017-07-281-0/+40
| | | | | | | | | | Adds a generic API to clear sensor groups. OCC inband sensor groups such as CSM, Profiler and Job Scheduler can be cleared using this API. It will clear the min/max of all sensors belonging to OCC sensor groups. Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* psr: occ: Add support to change power-shifting-ratioShilpasri G Bhat2017-07-281-0/+53
| | | | | | | | | | | Add support to set the CPU-GPU power shifting ratio which is used by the OCC power capping algorithm. PSR value of 100 takes all power away from CPU first and a PSR value of 0 caps GPU first. Documentation enhanced by Stewart Smith. Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* powercap: occ: Add a generic powercap frameworkShilpasri G Bhat2017-07-281-0/+48
| | | | | | | | | | | This patch adds a generic powercap framework and exports OCC powercap sensors using which system powercap can be set inband through OPAL-OCC command-response interface. Documentation for powercap enhanced by Stewart Smith. Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* occ: Fix Pstate ordering for P9Shilpasri G Bhat2017-05-312-10/+48
| | | | | | | | | | | | | | In P9 the pstate values are positive. They are continuous set of unsigned integers [0 to +N] where Pmax is 0 and Pmin is N. The linear ordering of pstates for P9 has changed compared to P8. P8 has neagtive pstate values advertised as [0 to -N] where Pmax is 0 and Pmin is -N. This patch adds helper routines to abstract pstate comparison with pmax and adds sanity pstate limit checks. This patch also fixes pstate arithmetic by using labs(). Suggested-by: Gautham R. Shenoy <ego@linux.vnet.ibm.com> Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc/sensors: be explicit about the encoding of sensor ID/handle not being ABIStewart Smith2016-12-081-1/+2
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* sensor: add a family field in the handlerCédric Le Goater2016-12-081-3/+6
| | | | | | | | | | | | | | Currently, we are hijacking the last bit of the resource field of the sensor handler to differentiate the sensor families and route the opal_sensor_read() call to the appropriate component. Let's reserve the last 3bits and provide an API to set the sensor family for current use and future use. This gives us a maximum of 8 families and 32 resource classes. The FSP uses 15, so we should be fine for a while. Signed-off-by: Cédric Le Goater <clg@kaod.org> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc: Document path of /ibm,opal/diagnostics being ABIStewart Smith2016-10-311-0/+3
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc: device-tree snippets should be dts code-blocksStewart Smith2016-10-287-15/+73
| | | | | | This gets us syntax highlighting of device tree snippets. Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc: use RST references where appropriateStewart Smith2016-10-282-1/+5
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* Change .txt to .rst for correctnessNageswara R Sastry2016-10-281-1/+1
| | | | | | | | | This patch changes .txt to .rst for correctness of the documentation files, path to the documentation files Signed-off-by: Nageswara R Sastry <rnsastry@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc/device-tree/ibm, opal: fix ReStructured Text syntaxStewart Smith2016-08-027-68/+77
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc/device-tree/ibm, opal: rename .txt to .rstStewart Smith2016-08-027-0/+0
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* Document changes to how firmware versions are passed to host on P9Stewart Smith2016-07-201-1/+3
| | | | | | We won't do mi-version/ml-version, but we will always have version. Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc/device-tree: Add documentation for ibm, cpu-idle-state-* propertiesShreyas B. Prabhu2016-06-201-5/+27
| | | | | | | | | | | | | | Add documentation for following nodes- ibm,cpu-idle-state-pmicr ibm,cpu-idle-state-pmicr-mask ibm,cpu-idle-state-psscr ibm,cpu-idle-state-psscr-mask ibm,cpu-idle-state-flags Also removing ibm,cpu-idle-state-names from FIXME since its already documented. Acked-by: Michael Neuling <mikey@neuling.org> Signed-off-by: Shreyas B. Prabhu <shreyas@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* occ: Add support to read V2 format of OCC-OPAL shared memory regionShilpasri G Bhat2016-02-231-0/+11
| | | | | | | | | | | Add support to read OCC-OPAL shared memory region version2 to parse ultra-turbo pstates and core-to-max-pstate-allowed array and append it to device tree. Each element of core-to-max-pstate-allowed indicates the maximum pstate sustained with 'n' online cores. Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> Reviewed-by: Joel Stanley <joel@jms.id.au> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* FSP/LEDS: Remove led-loc propertyVasant Hegde2015-07-171-3/+0
| | | | | | | | | | | | | | | | | | We added led-loc property.. which contains LED location information. But this property was never used. Also we can make out LED location (enclosure/component) based on location code (if location code doesn't contain "-" means its enclosure location code). As Ben suggested [1], removing this property. Present code is included in skiboot skiboot-5.0 release..But we don't have any consumer yet. Hence I think its fine to make this changes. [1] https://lists.ozlabs.org/pipermail/linuxppc-dev/2015-June/130433.html Suggested-by: Benjamin Herrenschmidt <benh@kernel.crashing.org> Signed-off-by: Vasant Hegde <hegdevasant@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* LEDS: Rename led node as ledsVasant Hegde2015-07-021-3/+3
| | | | | | | | | | | | | | | | | | | | | Presently we are creating '/ibm,opal/led' node and populating all LED related information there. Ben [1] suggested to rename this as 'leds'. Present code is included in skiboot skiboot-5.0 release..But we don't have any consumer yet. Hence I think its fine to make this changes. Finally updated node name in doc file. [1] https://lists.ozlabs.org/pipermail/linuxppc-dev/2015-June/130433.html Suggested-by: Benjamin Herrenschmidt <benh@kernel.crashing.org> Signed-off-by: Vasant Hegde <hegdevasant@linux.vnet.ibm.com> Reviewed-by: Stewart Smith <stewart@linux.vnet.ibm.com> [stewart@linux.vnet.ibm.com: We're *lucky* that no FSP based system shipped with skiboot with /led/ rather than /leds/, in future, as the OpenPower ecosystem grows, we will unlikly be able to make this kind of assumption that nobody else went and used this layout. This is likely the last of this kind of change.] Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* Merge PRD rework from stableStewart Smith2015-05-211-0/+10
|\
| * hw/prd: Expose prd ranges via device treeJeremy Kerr2015-05-211-0/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Currently, the prd reserved ranges are present in the reserved-ranges nodes in the device tree. While this works, it's difficult to filter the actual PRD ranges from general reserved memory. This change links the prd ranges into the /reserved-memory nodes, by adding ibm,prd-label properties to those used for PRD. This change adds a prd node to the ibm,opal node too, to giver kernel & userspace information about the prd infrastructure provided by OPAL. Signed-off-by: Jeremy Kerr <jk@ozlabs.org> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* | hdata: Detect LED mode and populate device treeVasant Hegde2015-05-071-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | FSP based machine supports two different LED modes: - Light Path : Both identify and fault LEDs are supported - Guiding Light: Only identify LEDs are supported And this information is passed to OPAL via HDAT. Lets parse this and populate the device tree. Later LED driver uses this information to populate indivisual LED node. Device Tree property: /ibm,opal/led/led-mode : lightpath/guidinglight Signed-off-by: Vasant Hegde <hegdevasant@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* | update version/m[il]-version docs indicating properties may not be presentStewart Smith2015-05-071-3/+4
| | | | | | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* | FSP/CUPD: Device tree documentation for firmware informationVasant Hegde2015-05-071-0/+27
|/ | | | | | | Lets document the firmware version related device tree properties. Signed-off-by: Vasant Hegde <hegdevasant@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* dts: add memory buffers temperature sensorsCédric Le Goater2015-03-241-0/+26
| | | | | | | | | | The memory buffer chips (Centaur) have DTS very similar to the ones we find on the cores. Only available on open power machines for the moment. Signed-off-by: Cédric Le Goater <clg@fr.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* dts: add device tree documentationCédric Le Goater2015-03-241-0/+67
| | | | | | | | Let's document what has been done so far for DTS sensors in the device tree under node ibm,opal/sensors/ Signed-off-by: Cédric Le Goater <clg@fr.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* FSP/LEDS: Add device tree nodesVasant Hegde2015-03-201-0/+33
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch creates a parent LED device node called 'led' under the root 'opal' device node. This also creates child device nodes under 'led' corresponding to all individual LEDs on the system whether it is an enclosure type or a descendant type with their location code as name. The location code information will be used by the host to enlist and access all the individual LEDs present on the system. The child LED device nodes also have the properties 'led-types' and 'led-loc' representing what kind of LEDs present on the same loation code and whether it is an enclosure type LED or a descendant type LED. Sample device tree output: ibm,opal { .. .. led { compatible = "ibm,opal-v3-led"; phandle = <0x1000006b>; linux,phandle = <0x1000006b>; U78C9.001.RST0027-P1-C1 { led-types = "identify", "fault"; led-loc = "descendent"; phandle = <0x1000006f>; linux,phandle = <0x1000006f>; }; <snip> }; }; Signed-off-by: Vasant Hegde <hegdevasant@linux.vnet.ibm.com> Signed-off-by: Anshuman Khandual <khandual@linux.vnet.ibm.com> [stewart@linux.vnet.ibm.com: Move create_led_device_nodes to FSP platform.exit] Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* doc/device-tree: Add descriptions for the ibm, pstate-* properties.Jeremy Kerr2015-03-171-14/+26
| | | | | Signed-off-by: Jeremy Kerr <jk@ozlabs.org> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* core/flash: Add flash APIJeremy Kerr2015-02-191-0/+35
| | | | | | | | | | | | | | | | | | | We'd like to enable access to the system PNOR, on platforms where its present. This change introduces an API for global flash operations: opal_flash_read opal_flash_erase opal_flash_write - plus device-tree bindings to expose the flash details. Since there are other components of the system that use the PNOR (NVRAM and pnor_load_resource), upcoming changes will port this these over to use the new interface. Signed-off-by: Jeremy Kerr <jk@ozlabs.org> Reviewed-by: Joel Stanley <joel@jms.id.au> Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* Document the device-tree entries for the operator panelStewart Smith2015-01-281-0/+21
| | | | Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
* Add skeleton documentation on power-mgt section of device-treeStewart Smith2015-01-281-0/+51
Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
OpenPOWER on IntegriCloud