From 9b41d9ac5e50e7726010120fe9c265a8df1d7eea Mon Sep 17 00:00:00 2001
From: Mike Nix <mnix@wanm.com.au>
Date: Fri, 24 Apr 2020 00:15:21 +0800
Subject: [PATCH] XMC flash support - WIP (#6725)

* Move the spi vendor list from Esp.h to its own header in eboot.

* Fix ifdef issue with spi_vendors.h

* Add initFlashQuirks() for any chip specific flash initialization.

Called from user_init().

* namespace experimental for initFlashQuirks()

* Slow down flash access during eboot firmware copy

Part 1 - still some work to do

* Slow down flash access during eboot firmware copy on XMC chips

Part 2 - Identify the chip type.

Note: there may still be issues with the access speed change.
This is very much experimental.

* Commit eboot.elf

Co-authored-by: Develo <deveyes@gmail.com>
Co-authored-by: Earle F. Philhower, III <earlephilhower@yahoo.com>
---
 bootloaders/eboot/eboot.c                   |  62 ++++++++++++++
 bootloaders/eboot/eboot.elf                 | Bin 34956 -> 36640 bytes
 bootloaders/eboot/spi_vendors.h             |  63 +++++++++++++++
 cores/esp8266/Esp.cpp                       |   6 ++
 cores/esp8266/Esp.h                         |  38 +--------
 cores/esp8266/core_esp8266_flash_quirks.cpp |  85 ++++++++++++++++++++
 cores/esp8266/core_esp8266_main.cpp         |   3 +
 cores/esp8266/flash_quirks.h                |  42 ++++++++++
 cores/esp8266/spi_flash_defs.h              |  44 ++++++++++
 cores/esp8266/spi_vendors.h                 |  40 +++++++++
 10 files changed, 346 insertions(+), 37 deletions(-)
 create mode 100644 bootloaders/eboot/spi_vendors.h
 create mode 100644 cores/esp8266/core_esp8266_flash_quirks.cpp
 create mode 100644 cores/esp8266/flash_quirks.h
 create mode 100644 cores/esp8266/spi_flash_defs.h
 create mode 100644 cores/esp8266/spi_vendors.h

diff --git a/bootloaders/eboot/eboot.c b/bootloaders/eboot/eboot.c
index c7cf285c0..39b14307a 100644
--- a/bootloaders/eboot/eboot.c
+++ b/bootloaders/eboot/eboot.c
@@ -12,6 +12,7 @@
 #include <string.h>
 #include "flash.h"
 #include "eboot_command.h"
+#include "spi_vendors.h"
 #include <uzlib.h>
 
 extern unsigned char _gzip_dict;
@@ -189,6 +190,28 @@ int copy_raw(const uint32_t src_addr,
     return 0;
 }
 
+#define XMC_SUPPORT
+#ifdef XMC_SUPPORT
+// Define a few SPI0 registers we need access to
+#define ESP8266_REG(addr) *((volatile uint32_t *)(0x60000000+(addr)))
+#define SPI0CMD ESP8266_REG(0x200)
+#define SPI0CLK ESP8266_REG(0x218)
+#define SPI0C   ESP8266_REG(0x208)
+#define SPI0W0  ESP8266_REG(0x240)
+
+#define SPICMDRDID (1 << 28)
+
+/* spi_flash_get_id()
+   Returns the flash chip ID - same as the SDK function.
+   We need our own version as the SDK isn't available here.
+ */
+uint32_t __attribute__((noinline)) spi_flash_get_id() {
+  SPI0W0=0;
+  SPI0CMD=SPICMDRDID;
+  while (SPI0CMD) {}
+  return SPI0W0;
+}
+#endif // XMC_SUPPORT
 
 int main()
 {
@@ -211,9 +234,48 @@ int main()
 
     if (cmd.action == ACTION_COPY_RAW) {
         ets_putc('c'); ets_putc('p'); ets_putc(':');
+
+#ifdef XMC_SUPPORT
+        // save the flash access speed registers
+        uint32_t spi0clk = SPI0CLK;
+        uint32_t spi0c   = SPI0C;
+        
+        uint32_t vendor  = spi_flash_get_id() & 0x000000ff;
+        if (vendor == SPI_FLASH_VENDOR_XMC) {
+           uint32_t flashinfo=0;
+           if (SPIRead(0, &flashinfo, 4)) {
+              // failed to read the configured flash speed.
+              // Do not change anything,
+           } else {
+              // select an appropriate flash speed
+              // Register values are those used by ROM
+              switch ((flashinfo >> 24) & 0x0f) {
+                 case 0x0: // 40MHz, slow to 20
+                 case 0x1: // 26MHz, slow to 20
+                      SPI0CLK = 0x00003043;
+                      SPI0C   = 0x00EAA313;
+                      break;
+                 case 0x2: // 20MHz, no change
+                      break;
+                 case 0xf: // 80MHz, slow to 26
+                      SPI0CLK = 0x00002002;
+                      SPI0C   = 0x00EAA202;
+                      break;
+                 default:
+                      break;
+              }
+           }
+        }
+#endif // XMC_SUPPORT
         ets_wdt_disable();
         res = copy_raw(cmd.args[0], cmd.args[1], cmd.args[2]);
         ets_wdt_enable();
+        
+#ifdef XMC_SUPPORT
+        // restore the saved flash access speed registers
+        SPI0CLK = spi0clk;
+        SPI0C   = spi0c;
+#endif        
         ets_putc('0'+res); ets_putc('\n');
         if (res == 0) {
             cmd.action = ACTION_LOAD_APP;
diff --git a/bootloaders/eboot/eboot.elf b/bootloaders/eboot/eboot.elf
index 0d862f6a9f6bf2b014610c46d4ba14d4eb088fc0..bbd4452c0e5b418cb3a065daba765d68d3e541f2 100755
GIT binary patch
literal 36640
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

literal 34956
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

diff --git a/bootloaders/eboot/spi_vendors.h b/bootloaders/eboot/spi_vendors.h
new file mode 100644
index 000000000..484ac7ee8
--- /dev/null
+++ b/bootloaders/eboot/spi_vendors.h
@@ -0,0 +1,63 @@
+/*
+ spi_vendors.h - Vendor IDs for SPI chips
+ Copyright (c) 2019 Mike Nix. All rights reserved.
+ This file is part of the esp8266 core for Arduino environment.
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library 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
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#ifndef __SPI_VENDORS_H__
+#define __SPI_VENDORS_H__
+
+// Vendor IDs taken from Flashrom project
+// https://review.coreboot.org/cgit/flashrom.git/tree/flashchips.h?h=1.0.x
+// Moved here from ../../cores/esp8266/Esp.h
+typedef enum {
+    SPI_FLASH_VENDOR_ALLIANCE    = 0x52,    /* Alliance Semiconductor */
+    SPI_FLASH_VENDOR_AMD         = 0x01,    /* AMD */
+    SPI_FLASH_VENDOR_AMIC        = 0x37,    /* AMIC */
+    SPI_FLASH_VENDOR_ATMEL       = 0x1F,    /* Atmel (now used by Adesto) */
+    SPI_FLASH_VENDOR_BRIGHT      = 0xAD,    /* Bright Microelectronics */
+    SPI_FLASH_VENDOR_CATALYST    = 0x31,    /* Catalyst */
+    SPI_FLASH_VENDOR_EON         = 0x1C,    /* EON Silicon Devices, missing 0x7F prefix */
+    SPI_FLASH_VENDOR_ESMT        = 0x8C,    /* Elite Semiconductor Memory Technology (ESMT) / EFST Elite Flash Storage */
+    SPI_FLASH_VENDOR_EXCEL       = 0x4A,    /* ESI, missing 0x7F prefix */
+    SPI_FLASH_VENDOR_FIDELIX     = 0xF8,    /* Fidelix */
+    SPI_FLASH_VENDOR_FUJITSU     = 0x04,    /* Fujitsu */
+    SPI_FLASH_VENDOR_GIGADEVICE  = 0xC8,    /* GigaDevice */
+    SPI_FLASH_VENDOR_HYUNDAI     = 0xAD,    /* Hyundai */
+    SPI_FLASH_VENDOR_INTEL       = 0x89,    /* Intel */
+    SPI_FLASH_VENDOR_ISSI        = 0xD5,    /* ISSI Integrated Silicon Solutions, see also PMC. */
+    SPI_FLASH_VENDOR_MACRONIX    = 0xC2,    /* Macronix (MX) */
+    SPI_FLASH_VENDOR_NANTRONICS  = 0xD5,    /* Nantronics, missing prefix */
+    SPI_FLASH_VENDOR_PMC         = 0x9D,    /* PMC, missing 0x7F prefix */
+    SPI_FLASH_VENDOR_PUYA        = 0x85,    /* Puya semiconductor (shanghai) co. ltd */
+    SPI_FLASH_VENDOR_SANYO       = 0x62,    /* Sanyo */
+    SPI_FLASH_VENDOR_SHARP       = 0xB0,    /* Sharp */
+    SPI_FLASH_VENDOR_SPANSION    = 0x01,    /* Spansion, same ID as AMD */
+    SPI_FLASH_VENDOR_SST         = 0xBF,    /* SST */
+    SPI_FLASH_VENDOR_ST          = 0x20,    /* ST / SGS/Thomson / Numonyx (later acquired by Micron) */
+    SPI_FLASH_VENDOR_SYNCMOS_MVC = 0x40,    /* SyncMOS (SM) and Mosel Vitelic Corporation (MVC) */
+    SPI_FLASH_VENDOR_TENX        = 0x5E,    /* Tenx Technologies */
+    SPI_FLASH_VENDOR_TI          = 0x97,    /* Texas Instruments */
+    SPI_FLASH_VENDOR_TI_OLD      = 0x01,    /* TI chips from last century */
+    SPI_FLASH_VENDOR_WINBOND     = 0xDA,    /* Winbond */
+    SPI_FLASH_VENDOR_WINBOND_NEX = 0xEF,    /* Winbond (ex Nexcom) serial flashes */
+    SPI_FLASH_VENDOR_XMC         = 0x20,    /* Wuhan Xinxin Semiconductor Manufacturing Corp */
+
+    SPI_FLASH_VENDOR_UNKNOWN     = 0xFF
+} SPI_FLASH_VENDOR_t;
+
+#endif // __SPI_VENDORS_H__
diff --git a/cores/esp8266/Esp.cpp b/cores/esp8266/Esp.cpp
index db29ec599..dc9e069d9 100644
--- a/cores/esp8266/Esp.cpp
+++ b/cores/esp8266/Esp.cpp
@@ -404,6 +404,8 @@ uint32_t EspClass::getFlashChipSizeByChipId(void) {
             return (64_kB);
 
         // Winbond
+        case 0x1840EF: // W25Q128
+            return (16_MB);
         case 0x1640EF: // W25Q32
             return (4_MB);
         case 0x1540EF: // W25Q16
@@ -423,6 +425,10 @@ uint32_t EspClass::getFlashChipSizeByChipId(void) {
         case 0x1340E0: // BG25Q40
             return (512_kB);
 
+        // XMC - Wuhan Xinxin Semiconductor Manufacturing Corp
+        case 0x164020: // XM25QH32B
+            return (4_MB);
+
         default:
             return 0;
     }
diff --git a/cores/esp8266/Esp.h b/cores/esp8266/Esp.h
index 01327747e..a8fff3651 100644
--- a/cores/esp8266/Esp.h
+++ b/cores/esp8266/Esp.h
@@ -22,43 +22,7 @@
 #define ESP_H
 
 #include <Arduino.h>
-
-// Vendor IDs taken from Flashrom project
-// https://review.coreboot.org/cgit/flashrom.git/tree/flashchips.h?h=1.0.x
-typedef enum {
-    SPI_FLASH_VENDOR_ALLIANCE    = 0x52,    /* Alliance Semiconductor */
-    SPI_FLASH_VENDOR_AMD         = 0x01,    /* AMD */
-    SPI_FLASH_VENDOR_AMIC        = 0x37,    /* AMIC */
-    SPI_FLASH_VENDOR_ATMEL       = 0x1F,    /* Atmel (now used by Adesto) */
-    SPI_FLASH_VENDOR_BRIGHT      = 0xAD,    /* Bright Microelectronics */
-    SPI_FLASH_VENDOR_CATALYST    = 0x31,    /* Catalyst */
-    SPI_FLASH_VENDOR_EON         = 0x1C,    /* EON Silicon Devices, missing 0x7F prefix */
-    SPI_FLASH_VENDOR_ESMT        = 0x8C,    /* Elite Semiconductor Memory Technology (ESMT) / EFST Elite Flash Storage */
-    SPI_FLASH_VENDOR_EXCEL       = 0x4A,    /* ESI, missing 0x7F prefix */
-    SPI_FLASH_VENDOR_FIDELIX     = 0xF8,    /* Fidelix */
-    SPI_FLASH_VENDOR_FUJITSU     = 0x04,    /* Fujitsu */
-    SPI_FLASH_VENDOR_GIGADEVICE  = 0xC8,    /* GigaDevice */
-    SPI_FLASH_VENDOR_HYUNDAI     = 0xAD,    /* Hyundai */
-    SPI_FLASH_VENDOR_INTEL       = 0x89,    /* Intel */
-    SPI_FLASH_VENDOR_ISSI        = 0xD5,    /* ISSI Integrated Silicon Solutions, see also PMC. */
-    SPI_FLASH_VENDOR_MACRONIX    = 0xC2,    /* Macronix (MX) */
-    SPI_FLASH_VENDOR_NANTRONICS  = 0xD5,    /* Nantronics, missing prefix */
-    SPI_FLASH_VENDOR_PMC         = 0x9D,    /* PMC, missing 0x7F prefix */
-    SPI_FLASH_VENDOR_PUYA        = 0x85,    /* Puya semiconductor (shanghai) co. ltd */
-    SPI_FLASH_VENDOR_SANYO       = 0x62,    /* Sanyo */
-    SPI_FLASH_VENDOR_SHARP       = 0xB0,    /* Sharp */
-    SPI_FLASH_VENDOR_SPANSION    = 0x01,    /* Spansion, same ID as AMD */
-    SPI_FLASH_VENDOR_SST         = 0xBF,    /* SST */
-    SPI_FLASH_VENDOR_ST          = 0x20,    /* ST / SGS/Thomson / Numonyx (later acquired by Micron) */
-    SPI_FLASH_VENDOR_SYNCMOS_MVC = 0x40,    /* SyncMOS (SM) and Mosel Vitelic Corporation (MVC) */
-    SPI_FLASH_VENDOR_TENX        = 0x5E,    /* Tenx Technologies */
-    SPI_FLASH_VENDOR_TI          = 0x97,    /* Texas Instruments */
-    SPI_FLASH_VENDOR_TI_OLD      = 0x01,    /* TI chips from last century */
-    SPI_FLASH_VENDOR_WINBOND     = 0xDA,    /* Winbond */
-    SPI_FLASH_VENDOR_WINBOND_NEX = 0xEF,    /* Winbond (ex Nexcom) serial flashes */
-
-    SPI_FLASH_VENDOR_UNKNOWN     = 0xFF
-} SPI_FLASH_VENDOR_t;
+#include "spi_vendors.h"
 
 /**
  * AVR macros for WDT managment
diff --git a/cores/esp8266/core_esp8266_flash_quirks.cpp b/cores/esp8266/core_esp8266_flash_quirks.cpp
new file mode 100644
index 000000000..7128fcfe2
--- /dev/null
+++ b/cores/esp8266/core_esp8266_flash_quirks.cpp
@@ -0,0 +1,85 @@
+/*
+ flash_quirks.cpp - Chip specific flash init
+ Copyright (c) 2019 Mike Nix. All rights reserved.
+ This file is part of the esp8266 core for Arduino environment.
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library 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
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#include <c_types.h>
+#include "spi_flash.h"
+
+#include "spi_utils.h"
+#include "flash_quirks.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+namespace experimental {
+
+static int get_flash_mhz() {
+    // FIXME: copied from Esp.cpp - we really should define the magic values
+    uint32_t data;
+    uint8_t * bytes = (uint8_t *) &data;
+    // read first 4 byte (magic byte + flash config)
+    if(spi_flash_read(0x0000, &data, 4) == SPI_FLASH_RESULT_OK) {
+        switch (bytes[3] & 0x0F) {
+        case 0x0: // 40 MHz
+            return 40;
+        case 0x1: // 26 MHz
+            return 26;
+        case 0x2: // 20 MHz
+            return 20;
+        case 0xf: // 80 MHz
+            return 80;
+        default: // fail?
+            return 0;
+        }
+    }
+    return 0;
+}
+
+/* initFlashQuirks()
+ * Do any chip-specific initialization to improve performance and reliability.
+ */
+void initFlashQuirks() {
+  using namespace experimental;
+  uint32_t vendor = spi_flash_get_id() & 0x000000ff;
+
+  switch (vendor) {
+    case SPI_FLASH_VENDOR_XMC:
+         uint32_t SR3, newSR3;
+         if (SPI0Command(SPI_FLASH_CMD_RSR3, &SR3, 0, 8)==SPI_RESULT_OK) { // read SR3
+            newSR3=SR3;
+            if (get_flash_mhz()>26) { // >26Mhz?
+               // Set the output drive to 100%
+               newSR3 &= ~(SPI_FLASH_SR3_XMC_DRV_MASK << SPI_FLASH_SR3_XMC_DRV_S);
+               newSR3 |= (SPI_FLASH_SR3_XMC_DRV_100 << SPI_FLASH_SR3_XMC_DRV_S);
+            }
+            if (newSR3 != SR3) { // only write if changed
+               if (SPI0Command(SPI_FLASH_CMD_WEVSR,NULL,0,0)==SPI_RESULT_OK)  // write enable volatile SR
+                  SPI0Command(SPI_FLASH_CMD_WSR3,&newSR3,8,0);  // write to SR3
+               SPI0Command(SPI_FLASH_CMD_WRDI,NULL,0,0);        // write disable - probably not needed
+            }
+         }
+  }
+}
+
+} // namespace experimental
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/cores/esp8266/core_esp8266_main.cpp b/cores/esp8266/core_esp8266_main.cpp
index 0ec4f1f3b..2d8436234 100644
--- a/cores/esp8266/core_esp8266_main.cpp
+++ b/cores/esp8266/core_esp8266_main.cpp
@@ -34,6 +34,7 @@ extern "C" {
 }
 #include <core_version.h>
 #include "gdb_hooks.h"
+#include "flash_quirks.h"
 
 #define LOOP_TASK_PRIORITY 1
 #define LOOP_QUEUE_SIZE    1
@@ -334,6 +335,8 @@ extern "C" void user_init(void) {
 
     initVariant();
 
+    experimental::initFlashQuirks(); // Chip specific flash init.
+
     cont_init(g_pcont);
 
     preinit(); // Prior to C++ Dynamic Init (not related to above init() ). Meant to be user redefinable.
diff --git a/cores/esp8266/flash_quirks.h b/cores/esp8266/flash_quirks.h
new file mode 100644
index 000000000..0d05c6d3e
--- /dev/null
+++ b/cores/esp8266/flash_quirks.h
@@ -0,0 +1,42 @@
+/*
+ flash_quirks.h
+ Copyright (c) 2019 Mike Nix. All rights reserved.
+ This file is part of the esp8266 core for Arduino environment.
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library 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
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#ifndef FLASH_QUIRKS_H
+#define FLASH_QUIRKS_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "spi_vendors.h"
+#include "spi_flash_defs.h"
+
+namespace experimental {
+
+void initFlashQuirks();
+
+} // namespace experimental
+
+#ifdef __cplusplus
+}
+#endif
+
+
+#endif // FLASH_QUIRKS_H
diff --git a/cores/esp8266/spi_flash_defs.h b/cores/esp8266/spi_flash_defs.h
new file mode 100644
index 000000000..b749fc4c2
--- /dev/null
+++ b/cores/esp8266/spi_flash_defs.h
@@ -0,0 +1,44 @@
+/*
+ spi_flash_defs.h - SPI Flash chip commands and status registers
+ Copyright (c) 2019 Mike Nix. All rights reserved.
+ This file is part of the esp8266 core for Arduino environment.
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library 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
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#ifndef SPI_FLASH_DEFS_H
+#define SPI_FLASH_DEFS_H
+
+// Flash chip Status Register 3: Vendor XMC Output Drive levels
+#define SPI_FLASH_SR3_XMC_DRV_25  1
+#define SPI_FLASH_SR3_XMC_DRV_50  0
+#define SPI_FLASH_SR3_XMC_DRV_75  2
+#define SPI_FLASH_SR3_XMC_DRV_100 3
+
+#define SPI_FLASH_SR3_XMC_DRV_S   5
+#define SPI_FLASH_SR3_XMC_DRV_MASK 0x03
+
+// Flash Chip commands
+#define SPI_FLASH_CMD_RSR1  0x05  //Read Flash Status Register...
+#define SPI_FLASH_CMD_RSR2  0x35
+#define SPI_FLASH_CMD_RSR3  0x15
+#define SPI_FLASH_CMD_WSR1  0x01  //Write Flash Status Register...
+#define SPI_FLASH_CMD_WSR2  0x31
+#define SPI_FLASH_CMD_WSR3  0x11
+#define SPI_FLASH_CMD_WEVSR 0x50  //Write Enable Volatile Status Registers
+#define SPI_FLASH_CMD_WREN  0x06  //Write Enable
+#define SPI_FLASH_CMD_WRDI  0x04  //Write Disable
+
+#endif // SPI_FLASH_DEFS_H
diff --git a/cores/esp8266/spi_vendors.h b/cores/esp8266/spi_vendors.h
new file mode 100644
index 000000000..b656f4cb5
--- /dev/null
+++ b/cores/esp8266/spi_vendors.h
@@ -0,0 +1,40 @@
+/*
+ spi_vendors.h - Vendor IDs for SPI chips
+ Copyright (c) 2019 Mike Nix. All rights reserved.
+ This file is part of the esp8266 core for Arduino environment.
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library 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
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#ifndef SPI_VENDORS_H
+#define SPI_VENDORS_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Definitions are placed in eboot. Include them here rather than duplicate them.
+ * Also, prefer to have eboot standalone as much as possible and have the core depend on it
+ * rather than have eboot depend on the core.
+ */
+#include <../../bootloaders/eboot/spi_vendors.h>
+
+
+#ifdef __cplusplus
+}
+#endif
+
+
+#endif // SPI_VENDORS_H