aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--examples/Makefile10
-rw-r--r--examples/fancyblink/Makefile85
-rw-r--r--examples/fancyblink/README48
-rw-r--r--examples/fancyblink/fancyblink.c45
-rw-r--r--examples/fancyblink/fancyblink.ld49
5 files changed, 235 insertions, 2 deletions
diff --git a/examples/Makefile b/examples/Makefile
index 0521770..59f9ae4 100644
--- a/examples/Makefile
+++ b/examples/Makefile
@@ -25,15 +25,21 @@ ifneq ($(V),1)
Q := @
endif
-all: miniblink
+all: miniblink fancyblink
miniblink:
@printf " BUILD miniblink\n"
$(Q)$(MAKE) -C miniblink
+fancyblink:
+ @printf " BUILD fancyblink\n"
+ $(Q)$(MAKE) -C fancyblink
+
clean:
@printf " CLEAN miniblink\n"
$(Q)$(MAKE) -C miniblink clean
+ @printf " CLEAN fancyblink\n"
+ $(Q)$(MAKE) -C fancyblink clean
-.PHONY: miniblink clean
+.PHONY: miniblink fancyblink clean
diff --git a/examples/fancyblink/Makefile b/examples/fancyblink/Makefile
new file mode 100644
index 0000000..b2790f6
--- /dev/null
+++ b/examples/fancyblink/Makefile
@@ -0,0 +1,85 @@
+##
+## This file is part of the libopenstm32 project.
+##
+## Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+##
+## This program is free software: you can redistribute it and/or modify
+## it under the terms of the GNU General Public License as published by
+## the Free Software Foundation, either version 3 of the License, or
+## (at your option) any later version.
+##
+## This program 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 General Public License for more details.
+##
+## You should have received a copy of the GNU General Public License
+## along with this program. If not, see <http://www.gnu.org/licenses/>.
+##
+
+BINARY = fancyblink
+
+# PREFIX ?= arm-none-eabi
+PREFIX ?= arm-elf
+CC = $(PREFIX)-gcc
+LD = $(PREFIX)-ld
+OBJCOPY = $(PREFIX)-objcopy
+OBJDUMP = $(PREFIX)-objdump
+CFLAGS = -O0 -g -Wall -Wextra -I../../include -fno-common \
+ -mcpu=cortex-m3 -mthumb
+LDFLAGS = -L../../lib -T$(BINARY).ld -nostartfiles
+OBJS = $(BINARY).o
+OPENOCD = openocd
+
+# Be silent per default, but 'make V=1' will show all compiler calls.
+ifneq ($(V),1)
+Q := @
+NULL := 2>/dev/null
+endif
+
+all: images
+
+images: $(BINARY)
+ @printf " OBJCOPY $(BINARY).bin\n"
+ $(Q)$(OBJCOPY) -Obinary $(BINARY) $(BINARY).bin
+ @printf " OBJCOPY $(BINARY).hex\n"
+ $(Q)$(OBJCOPY) -Oihex $(BINARY) $(BINARY).hex
+ @printf " OBJCOPY $(BINARY).srec\n"
+ $(Q)$(OBJCOPY) -Osrec $(BINARY) $(BINARY).srec
+ @printf " OBJDUMP $(BINARY).list\n"
+ $(Q)$(OBJDUMP) -S $(BINARY) > $(BINARY).list
+
+$(BINARY): $(OBJS) $(BINARY).ld
+ @printf " LD $(subst $(shell pwd)/,,$(@))\n"
+ $(Q)$(LD) $(LDFLAGS) -o $(BINARY) $(OBJS) -lopenstm32
+
+%.o: %.c Makefile
+ @printf " CC $(subst $(shell pwd)/,,$(@))\n"
+ $(Q)$(CC) $(CFLAGS) -o $@ -c $<
+
+clean:
+ @printf " CLEAN $(subst $(shell pwd)/,,$(OBJS))\n"
+ $(Q)rm -f *.o
+ @printf " CLEAN $(BINARY)\n"
+ $(Q)rm -f $(BINARY)
+ @printf " CLEAN $(BINARY).bin\n"
+ $(Q)rm -f $(BINARY).bin
+ @printf " CLEAN $(BINARY).hex\n"
+ $(Q)rm -f $(BINARY).hex
+ @printf " CLEAN $(BINARY).srec\n"
+ $(Q)rm -f $(BINARY).srec
+ @printf " CLEAN $(BINARY).list\n"
+ $(Q)rm -f $(BINARY).list
+
+flash: images
+ @printf " FLASH $(BINARY).bin\n"
+ @# IMPORTANT: Don't use "resume", only "reset" will work correctly!
+ $(Q)$(OPENOCD) -f interface/jtagkey-tiny.cfg \
+ -f board/olimex_stm32_h103.cfg \
+ -c "init" -c "reset halt" \
+ -c "flash write_image erase $(BINARY).bin 0x08000000" \
+ -c "reset" \
+ -c "shutdown" $(NULL)
+
+.PHONY: images clean
+
diff --git a/examples/fancyblink/README b/examples/fancyblink/README
new file mode 100644
index 0000000..f537497
--- /dev/null
+++ b/examples/fancyblink/README
@@ -0,0 +1,48 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This is the smallest-possible example program using libopenstm32.
+
+It's intended for the ST STM32-based Olimex STM32-H103 eval board (see
+http://olimex.com/dev/stm32-h103.html for details). It should blink
+the LED on the board.
+
+
+Building
+--------
+
+ $ make
+
+Running 'make' on the top-level libopenstm32 directory will automatically
+also build this example. Or you can build the library "manually" and
+then run 'make' in this directory.
+
+You may want to override the toolchain (e.g., arm-elf or arm-none-eabi):
+
+ $ PREFIX=arm-none-eabi make
+
+For a more verbose build you can use
+
+ $ make V=1
+
+
+Flashing
+--------
+
+You can flash the generated code on the STM32-H103 board using OpenOCD:
+
+ $ make flash
+
+Or you can do the same manually via:
+
+ $ openocd -f interface/jtagkey-tiny.cfg -f board/olimex_stm32_h103.cfg
+ $ telnet localhost 4444
+ > init
+ > reset halt
+ > flash write_image erase fancyblink.bin 0x08000000
+ > resume 0x08000000
+
+Replace the "jtagkey-tiny.cfg" with whatever JTAG device you are using, and/or
+replace "olimex_stm32_h103.cfg" with your respective board config file.
+
diff --git a/examples/fancyblink/fancyblink.c b/examples/fancyblink/fancyblink.c
new file mode 100644
index 0000000..bf8470f
--- /dev/null
+++ b/examples/fancyblink/fancyblink.c
@@ -0,0 +1,45 @@
+/*
+ * This file is part of the libopenstm32 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <libopenstm32.h>
+
+int main(void)
+{
+ int i;
+
+ /* Enable GPIOC clock. */
+ rcc_enable_peripheral_clock(&RCC_APB2ENR, IOPCEN);
+
+ /* Set GPIO12 (in GPIO port C) to 'output push-pull'. */
+ gpio_set_mode(GPIOC, GPIO_MODE_OUTPUT_2_MHZ,
+ GPIO_CNF_OUTPUT_PUSHPULL, GPIO12);
+
+ /* Blink the LED (PC12) on the board. */
+ while (1) {
+ gpio_toggle(GPIOC, GPIO12); /* LED on/off */
+ for (i = 0; i < 80000; i++); /* Wait (needs -O0 CFLAGS). */
+ }
+
+ return 0;
+}
+
+u32 *vector_table[2] __attribute__ ((section(".vectors"))) = {
+ (u32 *)0x20000800, /* Use 2 KB stack (0x800 bytes). */
+ (u32 *)main, /* Use main() as reset vector for now. */
+};
diff --git a/examples/fancyblink/fancyblink.ld b/examples/fancyblink/fancyblink.ld
new file mode 100644
index 0000000..2d819a7
--- /dev/null
+++ b/examples/fancyblink/fancyblink.ld
@@ -0,0 +1,49 @@
+/*
+ * This file is part of the libopenstm32 project.
+ *
+ * Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/* Linker script for Olimex STM32-H103 (STM32F103RBT6, 128K flash, 20K RAM). */
+
+/* Define memory regions. */
+MEMORY
+{
+ rom (rx) : ORIGIN = 0x00000000, LENGTH = 128K
+ ram (rwx) : ORIGIN = 0x20000000, LENGTH = 20K
+}
+
+/* Define sections. */
+SECTIONS
+{
+ . = ORIGIN(rom);
+
+ .text : {
+ *(.vectors) /* Vector table */
+ *(.text) /* Program code */
+ *(.rodata) /* Read-only data */
+ } >rom
+
+ . = ORIGIN(ram);
+
+ .data : {
+ *(.data) /* Read-write initialized data */
+ } >ram AT >rom
+
+ .bss : {
+ *(.bss) /* Read-write zero initialized data */
+ } >ram AT >rom
+}