.. _rzg2-flashing:

Flashing RZ/G2L Boards
======================

Initial Bootloader Flashing
---------------------------

.. hint:: Due to serial transfer, this process takes some time. Usually you have a working bootloader on your board, so you can **skip this section.**

Yocto generated images and our precompiled images contain the ``install-bootloader.sh`` script.

**Make sure to put the board into Download Mode** - See: :ref:`enabling-bootmode`

For running the script, pass the serial port device, and let it work for you. The serial port normally is something like ``/dev/ttyS0`` or ``/dev/ttyUSB0``:

.. prompt::
   :prompts: $

   cd <image-directory>
   ./install-bootloader.sh /dev/ttyS0

The output will look as follows:

.. code-block:: text

   Started bootloader flash process on /dev/ttyS0

   Put your board into SCIF Download mode
   When done press any key to continue...

   Sending FlashWriter:
   269312 bytes (269 kB, 263 KiB) copied, 23 s, 11,6 kB/s
   269+1 records in
   269+1 records out
   275980 bytes (276 kB, 270 KiB) copied, 23,458 s, 11,8 kB/s

   BL2 transfer:
   107520 bytes (108 kB, 105 KiB) copied, 9 s, 11,6 kB/s
   115+1 records in
   115+1 records out
   118724 bytes (119 kB, 116 KiB) copied, 9,91065 s, 12,0 kB/s

   FIP transfer:
   2274304 bytes (2,3 MB, 2,2 MiB) copied, 196 s, 11,6 kB/s
   2223+1 records in
   2223+1 records out
   2276684 bytes (2,3 MB, 2,2 MiB) copied, 196,241 s, 11,6 kB/s

   Writing eMMC partconf

   ======================================================
   Done. Put the board into normal bootmode and reset it.
   ======================================================


You can also notice output in serial terminal while flashing.

.. tip:: After flashing put the board back to normal bootmode and reset it.


Flashing via Fastboot
---------------------

Flashing to eMMC is done via Fastboot protocol using **UUU**.

If you are not familiar with UUU follow :ref:`uuu`.

.. hint:: For flashing RZ/G2L boards with UUU it's **not necessary** to put the board into Serial Download Bootmode.
   You have to start fastboot from U-Boot manually.

Yocto generated images and our precompiled images contain the **uuu.auto** script.

When UUU is installed on your host and ready to use, simply run:

.. prompt::
   :prompts: $

   cd <build-directory>/tmp/deploy/images/$MACHINE/<image-directory>
   uuu -v

Now enter the U-Boot prompt on your target via serial terminal and type:

.. prompt::
   :prompts: #

   fastboot usb 0

Now UUU partitions your board and flashes the filesystem.

.. tip:: After flashing with UUU has finished, the desired Linux image will boot.