VamLoader wersja 2.00 Opis programu Vamond Kraków 2009
Wstęp VamLoader jest programem służącym do ładowania do Vamstera programów w formacie IntelHex i plików programów Vamstera powstałych w Vamgrafie. Właścicielem wszelkich praw do VamLoadera jest firma Vamond. Program jest dostępny bezpłatnie. Terminologia: Vamster - urządzenie, do którego Vamloader potrafi zapisać pliki - programy Vamgraf - aplikacja do graficznego tworzenia programów dla Vamstera IntelHex - popularny format zapisu danych binarnych dla mikroprocesorów Vamond - producent Vamstera, Vamgrafa i VamLoadera Wszelkie nazwy i symbole procesorów, programów, systemów i firm, nie będące własnością firmy Vamond, zostały użyte tylko w celach identyfikacyjnych i informacyjnych. Bez pisemnej zgody firmy Vamond żadna część tego dokumentu nie może być publikowana, cytowana i kopiowana w celach komercyjnych. Właścicielem nazw: Vamgraf, Vamster, VamLoader oraz poniższego znaku graficznego jest firma Vamond. Dodatkowe informacje na temat Vamgrafa, Vamstera i modułów sprzętowych dostępne są na stronie firmy Vamond www.vamond.pl. Tam również można pobrać dodatkową dokumentację i przykłady oraz nowe wersje Vamgrafa. Wszelkie uwagi dotyczące VamLoadera prosimy zgłaszać email-em na adres: biuro@vamond.pl. Vamond 31-617 Kraków os. Złotego Wieku 29 www.vamond.pl email: biuro@vamond.pl Strona: 2
Licencja Program VamLoader objęty jest umową licencyjną zawartą w pliku "VamLoader_umowa_licencyjna.rtf" dostarczanym wraz z VamLoaderem. Opis Program przeznaczony jest do pracy w systemie WindowsXP SP2, WindowsVista i nowszych systemów Windows. Do poprawnej pracy wymaga zainstalowanego frameworka.net 2.0 SP2 (Microsoft). Ładowanie programu do Vamstera odbywa się przy pomocy łącza szeregowego popularnie nazywanego portem COM. Może to być port COM pochodzący ze sterownika konwertera USB na RS232. Program współpracuje z mikrokontrolerami Vamster, które wyposażono w dedykowany program (bootloader) umożliwiający wygodne zapisywanie programów. VamLoader potrafi przesłać do Vamstera pliki zapisane w formacie IntelHex oraz pliki wygenerowane przez program Vamgraf. Pliki IntelHex mogą pochodzić z dowolnego programu (kompilatora) generującego taki format pliku. Vamster oparto na mikrokontrolerze ATMega32 firmy Atmel, i jest możliwe ładowanie do niego programów z innych kompilatorów pod warunkiem przestrzegania pewnych zasad opisanych w Informacje techniczne. Pliki programów Vamstera powstałe w Vamgrafie mają swój własny format. Vamster, z punktu widzenia sprzętu, to moduł elektroniczny wyposażony w mikrokontroler ATMega32, MAX232 oraz inne niezbędne peryferia. Procesor wyposażono w program bootloadera umożliwiający komunikację z VamLoaderem. Vamloader może także współpracować z procesorami ATMega32 do których załadowany został specjalny bootloader (plik boothex.bin) przeznaczony do pracy wyłącznie z plikami w formacie IntelHex. VamLoader może być uruchamiany dwojako: -klasycznie, jak inny program w Windows (ze skrótu, z menu itp.) -z linii poleceń z odpowiednimi parametrami Opis w sekcji Komunikacja z Vamsterem. W trakcie ładowania programów (plików) do Vamstera jest zapewniona kontrola błędów transmisji (sumy CRC etc.). Niepowodzenie w trakcie ładowania jest sygnalizowane odpowiednim komunikatem. Strona: 3
Instalacja W celu zainstalowania programu należy uruchomić plik "VamLoaderInstall.msi" z katalogu instalacyjnego VamLoadera. Procedura instalacyjna jest prosta i wymaga jedynie ewentualnej zmiany katalogu docelowego VamLoadera (co nie jest zalecane). Instalator programu może zażądać wcześniejszego zainstalowania frameworka.net 2.0 SP2 -można go pobrać z witryny internetowej firmy Microsoft. Zwykle.NET 2.0 już jest zainstalowany w systemie. Po zainstalowaniu frameworka należy ponownie uruchomić program instalujący VamLoadera. Po zakończeniu instalacji w katalogu VamLoadera powinny znajdować się cztery pliki: "Vamloader.exe"(program), "VamLoader_umowa_licencyjna.rtf" Opis_VamLoadera.pdf "birsnp.vas" "VamLoader.chm" (plik pomocy). Przy pierwszym uruchomieniu VamLoader przyjmie domyślne ustawienia (jeżeli nie jest uruchamiany z linii poleceń - patrz Komunikacja z Vamsterem). Vamloader pamięta ostatnie ustawienia i z takimi ponownie się uruchamia. Strona: 4
Interfejs Okno główne programu: Przycisk "Wyślij": Rozpoczyna wysyłanie pliku (programu) do Vamstera. Jest nieaktywny w trakcie transmisji. Po jego naciśnięciu Vamloader odczytuje plik z dysku, sprawdza jego poprawność a następnie wysyła do Vamstera. Jeżeli zawartość pliku jest niepoprawna to jest zgłaszany komunikat i transmisja nie jest rozpoczynana. Więcej w sekcji Komunikacja z Vamsterem. Przycisk "Przerwij": Przerywa transmisję plików do Vamstera. Uaktywnia się na początku transmisji i jest deaktywowany po jej zakończeniu (przerwaniu). Jest jedynym przyciskiem aktywnym w trakcie wysyłania pliku. Przycisk "Pomoc": Otwiera plik pomocy. Jest nieaktywny w trakcie transmisji. Przycisk "O programie": Otwiera okno z informacjami o VamLoaderze. Jest nieaktywny w trakcie transmisji. Strona: 5
Przycisk "Zamknij": Zamyka program VamLoader. Jest nieaktywny w trakcie transmisji. Grupa "Plik programu": Jest to ścieżka do pliku jaki będzie wysyłany do Vamstera. Z prawej strony znajduje się przycisk. Po jego naciśnięciu można wybrać plik jaki chcemy wysłać. Obsługa okna wyboru pliku jest typowa w systemie Windows. Można wybrać dwa rodzaje plików IntelHex - rozszerzenie ".hex" i programów Vamstera - rozszerzenie ".vmb". W przypadku nieprawidłowej zawartości tych plików VamLoader przed załadowaniem do Vamstera zgłosi odpowiedni komunikat. Strona: 6
Grupa "Transmisja": Port COM: Tu można wybrać port szeregowy do którego podłączony jest Vamster. Na liście znajdują się tylko porty szeregowe zainstalowane w systemie. Domyślnie jest to port "COM1". Indykator "Czerwona lampka": Pokazuje aktywność programu (zmienia jasność) w trakcie nawiązywania połączenia z Vamsterem. Prędkość: Jest to prędkość transmisji szeregowej. Na liście są dwie pozycje: "Normalna (57600)" - domyślna wartość i nie powinno się jej zmieniać. Jedynie w przypadku, jeżeli występują problemy z poprawną transmisją i zostały sprawdzone inne przyczyny problemów (patrz Port COM), wtedy można ją zmienić na "Bezpieczną" "Bezpieczna (19200)" - jest to kilkukrotnie mniejsza prędkość wysyłania nazwana "Bezpieczną". Po jej wybraniu transmisja jest wolniejsza ale bardziej pewna. Pasek postępu: Pokazuje postęp ładowania pliku do Vamstera. Okno informacyjne: W tym oknie (jasnożółte tło) VamLoader wpisuje komunikaty. Strona: 7
Komunikacja z Vamsterem Tryb manualny Kolejność działań przy wysyłaniu pliku do Vamstera w trybie manualnym: -Uruchomić Vamloadera (ze skrótu, z menu itp.) -Wybrać plik jaki będzie wysyłany do Vamstera ("Plik:" przycisk ) Można wybrać pliki dwóch rodzajów: IntelHex (*.hex) lub plik Vamstera (*.vmb) -Wybrać odpowiedni port komunikacyjny (z listy "Port COM:") - ten do którego podłączony jest Vamster przy pomocy kabla transmisyjnego. -Sprawdzić i ewentualnie zmienić prędkość transmisji (lista "Prędkość:") -Sprawdzić połączenie Vamstera z PC. Kabel transmisyjny powinien być włożony w odpowiednie gniazda w PC i Vamsterze. -Sprawdzić czy Vamster jest podłączony do zasilania. -Uruchomić transmisję poprzez naciśnięcie przycisku "Wyślij". Wówczas VamLoader odczyta plik z dysku i sprawdza jego poprawność. Jeżeli plik jest niepoprawny to zgłaszany jest komunikat (w oknie informacyjnym) a transmisja nie jest rozpoczynana. -Po sprawdzeniu pliku VamLoader wypisuje w oknie informacyjnym: "Oczekiwanie na zgłoszenie Vamstera" i rozpoczyna nawiązywanie łączności z Vamsterem. Deaktywowane są wszystkie przyciski a przycisk "Przerwij" staje się aktywny. Indykator "czerwona lampka" zaczyna pulsować. Nawiązanie łączności powinno nastąpić prawie natychmiast. -Po nawiązaniu łączności z Vamsterem w oknie informacyjnym wypisywany jest komunikat: "Początek wysyłania programu". Indykator przestaje pulsować. Rozpoczyna się wysyłanie pliku do Vamstera. Na pasku postępu widać procentowe zaawansowanie ładowania. -Po pomyślnym zakończeniu ładowania w oknie informacyjnym wypisywany jest komunikat: "Program został pomyślnie wysłany". Przycisk "Przerwij" jest deaktywowany a pozostałe stają się aktywne. Oznacza to pomyślne wysłanie pliku do Vamstera. Vamster powinien wykonać reset. Jeżeli po rozpoczęciu transmisji minął pewien czas (kilkadziesiąt sekund) a połączenie z Vamsterem nie zostało nawiązane VamLoader kończy próbę i wypisuje komunikat: "Brak odpowiedzi - sprawdź połączenie lub uruchom ponownie Vamstera". Przycisk "Przerwij" jest deaktywowany a pozostałe stają się aktywne. Może to oznaczać, że w Vamsterze jest jakiś działający program, który uniemożliwia nawiązanie połączenia. Wówczas: -Należy odłączyć zasilanie Vamstera. Strona: 8
-W VamLoaderze ponownie rozpocząć wysyłkę (przycisk: "Wyślij"). W trakcie jak indykator pulsuje włączyć zasilanie Vamstera. -Po najwyżej kilku sekundach powinna się rozpocząć transmisja. Jeżeli się nie rozpocznie oznacza to problemy z łączem transmisyjnym (sekcja Problemy). Tak samo należy postąpić jeżeli transmisja się rozpoczyna (na pasku postępu pojawia się wskaźnik) ale jest kończona z błędem. Tryb linii poleceń Uruchamianie transmisji z linii poleceń: VamLoadera można uruchamiać z linii poleceń, ze skrótu, z innych programów itp. Poszczególne parametry muszą być oddzielone spacjami. Parametr 3 (ścieżka do pliku) musi być ujęta w podwójne apostrofy np. ścieżkę: C:\katalog hex\plik.hex należy podać jako: "C:\katalog hex\plik.hex". UWAGA: Ważna jest wielkość liter (dotyczy parametru 1 i parametru 2). Podane muszą być wszystkie parametry. Po uruchomieniu VamLoadera z linii poleceń VamLoader otworzy swoje okno, automatycznie wczyta podany plik, wyśle go i zamknie swoje okno kończąc pracę. W przypadku wystąpienia błędu program wyświetli odpowiedni komunikat a okno pozostanie otwarte. Parametry linii poleceń Vamloadera: Vamloader.exe [parametr 1] [parametr 2] [parametr 3] gdzie: [parametr 1] wyznacza nazwę portu szeregowego w systemie np. COM1, COM4 itp. [parametr 2] wyznacza prędkość transmisji i określany jest jedną literą. Są tylko dwie możliwości: N - prędkość normalna(57600) B - prędkość bezpieczna (19200) [parametr 3] wyznacza ścieżkę dostępu do pliku jaki Vamloader będzie wysłał. Musi to być pełna ścieżka dostępu łącznie z symbolem dysku. Przykłady: Vamloader.exe COM1 N "C:\katalog1\katalog2\plik.hex" transmisja poprzez port COM1 z prędkością normalną, wysłany plik: plik.hex, z katalogu: "C:\katalog1\katalog2" Vamloader.exe COM4 B "C:\katalog1\katalog2\plik.vmb" transmisja poprzez port COM4 z prędkością bezpieczną, wysłany plik: plik.vmb, z katalogu: "C:\katalog1\katalog2" Strona: 9
C:\Program Files\Vamond\Vamloader\Vamloader.exe COM1 N "C:\kat1\kat2\plik.hex" transmisja poprzez port COM1 z prędkością normalną, wysłany plik: plik.hex z katalogu: C:\kat1\kat2 Podana jest również pełna ścieżka dostępu do VamLoadera (bez apostrofów) Problemy W przypadku jeżeli plik programu (*.hex, *.vmb) jest niedostępny lub jest nieprawidłowy (np. uszkodzony, za długi) VamLoader wypisuje odpowiedni komunikat i nie rozpoczyna transmisji. Należy wówczas sprawdzić ścieżkę dostępu do pliku i/lub wygenerować nowy plik. Jeżeli ładowanie pliku do Vamstera zakończy się komunikatem: "Brak odpowiedzi - sprawdź połączenie lub uruchom ponownie Vamstera". Mogą być różne przyczyny: -nieprawidłowo wybrany port szeregowy -port szeregowy działa nieprawidłowo - zdarza się to przy konwerterach USB -Vamster nie jest podłączony do PC -Vamster nie jest podłączony do zasilania -Vamster nie został zresetowany -Kabel transmisyjny jest uszkodzony -Inne - uszkodzony bootloader w Vamsterze, jego zamazanie, problemy z zasilaniem itp. Dokładny opis postępowania przy ładowaniu programu opisany jest w sekcji Komunikacja z Vamsterem. Uwaga! Ponieważ istnieje kilka typów Vamstera, programy tworzone w Vamgrafie są przeznaczone tylko dla jednego z nich (programy zapisane jako *.vmb). W przypadku jeżeli program ładowany do Vamstera nie jest przeznaczony dla podłączonego typu Vamstera, VamLoader wypisuje komunikat: "Program nie jest przeznaczony dla podłączonego Vamstera. Program nie może być załadowany." Ładowanie programu jest przerywane. Podobnie jest w przypadku ładowania plików IntelHex do procesora ATMega32 wyposażonego w darmowy bootloader (plik boothex.bin). Informacje techniczne Vamster to urządzenie oparte na procesorze ATMega32 firmy Atmel. Vamster produkowany jest przez firmę Vamond z przeznaczeniem do sterowania i regulacji. Podstawowym narzędziem do tworzenia programów dla Vamstera jest Vamgraf również produkcji Vamond. Programy stworzone w Vamgrafie mają swój własny format i zawartość. Strona: 10
Zapisywane są do plików o rozszerzeniu ".vmb". I takie pliki (programy) można transmitować do Vamstera przy pomocy VamLoadera. Oprócz tego, ponieważ Vamster jest oparty na procesorze ATmega32, można na nim uruchamiać programy tworzone w innych środowiskach i kompilatorach (np. C, AVRGCC, Bascom itp.) Zwykle produktem końcowym jest plik w formacie IntelHex i takie pliki Vamloader również potrafi ładować do Vamstera. Vamster posiada własnego bootloadera i posługuje się własnym protokołem transmisji, dlatego aby transmisja przy pomocy VamLoadera się powiodła, w Vamsterze musi być oryginalny bootloader. Bootloader ten jest ładowany do procesora w trakcie produkcji i NIE JEST udostępniany w innej formie. Jego zamazanie sprawi, że nie można będzie używać programów Vamstera i programu VamLoader. Inne programy ładujące pliki programów w dowolnym formacie (np. IntelHex ale poza plikami ".vmb") będą wówczas oczywiście działać. Aby przywrócić bootloader w Vamsterze należy skontaktować się z firmą Vamond. Bootloader zajmuje ostatnie 512 bajtów pamięci FLASH mikrokontrolera. Zamazanie programu bootloadera możliwe jest przy użyciu programatora ISP ale oczywiście wówczas nie będzie można ładować programów przy pomocy VamLoadera. Dokładna dokumentacja Vamstera i Vamgrafa dostępna jest na stronie www.vamond.pl. 31-617 Kraków os. Złotego Wieku 29/30 www.vamond.pl email: biuro@vamond.pl Strona: 11