Light Box Controller

Documentation of the user interface User Interface to control a light box

Getting started

The light box has an array of 8x8 LEDS connected into four banks of 2x8, controlled by a pulse width modularmodulator. The frequency, phase and duty cycle of the LEDs can be set. This guide is designed get to introduce the user interface controlling the light box and walk through the available controls.

Prerequisites

1. A light box, 5v 5V power supply and USB cable. (Note 5v5V, not 12v12V)

...

Image Added
Figure 1 Light Box

1. A current installation of DevWare.
2. Optionally a Demo2x Demo2X board.

Configurations

There are two configurations that can be controlled. Direct USB and via using the Demo2x board. It is preferable to control the light box via the USB however, if this fails to work for some reason, the Demo2x Demo2X might be a useful backup.

This is the USB configuration:

Figure 2 USB Configuration
By removing the back cover and attaching a Demo2X board this configuration can be achieved.

Figure 3 Demo2X Configuration

The

...

connection to the light box

Connect the lightbox to the PC in either configuration. Connect the 5v power to the light box too. Open the DevWare folder. Double click on LightBoxController.exe. If it's not there present, it's possible you'll need necessary to upgrade to the current version of DevWare.
Ideally all the lights on the light box should flash and the user interface will come up with no errors. If this is the case you can skip the trouble shooting section and go onto the user interface controls.

Trouble shooting connecting to the light box

You will probably get an error message similar to this.
Image Removed

1. You will find there are errors for both USB and Demo2X. It searches for both and if it finds neither will report all errors.
2. Check the voltage on your power supply one more time. It should be 5v. If it's 12v power supply you have destroyed the light box. Find another light box and keep the 12v power away.
3. Check the pc device manager. See if the Demo2x or mcp2221 (USB configuration) are visible devices. If they are not look to a hardware issue.
4. If you are connecting via a USB and you have a Demo2x available try it. If it works it verifies the hardware is working. You can use the 'retry' button rather than restarting the application to search for the attached devices.
5. Try all the USB ports on your machine. USB 2 / 3 issues can cause issues. Again use the 'retry' button.
6. If you are still having problems over UBS you may need to upgrade the USB3 firmware.
7. If none of that works try swapping hardware to identify the problem ideally with a known working system.

Refer the Trouble shooting section if you are unable to see light flashing.

Main User interface

This section describes the user interface that controls the light box LEDs.

...

The light box will come up in a basic mode where the duty cycle of the all the LEDs can be controlled together. By changing the duty cycle the white light will change in intensity from of all the LEDs. There is no update or apply button. If the interface is connected to the light box changes will show immediately.
Image Removed Image Added

Frequency control

The frequency of all the LEDs can be controlled using the top slider. Set the duty cycle to 50% and slide to the left for the lowest available frequency and you should see it flashing.
The all All frequencies that can generated by the light box are available. They are non-linear. There are many more low frequencies that than high ones. To get the best frequency setting slide to the approximate frequency and then use the left and right arrow keys to search for the best setting.
Image Removed Image Added

Color control

Click on the color radio button.
Image Removed
You should get three Image Added
Three duty cycle sliders appear, which you can use be used to set a color.

Phase control

The phase effects when the LEDs are pulsed. With 0% phase the pulse will start at the beginning of the cycle, a 50% phase will start half way through the cycle.
Image Removed Image Added
The above settings will look white at high frequencies but in fact the light box is red for the first 33% of the cycle, green for the next 33% and blue for the last 33%.
A setting Setting phase and duty cycle of which total totaling more than 100% is honored. By For example, a duty cycle of 20% and a phase of 90% will start at 90% into this cycle and end 10% through the next cycle.

LED selection

So far all setting have been applied to all LEDs but , it is also possible to select four bank 2x8 LEDs individually. Change the selection from 'All LEDs' to LEDs by sector. Use the radio buttons to select which bank you wish to changea particular bank that needs to be changed. The controls for duty cycle and phase are same as controlling all the LEDs. Select the bank, then select color / monochrome and then set the sliders. Repeat to set up each bank.
Image Removed Image Removed Image Added Image Added

Animation

A pattern can be created by varying the setting for each sector that can be scrolled across the lightbox. The pattern can be made to move one sector to the left or right at the given frequency. The last sector will be rotated to the first sector so that the pattern repeats. Most controls are disabled during animation. Only the frequency controls and pause are allowed. An animated pattern can be saved and will animate immediately on load (See saving setting). Note: animation is not supported in script mode. Script mode only loads Anchor_GoBack_GoBack one shot pattern and then exits.
Image Removed Image Added

Saving settings

The file menu allows save, save as and open. These will save all the current user interface setting to file <filename>.LightBox. The settings are held in xml so it is possible to edit them using a text editor. When a file is opened its settings will be immediately applied to the light box if one is when connected.

Light Box Menu

This describes the Light Box menu

...

This option will have no effect if you are already connected to a Light Box is not connected . If you aren't connected to a light box is not connected, it will search for a light box and on finding it will apply the current user interface settings to it. This can be used if the light box is physically connected to the PC after the user interface is already running. It can be used it if some temporary problem causes the light box to disconnect.

Disconnect

This disconnects from the light box. It's a good idea if you about there is no need to physically disconnect the light box but wish to keep modifying the light box setting to save as a file or apply later using connect.

...

Using the command LightBoxController.exe –n <filename>.LightBox the executable will apply the settings in the given file to the light box and immediately exit without starting a user interface allowing it to be used in a script for moving through a series of test patterns.

Trouble shooting connecting to the light box

If an error message similar to this appears Trouble shooting section can be skipped if this is the case and move onto the user interface controls.
Image Added

1. You will find there are errors for both USB and Demo2X. It searches for both and if it finds neither will report all errors.
2. Check the voltage on your power supply one more time. It should be 5V. If it's 12V power supply you have destroyed the light box. Find another light box and keep the 12V power away.
3. Check the pc device manager. See if the Demo2X or mcp2221 (USB configuration) are visible devices. If they are not look to a hardware issue.
4. If you are connecting via a USB and you have a Demo2X available, try it. If it works it verifies the hardware is working. You can use the 'retry' button rather than restarting the application to search for the attached devices.
5. Try all the USB ports on your machine. USB 2 / 3 issues can cause issues. Again use the 'retry' button.
6. If you are still having problems over USB you may need to upgrade the USB3 firmware.
7. If none of that works, try swapping hardware to identify the problem ideally with a known working system.

Revision History