aboutsummaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
Diffstat (limited to 'examples')
-rw-r--r--examples/Makefile85
-rw-r--r--examples/README47
-rw-r--r--examples/blink.c62
-rw-r--r--examples/blink.ld57
4 files changed, 251 insertions, 0 deletions
diff --git a/examples/Makefile b/examples/Makefile
new file mode 100644
index 0000000..8fe0077
--- /dev/null
+++ b/examples/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 = blink
+
+# 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/README b/examples/README
new file mode 100644
index 0000000..a46e75a
--- /dev/null
+++ b/examples/README
@@ -0,0 +1,47 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This is a small 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 blink.bin 0x08000000
+ > resume 0x08000000
+
+Replace the "jtagkey-tiny.cfg" with whatever JTAG device you are using.
+
diff --git a/examples/blink.c b/examples/blink.c
new file mode 100644
index 0000000..7c7da78
--- /dev/null
+++ b/examples/blink.c
@@ -0,0 +1,62 @@
+/*
+ * 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_APB2ENR = IOPCEN;
+
+ /* Set GPIO12 (in GPIO port C) to 'output push-pull'. */
+ /* Manually: */
+ // GPIOC_CRH = (GPIO_CNF_OUTPUT_PUSHPULL << (((12 - 8) * 4) + 2));
+ // GPIOC_CRH |= (GPIO_MODE_OUTPUT_2_MHZ << ((12 - 8) * 4));
+ /* Using API functions: */
+ gpio_set_mode(GPIOC, GPIO_MODE_OUTPUT_2_MHZ,
+ GPIO_CNF_OUTPUT_PUSHPULL, GPIO12);
+
+ /* Blink the LED (PC12) on the board. */
+ while (1) {
+ /* Manually: */
+ // GPIOC_BSRR = GPIO12; /* LED off */
+ // for (i = 0; i < 80000; i++); /* Wait (needs -O0 CFLAGS). */
+ // GPIOC_BRR = GPIO12; /* LED on */
+ // for (i = 0; i < 80000; i++); /* Wait (needs -O0 CFLAGS). */
+
+ /* Using API functions gpio_set()/gpio_clear(): */
+ // gpio_set(GPIOC, GPIO12); /* LED off */
+ // for (i = 0; i < 80000; i++); /* Wait (needs -O0 CFLAGS). */
+ // gpio_clear(GPIOC, GPIO12); /* LED on */
+ // for (i = 0; i < 80000; i++); /* Wait (needs -O0 CFLAGS). */
+
+ /* Using API function gpio_toggle(): */
+ 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/blink.ld b/examples/blink.ld
new file mode 100644
index 0000000..bfae3bd
--- /dev/null
+++ b/examples/blink.ld
@@ -0,0 +1,57 @@
+/*
+ * 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
+
+ /* Discard useless sections. */
+ /DISCARD/ : {
+ *(.comment)
+ *(.comment.*)
+ *(.note)
+ *(.note.*)
+ }
+}