PLD-doc/book: pl_book__master.docb pl_book__siec/pl_siec.chp pl_book__siec/pl_siec__dsl_neo_sagem.se...

qwiat cvs w pld-linux.org
Sob, 19 Mar 2005, 15:01:16 CET


Author: qwiat
Date: Sat Mar 19 15:00:57 2005
New Revision: 5611

Added:
   PLD-doc/book/pl_book__siec/pl_siec__dsl_neo_sagem.sec
   PLD-doc/book/pl_book__siec/pl_siec__dsl_neo_thompson.sec
Removed:
   PLD-doc/book/pl_book__siec/pl_siec__neo_sagem.sec
   PLD-doc/book/pl_book__siec/pl_siec__neo_thompson.sec
Modified:
   PLD-doc/book/pl_book__master.docb
   PLD-doc/book/pl_book__siec/pl_siec.chp
Log:
-ujdenolicenie nazewnitwa plikow opisujacych konfiguracje laczy xDSL


Modified: PLD-doc/book/pl_book__master.docb
==============================================================================
--- PLD-doc/book/pl_book__master.docb	(original)
+++ PLD-doc/book/pl_book__master.docb	Sat Mar 19 15:00:57 2005
@@ -45,8 +45,8 @@
 <!ENTITY siec SYSTEM "pl_book__siec/pl_siec.chp">
 <!ENTITY siec_basic SYSTEM "pl_book__siec/pl_siec__basic.sec">
 <!ENTITY siec_ethernet SYSTEM "pl_book__siec/pl_siec__ethernet.sec">
-<!ENTITY siec_neo_sagem SYSTEM "pl_book__siec/pl_siec__neo_sagem.sec">
-<!ENTITY siec_neo_thompson SYSTEM "pl_book__siec/pl_siec__neo_thompson.sec">
+<!ENTITY siec_dsl_neo_sagem SYSTEM "pl_book__siec/pl_siec__dsl_neo_sagem.sec">
+<!ENTITY siec_dsl_neo_thompson SYSTEM "pl_book__siec/pl_siec__dsl_neo_thompson.sec">
 <!ENTITY siec_dsl_ethernet SYSTEM "pl_book__siec/pl_siec__dsl_ethernet.sec">
 <!ENTITY siec_gprs SYSTEM "pl_book__siec/pl_siec__gprs.sec">
 <!ENTITY siec_nat SYSTEM "pl_book__siec/pl_siec__nat.sec">

Modified: PLD-doc/book/pl_book__siec/pl_siec.chp
==============================================================================
--- PLD-doc/book/pl_book__siec/pl_siec.chp	(original)
+++ PLD-doc/book/pl_book__siec/pl_siec.chp	Sat Mar 19 15:00:57 2005
@@ -4,8 +4,8 @@
 <para>W tym rozdziale znajdziesz informacje dotyczące konfiguracji sieci</para>
 &siec_basic;
 &siec_ethernet;
-&siec_neo_sagem;
-&siec_neo_thompson;
+&siec_dsl_neo_sagem;
+&siec_dsl_neo_thompson;
 &siec_dsl_ethernet;
 <!--&siec_gprs;-->
 &siec_nat;

Added: PLD-doc/book/pl_book__siec/pl_siec__dsl_neo_sagem.sec
==============================================================================
--- (empty file)
+++ PLD-doc/book/pl_book__siec/pl_siec__dsl_neo_sagem.sec	Sat Mar 19 15:00:57 2005
@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<section id="siec_dsl_neo_sagem">
+	<title>Neostrada+ z modemem USB firmy Sagem</title>
+	<section id="siec_dsl_neo_sagem_wprowadzenie">
+		<title>Wprowadzenie</title>
+		<para>Na samym początku musimy włączyć
+			w biosie komputera port USB oraz
+			zainstalować takie pakiety jak <productname>eagle</productname> oraz
+			<productname>kernel-usb-eagle</productname>. Dodatkowo musimy jeszcze zainstalować pakiet <productname>ppp</productname>. Jeżeli 
+			zainstalowałeś system
+			z płytki MINI-iso, powinieneś je tam znaleźć.
+			W przypadku, kiedy instalowałeś system z dyskietki,
+			znajdziesz je na jednej lub kilku dyskietek "addons"
+			czyli dyskietek zawierających dodatkowe pakiety.</para>
+	</section>
+	<section id="siec_dsl_neo_sagem_instalacja">
+		<title>Instalacja</title>
+		<para>Przystępujemy do instalacji. Należy przejść do
+			do lokalizacji w której znajdują się owe pakiety
+			a następnie wydać następujące polecenie.</para>
+		<screen># rpm -Uvh kernel-usb-eagle* eagle-usb* ppp*</screen>
+<para>Kiedy już upewniliśmy się, że mamy włączony port USB w biosie, musimy
+	go zainicjować w systemie. Możemy to zrobić za pomocą pliku 
+	<filename>/etc/modules.conf</filename> w którym umieszczamy przykładową linijkę</para>
+<screen>alias usb-controller usb-uhci</screen>
+<para>Jeżeli posiadasz zainstalowany kernel z serii 2.6.x powinieneś umieścić następujący wpis w 
+	pliku <filename>/etc/modprobe.conf</filename></para>
+<screen>alias usb-controller uhci-hcd</screen>
+<para>Po ponownym uruchomieniu komputera powinniśmy posiadać w systemie
+	obecny moduł <emphasis>usb-uhci</emphasis> (<emphasis>uhci-hcd</emphasis> dla
+	jądra 2.6.x). W przypadku, kiedy ten moduł po prostu nie zadziała
+	spróbuj załadować <emphasis>usb-ohci</emphasis> (<emphasis>ohci-hcd</emphasis> dla jądra 
+	2.6.x). Jeżeli podłączyłeś modem do portu USB 2.0
+	powinieneś użyć modułu <emphasis>usb-ehci</emphasis> (<emphasis>ehci-hcd</emphasis> dla
+	jądra 2.6.x).</para>
+<para>Możemy teraz podłączyć modem do komputera. Nasze 
+	urządzenie zostanie od razu wykryte i zainicjowane w systemie.
+	Poprawna inicjalizacja powinna zakończyć się załadowaniem do pamięci
+	modułu <command>adiusbadsl</command>. UWAGA! Jeżeli posiadasz kernel 2.6.x powinieneś
+	załadować moduł <emphasis>eagle-usb</emphasis>.</para>
+</section>
+<section id="siec_dsl_neo_sagem_konf">
+	<title>Konfiguracja</title>
+	<para>Możemy zacząć od pliku <filename>/etc/resolv.conf</filename>. Opis znajdziecie w
+		rozdziale poświęconym konfiguracji sieci. Przystępujemy teraz
+		do konfiguracji pliku <filename>/etc/eagle-usb/eagle-usb.conf</filename>. Należy 
+		w nim zmienić wartość opcji VPI na taką jaką widzicie poniżej.</para>
+<screen>VPI=00000000</screen>
+<para>Skonfigurujemy teraz demona PPP. Utworzonemu w wyniku instalacji plikowi <filename>/etc/ppp/options</filename>
+	zmieniamy nazwę na <filename>options.old</filename>. Tworzymy nowy plik options z zawartością taką jaka została
+	przedstawiona na poniższym listingu. Najważniejszą rzeczą jest podanie w nim
+	nazwy użytkownika, która jest konieczna do ustanowienia połączenia.
+	Możemy również dopisać opcję debug, jeśli chcemy być informowani
+	o tym co się dzieje.</para>
+<screen># cat /etc/ppp/options
+user "user w neostrada.pl"
+mru 1492
+mtu 1492
+noipdefault
+defaultroute
+usepeerdns
+noauth
+#ipcp-accept-remote
+#ipcp-accept-loacal
+nobsdcomp
+nodeflate
+nopcomp
+novj
+novjccomp
+#novaccomp -am
+noaccomp -am
+#włączam debug.
+debug</screen>
+<para>Musimy jeszcze wpisać hasło. Aby tego dokonać wyedytujmy plik
+	<filename>/etc/ppp/chap-secrets</filename>. UWAGA! Jeżeli się pomylisz i wpiszesz hasło do
+	<filename>/etc/ppp/pap-secrets</filename>, hasło nie zadziała.</para>
+<screen># cat /etc/ppp/chap-secrets
+user w neostrada.pl	*	haslo	*</screen>
+<para>Na tym zakończymy konfigurację połączenia z Neostradą. Jesteśmy już
+	gotowi aby wszystko uruchomić.</para>
+</section>
+<section id="siec_dsl_neo_sagem_run">
+	<title>Uruchomienie i post konfiguracja</title>
+	<para>Najbardziej wygodnym sposobem będzie wykorzystanie mechanizmu <emphasis>rc-scripts</emphasis>
+		do uruchamiania usługi. Poniżej zamieszczam przykład pliku 
+		<filename>/etc/sysconfig/interfaces/ifcfg-ppp0</filename>, który możesz wykorzystać.</para>
+	<screen>PPPOA_EAGLE=yes
+DEVICE=ppp0
+ONBOOT=yes
+PERSIST=yes
+HOLDOFF=10
+USER='user w neostrada.pl'
+PPPOA_NETADDR=192.168.60.30/24
+ONBOOT=yes</screen>
+	<para>Aby uruchomić neostradę wystarczy wydać polecenie takie jak poniżej.</para>
+	<screen># ifup ppp0</screen>
+	<para>Dzięki opcji <option>ONBOOT=yes</option> połączenie będzie nawiązywane wraz z 
+		uruchamianiem systemu.</para>
+	<para><!--Powinieneś utworzyć sobie plik <filename>startadsl</filename>. Poniżej zamieszczam jego
+		zawartość.</para>
+	<screen>eaglectrl -s
+INTERFACE=`eaglectrl -i`
+/sbin/ifconfig $INTERFACE 192.168.60.30 netmask 255.255.255.0 up
+/usr/sbin/pppd persist pty "/usr/sbin/pppoa -I $INTERFACE" file \
+/etc/ppp/options.adsl</screen>
+<para>Nawiązanie połączenia sprowadza się jedynie do wydania polecenia
+	<command>startadsl</command>, co niezwłocznie wykonujemy. -->Możemy sprawdzić np.
+		pingiem łączność z jakimś zewnętrznym serwerem, np.
+		<command>ping www.pld-linux.org</command>. Jeżeli posiadasz jakąś sieć LAN, lub kilka
+	komputerów w mieszkaniu, powinieneś przeczytać rozdział poświęcony
+	maskaradzie.</para>
+</section>
+</section>

Added: PLD-doc/book/pl_book__siec/pl_siec__dsl_neo_thompson.sec
==============================================================================
--- (empty file)
+++ PLD-doc/book/pl_book__siec/pl_siec__dsl_neo_thompson.sec	Sat Mar 19 15:00:57 2005
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="ISO-8859-2"?>
+<section id="siec_dsl_neo_thompson">
+	<title>Neostrada+ z modemem USB firmy Alcatel - Thompson</title>
+	<section id="siec_dsl_neo_thompson_wstęp">
+		<title>Przygotowanie do instalacji</title>
+		<para>Oto krótka lista tego, co będzie nam potrzebne do
+			uruchomienia modemu.
+		</para>
+		<itemizedlist>
+			<listitem>
+				<para>Port USB w komputerze</para>
+			</listitem>
+			<listitem>
+				<para>Jądro z serii 2.4 lub 2.6</para>
+			</listitem>
+			<listitem>
+				<para>Programy: <productname>modem_run</productname>
+					oraz <productname>pppoa3</productname></para>
+			</listitem>
+			<listitem>
+				<para>Pakiet: <productname>ppp-plugin-pppoatm</productname></para>
+			</listitem>
+			<listitem>
+				<para>Firmware do modemu.</para>
+			</listitem>
+		</itemizedlist>
+		<para>Firmware dla modemu można ściągnąć z stąd: 
+			<ulink url="http://speedtouch.sourceforge.net/files/fi
+				rmware.bin">http://speedtouch.sourceforge.net/files/firmware.bin</ulink>.
+		</para>
+		<para>Jeżeli już upewniłeś się, że masz wszystkie wymagane
+			rzeczy, możemy przystąpić do instalacji.
+		</para>
+	</section>
+	<section id="siec_dsl_neo_thompson_konf">
+		<title>Konfiguracja</title>
+		<para>W pierwszej kolejności musimy zainicjować w systemie
+			USB, oraz kilka modułów do obsługi ppp. Możemy to zrobić
+			wykonując następujące polecenie</para>
+		<screen># for i in usbcore uhci acm ppp_generic \
+    ppp_synctty;do modprobe $i;done</screen>
+		<para>Komentarza wymaga tutaj obsługa USB. W przykładzie został podany moduł 
+			<literal>uhci</literal>. Jeżeli nie załaduje się poprawnie (zostaniesz o tym poinformowany) powinieneś wybrać jeden z następujących: <literal>usb-uhci</literal>, <literal>usb-ohci</literal> lub dla USB 2.0 <literal>usb-ehci</literal>. Posiadacze jąder z serii 2.6 mają do wyboru następujący zestaw modułów: <literal>uhci-hcd</literal>, <literal>ohci-hcd</literal> lub <literal>ehci-hcd</literal>. Ta różnorodność jest uwarunkowana sprzętowo, w zależności od rodzaju chipsetu obsługującego porty USB.
+			Ważną rolę tutaj odgrywa moduł <command>acm</command>,
+			gdyż bez niego nie będzie możliwe załadowanie firmware do modemu. W kernelach z serii
+			2.6.x odpowiednikiem <literal>acm</literal> jest moduł <literal>cdc-acm</literal>.</para>
+		<para>Posiadacze kernela z serii 2.6.x mogą użyć poniższej pętli która załaduje wszystkie
+			potrzebne moduły. Oczywiście należy zwrócić uwagę aby załadować odpowiedni dla Twojego
+			sprzętu moduł obsługujący kontroler USB na płycie głównej.</para>
+		<screen># for i in usbcore uhci-hcd cdc-acm ppp_generic ppp_synctty;do modprobe $i;done</screen>
+		<para>Następnym krokiem jest podmontowanie systemu plików w
+			proc.</para>
+		<screen># mount none /proc/bus/usb -t usbdevfs</screen>
+		<para>W tym momencie możemy sprawdzić, czy SpeedTouch rzeczywiście jest widziany przez system.
+			Aby tego dokonać wykonaj poniższe polecenie</para>
+		<screen># cat /proc/bus/usb/devices
+[...]
+S:  Manufacturer=ALCATEL
+S:  Product=Speed Touch 330
+[...]</screen>
+		<para>Musisz teraz zainstalować oprogramowanie do modemu. Robimy to wydając następujące polecenie:</para>
+		<screen># poldek -U speedtouch</screen>
+		<para>Podłącz modem do komputera. Będzie on potrzebował do działania specjalnego pliku, 
+		tak zwanego firmware. Program <command>modem_run</command> potrafi odczytywać 
+		firmware w formatach przygotowanych dla Linuksa, Windowsa oraz MacOS. 
+		Jakie są możliwości pobrania pliku firmware? Możemy pobrać go z adresu podanego 
+		na początku rozdziału. Jest to firmware przygotowany dla systemu MacOS. 
+		Linuksowy firmware możemy pobrać ze strony Alcatela: 
+		<ulink url="http://www.speedtouchdsl.com/dvrreg_lx.htm">www.speedtouchdsl.com/dvrreg_lx.htm</ulink>. 
+		Wymagana jest rejestracja. Możemy również go wziąć z płytki dostarczonej przez TPSA. 
+		Powinien on znajdować się w archiwum <literal>Linux/ThomsonST330/pliki.tar.gz</literal>. 
+		Po jego rozpakowaniu powinniśmy mieć coś takiego jak: <literal>drivers/speedmgmt.tar.gz</literal>. 
+		Posiadając już plik <literal>speedmgmt.tar.gz</literal> możemy sobie zbudować
+			pakiet rpm z firmwarem przy użyciu speedtouch-firmware.spec. Musimy tylko
+			skopiować archiwum do katalogu <literal>~/rpm/SOURCES</literal>. Dalsze
+			instrukcje dotyczące budowania pakietów znajdziesz w tej dokumentacji w rozdziale: <command>Tworzenie PLD</command>. Po zainstalowaniu zbudowanego pakietu z firmwarem, możemy
+			go załadować wydając poniższe polecenie:</para>
+		<screen># modem_run -v 1 -m -f /ścieżka/do/firmware</screen>
+		<para>Ładowanie firmware do modemu może trochę potrwać.
+			Jeżeli chcesz widzieć co się dzieje wpisz następujące polecenie</para>
+		<screen># tail -f /var/log/messages</screen>
+		<para>W trakcie ładowania pliku firmware, zaczną migać diody urządzenia. Będzie to oznaczać
+			synchronizację linii. Po kilkunastu sekundach modem się ustabilizuje. Diody powrócą do
+		zielonego koloru.</para>
+		<para>Jeżeli masz zainstalowany kernel z serii 2.6 lub 2.4.22+ wykonaj poniższe polecenia:</para>
+<screen># modprobe speedtch
+# modem_run -k -m -v 1 -f /usr/share/speedtouch/mgmt.o
+# modprobe pppoatm</screen>
+<para>Moduł <literal>speedtch</literal> jest potrzebny do użycia opcji -k (może być ładowany automatycznie przez hotplug. Z kolei <literal>pppoatm</literal> będzie potrzebny do uruchomienia pppd.
+	Nie ładuje się on automatycznie, dlatego należy go dopisać np. do <literal>/etc/modules</literal>. </para>
+		<para>W porządku. Po zakończonej operacji ładowania firmware jesteśmy gotowi 
+			aby skonfigurować nasze ppp do neostrady. Zanim to zrobimy będziemy musieli zainstalować pakiet <literal>ppp-plugin-pppoatm</literal>.</para>
+		<screen># poldek -U ppp-plugin-pppoatm</screen>
+		<para>W zależności od wersji zainstalowanego kernela (2.6 lub 2.4) konfiguracja demona pppd będzie się różniła kilkoma szczegółami. Poniżej przedstawiam przykłady dla obu serii jąder.</para>
+		<para>Linux z serii 2.4</para>
+<screen># cat /etc/ppp/peers/neostrada
+debug
+lock
+noipdefault
+defaultroute
+pty "/usr/sbin/pppoa3 -v 1 -e 1 -c -m 1 -vpi 0 -vci 35"
+asyncmap 0
+lcp-echo-interval  2
+lcp-echo-failure   7
+sync
+user "user w neostrada.pl"
+noauth
+holdoff 3
+persist
+maxfail 25
+mru 1500
+mtu 1500</screen>
+<para>Linux z serii 2.6 lub 2.4.22+</para>
+<screen># cat /etc/ppp/peers/neostrada
+noauth
+usepeerdns
+noipdefault
+defaultroute
+pty "/usr/sbin/pppoa3 -e 1 -v 1 -m 1 -c -vpi 0 -vci 35"
+sync
+user nasz_login
+noaccomp
+nopcomp
+noccp
+holdoff 4
+persist
+maxfail 25</screen>
+<!--
+- Ten fragment jest problematyczny. Zakomentowałem go ku uwadze innych.
+
+<screen># cat /etc/ppp/peers/neostrada
+debug
+lock
+noipdefault
+defaultroute
+asyncmap 0
+lcp-echo-interval  2
+lcp-echo-failure   7
+sync
+user "user w neostrada.pl"
+noauth
+holdoff 3
+persist
+maxfail 25
+mru 1500
+mtu 1500
+plugin "pppoatm.so"
+0.35</screen>
+<para>Brak pppoa3 w drugim przykładzie wynika z tego, iż nie jest on obsługiwany w jądrach 2.6.
+	Dlatego radziłbym trzymać się tego opisu. Ostatnia linijka definiuje wymagane parametry dla
+	wtyczki <command>pppoatm.so</command></para>-->
+<para>Ważną rolę odgrywa tu parametr <option>-e 1</option>, gdyż bez niego nie uzyskamy
+połączenia.</para>
+		<para>Oczywiście musimy jeszcze odpowiednio skonfigurować
+			<filename>pap-secrets</filename> oraz <filename>chap-secrets</filename></para>
+		<screen># cat /etc/ppp/chap-secrets
+user w neostrada.pl     *       haslo        *</screen>		
+	</section>
+	<section id="siec_dsl_neo_thompson_run">
+		<title>Uruchomienie i zakończenie</title>
+		<para>W celu nawiązania połączenia, które uprzednio 
+			skonfigurowaliśmy, wydajemy takie oto polecenie</para>
+		<screen>pppd call neostrada</screen>
+		<para>Jeżeli nie chcemy, bądź z jakichś powodów nie możemy
+			korzystać z programu <productname>hotplug</productname>
+			nie musimy tego robić. Nie jest on tak naprawdę niezbędny.
+			W takim przypadku za każdym razem będziemy musieli ładować
+			firmware modemu programem <productname>modem_run</productname>.</para>
+		</section>
+</section>




Więcej informacji o liście dyskusyjnej pld-doc