# 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
- [X] Pull requests
- [X] Issues
## Supported functionality
- [X] Read
- [X] Write
- [X] Erase / sector erase
- [X] Info / area information
- [ ] ID Authentication
- [ ] Baud rate (only for SCI)
## Supported OS
- [X] Linux
- [X] Windows
- [ ] Mac OS
## Supported interfaces
- [X] USB
- [ ] SCI
## Supported MCUs
- [X] 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
Raw data
{
"_id": null,
"home_page": "https://github.com/robinkrens/raflash",
"name": "raflash",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Renesas RA flash bootloader",
"author": "Robin Krens",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/fd/b1/89304b8d97cec0567eae4a56edf3b60de2bbb44e3cf0abdca4751db61f40/raflash-0.0.2.tar.gz",
"platform": null,
"description": "# Renesas RA flash tool\nFlash tool for the built in ROM bootloader for Renesas RA microcontrollers\n\n## Requirements\n- Python >= 3.6\n- venv\n\n## Local and development install\n*Strongly Recommended to use venv (https://docs.python.org/3/library/venv.html)*\n- python -m venv .venv\n- source .venv/bin/activate\n- pip install -r requirements.txt\n- pip install -e .\n\n## Access rights to USB device\n\nAdd a file `/etc/udev/rules.d/40-renesas.rules` and add the following:\n```\nSUBSYSTEMS==\"usb\", ATTRS{idVendor}==\"045b\", ATTRS{idProduct}==\"0261\", GROUP=\"plugdev\", MODE=\"0666\"\n```\nMake sure you retrigger udev again:\n\n```\nsudo udevadm trigger\n```\nMake sure you are also in the group *plugdev* \n\n## Usage\n```\nusage: raflash [-h] {write,read,erase,info} ...\n\nRA Flasher Tool\n\noptions:\n -h, --help show this help message and exit\n\nCommands:\n {write,read,erase,info}\n write Write data to flash\n read Read data from flash\n erase Erase sectors\n info Show flasher information\n```\nEach command has various options. For example, use RAFlasher write -h to see all write options:\n```\nusage: raflash write [-h] [--start_address START_ADDRESS] [--size SIZE] [--verify] file_name\n\npositional arguments:\n file_name File name\n\noptions:\n -h, --help show this help message and exit\n --start_address START_ADDRESS\n Start address\n --size SIZE Size in bytes\n --verify Verify after writing\n\n```\n\n## Dev\n - [X] Pull requests\n- [X] Issues\n\n## Supported functionality\n- [X] Read\n- [X] Write\n- [X] Erase / sector erase\n- [X] Info / area information\n- [ ] ID Authentication\n- [ ] Baud rate (only for SCI)\n\n## Supported OS\n- [X] Linux\n- [X] Windows\n- [ ] Mac OS\n\n## Supported interfaces\n- [X] USB\n- [ ] SCI\n\n## Supported MCUs\n- [X] RA4 (tested)\n- [ ] RA2 (should potentially work)\n- [ ] RA6 \n\n*Note: only tested on RA4 hardware*\n\n## Resources\nhttps://www.renesas.com/us/en/document/apn/renesas-ra-family-system-specifications-standard-boot-firmware\n",
"bugtrack_url": null,
"license": "GNU",
"summary": "Flash tool for ROM bootloader for Renesas RA MCUs",
"version": "0.0.2",
"project_urls": {
"Homepage": "https://github.com/robinkrens/raflash"
},
"split_keywords": [
"renesas",
"ra",
"flash",
"bootloader"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "de3dde3afb413ad2a4f48d164881ed2aacc4546611363bb9f64459415b8671d9",
"md5": "e010bb6f8031fb6d28d419fdd182ac60",
"sha256": "68e9edc8a2e616b25776edbbb322af767dc0a058f4b5455764c4982e7a848046"
},
"downloads": -1,
"filename": "raflash-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e010bb6f8031fb6d28d419fdd182ac60",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 21847,
"upload_time": "2024-02-18T23:22:00",
"upload_time_iso_8601": "2024-02-18T23:22:00.116992Z",
"url": "https://files.pythonhosted.org/packages/de/3d/de3afb413ad2a4f48d164881ed2aacc4546611363bb9f64459415b8671d9/raflash-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fdb189304b8d97cec0567eae4a56edf3b60de2bbb44e3cf0abdca4751db61f40",
"md5": "03d5e7eae9b82b10be8fe0e27ea47bce",
"sha256": "872e66d2136fbd4c55ecdcf8c37e0faf765cb0717966f53bfd87a4223e8ce825"
},
"downloads": -1,
"filename": "raflash-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "03d5e7eae9b82b10be8fe0e27ea47bce",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 20283,
"upload_time": "2024-02-18T23:22:02",
"upload_time_iso_8601": "2024-02-18T23:22:02.108684Z",
"url": "https://files.pythonhosted.org/packages/fd/b1/89304b8d97cec0567eae4a56edf3b60de2bbb44e3cf0abdca4751db61f40/raflash-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-18 23:22:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "robinkrens",
"github_project": "raflash",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "raflash"
}
JSON
