stm32f3discovery examples added.

- miniblink - button - fancyblink - adc - Non tested yet! But they compile.
2013-06-26 05:12:36 -06:00
parent fb4cecd05e
commit 757d044c23
14 changed files with 739 additions and 0 deletions
--- a/examples/stm32/f3/Makefile.include
+++ b/examples/stm32/f3/Makefile.include
@@ -0,0 +1,154 @@
+##
+## This file is part of the libopencm3 project.
+##
+## Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+## Copyright (C) 2010 Piotr Esden-Tempski <piotr@esden.net>
+## Copyright (C) 2011 Fergus Noble <fergusnoble@gmail.com>
+##
+## This library is free software: you can redistribute it and/or modify
+## it under the terms of the GNU Lesser General Public License as published by
+## the Free Software Foundation, either version 3 of the License, or
+## (at your option) any later version.
+##
+## This library is distributed in the hope that it will be useful,
+## but WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+## GNU Lesser General Public License for more details.
+##
+## You should have received a copy of the GNU Lesser General Public License
+## along with this library.  If not, see <http://www.gnu.org/licenses/>.
+##
+
+PREFIX	?= arm-none-eabi
+# PREFIX		?= arm-elf
+CC		= $(PREFIX)-gcc
+LD		= $(PREFIX)-gcc
+OBJCOPY		= $(PREFIX)-objcopy
+OBJDUMP		= $(PREFIX)-objdump
+GDB		= $(PREFIX)-gdb
+FLASH		= $(shell which st-flash)
+
+TOOLCHAIN_DIR ?= ../../../../../libopencm3
+ifeq ($(wildcard ../../../../../libopencm3/lib/libopencm3_stm32f3.a),)
+ifneq ($(strip $(shell which $(CC))),)
+TOOLCHAIN_DIR := $(shell dirname `which $(CC)`)/../$(PREFIX)
+endif
+else
+ifeq ($(V),1)
+$(info We seem to be building the example in the source directory. Using local library!)
+endif
+endif
+
+CFLAGS		+= -Os -g -Wall -Wextra -I$(TOOLCHAIN_DIR)/include \
+		   -fno-common -mcpu=cortex-m4 -mthumb \
+		   -mfloat-abi=hard -mfpu=fpv4-sp-d16 -MD -DSTM32F3
+LDSCRIPT	?= $(BINARY).ld
+LDFLAGS		+= --static -lc -lnosys -L$(TOOLCHAIN_DIR)/lib \
+			 -L$(TOOLCHAIN_DIR)/lib/stm32/f3 \
+		   -T$(LDSCRIPT) -nostartfiles -Wl,--gc-sections \
+		   -mthumb -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16
+OBJS		+= $(BINARY).o
+
+OOCD		?= openocd
+OOCD_INTERFACE	?= stlink-v2
+OOCD_BOARD	?= stm32f3discovery
+# Black magic probe specific variables
+# Set the BMP_PORT to a serial port and then BMP is used for flashing
+BMP_PORT        ?=
+
+# Be silent per default, but 'make V=1' will show all compiler calls.
+ifneq ($(V),1)
+Q := @
+NULL := 2>/dev/null
+else
+LDFLAGS += -Wl,--print-gc-sections
+endif
+
+.SUFFIXES: .elf .bin .hex .srec .list .images
+.SECONDEXPANSION:
+.SECONDARY:
+
+all: images
+
+images: $(BINARY).images
+flash: $(BINARY).stlink-flash
+
+%.images: %.bin %.hex %.srec %.list
+	@#echo "*** $* images generated ***"
+
+%.bin: %.elf
+	@#printf "  OBJCOPY $(*).bin\n"
+	$(Q)$(OBJCOPY) -Obinary $(*).elf $(*).bin
+
+%.hex: %.elf
+	@#printf "  OBJCOPY $(*).hex\n"
+	$(Q)$(OBJCOPY) -Oihex $(*).elf $(*).hex
+
+%.srec: %.elf
+	@#printf "  OBJCOPY $(*).srec\n"
+	$(Q)$(OBJCOPY) -Osrec $(*).elf $(*).srec
+
+%.list: %.elf
+	@#printf "  OBJDUMP $(*).list\n"
+	$(Q)$(OBJDUMP) -S $(*).elf > $(*).list
+
+%.elf: $(OBJS) $(LDSCRIPT) $(TOOLCHAIN_DIR)/lib/libopencm3_stm32f3.a
+	@#printf "  LD      $(subst $(shell pwd)/,,$(@))\n"
+	$(Q)$(LD) -o $(*).elf $(OBJS) -lopencm3_stm32f3 $(LDFLAGS)
+
+%.o: %.c Makefile
+	@#printf "  CC      $(subst $(shell pwd)/,,$(@))\n"
+	$(Q)$(CC) $(CFLAGS) -o $@ -c $<
+
+clean:
+	$(Q)rm -f *.o
+	$(Q)rm -f *.d
+	$(Q)rm -f *.elf
+	$(Q)rm -f *.bin
+	$(Q)rm -f *.hex
+	$(Q)rm -f *.srec
+	$(Q)rm -f *.list
+
+%.stlink-flash: %.bin
+	@printf "  FLASH  $<\n"
+	$(Q)$(FLASH) write $(*).bin 0x8000000
+
+	
+ifeq ($(BMP_PORT),)
+ifeq ($(OOCD_SERIAL),)
+%.flash: %.hex
+	@printf "  FLASH   $<\n"
+	@# IMPORTANT: Don't use "resume", only "reset" will work correctly!
+	$(Q)$(OOCD) -s ${HOME}/local/share/openocd/scripts \
+		     -f interface/$(OOCD_INTERFACE).cfg \
+		    -f board/$(OOCD_BOARD).cfg \
+		    -c "init" -c "reset init" \
+		    -c "flash write_image erase $(*).hex" \
+		    -c "reset" \
+		    -c "shutdown" $(NULL)
+else
+%.flash: %.hex
+	@printf "  FLASH   $<\n"
+	@# IMPORTANT: Don't use "resume", only "reset" will work correctly!
+	$(Q)$(OOCD) -f interface/$(OOCD_INTERFACE).cfg \
+		    -f board/$(OOCD_BOARD).cfg \
+		    -c "ft2232_serial $(OOCD_SERIAL)" \
+		    -c "init" -c "reset init" \
+		    -c "stm32x mass_erase 0" \
+		    -c "flash write_image $(*).hex" \
+		    -c "reset" \
+		    -c "shutdown" $(NULL)
+endif
+else
+%.flash: %.elf
+	@echo "  GDB   $(*).elf (flash)"
+	$(Q)$(GDB) --batch \
+		   -ex 'target extended-remote $(BMP_PORT)' \
+		   -x $(TOOLCHAIN_DIR)/scripts/black_magic_probe_flash.scr \
+		   $(*).elf
+endif
+
+.PHONY: images clean
+
+-include $(OBJS:.o=.d)
+
--- a/examples/stm32/f3/stm32f3-discovery/adc/Makefile
+++ b/examples/stm32/f3/stm32f3-discovery/adc/Makefile
@@ -0,0 +1,24 @@
+##
+## This file is part of the libopencm3 project.
+##
+## Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+##
+## This library is free software: you can redistribute it and/or modify
+## it under the terms of the GNU Lesser General Public License as published by
+## the Free Software Foundation, either version 3 of the License, or
+## (at your option) any later version.
+##
+## This library is distributed in the hope that it will be useful,
+## but WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+## GNU Lesser General Public License for more details.
+##
+## You should have received a copy of the GNU Lesser General Public License
+## along with this library.  If not, see <http://www.gnu.org/licenses/>.
+##
+
+BINARY = adc
+
+LDSCRIPT = ../stm32f3-discovery.ld
+
+include ../../Makefile.include
--- a/examples/stm32/f3/stm32f3-discovery/adc/README
+++ b/examples/stm32/f3/stm32f3-discovery/adc/README
@@ -0,0 +1,9 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This is the smallest-possible example program using libopencm3.
+
+It's intended for the ST STM32F3DISCOVERY eval board. It should read from the ADC1_IN1 (PA0) pin its voltage and print it in the LEDs.
+
+
--- a/examples/stm32/f3/stm32f3-discovery/adc/adc.c
+++ b/examples/stm32/f3/stm32f3-discovery/adc/adc.c
@@ -0,0 +1,207 @@
+/*
+ * This file is part of the libopencm3 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+ * Copyright (C) 2011 Stephen Caudle <scaudle@doceme.com>
+ * Modified by Fernando Cortes <fermando.corcam@gmail.com>
+ * modified by Guillermo Rivera <memogrg@gmail.com>
+ *
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <libopencm3/stm32/f3/rcc.h>
+#include <libopencm3/stm32/f3/adc.h>
+#include <libopencm3/stm32/f3/usart.h>
+#include <libopencm3/stm32/gpio.h>
+
+#define LBLUE GPIOE, GPIO8
+#define LRED GPIOE, GPIO9
+#define LORANGE GPIOE, GPIO10
+#define LGREEN GPIOE, GPIO11
+#define LBLUE2 GPIOE, GPIO12
+#define LRED2 GPIOE, GPIO13
+#define LORANGE2 GPIOE, GPIO14
+#define LGREEN2 GPIOE, GPIO15
+
+#define LD4 GPIOE, GPIO8
+#define LD3 GPIOE, GPIO9
+#define LD5 GPIOE, GPIO10
+#define LD7 GPIOE, GPIO11
+#define LD9 GPIOE, GPIO12
+#define LD10 GPIOE, GPIO13
+#define LD8 GPIOE, GPIO14
+#define LD6 GPIOE, GPIO15
+
+
+void adc_setup(void) {
+	//ADC
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_ADC12EN);
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPAEN);
+	//ADC
+	gpio_mode_setup(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO0);
+	gpio_mode_setup(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO1);
+	adc_off(ADC1);
+	adc_set_clk_prescale(ADC_CCR_CKMODE_DIV2);
+        adc_set_single_conversion_mode(ADC1);
+        adc_disable_external_trigger_regular(ADC1);
+        adc_set_right_aligned(ADC1);
+        /* We want to read the temperature sensor, so we have to enable it. */
+        adc_enable_temperature_sensor();
+        adc_set_sample_time_on_all_channels(ADC1, ADC_SMPR1_SMP_61DOT5CYC);
+	uint8_t channel_array[16];
+	channel_array[0]=16; // Vts (Internal temperature sensor
+	channel_array[0]=1; //ADC1_IN1 (PA0)
+	adc_set_regular_sequence(ADC1, 1, channel_array);
+	adc_set_resolution(ADC1, ADC_CFGR_RES_12_BIT);
+        adc_power_on(ADC1);
+
+        /* Wait for ADC starting up. */
+	int i;
+        for (i = 0; i < 800000; i++)    /* Wait a bit. */
+                __asm__("nop");
+
+}
+
+void usart_setup(void) {
+  /* Enable clocks for GPIO port A (for GPIO_USART2_TX) and USART2. */
+  rcc_peripheral_enable_clock(&RCC_APB1ENR, RCC_APB1ENR_USART2EN);
+  rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPAEN);
+
+  /* Setup GPIO pin GPIO_USART2_TX/GPIO9 on GPIO port A for transmit. */
+  gpio_mode_setup(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO2 | GPIO3);
+  gpio_set_af(GPIOA, GPIO_AF7, GPIO2| GPIO3);
+
+  /* Setup UART parameters. */
+  usart_set_baudrate(USART2, 115200);
+  usart_set_databits(USART2, 8);
+  usart_set_stopbits(USART2, USART_STOPBITS_1);
+  usart_set_mode(USART2, USART_MODE_TX_RX);
+  usart_set_parity(USART2, USART_PARITY_NONE);
+  usart_set_flow_control(USART2, USART_FLOWCONTROL_NONE);
+  
+  /* Finally enable the USART. */
+  usart_enable(USART2);
+}
+
+void gpio_setup(void)
+{
+	/* Enable GPIOE clock. */
+	/* Manually: */
+	// RCC_AHB1ENR |= RCC_AHB1ENR_IOPDEN;
+	/* Using API functions: */
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPEEN);
+
+
+	/* Set GPIO12 (in GPIO port E) to 'output push-pull'. */
+	/* Manually: */
+	//GPIOE_CRH = (GPIO_CNF_OUTPUT_PUSHPULL << (((8 - 8) * 4) + 2));
+	//GPIOE_CRH |= (GPIO_MODE_OUTPUT_2_MHZ << ((8 - 8) * 4));
+	/* Using API functions: */
+	gpio_mode_setup(GPIOE, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO8| GPIO9| GPIO10| GPIO11| GPIO12| GPIO13| GPIO14| GPIO15);
+}
+
+void my_usart_print_int(uint32_t usart, int value)
+{
+        uint8_t i;
+        uint8_t nr_digits = 0;
+        char buffer[25];
+
+        if (value < 0) {
+                usart_send_blocking(usart, '-');
+                value = value * -1;
+        }
+
+        while (value > 0) {
+                buffer[nr_digits++] = "0123456789"[value % 10];
+                value /= 10;
+        }
+
+        for (i = nr_digits; i >= 0; i--) {
+                usart_send_blocking(usart, buffer[i]);
+        }
+
+        usart_send_blocking(usart, '\r');
+        usart_send_blocking(usart, '\n');
+}
+
+void clock_setup(void) {
+  /*
+  rcc_set_sysclk_source(RCC_CFGR_SW_HSI); //se cayo
+  rcc_wait_for_sysclk_status(HSI);
+  rcc_osc_off(PLL);
+  rcc_wait_for_osc_not_ready(PLL);
+  rcc_set_pll_source(RCC_CFGR_PLLSRC_HSI_DIV2);
+  rcc_set_main_pll_hsi(RCC_CFGR_PLLMUL_PLL_IN_CLK_X11);
+  rcc_osc_on(PLL);
+  rcc_wait_for_osc_ready(PLL);
+  rcc_set_hpre(RCC_CFGR_HPRE_DIV_NONE);
+  rcc_set_ppre2(RCC_CFGR_PPRE2_DIV_NONE);
+  rcc_set_ppre1(RCC_CFGR_PPRE1_DIV_2);
+  rcc_set_sysclk_source(RCC_CFGR_SW_PLL); //se cayo
+  rcc_wait_for_sysclk_status(PLL);
+  */
+  //rcc_clock_setup_hsi(&hsi_8mhz[CLOCK_44MHZ]);
+  rcc_clock_setup_hsi(&hsi_8mhz[CLOCK_64MHZ]);
+}
+
+int main(void)
+{
+	int i, j;
+       	uint16_t temp, inc=0;
+
+	clock_setup();
+	gpio_setup();
+	adc_setup();
+	usart_setup();
+
+	/* Blink the LED (PC8) on the board. */
+	while (1) {
+	  /* Manually: */
+	  // GPIOD_BSRR = GPIO12;		/* LED off */
+	  // for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+	  // 	__asm__("nop");
+	  // GPIOD_BRR = GPIO9;		/* LED on */
+	  // for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+	  // 	__asm__("nop");
+
+	  /* Using API functions gpio_set()/gpio_clear(): */
+	  //gpio_set(GPIOE, GPIO9);	/* LED off */
+	  // for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+	  // 	__asm__("nop");
+	  //gpio_clear(GPIOE, GPIO9);	/* LED on */
+	  // for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+	  // 	__asm__("nop");
+
+	  /* Using API function gpio_toggle(): */
+	  gpio_toggle(LRED);
+	  for (i = 0; i < 200000; i++) /* Wait a bit. */
+	    __asm__("nop");
+	  gpio_toggle(LRED);
+	  for (i = 0; i < 200000; i++) /* Wait a bit. */
+	    __asm__("nop");
+	  adc_start_conversion_regular(ADC1);
+	  while (!(adc_eoc(ADC1)));
+	  temp=adc_read_regular(ADC1);
+	  gpio_port_write(GPIOE, temp << 4);
+	  my_usart_print_int(USART2, temp);
+	  //usart_send_blocking(USART2, 'a');
+	  //usart_send_blocking(USART2, '\r');
+	  //usart_send_blocking(USART2, '\n');
+
+	  inc++;
+	}
+
+	return 0;
+}
+
--- a/examples/stm32/f3/stm32f3-discovery/button/Makefile
+++ b/examples/stm32/f3/stm32f3-discovery/button/Makefile
@@ -0,0 +1,25 @@
+##
+## This file is part of the libopencm3 project.
+##
+## Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+##
+## This library is free software: you can redistribute it and/or modify
+## it under the terms of the GNU Lesser General Public License as published by
+## the Free Software Foundation, either version 3 of the License, or
+## (at your option) any later version.
+##
+## This library is distributed in the hope that it will be useful,
+## but WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+## GNU Lesser General Public License for more details.
+##
+## You should have received a copy of the GNU Lesser General Public License
+## along with this library.  If not, see <http://www.gnu.org/licenses/>.
+##
+
+BINARY = button
+
+LDSCRIPT = ../stm32f3-discovery.ld
+
+include ../../Makefile.include
+
--- a/examples/stm32/f3/stm32f3-discovery/button/README
+++ b/examples/stm32/f3/stm32f3-discovery/button/README
@@ -0,0 +1,8 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This example blinks the green LED on the ST STM32F3DISCOVERY eval board.
+
+When you press the 'USER' button, the blinking is slower.
+
--- a/examples/stm32/f3/stm32f3-discovery/button/button.c
+++ b/examples/stm32/f3/stm32f3-discovery/button/button.c
@@ -0,0 +1,78 @@
+/*
+ * This file is part of the libopencm3 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>,
+ * Copyright (C) 2010 Piotr Esden-Tempski <piotr@esden.net>
+ * Copyright (C) 2011 Stephen Caudle <scaudle@doceme.com>
+ * Modified by Fernando Cortes <fermando.corcam@gmail.com>
+ * modified by Guillermo Rivera <memogrg@gmail.com>
+ *
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <libopencm3/stm32/rcc.h>
+#include <libopencm3/stm32/gpio.h>
+
+uint16_t exti_line_state;
+
+/* Set STM32 to 64 MHz. */
+void clock_setup(void)
+{
+	rcc_clock_setup_hsi(&hsi_8mhz[CLOCK_64MHZ]);
+}
+
+void gpio_setup(void)
+{
+	/* Enable GPIOD clock. */
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPEEN);
+
+	/* Set GPIO12 (in GPIO port D) to 'output push-pull'. */
+	gpio_mode_setup(GPIOE, GPIO_MODE_OUTPUT,
+			GPIO_PUPD_NONE, GPIO8 | GPIO9 | GPIO10 | GPIO11);
+}
+
+void button_setup(void)
+{
+	/* Enable GPIOA clock. */
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPAEN);
+
+	/* Set GPIO0 (in GPIO port A) to 'input open-drain'. */
+	gpio_mode_setup(GPIOA, GPIO_MODE_INPUT, GPIO_PUPD_NONE, GPIO0);
+}
+
+int main(void)
+{
+	int i;
+
+	clock_setup();
+	button_setup();
+	gpio_setup();
+
+	/* Blink the LED (PD12) on the board. */
+	while (1) {
+		gpio_toggle(GPIOE, GPIO11);
+
+		/* Upon button press, blink more slowly. */
+		exti_line_state = GPIOA_IDR;
+		if ((exti_line_state & (1 << 0)) != 0) {
+			for (i = 0; i < 3000000; i++)	/* Wait a bit. */
+				__asm__("nop");
+		}
+
+		for (i = 0; i < 1000000; i++)		/* Wait a bit. */
+			__asm__("nop");
+	}
+
+	return 0;
+}
--- a/examples/stm32/f3/stm32f3-discovery/fancyblink/Makefile
+++ b/examples/stm32/f3/stm32f3-discovery/fancyblink/Makefile
@@ -0,0 +1,25 @@
+##
+## This file is part of the libopencm3 project.
+##
+## Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+##
+## This library is free software: you can redistribute it and/or modify
+## it under the terms of the GNU Lesser General Public License as published by
+## the Free Software Foundation, either version 3 of the License, or
+## (at your option) any later version.
+##
+## This library is distributed in the hope that it will be useful,
+## but WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+## GNU Lesser General Public License for more details.
+##
+## You should have received a copy of the GNU Lesser General Public License
+## along with this library.  If not, see <http://www.gnu.org/licenses/>.
+##
+
+BINARY = fancyblink
+
+LDSCRIPT = ../stm32f3-discovery.ld
+
+include ../../Makefile.include
+
--- a/examples/stm32/f3/stm32f3-discovery/fancyblink/README
+++ b/examples/stm32/f3/stm32f3-discovery/fancyblink/README
@@ -0,0 +1,9 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This is the smallest-possible example program using libopencm3.
+
+It's intended for the ST STM32F3DISCOVERY eval board. It should blink
+the LEDs on the board.
+
--- a/examples/stm32/f3/stm32f3-discovery/fancyblink/fancyblink.c
+++ b/examples/stm32/f3/stm32f3-discovery/fancyblink/fancyblink.c
@@ -0,0 +1,60 @@
+/*
+ * This file is part of the libopencm3 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+ * Copyright (C) 2011 Damjan Marion <damjan.marion@gmail.com>
+ * Copyright (C) 2011 Mark Panajotovic <marko@electrontube.org>
+ *
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <libopencm3/stm32/f3/rcc.h>
+#include <libopencm3/stm32/gpio.h>
+
+/* Set STM32 to 64 MHz. */
+void clock_setup(void)
+{
+	rcc_clock_setup_hsi(&hsi_8mhz[CLOCK_64MHZ]);
+
+	/* Enable GPIOE clock. */
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPEEN);
+}
+
+void gpio_setup(void)
+{
+	/* Set GPIO8-11 (in GPIO port E) to 'output push-pull'. */
+	gpio_mode_setup(GPIOE, GPIO_MODE_OUTPUT,
+			GPIO_PUPD_NONE, GPIO8 | GPIO9 | GPIO10 | GPIO11);
+}
+
+int main(void)
+{
+	int i;
+
+	clock_setup();
+	gpio_setup();
+
+	/* Set two LEDs for wigwag effect when toggling. */
+	gpio_set(GPIOE, GPIO8 | GPIO10);
+
+	/* Blink the LEDs (PD8, PD9, PD10 and PD11) on the board. */
+	while (1) {
+		/* Toggle LEDs. */
+		gpio_toggle(GPIOE, GPIO8 | GPIO9 | GPIO10 | GPIO11);
+		for (i = 0; i < 1000000; i++) /* Wait a bit. */
+			__asm__("nop");
+	}
+
+	return 0;
+}
--- a/examples/stm32/f3/stm32f3-discovery/miniblink/Makefile
+++ b/examples/stm32/f3/stm32f3-discovery/miniblink/Makefile
@@ -0,0 +1,25 @@
+##
+## This file is part of the libopencm3 project.
+##
+## Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+##
+## This library is free software: you can redistribute it and/or modify
+## it under the terms of the GNU Lesser General Public License as published by
+## the Free Software Foundation, either version 3 of the License, or
+## (at your option) any later version.
+##
+## This library is distributed in the hope that it will be useful,
+## but WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+## GNU Lesser General Public License for more details.
+##
+## You should have received a copy of the GNU Lesser General Public License
+## along with this library.  If not, see <http://www.gnu.org/licenses/>.
+##
+
+BINARY = miniblink
+
+LDSCRIPT = ../stm32f3-discovery.ld
+
+include ../../Makefile.include
+
--- a/examples/stm32/f3/stm32f3-discovery/miniblink/README
+++ b/examples/stm32/f3/stm32f3-discovery/miniblink/README
@@ -0,0 +1,9 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This is the smallest-possible example program using libopencm3.
+
+It's intended for the ST STM32F3DISCOVERY eval board. It should blink
+the blue LED on the board.
+
--- a/examples/stm32/f3/stm32f3-discovery/miniblink/miniblink.c
+++ b/examples/stm32/f3/stm32f3-discovery/miniblink/miniblink.c
@@ -0,0 +1,74 @@
+/*
+ * This file is part of the libopencm3 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+ * Copyright (C) 2011 Stephen Caudle <scaudle@doceme.com>
+ * Modified by Fernando Cortes <fermando.corcam@gmail.com>
+ * modified by Guillermo Rivera <memogrg@gmail.com>
+ *
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <libopencm3/stm32/f3/rcc.h>
+#include <libopencm3/stm32/gpio.h>
+
+void gpio_setup(void)
+{
+	/* Enable GPIOE clock. */
+	/* Manually: */
+	// RCC_AHB1ENR |= RCC_AHB1ENR_IOPDEN;
+	/* Using API functions: */
+	rcc_peripheral_enable_clock(&RCC_AHBENR, RCC_AHBENR_IOPEEN);
+
+	/* Set GPIO12 (in GPIO port E) to 'output push-pull'. */
+	/* Manually: */
+	//GPIOE_CRH = (GPIO_CNF_OUTPUT_PUSHPULL << (((8 - 8) * 4) + 2));
+	//GPIOE_CRH |= (GPIO_MODE_OUTPUT_2_MHZ << ((8 - 8) * 4));
+	/* Using API functions: */
+	gpio_mode_setup(GPIOE, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO12);
+}
+
+int main(void)
+{
+	int i, j;
+
+	gpio_setup();
+
+	/* Blink the LED (PC8) on the board. */
+	while (1) {
+		/* Manually: */
+		// GPIOD_BSRR = GPIO12;		/* LED off */
+		// for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+		// 	__asm__("nop");
+		// GPIOD_BRR = GPIO9;		/* LED on */
+		// for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+		// 	__asm__("nop");
+
+		/* Using API functions gpio_set()/gpio_clear(): */
+		//gpio_set(GPIOE, GPIO9);	/* LED off */
+		// for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+		// 	__asm__("nop");
+		//gpio_clear(GPIOE, GPIO9);	/* LED on */
+		// for (i = 0; i < 1000000; i++)	/* Wait a bit. */
+		// 	__asm__("nop");
+
+		/* Using API function gpio_toggle(): */
+		gpio_toggle(GPIOE, GPIO12);	/* LED on/off */
+		for (i = 0; i < 2000000; i++) /* Wait a bit. */
+			__asm__("nop");
+
+	}
+
+	return 0;
+}
--- a/examples/stm32/f3/stm32f3-discovery/stm32f3-discovery.ld
+++ b/examples/stm32/f3/stm32f3-discovery/stm32f3-discovery.ld
@@ -0,0 +1,32 @@
+/*
+ * This file is part of the libopencm3 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+ * Copyright (C) 2011 Stephen Caudle <scaudle@doceme.com>
+ *
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/* Linker script for ST STM32F4DISCOVERY (STM32F407VG, 1024K flash, 128K RAM). */
+
+/* Define memory regions. */
+MEMORY
+{
+	rom (rx) : ORIGIN = 0x08000000, LENGTH = 256K
+	ram (rwx) : ORIGIN = 0x20000000, LENGTH = 20K
+}
+
+/* Include the common ld script. */
+INCLUDE libopencm3_stm32f3.ld
+