JYMAG - Informacje o programie

To jest plik README dla JYMAG (Jig Your Music and Graphics), programu do komunikacji z telefonami komórkowymi.

Główną funkcjonalnością programu JYMAG jest pobieranie i wysyłanie multimediów i innych obiektów z i do telefonów lub urządzeń opartych na komendach AT, jak telefon komórkowy marki Sagem (przetestowane na Linuksie z telefonem "Sagem MY X5-2").

JYMAG może też być używany z innymi telefonami i urządzeniami (modemy) lub służyć jako terminal szeregowy ogólnego przeznaczenia lub jako biblioteka Javy dla programistów.

Autor: Bogdan Drozdowski, bogdro AT users . sourceforge . net (polski akceptowany, napisz '[SOFT]' w tytule).

Licencja: GPLv3+ na program, Licencja MIT na pomocnicze programy uruchamiające (jymag*.exe). Zobacz plik COPYING.

Uruchamianie

Wymagania:

RxTx z jednej ze stron:
lub dowolne oprogramowanie równoważne
JRE, Java SE Runtime Environment >= (1.)6.0
uprawnienia do korzystania z portów szeregowych
uprawnienia do blokowania portów szeregowych mogą być wymagane przez RxTx. Na Un*x dodanie użytkownika uruchamiającego JYMAG do grup uucp i lock powinno wystarczyć. Jeśli nie, należy dodać mu uprawnienia do zapisu w katalogu /var/lock.

Uruchom ant jar w katalogu JYMAG, aby zbudować aplikację.

Korzystając z Apache NetBeans: otwórz katalog JYMAG jako projekt NetBeans i kliknij "Run" (lub wciśnij F6).

Ręcznie (po rozpakowaniu):

kliknij dwukrotnie plik JYMAG-X.Y\dist\JYMAG.jar (działa na MS Windows) albo
run.bat (na MS Windows) albo
./run.sh (na Un*x) albo
java -jar JYMAG/dist/JYMAG.jar (na Un*x) albo
java -jar JYMAG\dist\JYMAG.jar (na MS Windows)

Możesz też zrobić jedną z następujących rzeczy:

Pod Un*x: skopiuj JYMAG-X.Y\dist\JYMAG.jar i run.sh do jednego katalogu w dogodnym miejscu (na przykład tam, gdzie wskazuje PATH). Uruchomienie ./run.sh wystarczy. Program java musi być w Twojej zmiennej środowiskowej PATH.
Pod Windows: podwójne kliknięcie na plik JAR powinno wystarczyć. Jeśli nie, skopiuj JYMAG-X.Y\dist\JYMAG.jar i run.bat do jednego katalogu w dogodnym miejscu (na przykład tam, gdzie wskazuje PATH). Uruchomienie run.bat wystarczy. Gdy korzysta się z drugiego sposobu, program java też musi być w Twojej zmiennej środowiskowej PATH.

Uruchamianie w języku domyślnym (bez tłumaczeń)

Wymagania:

RxTx z jednej ze stron:
lub dowolne oprogramowanie równoważne
JRE, Java SE Runtime Environment >= (1.)6.0
uprawnienia do korzystania z portów szeregowych
uprawnienia do blokowania portów szeregowych mogą być wymagane przez RxTx. Na Un*x dodanie użytkownika uruchamiającego JYMAG do grup uucp i lock powinno wystarczyć. Jeśli nie, należy dodać mu uprawnienia do zapisu w katalogu /var/lock.

Korzystając z Apache NetBeans: wybierz konfigurację English z listy na górze i kliknij przycisk "Run".
Możesz także otworzyć katalog JYMAG jako projekt NetBeans, kliknij prawym przyciskiem na główny element projektu w drzewie projektu po lewej stronie okna (podoknie "Projects"), po czym kliknij "Properties". W drzewie kliknij "Run" i wpisz

	-Duser.language=en -Duser.country=US

w polu "VM Options". Kliknij OK i kliknij "Run" (lub wciśnij F6).

Ręcznie (po rozpakowaniu):

run-en.bat (na MS Windows) albo
run-en.sh (na Un*x) albo
java -jar -Duser.language=en -Duser.country=US JYMAG/dist/JYMAG.jar (na Un*x) albo
java -jar -Duser.language=en -Duser.country=US JYMAG\dist\JYMAG.jar (na MS Windows)

Możesz też zrobić jedną z następujących rzeczy:

Pod Un*x: skopiuj JYMAG-X.Y\dist\JYMAG.jar i run-en.sh do jednego katalogu w dogodnym miejscu (na przykład tam, gdzie wskazuje PATH). Uruchomienie ./run-en.sh wystarczy. Program java musi być w Twojej zmiennej środowiskowej PATH.
Pod Windows: skopiuj JYMAG-X.Y\dist\JYMAG.jar i run-en.bat do jednego katalogu w dogodnym miejscu (na przykład tam, gdzie wskazuje PATH). Uruchomienie run-en.bat wystarczy. Gdy korzysta się z drugiego sposobu, program java też musi być w Twojej zmiennej środowiskowej PATH.

Kompilacja (jeśli trzeba)

Wymagania do kompilacji:

RxTx z jednej ze stron:
lub dowolne oprogramowanie równoważne
JDK, Java SE Development Kit >= (1.)6.0

Kompilacja z wykorzystaniem Apache NetBeans: otwórz katalog JYMAG jako projekt NetBeans i kliknij "Build Main Project" (lub wciśnij F11), jeśli to jest główny projekt (wytłuszczona czcionka). Jeśli to nie jest główny projekt, kliknij prawym na ikonę projektu JYMAG i kliknij "Build".

Kompilacja z wykorzystaniem "ant" z NetBeans (może być wymagane podanie pełnej ścieżki do programu "ant"):

	cd JYMAG-X.Y
	ant jar

Kompilacja ręczna (może być wymagane podanie pełnej ścieżki do programu "javac"):

na Un*x spróbuj

		cd JYMAG/src/BogDroSoft/jymag/
		javac *.java

na MS Windows to może zadziałać:

		cd JYMAG\src\BogDroSoft\jymag
		javac *.java

Korzystanie z programu (GUI - tryb graficzny)

Ustawienie telefonu: podłącz go do komputera, używając kabla, IrDA lub czegokolwiek, co działa. Włącz transmisję w telefonie, jeśli trzeba. Jeśli korzystasz z kabla, wybierz w konfiguracji prędkość automatyczną.

Domyślne parametry JYMAG powinny działać w większości przypadków. Jeśli trzeba, możesz ustawić parametry portu ręcznie.

Nie ma potrzeby łączyć się z telefonem. Zacznij od wybrania karty, która Cię interesuje (zdjęcia, dzwonki, ...). Kliknij "Pobierz listę" ("Get list"), aby połączyć się z telefonem i pobrać listę elementów. Zaznacz elementy, które chcesz pobrać i kliknij "Pobierz zaznaczone" ("Download selected"). Wybierz katalog docelowy. Pobrane pliki znajdą się w wybranym miejscu.

Aby wysłać element, po prostu kliknij przycisk "Wyślij" ("Upload"). Pobieranie listy nie jest wymagane. Możesz też przeciągnąć i upuścić pliki, które chcesz wysłać, na dowolną z tabel (za wyjątkiem budzików i wiadomości SMS).

Aby edytować budzik, kliknij dwukrotnie komórkę tabeli. Zmień wartości, ale zachowaj niezmieniony format danych.

Aby odczytać wiadomość SMS, zaznacz ją w tabeli i wybierz "Pobierz zaznaczone" ("Download selected"). Pojawi się nowe okno umożliwiające przeczytanie całej wiadomości.

Aby wysłać wiadomość SMS, kliknij przycisk "Wyślij" ("Upload"). Pojawi się nowe okno umożliwiające wpisanie numeru telefonu i treści wiadomości.

Korzystanie z programu (linia poleceń)

Obsługiwane są następujące opcje linii poleceń (niewrażliwe na wielkość liter):

--conf <plik> - odczytaj konfigurację z <pliku>
--databits <5,6,7,8> - ustaw liczbę bitów danych (domyślnie: 8)
--delete-after-download - skasuj elementy pobrane pomyślnie
--delete-alarm <N> - skasuj budzik o numerze N
--delete-element <ID> - skasuj element (plik) o danym identyfikatorze ID
--delete-sms <N> - skasuj wiadomość SMS o ID=N
--dial-data <numer> - wykręca dany numer dla połączenia danych
--dial-voice <numer> - wykręca dany numer dla połączenia głosowego
--download-all-animations - pobierz wszystkie animacje/filmy z telefonu i wyjdź
--download-all-events - pobierz wszystkie zdarzenia z telefonu i wyjdź
--download-all-photos - pobierz wszystkie zdjęcia z telefonu i wyjdź
--download-all-ringtones - pobierz wszystkie dzwonki z telefonu i wyjdź
--download-all-todo - pobierz wszystkie zadania do zrobienia z telefonu i wyjdź
--download-all-vcards - pobierz wszystkie wpisy książki telefonicznej z telefonu i wyjdź
--download-all - łączy wszystkie opcje "download" i wychodzi z programu
--download-dir <dir> - ustawia domyślny katalog pobierania
--flow <none,soft,hard,soft+hard> - ustawia tryb kontroli przepływu (domyślnie: none)
--hangup - rozłącza bieżące połączenie, jeśli jakieś jest
--help - wyświetla pomoc
--lang LL_CC_VV - wybiera język dla JYMAG: LL to język, CC to kod kraju, VV to wariant. Rozdziel je podkreśleniami. Wymagane jest tylko LL.
--license, --licence - wyświetla informacje o licencji
--list-alarms - wyświetla budziki w telefonie
--list-elements - wyświetla elementy (pliki) w telefonie
--list-sms - wyświetla wiadomości SMS w telefonie
--parity <none, even, odd, space, mark> - ustawia tryb kontroli parzystości (domyślnie: none)
--port <nazwa> - ustawia domyślny port
--scan - skanuje dostępne porty na odpowiedzi "OK" i wychodzi
--send-cmd-file <plik> - wysyła zawartość podanego pliku (jako komendy, dane lub mieszankę)
--send-sms <numer> <treść> - wyślij daną <treść> jako SMS do odbiorcy o numerze <numer>
--speed <1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 500000, 576000, 921600, 1000000, 1152000, 1500000, 2000000, 2500000, 3000000, 3500000, 4000000> - ustawia prędkość transmisji na porcie (domyślnie: 115200)
--stopbits <1,1.5,2> - ustawia liczbę bitów stopu (domyślnie: 1)
--update-alarm "DD/MM/YY,HH:MM:SS",N,"dni" - aktualizuje dany budzik w telefonie. N to numer budzika. Dni są numerami rozdzielonymi przecinkami (1-Poniedziałek) lub 0 oznaczającym wszystkie dni
--upload <plik> - wysyła dany plik do telefonu i wychodzi
--version, -v - wyświetla wersję programu

Konwertowanie dzwonków

Niektóre dzwonki pobrane z telefonu mogą być w formacie AMR. Możesz przerobić je na inne formaty, korzystając z innego oprogramowania, jak darmowy "Mobile Media Converter". Jeśli ten program nie działa, skorzystajcie z programu FFMPEG dołączonego do "Mobile Media Converter" w następujący sposób:

	ffmpeg -i Ring.amr -ar 44100 Ring.wav

Aby przerobić dzwonek na format WAV przyjmowany przez telefon, skorzystaj z następującej komendy:

	ffmpeg -i <ringtone file> -ar 8000 -t 10 -ac 1 -acodec adpcm_ima_wav <output file>.wav

(liczba po "-t" to czas trwania dzwonka w sekundach). Udało mi się wysłać dzwonki stworzone tylko powyższą komendą. Być może da się wysłać dłuższe dzwonki, w większych częstotliwościach próbkowania, stereo itd, ale nie próbowałem tego wszystkiego (moje 30-sekundowe dzwonki są odrzucane).

Możesz też użyć IMYplay, aby przekonwertować dzwonki IMY na pliki próbek, po czym na pliki WAV.

Tłumaczenie

Aby przetłumaczyć program na swój język, skopiuj każdy plik *.properties. Zmień nazwy tych kopii, aby kończyły się kodem Twojego języka i kraju, na przykład: AboutBox_en_GB.properties, MainWindow_de_DE.properties, RawCommunicator_pt_BR.properties

Otwórz każdy plik w trybie UTF-8 i przetłumacz słowa PO znaku "=" w kazdej linii. Gdy wszystkie pliki są skończone, wyślij mi je. Pamiętaj, UTF-8, nie ISO-8859-*, nie windows-*, nie cp*.

UWAGA: Jeśli zmienisz słowa przed znakiem "=", Twoje tłumaczenia nie będą widziane przez program.

UWAGA: Alternatywnie, możesz skorzystać ze środowiska Apache NetBeans, aby przetłumaczyć program. Otwórz projekt JYMAG, kliknij prawym klawiszem na dowolny z głównych plików "properties", wybierz "Add" i "Locale". Wybierz swój język i kliknij OK. Teraz kliknij prawym klawiszem na wybrany plik i wybierz "Open". Edytuj napisy w swoim języku.

Jeśli nie działa

Port telefonu nie pojawia się na liście.
Nie wina JYMAG. Sprawdź, czy:
- telefon łączy się połączeniem szeregowym (nie jako pamięć na USB, na przykład)
- zainstalowano prawidłowy sterownik do kabla/IrDA/innych urządzeń
- port telefonu nie jest już używany
- masz najnowsze RxTx
Pobieranie listy się nie udaje.
Kliknij "Skanuj porty" ("Scan ports"). Jeśli otrzymano odpowiedź, właściwy port powinien zostać wybrany z listy. Jeśli nie, pojawi się błąd. Spróbuj zamknąć program i uruchomić go ponownie co najmniej jeszcze 3 razy. Jeśli to nie pomoże, sprawdź swoje sterowniki i połączenie.
Program się nie uruchamia i wyświetla wiadomości "class not found/java.lang.NoClassDefFoundError".
Uruchom program java, podając pełną ścieżkę, na przykład /usr/bin/java -jar JYMAG.jar. Możesz spróbować dodać ścieżkę do RxTx do swojej zmiennej środowiskowej CLASSPATH (stwórz taką, jeśli nie masz). Spróbuj dodać zarówno katalog zawierający RXTXcomm.jar, jak i ścieżkę do tego pliku do zmiennej CLASSPATH.
Pobrane elementy są uszkodzone.
Moje czasem też są uszkodzone. Nic na to nie poradzę. Niektóre elementy ściągają się poprawnie za pierwszym razem, niektóre wymagają kliku prób, a inne wymagają wielu prób. Jako że to raz działa, a raz nie, to nie jest to wina JYMAG. Skoro to działa, to program jest napisany prawidłowo. To połączenie jest zawodne. Oryginalny program był jeszcze gorszy - połączenie zbyło zrywane w trakcie transmisji i trzeba było w kółko klikać "Connect", a niektóre zdjęcia i tak były uszkodzone. Miej cierpliwość. Jeśli wiesz, jak to poprawić, skontaktuj się ze mną (adres e-mail jest na górze tego pliku).
JYMAG wysyła plik, ale telefon go odrzuca.
Sprawdź, czy telefon przyjmuje dany format pliku, albo korzystając z przycisku możliwości w oknie głównym, albo wysyłając
```
   	AT+KPSCAP="X"
```
(z cudzysłowami) w oknie "Komunikacja ręczna" ("Manual commands"). Za X można wstawić: PICTURES, SOUNDS, VTODO, VEVENT, VCARDS, ANIMATIONS.

Zgłaszanie problemów

Wszelkie defekty i problemy mogą być zgłaszane przez e-mail (adres możesz znaleźć na górze tego pliku) lub przez stronę zarządzania defektami na SourceForge (po angielsku).

Wszelkie propozycje usprawnień mogą być zgłaszane przez e-mail (adres możesz znaleźć na górze tego pliku) lub przez stronę zarządzania zgłoszeniami na SourceForge (po angielsku).

Sprawdź, czy masz najnowszą wersję JYMAG.
Dołącz swoje numery wersji Javy i RxTx. Sprawdź, czy program działa ze starszą/nowszą wersją Java/RxTx. Jeśli działa ze starszą wersją, a nie z nową, problem rozwiązany, ale i tak przyślij mi problematyczne numery wersji.
Podaj dokładne kroki prowadzące do błędu, jeśli to możliwe. To ułatwi znalezienie problemu.
Jeśli program się zamknął, dołącz jymag.log w swoim zgłoszeniu. Plik ten powinien znajdować się w katalogu bieżącym JYMAG.
Jeśli program zamknął się normalnie, ale jymag.log dalej istnieje po zamknięciu programu i nie jest pusty, dołącz go w swoim zgłoszeniu.
Spróbuj z innym telefonem lub plikiem, jeśli możliwe.
Zbierz wszystkie informacje z powyższych kroków oraz wszelkie dodatkowe informacje, które jesteś w stanie podać (jak minimalistyczny plik powodujący problem), i dodaj je do zgłoszenia defektu.