Redirecting printf to UART on STM32F4-Discovery using Keil
Keywords: Embedded systems, ARM, STM32F4, UART, ITM, printf
Code Link: Source Code Github Link
The “C” printf is one of the most commonly used debug function/assistant used in DESKTOP applications. In embedded systems, the printf is not used frequently due to:
- Larger Footprint
- High CPU cycles consumptions
which indeed is a problem on memory space limited and relatively slower speed embedded systems. In such systems “Blinky Led” is the best alternative and most commonly used debug assistant BUT if printf is affordable on embedded board, it can provide much better assistance than “Blinky Led”.
Anyhow irrespective of printf pros and coins, we will discuss how it can be used on STM32F4-Discovery Microcontroller/kit platform using Keil. The Keilv5 is used with MDK5.
Keil provides Run-Time libraries to direct printf messages to:
- User defined Medium like UART, SPI, CAN etc.
- STLINK Debugger via ARM Instrumentation Trace Macrocell (ITM)
- None, Just stop processor to analyze system state.
In this tutorial we will focus on first method i.e. printf redirection to user defined Medium. The second method i.e. printf redirection to Stlink Debugger is described in the following tutorial.
For illustration purpose we will direct printf messages to USART-3 of STM32F4-Discovery board.
User defined Medium- printf-to-UART/USART:
In this method, the supplied characters of printf are redirected to user defined medium as defined by void stdout_putchar (int ch) function. The background working procedure is that the “C” printf formats the text as per supplied arguments and passes the formated string characters one by one to int fputc (int c, FILE * stream) character by character. The int fputc (int c, FILE * stream) simply redirect received character in its first argument to void stdout_putchar (int ch) or void stderr_putchar (int ch) function – Figure-1.
Now its upto void stdout_putchar (int ch) or void stderr_putchar (int ch) function implementation where the character needs to be sent.
NOTE: There is a way around of directing printf characters to UART. But to keep things simple, we will stick to default flow which is easy, portable and straight forward.
NOTE: Before we can redirect printf messages to UART, UART needs to configured properly for desired baudrate. Configuring UART is not in scope of this tutorial. We already have another tutorial which discusses how to configure and use UART on STM32F4-Discovery board (Link given bellow).
Following are steps to redirect printf messages to UART in Keil.
Steps:
1. Create a black project in for STM32F407VG (Microcontroller on STM32F4-Discovery board). Create a new main.c file with the simple main function as shown bellow.
#include <stm32f4xx.h>
#include <stdio.h>
// main function main.c
int main () {
volatile int x = 0;
/*
configure DESIRED USART to which printf string will
be redirected.
*/
init_usart3();
for (;;) {
/*
Transmit string PB.10
*/
printf ("Test String redirection to UART\n");
for (x = 0; x < 5000; x++);
}
}
2. Click on Manage Run-Time Environment (
)in Keil.
Click Compiler –> I/O –> STDIO –> check the enable check box and select “User” from drop down menu – Figure-2.
a file with name retarget_io.c will be added automatically added to the project.
3. Initialize desired UART in main function or in separate function. For demonstration purpose we will use USART3 on STM32F407VG. All related USART3 initialization is done in a separate function static void init_usart3 (void).
static void init_usart3 (void) {
/*
enable clock to GPIOB
*/
RCC->AHB1ENR |= (1u << 1);
/*
enable clock to USART3
*/
RCC->APB1ENR |= (1U << 18);
/*
1-stop bit
*/
USART3->CR2 &= ~(1u << 12);
USART3->CR2 &= ~(1u << 13);
/*
9600 baudrate at 16Mhz
B.R = f / 8 x (2 - OVER8) x USARTDIV
B.R = 9600
f = 16000000
OVER8 = 0
==> USARTDIV = 104
fraction = 0
mantissa = 104
*/
USART3->BRR = (104U << 4);
/*
enabble Transmission
*/
USART3->CR1 |= (1U <<3);
/*
disable parity
*/
USART3->CR1 &= ~(1U << 10);
/*
1-start bit, 8-bits data, n-stop bits
*/
USART3->CR1 &= ~ (1U << 12);
/********************************
ENABLE GPIOB Pin.10 as USART Tx
*********************************/
/*
setting alternate function for GPIOB.10
*/
GPIOB->MODER |= (1U << 21);
/*
medium speed
*/
GPIOB->OSPEEDR |= (1U << 20);
/*
pull up
*/
GPIOB->PUPDR |= (1U << 20);
/*
alternate function - 7 (USART-3 Tx)
*/
GPIOB->AFR[1] |= (0x7U << 8);
/*
finally enable USART3
*/
USART3->CR1 |= (1U << 13);
}
4. Copy and past the following function to main.c. Remember to keep the scope “Global”.
int stdout_putchar (int ch) {
USART3->DR = ch;
/* wait until the transmission completes */
while ((USART3->SR & (1U << 6)) != (1U << 6));
return 1;
}
5. That’s it. Compile it and burn to STM32F407VG flash. Connect USB-to-Serial to board. In our case as we have configured USART3 Tx line only so connect Rx line of USB-to-Serial cable to PB.10 of STM32F4-Discovery board. Open a serial window like Termite, Putty, Docklight etc. and set it to desired port (as shown in device manager for USB-to-Serial cable) and set the baudrate to 9600 (as per our USART3 configuration).
FINALLY RUN THE PROGRAM.
For demonstration, see the following video.
Video demonstration:
Click the full screen button for more clear view.
[1] – Reference manual-RM0090
I loved as much as you will receive carried out right
here. The sketch is tasteful, your authored subject matter stylish.
nonetheless, you command get got an impatience over that you wish be delivering the following.
unwell unquestionably come further formerly again since
exactly the same nearly very often inside case you shield this hike.
Nice post. I learn something new and challenging on sites I stumbleupon on a daily basis.
It’s always exciting to read through content from other writers and practice something
from their websites.
A Long Way Gone Uncle Tommy Kane And Abel Between Us
My web blog: pdf base [https://www.pearltrees.com]
Having read this I thought it was rather
enlightening. I appreciate you taking the time and effort to put this
short article together. I once again find myself spending a significant amount of time
both reading and commenting. But so what, it
was still worth it!
Simply desire to say your article is as astonishing.
The clearness in your post is just cool and i could assume you are a professional on this subject.
Well with your permission allow me to clutch your RSS feed to keep up
to date with drawing close post. Thank you a million and please keep
up the gratifying work.
I am genuinely thankful to the holder of this web site who
has shared this enormous post at at this time.
I am extremely impressed with your writing skills as
well as with the layout on your weblog. Is this a paid theme or did you modify it yourself?
Either way keep up the nice quality writing, it is
rare to see a great blog like this one these days.
I loved as much as you will receive carried out right here.
The sketch is attractive, your authored subject matter stylish.
nonetheless, you command get got an impatience over that
you wish be delivering the following. unwell unquestionably come more
formerly again as exactly the same nearly a lot often inside case you shield
this increase.
Hey there! I know this is kind of off topic but I was wondering which blog platform are you using
for this site? I’m getting sick and tired of WordPress because I’ve had issues with hackers and
I’m looking at alternatives for another platform. I would
be great if you could point me in the direction of a good platform.
My programmer is trying to convince me to move to .net from PHP.
I have always disliked the idea because of the costs.
But he’s tryiong none the less. I’ve been using WordPress on a variety of websites for about a
year and am concerned about switching to another platform.
I have heard fantastic things about blogengine.net.
Is there a way I can import all my wordpress content into it?
Any kind of help would be greatly appreciated!
I know this if off topic but I’m looking into starting my
own weblog and was curious what all is required to get setup?
I’m assuming having a blog like yours would cost
a pretty penny? I’m not very internet smart so I’m not 100% certain. Any suggestions or advice would be greatly
appreciated. Thank you
It’s very straightforward to find out any topic on web as compared to textbooks, as I
found this piece of writing at this website.
This design is wicked! You definitely know how to keep a reader amused.
Between your wit and your videos, I was almost moved
to start my own blog (well, almost…HaHa!) Wonderful job.
I really loved what you had to say, and more than that,
how you presented it. Too cool! asmr https://app.gumroad.com/asmr2021/p/best-asmr-online asmr
Good post. I learn something new and challenging on websites I stumbleupon everyday.
It will always be exciting to read content from other writers and practice something from other sites.
cheap flights http://1704milesapart.tumblr.com/ cheap flights
Do you have a spam issue on this website; I also am a blogger, and I
was curious about your situation; we have created some nice methods and we are looking to swap solutions with other folks, be sure
to shoot me an e-mail if interested. quest bars http://bit.ly/3jZgEA2 quest
bars
Saved as a favorite, I really like your site! ps4 games
https://bitly.com/3z5HwTp ps4 games
This is a great tip particularly to those new to
the blogosphere. Short but very accurate information… Many thanks for sharing this one.
A must read post! scoliosis surgery https://0401mm.tumblr.com/ scoliosis
surgery
Asking questions are in fact fastidious thing if you are not understanding anything entirely, except this post gives nice understanding yet.
quest bars https://www.iherb.com/search?kw=quest%20bars quest bars
Thank you for sharing your info. I truly appreciate your efforts and I will be waiting for your further write ups thank you once again. scoliosis surgery https://coub.com/stories/962966-scoliosis-surgery scoliosis surgery
Hi there! This article could not be written much better!
Going through this article reminds me of my previous roommate!
He constantly kept talking about this. I am going to forward this article to him.
Pretty sure he will have a good read. I appreciate you for sharing!
Small body molding changes in the XTi arguably is important in the ergonomics
of the camera; depending on your hand size, you might find
the XTi comfortable or unbalanced and cramped.Get Camera at Amazon
If you already have acne, do not try to touch them or squeeze them;
it can lead to permanent scars.Get Skin Care at Amazon
Write more, thats all I have to say. Literally, it seems as though you relied
on the video to make your point. You definitely know what youre talking about, why waste your intelligence on just posting videos to
your weblog when you could be giving us something enlightening
to read?
Great blog.Much thanks again. Awesome.
Hi, I do think your site could possibly be having internet browser compatibility problems.
When I take a look at your website in Safari, it looks fine however, when opening in Internet Explorer, it’s got some overlapping issues.
I simply wanted to give you a quick heads up! Besides that, wonderful website!
Howdy just wanted to give you a quick heads up. The text in your post seem to be running off the screen in Firefox.
I’m not sure if this is a format issue or something
to do with browser compatibility but I thought I’d post to let you know.
The design look great though! Hope you get the problem fixed
soon. Thanks
Aw, this was a really nice post. Taking the time and actual effort to create a superb
article… but what can I say… I procrastinate a whole lot and don’t seem to get nearly anything done.
What’s up, I read your new stuff daily.
Your writing style is witty, keep up the good work!
It’s really a nice and helpful piece of info. I’m glad that you
just shared this helpful info with us. Please stay us informed
like this. Thanks for sharing.
I blog often and I genuinely appreciate your content. Your article has truly peaked my interest.
I’m going to book mark your blog and keep checking
for new details about once a week. I opted in for your RSS feed as well.
I do not know whether it’s just me or if everybody else encountering
problems with your blog. It appears as though some of the written text in your posts are
running off the screen. Can someone else please provide feedback and let me know
if this is happening to them as well? This may be a problem with my internet
browser because I’ve had this happen previously. Thank you
my web page – tracfone