Skip to content
IDA processor module for the hexagon (QDSP6) processor
C C++
Branch: master
Clone or download

README.md

hexagon

IDA processor module for the hexagon (QDSP6v55) processor

This is the processor found in recent qualcomm basebands ( MSM9xxx ) with LTE support, like the apple iPhone5 and Samsung Galaxy s3 ( GT-i9305 ) or Galaxy S5 ( SM-G900F )

Several versions of the programmers reference manual can be found online:

  • 80-NB419-1 Rev. A Hexagon V2 Programmer’s Reference Manual
  • 80-N2040-9 Rev. A Hexagon V4 Programmer’s Reference Manual
  • 80-N2040-8 Rev. H Hexagon V5/V55 Programmer’s Reference Manual
    • both the v4 and v5 refman can be found in this zip
  • 80-N2040-9 Rev. F Hexagon V5x Programmer’s Reference Manual
  • 80-N2040-33 Rev. D Hexagon V6x Programmer’s Reference Manual
    • both the v5.x and v6.x refman can be found in the Hexagon LLVM Tools 8.0 Document Bundle, which is installed as part of the Hexagon SDK
  • 80-N2040-30 Rev B Hexagon V60 HVX Programmer's Reference Manual
  • 80-N2040-37 Rev A Hexagon V62 HVX Programmer's Reference Manual
  • 80-N2040-36 Rev B Hexagon V62 Programmer's Reference Manual

check out https://developer.qualcomm.com/hexagon-processor for updates from qualcomm.

Available disassemblers:

Note: The Hexagon SDK uses LLVM, but with more hexagon instructions than the publicly available llvm code.

Processor Module

This processor module is a wrapper for the objdump code found on sourcery.mentor.com

Binary download

Binaries for OSX, Linux and Windows can be found under releases:

Installation

Copy the hexagon.{dylib,dll,so} file to the procs subdirectory of your IDA installation. This module can probably also be used with the IDA Evaluation version.

Usage

Start IDA, select 'Qualcomm Hexagon DSP v4:QDSP6' from the processor type.

When loading an ELF binary, IDA will tell you 'Undefined or unknown machine type 164.' you should answer 'Yes'. Then IDA well tell you about unknown flag bits, you can ignore that as well. IDA may also tell you the ELF has an illegal entry point.

Compiling

Separate makefiles exist for OSX (Makefile.osx), Windows (Makefile.w32) and Linux (Makefile.linux).

You need the IDASDK ( Password protected ). The sourcery hexagon gnutools, install them in a subdirectory named hx/sourceryg++-2012.03-151-hexagon/binutils-hexagon-2012.03. You need a c++17 compiler, like visualstudio 2017, or any recent gcc or clang.

Create a idacfg.mk file, containing the following variables:

  • idasdk, pointing to your IDASDK directory
  • idabin, pointing to your IDA binaries directory

On windows, first run the following command, to setup the right visualstudio environment.

vsdevcmd -arch=amd64

Bugs

  • Stack variables not yet recognized
  • The first instruction of a segment is not always disassembled correctly, you can see it switch sometimes. ( this is because the objdump hexagon code keeps internal state in local static variables )
  • Switches are not yet recognized
  • Indirect jumps and calls are not yet marked as such
  • basic block ends are not correct in graph view
  • processor type is fixed to v5.5
  • module may crash when encountering some invalid instructions ( lumia 820 modem )
  • 'loop' instruction should have a code xref, instead of a data xref.

Other Hexagon Processor modules

Author

Willem Hengeveld (itsme@gsmk.de)

History

2013-06-10 version 1.0 2016-02-01 version 1.1 2017-12-05 version 1.2 - for idapro v7

  • fixed incorrect code ref from memw instruction
  • fixed incorrect label for some jump instructions
  • now using changed plugin architecture for IDA7.

License

Free

You can’t perform that action at this time.