r2plugin/README.md

# 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).

## 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

The test ROM (`isa_test.dsp`) was assembled with open21xx and
contains known opcodes for all major instruction types.

## Coding Standards

This plugin follows the GNU Coding Standards for C source code.
No hardcoded absolute paths in any scripts.
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00			`# ADSP-219x Radare2 Plugin`
Add radare2 ADSP-219x ASM plugin 2026-04-12 14:28:20 +00:00
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 2026-04-22 18:46:54 +00:00			`Native architecture plugin for disassembling ADSP-219x (including`
			`ADSP-2191) 24-bit instructions in radare2 and iaito.`
Add radare2 ADSP-219x ASM plugin 2026-04-12 14:28:20 +00:00
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 2026-04-22 18:46:54 +00:00			`## Build & Install`
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00
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 2026-04-22 18:46:54 +00:00			`make`
			`make install`
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00
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 2026-04-22 18:46:54 +00:00			`Requires: GCC, radare2 >= 5.8.0 (RArchPlugin API).`
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00
			`## Usage`

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 2026-04-22 18:46:54 +00:00			`r2 -a adsp219x -b 24 firmware.bin`
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00
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 2026-04-22 18:46:54 +00:00			`## Validation`
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00
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 2026-04-22 18:46:54 +00:00			`Compare against the assembler-verified test ROM:`
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00
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 2026-04-22 18:46:54 +00:00			`r2 -a adsp219x -b 24 -q -c "pd 48" ../examples/isa_test.bin`
Add radare2 ADSP-219x ASM plugin 2026-04-12 14:28:20 +00:00
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 2026-04-22 18:46:54 +00:00			The test ROM (`isa_test.dsp`) was assembled with open21xx and
			`contains known opcodes for all major instruction types.`
Add radare2 ADSP-219x ASM plugin 2026-04-12 14:28:20 +00:00
Compliance update: GNU Coding Standards for C, relative paths in Python, and updated README. 2026-04-12 16:59:41 +00:00			`## Coding Standards`
Add radare2 ADSP-219x ASM plugin 2026-04-12 14:28:20 +00:00
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 2026-04-22 18:46:54 +00:00			`This plugin follows the GNU Coding Standards for C source code.`
			`No hardcoded absolute paths in any scripts.`