Update all docs and test generator to match verified assembler opcodes

- README.md: Complete project overview with plugin status
- ARCHITECTURE.md: Fixed register tables (CNTR in REG1, not REG2)
- GETTING_STARTED.md: r2-native workflow, removed Python disasm refs
- PRACTICAL_EXAMPLE.md: Uses verified open21xx opcodes with bit layouts
- ROM_ANALYSIS_WALKTHROUGH.md: Updated format detection and r2 commands
- r2plugin/README.md: Simplified, points to assembler test ROM
- gen_isa_test.py: All opcodes from open21xx assembler with labels
This commit is contained in:
Siggi
2026-04-22 18:46:54 +00:00
parent c8fba73574
commit 29dc1f1bd2
7 changed files with 380 additions and 200 deletions

View File

@@ -1,44 +1,29 @@
# ADSP-219x Radare2 Plugin
This plugin adds support for the ADSP-219x architecture to radare2 and iaito.
Native architecture plugin for disassembling ADSP-219x (including
ADSP-2191) 24-bit instructions in radare2 and iaito.
## Prerequisites
## Build & Install
- GCC
- Radare2 5.8.0+ (uses the `RArchPlugin` API)
- Python 3 (for test ROM generation)
make
make install
## Installation
```bash
cd r2plugin
make
make install
```
To uninstall:
```bash
make uninstall
```
Requires: GCC, radare2 >= 5.8.0 (RArchPlugin API).
## Usage
Load a binary file specifying the architecture and bits:
r2 -a adsp219x -b 24 firmware.bin
```bash
r2 -a adsp219x -b 24 firmware.bin
```
## Validation
## Maintenance & Testing
Compare against the assembler-verified test ROM:
A test ROM generator is provided in the `testrom/` directory to verify instruction decoding accuracy.
r2 -a adsp219x -b 24 -q -c "pd 48" ../examples/isa_test.bin
```bash
cd testrom
python3 gen_isa_test.py
r2 -a adsp219x -b 24 -q -c "pd 42" test_roms/isa_test.bin
```
The test ROM (`isa_test.dsp`) was assembled with open21xx and
contains known opcodes for all major instruction types.
## Coding Standards
This project follows the **GNU Coding Standards** for C code and avoids hardcoded absolute paths in scripts.
This plugin follows the GNU Coding Standards for C source code.
No hardcoded absolute paths in any scripts.