Documentation/mainboard/opencellular/elgon.md

   1 # Elgon
   2
   3 This page describes how to run coreboot on the [Elgon] compute board
   4 from [OpenCellular].
   5
   6 ## TODO
   7
   8 * Add hard reset control
   9
  10 ## Flashing coreboot
  11
  12 ```{eval-rst}
  13 +---------------------+------------+
  14 | Type                | Value      |
  15 +=====================+============+
  16 | Socketed flash      | no         |
  17 +---------------------+------------+
  18 | Model               | W25Q128    |
  19 +---------------------+------------+
  20 | Size                | 16 MiB     |
  21 +---------------------+------------+
  22 | In circuit flashing | yes        |
  23 +---------------------+------------+
  24 | Package             | SOIC-8     |
  25 +---------------------+------------+
  26 | Write protection    | No         |
  27 +---------------------+------------+
  28 | Dual BIOS feature   | No         |
  29 +---------------------+------------+
  30 | Internal flashing   | yes        |
  31 +---------------------+------------+
  32 ```
  33
  34 ### Internal programming
  35
  36 The SPI flash can be accessed using [flashrom].
  37
  38 ### External programming
  39
  40 The EVT board does have a pinheader to flash the SOIC-8 in circuit.
  41 Directly connecting a Pomona test-clip on the flash is also possible.
  42
  43 **Total board view of EVT**
  44
  45 ![][elgon1]
  46
  47 [elgon1]: elgon1.jpg
  48
  49 **Closeup view of SOIC-8 flash IC and USB serial connector of EVT (marked blue)**
  50
  51 ![][elgon2]
  52
  53 [elgon2]: elgon2.jpg
  54
  55
  56 **SPI header (marked blue)**
  57
  58 ![][elgon_conn_j9_pcb]
  59
  60 [elgon_conn_j9_pcb]: elgon_conn_j9_pcb.jpg
  61
  62 **SPI header pinout**
  63
  64 Dediprog compatible pinout.
  65
  66 ![][elgon_conn_j9]
  67
  68 [elgon_conn_j9]: elgon_conn_j9.png
  69
  70 ## Technology
  71
  72 ```{eval-rst}
  73 +---------------+----------------------------------------+
  74 | SoC           | :doc:`../../soc/cavium/cn81xx/index`   |
  75 +---------------+----------------------------------------+
  76 | CPU           | Cavium ARMv8-Quadcore `CN81XX`_        |
  77 +---------------+----------------------------------------+
  78
  79 .. _CN81XX: https://www.cavium.com/product-octeon-tx-cn80xx-81xx.html
  80 ```
  81
  82 [Elgon]: https://github.com/Telecominfraproject/OpenCellular
  83 [OpenCellular]: https://code.fb.com/connectivity/introducing-opencellular-an-open-source-wireless-access-platform/
  84 [flashrom]: https://flashrom.org/Flashrom