Difference between revisions of "Workshop"

Revision as of 16:47, 28 January 2014

The MAGEEC project has designed a board for high frequency measurement of energy usage. This workshop will guide you through setting up and using the MAGEEC energy measurement boards.

At its simplest, the power measurement shield works by sampling the voltage drop across a resistor wire inline with a power supply. It is implemented as a shield for a ST Microelectronics STM32F4 Discovery board. The STM32F4 is used to process the raw data and pass it out over USB. The shield can measure up to three external targets simultaneously, as well as measuring its own energy usage.

The hardware is a fully open design by Dr Simon Hollis of Bristol University. It may be downloaded from GitHub: https://github.com/mageec/powersense-shield.

Follow the quick start guide if you are using a MAGEEC USB stick.

Quick Start

Follow this section if you have booted from the MAGEEC USB stick - it already contains all the libraries and software needed.

Connect up all the hardware as shown in the Connecting the hardware section.

The first step is to put the firmware on the STM32F4DISCOVERY board. To do this plug in the STM32F4DISCOVERY board with the mini-USB cable and open a terminal (Ctrl+Alt+T)

$ cd Desktop/stlink
$ ./st-util

This starts the GDB server that will communicate between the debugger and the board. Now open another terminal (Ctrl+Alt+T) and start the debugger to flash the firmware to the board.

$ cd Desktop
$ arm-none-eabi-gdb stm32f4-energy-monitor/src/firmware/energy_monitor
> target extended-remote :4242
> load

The board is now flashed, and the mini-usb cable can now be connected. The board can be connected via the other USB port now (micro-USB). This allows the firmware to communicate with the host. There is no direct power connection from this client USB port, so take a jumper and connect it from PA9 (client USB bus power) to the 5V pin.

Now look at the Connecting a target board section.

Software Requirements

Skip this section if you are running from the MAGEEC live CD. Download it from:

• jpallister.com/documents/ubuntu-mageec.iso

This section sets up the packages required to compile the firmware for the energy monitor board, run the python scripts to communicate with the board and toolchain to compile for an arduino target board.

Install packages required to build the firmware for the energy monitor board

sudo add-apt-repository ppa:terry.guo/gcc-arm-embedded

If on Ubuntu 13.10, the following is required

sed -i 's/saucy/raring/' /etc/apt/sources.list.d/terry_guo-gcc-arm-embedded-saucy.list
sudo apt-get update

Install an ARM toolchain

sudo apt-get install gcc-arm-none-eabi

If the target board is a shrimping kit / arduino / AVR

sudo apt-get install gcc-avr  gdb-avr avr-libc avrdude arduino  

Install other libraries needed

sudo apt-get install git python-numpy python-scipy build-essential python-pip autoconf automake autotools-dev libtool libusb-1.0-0-dev libusb-0.1-4
sudo pip install pyusb

The following udev rules will need to be install, to use the board without being root

https://github.com/jpallister/stm32f4-energy-monitor/blob/pyusb/53-energy-monitor.rules
https://github.com/jpallister/stlink/blob/master/49-stlinkv2.rules

For example using wget against the raw version from GitHub.

wget https://raw2.github.com/jpallister/stm32f4-energy-monitor/pyusb/53-energy-monitor.rules
wget https://raw2.github.com/jpallister/stlink/master/49-stlinkv2.rules

and install with:

sudo cp 53-energy-monitor.rules /etc/udev/rules.d/
sudo cp 49-stlinkv2.rules /etc/udev/rules.d/
sudo service udev restart

Connecting the hardware

First mount the shield as shown in the following image. There will probably be a jumper supplied with the STM32F4, which will need removing, with the pins slotting into a socket on the underside of the shield.

For each measurement point there are two headers. One 4x1 offering pins labelled GND, OUT and IN (more on the 4th one later) and one 5x2 for selecting an inline resistor (see below).

The target power supply should be intercepted, and wired to the IN pin, with the OUT pin then connected to the power supply on the target board. GND should be connected to ground on the target board. Power supplies up to 5V are supported. Although the voltage drop is sufficient to give the current measurement, a GND connection (not shown in the above picture) is needed to get an absolute voltage measurement.

The 4th pin next to IN is a jumper to bypass an inductor. Sometimes the only way to intercept the power supply on a target board is to cut out the inductor. In this case, remove the jumper to use the inductor on the shield instead. The target device can be powered from the shield if desired. In this case IN should be connected to the 3.3V or 5V supply on the shield (the above shows this, with the brown wire picking up the 3.3V supply). A maximum of 100mA draw is available in total.

The choice of resistor depends on the target maximum power consumption. Values of 0.05Ω, 0.5Ω, 1Ω and 5Ω are provided (the 5th slot is unused and can be used to supply your own resistor). The objective is a maximum 50mV drop.

To power the board without the programming cable connected, a wire should be connected from the PA9 pin to the 5V pin. Warning: don't connect cables to both USB ports with a power cable connected.

Software setup

The first thing to do is to flash the STM32F4DISCOVERY board with the firmware required to take energy measurements. This firmware sets up the ADCs, USB and other peripherals, so that the board can talk to the host machine via USB. It performs the accumulation and conversion of the analog energy values coming from the power measurement shield.

In the following steps, skip any git clone commands if you are using the MAGEEC tools environment - all of the files are already provided on the desktop.

The energy monitor firmware uses a library called libopencm3 to interface to the hardware peripherals provided by the board. This needs to be downloaded and compiled into the toolchain:

$ git clone https://github.com/libopencm3/libopencm3
$ cd libopencm3
$ make
$ sudo make DETECT_TOOLCHAIN=1 install
$ cd ..

Next, we need to obtain the energy monitor sources.

$ git clone https://github.com/jpallister/stm32f4-energy-monitor
$ cd stm32f4-energy-monitor
$ git checkout pyusb

Then configure and compile specifying that we want to compile ARM firmware:

$ ./configure --host=arm-none-eabi
$ make

This will produce a file energy_monitor in src/firmware/. The next step is to flash this to the STM32F4 board. The board has two USB interfaces, one for programming and the other for the firmware's use. The programming USB interface is at the top of the board, connected with a USB mini cable. Make sure this is plugged in, and follow the steps below to flash the board.

To communicate with the board, we need a gdb server to enable communication between the debugger, GDB, and the target board. This is provided by the opensource st-link utility.

$ cd ..
$ git clone https://github.com/jpallister/stlink
$ cd stlink
$ ./autogen.sh
$ ./configure
$ make
   

Now, we need to run this program and leave it running in - it will talk to GDB and the STM32F4 in the background.

$ ./st-util

In a new terminal, we can now flash the firmware to the board:

$ arm-none-eabi-gdb

Choose the firmware file, tell GDB to talk to the GDB server (st-util) on port 4242 and load the firmware onto the board.

(gdb) file stm32f4-energy-monitor/src/firmware/energy_monitor
(gdb) target extended-remote :4242
(gdb) load
(gdb) detach
(gdb) quit

Note. The load command does not always work first time. If you get an error message, just repeat the load command.

At this point kill st-utils and reset the STM4 board by pressing the black button.

Congratulations. You now have a programmed energy monitor board. At this point, you can disconnect the mini-USB programming cable. The micro-USB cable can now be connected to the board, and you should have a fully functioning energy monitor.

Connecting a target board

This section discusses how to connect target boards to the energy measurement.

The energy measurement board works by inserting a small resistor between the positive power rail and the processors to be measured.

STM32VLDISCOVERY

This section discusses how to connect a Cortex-M3 STM32VLDISCOVERY board (pictured right). You will need 3 jumper cables to connect the target board to the energy measurement board.

Locate the idd jumper next to the larger chip on the board. This is a jumper which allows the power supply to the chip to be intercepted. The following connections need to be made:

• OUT pin of the measurement shield to the side of the idd header closest to the chip.
• IN pin of the measurement shield to the side of the idd header furthest from the chip.
• GND pin of the measurement shield to a ground pin on the target board.

AVR/Shrimping kit

The following connections should be made:

• The IN pin of the measurement board should be connected to the voltage into the breadboard.
• The OUT pin of the measurement board should go back to the breakboard, and into the power supply of the chip
• The GND pin on the measurement board should be plugged into one of the ground pins of the chip.

Using the software

A python library is provided which communicates with the USB board, and transfers the energy data back. Two example scripts are provided, read.py and continuous.py

The first script, read.py, sets up a port to trigger the energy measurement (PA0, the blue button). Pressing the button down causes the board to start measuring. Releasing the button causes the board to stop measuring and the data to be transferred back.

   > cd stm32f4-energy-monitor/src/python/
   > python read.py

The second script, continuous.py, starts measurement point 1, then repeatedly gets the current measurement. This will allow you to see the energy consumed since this beginning of the script.

   > python continuous.py

There is one more script, which allows you to see the instantaneous current and voltage values at a particular measurement point

   > python debug.py 1

A further script plots the instantaneous current on a graph.

   > python graph.py

Challenges

This section gives some examples for you to try out with the energy measurement kit.

Persistence of Vision

This uses one of the shrimping.it persistence of vision kits. Use the following two links to build one of the kits.

• http://shrimping.it/blog/pov-kit/
• https://github.com/embecosm/shrimp-pov

Once you have built the kit, there are a few interesting things you can try

• Do different messages affect how much energy is consumed?
• Does compiling for space (-Os) make the code take less energy?
• Does an interrupt driven version of the code run more efficiently?

Blinking, ADCs, Peripherals and more

The libopencm3-examples repository has many different programs demonstrating what the STM32F boards can do. Instrument some of these examples with energy measurement, for example:

• How much power does the serial UART take for different STM32F boards?
• Use some of the interrupts to explore event driven programming - can this result in lower energy?
• Is it more energy efficient to use the built in CRC calculation, or do it in software?

Sorting

Try different sorting algorithms. Which is most energy efficient?

BEEBS

We use the a benchmark suite called BEEBS for our research. Try running some of these benchmarks on different hardware targets, with different clock speeds. Which takes the least energy?

Troubleshooting and bugs

• Check the blue light on the board. If this is lit, then an error has occurred and the board needs to be unplugged and then plugged back in. This happens if the host polls the board too frequently.