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:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user