build instructions
==================

install board firmware
----------------------

The only board firmware currently known to support ethernet is version
0v9p9b909 available from:

	http://forum.energymicro.com/topic/151-dk3550-dk3650-dk3750-firmware-099-beta/

The newer firmware 0v9p10b929 does not work.

install toolchain
-----------------

This BSP is created for OSELAS.Toolchain-2014.12. Either use a binary toolchain
(e.g. from http://debian.pengutronix.de/debian, package
	oselas.toolchain-2014.12.0-arm-cortexm3-uclinuxeabi-gcc-4.9.2-uclibc-0.9.33.2-binutils-2.24-kernel-3.16-sanitized) or
you can build it yourself using the following commands:

	wget http://www.pengutronix.de/oselas/toolchain/download/OSELAS.Toolchain-2014.12.0.tar.bz2
	wget http://www.ptxdist.org/software/ptxdist/download/ptxdist-2014.12.0.tar.bz2

Then install ptxdist:

	tar xjf ptxdist-2014.12.0.tar.bz2
	cd ptxdist-2014.12.0
	./configure

if ptxdist is missing some packages on your system, install them and restart configure

	make
	sudo make install

This installs ptxdist to /usr/local.

For building the toolchain, fakeroot is needed:

	sudo apt-get install fakeroot

Then build the toolchain

	tar xf OSELAS.Toolchain-2014.12.0.tar.bz2
	cd OSELAS.Toolchain-2014.12.0
	ln -sf /usr/local/bin/ptxdist-2014.12.0 p
	./p select ptxconfigs/arm-cortexm3-uclinuxeabi_gcc-4.9.2_uclibc-0.9.33.2_binutils-2.24_kernel-3.16-sanitized.ptxconfig
	./p go

Now go and get you a cup of coffee.

install ptxdist 2014.07.0
-------------------------

Note, for building the BSP you need a different ptxdist version than for the toolchain.

	wget http://ptxdist.de/software/ptxdist/download/ptxdist-2014.07.0.tar.bz2
	tar xjf ptxdist-2014.07.0.tar.bz2
	cd ptxdist-2014.07.0
	./configure && make
	sudo make install

building
--------

	cd /path/to/OSELAS.BSP-EnergyMicro-Gecko
	ln -s /usr/local/bin/ptxdist-2014.07.0 p
	./p select configs/ptxconfig
	./p toolchain /opt/OSELAS.Toolchain-2014.12.0/arm-cortexm3-uclinuxeabi/gcc-4.9.2-uclibc-0.9.33.2-binutils-2.24-kernel-3.16-sanitized/bin
	./p platform configs/platform-energymicro-efm32gg-dk3750/platformconfig
	./p images

   This takes some time now. After ptxdist completed and you plugged your Gecko
   board to your maschine, first make sure that the debug mode is set to "MCU".
   (Press the "CFG" button under the display, then select "MCU" for "Debug
   Control" and save.) Then you can do

	./p test flash

   to write the built images into the Gecko's flash and boot into Linux.
   Note that this uses Energymicro's eACommander which needs 32-bit Qt
   installed.