Skip to content

BuildingTheProject

atlas0fd00m edited this page Aug 7, 2017 · 1 revision

Introduction

This page will give information about how to build to software for your dongle, this page assumes a Linux based operating system is used.

Details

In order to build the software for the dongle the following two things are needed:

  • SDCC compiler
  • CC1111USB software

SDCC compiler

The software is compiled using the SDCC (Small Device C Compiler). This compiler is open source and support the 8051 core that is included in the CC111x chips.

The version of this compiler that should definitely work is 2.9.0. This can be downloaded from [http://sourceforge.net/projects/sdcc/files/ here]. Follow the included instructions to install the SDCC compiler.

RfCat software

The RfCat software is the library provided on this site. Because a release isn't available yet the code has to be obtained from the repository.

The software can be checked out using the following command: hg clone https://code.google.com/p/rfcat/

The project is split into two parts: firmware and software. The software is python code that interfaces to LIBUSB (dependency) to talk to the USB dongle. The firmware must be built and flashed onto the USB dongle before RfCat will work properly

In order to build the firmware, one of the following commands can be issued (from within the firmware/ directory):

  • Chronos dongle make RfCatChronos.hex
  • CC1111EMK make RfCatDons.hex
  • IM-Me dongle make immeSniff.hex

There are several other Makefile targets used to install the firmware directly to the dongle. Below are some examples (others exist):

  • CC1111EMK (install bootloader) make installdonsbootloader
  • CC1111EMK (using bootloader) make installRfCatDonsDongleCCBootloader
  • CC1111EMK (using GoodFET) make installRfCatDonsDongle

The resulting hex image is located in the {{{firmware/bins}}} folder and can be loaded into the dongle using a [http://www.ti.com/tool/cc-debugger CC Debugger] or a [http://goodfet.sourceforge.net/ GoodFET].

Clone this wiki locally