Dr. Christian Giessen 9a82c4d522 Verify and fix gap types against assembler output
Assembler-verified and fixed:
- Type 12: XOP field corrected to bits10-8 (was bits11-9)
- Type 14: SF=4bits, XREG uses reg0[] not xop_shift[] (was 3-bit OOB)
- Type 16: XREG uses reg0[] (was xop_shift[], 4-bit index OOB)
- Type 19: I-reg field at bits3-2 (was bits1-0), now correct for jump(i2)
- Type 26: Push/Pop encoding is 10/11 not 01/10;
  PPP=bits6-5, LPP=bits4-3 (was bits6-4, bits3-2)
  All 6 variants verified: push/pop sts, loop, pc

Assembler-verified unchanged:
- Type 21/21a: MODIFY correct
- Type 23/24: DIVQ/DIVS correct
- Type 29: DM immediate modify read/write correct
- Type 32: Any Reg <-> DM read/write correct
- Type 34/35: IO/System register read/write correct
- Type 36: LJUMP 2-word correct
- Type 37: SETINT/CLRINT correct

Remaining note: Type 12 SF field may use a different mapping
than sf_names[] for combined shift+memory ops (ASHIFT encodes
as SF=2 not SF=4). Needs further investigation.
2026-04-22 20:16:30 +00:00

ADSP-219x Reverse Engineering Toolkit

Radare2 architecture plugin and reference materials for reverse engineering ADSP-2191 firmware.

Contents

r2plugin/       Native radare2 arch plugin (C, GNU style)
examples/       ADSP-2191 assembly examples (FIR, IIR, FFT, Viterbi)
                + assembler-verified ISA test ROM
testrom/        Test ROM generator for plugin validation
docs/           Architecture reference, opcode tables, walkthrough guides

Quick Start

cd r2plugin && make && make install
r2 -a adsp219x -b 24 examples/isa_test.bin
[0x00000000]> pd 48

Requirements

  • Radare2 >= 5.8.0 (RArchPlugin API)
  • GCC

Plugin Status

Currently decodes: NOP, IDLE, Type 1 (multifunction), Type 3 (direct memory), Type 4 (compute + memory), Type 6/7 (immediate loads), Type 10/10a (jump/call), Type 17 (reg move), Type 20 (RTS/RTI).

Work in progress: Type 9/9a (standalone compute), Type 11 (DO UNTIL), Type 15 (shift), Type 18 (mode control), Type 25 (saturate).

Assembler

The examples were assembled with open21xx, an open-source assembler/linker for ADSP-218x/219x. Build instructions are in the open21xx README. The resulting ELF is converted to raw binary with dd (extract the int_pm section).

License

Plugin code: LGPL-3.0-only. Example code from Analog Devices application notes. Documentation extracts from the ADSP-219x DSP Instruction Set Reference.

Description
ADSP-2191 Reverse Engineering - Disassembler, radare2 plugin, and analysis tools
Readme 2.1 MiB
Languages
C 50.4%
Python 48.6%
Makefile 1%