aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Otto2010-03-28 15:52:49 +0200
committerThomas Otto2010-03-28 15:52:49 +0200
commit9dc0af94b064ad80b55433a1cdeb4ccf3db300ca (patch)
treeb88fee7ab35ef3d59689959e198d73b835a03815
parent97e27b2430a2ba2294c772408171c807520a070c (diff)
Added dma_mem2mem example.
-rw-r--r--examples/other/Makefile10
-rw-r--r--examples/other/dma_mem2mem/Makefile95
-rw-r--r--examples/other/dma_mem2mem/README48
-rw-r--r--examples/other/dma_mem2mem/dma.c174
-rw-r--r--examples/other/dma_mem2mem/dma.ld31
5 files changed, 356 insertions, 2 deletions
diff --git a/examples/other/Makefile b/examples/other/Makefile
index 4f2bcc9..f4b73a7 100644
--- a/examples/other/Makefile
+++ b/examples/other/Makefile
@@ -24,7 +24,7 @@ Q := @
MAKEFLAGS += --no-print-directory
endif
-all: i2c_stts75_sensor adc_temperature_sensor
+all: i2c_stts75_sensor adc_temperature_sensor dma_mem2mem
i2c_stts75_sensor:
@printf " BUILD examples/other/i2c_stts75_sensor\n"
@@ -34,11 +34,17 @@ adc_temperature_sensor:
@printf " BUILD examples/other/adc_temperature_sensor\n"
$(Q)$(MAKE) -C adc_temperature_sensor
+dma_mem2mem:
+ @printf " BUILD examples/other/dma_mem2mem\n"
+ $(Q)$(MAKE) -C dma_mem2mem
+
clean:
@printf " CLEAN examples/other/i2c_stts75_sensor\n"
$(Q)$(MAKE) -C i2c_stts75_sensor clean
@printf " CLEAN examples/other/adc_temperature_sensor\n"
$(Q)$(MAKE) -C adc_temperature_sensor clean
+ @printf " CLEAN examples/other/dma_mem2mem\n"
+ $(Q)$(MAKE) -C dma_mem2mem clean
-.PHONY: i2c_stts75_sensor adc_temperature_sensor clean
+.PHONY: i2c_stts75_sensor adc_temperature_sensor dma_mem2mem clean
diff --git a/examples/other/dma_mem2mem/Makefile b/examples/other/dma_mem2mem/Makefile
new file mode 100644
index 0000000..085aa60
--- /dev/null
+++ b/examples/other/dma_mem2mem/Makefile
@@ -0,0 +1,95 @@
+##
+## 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 = dma
+
+# 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)\``/..
+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_BASE = /usr
+OPENOCD = $(OPENOCD_BASE)/bin/openocd
+OPENOCD_SCRIPTS = $(OPENOCD_BASE)/share/openocd/scripts
+OPENOCD_FLASHER = $(OPENOCD_SCRIPTS)/interface/jtagkey.cfg
+OPENOCD_BOARD = $(OPENOCD_SCRIPTS)/target/stm32.cfg
+
+# 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) -s $(OPENOCD_SCRIPTS) \
+ -f $(OPENOCD_FLASHER) \
+ -f $(OPENOCD_BOARD) \
+ -c "init" -c "reset halt" \
+ -c "flash write_image erase $(BINARY).hex" \
+ -c "reset" \
+ -c "shutdown" $(NULL)
+
+.PHONY: images clean
+
diff --git a/examples/other/dma_mem2mem/README b/examples/other/dma_mem2mem/README
new file mode 100644
index 0000000..c680b84
--- /dev/null
+++ b/examples/other/dma_mem2mem/README
@@ -0,0 +1,48 @@
+------------------------------------------------------------------------------
+README
+------------------------------------------------------------------------------
+
+This program demonstrates a little DMA MEM2MEM transfer. A string is send out
+to USART1 and afterwards copied by DMA to another memory location. To check
+if the transfer was successful we send the destination string also out to
+USART1.
+
+The terminal settings for the receiving device/PC are 115200 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 using OpenOCD:
+
+ $ make flash
+
+Or you can do the same manually via:
+
+ $ openocd -f interface/jtagkey-tiny.cfg -f target/stm32.cfg
+ $ telnet localhost 4444
+ > reset halt
+ > flash write_image erase dma.hex
+ > reset
+
+Replace the "jtagkey-tiny.cfg" with whatever JTAG device you are using, and/or
+replace "stm.cfg" with your respective config file.
+
diff --git a/examples/other/dma_mem2mem/dma.c b/examples/other/dma_mem2mem/dma.c
new file mode 100644
index 0000000..98c360d
--- /dev/null
+++ b/examples/other/dma_mem2mem/dma.c
@@ -0,0 +1,174 @@
+/*
+ * This file is part of the libopenstm32 project.
+ *
+ * Copyright (C) 2010 Thomas Otto <tommi@viadmin.org>
+ *
+ * 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/rcc.h>
+#include <libopenstm32/flash.h>
+#include <libopenstm32/gpio.h>
+#include <libopenstm32/usart.h>
+#include <libopenstm32/dma.h>
+
+/* Set STM32 to 72 MHz. HSE 16MHz */
+void clock_setup(void)
+{
+ /* enable Internal High Speed Oscillator */
+ rcc_osc_on(HSI);
+ rcc_wait_for_osc_ready(HSI);
+
+ /* Select HSI as SYSCLK source. */
+ rcc_set_sysclk_source(SW_SYSCLKSEL_HSICLK);
+
+ /* enable External High Speed Oscillator 16MHz */
+ rcc_osc_on(HSE);
+ rcc_wait_for_osc_ready(HSE);
+ rcc_set_sysclk_source(SW_SYSCLKSEL_HSECLK);
+
+ /* set prescalers for ADC, ABP1, ABP2... make this before touching the PLL */
+ rcc_set_hpre(HPRE_SYSCLK_NODIV); //prescales the AHB clock from the SYSCLK
+ rcc_set_adcpre(ADCPRE_PLCK2_DIV6); //prescales the ADC from the APB2 clock; max 14MHz
+ rcc_set_ppre1(PPRE1_HCLK_DIV2); //prescales the APB1 from the AHB clock; max 36MHz
+ rcc_set_ppre2(PPRE2_HCLK_NODIV); //prescales the APB2 from the AHB clock; max 72MHz
+
+ /* sysclk should run with 72MHz -> 2 Waitstates ; choose 0WS from 0-24MHz, 1WS from 24-48MHz, 2WS from 48-72MHz */
+ flash_set_ws(FLASH_LATENCY_2WS);
+
+ /* Set the PLL multiplication factor to 9. -> 16MHz (external) * 9 (multiplier) / 2 (PLLXTPRE_HSE_CLK_DIV2) = 72MHz */
+ rcc_set_pll_multiplication_factor(PLLMUL_PLL_CLK_MUL9);
+
+ /* Select HSI as PLL source. */
+ rcc_set_pll_source(PLLSRC_HSE_CLK);
+
+ /* divide external frequency by 2 before entering pll (only valid/needed for HSE) */
+ 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 A (for GPIO_USART1_TX) and USART1. */
+ rcc_peripheral_enable_clock(&RCC_APB2ENR, IOPAEN);
+ rcc_peripheral_enable_clock(&RCC_APB2ENR, USART1EN);
+
+ /* Setup GPIO pin GPIO_USART1_TX/GPIO9 on GPIO port A for transmit. */
+ gpio_set_mode(GPIOA, GPIO_MODE_OUTPUT_50_MHZ,
+ GPIO_CNF_OUTPUT_ALTFN_PUSHPULL, GPIO_USART1_TX);
+
+ /* Setup UART parameters. */
+ usart_set_baudrate(USART1, 115200);
+ usart_set_databits(USART1, 8);
+ usart_set_stopbits(USART1, USART_STOPBITS_1);
+ usart_set_mode(USART1, USART_MODE_TX_RX);
+ usart_set_parity(USART1, USART_PARITY_NONE);
+ usart_set_flow_control(USART1, USART_FLOWCONTROL_NONE);
+
+ /* Finally enable the USART. */
+ usart_enable(USART1);
+}
+
+void gpio_setup(void)
+{
+ /* Enable GPIOB clock. */
+ rcc_peripheral_enable_clock(&RCC_APB2ENR, IOPBEN);
+
+ /* Set GPIO6/7 (in GPIO port B) to 'output push-pull' for the LEDs. */
+ gpio_set_mode(GPIOB, GPIO_MODE_OUTPUT_2_MHZ,
+ GPIO_CNF_OUTPUT_PUSHPULL, GPIO6);
+ gpio_set_mode(GPIOB, GPIO_MODE_OUTPUT_2_MHZ,
+ GPIO_CNF_OUTPUT_PUSHPULL, GPIO7);
+}
+
+void my_usart_print_string(u32 usart, char * s)
+{
+ while (*s != 0) {
+ usart_send(usart, *s);
+ s++;
+ }
+}
+
+int main(void)
+{
+ /* Exactly 20 bytes including '0' at the end.
+ We want to transfer 32bit * 5 so it should fit */
+ char s1[20] = "Hello STM MEM2MEM\r\n";
+ char s2[20];
+
+ clock_setup();
+ gpio_setup();
+ usart_setup();
+
+ gpio_clear(GPIOB, GPIO7); /* LED1 on */
+ gpio_set(GPIOB, GPIO6); /* LED2 off */
+
+ my_usart_print_string(USART1, "s1 ");
+ my_usart_print_string(USART1, s1);
+
+ rcc_peripheral_enable_clock(&RCC_AHBENR, DMA1EN);
+
+ /* MEM2MEM mode for channel 1. */
+ dma_enable_mem2mem_mode(DMA1, DMA_CHANNEL1);
+
+ /* Highest priority. */
+ dma_set_priority(DMA1, DMA_CHANNEL1, DMA_CCR1_PL_VERY_HIGH);
+
+ /* 32Bit wide transfer for source and destination. */
+ dma_set_memory_size(DMA1, DMA_CHANNEL1, DMA_CCR1_MSIZE_32BIT);
+ dma_set_peripheral_size(DMA1, DMA_CHANNEL1, DMA_CCR1_PSIZE_32BIT);
+
+ /* After each 32Bit we have to increase the addres because we use RAM. */
+ dma_enable_memory_increment_mode(DMA1, DMA_CHANNEL1);
+ dma_enable_peripheral_increment_mode(DMA1, DMA_CHANNEL1);
+
+ /* We define the source as peripheral. */
+ dma_set_read_from_peripheral(DMA1, DMA_CHANNEL1);
+
+ /* We want to transfer string s1. */
+ dma_set_peripheral_address(DMA1, DMA_CHANNEL1, (u32) &s1);
+
+ /* Destination should be string s2. */
+ dma_set_memory_address(DMA1, DMA_CHANNEL1, (u32) &s2);
+
+ /* Set number of DATA to transfer.
+ Remember that this means not necessary bytes but MSIZE or PSIZE
+ depending from your source device. */
+ dma_set_number_of_data(DMA1, DMA_CHANNEL1, 5);
+
+ /* Start DMA transfer. */
+ dma_enable_channel(DMA1, DMA_CHANNEL1);
+
+ /* TODO: write a function to get the interrupt flags. */
+ while(!(DMA_ISR(DMA1) & 0x0000001))
+ {
+ }
+
+ dma_disable_channel(DMA1, DMA_CHANNEL1);
+
+ /* String s1 should now already be transferred to s2. */
+ my_usart_print_string(USART1, "s2 ");
+ my_usart_print_string(USART1, s2);
+
+ gpio_clear(GPIOB, GPIO6); /* LED2 on */
+ while(1); /* Halt. */
+
+ return 0;
+}
diff --git a/examples/other/dma_mem2mem/dma.ld b/examples/other/dma_mem2mem/dma.ld
new file mode 100644
index 0000000..a1e9de5
--- /dev/null
+++ b/examples/other/dma_mem2mem/dma.ld
@@ -0,0 +1,31 @@
+/*
+ * This file is part of the libopenstm32 project.
+ *
+ * Copyright (C) 2010 Thomas Otto <tommi@viadmin.org>
+ *
+ * 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 an STM32F103RBT6 board (128K flash, 20K RAM). */
+
+/* Define memory regions. */
+MEMORY
+{
+ rom (rx) : ORIGIN = 0x08000000, LENGTH = 128K
+ ram (rwx) : ORIGIN = 0x20000000, LENGTH = 20K
+}
+
+/* Include the common ld script from libopenstm32. */
+INCLUDE libopenstm32.ld
+