quanta-q71l package for controlling the SPI master.
Testing: Used this version to change the register during a BIOS
flashing, and it worked as expected.
Change-Id: I13e59f6917d535647679cc84ff5c62ed1602ad4d
Signed-off-by: Patrick Venture <venture@google.com>
diff --git a/meta-openbmc-machines/meta-x86/meta-quanta/meta-q71l/recipes-phosphor/spictrl/files/spimaster.py b/meta-openbmc-machines/meta-x86/meta-quanta/meta-q71l/recipes-phosphor/spictrl/files/spimaster.py
new file mode 100644
index 0000000..dd08372
--- /dev/null
+++ b/meta-openbmc-machines/meta-x86/meta-quanta/meta-q71l/recipes-phosphor/spictrl/files/spimaster.py
@@ -0,0 +1,148 @@
+# Copyright (C) 2017 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#!/usr/bin/env python
+"""Basic utility for reading and writing registers on an ASPEED BMC.
+
+The values hardcoded are for the ASPEED AST2400.
+"""
+
+import subprocess
+import sys
+
+IO_TOOL = 'devmem'
+PROTECTION_KEY = '0x1E6E2000'
+HWTRAP = '0x1E6E2070'
+# The AST2400 SCU Password (as int for write_register)
+SCU_PASSWORD = 0x1688A8A8
+
+# Bits 13:12
+SPI_MASK = 0xffffcfff
+# Enable SPI Master
+SPI_MASTER = 0x1000
+# Enable SPI Master and SPI Slave to AHB Bridge
+SPI_MASTER_SLAVE = 0x2000
+# Enable SPI Pass-through
+SPI_BYPASS = 0x3000
+
+
+def read_register(address):
+ """Run a tool to read a register value.
+
+ This will convert it to an integer.
+ """
+
+ output = subprocess.check_output([IO_TOOL, address]).replace('\n', '')
+ value = int(output, 16)
+ return value
+
+
+def write_register(address, value):
+ """Run a tool to write the 32-bit register value."""
+
+ subprocess.check_output([IO_TOOL, address, '32', '0x%x' % value])
+ return
+
+
+def set_master(value):
+ """Set Hardware Strapping to SPI Master."""
+
+ print 'Setting to "SPI Master"'
+
+ masked = value & SPI_MASK
+ masked |= SPI_MASTER
+
+ print 'setting: 0x%x' % masked
+ write_register(HWTRAP, masked)
+
+
+def set_ahb_bridge(value):
+ """Set hardware strapping to spi master and spi-slave to ahb."""
+
+ print 'Setting to "SPI Master and SPI Slave to AHB Bridge"'
+ masked = value & SPI_MASK
+ masked |= SPI_MASTER_SLAVE
+
+ print 'setting: 0x%x' % masked
+ write_register(HWTRAP, masked)
+
+
+def set_bypass(value):
+ """Set hardware strappign to spi bypass."""
+
+ print 'Setting to "Enable SPI Pass-through"'
+ masked = value & SPI_MASK
+ masked |= SPI_BYPASS
+
+ print 'setting: 0x%x' % masked
+ write_register(HWTRAP, masked)
+
+
+def usage():
+ """Print usage string."""
+
+ print 'usage: %s master|bridge|bypass' % sys.argv[0]
+ print 'master sets the BMC SPI to Master.'
+ print ('bridge sets the BMC SPI to Master-Slave bridge to AHB (for BIOS ' +
+ 'Update).')
+ print 'bypass sets the BMC SPI to Bypass (default).'
+
+
+def main():
+ """Main entry point for execution."""
+
+ if len(sys.argv) != 2:
+ usage()
+ sys.exit(-1)
+
+ ctrl = sys.argv[1].lower()
+ if ctrl not in ('master', 'bridge', 'bypass'):
+ usage()
+ sys.exit(-1)
+
+ locked = False
+ # Check if locked
+ value = read_register(PROTECTION_KEY)
+ if value == 1:
+ print 'Presently unlocked'
+ else:
+ print 'Presently locked'
+ locked = True
+
+ # if Locked we need to unlock it.
+ if locked:
+ write_register(PROTECTION_KEY, SCU_PASSWORD)
+
+ # Read the value.
+ value = read_register(HWTRAP)
+ if value & SPI_BYPASS == SPI_BYPASS:
+ print 'Presently set to bypass'
+ elif value & SPI_MASTER == SPI_MASTER:
+ print 'Presently set to master'
+ elif value & SPI_MASTER_SLAVE == SPI_MASTER_SLAVE:
+ print 'Presently set to master-slave'
+
+ if ctrl == 'master':
+ set_master(value)
+ elif ctrl == 'bridge':
+ set_ahb_bridge(value)
+ elif ctrl == 'bypass':
+ set_bypass(value)
+
+ # We leave it unlocked in case it was locked.
+ # we could lock it.
+ # TODO(venture): lock it by writing any non-password value.
+
+if __name__ == '__main__':
+ main()
diff --git a/meta-openbmc-machines/meta-x86/meta-quanta/meta-q71l/recipes-phosphor/spictrl/spictrl.bb b/meta-openbmc-machines/meta-x86/meta-quanta/meta-q71l/recipes-phosphor/spictrl/spictrl.bb
new file mode 100644
index 0000000..5b2fcf2
--- /dev/null
+++ b/meta-openbmc-machines/meta-x86/meta-quanta/meta-q71l/recipes-phosphor/spictrl/spictrl.bb
@@ -0,0 +1,19 @@
+# Should RDEPENDS on python at the very least.
+FILESEXTRAPATHS_append := "${THISDIR}/files:"
+
+LICENSE = "Apache-2.0"
+LIC_FILES_CHKSUM = "file://spimaster.py;beginline=1;endline=13;md5=b86c59990b35609be34a0ec322a3cfff"
+
+S = "${WORKDIR}/"
+
+SRC_URI = "file://spimaster.py"
+
+DEPENDS = "python"
+
+FILES_${PN} += "*"
+
+do_install() {
+ install -d ${D}/home
+ install -d ${D}/home/root
+ install -m 0755 ${S}/spimaster.py ${D}/home/root/.
+}