From d20c3454fa2b427b927cb45f4055015498f69823 Mon Sep 17 00:00:00 2001 From: Uwe Hermann Date: Sat, 25 Jul 2009 03:27:48 +0200 Subject: Add a simple USART example project which sends some bytes. --- examples/Makefile | 10 ++++- examples/usart/Makefile | 89 ++++++++++++++++++++++++++++++++++++++++++ examples/usart/README | 48 +++++++++++++++++++++++ examples/usart/usart.c | 101 ++++++++++++++++++++++++++++++++++++++++++++++++ examples/usart/usart.ld | 31 +++++++++++++++ 5 files changed, 277 insertions(+), 2 deletions(-) create mode 100644 examples/usart/Makefile create mode 100644 examples/usart/README create mode 100644 examples/usart/usart.c create mode 100644 examples/usart/usart.ld (limited to 'examples') diff --git a/examples/Makefile b/examples/Makefile index 59f9ae4..d0f25f3 100644 --- a/examples/Makefile +++ b/examples/Makefile @@ -25,7 +25,7 @@ ifneq ($(V),1) Q := @ endif -all: miniblink fancyblink +all: miniblink fancyblink usart miniblink: @printf " BUILD miniblink\n" @@ -35,11 +35,17 @@ fancyblink: @printf " BUILD fancyblink\n" $(Q)$(MAKE) -C fancyblink +usart: + @printf " BUILD usart\n" + $(Q)$(MAKE) -C usart + clean: @printf " CLEAN miniblink\n" $(Q)$(MAKE) -C miniblink clean @printf " CLEAN fancyblink\n" $(Q)$(MAKE) -C fancyblink clean + @printf " CLEAN usart\n" + $(Q)$(MAKE) -C usart clean -.PHONY: miniblink fancyblink clean +.PHONY: miniblink fancyblink usart clean diff --git a/examples/usart/Makefile b/examples/usart/Makefile new file mode 100644 index 0000000..ef32191 --- /dev/null +++ b/examples/usart/Makefile @@ -0,0 +1,89 @@ +## +## 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 = usart + +# PREFIX ?= arm-none-eabi +PREFIX ?= arm-elf +CC = $(PREFIX)-gcc +LD = $(PREFIX)-ld +OBJCOPY = $(PREFIX)-objcopy +OBJDUMP = $(PREFIX)-objdump +# Uncomment this line if you want to use the installed (not local) library. +# TOOLCHAIN_DIR = `dirname \`which $(CC)\``/../$(PREFIX) +TOOLCHAIN_DIR = ../.. +CFLAGS = -O0 -g -Wall -Wextra -I$(TOOLCHAIN_DIR)/include -fno-common \ + -mcpu=cortex-m3 -mthumb +LDSCRIPT = $(BINARY).ld +LDFLAGS = -L$(TOOLCHAIN_DIR)/lib -T$(LDSCRIPT) -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) $(LDSCRIPT) + @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/usart/README b/examples/usart/README new file mode 100644 index 0000000..59d1d89 --- /dev/null +++ b/examples/usart/README @@ -0,0 +1,48 @@ +------------------------------------------------------------------------------ +README +------------------------------------------------------------------------------ + +This example program sends some characters on USART3 on the ST STM32-based +Olimex STM32-H103 eval board (see http://olimex.com/dev/stm32-h103.html +for details). + +The terminal settings for the receiving device/PC are 38400 8n1. + + +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 usart.bin 0x08000000 + > reset + +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/usart/usart.c b/examples/usart/usart.c new file mode 100644 index 0000000..72dbd75 --- /dev/null +++ b/examples/usart/usart.c @@ -0,0 +1,101 @@ +/* + * 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 + +void clock_setup(void) +{ + /* Select HSI as SYSCLK source. */ + rcc_set_sysclk_source(SW_SYSCLKSEL_HSICLK); + + /* Set the PLL multiplication factor to 9. */ + rcc_set_pll_multiplication_factor(PLLMUL_PLL_CLK_MUL9); + + /* Select HSI/2 as PLL source. */ + rcc_set_pll_source(PLLSRC_HSI_CLK_DIV2); + + rcc_set_pllxtpre(PLLXTPRE_HSE_CLK_DIV2); + + /* Enable PLL oscillator and wait for it to stabilize. */ + rcc_osc_on(PLL); + rcc_wait_for_osc_ready(PLL); + + /* Select PLL as SYSCLK source. */ + rcc_set_sysclk_source(SW_SYSCLKSEL_PLLCLK); +} + +void usart_setup(void) +{ + /* Enable clocks for GPIO port B (for GPIO_USART_TX) and USART3. */ + rcc_enable_peripheral_clock(&RCC_APB2ENR, IOPBEN); + rcc_enable_peripheral_clock(&RCC_APB1ENR, USART3EN); + + /* Setup GPIO pin GPIO_USART_TX/GPIO10 on GPIO port B for transmit. */ + gpio_set_mode(GPIOB, GPIO_MODE_OUTPUT_50_MHZ, + GPIO_CNF_OUTPUT_ALTFN_PUSHPULL, GPIO_USART_TX); + + /* Setup UART parameters. */ + usart_set_baudrate(USART3, 38400); + usart_set_databits(USART3, 8); + usart_set_stopbits(USART3, STOPBITS_1); + usart_set_mode(USART3, MODE_TX); + usart_set_parity(USART3, PARITY_NONE); + usart_set_flow_control(USART3, FLOWCONTROL_NONE); + + /* Finally enable the USART. */ + usart_enable(USART3); +} + +void gpio_setup(void) +{ + /* 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); +} + +int main(void) +{ + int i, j = 0, c = 0; + + clock_setup(); + gpio_setup(); + usart_setup(); + + /* Blink the LED (PC12) on the board with every transmitted byte. */ + while (1) { + gpio_toggle(GPIOC, GPIO12); /* LED on/off */ + usart_send(USART3, c + '0'); /* Send one byte on USART3. */ + c = (c == 9) ? 0 : c + 1; /* Increment c. */ + if ((j++ % 80) == 0) { /* Newline after line full. */ + usart_send(USART3, '\r'); + usart_send(USART3, '\n'); + } + 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/usart/usart.ld b/examples/usart/usart.ld new file mode 100644 index 0000000..0445bab --- /dev/null +++ b/examples/usart/usart.ld @@ -0,0 +1,31 @@ +/* + * 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 +} + +/* Include the common ld script from libopenstm32. */ +INCLUDE libopenstm32.ld + -- cgit v1.2.3