From patchwork Tue Apr 3 04:57:56 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 894433 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [103.22.144.68]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 40FcL50F8mz9s0y for ; Tue, 3 Apr 2018 14:58:21 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 40FcL46BRzzF25k for ; Tue, 3 Apr 2018 14:58:20 +1000 (AEST) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=prvs=0631e934e4=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 40FcKv4V9xzF25R for ; Tue, 3 Apr 2018 14:58:08 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w334s23R011931 for ; Tue, 3 Apr 2018 00:58:05 -0400 Received: from e18.ny.us.ibm.com (e18.ny.us.ibm.com [129.33.205.208]) by mx0b-001b2d01.pphosted.com with ESMTP id 2h42ft1149-1 (version=TLSv1.2 cipher=AES256-SHA256 bits=256 verify=NOT) for ; Tue, 03 Apr 2018 00:58:04 -0400 Received: from localhost by e18.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Tue, 3 Apr 2018 00:58:03 -0400 Received: from b01cxnp23034.gho.pok.ibm.com (9.57.198.29) by e18.ny.us.ibm.com (146.89.104.205) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; Tue, 3 Apr 2018 00:58:02 -0400 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w334w1XQ50200618 for ; Tue, 3 Apr 2018 04:58:01 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E26D9124035 for ; Tue, 3 Apr 2018 02:00:07 -0400 (EDT) Received: from birb.localdomain (unknown [9.81.197.236]) by b01ledav002.gho.pok.ibm.com (Postfix) with SMTP id 63B16124037 for ; Tue, 3 Apr 2018 02:00:07 -0400 (EDT) Received: by birb.localdomain (Postfix, from userid 1000) id 1FC044EC648; Tue, 3 Apr 2018 14:57:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Tue, 3 Apr 2018 14:57:56 +1000 X-Mailer: git-send-email 2.14.3 X-TM-AS-GCONF: 00 x-cbid: 18040304-0044-0000-0000-000003FCC2ED X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00008793; HX=3.00000241; KW=3.00000007; PH=3.00000004; SC=3.00000255; SDB=6.01012348; UDB=6.00515938; IPR=6.00791614; MB=3.00020383; MTD=3.00000008; XFM=3.00000015; UTC=2018-04-03 04:58:02 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18040304-0045-0000-0000-0000082CD537 Message-Id: <20180403045756.31804-1-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2018-04-03_01:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 impostorscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1709140000 definitions=main-1804030051 Subject: [Skiboot] [PATCH] doc: Document ibm,heartbeat-ms X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" and by 'document', I mean 'gather a few extra minor bits of breadcrumbs of clues as to what, when and why this thing exists'. Signed-off-by: Stewart Smith --- doc/device-tree/ibm,opal.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/device-tree/ibm,opal.rst b/doc/device-tree/ibm,opal.rst index 932f41d05cde..2fa446ddef04 100644 --- a/doc/device-tree/ibm,opal.rst +++ b/doc/device-tree/ibm,opal.rst @@ -50,3 +50,24 @@ Top level ibm,opal node opal-runtime-size = <0x0 0x9a00000>; phandle = <0x10000003>; }; + +.. ibm-heartbeat-ms: + +ibm,heartbeat-ms +^^^^^^^^^^^^^^^^ + +.. code-block:: dts + + ibm,opal { + ibm,heartbeat-ms = <0x7d0>; + } + + +Any OS targetting POWER9 processors *must* respect `ibm,heartbeat-ms`. + +Linux kernels prior to v4.1-rc1 would ignore `ibm,heartbeat-ms`. These only +supported POWER8 systems. + +On the earliest POWER8 OPAL systems, there was `ibm,heartbeat-freq` instead. +However, no OS at the time ever looked at that value, so it can be ignored +by any new operating systems.