In order to easily get going with the development of Bitcraze projects we have pre-configured a virtual machine that can be imported into WM Player or Oracle VirtualBox. It contains all the pre-requisites needed for development and usage of the projects at Bitcraze.

If you would like to create your own virtual machine instead of downloading ours, then have a look at these intructions.

You can download the VM using one of the link below:

• Bitcraze VM 0.2 via torrent
• Bitcraze VM 0.3 via torrent
• Bitcraze VM 0.3 from here (hosted at MEGA so it's limited to 6 downloads at a time)

The latest available version of the VM is 0.3.

OS  : Xubuntu 13.04
HDD : 10 GB (dynamically sized)
RAM : 1 GB
User: bitcraze
Pass: crazyflie

The VM comes pre-configured with the following:

• udev rules for Crazyradio and bootloader
• Pre-configured USB filters for passing Crazyradio/NRF BOOT to the VM (not enabled by default)

Below is a overview of what's installed in the virtual machine:

• VirtualBox guest additions (for network sharing, screen resize, etc)
• gnu-arm-none-eabi toolchain and build tools
• Mercurial
• TortoiseHG
• pyusb, pygame and pyqt
• Qt4 and QtDesigner
• KiCad
• Eclipse with compiling/debugging/flashing configured (for use with BusBlaster)
• gedit
• SDCC 3.2

The following projects are cloned into the VM:

• crazyflie-firmware
• crazyflie-bootloader
• crazyflie-pc-client
• crazyradio-firmware
• crazyradio-electronics

There are also short-cuts on the desktop to easily run the Crazyflie PC client and also to update all the projects to the latest version available on Bitbucket.

The VM comes pre-installed and pre-configured for development. Here's what you can do:

• Update and build the latest versions of the Crazyflie/Crazyradio firmware
• Debug the Crazyflie firmware via JTAG (pre-configured for BusBlaster)
• View and modify the Crazyradio electronics design
• Develop for Crazyflie PC client with QtDesigner for the UI

If you would like to update to the latest version from Bitbucket for all the projects you can either use the short-cut on the desktop (Update all projects) or run the following command:

/home/bitcraze/bin/update_all_projects.sh

If you would like to fly the Crazyflie then you should to the following:

• Insert the controller and Crazyradio and pass them to the VM. In VirtualBox this is done by right-clicking on the USB icon in the bottom left hand of the screen and selecting the Crazyradio and the controller
• Start the cfclient either by using the short-cut on the desktop (Crazyflie PC client latest) or by running the following command:

  /home/bitcraze/projects/crazyflie-pc-client/cfclient

• Press the Connect button and select the URI starting with radio and then press Connect

PLEASE NOTE: If no controller is passed to VirtualBox the default controller will be the VirtualBox USB Tablet. This device together with the default controller mapping will set the thrust depending on where the mouse-pointer is on the screen. Make sure to check that there's no thrust before connecting to the Crazyflie.

Pulling the latest stable release of the firmware and client can be done using the following commands:

cd ~/projects/crazyflie-firmware
hg pull && hg update -C 2013.4
cd ~/projects/crazyflie-pc-client
hg pull && hg update -C 2013.4.2

Running the following commands will build the firmware which can be flashed with the wireless bootloader. For updating the Crazyflie use the resulting cflie.bin.

cd ~/projects/crazyflie-firmware
make CLOAD=1 DEBUG=0