blob: e90634190628af9f817a6c0ad3c06462c8ed7ec3 [file] [log] [blame]
#!/usr/bin/python
# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
#
# Python library for in-band SCom access
# (based on xscom-utils from OPAL firmware)
#
# Copyright 2018 IBM Corp.
import os, sys, struct, getopt
class XSCom(object):
def __init__(self):
self.name = "xscom"
self.base = "/sys/kernel/debug/powerpc/scom/"
self.enabled = False
self.setup = False
self.chips = []
self.dirs = []
self.key_val_bin = {}
self.file = "/access"
if os.path.exists(self.base):
self.enabled = True
if not self.scan_chips():
raise ValueError
def scan_chips(self):
if not self.enabled:
print("Not supported")
return False
for i in os.listdir(self.base):
if os.path.isdir(self.base+i):
self.dirs.append(i)
self.chips.append(int(i,16))
for i in self.dirs:
try:
b = open(self.base+i+self.file, "rb+")
self.key_val_bin[int(i,16)] = b
except:
print("Count not open"+self.base+i+self.file)
return False
self.setup = True
return True
def is_supported(self):
return self.enabled
def get_chip_ids(self):
return list(self.key_val_bin.keys())
def mangle_addr(self, addr):
tmp = (addr & 0xf000000000000000) >> 4
addr = (addr & 0x00ffffffffffffff)
addr = addr | tmp
return (addr << 3)
def xscom_read(self, chip_id, addr):
if not isinstance(chip_id, int) or not isinstance(addr, int):
print("xscom_read: Input paramater type mismatch")
return -1
if chip_id not in self.key_val_bin:
print("Invalid Chip id")
return -1
saddr = self.mangle_addr(addr)
fd = self.key_val_bin.get(chip_id)
fd.seek(saddr, 0)
return struct.unpack('Q',fd.read(8))[0]
def xscom_read_spl(self, chip_id, addr):
if not isinstance(chip_id, int) or not isinstance(addr, int):
print("xscom_read: Input paramater type mismatch")
return -1
if chip_id not in self.key_val_bin:
print("Invalid Chip id")
return -1
saddr = self.mangle_addr(addr)
fd = self.key_val_bin.get(chip_id)
fd.seek(saddr, 0)
val = struct.unpack('Q',fd.read(8))[0]
fd.close()
try:
b = open(self.key_val_path.get(chip_id), "rb+")
except:
print("Reopen failed")
return val
self.key_val_bin[chip_id] = b
return val
def xscom_write(self, chip_id, addr, val):
if chip_id not in self.key_val_bin:
print("Invalid Chip id")
return -1
c = struct.pack('Q',val)
saddr = self.mangle_addr(addr)
fd = self.key_val_bin.get(chip_id)
try:
fd.seek(saddr, 0)
fd.write(c)
# write again just to be sure
fd.seek(saddr, 0)
fd.write(c)
except:
print("Write() error")
return -1
def xscom_read_ex(self, ex_target_id, addr):
if not isinstance(ex_target_id, int) or not isinstance(addr, int):
print("xscom_read_ex: Input paramater type mismatch")
return -1
chip_id = ex_target_id >> 4
addr |= (ex_target_id & 0xf) << 24;
return self.xscom_read(chip_id, addr, val);
def xscom_write_ex(self, ex_target_id, addr, val):
chip_id = ex_target_id >> 4
addr |= (ex_target_id & 0xf) << 24;
return self.xscom_write(chip_id, addr, val)
class GetSCom(object):
def __init__(self):
self.name = "getscom"
self.backend = XSCom()
self.listchip = False
self.chip_id = 0
self.chips = False
self.addr = 0
self.flg_addr = False
if not self.backend.is_supported():
print("In-Band SCom not supported Exiting....")
raise ValueError
def set_chip(self, chip_id):
self.chip_id = chip_id
self.chips = True
def set_addr(self, scom_addr):
self.addr = scom_addr
self.flg_addr = True
def print_usage(self):
print("usage: getscom [-c|--chip chip-id] addr")
print(" getscom -l|--list-chips")
print(" getscom -h|--help")
sys.exit(0)
def chip_info(self, chip_id):
val = self.backend.xscom_read(chip_id, 0xf000f)
if val < 0:
print("Error in scom read")
raise ValueError
c_id = val >> 44
id = c_id & 0xff
if id == 0xef:
name = "P8E (Murano) processor"
elif id == 0xea:
name = "P8 (Venice) processor"
elif id == 0xd3:
name = "P8NVL (Naples) processor"
elif id == 0xd1:
name = "P9 (Nimbus) processor"
elif id == 0xd4:
name = "P9 (Cumulus) processor"
elif id == 0xd9:
name = "P9P (Axone) processor"
elif id == 0xda:
name = "P10 processor"
elif id == 0xe9:
name = "Centaur memory buffer"
else:
name = "Unknown ID 0x%x"%id
print(("%08x | DD%s.%s | %s"%(chip_id, ((c_id >> 16) & 0xf), ((c_id >> 8) & 0xf), name)))
def parse_args(self):
try:
optlist, sys.argv = getopt.getopt(sys.argv[1:], "lhc:", ["chip", "list-chips", "help"])
except getopt.GetoptError as err:
print(str(err))
self.print_usage()
sys.exit(0)
if len(optlist) == 0:
self.print_usage()
sys.exit(0)
for opt, arg in optlist:
if opt in [ "-h", "--help"]:
self.print_usage()
sys.exit(0)
elif opt in [ "-l", "--list-chips"]:
self.listchip = True
elif opt in ["-c", "--chip"]:
self.chip_id = int(arg, 16)
self.chips = True
if sys.argv:
self.addr = int(sys.argv.pop(), 16)
self.flg_addr = True
if self.listchip:
print("Chip ID | Rev | Chip type")
print("---------|-------|-----------")
for i in self.backend.get_chip_ids():
self.chip_info(i)
sys.exit(0)
def run_command(self):
if self.chips and self.flg_addr:
print(hex(self.backend.xscom_read(self.chip_id, self.addr)))
def list_chips(self):
print("Chip ID | Rev | Chip type")
print("---------|-------|-----------")
for i in self.backend.get_chip_ids():
self.chip_info(i)
raise ValueError
def execute(self, chip_id, addr):
return self.backend.xscom_read(chip_id, addr)
def execute_spl(self, chip_id, addr):
return self.backend.xscom_read_spl(chip_id, addr)
class PutSCom(object):
def __init__(self):
self.name = "putscom"
self.backend = XSCom()
self.chip_id = 0
self.chips = False
self.addr = 0
self.value = 0
if not self.backend.is_supported():
print("In-Band SCom not supported Exiting....")
raise ValueError
def set_addr(self, addr):
self.addr = addr
def set_value(self, value):
self.value = value
def print_usage(self):
print("usage: putscom [-c|--chip chip-id] addr value")
print(" putscom -h|--help")
sys.exit(0)
def parse_args(self):
try:
optlist, sys.argv = getopt.getopt(sys.argv[1:], "hc:", ["chip", "help"])
except getopt.GetoptError as err:
print(str(err))
self.print_usage()
sys.exit(0)
if len(optlist) == 0:
self.print_usage()
sys.exit(0)
for opt, arg in optlist:
if opt in [ "-h", "--help"]:
self.print_usage()
sys.exit(0)
elif opt in ["-c", "--chip"]:
self.chip_id = int(arg, 16)
self.chips = True
if sys.argv:
self.value = int(sys.argv.pop(), 16)
self.addr = int(sys.argv.pop(), 16)
if self.chips:
self.backend.xscom_write(self.chip_id, self.addr, self.value)
def run_command(self):
if self.chips:
self.backend.xscom_write(self.chip_id, self.addr, self.value)
def execute(self, chip_id, addr, value):
self.backend.xscom_write(chip_id, addr, value)