{"id":16658233,"url":"https://github.com/connorrigby/rx8-ecu-dump","last_synced_at":"2025-04-09T18:24:38.762Z","repository":{"id":61300608,"uuid":"549116465","full_name":"ConnorRigby/rx8-ecu-dump","owner":"ConnorRigby","description":"utility to dump the Mazda RX8 (and maybe others) ECU firmware","archived":false,"fork":false,"pushed_at":"2022-11-05T22:33:35.000Z","size":13189,"stargazers_count":29,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-23T20:24:26.026Z","etag":null,"topics":["automotive","can","canbus","ecuhacking","j2534","reverse-engineering"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ConnorRigby.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-10-10T17:44:07.000Z","updated_at":"2025-03-13T04:21:49.000Z","dependencies_parsed_at":"2022-10-14T17:09:50.774Z","dependency_job_id":null,"html_url":"https://github.com/ConnorRigby/rx8-ecu-dump","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnorRigby%2Frx8-ecu-dump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnorRigby%2Frx8-ecu-dump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnorRigby%2Frx8-ecu-dump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnorRigby%2Frx8-ecu-dump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ConnorRigby","download_url":"https://codeload.github.com/ConnorRigby/rx8-ecu-dump/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248086339,"owners_count":21045327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automotive","can","canbus","ecuhacking","j2534","reverse-engineering"],"created_at":"2024-10-12T10:03:47.625Z","updated_at":"2025-04-09T18:24:38.736Z","avatar_url":"https://github.com/ConnorRigby.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RX8 ECU ROM Dumper\n\nThis project is very much a work in progress. It's primarily developed by myself\nwith occasional assistance from a small group of enthusiasts in the community.\nIf you wish to get involved, *please* do so. \n\n## Disclaimer\n\nIt's not my fault if you mess your car up. Really. If you're here, I assume\nyou at least *sort of* understand what you're doing. It should be noted\nthat **THERE IS ALMOST NO MORE POWER LEFT** in the OEM tune for RX8 from\nMazda. If you are hunting for more power out of your stock Renisis, you\nwill not find it here. It is expected that this project is targeted\nat tuners for ported, boosted or otherwise modified engines.\n\n## Usage\n\nExecute `ecudump` or `ecudump.exe` depending on your platform. \n\n### Downloading the ROM from an ECU\n\nIt should take about 2 minutes to complete. Once complete, you\nshould have a file in the same directory as the executable labeled\nwith your ECU's VIN and CALID. \n\n```powershell\necudump.exe --download\n```\n\n### Downloading a RAM snapshot from an ECU\n\nThis should only take about 5 seconds.\n\n```powershell\necudump.exe --download=ramdump.bin --start-address=0xffff6000 --transfer-size=0x7D00\n```\n\n## Planned Features\n\nThis project is still in it's infancy, and probably won't get a ton of\nlove until I have more time for it. I do have some goals and non-goals\nin mind.\n\n### Goals\n\n* ECU flashing. currently only downloading is supported, for this to be useful it'll need to be able to flash firmware back to the ECU.\n* Develop/port a kernel or bootloader. I'm not currently sure if this will be required, but if so it will get done.\n* ROMRaider or ECUFlash integration. For flashing the ROM to be useful to anyone, the ROM will need to be mapped.\n\n### Non Goals\n\n* Make money. I started this project specifically because I disagree with the model that current companies are relying on.\n* Replace Ecutek, Cobb, or whatever your favorite tuning company is. They have a business, I am just bored.\n* Handhold or teach engine tuning. There are plenty of (better) resources for this already.\n* Handhold or teach reverse engineering. There are not resources for this unfortunately, and this will not be a solution to that.\n* New ECU features \n* Removing ECU features (yes, this includes the immobilizer. Just pay $100 for a new key)\n\nWith all that being said, I am doing this \"for fun\", on my own free time. If you feel so inclined buy me a coffee with the\nsponsor button above. \n\n## Getting Involved\n\nMy long term goal is to have an option for tuning RX8s without needing to\npay $250+ for a license to closed source software on top of the closed source\nJ2354 Interface. With that said, if you are also interested please let me know.\nThere is a lot of ongoing work happening and would love some additional help.\nIssues, Pull Requests, and any other feedback is welcome. \n\n## Linux Support\n\nLinux is supported experimentally, however you will have to compile it yourself.\nIf you (the reader) are interested in this, feel free to reach out or open an issue.\n\n```bash\n# clone the repo\ngit clone https://github.com/ConnorRigby/rx8-ecu-dump.git -b v0.1.0\ncd rx8-ecu-dump\n\n# fetch and build external dependencies (very important)\ngit submodule update --init --recursive\ncd lib/j2534\n\n# this patch needs to be applied to fix a bug in the library.\ngit patch apply ../*.patch\ncd j2534\nmake\n\n# optionally install the library globally (you proably don't want/need this)\nsudo make install\n\n# build the program\ncd ../../../\nmake\n```\n\nOnce built, the same instructions should apply as for Windows. There is one caveat that\nmay trick Linux users up: permissions. See [the j2534 documentation](https://github.com/dschultzca/j2534/tree/bf08e0d923f0e5b28370d3ec0ed402d8093371e6#using-the-library).\n\n## LICENSE\n\nCode is licensed under the APACHE-2 license where possible.\nother licenses may apply to individual files. Make sure to check\nfor this if you plan on using anything found in this repo. Notably\nthe code in the folder `J2534` is Copyright (C) 2004- Tactrix Inc.\n\n## Special Thanks\n\n* [gooflophaze](https://github.com/gooflophaze)\n* [dschultzca](https://github.com/dschultzca)\n* [fenugrec](https://github.com/fenugrec)\n* equinox92\n* [speepsio](https://github.com/speepsio)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconnorrigby%2Frx8-ecu-dump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconnorrigby%2Frx8-ecu-dump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconnorrigby%2Frx8-ecu-dump/lists"}