Getting started

Using argXtract with the provided examples is simple:

• Clone the repo using git clone https://github.com/projectbtle/argXtract.git. (This assumes you have git installed.)
• cd into the project folder.
• Install pre-requisites using pip install -r requirements.txt. (Again, this assumes you have pip installed.)
• If you will be testing Nordic BLE or ANT binaries, and you believe the binary may have an embedded SoftDevice (i.e., Nordic's BLE/ANT stack), then you will also need to download the SoftDevices to test against, using the instructions below. Note that it is rare for SoftDevices to be embedded in real-world binaries due to the much larger filesize and the fact that the SoftDevice does not normally need to be changed during the lifetime of a device. None of the example binaries require this step.
  • For Nordic BLE SoftDevices:
    • Go to https://developer.nordicsemi.com/nRF5_SDK/ and download all SDKs. Within the SDKs, navigate to components/softdevice. For each listed SoftDevice, obtain the ihex from within the hex folder and convert it to binary format (using objcopy). Copy the resultant .bin file to argxtract/resources/vendor/nordic_ble/softdevices/.
  • For Nordic ANT SoftDevices:
    • You have to sign up for an account with ANT and download SoftDevices from the ANT+ website. Place them within argxtract/resources/vendor/nordic_ant/softdevices/
• Head over to the Examples page to find out how to test argXtract.

** Note that you will need Python 3.7+ in order to use this tool.