From patchwork Thu Mar 9 05:08:09 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: maddy X-Patchwork-Id: 736831 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3vdz3Q6Jmqz9sNg for ; Thu, 9 Mar 2017 16:09:54 +1100 (AEDT) Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 3vdz3Q5Zh6zDqcM for ; Thu, 9 Mar 2017 16:09:54 +1100 (AEDT) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org 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 3vdz2W5Mc8zDqZ3 for ; Thu, 9 Mar 2017 16:09:07 +1100 (AEDT) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.20/8.16.0.20) with SMTP id v2950lFY071702 for ; Thu, 9 Mar 2017 00:09:05 -0500 Received: from e28smtp02.in.ibm.com (e28smtp02.in.ibm.com [125.16.236.2]) by mx0b-001b2d01.pphosted.com with ESMTP id 292mrk6jkr-1 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=NOT) for ; Thu, 09 Mar 2017 00:09:05 -0500 Received: from localhost by e28smtp02.in.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Thu, 9 Mar 2017 10:38:32 +0530 Received: from d28relay04.in.ibm.com (9.184.220.61) by e28smtp02.in.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; Thu, 9 Mar 2017 10:38:30 +0530 Received: from d28av07.in.ibm.com (d28av07.in.ibm.com [9.184.220.146]) by d28relay04.in.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id v2958TNs14417936 for ; Thu, 9 Mar 2017 10:38:29 +0530 Received: from d28av07.in.ibm.com (localhost [127.0.0.1]) by d28av07.in.ibm.com (8.14.4/8.14.4/NCO v10.0 AVout) with ESMTP id v2958RP6021688 for ; Thu, 9 Mar 2017 10:38:29 +0530 Received: from SrihariSrinidhi.in.ibm.com (sriharisrinidhi.in.ibm.com [9.121.0.27]) by d28av07.in.ibm.com (8.14.4/8.14.4/NCO v10.0 AVin) with ESMTP id v2958Eu2021476; Thu, 9 Mar 2017 10:38:27 +0530 From: Madhavan Srinivasan To: stewart@linux.vnet.ibm.com Date: Thu, 9 Mar 2017 10:38:09 +0530 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1489036089-6529-1-git-send-email-maddy@linux.vnet.ibm.com> References: <1489036089-6529-1-git-send-email-maddy@linux.vnet.ibm.com> X-TM-AS-MML: disable x-cbid: 17030905-0004-0000-0000-0000054C8CFD X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17030905-0005-0000-0000-000013491C8B Message-Id: <1489036089-6529-11-git-send-email-maddy@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2017-03-09_04:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=1 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1702020001 definitions=main-1703090039 Subject: [Skiboot] [PATCH v7 10/10] skiboot: Add documentation for the Core IMC opal call X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: mikey@neuling.org, skiboot@lists.ozlabs.org MIME-Version: 1.0 Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" From: Hemant Kumar Adds documentation for the opal_core_imc_counters_control() interface. Signed-off-by: Hemant Kumar Signed-off-by: Madhavan Srinivasan --- doc/opal-api/opal-core-imc-counters.rst | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 doc/opal-api/opal-core-imc-counters.rst diff --git a/doc/opal-api/opal-core-imc-counters.rst b/doc/opal-api/opal-core-imc-counters.rst new file mode 100644 index 000000000000..f7390a20f603 --- /dev/null +++ b/doc/opal-api/opal-core-imc-counters.rst @@ -0,0 +1,33 @@ +The interface can be extended to include more modes and operations +available in core IMC. + +Parameters +---------- +``uint64_t operation`` + 3 operations are supported for now (include/opal-api.h) : + - OPAL_CORE_IMC_DISABLE -- disable or stop the counters + - OPAL_CORE_IMC_ENABLE -- enable/resume the counters + - OPAL_CORE_IMC_INIT -- Initialize and enable the counters. + +``uint64_t addr`` + For OPAL_CORE_IMC_INIT, this parameter must have a non-zero value. + This value must be a per-core physical address. + For other operations, this value is undefined and must be zero. + +``uint64_t value_1`` + - This parameter is undefined for now and must be zero. + +``uint64_t value_2`` + - This parameter is undefined for now and must be zero. + +Returns +------- +OPAL_PARAMETER + In any one/some/all of the following cases : + - Unsupported ``operation`` + - Wrong ``addr`` for the given ``operation`` + - Non-zero ``value_1`` or ``value_2`` +OPAL_HARDWARE + If xscom_write fails. +OPAL_SUCCESS + On successful execution of the ``operation``.