Awesome

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, V73, V75, V77, V79
• 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-8.3

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, 7.6, 7.7, 8.3) (password protected).
You will also need a C++17 compiler, like Visual Studio 2015/2017/2022, 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).
• Some experimental instructions are not decoded.

Other Hexagon Processor modules

• hexagon
• nogaxeh
• hexag00n

Author

n-o-o-n (n_o_o_n@bk.ru)

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
2022-01-12 added support for IDA v7.6
2022-02-03 fixed two crashes
2022-02-07 duplex instructions decoded into two separate insn_t
2022-02-14 predicate operands stored at the end of ops array; version 5.0 released
2023-03-31 added support for IDA v7.7
2023-06-26 added support for Hexagon v73; version 5.2 released
2024-05-21 added support for Hexagon v75, v77, v79; version 5.3 released
2024-05-22 added support for IDA v8.3; version 5.4 released