amesianx / idp_hexagon

Hexagon processor module for IDA Pro disassembler

Hexagon Processor Module

This is Hexagon (aka QDSP6) processor module for IDA Pro disassembler. Features:

• Supports all Hexagon versions: V4, V5, V55, V60, V61, V62, V65, V66, V67, V67t, V68, V69, V71
• Supports Hexagon Vector Extensions (HVX), audio extensions
• Supports Hexagon Matrix Extensions (HMX), V66 NN extensions
• Supports all known instructions, including undocumented ones
• Supports ELF relocations (both static and dynamic)
• Supports IDA v7.0-7.5

Information on instructions was mainly gathered from LLVM, whereas missing system-level instructions were taken from Programmer's Reference Manual.

Compilation

You will need the target IDA SDK (7.0, 7.2, 7.3, 7.5) (password protected).
You will also need a C++17 compiler, like Visual Studio 2015/2017, or any recent GCC or Clang.

Install target IDA SDK, copy hexagon folder into $SDK/module folder, and modify $SDK/module/makefile to include hexagon in ALLDIRS.
Build SDK, the resulting binary will be in $SDK/bin/procs/hexagon.dll.

Binary download

Binaries for Windows can be found under releases.

Installation

Copy the hexagon.dll file to the procs subdirectory of your IDA installation.

Usage

Start IDA, load binary and select 'Qualcomm Hexagon DSP [QDSP6]' from the processor type. In case of ELF binary just press the "Set" button.
Otherwise IDA would still sucessfully load binary, but will complain about unknown relocations.

Issues

• In case of mixed code and data the former may have incorrect packet boundaries.
• Some rare relocation types are not properly recognized.
• Does not distinguish between different Hexagon versions; will disassemble instructions not supported by a particular version.
• IDA stores flags for two operands only, and all subsequent operands will have the same flag. For example, if the 2nd operand is an offset, then 4th will be treated as offset too.
• Xref to a stack variable has random type (r/w).

Other Hexagon Processor modules

• hexagon
• nogaxeh
• hexag00n

Author

n-o-o-n ([email protected])

License

LGPLv3. For more information see LICENSE.

History

2020-06-29 version 1.0
2020-06-30 added support for FP-based stack vars
2020-07-01 added basic support for type information; fixed warning message in IDA 7.2 ("Bad declaration..."); symbol, string and relocation tables are now shown for .so binaries
2020-07-02 added function arguments locations
2020-07-10 trace SP modification at the end of a packet
2020-07-13 added automatic comments for function arguments
2020-07-16 added switch support; version 2.0 released
2021-02-04 added support for IDA v7.3 and v7.5
2021-02-26 added support for Hexagon v68
2021-03-02 fixed analysis order; version 3.0 released
2021-06-25 fixed crashes related to missing segment registers
2021-07-12 fixed crash related to xref to a stack variable; removed PR_ALIGN flag
2021-08-13 added support for Hexagon v69 and v71; version 4.0 released