This repository hosts a workspace featuring a single project: rl78-boot. This project includes both the bootloader, which utilizes the Renesas Code Flash Self-Programming Library for RL78, and the application itself. The flashing process is performed via a serial port using the XMODEM protocol to ensure file transfer integrity.

The bootloader project in this repo used the following software and hardware components

• IAR Embedded Workbench for Renesas RL78 (V5.10.3)
• Renesas Code Flash Self-Programming Library for RL78 (T01, Ver.4.00)
• Renesas Applilet3 for RL78 (V1.22.0)
• Tera Term (V5.2)
• 2x mini-B USB cables
• Renesas E1 Emulator (or similar)
• Renesas Promotion Board for RL78 (YRPBRL78G13)

The Renesas Promotion Board for RL78 conveniently comes with a built-in Serial-to-USB adapter which simplifies the initial setup.

1. Make sure the Virtual UART is selected.

2. Use the E1 Emulator 14-pin flat cable to connect to the board J5 header.
3. Use one mini-B USB cable to connect the Renesas E1 emulator to a PC USB port.
4. Use another mini-B USB cable to connect the USB1 connector to another PC USB port.
5. Use the Windows Device Manager to find out if the device was properly recognized and, if so, which communications port was assigned to it (e.g. COMx).

The serial_bootloader workspace contains the rl78-boot project and can be cloned directly (or downloaded):

$ git clone https://github.com/iarsystems/ewrl78-bootloader

1. Switch to the Tera Term.
2. Open a new serial connection using the COMx.
3. Set the serial port parameters to 115200-8-N-1.

To build the project, perform the following steps:

1. Install the RL78 FSL library (for IAR compiler version 2.10+):

2. Install it in the <path-to>/ewrl78-bootloader/rl78-boot/FSL. For example:

3. In the IAR Embedded Workbench, load the serial_bootloader.eww workspace.
4. Build the project (F7).
5. Choose Project → Download → Download active application.
6. Disconnect the E1 Emulator from the YRPBRL78G13 J5 header.

In Tera Term, you should see the application V1 running, with the LED blinking on the board:

1. In the project, modify the welcome string from V1 to V2 in the main-app.c source file and rebuild the project (F7).
2. The application can enter into its "bootloader mode". Press b:

3. The application is now in "bootloader mode" from where it is possible to download a new firmware. Press 1:

4. Choose File → Transfer → XMODEM → Send..., navigate to the file Debug\Exe\boot+app.bin and click Send:

Congratulations! The bootloader updated the application:

The memory layout was defined for the R5F100LE device:

The following command is performed during the post-build stage (Project → Options → Build Actions):

ielftool --bin-multi="0x00000-0x00FFF;0x02000-0x0FFFF" "$TARGET_PATH$" "$EXE_DIR$\binfile" & copy /b/v "$EXE_DIR$\binfile-0x0"+"$EXE_DIR$\binfile-0x2000" "$EXE_DIR$\boot+app.bin"

This build action will:

1. Use the IAR ELF Tool to generate 2 binary files: one for BOOT0_ROM and another one for APPLICATION.
2. Use the copy /b command to concatenate the generated binary files into a single boot+app.bin binary file.

For technical support contact IAR Customer Support.

For questions or suggestions related to this repository: try the wiki or check earlier issues. If those don't help, create a new issue with detailed information.