Skonfiguruj program wizualny ST za pomocą kompilatora Cosmic STM8: 11 kroków

2024 Autor: John Day | [email protected]. Ostatnio zmodyfikowany: 2024-01-30 11:26

W ten sposób konfiguruję zintegrowane środowisko programistyczne (IDE) do programowania mikrokontrolerów STM8 firmy ST Microelectronics (ST) z systemem Windows 10. Nie twierdzę, że jest to właściwy sposób, ale dla mnie działa to dobrze. W tym Instructable będzie to wyglądać jak dużo pracy, ale w rzeczywistości nie jest to wcale tak dużo pracy.

Kieszonkowe dzieci:

Kawa i trochę cierpliwości?

PC z Windows 10

dostęp do Internetu

Debuger/programator STLink

Krok 1: Pobierz Cosmic Compiler i ST Microelectronics IDE (STVD)

Będziesz musiał zarejestrować się na stronie ST.com i stronie Cosmic.com i pobrać z nich kilka programów. Dodatkowo potrzebujesz licencji, aby używać kompilatora Cosmic. Ta licencja jest bezpłatna i ważna przez rok, po czym wystarczy poprosić o nową licencję. Licencja jest ważna tylko na komputer, na którym zgłoszono żądanie. Myślę, że opłaca ją ST jako usługa dla firm, które używają ich sprzętu, ale nie jestem tego pewien. (Wiem, że istnieje inny kompilator, SDCC, który jest open source, ale nie mam z nim żadnego doświadczenia.)

Zacznę od pobrania kompilatora Cosmic, ponieważ prośba o licencję jest obsługiwana przez pracownika Cosmic, więc może to zająć trochę czasu, jeśli wyślesz prośbę w weekend, prawdopodobnie będziesz musiał poczekać do następnego tygodnia. W tym czasie możemy pobrać i zainstalować IDE z ST. Więc przejdź do:

https://www.cosmicsoftware.com/download.php

Przewiń w dół, aż zobaczysz żółty blok „Bezpłatne narzędzia STM8 bez ograniczeń”, kliknij link „Zarejestruj się i pobierz” i wypełnij wymagane informacje. Następnie możesz pobrać kompilatory. Do pobrania są dwa kompilatory i dwa programy o nazwach Idea_STM8 i IdeaCXM, użyjemy tylko kompilatora STM8.

Krok 2: Instalacja Kosmicznego Kompilatora(ów)

Uruchom pobrany program jako administrator swojego komputera (potrzebne będzie hasło administratora), aby można go było zainstalować w katalogu „Program Files (x86)”. Po prostu postępuj zgodnie z instrukcjami, zaakceptuj licencję (nie czytałem jej, czy ktoś?), wpisz swoje imię i nazwisko oraz nazwę firmy i kliknij dalej, a następnie kolejne ekrany. Po zainstalowaniu wszystkich plików chce umieścić się w "ścieżce", kazałem mu zarejestrować się w HKEY_LOCAL_MACHINE, aby działał dla wszystkich użytkowników komputera, nie tylko dla administratora.

Zadbaj o to, aby przeczytać informacje na kolejnych ekranach i wybrać, co chcesz lub nie, np. Nie chcę żadnych ikon na pulpicie.

Pod koniec instalacji otworzy się plik Readme.txt z informacją, że możesz zarejestrować oprogramowanie na dwa sposoby. U mnie metoda "On the Web" nie zadziałała, więc wybrałem opcję e-mail. Wypełnij User, Company i Email swoim prawdziwym imieniem i adresem e-mail, nie mam firmy, więc wymyśliłem ładne imię. Następnie wybierz "Zapisz do pliku", zapisz go w miejscu, w którym Ty i administrator macie dostęp do: C:\ pracował dla mnie. Możesz wysłać ten plik jako załącznik do wiadomości e-mail lub skopiować zawarty w nim tekst i umieścić go w treści wiadomości e-mail do Cosmic. Adres e-mail to:

[email protected]

i upewnij się, że wpisałeś: "Żądanie licencji STM8FSE_2020" jako temat. Zakończ instalację i uruchom ponownie komputer. A potem poczekaj na przybycie licencji.

Krok 3: Pobierz i zainstaluj ST Visual Develop

W międzyczasie pobierz i zainstaluj oprogramowanie ST Visual Develop.

Przejdź do:

Przewiń na dół strony i kliknij „Pobierz oprogramowanie”, zaakceptuj Umowę licencyjną (ja też jej nie czytałem…) i Zaloguj się, jeśli masz już login w ST lub zarejestruj się, jeśli jeszcze nie masz loginu. Witryna ST jest raczej powolna, więc być może będziesz musiał poczekać na odpowiedź przez kilka sekund, po prostu poczekaj cierpliwie, zadziała.

Zapisz pobrany plik zip i otwórz go, rozpakuj oprogramowanie do miejsca, w którym chce go system Windows. Rozpocznij instalację programu ST Visual Development, uruchamiając "sttoolset_pack42.exe" jako administrator. Klikaj przez pierwsze ekrany, ponownie akceptując umowę licencyjną (i ponownie bez jej czytania) i akceptując większość opcji sugerowanych przez ST. Nie, nie wiem, dlaczego ST wybrało nazwy katalogów, takie jak „st_toolset”. Ponownie, nie chciałem ikon na pulpicie i nie przeczytałem informacji o wydaniu.

Gdy po raz pierwszy zainstalowałem zestaw narzędzi ST, zawiódł, zawieszając się na końcu instalacji. Kiedy zakończyłem instalację przez menedżera zadań i próbowałem uruchomić ST Visual Develop, pojawił się ekran informujący, że wystąpiła „anomalia”. Po czym program się rozpoczął…..

Przeinstalowałem i za drugim razem poszło dobrze. Kolejne ponowne uruchomienie systemu Windows później program został poprawnie zainstalowany i uruchomiony bez komunikatów o błędach.

Krok 4: Niektóre opcje w STVD

Musimy ustawić kilka opcji w ST Visual Develop (STVD) Przejdź do - Narzędzia - Opcje - Zestaw narzędzi. Wybierz zestaw narzędzi o nazwie „STM8 Cosmic” i ustaw jego „Ścieżkę główną” na:

„C:\Program Files (x86)\COSMIC\FSE_Compilers\CXSTM8”

„Ścieżka Bin” może pozostać pusta, „Ścieżka dołączania” będzie już miała wartość „HSTM8”, a „Ścieżka Lib” będzie miała wartość „Lib”, wszystkie są poprawne. Kliknij Zastosuj i OK, ostrzeżenia, które otrzymasz, dotyczą innych zestawów narzędzi, więc można je zignorować.

Spójrz na inne zakładki Opcji, możesz zmienić niektóre opcje.

W zakładce "Debugowanie" wybrałem Automatyczne zapisywanie plików, ponieważ denerwowało mnie to, gdy po każdej edycji pytał, czy chcę zapisać przed kompilacją. Oczywiście chce, żeby moje zmiany zostały zapisane!

W zakładce „Edycja” wyłączyłem opcję Długa linia - domyślnie włączona i zmieniłem rozmiar tabulatora z 2 na 4 oraz czcionkę z „Courier New” na „Consolas” o rozmiarze 12 punktów.

Ale te ustawienia są osobistymi preferencjami, nie są ważne i można je zrobić później.

Krok 5: Pierwszy program (miga)

Czas na programowanie. W tym celu potrzebujemy tak zwanego obszaru roboczego, w którym STVD zapisuje informacje o projektach w nim. Kliknij Plik - Nowy obszar roboczy - Utwórz pusty obszar roboczy, zwykle nadaję obszarowi roboczemu nazwę typu mikrokontrolera, którego będę używał dla projektu w to. Wybiorę więc „STM8S103” i umieszczę go w katalogu o tej samej nazwie.

Teraz możesz "kliknąć prawym przyciskiem" na Workspace (STM8S103.stw) i stworzyć w nim nowy projekt. Następnie kliknij Nowy projekt i nadaj mu żądaną nazwę, utwórz również katalog, w którym chcesz umieścić ten projekt, STVD nie robi tego sam! Wybierz Toolchain STM8 Cosmic i sprawdź, czy katalogiem głównym Toolchain jest „C:\Program Files (x86)\COSMIC\FSE_Compilers\CXSTM8” Kliknij OK.

Następnie wybierz mikrokontroler, którego będziesz używać, tutaj wybiorę STM8S103F3P i kliknij Wybierz, OK

Projekt jest tworzony i możesz otworzyć foldery, aby zobaczyć, jakie pliki zostały utworzone przez STVD. Teraz ZAMKNIJ ST Visual Opracuj i zapisz zmiany w obszarze roboczym i swoim nowym projekcie. Nadpiszemy niektóre pliki i dodamy więcej, aby przygotować STVD do użycia z kompilatorem Cosmic.

Krok 6: Nadpisz i dodaj pliki

Potrzebne pliki można pobrać z:

https://gitlab.com/WilkoL/setup-st-visual-develop-…

i zapisz je w nowym folderze, nazywam ten folder moim szablonem

W poprzednim kroku stworzyliśmy projekt we własnym folderze projektu. Skopiuj WSZYSTKIE pliki i foldery pobrane z Gitlab do tego folderu projektu. Zastąpi niektóre pliki, które już tam są.

Używana jest standardowa biblioteka (patrz main.h) stm8s_conf.h jest już edytowany, aby wykluczyć USE_FULL_ASSERT)

stm8s_it.c jest już edytowany, aby uwzględnić obsługę TIMER4 UPDATE IRQ (dla systick i DELAY)

Krok 7: Uruchom ponownie program wizualny ST i zakończ konfigurację projektu

Po ponownym uruchomieniu STVD zostanie wyświetlony bardzo pusty ekran.

Aby przejść do swojego projektu, wybierz Plik - Ostatni obszar roboczy - "nazwa, którą mu nadałeś" STVD otworzy ostatni (i wciąż jedyny) projekt. Możesz rzucić okiem na pliki, ale nie jesteśmy jeszcze gotowi.

Najpierw dodaj następujące pliki:

stm8s_it.c do plików źródłowych

stm8s_it.h i main.h do dołączania plików (patrz zdjęcia)

Teraz utwórz foldery w folderze projektu:

lib

lib/inc

lib/źródło

standard_lib

standard_lib/inc

standard_lib/scr (zobacz zdjęcia)

A potem dodaj wszystkie pliki z odpowiednich folderów na dysku do nowych folderów w projekcie. W końcu powinno to wyglądać jak na ostatnim obrazku powyżej.

Krok 8: Ustawienia projektu

Jesteśmy prawie gotowi…

PRZEJDŹ DO: Projekt -> Ustawienia -> Ogólne

- Zestaw narzędzi powinien być STM8 Cosmic

- wybierz „Ścieżka zestawu narzędzi specyficzna dla projektu”

- zmień ścieżkę Root na: C:\Program Files (x86)\COSMIC\FSE_Compilers\CXSTM8

- ścieżka include powinna mieć postać Hstm8, ścieżka biblioteki powinna mieć postać Lib

PRZEJDŹ DO: Projekt -> Ustawienia -> C-Compiler -> Kategoria Ogólne

– zmień Optymalizacje na Dostosuj

– zmień wyświetlanie komunikatów kompilatora z „Wyświetl tylko błędy” na „Wyświetl błędy i ostrzeżenia”

– dodaj STM8S103 HSE_VALUE=1600000UL do definicji preprocesora

– (lub STM8S103 lub inny typ mikrokontrolera i rzeczywista wartość HSE, której używasz)

PRZEJDŹ DO: Projekt -> Ustawienia -> C-Compiler -> Optymalizacje kategorii

Do DEBUGOWANIA wybierz:

– Wyłącz do debugowania (-nie)

– Podziel funkcje w oddzielnych sekcjach (+split)

Dla RELEASE wybierz:

– Podziel funkcje w oddzielnych sekcjach (+split)

– Optymalizacja prędkości (+szybka) (STM8 Cosmic>= 4.3.2)

– lub wybierz Minimalizuj rozmiar kodu (+kompaktowy)

(ale nie zarówno +szybki, jak i +kompaktowy)

PRZEJDŹ DO: Projekt -> Ustawienia -> C-Compiler -> Preprocesor kategorii

- dodatkowe biblioteki include powinny być:

standard_lib\inc; lib\inc;. ← dodaj „kropkę”

- zaznacz to dla ustawień debugowania i wydania

PRZEJDŹ DO: Projekt -> Ustawienia -> Linker

- w Wyjściu Kategorii zaznacz "Generuj plik mapy"

- jeśli potrzebujesz wsparcia dla zmiennych zmiennoprzecinkowych, w kategorii Ogólne zaznacz Float (powiększy to rozmiar kodu, więc rób to tylko w razie potrzeby)

- zrób to dla ustawień debugowania i wydania

I w końcu:

kliknij OK i wypróbuj REBUILD_ALL, aby sprawdzić ostrzeżenia/błędy. Jeśli wszystko pójdzie dobrze, kod jest kompilowany bez błędów i dołączany do pliku S19, który można znaleźć w folderze Debug.

Krok 9: Programowanie mikrokontrolera

Ostatnim krokiem jest wprowadzenie kodu do samego mikrokontrolera. Jest na to kilka sposobów, tutaj pokażę, jak to zrobić za pomocą "Light Programmer", który jest częścią STVD.

W pasku menu znajdziesz go pod Narzędzia - Programista

PRZEJDŹ DO: Narzędzia -> Programista -> Ustawienia:

– zmień sprzęt na „ST-LINK”

PRZEJDŹ DO: Narzędzia -> Programator -> Obszary pamięci – PAMIĘĆ DANYCH: powinna być pusta

– PAMIĘĆ PROGRAMU -> Dodaj: nazwa projektu\Debug\plik xxx.s19 lub

– PAMIĘĆ PROGRAMU -> Dodaj: nazwa projektu\Release\xxx.s19 plik podczas kompilacji w trybie wydania

Bajty opcji są interesujące do sprawdzenia, ale zwykle są poprawne. Myślę, że najlepiej zmienić opcję bajty osobnym programem: ST Visual Programmer, którego tutaj nie będę omawiał.

TERAZ KLIKNIJ OK, to ważne, zrób to przed programowaniem mikrokontrolera lub ustawisz wszystkie opcje wymienione powyżej.

PRZEJDŹ DO: Narzędzia -> Programator -> Program

kliknij "Start", aby wgrać kod do MCU i podziwiaj mrugającą diodę:-)

Krok 10: Rozwiązywanie problemów

Z nieznanych mi przyczyn może się zdarzyć, że debugowanie nie działa. Rozwiązaniem wydaje się być wyrejestrowanie pliku DAO350. LL i ponowna rejestracja.

Aby to zrobić, uruchom cmd jako administrator i uruchom kolejne polecenia:

Regsvr32 /u "C:\Program Files (x86)\Common Files\Microsoft Shared\DAO\DAO350. DLL"

Regsvr32 "C:\Program Files (x86)\Common Files\Microsoft Shared\DAO\DAO350. DLL"

Może się również zdarzyć, że jak tylko będziesz chciał uruchomić Light Programmer, STVD zawiesi się, czasami z błędem "braku pamięci". W takim przypadku skopiuj plik ProgrammerAddOn. DLL na plik z folderu /STVD.

Korzystanie z EEPromu

Kiedy dane muszą trafić do EEPROM, wgrywanie przez Light Programmer NIE działa ze mną. Rozwiązanie, które znalazłem, to otwarcie sesji DEBUG, która zajmie się programowaniem zarówno PAMIĘCI PROGRAMU, jak i PAMIĘCI DANYCH (eeprom)

Miałem drobne problemy z dostępem do plików i folderów zarówno z Cosmic, jak i STVD, ponieważ używam systemu Windows jako zwykły użytkownik, a nie jako administrator. Wiem, że to nie jest właściwy sposób na rozwiązanie tego problemu, ale po prostu dałem wszystkim zwykłym użytkownikom na komputerze uprawnienia do modyfikacji w folderach:

C:\Program Files (x86)\STMicroelectronics\st_toolset

C:\Program Files (x86)\COSMIC\FSE_Compilers

Gdy debugowanie nie rozpoczyna się od komunikatu o wyborze celu, program nie ustawił ST-Link jako instrumentu debugowania. Wybierz tę opcję na głównym pasku zadań i ustaw opcję Debug Instrument Selection na Swim ST-Link

Krok 11: Moduł Stlink V2 i STM8S103F3p

Niewiele do powiedzenia, tylko po to, aby pokazać STlink-V2 i STM8S103F3P, których używam. Mam zarówno oryginalny STLink wyprodukowany przez ST Microelectronics, jak tani klon, który kupiłem w serwisie eBay, oba działają dobrze. Wszystkie moduły STM8S103 pochodzą z Ebay, Aliepress lub innych. Nie sądzę, aby oficjalni dealerzy, tacy jak Farnell lub Mouse, mieli moduły STM8S103 jako moduły, ale można je kupić jako gołe części.