AAUSAT3 Ground Station Box
C C++ Makefile Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


About the BlueBox

The bluebox is a USB-powered ground station box design for the AAUSAT3 cubesat
satellite. The device firmware, control software and hardware is licensed under
the MIT license with the hope that it may be useful to other cubesat projects.

The device is built around the Analog Devices ADF7021 transceiver and controlled
by an Atmel ATMEGA32U4 microcontroller with hardware USB. The firmware makes use
of the open source LUFA USB stack and uses libusb and pyusb for communication
between the device and control program, bbctl.

How to install bbctl

Go to software/bbctl and run:

    $ sudo python2 setup.py install

Note that you need gcc to compile the FEC extension module.

How to build and flash the firmware

In order to communicate with device without being root, copy 49-bluebox.rules
and 49-atmel.rules to your udev rules directory (usually /etc/udev/rules.d).

Now, compile and flash the software. The bbctl dfu step can be omitted if
you're flashing the device for the first time:

    $ cd bluebox/software/firmware
    $ make clean all 
    $ bbctl dfu
    $ make program

You need dfu-programmer to program the device. Install it from your package
manager or from http://dfu-programmer.sourceforge.net/

Finally, test the device by reading back the silicon revision of the ADF7021 RF

    $ bbctl version

You can run bbctl help to get a list of available commands.