Silicom LTD.
                              Silicom BMC EFM32GG11 series
                                       NOTES

In the Host (Linux OS), using 'minicom' application, enter the BTL menu
and update/download FW (*.gbl file ).

Pre-requirements:
=================
- BMC UART Console connected to Host with Linux OS.
- 'minicom' installed and configured with <115200,8,N,1> serial port settings.
- Copied *.gbl FW update file (EFM32GG11_BMC_MNB_FW_ID1_V1.0.0_BX.Y.ZZ.gbl)
  to /root directory of the Host Linux.

Update procedure:
=================
 1. Boot Host to OS (Linux) and login into it as root.

 2. In the Host Linux prompt, run:
    # stty rows 80

 3. In the Host Linux prompt, run:
    # minicom

 4. In minicom press <Enter> to get the BMC command shell prompt:
    [bmc]$

 5. To check the current BMC FW Version, run:
    [bmc]$ ver
    Press <Enter>

    You'll get the following output, for example:

    Device Name:                    BMC_MNB
    MCU Name:                       EFM32GG11_BMC_MNB
    BMC APP FW Version:             1.0.0
    BMC APP FW Build:               0.0.1
    BMC FW Group ID:                1.0
    BMC MicriumOS Version:          5.7.0
    BMC Environment Version:        1.0
    BMC Log Version:                1.0
    Current APP version:            1.0

    The most important information for update is:
    BMC APP FW Build:               x.y.zz
    where x - firmware major version
          y - firmware minor version
          zz - build number

 6. Run command 'update -x' to reboot to bootloader.
    [bmc]$ update -x
    Press <Enter>

    You'll get the following output, for example:

    [1664058925.0000866587] [INFO] Now all the tasks will be closed.
    [1664058925.0000866587] [INFO] BMC GPIO Task closed successfully
    [1664058925.0000866587] [INFO] BMC Shell Task closed successfully
    [1664058925.0000866587] [INFO] BMC Monitor Task closed successfully
    [1664058925.0000866587] [INFO] BMC MAIN Task closed successfully
    [1664058926.0000866587] [INFO] Rebooting...

    Gecko Bootloader v1.8.4
    1. upload gbl
    2. run
    3. ebl info
    BL >

 7. To start the update FW, you should select '1' option (upload gbl)
    in the BMC Bootloader menu.
    Press <1> on the keyboard.
    Now the Bootloader will wait for *.gbl FW update file during 40 sec
    (sending 'C' symbol every second for output).

 8. Quickly perform the following:
    - Press CTRL-A Z on the keyboard.
    - Press S (Send file) on the keyboard.
    - In the dialog window select using the arrow keys 'xmodem' option
      and press on <Enter>.
    - Navigate to valid FW file name (EFM32GG11_BMC_MNB_FW_ID1_V1.0.0_BX.Y.ZZ.gbl)
      by arrows.
    - Press <Space> to select the FW file name.
    - Press <Enter>.

 9. If you selected the appropriate FW *.gbl file,
    the FW upload process will start,
    and you will see the byte sending progress in the dialog window.

10. The message 'Transfer complete' should appear on successful completion.

11. Press any key to continue.

12. You should see the following output:
    Serial upload complete
    Gecko Bootloader v1.8.4
    1. upload gbl
    2. run
    3. ebl info
    BL >

13. To start the new FW Application, select '2' option (run)
    in the BMC Bootloader menu.
    Press <2> on the keyboard.

    You'll get the following output, for example:

    [ 943920000.0000000000] [INFO] ========== Booting ==============
    [ 943920000.0000000000] [INFO] Thu Mar 5 08:10:25 2020
    [ 943920000.0000000000] [INFO] Device Name:             BMC_MNB
    [ 943920000.0000000000] [INFO] MCU Name:                EFM32GG11_BMC_MNB
    [ 943920000.0000000000] [INFO] MCU Clock - running at 50.0 MHz
    [ 943920000.0000000000] [INFO] BMC APP FW Version:      1.0.0
    [ 943920000.0000000000] [INFO] BMC APP FW Build:        0.0.82
    [ 943920000.0000000000] [INFO] BMC FW Group ID:         1.0
    [ 943920000.0000000000] [INFO] BMC MicriumOS Version:   5.7.0
    [ 943920000.0000000000] [INFO] BMC Environment Version: 1.0
    [ 943920000.0000000000] [INFO] BMC Log Version:         1.0
    [ 943920000.0000000000] [INFO] BTL current APP version: 1.0
    [ 943920000.0000000000] [INFO] Flash Device Info:
    [ 943920000.0000000000]         ID - 0xc22816
    [ 943920000.0000000000]         Name - MX25R3235F (32 MBit)
    [ 943920000.0000000000]         Clock - running at 32.0 MHz in PHY mode
    [1664058999.0000000099]        BMC GPIO Task starting...
    [1664058999.0000000099] [ OK ] BMC GPIO Task started
    [1664058999.0000000099]        BMC Shell Task starting...
    [1664058999.0000000099] [ OK ] BMC Shell Task started
    [1664058999.0000000186]        BMC Monitor Task starting...
    [1664058999.0000000186] [ OK ] BMC Monitor Task started
    [bmc]$

14. To check the new updated BMC FW version,
    you may run again the command 'ver' in the BMC command shell.

    [bmc]$ ver
    Press <Enter>

    You'll get the following output, for example:

    Device Name:                    BMC_MNB
    MCU Name:                       EFM32GG11_BMC_MNB
    BMC APP FW Version:             1.0.0
    BMC APP FW Build:               0.0.2
    BMC FW Group ID:                1.0
    BMC MicriumOS Version:          5.7.0
    BMC Environment Version:        1.0
    BMC Log Version:                1.0
    Current APP version:            1.0

    As you can see, your previous version 0.0.1 was updated to 0.0.2.