Microchip Technology PL360G55Cx-EK User manual

PL360G55Cx-EK
Smart Energy: Serial Bootloader User Guide
Introduction
The serial bootloader of the PL360G55Cx-EK boards allows the user to load application binaries in the
SAMG55J19 using one of the serial interfaces available in the boards.
The package contains all necessary sources to modify and compile the embedded serial bootloader,
including the project files for IAR Embedded Workbench®.
Section 1: Overview provides an overview of the serial bootloader and the contents of the package.
Section 2: Installation and Getting Started gives a brief step-by-step description about how to upload a
new firmware application binary.
Appendix A: Bootloader Commands resumes the supported bootloader commands.
Appendix B: How to Flash the Serial Bootloader Binary explains step-by-step how to Flash the bootloader
in the SAMG55J19.
Features
• For PL360G55CB-EK and PL360G55CF-EK Boards
• Firmware Programming over UART and USB Serial Interfaces
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 1

Table of Contents
Introduction......................................................................................................................1
Features.......................................................................................................................... 1
1. Overview....................................................................................................................3
1.1. Supported Platforms and Interfaces.............................................................................................3
1.2. Package Content and Structure................................................................................................... 3
2. Installation and Getting Started................................................................................. 5
2.1. Serial Interface Connections........................................................................................................ 5
2.2. Loading Application Firmware from a PC Host............................................................................ 6
3. Appendix A: Bootloader Commands....................................................................... 10
4. Appendix B: How to Flash the Serial Bootloader Binary..........................................11
5. Revision History.......................................................................................................13
5.1. Rev A - 04/2019......................................................................................................................... 13
The Microchip Web Site................................................................................................ 14
Customer Change Notification Service..........................................................................14
Customer Support......................................................................................................... 14
Microchip Devices Code Protection Feature................................................................. 14
Legal Notice...................................................................................................................15
Trademarks................................................................................................................... 15
Quality Management System Certified by DNV.............................................................16
Worldwide Sales and Service........................................................................................17
PL360G55Cx-EK
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 2

1. Overview
The serial bootloader allows the loading of firmware images to a SAMG55J19 device over a serial
connection. It is intended for use with Microchip PLC stacks such as G3 and PRIME, but it also can be
used with other non-PLC applications.
The embedded serial bootloader preprogrammed in the SAMG55J19 receives an image of the application
in binary format (.bin) over one of the serial interfaces and writes it in the application part of the internal
MCU Flash. The host may be a PC or another MCU/MPU.
Figure 1-1. General approach of the Serial Bootloader for SAMG55J19 Programming
The firmware package provided along with the PL360G55Cx-EK includes a pre-compiled image of the
embedded serial bootloader image.
1.1 Supported Platforms and Interfaces
The embedded bootloader is supported on PL360G55CF_EK and PL360G55CB_EK boards.
The embedded bootloader can work with two serial interfaces of the evaluation kit indistinctly: USB and
mikroBUS™ UART.
1.2 Package Content and Structure
The firmware package contains:
• The embedded bootloader sources, including
– Source code, configuration and header files
– IAR™ project
• A pre-compiled firmware image of embedded bootloader
• USB driver for Windows®
Table 1-1 describes the different folders related to the root directory of the package:
Table 1-1. Serial Bootloader Files and Directories
Path Description
\sam\application\serial_bootloader\ Embedded bootloader source code
PL360G55Cx-EK
Overview
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 3

...........continued
Path Description
\sam\application\serial_bootloader\bin\ Pre-compiled firmware image of embedded
bootloader
\sam\application\serial_bootloader
\samg55j19_pl360g55cx_ek\
Embedded bootloader configuration files
\sam\application\serial_bootloader
\samg55j19_pl360g55cx_ek\iar\
IAR Embedded Workbench project files for
embedded bootloader
\common\services\usb\class\cdc\device\ USB driver for Windows
PL360G55Cx-EK
Overview
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 4

2. Installation and Getting Started
Before using the serial bootloader with a PC host, there are some steps to follow:
1. Unpack the package to a folder on the PC hard drive.
2. Connect the PL360G55Cx-EK board to the PC via one of the serial interfaces supported by the
embedded serial bootloader, UART or USB.
2.1. For a USB interface, the PC could require the installation of a CDC (Communication
Device Class) virtual COM port driver. The package includes an INF file to be used with
Microsoft® Windows versions prior to Windows 10 located in:
\common\services\usb\class\cdc\device\
3. Install a Terminal Emulator PC application (like TeraTerm, for example).
To interact with the embedded serial bootloader from other MCU as host, is it required to implement a
host application which must be able to upload the .bin image following the serial protocol supported by
the embedded firmware.
The PL360G55Cx-EK boards are provided with the embedded serial bootloader pre-programmed in the
Flash memory.
Attention: The use of the jumper ERASE (J3) erases the Flash memory of the SAMG55
microcontroller, including the serial bootloader application.
If the serial embedded bootloader is not present on the SAMG55J19 device, follow the instructions
described in section Appendix B: How to Flash the Serial Bootloader Binary.
2.1 Serial Interface Connections
The embedded bootloader can work with the mikroBUS UART and the USB interfaces provided by the
PL360G55Cx-EK board. The pin assignment of the ports is described in the PL360G55Cx-EK user
manual.
Different interfaces and ports can be enabled at the same time. The embedded bootloader scans them
sequentially for the required handshake packets until one is found.
2.1.1 USB Interface
The USB interface is enumerated in the PC as a virtual COM port. The default port configuration is shown
in Table 2-1.
Table 2-1. Default COM Port Settings for Embedded Serial Bootloader Host
Field Value
Baud Rate 115200
Data Bits 8
Parity None
Stop Bits 1
PL360G55Cx-EK
Installation and Getting Started
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 5

...........continued
Field Value
Flow Control None
2.1.2 MikroBUS UART Interface
By default, the embedded serial bootloader supports USART4 peripheral of the SAMG55J19 which is
accessible in the TXD, RXD and GND pins of the mikroBUS connector in the PL360G55Cx-EK boards. It
is the responsibility of the user to ensure a proper connection to the host device.
The COM port settings to use are the same as for the USB interface.
2.2 Loading Application Firmware from a PC Host
To program the SAMG55J19 MCU using the serial bootloader, follow these steps:
1. Short PROG (J2) header with the provided jumper.
2. Connect the PC to the PL360G55Cx-EK using one of the serial interfaces:
2.1. USB connector of the PL360G55Cx-EK (with the provided USB cable).
2.2. UART pins in the mikroBUS connector of the PL360G55Cx-EK (a USB-UART converter
may be required).
3. Open the Terminal Emulator software and configure the serial port to which the target is connected
using the parameters detailed in Table 2-1. The USB module of the SAMG55J19 can negotiate the
baud rate so a different value can be used. By default, the serial bootloader is started in Terminal
mode, so an echo of the received character will be shown in the terminal window automatically;
therefore it is recommended to disable the “local echo” option of the terminal emulator software.
4. Type # to check the connection with the serial bootloader firmware. If the connection is established
properly, a prompt is shown in the terminal window.
PL360G55Cx-EK
Installation and Getting Started
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 6

5. The bootloader now is ready to receive commands. For example, type V# in the terminal window to
get the version information of the bootloader firmware. In case of a typing mistake, use character
ESC to re-enter a new command sequence. This is applicable to all commands.
6. To load the application firmware to the SAMG55J19 device, use command S. It requires two
parameters:
– RAM address (in hexadecimal format) of a temporal buffer (64 KBytes) to handle the loading
process.
– The size of the application binary file in bytes (in hexadecimal format).
In the example, the buffer is located in the position 0x20010000 (the RAM memory of the
SAMG55J19 starts at 0x20000000).
The size of the application binary file used in this example is 152658 bytes (0x25452).
Type S20010000,25452# in your terminal window. The prompt automatically goes down to the
next line signaling that it is waiting for the file transfer process.
PL360G55Cx-EK
Installation and Getting Started
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 7

7. Send the application binary file to the SAMG55J19 in binary format.
For using the UART interface, it is required to select XMODEM-CRC protocol to transfer the binary
file:
PL360G55Cx-EK
Installation and Getting Started
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 8

8. When the upload process is complete, the prompt appears again.
9. Type command G# in the terminal window to start the application.
10. If the loaded application is running in the SAMG55J19, remove the jumper PROG (J2) and reset
the board.
PL360G55Cx-EK
Installation and Getting Started
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 9

3. Appendix A: Bootloader Commands
The command interpreter allows the host to send or receive data to/from the target. The supported
bootloader mnemonics commands (case sensitive) are given in the table below:
Table 3-1. Bootloader Commands
Command Action Argument(s) Example
N Set Normal Mode No argument N#
T Set Terminal Mode No argument T#
o Read a byte Address,# o200001,#
h Read a half word Address,# h200002,#
w Read a word Address,# w200000,#
S Send a file Address,# S200000,#
R Receive a file Address,NbOfBytes# R200000,1234#
G Go No argument G#
V Display version No argument V#
For example, to read the Chip ID register which is located in the memory address 0x400E0740:
PL360G55Cx-EK
Appendix A: Bootloader Commands
© 2019 Microchip Technology Inc. User Guide DS50002878A-page 10