{"id":409,"date":"2021-09-13T05:01:50","date_gmt":"2021-09-13T05:01:50","guid":{"rendered":"https:\/\/blog.embeddedexpert.io\/?p=409"},"modified":"2021-09-13T05:01:54","modified_gmt":"2021-09-13T05:01:54","slug":"working-with-stm32-and-uart-part-4-sending-strings-using-dma","status":"publish","type":"post","link":"https:\/\/blog.embeddedexpert.io\/?p=409","title":{"rendered":"Working with STM32 and UART part 4: Sending Strings using DMA"},"content":{"rendered":"\n

In the pervious part (from here<\/a>), we took a look how to send string in UART using polling mode. <\/p>\n\n\n\n

In polling mode, we forced the cpu to send the string character by character using software. In this guide, we shall use DMA (Direct Memory Access) to send the string.<\/p>\n\n\n\n

\"\"
UART<\/figcaption><\/figure><\/div>\n\n\n\n

In this guide, we will cover the following<\/p>\n\n\n\n

  • Configure UART for DMA TX<\/li>
  • Configure DMA<\/li>
  • DMA Send <\/li>
  • Code<\/li>
  • Result<\/li><\/ul>\n\n\n\n

    <\/p>\n\n\n\n

    1 Configure UART for DMA TX<\/h2>\n\n\n\n

    In order to configure UART to use DMA, we need to enable the DMA Transmission bit in Control Register 3 (CR3).<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
     USART2->CR3 |= (1<<7);            \/* enable USART2 transmitter DMA *\/<\/pre><\/div>\n\n\n\n
    hence, the UART Initialization will be as following<\/p>\n\n\n\n
    \/*  Initialize UART pins, Baudrate\n    The USART2 is configured to send output to pin PA2 at 9600 Baud.\n *\/\nvoid USART2_init (void) {\n    RCC->AHB1ENR |= 1;          \/* enable GPIOA clock *\/\n    RCC->APB1ENR |= 0x20000;    \/* enable USART2 clock *\/\n\n    \/* Configure PA2 for USART2_TX *\/\n    GPIOA->AFR[0] &= ~0x0F00;\n    GPIOA->AFR[0] |=  0x0700;   \/* alt7 for USART2 *\/\n    GPIOA->MODER  &= ~0x0030;\n    GPIOA->MODER  |=  0x0020;   \/* enable alternate function for PA2 *\/\n\n    USART2->BRR = 0x0683;       \/* 9600 baud @ 16 MHz *\/\n    USART2->CR1 = 0x0008;       \/* enable Tx, 8-bit data *\/\n    USART2->CR2 = 0x0000;       \/* 1 stop bit *\/\n    USART2->CR3 = 0x0000;       \/* no flow control *\/\n    USART2->CR1 |= 0x2000;      \/* enable USART2 *\/\n    USART2->CR3 |= (1<<7);            \/* enable USART2 transmitter DMA *\/\n    USART2->SR = ~0x40;         \/* clear TC flag *\/\n    USART2->CR1 |= 0x0040;      \/* enable transmit complete interrupt *\/\n\n    NVIC_EnableIRQ(USART2_IRQn);    \/* USART2 interrupt enable at NVIC *\/\n}<\/pre><\/div>\n\n\n\n
    2.1  DMA Initialization<\/h2>\n\n\n\n
    Before we enable clock access, we need to know which DMA and which channel to use in order to use DMA for UART TX.<\/p>\n\n\n\n
    From DMA section from reference manual of STM32F411, we conclude the we need to use DMA1 Stream6 and channel 4<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    First we start by enabling clock access to DMA1 as following<\/p>\n\n\n\n
    RCC->AHB1ENR |= RCC_AHB1ENR_DMA1EN;     \/* DMA controller clock enable *\/<\/pre><\/div>\n\n\n\n
    Then we clear all pending interrupts of DMA1_Stream 6 (HIFCR)<\/p>\n\n\n\n
    DMA1->HIFCR = 0x003F0000;       \/* clear all interrupt flags of Stream 6 *\/<\/pre><\/div>\n\n\n\n
    Finally enable interrupt for DMA1_Stream6<\/p>\n\n\n\n
    \nNVIC_EnableIRQ(DMA1_Stream6_IRQn);  \/* DMA interrupt enable at NVIC *\/<\/pre><\/div>\n\n\n\n
    2.2 DMA Configuration to send data<\/h2>\n\n\n\n
    First we need clear the Transmission Complete interrupt from status register of USART2 as following<\/p>\n\n\n\n
    USART2->SR &= ~USART_SR_TC;          \/* clear UART transmit complete interrupt flag *\/<\/pre><\/div>\n\n\n\n
    Then we disable the stream and wait until the stream is disabled <\/p>\n\n\n\n
    DMA1_Stream6->CR &= ~1;         \/* disable DMA1 Stream 6 *\/\n while (DMA1_Stream6->CR & 1) {} \/* wait until DMA1 Stream 6 is disabled *\/<\/pre><\/div>\n\n\n\n
    We clear the interrupt flags of DMA1_Stream6<\/p>\n\n\n\n
    DMA1->HIFCR = 0x003F0000;       \/* clear all interrupt flags of Stream 6 *\/<\/pre><\/div>\n\n\n\n
    Then we set the destination as following<\/p>\n\n\n\n
    DMA1_Stream6->PAR = dst;<\/pre><\/div>\n\n\n\n
    Setting the source as following<\/p>\n\n\n\n
    DMA1_Stream6->M0AR = src;<\/pre><\/div>\n\n\n\n
    Setting how many number of bytes to send as following<\/p>\n\n\n\n
    DMA1_Stream6->NDTR = len;<\/pre><\/div>\n\n\n\n
    Now we choose channel 4 <\/p>\n\n\n\n
    DMA1_Stream6->CR = 0x08000000;  \/* USART2_TX on DMA1 Stream6 Channel 4 *\/<\/pre><\/div>\n\n\n\n
    now we select memory size, memory inc and memory to peripheral as following<\/p>\n\n\n\n
    DMA1_Stream6->CR |= 0x00000440; \/* data size byte, mem incr, mem-to-peripheral *\/<\/pre><\/div>\n\n\n\n
    Now we need to enable some interrupt <\/p>\n\n\n\n
    • Transfer complete interrupt enable<\/li>
    • Transfer error interrupt enable<\/li>
    • Direct mode error interrupt enable<\/li><\/ul>\n\n\n\n
      DMA1_Stream6->CR |= 0x16;       \/* enable interrupts DMA_IT_TC | DMA_IT_TE | DMA_IT_DME *\/<\/pre><\/div>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Finally we enable the DMA stream.<\/p>\n\n\n\n
      DMA1_Stream6->CR |= 1;          \/* enable DMA1 Stream 6 *\/<\/pre><\/div>\n\n\n\n
      2.3 Interrupt handler<\/h2>\n\n\n\n
      For interrupt handler. For DMA, in case of error it will halt the entire mcu and for UART if the TC is triggered , we inform the application that the transmission is finished<\/p>\n\n\n\n
      \/*  DMA1 Stream6 interrupt handler\n    This function handles the interrupts from DMA1 controller Stream6. The error interrupts \n    have a placeholder for error handling code. If the interrupt is from DMA data\n    transfer complete, the DMA controller is disabled, the interrupt flags are\n    cleared.\n *\/\nvoid DMA1_Stream6_IRQHandler(void)\n{\n    if (DMA1->HISR & 0x000C0000)    \/* if an error occurred *\/\n        while(1) {}                 \/* substitute this by error handling *\/\n    DMA1->HIFCR = 0x003F0000;       \/* clear all interrupt flags of Stream 6 *\/\n    DMA1_Stream6->CR &= ~0x10;      \/* disable DMA1 Stream 6 TCIE *\/\n}\n\n\/*  USART2 interrupt handler\n *  USART2 transmit complete interrupt is used to set the done flag to signal\n *  the other part of the program that the data transfer is done.\n *\/\nvoid USART2_IRQHandler(void)\n{\n    USART2->SR &= ~0x0040;          \/* clear transmit complete interrupt flag *\/\n    done = 1;                       \/* set the done flag *\/\n\t\n}<\/pre><\/div>\n\n\n\n
      3. Code<\/h2>\n\n\n\n
      #include "stm32f4xx.h"                  \/\/ Device header\n#include "string.h"\n#include "stdio.h"\nvoid USART2_init(void);\nvoid DMA1_init(void);\nvoid DMA1_Stream6_setup(unsigned int src, unsigned int dst, int len);\nint variable;\nint done = 1;\nchar c[]="hello from stm32f411re \\r\\n";\nchar message[sizeof(c)];\n    \n\n\nvoid delayMs(int delay)\n\n{\n\nint i;\n\nfor(; delay>0 ;delay--)\n\n{\n\nfor(i =0; i<3195;i++);\n\n}\n\n}\n\n\n\nint main (void) {\n \n    \n\n    \n    USART2_init();\n    DMA1_init();\n    \n    while (1) {\n\t\t\t\n\t\t\tint i;\n    int size = strlen(c);\n        \/* prepare the message for transfer *\/\n\t\t\t\n        for (i = 0; i < size; i++)\n            message[i] = c[i];\n        \n        \/* send the message out by USART2 using DMA *\/\n        while (done == 0) {}    \/* wait until DMA data transfer is done *\/\n        done = 0;               \/* clear done flag *\/\n        DMA1_Stream6_setup((unsigned int)message, (unsigned int)&USART2->DR, size);\n\t\t\t\t\t\t\t\t\t\n    }\n}\n\/*  Initialize UART pins, Baudrate\n    The USART2 is configured to send output to pin PA2 at 9600 Baud.\n *\/\nvoid USART2_init (void) {\n    RCC->AHB1ENR |= 1;          \/* enable GPIOA clock *\/\n    RCC->APB1ENR |= 0x20000;    \/* enable USART2 clock *\/\n\n    \/* Configure PA2 for USART2_TX *\/\n    GPIOA->AFR[0] &= ~0x0F00;\n    GPIOA->AFR[0] |=  0x0700;   \/* alt7 for USART2 *\/\n    GPIOA->MODER  &= ~0x0030;\n    GPIOA->MODER  |=  0x0020;   \/* enable alternate function for PA2 *\/\n\n    USART2->BRR = 0x0683;       \/* 9600 baud @ 16 MHz *\/\n    USART2->CR1 = 0x0008;       \/* enable Tx, 8-bit data *\/\n    USART2->CR2 = 0x0000;       \/* 1 stop bit *\/\n    USART2->CR3 = 0x0000;       \/* no flow control *\/\n    USART2->CR1 |= 0x2000;      \/* enable USART2 *\/\n    USART2->CR3 |= (1<<7);            \/* enable USART2 transmitter DMA *\/\n    USART2->SR = ~0x40;         \/* clear TC flag *\/\n    USART2->CR1 |= 0x0040;      \/* enable transmit complete interrupt *\/\n\n    NVIC_EnableIRQ(USART2_IRQn);    \/* USART2 interrupt enable at NVIC *\/\n}\n\n\n\/*  Initialize DMA1 controller\n *  DMA1 controller's clock is enabled and also the DMA interrupt is \n *  enabled in NVIC.\n *\/\nvoid DMA1_init(void) {\n    RCC->AHB1ENR |= RCC_AHB1ENR_DMA1EN;     \/* DMA controller clock enable *\/\n    DMA1->HIFCR = 0x003F0000;       \/* clear all interrupt flags of Stream 6 *\/\n    \n    \n\t\n    NVIC_EnableIRQ(DMA1_Stream6_IRQn);  \/* DMA interrupt enable at NVIC *\/\n}\n\n\/*  Set up a DMA transfer for USART2 \n *  The USART2 is connected to DMA1 Stream 6. This function sets up the \n *  peripheral register address, memory address, number of transfers,\n *  data size, transfer direction, and DMA interrupts are enabled.\n *  At the end, the DMA controller is enabled and the USART2 transmit\n *  DMA is enabled.\n *\/\nvoid DMA1_Stream6_setup(unsigned int src, unsigned int dst, int len) {\n\t\n\t\tUSART2->SR &= ~USART_SR_TC;          \/* clear UART transmit complete interrupt flag *\/\n\t\n    DMA1_Stream6->CR &= ~1;         \/* disable DMA1 Stream 6 *\/\n    while (DMA1_Stream6->CR & 1) {} \/* wait until DMA1 Stream 6 is disabled *\/\n    DMA1->HIFCR = 0x003F0000;       \/* clear all interrupt flags of Stream 6 *\/\n    DMA1_Stream6->PAR = dst;\n    DMA1_Stream6->M0AR = src;\n    DMA1_Stream6->NDTR = len;\n    DMA1_Stream6->CR = 0x08000000;  \/* USART2_TX on DMA1 Stream6 Channel 4 *\/\n    DMA1_Stream6->CR |= 0x00000440; \/* data size byte, mem incr, mem-to-peripheral *\/\n    DMA1_Stream6->CR |= 0x16;       \/* enable interrupts DMA_IT_TC | DMA_IT_TE | DMA_IT_DME *\/\n    \/\/DMA1_Stream6->FCR  = 0;         \/* direct mode, no FIFO *\/\n    DMA1_Stream6->CR |= 1;          \/* enable DMA1 Stream 6 *\/\n\n\t\t\t\n\t\t\t\n\t\t\t\n}\n\n\/*  DMA1 Stream6 interrupt handler\n    This function handles the interrupts from DMA1 controller Stream6. The error interrupts \n    have a placeholder for error handling code. If the interrupt is from DMA data\n    transfer complete, the DMA controller is disabled, the interrupt flags are\n    cleared.\n *\/\nvoid DMA1_Stream6_IRQHandler(void)\n{\n    if (DMA1->HISR & 0x000C0000)    \/* if an error occurred *\/\n        while(1) {}                 \/* substitute this by error handling *\/\n    DMA1->HIFCR = 0x003F0000;       \/* clear all interrupt flags of Stream 6 *\/\n    DMA1_Stream6->CR &= ~0x10;      \/* disable DMA1 Stream 6 TCIE *\/\n}\n\n\/*  USART2 interrupt handler\n *  USART2 transmit complete interrupt is used to set the done flag to signal\n *  the other part of the program that the data transfer is done.\n *\/\nvoid USART2_IRQHandler(void)\n{\n    USART2->SR &= ~0x0040;          \/* clear transmit complete interrupt flag *\/\n    done = 1;                       \/* set the done flag *\/\n\t\n}\n\n<\/pre><\/div>\n\n\n\n
      4. Results<\/h2>\n\n\n\n
      after you compile and upload the code, you will get this<\/p>\n\n\n\n
      \"\"<\/figure>\n","protected":false},"excerpt":{"rendered":"
      In the pervious part (from here), we took a look how to send string in UART using polling mode. In polling mode, we forced the cpu to send the string character by character using software. In this guide, we shall use DMA (Direct Memory Access) to send the string. In this guide, we will cover […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,11,12],"tags":[],"class_list":["post-409","post","type-post","status-publish","format-standard","hentry","category-embedded-systems","category-peripheral-drivers","category-stm32"],"_links":{"self":[{"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=\/wp\/v2\/posts\/409"}],"collection":[{"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=409"}],"version-history":[{"count":1,"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=\/wp\/v2\/posts\/409\/revisions"}],"predecessor-version":[{"id":415,"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=\/wp\/v2\/posts\/409\/revisions\/415"}],"wp:attachment":[{"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=409"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=409"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.embeddedexpert.io\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=409"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}