User manual (EN) - pkied/opaal GitHub Wiki
General information
The lamp is used to illuminate a plant freshwater aquarium. The lamp light is suitable for planted aquarium. The lamp simulates the solar lighting cycle during the day: dawn, day, dusk, moon and night. The configuration of the lamp is done using buttons and an oled screen, which are placed on the housing.
Case
The aluminum housing allows heat dissipation. Additional fans keep the case cool. The fans turn on automatically. The housing has an OLED screen, which is used to display the current status of the lamp and its configuration.
Lamp feet are located on both sides of the housing. One of the feet has 2 sockets and 2 control buttons.
From the left visible:
- USB 2.0 socket connected directly to the Arduino (allows direct programming of the lamp);
- configuration MODE button;
- value SELECT button;
- DC 12V socket.
Screen
The screen is divided into 2 sections: the status bar at the top, and the work area below. As soon as the power is turned on, you can see both the status bar and the work area showing the current time (hour and minute).
The status bar shows the current lighting status information (from left to right):
- current time of day (Sunrise, Day, Sunset, Moon, Night);
- global light output (0 - 100%);
- temperature inside the lamp housing in degrees Celsius;
- active cooling status (~ when enabled).
The screen will automatically turn off after 1 minute (sleep mode). Select MODE to turn on the screen.
Simulation of lighting in the cycle of the time of day
The lamp simulates the times of the day: sunrise, day, sunset, and night: moonlight and night. Sunrise and sunset take half an hour.
If you set the daytime cycle start to 10:00 and the day duration to 10 hours (see below), sunrise will be at 10:00 AM, then from 10:30 AM to 7:30 PM, full sunlight will be simulated. There will be sunset at 7:30 PM. At 20:00 the moonlight will be turned on, the duration of which you will set during the configuration. After this time, the night will come, i.e. the lighting will be completely turned off.
The transition from one time point to the next occurs smoothly within the time set during configuration.
Configuration of the lamp
Configuration is done by changing the configuration mode with the MODE button and selecting the appropriate value with the SELECT button. On the screen you will see the property you are configuring and the selected value. Each time you press MODE, the screen will show the next configuration property and its current value.
Current time (hour)
In this mode, you set the current time.
Current time (minute)
In this mode you set the current minute.
Day cycle start time (hour)
In this mode, you set the time from which the lamp simulates the beginning of the day.
Day cycle start time (minute)
In this mode, you set the minute from which the lamp simulates the beginning of the day.
The duration of the day
In this mode, you will set the number of hours of simulation of the day.
The duration of the moon lighting
In this mode, you set the number of hours of moonlight simulation.
Global lighting power
In this mode, you will set the% of power with which the lamp will work. 100% is full power.
Color temperature
In this mode, you can smoothly set the color temperature of light - from warm (W), through neutral to cold (C).
Duration of color change
in this mode, you set the duration of the transition from one light color to the next, during the simulation of the times of the day.
Save settings
in this mode you will save the settings, including the current time. If you don't, after a power outage, your settings will not be visible. Thanks to this, you can also experiment with the settings - if they do not suit you - turn the power off and on again. The lamp will turn on with the last saved configuration settings.
To save the settings, press SELECT. On the work screen, you will see NO change to YES, then the screen goes blank and goes into sleep mode.
Customization of the controller software
The downloaded software can be adapted to the lamp you have built.
Control pin and active cooling temperature
Depending on the needs and connection of the controller, you can change the control pin and the temperature of turning on and off the fans. The line in the opaal.ino file is responsible for this:
15. fan.begin(37, 34, 11);
Arguments:
- Switch-on temperature
- Switch-off temperature
- controller pin number (it must be a PWM pin).
Color channel control pins (drivers)
Each LED color should have independent control. Depending on the pins to which the drivers are connected, you can indicate these pins for the next color channels. In this case, they will be: white (w), red (r), green (g), blue (b), and yellow (y). The lines in the opaal_lamp.h file are responsible for this:
26. static const byte c_lampChannelPins[CHI_COUNT] = { //w,r,g,b,y
27. 3, 10, 6, 9, 5
28. };
The color of the light (power of the channels) for the time of day
You can adjust the color of the light for each time of the day: night (night), dawn (sunrise), day (suntop), evening (sunset), moonlight (moon). Successive values in a given line correspond to the following colors: white (w), red (r), green (g), blue (b) and yellow (y). The value of the power of a given channel is defined by a real number in the range from 0.0 to 1.0. 0.0 means complete shutdown of the given channel, while 1.0 - maximum power. Remember that the final light output will be further limited by setting the global light output. The set light color is additionally controlled by the lamp settings. Therefore, the values entered here will only be true for a neutral hue setting. Setting a warmer or cooler color will modify the original settings by adding and subtracting the appropriate amount of light towards red or blue. The lines of code in the opaal_lamp.h file are responsible for setting the power for individual times of the day:
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. };
At the end
Remember that the lamp designed according to Use my design and software at your own risk. I provide both the design and the software for free and I am not responsible for their use and the resulting losses. Read the license terms. Please visit Power LED Aquarium Lighting, where I will help if possible.