Add documentation to scom_addr_p9.sh, probe_cpus.sh
Change-Id: Id49ebf7c63beff6ff7d9939fa5c0d2e41d28098c
Signed-off-by: Sridevi Ramesh <sridevra@in.ibm.com>
diff --git a/lib/ras/host_utils.robot b/lib/ras/host_utils.robot
index 988b655..22bf7c6 100644
--- a/lib/ras/host_utils.robot
+++ b/lib/ras/host_utils.robot
@@ -165,3 +165,17 @@
OS Execute Command service opal-prd start
${opal_prd_state}= Is Opal-PRD Service Enabled
Should Contain ${opal_prd_state} enabled
+
+BMC Putscom
+ [Documentation] Executes putscom command through BMC.
+
+ [Arguments] ${proc_chip_id} ${fru} ${chip_address}
+
+ # Description of argument(s):
+ # proc_chip_id Processor ID (e.g '0', '8').
+ # fru FRU (field replaceable unit) (e.g. '2011400').
+ # chip_address Chip address (e.g. '4000000000000000').
+
+ ${cmd}= Catenate pdbg -d p9w -${proc_chip_id} putscom 0x${fru} 0x${address}
+
+ BMC Execute Command ${cmd}
diff --git a/tools/ras/probe_cpus.sh b/tools/ras/probe_cpus.sh
index 33710ea..a1fa03c 100755
--- a/tools/ras/probe_cpus.sh
+++ b/tools/ras/probe_cpus.sh
@@ -1,4 +1,5 @@
#!/bin/bash
+# Refer to help text in the usage function for details.
CPU_SYS_DIR=/sys/devices/system/cpu/
NR_CPUS=0
@@ -8,6 +9,8 @@
function usage()
{
+ echo "This script runs on HOST OS and gives core-id"
+ echo "corresponding to the chip-id."
echo "usage:"
echo " $0 [cpu] [-L]"
echo
diff --git a/tools/ras/scom_addr_p9.sh b/tools/ras/scom_addr_p9.sh
index e0b8098..a7c5ff0 100755
--- a/tools/ras/scom_addr_p9.sh
+++ b/tools/ras/scom_addr_p9.sh
@@ -1,15 +1,17 @@
#!/bin/bash
+# Refer to help text in the usage function for details.
function usage()
{
echo
- echo "usage: $0: <scom_addr> <core-id>"
+ echo "This script runs on HOST OS and gives translated SCOM address."
+ echo "usage: $0: <scom_addr> <core_id>"
echo
echo " <scom_addr>:"
- echo " SCOM address that needs transaltion."
- echo " <core-id>:"
+ echo " SCOM address that needs translation (e.g. '10010800')."
+ echo " <core_id>:"
echo " Core id as obtained from probe_cpu.sh."
- echo " Should be between 0-23."
+ echo " Should be between 0-23 (e.g. '0')."
exit 1
}