Prepare the example-application image file that is to be downloaded by the TFTP Bootloader:

• Open the project:

  fnet\fnet_demos\boards\<board_name>\shell_boot\<compiler_name>\
  

• In the IDE choose the Release target.
• Compile the project.
• The fnet_firmware.srec file should appear in directory with binaries.
  Copy this S-record file to the TFTP Server Base Directory (by default, it is C:\TFTP-Root).
• Close the project.

Prepare the FNET TFTP Bootloader:

• Open the project:

  fnet\fnet_demos\boards\<board_name>\boot\<compiler_name>\
  

• In the IDE choose Release target.
• Compile the project.
• Flash the program to the board.
• Now the TFTP Bootloader is ready to be used.
  You may update or backup the firmware with help of TFTP firmware client or TFTP firmware server.

TFTP firmware client

• Reset the board, press the RESET button on the board.
• In your terminal program window you should see the FNET Bootloader welcome message:

  ************************************************
   FNET Bootloader
  ************************************************
   FNET TCP/IP Stack for MK64FN1
   Version 4.0.0
   Built Oct 26 2017 at 16:32:22 by IAR
  
   Enter '?' for command list.
  ************************************************
  [FAPP] Application parameters loaded from Flash.
  Startup script: tftp
  ************************************************
   TFTP Server started.
   IPv4 Address         : 192.168.0.22
  ************************************************
  BOOT>
  

• Look at the network interface parameters using the info shell command:

  BOOT> info
  Ethernet Interface <default>:
   Name                 : eth0
   ScopeID              : 1
   Media State          : connected
   IPv4 Address         : 192.168.0.22 <manual>
   IPv4 Subnet mask     : 255.255.255.0
   IPv4 Gateway         : 0.0.0.0
   DHCP Client          : off
  
  Services:
   TFTP Server          : on
  BOOT>
  

• The Bootloader is now ready to accept user commands. Enter the ? command to display a list of all commands available within the shell of the Bootloader:

  BOOT> ?
  >      ?                                 - Display this help message
  >    set [<parameter> <value>]           - Set parameter
  >    get [<parameter>]                   - Get parameters
  >   info [-n <if name>]                  - Show interface info
  >  dhcpc [-n <if name>] [release|autoip] - Start DHCP client
  >  tftpc [<image name>[<server ip>[<type>]]]- TFTP firmware loader
  >tftpcup [<image name>[<server ip>[<type>]]]- TFTP firmware uploader
  >   tftp [release]                       - TFTP firmware server
  >    mem                                 - Show memory map
  >  erase all|[0x<erase address> <bytes>] - Erase flash memory
  >   save                                 - Save parameters to the FLASH
  >     go [0x<address>]                   - Start application at address
  >  reset                                 - Reset the board
  BOOT>
  

• Check Bootloader parameters. Enter the get command to see the parameter values:

  get
   ip      : 192.168.0.22
   netmask : 255.255.255.0
   gateway : 0.0.0.0
   mac     : 00:11:22:33:44:55
   boot    : stop
   delay   : 5
   script  : dhcpc; erase all; tftpc; set boot go; save; go
   tftp    : 192.168.0.200
   image   : fnet_firmware.srec
   type    : srec
   go      : 0x0
  BOOT>
  

• To change the default parameters the set command should be used. To understand its syntax, enter the set command without parameters:

  BOOT> set
  Valid 'set' options:
   ip      : <default-if IPv4 address>
   netmask : <default-if IPv4 netmask address>
   gateway : <default-if IPv4 gateway address>
   mac     : <default-if Ethernet address>
   boot    : <stop|go|script>
   delay   : <seconds>
   script  : <command script>
   tftp    : <TFTP server IP address>
   image   : <Image-file name to load with TFTP>
   type    : <srec|hex|bin|raw>
   go      : 0x<entry point address>
  BOOT> 
  

• Brief description of the Bootloader parameters:
  • ip : Default IPv4 address of the board.
  • netmask : Default IPv4 Network netmask.
  • gateway : Default IPv4 address of the gateway.
  • mac : Ethernet MAC address.
  • boot : Bootloader booting modes:
    • stop = the bootloader stops at the shell prompt.
    • go = the bootloader jumps to the entry point address defined by the go parameter.
    • script = the bootloder executes a command script located in the script parameter.
  • delay : After the bootup, the bootloader will wait specified number of seconds before it executes the boot-mode defined by the boot parameter. During this time a countdown is printed, which can be interrupted by pressing any key. It is ignored for the stop booting mode.
  • script : The command script is automatically executed when the boot parameter is set to the script value and the initial countdown is not interrupted. This script may contain any command supported by the application shell. The commands must be split by semicolon operator.
  • go : Default entry point address to start execution at. It is used by the bootloader in the go booting mode as the default entry point. Also it is used as the default address for the go shell command if no address is provided as an argument.
    NOTE: This parameter is updated by the TFTP loader automatically if the type parameter is set to the srec value. The S-record file format contains the entry point information.
  • tftp : This is the default TFTP server IP address to be used for network download if no address is provided for the tftpc shell command.
  • image : This is the default file name to download if no file name is provided for the tftpc shell command.
  • type : Type of the file to download by the TFTP loader:
    • srec = S-record file (default type). This file format contains both the address data as well as the entry point information.
    • hex = Intel HEX file. This file format does not contain the entry point, so go parameter must be set additionally.
    • bin = CodeWarrior binary file. This file format does not contain the entry point, so go parameter must be set additionally
    • raw = Raw binary file. For this type of file, the raw parameter (load address) must be set before the TFTP loader start.
  • raw : Load address for a raw-binary file used by the TFTP loader. It's used only if the type parameter is set to the raw value.
• Check if the parameter values are set correctly to suit your needs. Most probably, you will have a different TFTP server IP address. For example, to change it to the 10.171.89.219 address, enter:

  BOOT> set tftp 10.171.88.219
   tftp    : 10.171.88.219
  BOOT>
  

• For example, to change the script parameter (use the backslash-escape symbol before each semicolon):

  BOOT> set script 'erase all\; tftpc\; set boot go\; save\; reset'
   script  : erase all; tftpc; set boot go; save; reset
  BOOT>
  

• When all parameters are set correctly for your system, set the boot parameter to the script value.

  BOOT> set boot script
   boot    : script
  BOOT>
  

• Enter the save command to save all run-time parameters to a non-volatile memory (it is located in the last erase page of the on-chip flash memory).

  BOOT> save
  Application parameters saved
  BOOT>
  

  NOTE: The save command does not save the ip parameter in case it was allocated by a DHCP IPv4 server to avoid IPv4 address conflict during the system startup.
• Reset the board, press the RESET button on the board. On reset, the Bootloader will start in script booting mode.
  Let`s analyze the script parameter value of the example provided above:

  dhcpc; erase all; tftpc; set boot go; save; go
  

  This script has the following steps:
  1. dhcpc = starts DHCP client service on the default interface and tries to update the IPv4 parameters (ip, gateway and netmask) from DHCP server. If the DHCP service will fail to retrieve the IP parameter from a DHCP server, the bootloder will continue with the old IP settings.
  2. erase all = erases all Flash memory blocks. To see the memory map enter the mem command:

     BOOT> mem
     
        Memory type       Start         End
       ----------------------------------------
       FLASH            0x00000000   0x0007FFFF
     
     BOOT>
     

  3. tftpc = downloads the image-file (the file name defined by the image parameter) from the TFTP server (the server ip address defined by the tftp parameter), loads it to the Flash memory, checks if the written data are correct. Also, it checks a checksum and updates the go parameter if the type is set to the srec value.
     If the TFTP loading is failed, the bootloader will print an error message, stop script execution, and stay in the bootloader shell waiting for user actions (reset or parameters change).
  4. set boot go = Changes the bootloder booting mode to the go mode.
  5. save = Saves all run-time parameters to persistent memory to be available during the next startup.
     NOTE: The save command does not save the ip parameter in case it was allocated by a DHCP server to avoid IP address conflict during the system startup.
  6. go = Jumps to the application entry-point. As we use S-record image file the entry-point go parameter is updated automatically.
• On reset, in the terminal window you should see:

  ************************************************
   FNET Bootloader
  ************************************************
   FNET TCP/IP Stack for MK64FN1
   Version 4.0.0dev
   Built Oct 26 2017 at 16:48:56 by IAR
  
   Enter '?' for command list.
  ************************************************
  [FAPP] Application parameters loaded from Flash.
  Press any key to stop (script):   0
  
  dhcpc; erase all; tftpc; set boot go; save; go
  ************************************************
   DHCPv4 Client started.
   Interface            : eth0
  ************************************************
  Press [Ctr+C] to cancel.
  [DHCP] Discovering...
  
  ************************************************
   IPv4 parameters updated :
  ************************************************
  Ethernet Interface <default>:
   Name                 : eth0
   ScopeID              : 1
   Media State          : connected
   IPv4 Address         : 192.168.0.102 <dhcp>
   IPv4 Subnet mask     : 255.255.255.0
   IPv4 Gateway         : 192.168.0.1
   DHCP Client          : on
   DHCP Server Address  : 192.168.0.1
  
  Erasing...
   0x0000d000 to 0x000fefff erased
  Press [Ctr+C] to cancel.
  TFTP downloading 'fnet_firmware.srec' (srec) from 192.168.0.200 : \
  Entry point set to 0x0002703d
  
  TFTP completed (307618 bytes)
   boot    : go
  Application parameters saved
  go 0x0002703d
  
  ************************************************
   FNET Shell Demo (bootloader aware)
  ************************************************
   FNET TCP/IP Stack for MK64FN1
   Version 4.0.0dev
   Built Oct 26 2017 at 16:17:57 by IAR
  
   Enter '?' for command list.
  ************************************************
  [FAPP] Application parameters loaded from Flash.
  SHELLB>
  [LINK] eth0: connected => Script: dhcpc autoip -n eth0; mdns -n eth0; llmnr -n eth0;
  ************************************************
   DHCPv4 Client started.
   Interface            : eth0
  ************************************************
  Press [Ctr+C] to cancel.
  [DHCP] Discovering...
  
  ************************************************
   IPv4 parameters updated :
  ************************************************
  Ethernet Interface <default>:
   Name                 : eth0
   ScopeID              : 1
   Media State          : connected
   IPv4 Address         : 192.168.0.102 <dhcp>
   IPv6 Address         : fe80::211:22ff:fe33:4455 <autoconfigurable>
   IPv4 Subnet mask     : 255.255.255.0
   IPv4 Gateway         : 192.168.0.1
   IPv4 DNS             : 192.168.0.1
   DHCP Client          : on
   DHCP Server Address  : 192.168.0.1
   AUTOIP Service       : off
   LLMNR Server         : off
   MDNS Server          : off
  
  ************************************************
   mDNS server started.
   Interface            : eth0
   Host Name            : fnet
  ************************************************
  ************************************************
   LLMNR server started.
   Interface            : eth0
   Host Name            : fnet
  ************************************************
  SHELLB> 
  

• Now the Bootloader is in the go mode and every time on the system reset it will start the loaded application automatically.