✨ add dma project

Author: csrohit

dma/.gitignore

@@ -0,0 +1,4 @@
+build
+*.bkp
+*.dtmp
+.DS_Store

dma/.vscode/c_cpp_properties.json

@@ -0,0 +1,18 @@
+{
+    "configurations": [
+        {
+            "name": "STM32",
+            "includePath": [
+                "${workspaceFolder}/**"
+            ],
+            "defines": [
+                "STM32F103xB"
+            ],
+            "compilerPath": "/usr/bin/arm-none-eabi-gcc",
+            "cStandard": "gnu17",
+            "cppStandard": "gnu++17",
+            "intelliSenseMode": "gcc-arm"
+        }
+    ],
+    "version": 4
+}

dma/.vscode/launch.json

@@ -0,0 +1,22 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Cortex Debug",
+            "cwd": "${workspaceFolder}",
+            "executable": "./build/blink.elf",
+            "request": "launch",
+            "type": "cortex-debug",
+            "runToEntryPoint": "main",
+            "servertype": "openocd",
+            "configFiles": [
+                "interface/stlink.cfg",
+                "target/stm32f1x.cfg"
+            ],
+            "svdFile": "${workspaceFolder}/STM32F103.svd"
+        }
+    ]
+}

dma/LICENSE.md

@@ -0,0 +1,112 @@
+TARGET = dma-usart
+
+
+# Configure micro-controller
+MCU_FAMILY	= STM32F103xB
+LDSCRIPT 	= stm32f1.ld
+CPU			= cortex-m3
+INSTR_SET	= thumb
+FLOAT_ABI	= soft
+
+# compiler option
+OPT			:= -Os
+CSTD		?= c11
+CXXSTD		:= c++17
+
+# Project specific configuration
+BUILD_DIR 	:= build
+BUILD_TYPE	?= Debug
+SRC_DIR 	:= src
+INC_DIRS	= include
+
+
+PREFIX		?= arm-none-eabi
+CC			:= $(PREFIX)-gcc
+CXX			:= $(PREFIX)-g++
+LD			:= $(PREFIX)-gcc
+AR			:= $(PREFIX)-ar
+AS			:= $(PREFIX)-as
+SIZE		:= $(PREFIX)-size
+OBJCOPY		:= $(PREFIX)-objcopy
+OBJDUMP		:= $(PREFIX)-objdump
+GDB			:= $(PREFIX)-gdb
+
+# collect source files and generate object files
+SRCS 		:= $(shell find $(SRC_DIR) -name '*.cpp' -or -name '*.c')	
+OBJS 		:= $(addsuffix .o,$(basename $(SRCS)))			# replace .c with .o
+OBJS 		:= $(addprefix $(BUILD_DIR)/,$(OBJS))			# replace .c with .o
+
+
+# Define stm32 family macro
+DEFS		+= -D$(MCU_FAMILY)
+
+# header library include flsgs
+INC_FLAGS 	= $(addprefix -I,$(INC_DIRS))
+
+
+# Target-specific flags
+CPU_FLAGS	?= -mfloat-abi=$(FLOAT_ABI) -m$(INSTR_SET) -mcpu=$(CPU)
+
+CPPFLAGS	?=$(DEFS) $(INC_FLAGS)
+CFLAGS		?=$(CPU_FLAGS) $(OPT)
+CXXFLAGS 	:=$(CFLAGS) -fno-exceptions -fno-rtti
+LDFLAGS		?=$(CPU_FLAGS)
+
+ifeq ($(BUILD_TYPE), Debug)
+CFLAGS += -g -gdwarf-2
+endif
+
+# Do not link stdlib with executable
+CFLAGS		+= -nostdlib -fno-tree-loop-distribute-patterns -fdata-sections -ffunction-sections
+CXXFLAGS	+= -nostdlib -fno-tree-loop-distribute-patterns -fdata-sections -ffunction-sections
+LDFLAGS		+= -nostdlib 
+
+
+# Warning options for C and CXX compiler
+CFLAGS		+= -Wall -Wextra -Wundef -Wshadow -Wredundant-decls -Wmissing-prototypes -Wstrict-prototypes
+CXXFLAGS	+= -Wall -Wextra -Wundef -Wshadow -Wredundant-decls -Weffc++ -Werror
+
+
+LDFLAGS		+= -T $(LDSCRIPT)
+LDFLAGS		+= -Wl,-Map=$(basename $@).map,--gc-sections,-cref,--print-memory-usage
+
+all: bin size
+size: $(BUILD_DIR)/$(TARGET).size
+elf: $(BUILD_DIR)/$(TARGET).elf
+bin: $(BUILD_DIR)/$(TARGET).bin
+hex: $(BUILD_DIR)/$(TARGET).hex
+srec: $(BUILD_DIR)/$(TARGET).srec
+list: $(BUILD_DIR)/$(TARGET).list
+
+
+%.size: %.elf
+	@$(SIZE) $<
+
+%.bin: %.elf
+	@echo "COPY " $< " => " $@
+	@$(OBJCOPY) -Obinary $(*).elf $(*).bin
+
+$(BUILD_DIR)/%.o:%.c
+	@mkdir -p $(dir $@)
+	@echo "CC" $< " ==> " $@
+	$(CC) $(CPPFLAGS) $(CFLAGS) -o $@ -c $<
+
+$(BUILD_DIR)/%.o:%.cpp
+	@mkdir -p $(dir $@)
+	@echo "CXX" $< " ==> " $@
+	$(CXX) $(CPPFLAGS) $(CXXFLAGS) -o $@ -c $<
+	
+$(BUILD_DIR)/$(TARGET).elf: $(OBJS)
+	@echo "Linking sources into "$@
+	@$(CC) $(LDFLAGS) -o $@ $^
+
+
+flash: bin
+	st-flash write $(BUILD_DIR)/$(TARGET).bin 0x8000000
+	
+debug: CFLAGS 		+= -g -gdwarf-2
+debug: CXXFLAGS 	+= -g -gdwarf-2
+debug: all
+
+clean:
+	rm -rf build

dma/Makefile

@@ -0,0 +1,107 @@
+# USART communication using DMA
+
+A boilerplate for generating projects for stm32 blue pill board using makefile. The projects does not use any tools provided by ST Microelectronics.
+Everything from development, flashing to debugging can be done in Visual Studio Code only.
+
+![Build Passing](https://img.shields.io/badge/build-passing-brightgreen) [![GPLv3 License](https://img.shields.io/badge/License-GPL%20v3-yellow.svg)](https://opensource.org/licenses/)
+
+
+## Dependencies
+
+* make
+    Make utility is required for configuring and building this project. You can install make on linux by running command:
+
+    ```bash
+    sudo apt install build-essential
+    ```
+
+* gcc-arm-none-eabi toolchain
+    ARM cross-platform toolchain is required to build applications for arm mcus. Toolchain can be installed by running following command:
+
+    ```bash
+    sudo apt install gcc-arm-none-eabi
+    ```
+
+* openocd
+    It is an Open On Circuit Debugging tool used to flash and debug arm micro controllers. You can install openocd on linux by running command:
+
+   ```bash
+   sudo apt install openocd -y
+   ```
+
+* Cortex Debug extension
+x`
+
+
+## Project Structure
+
+* `src` directory contains all source files for the project
+* `include` directory contains all header files for the project
+
+### Source file description
+
+* `STM32F103C8TX_FLASH.ld`  - linker script
+* `src\main.c` - application code
+* `src\startup_stm32f103c8tx.s` - assembly startup script for blue pill board
+* `system_stm32f1xx.c` - clock configuration and system initialization functions
+
+## Run Locally
+
+Running the project is super easy. Just clone, build, and flash.
+
+### Clone the project
+
+1. Using https
+
+    ```bash
+    git clone https://github.com/csrohit/bluepill-template-project.git
+    cd bluepill-template-project
+    ```
+
+2. Using ssh
+
+    ```bash
+    git clone git@github.com:csrohit/bluepill-template-project.git
+    cd bluepill-template-project
+    ```
+## Configuration
+
+All the configuration required for building this project is given below.
+
+1. Build output directory
+    In `Makefile`, output directory can be configured using variable `BUILD_DIR`.
+
+2. Build type
+    In `Makefile`, build type can be configured using variable`DEBUG`. Possible values are `Debug` and `Release`.
+
+3. Binary name
+    In `CMakeLists.txt`, output binary name can be configured using `project(<binary-name>)` macro.
+    ** update above info in `.vscode/launch.json` as well for debugging to work.
+
+## Build
+
+Run following command in terminal to generate flashable binaries for blue pill board. Build files will be written to **Build Output Directory** as configured.
+
+```bash
+make all
+```
+
+## Flash
+
+1. Connect Stlink to PC and blue pill board using swd headers.
+2. Put blue pill board in programming mode.
+3. Run following to flash board with binary.
+
+```bash
+make flash
+```
+
+## Output
+
+Onboard led connected to Pin C13 can be observed to be blinking after 500ms.
+
+## Debug
+
+Click in `Run and Debug` option in VsCode sidebar. Then launch `Cortex Debug` target.
+
+Happy debugging....