VamLoader wersja 2.44

VamLoader wersja 2.44
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:
[email protected].
Vamond
31-617 Kraków
os. Złotego Wieku 29
www.vamond.pl
email: [email protected]
Strona: 2
Licencja
Program
VamLoader
objęty
jest
umową
licencyjną
zawartą
"VamLoader_umowa_licencyjna.rtf" dostarczanym wraz z VamLoaderem.
w
pliku
Opis
Program przeznaczony jest do pracy w systemie WindowsXP SP2, WindowsVista i nowszych
systemów Windows. Do poprawnej pracy wymaga zainstalowanego frameworka .NET 3.5
SP1 (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 lub z Vamstera w wersji płatnej.
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, ATMega168 do których
załadowany został specjalny bootloader (plik bootHex.bin (M32) lub boot168.bin (M168))
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 rozpakować plik "VamLoaderInstall.zip"
i uruchomić plik „setup.exe”. Instalator programu może zażądać wcześniejszego
zainstalowania frameworka .NET 3.5 SP1 -można go pobrać z witryny internetowej firmy
Microsoft. Zwykle .NET 3.5 już jest zainstalowany w systemie. Po zainstalowaniu
frameworka należy ponownie uruchomić program instalujący VamLoadera.
Przy pierwszym uruchomieniu VamLoader przyjmie domyślne ustawienia
nie jest uruchamiany z linii poleceń - patrz Komunikacja z Vamsterem).
Vamloader pamięta ostatnie ustawienia i z takimi ponownie się uruchamia.
Strona: 4
(jeżeli
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: [email protected]
Strona: 11