raflash

Flash tool for ROM bootloader for Renesas RA MCUs


Keywords
Renesas, RA, flash, bootloader, arduino-uno-r4, gr-cotton, gr-lychee, programmer, ra4m1
License
GPL-3.0
Install
pip install raflash==0.0.2

Documentation

Renesas RA flash tool

Flash tool for the built in ROM bootloader for Renesas RA microcontrollers

Requirements

  • Python >= 3.6
  • venv

Local and development install

Strongly Recommended to use venv (https://docs.python.org/3/library/venv.html)

  • python -m venv .venv
  • source .venv/bin/activate
  • pip install -r requirements.txt
  • pip install -e .

Access rights to USB device

Add a file /etc/udev/rules.d/40-renesas.rules and add the following:

SUBSYSTEMS=="usb", ATTRS{idVendor}=="045b", ATTRS{idProduct}=="0261", GROUP="plugdev", MODE="0666"

Make sure you retrigger udev again:

sudo udevadm trigger

Make sure you are also in the group plugdev

Usage

usage: raflash [-h] {write,read,erase,info} ...

RA Flasher Tool

options:
  -h, --help            show this help message and exit

Commands:
  {write,read,erase,info}
    write               Write data to flash
    read                Read data from flash
    erase               Erase sectors
    info                Show flasher information

Each command has various options. For example, use RAFlasher write -h to see all write options:

usage: raflash write [-h] [--start_address START_ADDRESS] [--size SIZE] [--verify] file_name

positional arguments:
  file_name             File name

options:
  -h, --help            show this help message and exit
  --start_address START_ADDRESS
                        Start address
  --size SIZE           Size in bytes
  --verify              Verify after writing

Dev

  • Pull requests
  • Issues

Supported functionality

  • Read
  • Write
  • Erase / sector erase
  • Info / area information
  • ID Authentication
  • Baud rate (only for SCI)

Supported interfaces

  • USB
  • SCI

Supported MCUs

  • RA4 (tested)
  • RA2 (should potentially work)
  • RA6

Note: only tested on RA4 hardware

Resources

https://www.renesas.com/us/en/document/apn/renesas-ra-family-system-specifications-standard-boot-firmware