40 lines
954 B
Markdown
40 lines
954 B
Markdown
# ADSP-219x Radare2 Plugin
|
|
|
|
Native architecture plugin for disassembling ADSP-219x (including
|
|
ADSP-2191) 24-bit instructions in radare2 and iaito.
|
|
|
|
## Build & Install
|
|
|
|
make
|
|
make install
|
|
|
|
Requires: GCC, radare2 >= 5.8.0 (RArchPlugin API).
|
|
|
|
The `Makefile` also provides `make test`, which builds the plugin and
|
|
runs a smoke test against `../examples/isa_test.bin`.
|
|
|
|
## Usage
|
|
|
|
r2 -a adsp219x -b 24 firmware.bin
|
|
|
|
## Validation
|
|
|
|
Compare against the assembler-verified test ROM:
|
|
|
|
r2 -a adsp219x -b 24 -q -c "pd 48" ../examples/isa_test.bin
|
|
|
|
Or run the local plugin without installing it:
|
|
|
|
make test
|
|
|
|
The test ROM (`isa_test.dsp`) was assembled with open21xx and
|
|
contains known opcodes for all major instruction types.
|
|
|
|
For the current verification matrix and remaining structural-only
|
|
types, see `TESTING.md`.
|
|
|
|
## Coding Standards
|
|
|
|
This plugin follows the GNU Coding Standards for C source code.
|
|
No hardcoded absolute paths in any scripts.
|