Changes between Version 3 and Version 4 of uboot

Timestamp:

04/18/2024 12:42:03 AM (7 months ago)

Author:

Tim Harvey

Comment:

added documentation and examples for dhcp/dns/tftpboot/nfs/wget

uboot

@@ -428 +428 @@
  * {{{filesize}}} - gets set to the size of data transferred
  * {{{netretry}}} - when set to 'no' each network operation will either success or fail without retrying. When set to 'once' the operation will fail only when all available network interfaces have been tried once without success.
+
+
+[=#dhcp]
+=== DHCP
+The {{{dhcp}}} command (if enabled) can use the DHCP protocol to configure networking.
+
+Examples:
+ * use DHCP to configure networking:
+{{{#!bash
+u-boot=> dhcp
+BOOTP broadcast 1
+BOOTP broadcast 2
+BOOTP broadcast 3
+DHCP client bound to address 172.24.20.160 (1047 ms)
+}}}
+
+A successful bind will set the following:
+ * ipaddr
+ * netmask
+ * gatewayip
+ * serverip
+
+The following variables affect dhcp:
+ * autoload - if set will attempt to transfer a file from the server
+
+
+[=#dns]
+=== DNS
+The {{{dns}}} command (if enabled) can use the DNS protocol to perform a name to IP lookup. You must setn the 'dnsip' env variable to an accessible DNS server.
+
+Examples:
+ * use DNS to lookup dev.gateworks.com
+{{{#!bash
+u-boot=> dhcp
+BOOTP broadcast 1
+DHCP client bound to address 172.24.20.160 (1046 ms)
+u-boot=> setenv dnsip 8.8.8.8 
+u-boot=> dns dev.gateworks.com
+108.161.129.64
+}}}
+
+
+[=#tftp]
+=== TFTP
+The {{{tftpboot}}} command has been the primary method for transferring files from a server for many years.
+
+The following U-Boot environment variables (as well as the general network variables above) are used with tftp:
  * {{{tftpsrcport}}} - UDP source port (if not set uses default)
  * {{{tftpdstport}}} - UDP dest port (if not set uses well known port 69)
  * {{{tftpblocksize}}} - if not set will use TFTP server's default block size
  * {{{tftptimeout}}} - retransmission timeout for TFTP packets in ms (min value is 1000, default is 5000)
- * {{{dhcp}}} - Use DHCP to configure networking env
+
+
+Examples:
+ * fetch a file via TFTP to a memory address specified by loadaddr:
+{{{#!bash
+u-boot=> tftpboot $loadaddr 192.168.1.146:file
+}}}
+
+The {{{filesize}}} variable will be set to the number of bytes transferred
+
+
+[=#nfs]
+=== NFS
+The NFS command (if enabled) can transfer a file from an NFS server to a memory address.
+
+Examples:
+ * fetch a file via NFS to a memory address specified by loadaddr:
+{{{#!bash
+u-boot=> nfs $loadaddr 172.24.21.238:/venice/firmware-venice-imx8mp.bin
+}}}
+
+The {{{filesize}}} variable will be set to the number of bytes transferred
+
+[=#wget]
+=== WGET
+The TCP protocol and {{{wget}}} command (if enabled) were added to U-Boot v2023.01 to support fetching files via HTTP however until very recently it was plagued with a couple of issues. These issues have been resolved and support has been enabled for venice U-Boot
+
+Examples:
+ * fetch a file via HTTP to a memory address specified by loadaddr:
+{{{#!bash
+u-boot=> wget $loadaddr 172.24.21.238:/venice/firmware-venice-imx8mp.bin
+HTTP/1.0 200 OK| | | | | | | | | | | | | | | | | | | | | | 
+Packets received 2900, Transfer Successful
+Bytes transferred = 4194336 (400020 hex)
+}}}
+
+The {{{filesize}}} variable will be set to the number of bytes transferred
+
+Note that only HTTP is supported.