Zaloguj
Bardzo często aplikacja webowa, niezależnie od tego, w jakim języku programowania jest napisana, nie implementuje protokołu HTTP, tylko podłączona jest do serwera HTTP, który w razie potrzeby ją uruchamia. W tym przykładzie jest jednak inaczej – aplikacja będzie zajmować się również parsowaniem żądań HTTP i formowaniem odpowiedzi. Dzięki temu unikniemy konieczności uruchamiania i konfiguracji serwera HTTP. Uruchomienie takiego serwera nie jest bardzo skomplikowane, ale wymaga wykonania dodatkowych kroków. Implementacją protokołu HTTP zajmie się biblioteka libmicrohttpd, której musimy tylko dostarczyć odpowiednie funkcje do obsługi żądań. Dzięki niej, w tym prostym przykładzie cały kod implementujący serwer HTTP mieści się w niecałych 200 linijkach.
Aby uruchomić aplikację, potrzebne są wszystkie pliki niezbędne do uruchomienia Linuksa na płytce Zedboard. Sposób ich przygotowania opisałem jednym z poprzednich artykułów kursu. Nie zmienia się sposób bootowania Linuksa, więc nie trzeba zmieniać nic w programie Uboot, ani FSBL. Nie ma też potrzeby modyfikować jądra systemu. Aplikacja będzie sterować diodami poprzez dedykowany sterownik Linuksa, więc potrzebne są odpowiednie wpisy w plikach DST. Tu jednak również nie są potrzebne żadne modyfikacje, ponieważ wpisy dotyczące tych diod są już domyślnie dodane. Potrzebna jest więc tylko jedna modyfikacja: jako że będziemy używać biblioteki libmicrohttpd, trzeba ją dodać do systemu plików.
System Yocto w dużym uproszczeniu oparty jest na receptach (recipes), które zgromadzone są w warstwach (Layers). Po pobraniu repozytorium poky dostępne są tylko podstawowe recepty. Aby zbudować podstawowy system dla układu Zynq należy dodatkowo pobrać warstwę meta-xilinx. Te warstwy mamy już pobrane. Recepta budowania biblioteki libmicrohtd znajduje się w nie pobranej jeszcze warstwie meta-oe, w repozytorium meta-openembedded, które można znaleźć na Github. Aby je pobrać, należy uruchomić terminal, przejść do folderu Yocto, w którym znajdują się poprzednio pobrane repozytoria poky i meta-xilinx i wykonać komendę git clone git@github.com:openembedded/meta-openembedded.git. To polecenie pobierze całe repozytorium. Trzeba jeszcze dodać ścieżkę potrzebnej warstwy do pliku bblayers.conf, do zmiennej LAYERS. Po modyfikacji ta zmienna wygląda tak:
BBLAYERS ?= „
/home/stas/yocto/poky/meta
/home/stas/yocto/poky/meta-poky
/home/stas/yocto/poky/meta-yocto-bsp
/home/stas/yocto/meta-xilinx
/home/stas/yocto/meta-openembedded/meta-oe
„
Teraz można zmodyfikować główny plik konfiguracyjny – local.conf. Znajdziemy go w katalogu <yocto>/poky/zedboard/conf/ . W pliku local.conf szukamy zmiennej IMAGE_INSTALL_append i dodajemy do niej bibliotekę libmicrohttpd pamiętając o dodaniu na końcu spacji. Po modyfikacji linijka będzie wyglądała następująco – IMAGE_INSTALL_append = „libgcc libstdc++ libmicrohttpd”.
Następnie ponownie generujemy obraz zgodnie z instrukcją. Nie będzie to trwało tak długo, jak poprzednim razem, gdyż Yocto ma już skompilowane większość potrzebnych pakietów, więc musi tylko skompilować nową bibliotekę i dodać ją do obrazu.
Po wygenerowaniu nowego obrazu, kopiujemy go w odpowiednie miejsce, zgodnie z wybraną metodą uruchamiania Linuksa i uruchamiamy go.
Aplikacja
Uruchamiany program potrzebuje dodatkowej biblioteki, więc tym razem potrzebne są dodatkowe kroki, aby poprawnie zbudować aplikację. Niezbędne jest wskazanie dwóch katalogów. W jednym z nich są pliki nagłówkowe, w drugim – biblioteki. Projekt libmicrohttpd jest skompilowany jako biblioteka współdzielona, ale i tak podczas budowania jest ona potrzebna.
Zaczynamy od uruchomienia XSDK – z konsoli lub z poziomu Vivado. Przykładowa aplikacja pisana na system Linux, więc nie trzeba koniecznie posługiwać się tą samą, co przy poprzednich aplikacjach przestrzenią roboczą (workspace), ale można tak zrobić.
Tak jak w przypadku dwóch poprzednich aplikacji, zaczynamy od utworzenia nowego projektu: File New Application Project. Jako nazwę projektu można wpisać ledhttpserver. W opcji OS Platform wybieramy Linux, język – C, a na koniec zaznaczamy opcję Linux System Root i wpisujemy tam ścieżkę, w której Yocto trzyma potrzebne do budowania aplikacji zależności. Ta lokalizacja znajduje się w folderze <yocto>/poky/zedboard/tmp/sysroot/zedboard-zynq7. Na koniec ekran tworzenia aplikacji powinien wyglądać podobnie jak na rysunku 2, na którym ustawiona jest ścieżka do folderu yocto taka, jak na moim komputerze. Następnie klikamy Next, jako szablon aplikacji wybieramy Empty application i klikamy Finish.
Kod aplikacji znajduje się w pliku main.c, który jest dostępny na serwerze ftp zawierającym materiały dodatkowe do artykułów. Po pobraniu dodajemy go do projektu. Jest to przerobiona wersja przykładowego programu, który można znaleźć w dokumentacji biblioteki libmicrohttpd (https://goo.gl/iSS2as). Program należy uruchomić z parametrem PORT oznaczającym numer portu, na którym aplikacja będzie nasłuchiwać żądań. Po wpisaniu w przeglądarce adresu IP płytki i portu, powinien się pojawić ekran z szeregiem białych kółek, po jednym na każdą diodę. Jeśli natomiast w ścieżce adresu wpisana zostanie liczba od 0 do 7, jedna z diod zapali się lub zgaśnie.
Główna część programu widoczna jest w listingu 1. Otwierają go dwie stałe preprocesora: HEADER i FOOTER. Są to odpowiednio początek i koniec kodu HTML, który zostanie wysłany w odpowiedzi. Funkcja main zawiera kod parsujący parametry wywołania programu, inicjalizację sterownika diod LED i funkcję MHD_start_daemon, która uruchamia nasłuchiwanie serwera. Zawiera ona wiele argumentów, których dokładny opis znajduje się w dokumentacji, a najważniejszy z nich to funkcja ahc_ledhttpserver, która będzie wywoływana w odpowiedzi na żądanie HTTP. W przypadku skomplikowanych i długich żądań potrzebne są jeszcze dodatkowe funkcje, ale w tym przypadku nie ma takiej konieczności.
Aby uruchomić aplikację, należy zaznaczyć projekt w panelu po lewej stronie, rozwinąć menu klikając go prawym przyciskiem myszy i z menu wybrać Run as Run Configurations. Konfiguracja jest taka sama jak przy poprzednich aplikacjach, z jednym dodatkiem – trzeba dodać argument wywołania. W tym celu wybieramy kartę Arguments i w polu Program Arguments wpisujemy jakiś numer poru, np. 8080. Mając podłączoną i włączoną płytkę i uruchomiony system Linux klikamy Run.
Aby przetestować aplikację, otwieramy przeglądarkę i wpisujemy adres IP płytki, a po dwukropku wpisujemy numer portu. Jeśli wszystko zostało wykonane poprawnie, to przeglądarka powinna pokazać komunikat powitalny i szereg białych kółek. Po kliknięciu w kółko, odpowiadająca mu dioda powinna się zapalić. Po włączeniu kilku diod, ekran przeglądarki wygląda jak na rysunku 5, a odpowiadająca mu konfiguracja zaświeconych diod, jak pokazano na rysunku 6.
Podsumowanie
W artykule opisano sposób uruchomienia kolejnej aplikacji na platformie Zedboard. Jako że korzysta ona z zewnętrznej biblioteki współdzielonej, trzeba było dodać ją do systemu plików. Aby ją prawidłowo skompilować, trzeba było również ustawić odpowiednie opcje kompilacji i linkowania. To daje dobrą bazę do kolejnych, bardziej rozbudowanych projektów.
Stanisław Aleksiński
