Provide a common CBFS wrapper for SPI storage

Coreboot has all necessary infrastructure to use the proper SPI flash
interface in bootblock for CBFS. This patch creates a common CBFS
wrapper which can be enabled on different platforms as required.

COMMON_CBFS_SPI_WRAPPER, a new configuration option, enables the
common CBFS interface and prevents default inclusion of all SPI chip
drivers, only explicitly configured ones will be included when the new
feature is enabled. Since the wrapper uses the same driver at all
stages, enabling the new feature will also make it necessary to
include the SPI chip drivers in bootblock and romstage images.

init_default_cbfs_media() can now be common for different platforms,
and as such is defined in the library.

BUG=none
TEST=manual
   . with this change and the rest of the patches coreboot on AP148
     comes up all the way to attempting to boot the payload (reading
     earlier stages from the SPI flash along the way).

Change-Id: Ia887bb7f386a0e23a110e38001d86f9d43fadf2c
Signed-off-by: Vadim Bendebury <vbendeb@chromium.org>
Reviewed-on: https://chromium-review.googlesource.com/197800
Tested-by: Vadim Bendebury <vbendeb@google.com>
Reviewed-by: Aaron Durbin <adurbin@chromium.org>
Reviewed-by: David Hendricks <dhendrix@chromium.org>

src/Kconfig

@@ -56,6 +56,14 @@ config ALT_CBFS_LOAD_PAYLOAD
 	 through memory-mapped I/O is slow and a faster alternative can be
 	 provided.
 
+config COMMON_CBFS_SPI_WRAPPER
+       bool
+       default n
+       depends on SPI_FLASH
+       depends on !ARCH_X86
+       help
+         Use common wrapper to interface CBFS to SPI bootprom.
+
 choice
 	prompt "Compiler to use"
 	default COMPILER_GCC

src/drivers/spi/Kconfig

@@ -50,7 +50,7 @@ config SPI_FLASH_SMM
 
 config SPI_FLASH_EON
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain
@@ -58,7 +58,7 @@ config SPI_FLASH_EON
 
 config SPI_FLASH_MACRONIX
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain
@@ -66,7 +66,7 @@ config SPI_FLASH_MACRONIX
 
 config SPI_FLASH_SPANSION
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain
@@ -74,7 +74,7 @@ config SPI_FLASH_SPANSION
 
 config SPI_FLASH_SST
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain
@@ -82,7 +82,7 @@ config SPI_FLASH_SST
 
 config SPI_FLASH_STMICRO
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain
@@ -90,7 +90,7 @@ config SPI_FLASH_STMICRO
 
 config SPI_FLASH_WINBOND
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain
@@ -106,7 +106,7 @@ config SPI_FLASH_NO_FAST_READ
 
 config SPI_FLASH_GIGADEVICE
 	bool
-	default y
+	default y if !COMMON_CBFS_SPI_WRAPPER
 	depends on SPI_FLASH
 	help
 	  Select this option if your chipset driver needs to store certain

src/drivers/spi/Makefile.inc

@@ -1,4 +1,28 @@
 # SPI flash driver interface
+
+ifeq ($(CONFIG_COMMON_CBFS_SPI_WRAPPER),y)
+bootblock-y += spi_flash.c
+bootblock-$(CONFIG_SPI_FLASH_EON) += eon.c
+bootblock-$(CONFIG_SPI_FLASH_GIGADEVICE) += gigadevice.c
+bootblock-$(CONFIG_SPI_FLASH_MACRONIX) += macronix.c
+bootblock-$(CONFIG_SPI_FLASH_SPANSION) += spansion.c
+bootblock-$(CONFIG_SPI_FLASH_SST) += sst.c
+bootblock-$(CONFIG_SPI_FLASH_STMICRO) += stmicro.c
+bootblock-$(CONFIG_SPI_FLASH_WINBOND) += winbond.c
+bootblock-$(CONFIG_SPI_FRAM_RAMTRON) += ramtron.c
+
+romstage-$(CONFIG_SPI_FLASH) += spi_flash.c
+romstage-$(CONFIG_SPI_FLASH_EON) += eon.c
+romstage-$(CONFIG_SPI_FLASH_GIGADEVICE) += gigadevice.c
+romstage-$(CONFIG_SPI_FLASH_MACRONIX) += macronix.c
+romstage-$(CONFIG_SPI_FLASH_SPANSION) += spansion.c
+romstage-$(CONFIG_SPI_FLASH_SST) += sst.c
+romstage-$(CONFIG_SPI_FLASH_STMICRO) += stmicro.c
+romstage-$(CONFIG_SPI_FLASH_WINBOND) += winbond.c
+romstage-$(CONFIG_SPI_FRAM_RAMTRON) += ramtron.c
+
+endif
+
 ramstage-$(CONFIG_SPI_FLASH) += spi_flash.c
 
 # drivers

src/lib/Makefile.inc

@@ -18,6 +18,7 @@
 #
 
 bootblock-y += cbfs.c
+bootblock-$(CONFIG_COMMON_CBFS_SPI_WRAPPER) += cbfs_spi.c
 ifneq ($(CONFIG_HAVE_ARCH_MEMSET),y)
 bootblock-y += memset.c
 endif
@@ -50,6 +51,7 @@ romstage-y += memcmp.c
 rmodules-y += memcmp.c
 romstage-y += delay.c
 romstage-y += cbfs.c
+romstage-$(CONFIG_COMMON_CBFS_SPI_WRAPPER) += cbfs_spi.c
 romstage-y += lzma.c
 #romstage-y += lzmadecode.c
 romstage-$(CONFIG_CACHE_AS_RAM) += ramtest.c
@@ -87,6 +89,7 @@ ramstage-y += fallback_boot.c
 ramstage-y += compute_ip_checksum.c
 ramstage-y += version.c
 ramstage-y += cbfs.c
+ramstage-$(CONFIG_COMMON_CBFS_SPI_WRAPPER) += cbfs_spi.c
 ramstage-y += lzma.c
 #ramstage-y += lzmadecode.c
 ramstage-y += stack.c

src/lib/cbfs_spi.c

@@ -0,0 +1,96 @@
+/*
+ * This file is part of the coreboot project.
+ *
+ * Copyright 2014 Google Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; version 2 of the License.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+
+/*
+ * This file provides a common CBFS wrapper for SPI storage. SPI driver
+ * context is expanded with the buffer descriptor used to store data read from
+ * SPI.
+ */
+
+#include <cbfs.h>
+#include <spi_flash.h>
+
+/* SPI flash as CBFS media. */
+struct cbfs_spi_context {
+	struct spi_flash *spi_flash_info;
+	struct cbfs_simple_buffer buffer;
+};
+
+static struct cbfs_spi_context spi_context;
+
+static int cbfs_media_open(struct cbfs_media *media)
+{
+	return 0;
+}
+
+static int cbfs_media_close(struct cbfs_media *media)
+{
+	return 0;
+}
+
+static size_t cbfs_media_read(struct cbfs_media *media,
+			      void *dest, size_t offset,
+			      size_t count)
+{
+	struct cbfs_spi_context *context = media->context;
+
+	return context->spi_flash_info->read
+		(context->spi_flash_info, offset, count, dest) ? 0 : count;
+}
+
+static void *cbfs_media_map(struct cbfs_media *media,
+			    size_t offset, size_t count)
+{
+	struct cbfs_spi_context *context = media->context;
+
+	return cbfs_simple_buffer_map(&context->buffer, media, offset, count);
+}
+
+static void *cbfs_media_unmap(struct cbfs_media *media,
+			       const void *address)
+{
+	struct cbfs_spi_context *context = media->context;
+
+	return cbfs_simple_buffer_unmap(&context->buffer, address);
+}
+
+int init_default_cbfs_media(struct cbfs_media *media)
+{
+	if (spi_context.buffer.buffer)
+		return 0; /* It has been already initialized. */
+
+	spi_context.spi_flash_info = spi_flash_probe
+		(CONFIG_BOOT_MEDIA_SPI_BUS, 0);
+	if (!spi_context.spi_flash_info)
+		return -1;
+
+	spi_context.buffer.buffer = (void *)CONFIG_CBFS_CACHE_ADDRESS;
+	spi_context.buffer.size = CONFIG_CBFS_CACHE_SIZE;
+
+	media->context = &spi_context;
+
+	media->open = cbfs_media_open;
+	media->close = cbfs_media_close;
+	media->read = cbfs_media_read;
+	media->map = cbfs_media_map;
+	media->unmap = cbfs_media_unmap;
+
+	return 0;
+}
+