From db0e59da962e53ba84b961a1b3d5e6a3badb2726 Mon Sep 17 00:00:00 2001 From: Uwe Hermann Date: Mon, 20 Jul 2009 15:35:12 +0200 Subject: Rename example subdir to examples, we'll have more than one. --- examples/Makefile | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ examples/README | 47 ++++++++++++++++++++++++++++++ examples/blink.c | 62 ++++++++++++++++++++++++++++++++++++++++ examples/blink.ld | 57 +++++++++++++++++++++++++++++++++++++ 4 files changed, 251 insertions(+) create mode 100644 examples/Makefile create mode 100644 examples/README create mode 100644 examples/blink.c create mode 100644 examples/blink.ld (limited to 'examples') 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 +## +## 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 . +## + +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 + * + * 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 . + */ + +#include + +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 + * + * 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 . + */ + +/* 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.*) + } +} -- cgit v1.2.3