Purpose

Create a build and test environment for Magic Lantern 77D development in one step. It should be good for other models as well.

Directory structure

VagrantFile
|
|- ROMs/ # put your firmware ROM into the model directories
|  |
|  |- 77D/
|  |- 200D/
|  \...
|
|- provision/ # scripts to setup the guest Vagrant machine
|
|- magic-lantern/ # cloned ML repository, will be created by provisioning
|
|- qemu-eos/ # QEMU installation, will be created by provisioning
|
|- bin/ # useful executables like disassemblev7.pl
|

Note that while qemu-eos is visible in the file system of the host machine it is not executable in the host environment, unless the operating system and architecture are identical!

Vagrant Plugin Configuration

To install the VirtualBox guest additions automatically in the Vagrant machine. The second plugin allows a reload during provisioning of the Vagrant machine.

$ vagrant plugin install vagrant-vbguest
$ vagrant plugin install vagrant-reload

Provisioning of the Vagrant machine

First copy your ROM files to model-specific subdirectory in ROMs/.

Next execute vagrant up This will take some time to complete the provisioning:

download Ubuntu box
start Ubuntu
download and install needed packages
clone the ML repository
install QEMU
copy ROM files
compile QEMU

Using the Vagrant machine

After the provisioning has been completed:

login to GUI with vagrant / vagrant
on first start you should configure your keyboard layout

sudo dpkg-reconfigure keyboard-configuration

also you should consider to set the correct timezone

sudo dpkg-reconfigure tzdata

a system restart may be required for this to take effect in X11: vagrant reload
execute startx to start the Xfce4 desktop
run a terminal
start QEMU from the terminal to be able to see graphical output

./run_canon_fw.sh 77D,firmware="boot=0"

Compile and run Magic Lantern

To avoid issues with modules as long as none has been built change the modules/Makefile by putting a hyphen in front of line 31. See https://bitbucket.org/calle2010/magic-lantern/commits/7c425ae2c0d0e17855e4811dcb6ac0ae998dc00f

Then compile and install to Qemu SD card the minimal-d78:

$ cd /vagrant/magic-lantern/platform/77D.102/
$ make clean; make install_qemu CONFIG_QEMU=y ML_MODULES=

Then run it in Qemu

$ cd /vagrant/qemu-eos
$ ./run_canon_fw.sh 77D,firmware="boot=1" -s -S & gdb-multiarch -x 77D/patches.gdb

Tipps

For VirtualBox in MacOs the the host key is the right Cmd key. Press it to realease the focus from the guest window.

For QEMU in X11 press Ctrl+Alt+G to release the focus from the ML window.

You can login to the command line with vagrant ssh.

calle2010 / magic-lantern-77d-vagrant