Changes between Version 40 and Version 41 of newport

Timestamp:

02/08/2018 09:57:56 PM (6 years ago)

Author:

Tim Harvey

Comment:

update firmware-update and recovery sections

newport

@@ -146 +146 @@
 The various items that can be updated:
  * GSC Firmware - currently only JTAG updates are supported for Newport - see [#jtag-gsc below]
- * Boot Firmware (Everything up to and including the Bootloader) - currently must be updated from U-Boot or Linux on a live system - see [#firmware-update-uboot below]
- * Root Filesystem (Operating System) - currently must be updated from U-Boot or Linux on a live system - see [#firmware-update-uboot below]
+ * Boot Firmware (Everything up to and including the Bootloader) - currently must be updated from U-Boot or Linux on a live system - see [#serial-ethernet below]
+ * Root Filesystem (Operating System) - currently must be updated from U-Boot or Linux on a live system - see [#serial-ethernet below]
 
 
@@ -154 +154 @@
 The quickest and easiest way to update your firmware is via Serial Console and Ethernet. You can do this either in the U-Boot bootloader (recommended) or within a Linux OS. If your primary boot device is corrupt, then you can boot via an alternate boot device (ie microSD).
 
+
+[=#serial-ethernet-uboot]
+=== Update Firmware via Serial Console and Ethernet from Bootloader ==
 If using U-Boot (recommended) you need to setup a TFTP server to host the files for transfer. Alternatively you could load firmware files from removable storage (microSD, mSATA, or USB for example) however the transfer rate is typically very slow compared to Gigabit Ethernet. For details on setting up a TFTP server see [wiki:tftpserver here].
 
 The following instructions assume your board target IP address is 192.168.1.1 and you have a TFTP server at 192.168.1.146. Adjust environment according to your network via 'setenv ipaddr <ipaddr>' and 'setenv serverip <serverip>'.
 
-Note that if booted from the eMMC (primary device) U-Boot mmc dev 0 is eMMC and mmc dev 1 is microSD however if you booted from the microSD (secondary device) then U-Boot mmc dev 0 is microSD and mmc dev 1 is eMMC. Be sure to use {{{mmc list}}} to determine which device you should set via the {{{mmc dev}}} command.
-
-To update just the 'firmware' (everything up to and including the Bootloader) ([https://github.com/Gateworks/images-newport/raw/master/firmware-newport.img firmware image]):
-{{{#!bash
-mmc dev 0 # use 'mmc list' to show which device is which and select eMMC
-tftpboot ${loadaddr} firmware-newport.img && mmc write ${loadaddr} 0 8000
-}}}
-
-To update the 'boot firmware' as well as the root filesystem download the latest xenial-newport.img.gz from [https://github.com/Gateworks/images-newport/releases/latest the latest release] and flash with:
-{{{#!bash
-mmc list # see which device is emmc vs sd
-setenv dev 0 # use device of emmc assuming booted from emmc
-# using tftp server
+Note that the {{{dev}}} variable needs to be set to the MMC device you are updating:
+ * setenv dev 0 # boot device
+ * setenv dev 1 # secondary device
+ * use {{{mmc list}}} to see how they are configured
+
+Examples:
+ * Update just the '[wiki:newport/boot boot firmware]' (everything up to and including the Bootloader) ([https://github.com/Gateworks/images-newport/raw/master/firmware-newport.img firmware image]):
+{{{#!bash
+setenv dev 0 # use 'mmc list' to show which device to use for eMMC vs microSD
+tftpboot ${loadaddr} firmware-newport.img && mmc write ${loadaddr} 0 8000 # update first 16MB
+}}}
+ * Update the entire device from a Compressed Disk Image ('[wiki:newport/boot boot firmware]' as well as OS):
+{{{#!bash
+setenv dev 0 # use 'mmc list' to show which device to use for eMMC vs microSD
 tftpboot ${loadaddr} xenial-newport.img.gz && gzwrite mmc ${dev} ${loadaddr} ${filesize}
 }}}
- * after booting to Linux you will want to run {{{resize2fs /dev/mmcblk0p2}}} to resize the partition to expand to the available space. This is because {{{xenial-newport.img.gz}}} is a compressed disk image created with a minimal root filesystem to keep flashing time down to a minimum for fast updates.
-
-[=#microsd]
+  - If using Ubuntu you will want to run {{{resize2fs /dev/mmcblk0p2}}} to resize the partition to expand to the available anytime after the first. This is because {{{xenial-newport.img.gz}}} is a compressed disk image created with a minimal root filesystem to keep flashing time down to a minimum for fast updates.
+
+
+[=#recovery]
 == Creating a microSD recovery image ==
 If your primary boot won't boot for some reason (ie, you corrupted it during development) you can boot from a microSD (see [#bootdevice here]).
@@ -186 +191 @@
 }}}
   - '''Be careful to set the DEVICE above to the device the microSD appears as on your Linux host - you do not want to overwrite part of your hosts filesystem'''
- * On a Newport board booted from eMMC:
+ * On a Newport board booted from eMMC from U-Boot:
 {{{#!bash
 mmc list # if booted from eMMC you should see microSD as dev 1
@@ -192 +197 @@
 tftpboot ${loadaddr} firmware-newport.img && mmc write ${loadaddr} 0 8000
 }}}
-
-To create a bootable microSD with the Gateworks Ubuntu image (takes longer):
- * On a Linux host:
-{{{#!bash
-DEVICE=/dev/sdc # set to the microSD on your host
-zcat xenial-newport.img.gz | sudo dd of=$DEVICE
-# re-partition with a 2.5MB DOS partition (required by BDK) and a Linux partition at 16MB
-printf "3072,8191,1,,\n32768,,L,,\n" | sudo sfdisk -uS $DEVICE
-}}}
-  - we re-partition so that the full size of your microSD is available as the firmware image has partitions setup for a 8GiB device. Even though the partition table grows to the size of your device you still need to run {{{resize2fs /dev/mmcblk0p2}}} after bootup to grow the partition to fit the space in the table.
-  - while you could use U-Boot on a running board to program a microSD you would not be able to adjust it's partition table easily to take advantage of a larger disk.