Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README.

This commit is contained in:
Siggi
2026-04-12 16:59:41 +00:00
parent e940f51b96
commit 88d14aac7f
3 changed files with 247 additions and 109 deletions

View File

@@ -1,9 +1,14 @@
# ADSP-219x radare2 Plugin
# ADSP-219x Radare2 Plugin
Dieses Plugin fügt ADSP-2191 Support zu radare2 und iaito hinzu.
This plugin adds support for the ADSP-219x architecture to radare2 and iaito.
## Kompilieren & Installation
Da der Zielrechner air-gapped ist, stelle sicher, dass `gcc` und `radare2-dev` (oder Header) installiert sind.
## Prerequisites
- GCC
- Radare2 5.8.0+ (uses the `RArchPlugin` API)
- Python 3 (for test ROM generation)
## Installation
```bash
cd r2plugin
@@ -11,20 +16,29 @@ make
make install
```
## Nutzung
Lade dein ROM mit dem `-a` (Architecture) und `-b` (Bits) Schalter:
To uninstall:
```bash
r2 -a adsp219x -b 24 firmware_dump.bin
make uninstall
```
In `iaito`:
1. Datei öffnen
2. `Architecture`: `adsp219x` (im Dropdown suchen oder tippen)
3. `Bits`: `24`
## Usage
## Features
- Volle 24-bit Instruktionsbreite
- Unterstützung für Multifunktions-Compute (ALU/MAC)
- Anzeige von Delayed-Branch (DB) Flags
- Jump-Adressen Decodierung
Load a binary file specifying the architecture and bits:
```bash
r2 -a adsp219x -b 24 firmware.bin
```
## Maintenance & Testing
A test ROM generator is provided in the `testrom/` directory to verify instruction decoding accuracy.
```bash
cd testrom
python3 gen_isa_test.py
r2 -a adsp219x -b 24 -q -c "pd 42" test_roms/isa_test.bin
```
## Coding Standards
This project follows the **GNU Coding Standards** for C code and avoids hardcoded absolute paths in scripts.