Compal Laptop Control
=====================

Autor:		Krzemin <pkrzemin@o2.pl>
Strona WWW:	http://krzemin.iglu.cz/compal-laptop-control

Ten program jest rozprowadzany na licencji GNU General Public License.

Compal Laptop Control to mały program dla Linuksa, który potrafi
włączać/wyłączać interfejsy bluetooth oraz sieci bezprzewodowej i
zarządzać jasnością matrycy LCD oraz poziomem naładowania baterii na
laptopach z serii Compal IFL90/FL90 oraz podobnych.

Do działania wymaga modułu compal-laptop napisanego przez Cezarego
Jackiewicza, który możesz znaleźć na stronie:
http://eko.one.pl/index.php?page=compal-laptop


Instalacja
==========

Na początku powinieneś zainstalować paczkę z plikami nagłówkowymi,
odpowiednią dla swojej dystrybucji lub ściągnąć pełne źródła jądra
ze strony http://kernel.org oraz podlinkować katalog 
/lib/modules/$(uname -r)/build tak, aby wskazywał na katalog ze źródłami.
Nastepnie musisz ściągnąć źródła modułu compal-laptop ze strony
http://eko.one.pl/index.php?page=compal-laptop oraz rozpakować je:

$ tar -zxvf compal-laptop-wersja.tar.gz

Przejdź do utworzonego katalogu:

$ cd compal-laptop-wersja

Skompiluj moduł:

$ make

I go zainstaluj:

$ sudo make install

Teraz możesz spróbować załadować moduł:

$ sudo modprobe compal-laptop

Jeśli wyskoczy błąd "No such device", spróbuj załadować "na siłę",
wpisując parametr force=1:

$ sudo modprobe compal-laptop force=1

Aby włączyć automatyczne ładowanie modułu po restarcie, dodaj linię
"compal-laptop" na końcu pliku /etc/modules (albo podobnego, właściwego
dla Twojej dystrybucji).

Jeśli moduł się ładuje, możesz teraz skompilować program Compal
Laptop Control. Bedziesz potrzebował bibliotek Qt4 (qt4-core i
qt4-gui). Zazwyczaj odpowiednie pakiety znajdują się w repozytoriach
Twojej dystrybucji. Np. na Ubuntu instalacja pakietów wygląda następująco:

$ sudo apt-get install libqt4-core libqt4-gui

Po zainstalowaniu bibliotek Qt4, przejdź do katalogu ze źródłami
programu Compal Laptop Control:

$ cd ścieżka_do_źródeł/compal-laptop-control-wersja

Jeśli chcesz przekompilować program, będą potrzebne biblioteki
deweloperskie Qt4 (w Ubuntu: pakiet libqt4-dev).

$ make

Powyższe polecenie przekompiluje program. Zazwyczaj jednak
rekompilacja nie jest potrzebna.

Zainstaluj compal-laptop-control w systemie plików /usr:

(UWAGA: Jeśli chcesz zainstalować program w innym drzewie, niż
 /usr (np. w /usr/local), znajdź zmienną INSTALL_PREFIX w pliku
 compal-laptop-control.pro i dostosuj ją do własnych potrzeb.
 Potem zrekompiluj źródła ponownie.)

$ sudo make install

Oraz uruchom go z prawami roota:

$ sudo compal-laptop-control

Innym sposobem jest ustawienie praw roota dla pliku wykonywalnego:

$ sudo chmod +s /usr/bin/compal-laptop-control

Teraz możesz uruchomić aplikację bez sudo:

$ compal-laptop-control

OSTRZEŻENIE: powyższy sposób da uprawnienia roota każdemu użytkownikowi,
więc bądź z tym ostrożny!

Aby uniknąć uruchamiania aplikacji z uprawnieniami administratora, możesz
ustawić uprawnienia odpowiednich plików podczas startu systemu. Dodaj poniższe
linie:

chmod 666 /sys/devices/platform/compal-laptop/bluetooth
chmod 666 /sys/devices/platform/compal-laptop/wlan

# Jeśli używasz modułu compal-laptop w wersji <= 0.2.5
chmod 666 /sys/devices/platform/compal-laptop/lcd_level

# Jeśli używasz modułu compal-laptop w wersji >= 0.2.6
chmod 666 /sys/class/backlight/compal-laptop/brightness

# Lub opcjonalnie, jeśli używasz jądra w wersji >= 2.6.28
chmod 666 /sys/class/backlight/acpi_video0/brightness

# Jeśli używasz modułu compal-laptop w wersji >= 0.2.9
chmod 666 /sys/devices/platform/compal-laptop/charging_level

...do pliku /etc/rc.local albo podobnego, właściwego dla Twojej dystrybucji.

Aby odinstalować aplikację, wpisz następującą komendę w katalogu ze źródłami:

$ sudo make uninstall


Kontakt
=======

Jeśli znajdziesz jakiś błąd, chcesz dodać tłumaczenie lub masz jakieś inne
propozycje, napisz do mnie e-mail (pkrzemin@o2.pl) albo odwiedź stronę
WWW programu: http://krzemin.iglu.cz/compal-laptop-control
