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.

Lamp bottom

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. Lamp top

Nóżki lampy umieszczone są z obu stron obudowy. Na jednej z nóżek znajdują się 2 gniazda oraz 2 przyciski sterujące. Lamp side

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.

Lamp ports and buttons

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).

OLED clock

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ę.

Time setting (hour)

Bieżący czas (minuta)

W tym trybie ustawiasz aktualną minutę.

Time setting (minute)

Czas rozpoczęcia cyklu dziennego (godzina)

W tym trybie ustawisz godzinę, od której lampa symuluje początek dnia.

Start time (hour)

Czas rozpoczęcia cyklu dziennego (minuta)

W tym trybie ustawisz minutę, od której lampa symuluje początek dnia.

Start time (minute)

Czas trwania dnia

W tym trybie ustawisz liczbę godzin symulacji dnia.

Day duration

Czas trwania oświetlenia księżycowego

W tym trybie ustawisz liczbę godzin symulacji światła księżycowego.

Moon duration

Globalna moc oświetlenia

W tym trybie ustawisz % mocy z jaką będzie działać lampa. 100% to pełna moc.

Global power

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).

Light temperature

Czas trwania zmiany barwy

w tym trybie ustawisz czas trwania przejścia z jednej barwy światłą w kolejną, w trakcie symulacji pór dnia.

Light color transition time

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.

Save settings

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:

  1. Temperatura włączenia
  2. Temperatura wyłączenia
  3. 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ę.