Changes between Version 2 and Version 3 of venice/bootloader

Timestamp:

04/18/2024 12:41:20 AM (19 months ago)

Author:

Tim Harvey

Comment:

--

venice/bootloader

@@ -41 +41 @@
 }}}
 
+
+[=#bootdevs]
+== Boot Devices
+The Venice U-Boot Bootloader supports the following devices and partition types:
+ - eMMC
+ - microSD
+ - USB Mass Storage
+ - NVMe
+
+The U-Boot 'Generic Distro Config' is used for Venice:
+ - the default bootcmd will ultimately search for boot scripts on a set of bootable devices 
+ - the 'boot_targets' env variable dictates which devices are checked and in what order
+ - the 'boot_prefixes' env variable dictates what file prefixes are searched for a boot script
+ - the 'boot_scripts' env variable dictates what bootscript names are searched for
+ - only partitions that have the 'boot' flag set are looked at for boot scripts
+
+Venice boards are configured via one-time-programable fuses to boot to an on-board eMMC device (it is possible to have Gateworks configure a board to boot to microSD instead for a special or custom build).
+
+If you wish to select a different boot device priority you can adjust boot_targets. For example:
+ * boot from NVMe (nvme dev 0)
+{{{#!bash
+# flash your disk image to the NVMe device
+u-boot=> pci enum
+PCIE-0: Link up (Gen1-x1, Bus0)
+u-boot=> nvme scan
+u-boot=> nvme info
+Device 0: Vendor: 0x10ec Rev: 0426-D00 Prod: 60272-0005          
+            Type: Hard Disk
+            Capacity: 57241.8 MB = 55.9 GB (117231408 x 512)
+u-boot=> tftpboot $loadaddr venice/jammy-venice.img.gz && gzwrite nvme 0 $loadaddr $filesize
+...
+# set boot targets to boot only from nvme
+setenv boot_targets nvme0
+saveenv
+}}}
+ * boot from microSD (mmc dev 1)
+{{{#!bash
+u-boot=> mmc dev 1
+switch to partitions #0, OK
+mmc1 is current device
+u-boot=> mmc list
+FSL_SDHC: 0
+FSL_SDHC: 1 (SD)
+FSL_SDHC: 2 (eMMC)
+u-boot=> tftpboot $loadaddr venice/jammy-venice.img.gz && gzwrite mmc 1 $loadaddr $filesize
+...
+# set boot targets to boot only from nvme
+setenv boot_targets mmc1
+saveenv
+}}}
+ * boot from USB 0 (usb dev 0)
+{{{#!bash
+u-boot=> usb start
+starting USB...
+Bus usb@38100000: Register 2000140 NbrPorts 2
+Starting the controller
+USB XHCI 1.10
+Bus usb@38200000: Register 2000140 NbrPorts 2
+Starting the controller
+USB XHCI 1.10
+scanning bus usb@38100000 for devices... cannot reset port 1!?
+2 USB Device(s) found
+scanning bus usb@38200000 for devices... 4 USB Device(s) found
+       scanning usb for storage devices... 1 Storage Device(s) found
+u-boot=> usb storage
+  Device 0: Vendor: ASolid   Rev:      Prod: USB             
+            Type: Removable Hard Disk
+            Capacity: 60000.0 MB = 58.5 GB (122880001 x 512)
+       
+u-boot=> tftpboot $loadaddr venice/jammy-venice.img.gz && gzwrite usb 0 $loadaddr $filesize
+...
+# set boot targets to boot only from nvme
+setenv boot_targets mmc1
+saveenv
+}}}
+
+
 [=#memmap]
 == Memory Mapping