Light Box Controller

Documentation of the 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 modulator. The frequency, phase and duty cycle of the LEDs can be set. This guide is designed to introduce the user interface controlling the light box and walk through the available controls.

Prerequisites

• A light box, 5V power supply and USB cable. (Note 5V, not 12V)

Image Removed
Figure 1 Light Box

• A current installation of DevWare.
• Optionally a Demo2X board.

Configurations

There are two configurations that can be controlled. Direct USB and 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 might be a useful backup.

This is the USB configuration: Image Removed

Figure 2 USB Configuration

By removing the back cover and attaching a Demo2X board this configuration can be achieved. Image Removed

Figure 3 Demo2X Configuration

...

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 it’s not present, it's it’s 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. 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 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

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 should see it flashing.

All frequencies that can generated by the light box are available. They are non-linear. There are many more low frequencies 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

Color control

Click on the color radio button.

Image Removed
Three duty cycle sliders appear, which can be used to set a color.

...

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

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

Setting phase and duty cycle of totaling more than 100% is honored. 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, it is also possible to select four bank 2x8 LEDs individually. Change the selection from 'All LEDs' ‘All LEDs’ to LEDs by sector. Use the radio buttons to select a 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

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 one shot pattern and then exits. Image Removed

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 when connected.

...

This option will have no effect if Light Box Box  is not connected . If 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 if some temporary problem causes the light box to disconnect.

...

This disconnects the light box. It's It’s a good idea if 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. Anchor_Toc430691573_Toc430691573

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 Removed

• You will find there are errors for both USB and Demo2X. It searches for both and if it finds neither will report all errors.
• 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.
• 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.
• 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.
• Try all the USB ports on your machine. USB 2 / 3 issues can cause issues. Again use the ‘retry’ button.
• If you are still having problems over USB you may need to upgrade the USB3 firmware.
• If none of that works, try swapping hardware to identify the problem ideally with a known working system.

Revision History

Trouble shooting connecting to the light box

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

...