Instrukcja użytkownika (PL) - pkied/opaal GitHub Wiki
Informacje ogólne
Lampa służy do oświetlania roślinnego akwarium słodkowodnego. Światło lampy jest odpowiednie dla uprawy roślin akwariowych oraz dobrze odwzorowuje kolory ryb. Lampa symuluje cykl oświetlenia słonecznego w ciągu doby: świt, dzień, zmierzch, księżyc i noc. Konfiguracja lampy odbywa się przy użyciu przycisków i ekranu oled, które zostały umieszczone na obudowie.
Obudowa
Aluminiowa obudowa umożliwia odprowadzanie ciepła. Dodatkowe wentylatory chłodzą obudowę. Wentylatory włączają się automatycznie. Na obudowie umieszczony jest ekran OLED, który służy do wyświetlania bieżącego stanu lampy oraz jej konfiguracji.
Nóżki lampy umieszczone są z obu stron obudowy. Na jednej z nóżek znajdują się 2 gniazda oraz 2 przyciski sterujące.
Od lewej widoczne:
- gniazdo USB 2.0 połączone bezpośrednio z Arduino (umożliwia bezpośrednie programowanie lampy);
- przycisk wyboru trybu konfiguracji (ang. mode), dalej oznaczony jako MODE;
- przycisk wyboru wartości (ang. select), dalej oznaczony jako SELECT;
- gniazdo DC 12V.
Ekran
Ekran podzielony jest na 2 części: pasek stanu na górze, oraz obszar roboczy poniżej. Zaraz po włączeniu zasilania widoczny jest zarówno pasek stanu jak i obszar roboczy, na którym wyświetlany jest bieżący czas (godzina i minuta).
Na pasku stanu wyświetlane są bieżące informacje o stanie oświetlenia (od lewej):
- aktualna pora dnia (Sunrise, Day, Sunset, Moon, Night);
- globalna moc światła (0 - 100%);
- temperatura wewnątrz obudowy lampy w stopniach celsiusza;
- stan aktywnego chłodzenia (~ gdy włączone).
Ekran zostanie automatyczne wyłączony po upływie 1 minuty (tryb uśpienia). Aby włączyć ekran, wybierz MODE.
Symulacja oświetlenia w cyklu pór dnia
Lampa symuluje pory dnia: wschód słońca, dzień, zachód, oraz nocy: światło księżycowe i noc. Wschód oraz zachód słońca trwają pół godziny.
Jeśli ustawisz rozpoczęcie cyklu dziennego na godzinę 10:00 i czas trwania dnia na 10 godzin (patrz niżej), to wschód słońca nastąpi o 10:00, następnie od 10:30 do 19:30, symulowane będzie pełne światło słoneczne. O 19:30 nastąpi zachód słońca. O godzinie 20:00 włączone zostanie oświetlenie księżycowe, którego czas trwania ustawisz podczas konfiguracji. Po tym czasie nastąpi noc, czyli całkowite wyłączenie oświetlenia.
Przejście z jednej pory w drugą następuje płynnie w czasie ustawionym podczas konfiguracji.
Konfiguracja lampy
Konfiguracja odbywa się poprzez zmianę trybu konfiguracji przyciskiem MODE oraz wybór odpowiedniej wartości przyciskiem SELECT. Na ekranie będziesz widział właściwość, którą konfigurujesz oraz wybraną wartość. Za każdym razem, gdy wciśniesz MODE, na ekranie zostanie wyświetlona kolejna właściwość konfiguracji oraz jej aktualna wartość
Bieżący czas (godzina)
W tym trybie ustawiasz aktualną godzinę.
Bieżący czas (minuta)
W tym trybie ustawiasz aktualną minutę.
Czas rozpoczęcia cyklu dziennego (godzina)
W tym trybie ustawisz godzinę, od której lampa symuluje początek dnia.
Czas rozpoczęcia cyklu dziennego (minuta)
W tym trybie ustawisz minutę, od której lampa symuluje początek dnia.
Czas trwania dnia
W tym trybie ustawisz liczbę godzin symulacji dnia.
Czas trwania oświetlenia księżycowego
W tym trybie ustawisz liczbę godzin symulacji światła księżycowego.
Globalna moc oświetlenia
W tym trybie ustawisz % mocy z jaką będzie działać lampa. 100% to pełna moc.
Temperatura barwowa
W tym trybie ustawisz płynnie temperaturę barwową światła - od ciepłej (W, ang. warm), przez neutralną do zimnej (C, ang. cold).
Czas trwania zmiany barwy
w tym trybie ustawisz czas trwania przejścia z jednej barwy światłą w kolejną, w trakcie symulacji pór dnia.
Zapis ustawień
w tym trybie zapiszesz ustawienia, łącznie z bieżącym czasem. Jeśli tego nie zrobisz, po zaniku zasilania, Twoje ustawienia nie będą widoczne. Dzięki temu, możesz również eksperymentować z ustawieniami - jeśli nie będą Ci odpowiadać - wyłącz zasilanie i włącz ponownie. Lampa włączy sięz ostatnio zapisanymi ustawieniami konfiguracji.
Aby wykonać zapis ustawień, wciśnij SELECT. Na ekranie roboczym zobaczysz zmianę NO na YES, po czym ekran zgaśnie przejdzie w tryb uśpienia.
Dostosowanie oprogramowania kontrolera
Pobrane oprogramowanie możesz dostosować do zbudowanej przez siebie lampy.
Pin sterowania i temperatura aktywnego chłodzenia
W zależności od potrzeb i połączenia kontrolera, możesz zmienić pin sterujący oraz temperaturę włączenia i wyłączenia wentylatorów. Odpowiada za to linia w pliku opaal.ino:
15. fan.begin(37, 34, 11);
Argumenty:
- Temperatura włączenia
- Temperatura wyłączenia
- numer pinu kontrolera (musi być to pin PWM).
Piny kontroli kanałów barw (driverów)
Każdy kolor LED powinien posiadać niezależne sterowanie. W zależności od pinów, do których zostały podpięte drivery, możesz wskazać te piny dla kolejnych kanałów barw. W tym przypadku będą to: biały (w), czerwony (r), zielony (g), niebieski (b) oraz żółty (y). Odpowiadają za to linie w pliku opaal_lamp.h:
26. static const byte c_lampChannelPins[CHI_COUNT] = { //w,r,g,b,y
27. 3, 10, 6, 9, 5
28. };
Barwa światła (moc kanałów) dla pór dnia
Możesz dostosować barwę światła dla poszczególnych pór dnia: noc (night), świt (sunrise), dzień (suntop), wieczór (sunset), światło księżyca (moon). Kolejne wartości w danym wierszu odpowiadają kolejnym kolorom: biały (w), czerwony (r), zielony (g), niebieski (b) oraz żółty (y). Wartość mocy danego kanału określa liczba rzeczywista z zakresu od 0.0 do 1.0. 0.0 oznacza całkowite wyłączenie danego kanału, natomiast 1.0 - maksymalną moc. Pamiętaj, że ostateczna moc światła zostanie dodatkowo ograniczona poprzez ustawienie globalnej mocy oświetlenia. Ustalona barwa światła jest dodatkowo kontrolowana poprzez ustawienia lampy. Dlatego wprowadzone tutaj wartości będą odpowiadały rzeczywistości tylko przy ustawieniu neutralnym barwy. Ustawienie cieplejszej lub chłodniejszej barwy zmodyfikuje oryginalne nastawy dodając i odejmując odpowiednią ilość światła w kierunku czerwieni lub niebieskiego. Za ustawienie mocy dla poszczególnych pór dnia odpowiadają linie kodu w pliku opaal_lamp.h:
30. static const float c_lampColorProfiles[COLI_COUNT][CHI_COUNT] = { //w,r,g,b,y
31. {0.0, 0.0, 0.0, 0.0, 0.0}, //NIGHT
32. {0.1, 0.1, 0.06, 0.03, 0.4}, //SUNRISE
33. {1.0, 1.0, 0.6, 0.3, 0.0}, //SUNTOP
34. {0.1, 0.1, 0.06, 0.03, 0.4}, //SUNSET
35. {0.01, 0.0, 0.0, 0.0, 0.0} //MOON
36. };
Na koniec
Pamiętaj, że lampy zaprojektowanej wg. mojego wzoru oraz oprogramowania używasz na własne ryzyko. Zarówno projekt jak i oprogramowanie udostępniam za darmo i nie ponoszę odpowiedzialności za ich użytkowanie oraz wynikłe z tego straty. Zapoznaj się z warunkami licencji. Zapraszam na Oświetlenie Power LED Aquarium, gdzie w miarę możliwości pomogę.