Handspring-Visor mini-HOGYAN

1.1. A felel�ss�g teljes kiz�z�sa

Nem v�llalok felel�ss�get a dokumentum tartalm��rt. Az �tleteket, p�ld�kat �s a dokumentum marad�k r�sz�t saj�t felel�ss�gedre haszn�lhatod. Pontatlans�gok, hib�k el�fordulhatnak a sz�veg ezen �j v�ltozat�ban, amelyek persze k�rosak lehetnek a rendszeredre. Sz�val fontold meg minden l�p�sed, �s - b�r nagyon nem szimpatikus - nem v�llaljuk a felel�ss�get az esetlegesen kialakult hib�k�rt.

1.2. A szerz�

Ezt a dokumentumot eredetileg Ryan VanderBijl �rta �s alkalmank�nt karbantartotta. Sok ember tett hozz� �p�t� javaslatot. Rengeteg k�sz�nettel tartozom Miles Lottnak �s k�l�n�sen Greg Kroah-Hartmannak. Sz�vesen veszem a visszajelz�seket, de nem �g�rem, hogy minden javaslatot bele is teszek a doksiba.

M�sf�l �v ut�n v�gre friss�tettem az el�rhet�s�geimet, valamint alkalmank�nt a dokumentum �jabb verzi�ja megtal�lhat� a http://www.vanderbijlfamily.com/~rvbijl/visor/howto/ webhelyen.

�r�ln�k, ha �rn�l egy e-mailt, amikor siker�lt ez alapj�n a mini-HOGYAN alapj�n a Visor g�pedet m�k�d�sre b�rni.

1.3. Szerz�i jogok

Ez a dokumentum Ryan VanderBijl szellemi tulajdona. Copyright (c) 2000-2002. Szabadon terjeszthet� a GPL licencben le�rtak szerint (http://www.gnu.org/copyleft/gpl.html).

1.4. Magyar ford�t�s

A magyar ford�t�st Nov�k �ron k�sz�tette (2003.01.06). A lektor�l�st V�lgyi P�ter v�gezte el (2003.08.10). A dokumentum legfrissebb v�ltozata megtal�lhat� a Magyar Linux Dokument�ci�s Projekt honlapj�n.

2.1. T�mogatott eszk�z�k

A Linux USB-Visor modul �ltal t�mogatott PDA eszk�z�k a k�vetkez�k:

• Handspring Visor (�sszes)

• Palm USB eszk�z�k (�sszes)

• Sony Clie (�sszes)

2.2. K�vetelm�nyek

A Linux �s Visor �sszehangol�s�hoz, meg kell tan�tani a Linuxot, hogyan is v�gezze az alacsony szint� kommunik�ci�t az eszk�zzel, majd be kell �ll�tanod egy felhaszn�l�i programot, ami a t�nyleges kommunik�ci�t v�gzi.

2.3. Linux disztrib�ci�k

Sok disztrib�ci�t m�r eleve a sz�ks�ges t�mogat�sokkal adnak ki. Amennyiben ilyen v�ltozatod van, �s nem akarsz a rendszermag �jraford�t�s�val vesz�dni, ugorhatsz a Szinkroniz�l� szoftver fejezetre. �me - egy kor�ntsem teljes - lista azokr�l a disztrib�ci�kr�l, amelyek tartalmazz�k a sz�ks�ges modulokat:

• Mandrake 8.2 (vagy �jabb)

• Redhat 7.2 (vagy �jabb)

• Suse 8.0 (vagy �jabb)

Ezzel a paranccsal ellen�rizheted disztrib�ci�d alkalmass�g�t:

modprobe visor

Ha b�rmilyen hiba�zenetet kapsz v�laszul, akkor �jra kell ford�tani a rendszermagot a megfelel� t�mogat�s�rt. Ha nincs �zenet, akkor a disztrib�ci�d t�mogatja a Visor haszn�lat�t.

3.1. K�vetelm�nyek

P�r alapvet� dolog sz�ks�ges csup�n, �gymint sz�m�t�g�p, USB kapu, Visor k�zig�p (USB b�lcs�vel). Tov�bb� tudnod kell azt is, hogyan telep�ts �s ford�ts programokat, valamint a rendszermagot. Ha ezeket m�gsem tudod, van m�g n�h�ny lehet�s�ged: tanulni, h�vni egy szakembert vagy beszerezni egy disztrib�ci�t, amelyben van t�mogat�s.

Ha nincs USB vez�rl� a g�peden, �gy a Visor-t soros porton kereszt�l csatolhatod a g�pre (ebben az esetben m�r nem erre a dokumentumra van sz�ks�ged.), vagy veszel egy USB-t kezel� eszk�zt a g�pedbe (p�ld�ul USB k�rty�t, vagy �j alaplapot).

3.2. Rendszermag verzi�

A 2.4-es rendszermag az els�, amelyik USB t�mogat�ssal rendelkezik. A legfrissebb 2.4-es verzi� let�lthet� a ftp://ftp.kernel.org/pub/linux/kernel/v2.4/ webhelyr�l.

Az USB t�mogat�st visszaportolt�k a 2.2-es rendszermagokhoz is, a 2.2.18-as verzi�t�l kezdve. Sz�ks�g eset�n haszn�lhatod az itt felsorolt utas�t�sokat a leg�jabb 2.2-es sorozat eset�n is.

Itt az ideje a legfrissebb rendszermag let�lt�s�nek, �s ig�ny szerinti be�ll�t�s�nak! A k�vetkez�kben r�szekben tan�csokat kapsz az USB konfigur�l�s�hoz.

Ha m�r k�sz (ford�tott �s be�ll�tott) rendszermagod van, nem kell �jraind�tanod a g�pet! Csak a megfelel� modulokat kell beforgatni, be�ll�tani �s k�szen is vagy.

3.3. Az USB vez�rl� t�pusa

El�sz�r �llap�tsd meg milyen USB vez�rl�vel rendelkezel. Az USB vez�rl� a sz�m�t�g�ped USB be- �s kimeneti folyamatait kezel� hardver.

Intel lapkak�szlet� alaplapok tipikusan UHCI vez�rl�vel rendelkeznek. A legt�bb b�v�t�k�rtya OHCI vez�rl�t tartalmaz. A k�vetkez� parancs kiad�s�val (root felhaszn�l�k�nt) eld�ntheted milyen t�pussal rendelkezel.

lspci -v

Ha ehhez hasonl�t l�tsz:

USB Controller: ...... Flags: ..... I/O ports at ....

Akkor neked UHCI vez�rl�d van. Ha ezt l�tod:

USB Controller: ..... Flags: .... Memory at .....

Akkor OHCI vez�rl� van a g�pedben. Tov�bbi r�szleteket a http://www.linux-usb.org webhelyen tal�lsz. Az ide vonatkoz� rendszermag dokument�ci� az /usr/src/linux/Documentation/usb/usb.txt szint�n hasznos lehet a vez�rl� t�pus�nak meg�llap�t�s�hoz.

3.4. A rendszermag be�ll�t�sa �s ford�t�sa

Most be kell �ll�tanod �s le kell ford�tanod a rendszermagot. K�zvetlen�l a rendszermagba vagy modulk�nt is ford�thatod ezeket. Aj�nlott azonban modulk�nt ford�tani. Amennyiben k�zvetlen�l a rendszermagba ford�tasz, �jra kell majd ind�tanod a g�pet. A be�ll�t�s sor�n �gyelj az al�bbiak enged�lyez�s�re:

• USB support (USB t�mogat�s; CONFIG_USB)

• The preliminary USB Device Filesystem (Az el�zetes USB eszk�z f�jlrendszer; CONFIG_USB_DEVICEFS)

• A megfelel� vez�rl� - UHCI, vagy OHCI (CONFIG_USB_UHCI, vagy CONFIG_USB_OHCI)

• USB Serial Converter support (USB soros �talak�t� t�mogat�s; CONFIG_USB_SERIAL)

• USB Handspring Visor Driver (USB Handspring Visor eszk�zmeghajt�; CONFIG_USB_SERIAL_VISOR) (serial converter al-opci�)

Ezen a ponton kell eld�ntened, hogy akarsz-e Hotplug t�mogat�st. A Hotplug t�mogat�ssal egyetlen gombnyom�ssal (Hotsync) be tudod majd �ll�tani Visorodat. Olvasd el a Hotplug t�mogat�s fejezetet, �s f�leg a Hotplug rendszermag-be�ll�t�s, fejezetet, miel�tt ezt az utat v�lasztan�d.

Ford�tsd �s telep�tsd a rendszermagot. Ne feledkezz meg a lilo futtat�s�r�l sem. Amennyiben �j rendszermagot telep�tesz, m�g ne ind�ts �jra.

3.5. usbdevfs

Az usbdevfs parancs a /proc k�nyvt�rban helyez el inform�ci�kat az USB vez�rl�r�l. K�l�n�sen hasznos lesz majd hibakeres�skor. Ezt a k�vetkez� sor /etc/fstab f�jlhoz ad�s�val lehet enged�lyezni.

none /proc/bus/usb usbdevfs defaults 0 0

Ha �j rendszermagot telep�tesz, ett�l a pontt�l kezdve m�r �jraind�thatod a g�ped. Nem kell �jraind�tanod, ha csak modulk�nt adod az USB t�mogat�st a m�r l�tez� rendszermagodhoz.

3.6. /dev bejegyz�sek k�sz�t�se

Ha a Linux disztrib�ci�d nem t�mogatja az USB portos Visorokat, vagy NEM haszn�lsz devfs f�jlrendszert (nem ugyanaz, mint a usbdevfs), akkor l�tre kell hoznod az USB tty eszk�z�ket.

Ha devfs f�jlrendszert haszn�lsz, ezek az eszk�z�k automatikusan l�trej�nnek /dev/usb/tts/{0,1,...} n�ven; vagyis ugorhatsz A modulok haszn�lata fejezetre.

Ha nem haszn�lsz devfs f�jlrendszert, a k�vetkez� (root felhaszn�l�k�nt kiadott) paranccsal l�trehozhatod a megfelel� eszk�z�ket:

mknod /dev/ttyUSB0 c 188 0 mknod /dev/ttyUSB1 c 188 1 mknod /dev/ttyUSB2 c 188 2 mknod /dev/ttyUSB3 c 188 3 etc... chmod 666 /dev/ttyUSB*

255 kapcsolatot, kaput vagy eszk�zt tudsz �gy be�ll�tani, de (hacsak nem egyn�l t�bb USB-s eszk�z�d van) tal�n csak az els� n�h�nyra lesz sz�ks�ged. A chmod enged�lyezi m�s felhaszn�l�k sz�m�ra a Visor el�r�s�t. A szerz� v�lem�nye szerint ez biztons�gos egy szem�lyi sz�m�t�g�pen. T�bbfelhaszn�l�s g�peken bizony�ra jobban belem�lyednek a biztons�gi k�rd�sekbe (vil�gos�tsatok fel).

A Visor csatlakoz�sakor k�t kapu ny�lik meg. (Legt�bb ember sz�m�ra ez a /dev/ttyUSB0, �s /dev/ttyUSB1) lesz. Az els� kapu (zero), egy �ltal�nos kapcsolatot hoz l�tre. A m�sodik kapu a hotsync r�sz�re kell. Ez a lehet�s�g a j�v� fejleszt�i sz�m�ra van fenntartva; p�ld�ul f�jlrendszerek exportja a Visorr�l. Hasznos dolog egy hivatkoz�st (link) l�trehozni a hotsync portj�ra, hogy a szinkroniz�l� szoftver alapb�l a megfelel� eszk�zt haszn�lja. A k�vetkez�k�ppen teheted meg:

cd /dev ln -s /dev/ttyUSB1 pilot ln -s /dev/ttyUSB1 palm

A pilot-xfer programcsomag a /dev/pilot k�nyvt�rat haszn�lja alapb�l. A coldsync a /dev/palm k�nyvt�rra �ll be alaphelyzetben. Hozd l�tre az eszk�z�ket �s a hivatkoz�sokat sz�ks�g szerint. A sz�rakoz�s kedv��rt hozz l�tre hivatkoz�st a /dev/visor �s a /dev/ttyUSB1 k�z�tt csak, mivel Visor, �s nem egy Pilot (vagy Palm(tm)) g�ped van . Az aktu�lis eszk�zsz�m v�ltozhat, att�l f�gg�en mennyi (akt�v?) soros USB eszk�z van a g�pedhez csatlakozva. A syslog tartalmaz az aktu�lisan haszn�lt eszk�zre vonatkoz� megjegyz�seket. T�rt�netesen ez az �tlet egy bejegyz�s l�trehoz�s�ra a /proc alatt, ami tartalmazza a sz�ks�ges inform�ci�kat.

3.7. A modulok haszn�lata

Azoknak, akik modulk�nt ford�tott�k az USB k�dot, a rendszermagba is be kell illeszteni�k ezeket. A k�vetkez� parancs kiad�s�val tehetik ezt meg (root felhaszn�l�k�nt):

/sbin/modprobe usb-uhci /sbin/modprobe usb-ohci /sbin/modprobe visor

Egy fontos megjegyz�s: az aktu�lis eszk�zmeghajt�/eszk�z kapcsolat a /dev/ttyUSB* k�nyvt�rban, a rendszermag-mem�ri�ban a hotsync gomb megnyom�s�ig nem j�n l�tre. Ez�rt ha a programot haszn�lni akarod, miel�tt megnyomn�d a hotsync gombot, az nem fog m�k�dni.

4.1. �ltal�nos

K�t szoftvercsomag van amely kommunik�lni k�pes a Visorral. Az egyik a coldsync, a m�sik a pilot-link. Ezek a programok parancssorb�l futnak �s "alacsony szint�" szinkroniz�l�st v�geznek az aktu�lis adatb�zisokon. T�bbf�le fel�letet biztos�tanak a csatorn�k sz�m�ra. Felt�telezem, hogy tudod, hogyan kell programot let�lteni �s telep�teni. Ha nem tudod, tanuld meg. (Biztosan tudsz el�re ford�tott csomagokat telep�teni, de azt nem szeretem. ;-).

4.2. coldsync

A coldsync megtal�lhat� a http://coldsync.org/ webhelyen.

4.3. pilot-link

A pilot-link megtal�lhat� a http://www.pilot-link.org/ webhelyen. Ha Palm Desktop st�lus� eszk�zt haszn�lsz, erre lesz sz�ks�ged.

4.4. Itt az id� a szinkroniz�l�sra

Ezen a ponton m�r a tesztel�s� a f�szerep, hogy megtudjuk, minden renden m�k�dik-e. Term�szetesen a Visornak az USB portra csatolt b�lcs�ben kell lennie. A megfelel� moduloknak be kell t�lt�dni�k.

FIGYELEM! a hotsync gombot a szoftver futtat�sa EL�TT kell megnyomni! A visor vez�rl� bejegyz�st k�sz�t a syslogba, �s alkalmank�nt a /proc/drivers/visor f�jlba. Tegy�k fel, hogy a meghajt�program a /dev/ttyUSB0 �s /dev/ttyUSB1 k�nyvt�rakhoz csatlakozik, ekkor a Visor ment�se �gy n�z ki (megfelel� program kiv�lasztand�):

cd ~ mkdir visorbackup coldsync -p /dev/ttyUSB1 -mb visorbackup pilot-xfer -p /dev/ttyUSB1 -b visorbackup

Hiba�zenet eset�n, mint p�ld�ul "unable to bind to the port", olvasd �jra az el�z� fejezetet. Minden m�s hib�val a Hibaelh�r�t�s fejezet foglalkozik.

4.5. Palm Desktop v�ltozatok

Van n�h�ny Palm desktop v�ltozat. Nem tudtam m�g mindet tesztelni. J�v�beni tervem, hogy majd �rok r�luk valamit ide. Ha van valamilyen tapasztalatod ez �gyben, k�ldd el lev�lben �s beker�l ide. Eddigi ismereteim szerint mind a pilot-link k�nyvt�rakat haszn�lja a Visorral t�rt�n� kommunik�ci�ban.

Ezeket ismerem:

• J-Pilot

• KPilot (KDE)

• Gnome-Pilot (GNOME)

4.6. K�sz!

Ha eddig a pontig eljutott�l, k�sz vagy! Tudod telep�teni a Visort, menteni, �s szinkroniz�lni az inform�ci�kat. Gratul�lok! V�rom a h�laleveleket! A k�vetkez� r�sz a PPP kapcsolat l�trehoz�s�r�l �s a Hotplug t�mogat�sr�l sz�l.

5.1. Hotplug rendszermag-be�ll�t�s

A rendszermag be�ll�t�sa sor�n enged�lyezned kell a "Support for hot-pluggable devices" t�mogat�st a "General Options" r�szben. Ez a CONFIG_HOTPLUG opci�. A ford�t�sr�l �s �jra-telep�t�sr�l ne feledkezz meg!

5.2. Hotplug telep�t�s

Kell hozz� egy hotplug szkript a linux-hotplug honlapr�l, amely a http://linux-hotplug.sourceforge.net webhelyen tal�lhat�. Rpm, gz vagy tgz csomagok form�j�ban is megtal�lhat�. A csomagok telep�t�se el�tt �rdemes elolvasni a telep�t�st r�szletesen le�r� README f�jlt. Ha csak a Visor hotplug t�mogat�st akarod be�ll�tani, tal�n el�g lesz a k�vetkez�ket tenned:

gzip -dc hotplug-2002_08_26.tar.gz | tar xvf - cp hotplug-2002_08_26/sbin/hotplug /sbin/hotplug cp -r hotplug-2002_08_26/etc/hotplug /etc

5.3. A Visor meghajt� be�ll�t�sa

Amikor minden k�sz �s j�, a hotsync gomb megnyom�s�ra egy /etc/hotplug/usb/visor nev� (futtathat�) szkriptnek k�ne elindulni .

#!/bin/sh /bin/su rvbijl -c /usr/local/bin/coldsync

Term�szetesen a rvbijl param�tert cser�ld ki a rendes felhaszn�l�i neveddel. �s tedd futtathat�v� a szkriptet!

6.1. �tletek

• Van egy ismert hiba a Visorn�l, ami miatt �jra kell ind�tani a Visort szinkroniz�l�s el�tt. Ez a legegyszer�bb megold�s szinkroniz�l�si hib�k eset�n. Ha a szoftveres reset nem m�k�dik, �s m�s USB eszk�z is van a g�pen, egy hardveres �jraind�t�s (hard reset) seg�thet. (El�tte m�st pr�b�lj meg ink�bb.)

• Telep�tetted az �j rendszermagot/modulokat?

• N�zd meg, hogy az �sszes modul fut-e. Az lsmod parancs eredm�nyek�ppen legal�bb a k�vetkez�knek kell megjelenni�k: visor, usbserial, usbcore; �s ezek k�z�l az egyik: usb-uhci vagy usb-ohci.

• �j rendszermagot telep�tett�l. �jraind�tottad a rendszert?

• Enged�lyezve van az USB haszn�lata? (Ellen�rizd a BIOS-ban. M�s oper�ci�s rendszerekn�l m�k�dik?)

• Megjelennek az eszk�z�k (p�ld�ul "usb-serial") a /proc/devices k�nyvt�r alatt? �s a /proc/bus/usb/devices k�nyvt�r alatt? Ha nem, akkor a meghajt�program nem t�lt�d�tt be rendesen.

• A hotsync megnyom�sa ut�n megjelenik valami a syslogban?

• BIZTOS, hogy a szinkroniz�l�s (program futtat�sa) EL�TT nyomtad meg a hotsdync gombot?

• E-mail: <usbvisor-unix@lists.sourceforge.net>.