Changes between Version 4 and Version 5 of newport

Timestamp:

11/30/2017 06:49:58 PM (6 years ago)

Author:

Tim Harvey

Comment:

added firmware details

newport

@@ -56 +56 @@
 
 == Software ==
+ * [#firmware Firmware (up to and including the Bootloader)]
  * [#bsp Newport Board Support Packages and Operating Systems]
  * [#linux Linux kernel support]
@@ -109 +110 @@
 Additional references:
  * ​[http://www.cavium.com/pdfFiles/OCTEON-TX-CN80XX-CN81XX-Product-Brief-Rev1.pdf OCTEON TX CN80XX-CN81XX Product Brief]
+
+
+[=#firmware]
+= Firmware (Up to and including the Bootloader) =
+The 'firmware-image' for Newport is defined as the combination of the First level 'boot stub' and the additional firmware stages through the bootloader. This can be broken down into the following stages:
+ * Boot ROM (internal on CN80XX/CN81XX SoC): fetch first level boot stub (192KB limit) from boot device (MMC or SPI FLASH)
+ * SPL (Secondary Program Loader)
+ * Bootloader (U-Boot)
+
+For a Secondary Program Loader, or SPL, Gateworks currently uses the Cavium Board Development Kit (BDK) provided by their OCTEON-TX Software Development Kit (SDK). In this current implementation the Boot ROM loads and executes the BDK, the BDK loads and executes the ARM Trusted Firmware (ATF) and the ATF loads and executes the U-Boot bootloader in multiple stages as such:
+ * First level: Bootstub (firmware/bdk)
+ * Second level: ATF (firmware/atf)
+ * Third level: U-Boot (bootloader/u-boot)
+
+Gateworks provides a pre-built firmware-image ready to flash onto boot devices as well as source for building and/or modifying the firmware yourself.
+
+[=#bootrom]
+== Boot ROM ==
+The OCTEON-TX Boot ROM code loads an image from the primary boot device which can be either MMC or SPI FLASH. For a description of available boot devices see [#bootdevice below].
+
+
+[=#bootdevice]
+== Boot Device ==
+Some boards have multiple boot device and may allow selection of which one is the 'primary boot device':
+||= board =||= Primary Boot Device =||= Alternate Boot Device =||
+|| GW630x || on board eMMC || microSD ||
+
+To boot from the alternate boot device manually you can press-and-release the user pushbutton 5 times in a row and the board will power cycle primary power (the 3.3V LED will go off, then on again) and the board will boot from the alternate boot device.
+
+Boards with an Alternate boot device also have a boot watchdog such that if the current boot device fails to boot within 30 seconds, the board will power cycle primary power and attempt boot from the other boot device.