Kursy • Poradniki • Inspirujące DIY • Forum
W poprzedniej części kursu STM32 nauczyliśmy się używać linii I/O do komunikacji z otoczeniem. Nadszedł czas na poznanie pierwszego interfejsu, który pozwoli na większą interakcję ze światem.
UART posłuży nam do przesyłania komunikatów między STM32, a komputerem PC.
Kiedyś właściwie wszystkie komputery PC były wyposażone w interfejs RS-232. Obecnie USB prawie zupełnie wyparło starszy standard. Złącze szeregowe miało jedną ogromną zaletę – było proste w obsłudze (szczególnie porównując z USB).
Wtyczki USB vs. RS-232
Dlatego w przypadku mikrokontrolerów port szeregowy jest nadal popularny, chociaż coraz częściej w nieco innej postaci. RS-232 działał na dość nietypowych napięciach ±11V (właściwie tolerował od 3V do 15V), dlatego do jego obsługi potrzebny był dodatkowy układ konwertera napięcia np. MAX232.
W typowych mikrokontrolerach stosuje się uproszczoną wersję interfejsu, działającą na napięciach 0V i 3.3V (zamiast wspomnianych wcześniej). Moduł odpowiedzialny za obsługę takiej komunikacji nazywany jest UART (ang. Universal Asynchronous Receiver and Transmitter).
Przykładowa ramka UART
Transmisja rozpoczyna się od bitu startu, zaznaczonego na rysunku jako BS. Zawsze jest to bit będący logicznym zerem. Następnie, zależnie od konfiguracji, następuje po sobie 7, 8 lub 9 bitów danych (tutaj zaznaczone jako B0-B7), które są wysyłaną informacją. Bit stopu (zaznaczony tutaj jako bit BK) to bit będący logiczną jedynką - mówi o końcu transmisji.
Format ramki oraz sposób transmisji jest właściwie niezmieniony względem RS-232.
Płytka Nucleo wyposażona jest w konwerter z UART na USB. Nie mamy więc po drodze RS-232, a po podłączeniu do PC, przejściówka będzie widziana jako port COM, czyli nasz port szeregowy.
Część płytki będąca programatorem i przejściówką UART.
UART - Universal Asynchronous Receiver and Transmitter
USART - Universal Synchronus and Asynchronous Receiver and Transmitter
W przypadku komputerów PC za obsługę portu szeregowego odpowiedzialny był układ UART, czyli: Universal Asynchronous Receiver and Transmitter.
Nasz STM32 posiada moduł, który może pracować zarówno synchronicznie, jak i asynchronicznie, więc nazwa stała się jeszcze bardziej skomplikowana - USART, Universal Synchronus and Asynchronous Receiver and Transmitter. Używamy jednak tylko komunikacji asynchronicznej, więc obie nazwy możemy traktować jako synonimy.
Jeśli chcesz dowiedzieć się więcej o UART oraz jego zastosowaniach przeczytaj również artykuł: port szeregowy i interfejs USART, czyli komunikacja z komputerem.
Możliwość przesyłania danych jest nieoceniona podczas uruchamiania i testowania układów. Można w tym celu wykorzystywać debugger, np. przez interfejs SWD, jednak komunikaty testowe często są niezastąpioną metodą wyszukiwania błędów.
W kolejnych częściach kursu jeszcze wielokrotnie wykorzystamy komunikację przez UART, np. do testowania przetwornika ADC. Dodatkowym plusem komunikacji szeregowej jest możliwość łatwego zastąpienia przejściówki UART - USB modułem radiowym i przesyłanie informacji np. za pomocą Bluetooth lub WiFi.
Komplet elementów Gwarancja pomocy Wysyłka w 24h
Zestaw ponad 120 elementów do przeprowadzenia wszystkich ćwiczeń z kursu można nabyć u naszych dystrybutorów! Dostępne są wersje z płytką Nucleo lub bez niej!
Zamów w Botland.com.pl »Do obserwowania efektów pracy programów z tej części kursu konieczny jest dodatkowy program, terminal, przykładowo może to być darmowy: Tera Term lub Realterm.
Jak zwykle pierwszy krok to konfiguracja zegara. STM32 posiada kilka modułów USART, my wykorzystamy USART2, ponieważ jest on podłączony do naszej przejściówki, która znajduje się na płytce. Musimy również skonfigurować alternatywne funkcje pinów.
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);Pierwsza instrukcja uruchamia zegar funkcji alternatywnych linii I/O, druga uruchamia USART2.
Nie możemy w jednej instrukcji uruchomić obydwu,
ponieważ są to różne linie zegara (APB1 i APB2).
Zanim uruchomimy UART, zmienimy konfigurację linii RX oraz TX. Linia wyjściowa (TX) jest obecna na wyprowadzeniu PA2, a wejście (RX) na PA3. Wyjście skonfigurujemy jako funkcję alternatywną w trybie push-pull, natomiast wejście ustawimy jako pływające (ang. floating), czyli bez rezystora podciągającego. Kod będzie więc wyglądał wtedy następująco:
GPIO_InitTypeDef gpio;
GPIO_StructInit(&gpio);
gpio.GPIO_Pin = GPIO_Pin_2;
gpio.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(GPIOA, &gpio);
gpio.GPIO_Pin = GPIO_Pin_3;
gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(GPIOA, &gpio);Gdy mamy już skonfigurowane linie, czas przygotować moduł USART2:
USART_InitTypeDef uart;
USART_StructInit(&uart);
uart.USART_BaudRate = 115200;
USART_Init(USART2, &uart);
USART_Cmd(USART2, ENABLE);Prędkość transmisji 115200 jest jedną ze standardowych wartości. Jeśli pojawiałyby się błędy podczas komunikacji, można wykorzystać niższe, np.: 9600 lub 38400.
Do wysyłania danych służy funkcja USART_SendData. Przyjmuje ona dwa parametry: wykorzystywany interfejs (USART2) oraz wartość (bajt) do wysłania. Jeśli chcemy wysłać np. napis musimy podzielić go na bajty i wysyłać kolejno.
Niestety prędkość wysyłania danych jest mała, więc jeśli po prostu wywołamy USART_SendData, szybko zapełnimy bufor nadawczy, a kolejne dane będą gubione. Przed wysłaniem powinniśmy więc upewnić się, że w buforze nadawczym jest miejsce. W tym celu wykorzystamy funkcję: USART_GetFlagStatus. Procedura wysyłania bajtu będzie miała więc postać:
void send_char(char c)
{
while (USART_GetFlagStatus(USART2, USART_FLAG_TXE) == RESET);
USART_SendData(USART2, c);
}W pętli while czekamy, aż bufor nadawczy będzie wolny, a następnie wysyłamy dane.
W tej części kursu nie użyjemy przerwań do obsługi komunikacji przez UART. Wrócimy do tego, jeśli będzie później taka potrzeba.
Jak wysłać w takim razie cały napis? Możemy wykorzystać np. taką funkcję :
void send_string(const char* s)
{
while (*s)
send_char(*s++);
}W uproszczeniu, jako argument, przyjmuje ona ciąg znaków (wskaźnik na jego początek, czyli adres pierwszego elementu tablicy), a dalej napis przesyłany jest znak, po znaku.
Teraz możemy napisać program, który będzie wysyłał przez UART cały napis:
while (1) {
send_string("Hello world!\r\n");
}Znak końca wiersza to nieustający problem w przypadku różnych systemów operacyjnych. System Windows używa dwóch znaków, CR LF (czyli \r\n) natomiast Linux tylko jednego LF (\n). Ponieważ przykłady uruchamiamy na komputerze z systemem Windows, wysyłamy dwa znaki.
Więcej o tym problemie można przeczytać na Wikipedii.
Cały kod realizujący wysyłanie napisu wygląda w sposób następujący:
#include "stm32f10x.h"
void send_char(char c)
{
while (USART_GetFlagStatus(USART2, USART_FLAG_TXE) == RESET);
USART_SendData(USART2, c);
}
void send_string(const char* s)
{
while (*s)
send_char(*s++);
}
int main(void)
{
GPIO_InitTypeDef gpio;
USART_InitTypeDef uart;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOC | RCC_APB2Periph_GPIOD, ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);
GPIO_StructInit(&gpio);
gpio.GPIO_Pin = GPIO_Pin_2;
gpio.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(GPIOA, &gpio);
gpio.GPIO_Pin = GPIO_Pin_3;
gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(GPIOA, &gpio);
USART_StructInit(&uart);
uart.USART_BaudRate = 115200;
USART_Init(USART2, &uart);
USART_Cmd(USART2, ENABLE);
while (1) {
send_string("Hello world!\r\n");
}
}Rezultat powinien wyglądać następująco:
STM32 - wysyłanie danych przez UART.
Potrafimy już wysyłać dane. Teraz czas odebrać transmisję z PC - np.: instrukcje sterujące robotem lub innym urządzeniem. Do odbioru bajtu wykorzystamy funkcję USART_ReceiveData.
Tutaj pojawia się jednak analogiczny problem jak przy wysyłaniu danych. Nie możemy odczytać danych, jeśli w buforze odbiorczym ich nie ma. Zanim wywołamy tę funkcję powinniśmy upewnić się, że coś w buforze jest.
Wykorzystamy do tego tę samą funkcję co poprzednio, czyli: USART_GetFlagStatus. Fragment odbierający dane wygląda następująco:
if (USART_GetFlagStatus(USART2, USART_FLAG_RXNE)) {
char c = USART_ReceiveData(USART2);
}Oczywiście w tym momencie powinniśmy do czegoś wykorzystać zawartość zmiennej c – np. zapisać ją w buforze. Jeśli wystarczy nam bardzo proste sterowanie, po odebraniu znaku możemy wykonać czynność, przykładowo skręcić robotem, zapalić diodę, albo wysłać komunikat.
Prosty przykład wyglądałby następująco:
#include "stm32f10x.h"
void send_char(char c)
{
while (USART_GetFlagStatus(USART2, USART_FLAG_TXE) == RESET);
USART_SendData(USART2, c);
}
void send_string(const char* s)
{
while (*s)
send_char(*s++);
}
int main(void)
{
GPIO_InitTypeDef gpio;
USART_InitTypeDef uart;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOC | RCC_APB2Periph_GPIOD, ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);
GPIO_StructInit(&gpio);
gpio.GPIO_Pin = GPIO_Pin_2;
gpio.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(GPIOA, &gpio);
gpio.GPIO_Pin = GPIO_Pin_3;
gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(GPIOA, &gpio);
USART_StructInit(&uart);
uart.USART_BaudRate = 115200;
USART_Init(USART2, &uart);
USART_Cmd(USART2, ENABLE);
while (1) {
if (USART_GetFlagStatus(USART2, USART_FLAG_RXNE)) {
char c = USART_ReceiveData(USART2);
switch (c)
{
case 'a':
send_string("Odebrano komunikat A!\r\n");
break;
case 'b':
send_string("Odebrano komunikat B!\r\n");
break;
default:
send_string("Nieznany komunikat:(\r\n");
break;
}
}
}
}Działanie programu w praktyce widoczne jest na poniższym zrzucie ekranu:
STM32 - odbieranie danych przez UART.
Napisz program do sterowania diodami led, np. 'A' zapala diodę 1, 'a' gasi, 'B' zapala diodę 2, itd. Diody podłącz do pinów, które wybierzesz samodzielnie.
Napisz program, który odbiera kilka znaków, np. 3, zapisuje w buforze, a następnie wykonuje odebrane polecenie, np. „on1” włącza diodę 1, „of2” wyłącza diodę 2.
Napisz program odbierający znaki, aż do znaku końca linii (\n), a następnie wykonaj polecenie zależne od odebranego ciągu, np. „on 1”, „off 2”.
Wykorzystując własną funkcję send_string możemy przygotować całkiem sprawną komunikację z PC lub innym mikrokontrolerem. Jednak o wiele wygodniej byłoby wykorzystać standardową instrukcję printf do wypisywania komunikatów na złącze szeregowe.
Funkcja send_string jest bardzo prosta i potrafi jedynie wysyłać ciągi znaków. Funkcja printf daje natomiast możliwość formatowania napisów oraz wyświetlania liczb zarówno całkowitych jak i zmiennopozycyjnych. Jej wykorzystanie jest o wiele łatwiejsze, o czym chyba przekonał się każdy kto programował PC.
Dzięki przekierowaniu wyjścia, będziemy mogli używać printf, a wynik działania pojawi się w oknie terminala portu szeregowego. Dokładnie jak w przypadku programu napisanego na komputerze stacjonarnym.
Dzięki temu będziemy mogli przetestować nieśmiertelny przykład:
printf("Hello world!\n");UWAGA!
Wykorzystanie printf, chociaż wygodne, powoduje znaczne zwiększenie objętości programu. Jeśli nie jest to absolutnie niezbędne najlepiej unikać wykorzystywania tej funkcji w programach.
Okazuje się, że gdy wywołujemy printf, biblioteka wykonuje za nas mnóstwo pracy związanej z formatowaniem i przetwarzaniem parametrów, a na koniec wywołuje funkcję __io_putchar dla każdego wysyłanego bajtu. Wystarczy więc że napiszemy tę funkcję i printf będzie wysyłał dane na nasz port szeregowy:
int __io_putchar(int c)
{
send_char(c);
return c;
}Cały kod będzie więc wyglądał jak poniższy:
#include "stm32f10x.h"
void send_char(char c)
{
while (USART_GetFlagStatus(USART2, USART_FLAG_TXE) == RESET);
USART_SendData(USART2, c);
}
int __io_putchar(int c)
{
send_char(c);
return c;
}
int main(void)
{
GPIO_InitTypeDef gpio;
USART_InitTypeDef uart;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOC | RCC_APB2Periph_GPIOD, ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);
GPIO_StructInit(&gpio);
gpio.GPIO_Pin = GPIO_Pin_2;
gpio.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(GPIOA, &gpio);
gpio.GPIO_Pin = GPIO_Pin_3;
gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(GPIOA, &gpio);
USART_StructInit(&uart);
uart.USART_BaudRate = 115200;
USART_Init(USART2, &uart);
USART_Cmd(USART2, ENABLE);
while (1) {
printf("Hello World!\n");
}
}Teraz już możemy uruchomić nasz przykład.
W przypadku Windows możemy zaobserwować dziwne zachowanie na końcu wiersza. W zależności od wykorzystywanego programu do komunikacji, zamiast napisów w kolejnych wierszach możemy zobaczyć schodki. Wynika to z innego sposobu kodowania końców linii w systemach Windows oraz Unix, o którym pisałem wcześniej.
STM32 - błąd wyświetlania danych.
Możemy zmienić komunikat dodając \r\n na końcu (tak jak robiliśmy poprzednio), albo udoskonalić procedurę wysyłającą dane:
int __io_putchar(int c)
{
if (c=='\n')
send_char('\r');
send_char(c);
return c;
}Teraz komunikaty powinny pojawić się prawidłowo.
STM32 - poprawne wyświetlanie danych przez UART.
Poprawiony kod programu:
#include "stm32f10x.h"
void send_char(char c)
{
while (USART_GetFlagStatus(USART2, USART_FLAG_TXE) == RESET);
USART_SendData(USART2, c);
}
int __io_putchar(int c)
{
if (c=='\n')
send_char('\r');
send_char(c);
return c;
}
int main(void)
{
GPIO_InitTypeDef gpio;
USART_InitTypeDef uart;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOC | RCC_APB2Periph_GPIOD, ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);
GPIO_StructInit(&gpio);
gpio.GPIO_Pin = GPIO_Pin_2;
gpio.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(GPIOA, &gpio);
gpio.GPIO_Pin = GPIO_Pin_3;
gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(GPIOA, &gpio);
USART_StructInit(&uart);
uart.USART_BaudRate = 115200;
USART_Init(USART2, &uart);
USART_Cmd(USART2, ENABLE);
while (1) {
printf("Hello World!\n");
}
}Osoby, które nie spotkały się wcześniej z printf mogą nie widzieć jej zalet. Możliwości tej pozornie prostej funkcji są całkiem spore. Po więcej informacji warto zajrzeć np.: do manuala. Na zachętę przeprowadźmy szybkie doświadczenie.
Załóżmy, że naszym celem będzie pomiar napięcia przez ADC (o czym w kolejnym odcinku), wynik zaokrąglamy do części całkowitych i wyświetlamy w formie napisu:
Odczytana wartosc to X V!
Oczywiście, za X podstawiamy otrzymaną liczbę. Normalnie musielibyśmy konwertować liczbę, łączyć ją z tekstem lub wysyłać całość w trzech osobnych krokach (napis, wartość i jednostka). Korzystając z właściwości printf możemy zrobić to w jednej linii:
printf("Odczytana wartosc to %d V!\n", 2);Funkcja ta zamieni wystąpienie %d na cyfrę 2, która została podana jako argument funkcji. Printf pozwala na znacznie więcej operacji, zainteresowanych jeszcze raz odsyłam do manuala.
Wynik powyższego eksperymentu z printf.
Wykorzystaj właściwości funkcji printf do wyświetlania na ekranie komputera napisu, w którego treści podstawiane są dwie liczby całkowite:
To jest XX cz. kursu STM32, a to jest mój X dzien nauki!
Wykorzystaj właściwości funkcji printf do wyświetlania na ekranie komputera napisu, w którego treści podstawiana jest liczba zmiennoprzecinkowa oraz całkowita:
To zadanie domowe nr XX, a ten napis wyswietlono juz X razy
Napisz program działający jak w zadaniu 5.1, ale wykorzystując przerwanie do obsługi odbioru danych. Artykuł nie omawia przerwań od modułu UART, jednak wszystkie informacje są dostępne w dokumentacji mikrokontrolera. Obsługa przerwania jest podobna do omawianej w poprzedniej części kursu.
Poznaliśmy postawy komunikacji za pomocą portu szeregowego. Potrafimy wysyłać oraz odbierać komunikaty. W kolejnych częściach kursu wykorzystamy nabyte umiejętności do przesyłania wyników pomiarów, np. wartości odczytanych z przetwornika analogowo-cyfrowego.
Następna część naszego kursu STM32 będzie omawiała wykorzystanie przetwornika ADC. Jeśli nie chcesz przeoczyć kolejnego odcinka, to skorzystaj z poniższego formularza i zapisz się na powiadomienia o nowych publikacjach!
Autor kursu: Piotr (Elvis) Bugalski
Redakcja: Damian (Treker) Szymański
komunikacja, kursSTM32, Nucleo, stm32, uart
Dołącz do 30 tysięcy osób, które otrzymują powiadomienia o nowych artykułach! Zapisz się, a otrzymasz PDF-y ze ściągami (m.in. na temat mocy, tranzystorów, diod i schematów) oraz listę inspirujących DIY z Arduino i RPi.
Trwa ładowanie komentarzy...